Skip to content

armgit / orca

Public Imported from GitHub
0

Orca is the place for working with a fleet of agents (e.g. Grok Bot, Claude Code). Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.

2.0 KB
Raw Blame
// Root means no producer id, never a matching value. First-write attribution survives revisions without linkage; all producers share one session timeline.

import type {
  AgentJournalProducerLinkage,
  AgentJournalRenderItem
} from './agent-session-journal-types'

/** Check presence, not truthiness: unresolved child IDs must not become root. Pre-linkage rows lack an ID and retain their historical root attribution. */
export function isRootAgentJournalItem(
  item: Pick<AgentJournalRenderItem, 'agentId'> | undefined
): boolean {
  return agentJournalItemSubagentId(item) === null
}

/** The subagent that produced a row, or null when the session's own agent did.
 *  Same reading of absence as {@link isRootAgentJournalItem}. */
export function agentJournalItemSubagentId(
  item: Pick<AgentJournalRenderItem, 'agentId'> | undefined
): string | null {
  return item?.agentId ?? null
}

/** Any linkage member marks attribution; revisions omitting all members retain the existing producer. */
export function namesAgentJournalProducer(linkage: AgentJournalProducerLinkage): boolean {
  return (
    linkage.agentId !== undefined ||
    linkage.parentAgentId !== undefined ||
    linkage.providerParentRef !== undefined ||
    linkage.producerKind !== undefined ||
    linkage.attempt !== undefined
  )
}

/** Omit absent linkage members instead of setting undefined; spreading this carries future fields through every hop. */
export function agentJournalLinkageFields(
  linkage: AgentJournalProducerLinkage | undefined
): AgentJournalProducerLinkage {
  if (!linkage) {
    return {}
  }
  return {
    ...(linkage.agentId === undefined ? {} : { agentId: linkage.agentId }),
    ...(linkage.parentAgentId === undefined ? {} : { parentAgentId: linkage.parentAgentId }),
    ...(linkage.providerParentRef === undefined
      ? {}
      : { providerParentRef: linkage.providerParentRef }),
    ...(linkage.producerKind === undefined ? {} : { producerKind: linkage.producerKind }),
    ...(linkage.attempt === undefined ? {} : { attempt: linkage.attempt })
  }
}