Interface AgentSession

ReadonlysessionId

cancel

• cancel(cause: TurnCancelCause, by: string): void

  Parameters

  • cause: TurnCancelCause
  • by: string

  Returns void

close

• close(): void | Promise<void>

  Seals the session. Safe to call more than once.

  Returns void | Promise<void>

prompt

• prompt(
      text: string,
      images?: readonly NativeImageInput[],
  ): Promise<AgentPromptResult>

  Run one prompt to completion. Rejects a second while one is in flight.

  Parameters

  • text: string
  • Optionalimages: readonly NativeImageInput[]

  Returns Promise<AgentPromptResult>

OptionalpromptAudioParts

• promptAudioParts?(parts: readonly NativeAudioPart[]): Promise<AgentPromptResult>

  Parameters

  • parts: readonly NativeAudioPart[]

  Returns Promise<AgentPromptResult>

OptionalpromptParts

• promptParts?(parts: readonly NativeInputPart[]): Promise<AgentPromptResult>

  Optional on externally supplied legacy factories; native composition implements it.

  Parameters

  • parts: readonly NativeInputPart[]

  Returns Promise<AgentPromptResult>

readEvents

• readEvents(): readonly EvidenceEvent[]

  This session's committed rows.

  Exposed because the log is the only signed record of what a prompt did, so a caller that must report progress reads rows rather than being handed a second, unsigned narration of the same events.

  Returns readonly EvidenceEvent[]

Optionalrelease

• release?(): void | Promise<void>

  Explicit signed handoff at an idle boundary; ordinary close still seals.

  Returns void | Promise<void>