@finalai/agents 0.4.4 → 0.6.0

package/dist/modules/agent-client/index.mjs

@@ -27,14 +27,14 @@ import {
 import {
   AgentClientErrorName,
   ClientErrorCode,
-  PendingRequestErrorReason,
+  DecisionErrorReason,
   clientError,
+  decisionError,
   isClientError,
-  isPendingRequestError,
+  isDecisionError,
   isRealtimeSubscriptionError,
   isTerminalRealtimeError,
   isTurnRejectedError,
-  pendingRequestError,
   realtimeSubscriptionError,
   turnRejectedError
 } from "./errors.mjs";
@@ -55,7 +55,7 @@ export {
   CollectionEventKind,
   CollectionResyncReason,
   ConfigOptionCategory,
-  PendingRequestErrorReason,
+  DecisionErrorReason,
   SANDBOX_FILE_URI_SCHEME,
   SessionLiveEventKind,
   TURN_OPEN_SESSION_STATES,
@@ -66,17 +66,17 @@ export {
   createGatewayRealtimeTransport,
   createSandboxFileUri,
   createTextCollector,
+  decisionError,
   defaultStreamTiming,
   isClientError,
+  isDecisionError,
   isNewerMessageVersion,
-  isPendingRequestError,
   isRealtimeSubscriptionError,
   isTerminalRealtimeError,
   isTurnRejectedError,
   isUserMessageFor,
   messageVersionOf,
   parseSandboxFileUri,
-  pendingRequestError,
   realtimeSubscriptionError,
   sessionUpdateOf,
   textOf,

package/dist/modules/agent-client/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/agent-client/index.ts"],
-  "sourcesContent": ["// `@finalai/agents/client`: the agent platform client SDK.\n// Wire types come from `@finalai/agent-protocol/agent-platform`, re-exported\n// here so consumers need one import.\n\nexport * from '@finalai/agent-protocol/agent-platform';\nexport { AcpAuthMode, type AcpApiIface, type AcpConnectArgsIface } from \"./acp.mjs\";\nexport {\n  createTextCollector,\n  isUserMessageFor,\n  sessionUpdateOf,\n  textOf,\n  turnEndOf,\n  type AcpSessionUpdateIface,\n  type TurnEndIface,\n} from \"./acp-frames.mjs\";\nexport type {\n  ComputerSetupGuidesApiIface,\n  DefinitionRefIface,\n  DefinitionsApiIface,\n  ProvidersApiIface,\n  ScheduleRef,\n  SchedulesApiIface,\n} from \"./build.mjs\";\nexport {\n  createClient,\n  type AgentClientIface,\n  type AgentHandleIface,\n  type AgentsApiIface,\n  type CreateClientOptionsIface,\n  type PendingApiIface,\n  type PeopleApiIface,\n  type RealtimeApiIface,\n} from \"./client.mjs\";\nexport {\n  CollectionEventKind,\n  CollectionResyncReason,\n  type CollectionEvent,\n  type CollectionEventsOptionsIface,\n  type CollectionResyncEventIface,\n} from \"./collection-events.mjs\";\nexport {\n  ConfigOptionCategory,\n  configSelectFor,\n  configSelectsOf,\n  type ConfigSelectChoiceIface,\n  type ConfigSelectIface,\n  type SessionConfigOptionIface,\n} from \"./config-options.mjs\";\nexport type { EnumInput, SignalOptionsIface } from \"./context.mjs\";\nexport {\n  TURN_OPEN_SESSION_STATES,\n  isNewerMessageVersion,\n  messageVersionOf,\n  type MessageVersionIface,\n} from \"./conversations.mjs\";\nexport type {\n  ConversationAgentTurnIface,\n  ConversationEvent,\n  ConversationEventMetaIface,\n  ConversationEventsOptionsIface,\n  ConversationHandleIface,\n  ConversationsApiIface,\n  CreateConversationArgsIface,\n  ListMessagesOptionsIface,\n  OpenedConversationIface,\n  ParticipantCreateInput,\n  SandboxFileContentArgsIface,\n  SandboxFileContentRequestIface,\n  SendMessageOptionsIface,\n  SentMessageIface,\n  UploadAttachmentArgsIface,\n} from \"./conversations.mjs\";\nexport {\n  AgentClientErrorName,\n  ClientErrorCode,\n  PendingRequestErrorReason,\n  clientError,\n  isClientError,\n  isPendingRequestError,\n  isRealtimeSubscriptionError,\n  isTerminalRealtimeError,\n  isTurnRejectedError,\n  pendingRequestError,\n  realtimeSubscriptionError,\n  turnRejectedError,\n  type AgentClientError,\n  type ClientErrorIface,\n  type PendingRequestErrorIface,\n  type RealtimeSubscriptionErrorIface,\n  type TurnRejectedErrorIface,\n} from \"./errors.mjs\";\nexport { defaultStreamTiming, type StreamTimingIface } from \"./frame-stream.mjs\";\nexport type { AgentClientAuth, FetchIface, HeadersOption } from \"./http.mjs\";\nexport { SessionLiveEventKind, type SessionLiveEvent } from \"./live-stream.mjs\";\nexport {\n  createGatewayRealtimeTransport,\n  type GatewayConnect,\n  type GatewayConnectionIface,\n  type GatewayRealtimeTransportOptionsIface,\n  type RealtimeSubscribeOptionsIface,\n  type RealtimeTransportFrameIface,\n  type RealtimeTransportIface,\n} from \"./realtime.mjs\";\nexport {\n  SANDBOX_FILE_URI_SCHEME,\n  createSandboxFileUri,\n  parseSandboxFileUri,\n  type SandboxFileTargetIface,\n} from \"./sandbox-uri.mjs\";\nexport type {\n  CreateSessionArgsIface,\n  CreatedSessionIface,\n  ForkSessionOptionsIface,\n  RespondArgs,\n  SendOptionsIface,\n  SessionHandleIface,\n  SessionsApiIface,\n  StreamOptionsIface,\n  TurnHandleIface,\n  TurnResultIface,\n} from \"./sessions.mjs\";\n"],
-  "mappings": "AAIA,cAAc;AACd,SAAS,mBAA+D;AACxE;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AASP;AAAA,EACE;AAAA,OAQK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OAIK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAkBP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAMK;AACP,SAAS,2BAAmD;AAE5D,SAAS,4BAAmD;AAC5D;AAAA,EACE;AAAA,OAOK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;",
+  "sourcesContent": ["// `@finalai/agents/client`: the agent platform client SDK.\n// Wire types come from `@finalai/agent-protocol/agent-platform`, re-exported\n// here so consumers need one import.\n\nexport * from '@finalai/agent-protocol/agent-platform';\nexport { AcpAuthMode, type AcpApiIface, type AcpConnectArgsIface } from \"./acp.mjs\";\nexport {\n  createTextCollector,\n  isUserMessageFor,\n  sessionUpdateOf,\n  textOf,\n  turnEndOf,\n  type AcpSessionUpdateIface,\n  type TurnEndIface,\n} from \"./acp-frames.mjs\";\nexport type {\n  ComputerSetupGuidesApiIface,\n  DefinitionRefIface,\n  DefinitionsApiIface,\n  ProvidersApiIface,\n  ScheduleRef,\n  SchedulesApiIface,\n} from \"./build.mjs\";\nexport {\n  createClient,\n  type AgentClientIface,\n  type AgentHandleIface,\n  type AgentsApiIface,\n  type CreateClientOptionsIface,\n  type PeopleApiIface,\n  type RealtimeApiIface,\n} from \"./client.mjs\";\nexport {\n  CollectionEventKind,\n  CollectionResyncReason,\n  type CollectionEvent,\n  type CollectionEventsOptionsIface,\n  type CollectionResyncEventIface,\n} from \"./collection-events.mjs\";\nexport {\n  ConfigOptionCategory,\n  configSelectFor,\n  configSelectsOf,\n  type ConfigSelectChoiceIface,\n  type ConfigSelectIface,\n  type SessionConfigOptionIface,\n} from \"./config-options.mjs\";\nexport type { EnumInput, SignalOptionsIface } from \"./context.mjs\";\nexport {\n  TURN_OPEN_SESSION_STATES,\n  isNewerMessageVersion,\n  messageVersionOf,\n  type MessageVersionIface,\n} from \"./conversations.mjs\";\nexport type {\n  ConversationAgentTurnIface,\n  ConversationEvent,\n  ConversationEventMetaIface,\n  ConversationEventsOptionsIface,\n  ConversationHandleIface,\n  ConversationsApiIface,\n  CreateConversationArgsIface,\n  ListMessagesOptionsIface,\n  OpenedConversationIface,\n  ParticipantCreateInput,\n  SandboxFileContentArgsIface,\n  SandboxFileContentRequestIface,\n  SendMessageOptionsIface,\n  SentMessageIface,\n  UploadAttachmentArgsIface,\n} from \"./conversations.mjs\";\nexport {\n  AgentClientErrorName,\n  ClientErrorCode,\n  DecisionErrorReason,\n  clientError,\n  decisionError,\n  isClientError,\n  isDecisionError,\n  isRealtimeSubscriptionError,\n  isTerminalRealtimeError,\n  isTurnRejectedError,\n  realtimeSubscriptionError,\n  turnRejectedError,\n  type AgentClientError,\n  type ClientErrorIface,\n  type DecisionErrorIface,\n  type RealtimeSubscriptionErrorIface,\n  type TurnRejectedErrorIface,\n} from \"./errors.mjs\";\nexport { defaultStreamTiming, type StreamTimingIface } from \"./frame-stream.mjs\";\nexport type { AgentClientAuth, FetchIface, HeadersOption } from \"./http.mjs\";\nexport { SessionLiveEventKind, type SessionLiveEvent } from \"./live-stream.mjs\";\nexport {\n  createGatewayRealtimeTransport,\n  type GatewayConnect,\n  type GatewayConnectionIface,\n  type GatewayRealtimeTransportOptionsIface,\n  type RealtimeSubscribeOptionsIface,\n  type RealtimeTransportFrameIface,\n  type RealtimeTransportIface,\n} from \"./realtime.mjs\";\nexport {\n  SANDBOX_FILE_URI_SCHEME,\n  createSandboxFileUri,\n  parseSandboxFileUri,\n  type SandboxFileTargetIface,\n} from \"./sandbox-uri.mjs\";\nexport type {\n  CreateSessionArgsIface,\n  CreatedSessionIface,\n  ForkSessionOptionsIface,\n  RespondArgs,\n  SendOptionsIface,\n  SessionHandleIface,\n  SessionsApiIface,\n  StreamOptionsIface,\n  TurnHandleIface,\n  TurnResultIface,\n} from \"./sessions.mjs\";\n"],
+  "mappings": "AAIA,cAAc;AACd,SAAS,mBAA+D;AACxE;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AASP;AAAA,EACE;AAAA,OAOK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OAIK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAkBP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAMK;AACP,SAAS,2BAAmD;AAE5D,SAAS,4BAAmD;AAC5D;AAAA,EACE;AAAA,OAOK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;",
   "names": []
 }

package/dist/modules/agent-client/sessions.d.mts

@@ -1,14 +1,14 @@
 import type { JsonObjectIface, JsonValue } from '@finalai/agent-protocol';
-import { type AcpFrameEventIface, type AcpPreviewEventIface, type AgentSessionIface, type AgentTurnIface, type AgentTurnPolicy, type AttachmentDownloadIface, type ContentInput, type PendingOutcomeInput, type PendingRequestIface, type PromptAcceptedIface, type RespondPendingResponseIface, type SessionFramesPageIface, type SessionManifestIface } from '@finalai/agent-protocol/agent-platform';
+import { type AcpFrameEventIface, type AcpPreviewEventIface, type AgentSessionIface, type AgentTurnIface, type AgentTurnPolicy, type AttachmentDownloadIface, type ContentInput, type DecisionOutcomeInput, type DecisionRecordIface, type PromptAcceptedIface, type RespondDecisionResponseIface, type SessionFramesPageIface, type SessionManifestIface } from '@finalai/agent-protocol/agent-platform';
 import { type ClientContextIface, type EnumInput, type SignalOptionsIface } from "./context.mjs";
 import { type SessionLiveEvent } from "./live-stream.mjs";
-/** Answer a pending request by option id (permission) or with a full ACP outcome. */
+/** Answer a decision by option id (permission) or with a full ACP outcome. */
 export type RespondArgs = {
-    pendingId: string;
+    decisionId: string;
     optionId: string;
 } | {
-    pendingId: string;
-    outcome: PendingOutcomeInput;
+    decisionId: string;
+    outcome: DecisionOutcomeInput;
 };
 export interface StreamOptionsIface extends SignalOptionsIface {
     /** Inclusive; defaults to `FIRST_ACP_FRAME_SEQ` (the whole log). Earlier values are clamped. */
@@ -73,11 +73,12 @@ export interface SessionHandleIface {
         fromSeq: number;
         limit?: number;
     }) => Promise<SessionFramesPageIface>;
-    pending: (options?: SignalOptionsIface) => Promise<PendingRequestIface[]>;
+    /** The session's open decisions (`GET /sessions/:id/decisions`). */
+    decisions: (options?: SignalOptionsIface) => Promise<DecisionRecordIface[]>;
     turn: (turnId: string, options?: SignalOptionsIface) => Promise<AgentTurnIface>;
     /** Reconstruct an accepted response from its durable turn id, without resending its prompt. */
     response: (turnId: string, options?: SignalOptionsIface) => Promise<TurnHandleIface<string | null>>;
-    respond: (args: RespondArgs, options?: SignalOptionsIface) => Promise<RespondPendingResponseIface>;
+    respond: (args: RespondArgs, options?: SignalOptionsIface) => Promise<RespondDecisionResponseIface>;
     cancel: (options?: SignalOptionsIface & {
         reason?: string;
     }) => Promise<void>;
@@ -119,6 +120,6 @@ export interface SessionsApiIface {
     get: (sessionId: string, options?: SignalOptionsIface) => Promise<AgentSessionIface>;
     attach: (sessionId: string) => SessionHandleIface;
 }
-export declare const outcomeOf: (args: RespondArgs) => PendingOutcomeInput;
+export declare const outcomeOf: (args: RespondArgs) => DecisionOutcomeInput;
 export declare const createSessionHandle: (context: ClientContextIface, sessionId: string) => SessionHandleIface;
 export declare const createSessionsApi: (context: ClientContextIface) => SessionsApiIface;

package/dist/modules/agent-client/sessions.mjs

@@ -12,12 +12,12 @@ import {
   FIRST_ACP_FRAME_SEQ,
   forkSessionRequestSchema,
   observeSessionRequestSchema,
+  decisionRecordListSchema,
   okResponseSchema,
-  pendingRequestListSchema,
   promptAcceptedSchema,
   promptSessionRequestSchema,
-  respondPendingRequestSchema,
-  respondPendingResponseSchema,
+  respondDecisionResponseSchema,
+  respondDecisionSchema,
   sessionFramesPageSchema,
   sessionManifestSchema,
   sessionSchema,
@@ -109,12 +109,12 @@ const replay = (args) => args.context.http.request({
   response: sessionFramesPageSchema,
   signal: args.signal
 });
-const openPending = async (args) => (await args.context.http.request({
+const openDecisions = async (args) => (await args.context.http.request({
   method: HttpMethod.Get,
-  path: sessionPath(args.sessionId, "/pending"),
-  response: pendingRequestListSchema,
+  path: sessionPath(args.sessionId, "/decisions"),
+  response: decisionRecordListSchema,
   signal: args.signal
-})).pending;
+})).decisions;
 async function* streamFramesOverHttp(args) {
   for await (const message of streamServerSentEvents({
     http: args.context.http,
@@ -171,7 +171,7 @@ const streamPreviews = (args) => {
 };
 const frameSources = (args) => ({
   replay: (page) => replay({ context: args.context, sessionId: args.sessionId, ...page }),
-  pending: (signal) => openPending({ ...args, signal }),
+  decisions: (signal) => openDecisions({ ...args, signal }),
   httpStream: (stream) => streamFramesOverHttp({ ...args, ...stream })
 });
 const createSessionHandle = (context, sessionId) => {
@@ -272,7 +272,7 @@ const createSessionHandle = (context, sessionId) => {
     liveEvents: (options) => streamSessionLiveEvents({ context, sessionId, signal: options?.signal }),
     previews: (options) => streamPreviews({ context, sessionId, signal: options?.signal }),
     frames: (options) => replay({ context, sessionId, ...options }),
-    pending: (options) => openPending({ context, sessionId, signal: options?.signal }),
+    decisions: (options) => openDecisions({ context, sessionId, signal: options?.signal }),
     turn: (turnId, options) => getTurn({ context, sessionId, turnId, signal: options?.signal }),
     response: async (turnId, options) => {
       const receipt = await getTurn({ context, sessionId, turnId, signal: options?.signal });
@@ -290,12 +290,12 @@ const createSessionHandle = (context, sessionId) => {
       method: HttpMethod.Post,
       path: sessionPath(sessionId, "/respond"),
       body: {
-        schema: respondPendingRequestSchema,
-        value: { pendingId: args.pendingId, outcome: outcomeOf(args) }
+        schema: respondDecisionSchema,
+        value: { decisionId: args.decisionId, outcome: outcomeOf(args) }
       },
-      response: respondPendingResponseSchema,
+      response: respondDecisionResponseSchema,
       signal: options?.signal,
-      context: { sessionId, pendingId: args.pendingId }
+      context: { sessionId, decisionId: args.decisionId }
     }),
     cancel: (options) => post({
       suffix: "/cancel",

package/dist/modules/agent-client/sessions.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/agent-client/sessions.ts"],
-  "sourcesContent": ["import type { JsonObjectIface, JsonValue } from '@finalai/agent-protocol';\nimport {\n  acpFrameEventSchema,\n  acpPreviewEventSchema,\n  agentRealtimeFrameSchema,\n  AgentRealtimeFrameType,\n  AgentRealtimeKind,\n  agentRealtimeTopics,\n  attachmentDownloadSchema,\n  cancelRequestSchema,\n  createSessionRequestSchema,\n  createSessionResponseSchema,\n  FIRST_ACP_FRAME_SEQ,\n  forkSessionRequestSchema,\n  observeSessionRequestSchema,\n  okResponseSchema,\n  pendingRequestListSchema,\n  promptAcceptedSchema,\n  promptSessionRequestSchema,\n  respondPendingRequestSchema,\n  respondPendingResponseSchema,\n  sessionFramesPageSchema,\n  sessionManifestSchema,\n  sessionSchema,\n  setConfigOptionRequestSchema,\n  turnSchema,\n  type AcpFrameEventIface,\n  type AcpPreviewEventIface,\n  type AgentSessionIface,\n  type AgentTurnIface,\n  type AgentTurnPolicy,\n  type AttachmentDownloadIface,\n  type ContentInput,\n  type PendingOutcomeInput,\n  type PendingRequestIface,\n  type PromptAcceptedIface,\n  type RespondPendingResponseIface,\n  type SessionFramesPageIface,\n  type SessionManifestIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { createTextCollector, isUserMessageFor, turnEndOf } from \"./acp-frames.mjs\";\nimport { createAsyncQueue, failOnAbort } from \"./async-queue.mjs\";\nimport {\n  encodePath,\n  type ClientContextIface,\n  type EnumInput,\n  type SignalOptionsIface,\n} from \"./context.mjs\";\nimport { isTerminalRealtimeError, realtimeSubscriptionError } from \"./errors.mjs\";\nimport { streamServerSentEvents } from \"./event-stream.mjs\";\nimport { streamSessionFrames } from \"./frame-stream.mjs\";\nimport { HttpMethod, type HttpBodyIface } from \"./http.mjs\";\nimport { streamSessionLiveEvents, type SessionLiveEvent } from \"./live-stream.mjs\";\nimport type { RealtimeTransportFrameIface } from \"./realtime.mjs\";\n\n/** Answer a pending request by option id (permission) or with a full ACP outcome. */\nexport type RespondArgs =\n  | { pendingId: string; optionId: string }\n  | { pendingId: string; outcome: PendingOutcomeInput };\n\nexport interface StreamOptionsIface extends SignalOptionsIface {\n  /** Inclusive; defaults to `FIRST_ACP_FRAME_SEQ` (the whole log). Earlier values are clamped. */\n  fromSeq?: number;\n  /** Keep streaming live frames after replay catches up; defaults to true. */\n  follow?: boolean;\n}\n\nexport interface TurnResultIface<MessageId extends string | null = string> {\n  messageId: MessageId;\n  turnId: string;\n  stopReason: string | null;\n  /** Visible agent text of the turn. */\n  text: string;\n  /** Seq of the frame that ended the turn. */\n  toSeq: number;\n}\n\n/** An accepted prompt. `stream()` yields this turn's frames; `result()` waits for its end. */\nexport interface TurnHandleIface<MessageId extends string | null = string> extends Omit<\n  PromptAcceptedIface,\n  'messageId'\n> {\n  messageId: MessageId;\n  sessionId: string;\n  get: (options?: SignalOptionsIface) => Promise<AgentTurnIface>;\n  stream: (options?: SignalOptionsIface) => AsyncIterableIterator<AcpFrameEventIface>;\n  result: (options?: SignalOptionsIface) => Promise<TurnResultIface<MessageId>>;\n}\n\nexport interface SendOptionsIface extends SignalOptionsIface {\n  turnPolicy?: EnumInput<AgentTurnPolicy>;\n  idempotencyKey?: string;\n  meta?: JsonObjectIface;\n  /** When the person submitted, for the prompt-to-inference trace; defaults to now. */\n  clientSubmittedAtMs?: number;\n}\n\nexport interface ForkSessionOptionsIface extends SignalOptionsIface {\n  /** Retain this key when retrying an interrupted fork. Defaults to a new key. */\n  idempotencyKey?: string;\n  title?: string;\n}\n\n/** An I/O-free handle on one session; every method is one HTTP call or one stream. */\nexport interface SessionHandleIface {\n  id: string;\n  /** Native fork of an idle source on its pinned revision; the standalone child has fresh scopes. */\n  fork: (options?: ForkSessionOptionsIface) => Promise<CreatedSessionIface>;\n  get: (options?: SignalOptionsIface) => Promise<AgentSessionIface>;\n  /** Resolves a `final-attachment:` resource link from this session's frames. */\n  attachment: (\n    attachmentId: string,\n    options?: SignalOptionsIface,\n  ) => Promise<AttachmentDownloadIface>;\n  send: (content: ContentInput, options?: SendOptionsIface) => Promise<TurnHandleIface>;\n  /** Adds content to history without a model call (`_final/session/observe`). */\n  observe: (\n    content: ContentInput,\n    options?: SignalOptionsIface & { idempotencyKey?: string; meta?: JsonObjectIface },\n  ) => Promise<void>;\n  stream: (options?: StreamOptionsIface) => AsyncIterableIterator<AcpFrameEventIface>;\n  /** Full provisional frames and reset notices; never a durable replay cursor or receipt. */\n  liveEvents: (options?: SignalOptionsIface) => AsyncIterableIterator<SessionLiveEvent>;\n  /**\n   * `acp.preview` events: the text of message and thought chunks as the session\n   * publishes them, live only (never replayed), for surfaces that render text\n   * ahead of the durable frames and the conversation's projected messages.\n   */\n  previews: (options?: SignalOptionsIface) => AsyncIterableIterator<AcpPreviewEventIface>;\n  /** One replay page (`GET /sessions/:id/frames`). */\n  frames: (\n    options: SignalOptionsIface & { fromSeq: number; limit?: number },\n  ) => Promise<SessionFramesPageIface>;\n  pending: (options?: SignalOptionsIface) => Promise<PendingRequestIface[]>;\n  turn: (turnId: string, options?: SignalOptionsIface) => Promise<AgentTurnIface>;\n  /** Reconstruct an accepted response from its durable turn id, without resending its prompt. */\n  response: (\n    turnId: string,\n    options?: SignalOptionsIface,\n  ) => Promise<TurnHandleIface<string | null>>;\n  respond: (\n    args: RespondArgs,\n    options?: SignalOptionsIface,\n  ) => Promise<RespondPendingResponseIface>;\n  cancel: (options?: SignalOptionsIface & { reason?: string }) => Promise<void>;\n  /**\n   * ACP `session/set_config_option` (model, reasoning, mode, ...): `configId` and a value\n   * from the options the harness advertises (`get().configOptions`, `configSelectsOf`).\n   * Changing them takes the session's owner, or a conversation owner or admin.\n   */\n  setConfigOption: (\n    args: { configId: string; value: JsonValue },\n    options?: SignalOptionsIface,\n  ) => Promise<void>;\n  close: (options?: SignalOptionsIface) => Promise<void>;\n  /** Resolved manifest and resolver report; secret-bearing output requires agents:read and admin secret-binding access. */\n  manifest: (options?: SignalOptionsIface) => Promise<SessionManifestIface>;\n}\n\nexport interface CreateSessionArgsIface extends SignalOptionsIface {\n  /** Agent slug or id. */\n  agent: string;\n  /** Pin an author test session to a revision returned by definitions.testRevision. */\n  revisionId?: string;\n  message?: ContentInput;\n  turnPolicy?: EnumInput<AgentTurnPolicy>;\n  idempotencyKey?: string;\n  title?: string;\n  meta?: JsonObjectIface;\n  /** When the person submitted `message`; defaults to now. */\n  clientSubmittedAtMs?: number;\n}\n\nexport interface CreatedSessionIface {\n  session: AgentSessionIface;\n  handle: SessionHandleIface;\n  /** The first turn when `message` was given. */\n  response: TurnHandleIface | null;\n}\n\nexport interface SessionsApiIface {\n  create: (args: CreateSessionArgsIface) => Promise<CreatedSessionIface>;\n  fork: (sessionId: string, options?: ForkSessionOptionsIface) => Promise<CreatedSessionIface>;\n  get: (sessionId: string, options?: SignalOptionsIface) => Promise<AgentSessionIface>;\n  attach: (sessionId: string) => SessionHandleIface;\n}\n\nexport const outcomeOf = (args: RespondArgs): PendingOutcomeInput =>\n  'optionId' in args ? { outcome: 'selected', optionId: args.optionId } : args.outcome;\n\nconst sessionPath = (sessionId: string, suffix = ''): string =>\n  `/v1/sessions/${encodePath(sessionId)}${suffix}`;\n\ninterface TurnHandleArgsIface<MessageId extends string | null> {\n  context: ClientContextIface;\n  sessionId: string;\n  accepted: Omit<PromptAcceptedIface, 'messageId'> & { messageId: MessageId };\n}\n\nconst turnHandle = <MessageId extends string | null>(\n  args: TurnHandleArgsIface<MessageId>,\n): TurnHandleIface<MessageId> => {\n  const { context, sessionId, accepted } = args;\n  const get = (options?: SignalOptionsIface) =>\n    getTurn({ context, sessionId, turnId: accepted.turnId, signal: options?.signal });\n  const stream = (options?: SignalOptionsIface): AsyncIterableIterator<AcpFrameEventIface> => {\n    // Without the prompt's seq, scan from the start for ACP's user message with this id.\n    // `until` runs as frames are queued and `next` as they are consumed, so each tracks its own start.\n    let queuedStart = accepted.messageId == null && accepted.fromSeq != null;\n    let started = queuedStart;\n    const frames = streamSessionFrames({\n      sessionId,\n      fromSeq: accepted.fromSeq ?? FIRST_ACP_FRAME_SEQ,\n      follow: true,\n      ...frameSources({ context, sessionId }),\n      transport: context.realtime(),\n      timing: context.timing,\n      signal: options?.signal,\n      closeSignal: context.closeSignal,\n      terminal: async (signal) => {\n        const receipt = await get({ signal });\n        return receipt.endedAt == null ? null : { throughSeq: receipt.toSeq ?? 0 };\n      },\n      until: (event) => {\n        if (\n          !queuedStart &&\n          accepted.messageId != null &&\n          isUserMessageFor(event, accepted.messageId)\n        )\n          queuedStart = true;\n        return queuedStart && turnEndOf(event) != null;\n      },\n    });\n    const iterator: AsyncIterableIterator<AcpFrameEventIface> = {\n      next: async () => {\n        for (;;) {\n          const next = await frames.next();\n          if (next.done === true || started) return next;\n          if (accepted.messageId != null && isUserMessageFor(next.value, accepted.messageId)) {\n            started = true;\n            return next;\n          }\n        }\n      },\n      return: () => frames.return?.() ?? Promise.resolve({ done: true, value: undefined }),\n      [Symbol.asyncIterator]: () => iterator,\n    };\n    return iterator;\n  };\n\n  const result = async (options?: SignalOptionsIface): Promise<TurnResultIface<MessageId>> => {\n    const text = createTextCollector();\n    let last: AcpFrameEventIface | null = null;\n    for await (const event of stream(options)) {\n      text.add(event);\n      last = event;\n    }\n    const end = last == null ? null : turnEndOf(last);\n    const receipt = await get(options);\n    return {\n      messageId: accepted.messageId,\n      turnId: accepted.turnId,\n      stopReason: receipt.stopReason ?? end?.stopReason ?? null,\n      text: text.text(),\n      toSeq: receipt.toSeq ?? last?.seq ?? accepted.fromSeq ?? 0,\n    };\n  };\n\n  return { ...accepted, sessionId, get, stream, result };\n};\n\nconst getTurn = (args: {\n  context: ClientContextIface;\n  sessionId: string;\n  turnId: string;\n  signal?: AbortSignal;\n}): Promise<AgentTurnIface> =>\n  args.context.http.request({\n    method: HttpMethod.Get,\n    path: sessionPath(args.sessionId, `/turns/${encodePath(args.turnId)}`),\n    response: turnSchema,\n    signal: args.signal,\n  });\n\ninterface ReplayArgsIface extends SignalOptionsIface {\n  context: ClientContextIface;\n  sessionId: string;\n  fromSeq: number;\n  limit?: number;\n}\n\nconst replay = (args: ReplayArgsIface): Promise<SessionFramesPageIface> =>\n  args.context.http.request({\n    method: HttpMethod.Get,\n    path: sessionPath(args.sessionId, '/frames'),\n    query: { fromSeq: args.fromSeq, limit: args.limit },\n    response: sessionFramesPageSchema,\n    signal: args.signal,\n  });\n\nconst openPending = async (args: {\n  context: ClientContextIface;\n  sessionId: string;\n  signal?: AbortSignal;\n}): Promise<PendingRequestIface[]> =>\n  (\n    await args.context.http.request({\n      method: HttpMethod.Get,\n      path: sessionPath(args.sessionId, '/pending'),\n      response: pendingRequestListSchema,\n      signal: args.signal,\n    })\n  ).pending;\n\n/** The session's frames over Streamable HTTP (`GET /sessions/:id/frames/stream`), from `fromSeq`. */\nasync function* streamFramesOverHttp(args: {\n  context: ClientContextIface;\n  sessionId: string;\n  fromSeq: number;\n  signal: AbortSignal;\n}): AsyncGenerator<AcpFrameEventIface> {\n  for await (const message of streamServerSentEvents({\n    http: args.context.http,\n    path: sessionPath(args.sessionId, '/frames/stream'),\n    query: { fromSeq: args.fromSeq },\n    signal: AbortSignal.any([args.signal, args.context.closeSignal]),\n  })) {\n    if (message.event !== AgentRealtimeKind.AcpFrame) continue;\n    try {\n      const event = acpFrameEventSchema.safeParse(JSON.parse(message.data));\n      if (event.success) yield event.data;\n    } catch {\n      // A malformed event is skipped; replay fills any gap it leaves.\n    }\n  }\n}\n\n/** Live `acp.preview` events of the session topic. */\nconst streamPreviews = (args: {\n  context: ClientContextIface;\n  sessionId: string;\n  signal?: AbortSignal;\n}): AsyncIterableIterator<AcpPreviewEventIface> => {\n  const topic = agentRealtimeTopics.session(args.sessionId);\n  let unsubscribe: (() => void) | null = null;\n  let detachAbort: () => void = () => {};\n  let detachClose: () => void = () => {};\n  const queue = createAsyncQueue<AcpPreviewEventIface>(() => {\n    unsubscribe?.();\n    detachAbort();\n    detachClose();\n  });\n  const onFrame = (raw: RealtimeTransportFrameIface): void => {\n    const frame = agentRealtimeFrameSchema.safeParse(raw);\n    if (!frame.success) return;\n    if (frame.data.type === AgentRealtimeFrameType.Error && isTerminalRealtimeError(frame.data)) {\n      queue.fail(\n        realtimeSubscriptionError({\n          topic: frame.data.topic ?? topic,\n          code: frame.data.code ?? 'unknown',\n          message: frame.data.message ?? 'Realtime subscription was refused',\n        }),\n      );\n      return;\n    }\n    if (frame.data.type !== AgentRealtimeFrameType.Event) return;\n    if (frame.data.kind !== AgentRealtimeKind.AcpPreview) return;\n    const preview = acpPreviewEventSchema.safeParse(frame.data.payload);\n    if (preview.success) queue.push(preview.data);\n  };\n  detachAbort = failOnAbort(queue, args.signal);\n  detachClose = failOnAbort(queue, args.context.closeSignal);\n  if (!queue.closed()) {\n    const stop = args.context.realtime().subscribe(topic, onFrame);\n    if (queue.closed()) stop();\n    else unsubscribe = stop;\n  }\n  return queue.iterator;\n};\n\n/** Replay, open pending requests and the Streamable HTTP fallback of one session's frame stream. */\nconst frameSources = (args: { context: ClientContextIface; sessionId: string }) => ({\n  replay: (page: { fromSeq: number; limit: number; signal?: AbortSignal }) =>\n    replay({ context: args.context, sessionId: args.sessionId, ...page }),\n  pending: (signal?: AbortSignal) => openPending({ ...args, signal }),\n  httpStream: (stream: { fromSeq: number; signal: AbortSignal }) =>\n    streamFramesOverHttp({ ...args, ...stream }),\n});\n\nexport const createSessionHandle = (\n  context: ClientContextIface,\n  sessionId: string,\n): SessionHandleIface => {\n  const { http } = context;\n  const post = async (args: {\n    suffix: string;\n    body?: HttpBodyIface;\n    signal?: AbortSignal;\n  }): Promise<void> => {\n    await http.request({\n      method: HttpMethod.Post,\n      path: sessionPath(sessionId, args.suffix),\n      body: args.body,\n      response: okResponseSchema,\n      signal: args.signal,\n      context: { sessionId },\n    });\n  };\n\n  return {\n    id: sessionId,\n    fork: async (options) => {\n      const created = await http.request({\n        method: HttpMethod.Post,\n        path: sessionPath(sessionId, '/fork'),\n        body: {\n          schema: forkSessionRequestSchema,\n          value: {\n            idempotencyKey: options?.idempotencyKey ?? context.newKey(),\n            title: options?.title,\n          },\n        },\n        response: createSessionResponseSchema,\n        signal: options?.signal,\n        context: { sessionId },\n      });\n      return {\n        session: created.session,\n        handle: createSessionHandle(context, created.session.id),\n        response: null,\n      };\n    },\n    attachment: (attachmentId, options) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: sessionPath(sessionId, `/attachments/${encodePath(attachmentId)}`),\n        response: attachmentDownloadSchema,\n        signal: options?.signal,\n      }),\n    get: (options) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: sessionPath(sessionId),\n        response: sessionSchema,\n        signal: options?.signal,\n      }),\n    manifest: (options) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: sessionPath(sessionId, '/manifest'),\n        response: sessionManifestSchema,\n        signal: options?.signal,\n      }),\n    send: async (content, options) => {\n      const accepted = await http.request({\n        method: HttpMethod.Post,\n        path: sessionPath(sessionId, '/prompt'),\n        body: {\n          schema: promptSessionRequestSchema,\n          value: {\n            content,\n            turnPolicy: options?.turnPolicy,\n            idempotencyKey: options?.idempotencyKey ?? context.newKey(),\n            meta: options?.meta,\n            clientSubmittedAtMs: options?.clientSubmittedAtMs ?? context.now(),\n          },\n        },\n        response: promptAcceptedSchema,\n        signal: options?.signal,\n        context: { sessionId },\n      });\n      return turnHandle({ context, sessionId, accepted });\n    },\n    observe: (content, options) =>\n      post({\n        suffix: '/observe',\n        body: {\n          schema: observeSessionRequestSchema,\n          value: {\n            content,\n            idempotencyKey: options?.idempotencyKey ?? context.newKey(),\n            meta: options?.meta,\n          },\n        },\n        signal: options?.signal,\n      }),\n    stream: (options) =>\n      streamSessionFrames({\n        sessionId,\n        fromSeq: options?.fromSeq ?? FIRST_ACP_FRAME_SEQ,\n        follow: options?.follow ?? true,\n        ...frameSources({ context, sessionId }),\n        transport: context.realtime(),\n        timing: context.timing,\n        signal: options?.signal,\n        closeSignal: context.closeSignal,\n      }),\n    liveEvents: (options) =>\n      streamSessionLiveEvents({ context, sessionId, signal: options?.signal }),\n    previews: (options) => streamPreviews({ context, sessionId, signal: options?.signal }),\n    frames: (options) => replay({ context, sessionId, ...options }),\n    pending: (options) => openPending({ context, sessionId, signal: options?.signal }),\n    turn: (turnId, options) => getTurn({ context, sessionId, turnId, signal: options?.signal }),\n    response: async (turnId, options) => {\n      const receipt = await getTurn({ context, sessionId, turnId, signal: options?.signal });\n      return turnHandle({\n        context,\n        sessionId,\n        accepted: {\n          turnId: receipt.id,\n          messageId: receipt.promptMessageId,\n          fromSeq: receipt.fromSeq,\n        },\n      });\n    },\n    respond: (args, options) =>\n      http.request({\n        method: HttpMethod.Post,\n        path: sessionPath(sessionId, '/respond'),\n        body: {\n          schema: respondPendingRequestSchema,\n          value: { pendingId: args.pendingId, outcome: outcomeOf(args) },\n        },\n        response: respondPendingResponseSchema,\n        signal: options?.signal,\n        context: { sessionId, pendingId: args.pendingId },\n      }),\n    cancel: (options) =>\n      post({\n        suffix: '/cancel',\n        body: { schema: cancelRequestSchema, value: { reason: options?.reason } },\n        signal: options?.signal,\n      }),\n    setConfigOption: (args, options) =>\n      post({\n        suffix: '/config-option',\n        body: { schema: setConfigOptionRequestSchema, value: args },\n        signal: options?.signal,\n      }),\n    close: (options) => post({ suffix: '/close', signal: options?.signal }),\n  };\n};\n\nexport const createSessionsApi = (context: ClientContextIface): SessionsApiIface => ({\n  create: async (args) => {\n    const created = await context.http.request({\n      method: HttpMethod.Post,\n      path: '/v1/sessions',\n      body: {\n        schema: createSessionRequestSchema,\n        value: {\n          agent: args.agent,\n          revisionId: args.revisionId,\n          message: args.message,\n          turnPolicy: args.turnPolicy,\n          idempotencyKey:\n            args.idempotencyKey ?? (args.message == null ? undefined : context.newKey()),\n          title: args.title,\n          meta: args.meta,\n          clientSubmittedAtMs:\n            args.message == null ? undefined : (args.clientSubmittedAtMs ?? context.now()),\n        },\n      },\n      response: createSessionResponseSchema,\n      signal: args.signal,\n    });\n    const handle = createSessionHandle(context, created.session.id);\n    return {\n      session: created.session,\n      handle,\n      response:\n        created.turn == null\n          ? null\n          : turnHandle({ context, sessionId: created.session.id, accepted: created.turn }),\n    };\n  },\n  fork: (sessionId, options) => createSessionHandle(context, sessionId).fork(options),\n  get: (sessionId, options) => createSessionHandle(context, sessionId).get(options),\n  attach: (sessionId) => createSessionHandle(context, sessionId),\n});\n"],
-  "mappings": "AACA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAcK;AACP,SAAS,qBAAqB,kBAAkB,iBAAiB;AACjE,SAAS,kBAAkB,mBAAmB;AAC9C;AAAA,EACE;AAAA,OAIK;AACP,SAAS,yBAAyB,iCAAiC;AACnE,SAAS,8BAA8B;AACvC,SAAS,2BAA2B;AACpC,SAAS,kBAAsC;AAC/C,SAAS,+BAAsD;AAuIxD,MAAM,YAAY,CAAC,SACxB,cAAc,OAAO,EAAE,SAAS,YAAY,UAAU,KAAK,SAAS,IAAI,KAAK;AAE/E,MAAM,cAAc,CAAC,WAAmB,SAAS,OAC/C,gBAAgB,WAAW,SAAS,CAAC,GAAG,MAAM;AAQhD,MAAM,aAAa,CACjB,SAC+B;AAC/B,QAAM,EAAE,SAAS,WAAW,SAAS,IAAI;AACzC,QAAM,MAAM,CAAC,YACX,QAAQ,EAAE,SAAS,WAAW,QAAQ,SAAS,QAAQ,QAAQ,SAAS,OAAO,CAAC;AAClF,QAAM,SAAS,CAAC,YAA4E;AAG1F,QAAI,cAAc,SAAS,aAAa,QAAQ,SAAS,WAAW;AACpE,QAAI,UAAU;AACd,UAAM,SAAS,oBAAoB;AAAA,MACjC;AAAA,MACA,SAAS,SAAS,WAAW;AAAA,MAC7B,QAAQ;AAAA,MACR,GAAG,aAAa,EAAE,SAAS,UAAU,CAAC;AAAA,MACtC,WAAW,QAAQ,SAAS;AAAA,MAC5B,QAAQ,QAAQ;AAAA,MAChB,QAAQ,SAAS;AAAA,MACjB,aAAa,QAAQ;AAAA,MACrB,UAAU,OAAO,WAAW;AAC1B,cAAM,UAAU,MAAM,IAAI,EAAE,OAAO,CAAC;AACpC,eAAO,QAAQ,WAAW,OAAO,OAAO,EAAE,YAAY,QAAQ,SAAS,EAAE;AAAA,MAC3E;AAAA,MACA,OAAO,CAAC,UAAU;AAChB,YACE,CAAC,eACD,SAAS,aAAa,QACtB,iBAAiB,OAAO,SAAS,SAAS;AAE1C,wBAAc;AAChB,eAAO,eAAe,UAAU,KAAK,KAAK;AAAA,MAC5C;AAAA,IACF,CAAC;AACD,UAAM,WAAsD;AAAA,MAC1D,MAAM,YAAY;AAChB,mBAAS;AACP,gBAAM,OAAO,MAAM,OAAO,KAAK;AAC/B,cAAI,KAAK,SAAS,QAAQ,QAAS,QAAO;AAC1C,cAAI,SAAS,aAAa,QAAQ,iBAAiB,KAAK,OAAO,SAAS,SAAS,GAAG;AAClF,sBAAU;AACV,mBAAO;AAAA,UACT;AAAA,QACF;AAAA,MACF;AAAA,MACA,QAAQ,MAAM,OAAO,SAAS,KAAK,QAAQ,QAAQ,EAAE,MAAM,MAAM,OAAO,OAAU,CAAC;AAAA,MACnF,CAAC,OAAO,aAAa,GAAG,MAAM;AAAA,IAChC;AACA,WAAO;AAAA,EACT;AAEA,QAAM,SAAS,OAAO,YAAsE;AAC1F,UAAM,OAAO,oBAAoB;AACjC,QAAI,OAAkC;AACtC,qBAAiB,SAAS,OAAO,OAAO,GAAG;AACzC,WAAK,IAAI,KAAK;AACd,aAAO;AAAA,IACT;AACA,UAAM,MAAM,QAAQ,OAAO,OAAO,UAAU,IAAI;AAChD,UAAM,UAAU,MAAM,IAAI,OAAO;AACjC,WAAO;AAAA,MACL,WAAW,SAAS;AAAA,MACpB,QAAQ,SAAS;AAAA,MACjB,YAAY,QAAQ,cAAc,KAAK,cAAc;AAAA,MACrD,MAAM,KAAK,KAAK;AAAA,MAChB,OAAO,QAAQ,SAAS,MAAM,OAAO,SAAS,WAAW;AAAA,IAC3D;AAAA,EACF;AAEA,SAAO,EAAE,GAAG,UAAU,WAAW,KAAK,QAAQ,OAAO;AACvD;AAEA,MAAM,UAAU,CAAC,SAMf,KAAK,QAAQ,KAAK,QAAQ;AAAA,EACxB,QAAQ,WAAW;AAAA,EACnB,MAAM,YAAY,KAAK,WAAW,UAAU,WAAW,KAAK,MAAM,CAAC,EAAE;AAAA,EACrE,UAAU;AAAA,EACV,QAAQ,KAAK;AACf,CAAC;AASH,MAAM,SAAS,CAAC,SACd,KAAK,QAAQ,KAAK,QAAQ;AAAA,EACxB,QAAQ,WAAW;AAAA,EACnB,MAAM,YAAY,KAAK,WAAW,SAAS;AAAA,EAC3C,OAAO,EAAE,SAAS,KAAK,SAAS,OAAO,KAAK,MAAM;AAAA,EAClD,UAAU;AAAA,EACV,QAAQ,KAAK;AACf,CAAC;AAEH,MAAM,cAAc,OAAO,UAMvB,MAAM,KAAK,QAAQ,KAAK,QAAQ;AAAA,EAC9B,QAAQ,WAAW;AAAA,EACnB,MAAM,YAAY,KAAK,WAAW,UAAU;AAAA,EAC5C,UAAU;AAAA,EACV,QAAQ,KAAK;AACf,CAAC,GACD;AAGJ,gBAAgB,qBAAqB,MAKE;AACrC,mBAAiB,WAAW,uBAAuB;AAAA,IACjD,MAAM,KAAK,QAAQ;AAAA,IACnB,MAAM,YAAY,KAAK,WAAW,gBAAgB;AAAA,IAClD,OAAO,EAAE,SAAS,KAAK,QAAQ;AAAA,IAC/B,QAAQ,YAAY,IAAI,CAAC,KAAK,QAAQ,KAAK,QAAQ,WAAW,CAAC;AAAA,EACjE,CAAC,GAAG;AACF,QAAI,QAAQ,UAAU,kBAAkB,SAAU;AAClD,QAAI;AACF,YAAM,QAAQ,oBAAoB,UAAU,KAAK,MAAM,QAAQ,IAAI,CAAC;AACpE,UAAI,MAAM,QAAS,OAAM,MAAM;AAAA,IACjC,QAAQ;AAAA,IAER;AAAA,EACF;AACF;AAGA,MAAM,iBAAiB,CAAC,SAI2B;AACjD,QAAM,QAAQ,oBAAoB,QAAQ,KAAK,SAAS;AACxD,MAAI,cAAmC;AACvC,MAAI,cAA0B,MAAM;AAAA,EAAC;AACrC,MAAI,cAA0B,MAAM;AAAA,EAAC;AACrC,QAAM,QAAQ,iBAAuC,MAAM;AACzD,kBAAc;AACd,gBAAY;AACZ,gBAAY;AAAA,EACd,CAAC;AACD,QAAM,UAAU,CAAC,QAA2C;AAC1D,UAAM,QAAQ,yBAAyB,UAAU,GAAG;AACpD,QAAI,CAAC,MAAM,QAAS;AACpB,QAAI,MAAM,KAAK,SAAS,uBAAuB,SAAS,wBAAwB,MAAM,IAAI,GAAG;AAC3F,YAAM;AAAA,QACJ,0BAA0B;AAAA,UACxB,OAAO,MAAM,KAAK,SAAS;AAAA,UAC3B,MAAM,MAAM,KAAK,QAAQ;AAAA,UACzB,SAAS,MAAM,KAAK,WAAW;AAAA,QACjC,CAAC;AAAA,MACH;AACA;AAAA,IACF;AACA,QAAI,MAAM,KAAK,SAAS,uBAAuB,MAAO;AACtD,QAAI,MAAM,KAAK,SAAS,kBAAkB,WAAY;AACtD,UAAM,UAAU,sBAAsB,UAAU,MAAM,KAAK,OAAO;AAClE,QAAI,QAAQ,QAAS,OAAM,KAAK,QAAQ,IAAI;AAAA,EAC9C;AACA,gBAAc,YAAY,OAAO,KAAK,MAAM;AAC5C,gBAAc,YAAY,OAAO,KAAK,QAAQ,WAAW;AACzD,MAAI,CAAC,MAAM,OAAO,GAAG;AACnB,UAAM,OAAO,KAAK,QAAQ,SAAS,EAAE,UAAU,OAAO,OAAO;AAC7D,QAAI,MAAM,OAAO,EAAG,MAAK;AAAA,QACpB,eAAc;AAAA,EACrB;AACA,SAAO,MAAM;AACf;AAGA,MAAM,eAAe,CAAC,UAA8D;AAAA,EAClF,QAAQ,CAAC,SACP,OAAO,EAAE,SAAS,KAAK,SAAS,WAAW,KAAK,WAAW,GAAG,KAAK,CAAC;AAAA,EACtE,SAAS,CAAC,WAAyB,YAAY,EAAE,GAAG,MAAM,OAAO,CAAC;AAAA,EAClE,YAAY,CAAC,WACX,qBAAqB,EAAE,GAAG,MAAM,GAAG,OAAO,CAAC;AAC/C;AAEO,MAAM,sBAAsB,CACjC,SACA,cACuB;AACvB,QAAM,EAAE,KAAK,IAAI;AACjB,QAAM,OAAO,OAAO,SAIC;AACnB,UAAM,KAAK,QAAQ;AAAA,MACjB,QAAQ,WAAW;AAAA,MACnB,MAAM,YAAY,WAAW,KAAK,MAAM;AAAA,MACxC,MAAM,KAAK;AAAA,MACX,UAAU;AAAA,MACV,QAAQ,KAAK;AAAA,MACb,SAAS,EAAE,UAAU;AAAA,IACvB,CAAC;AAAA,EACH;AAEA,SAAO;AAAA,IACL,IAAI;AAAA,IACJ,MAAM,OAAO,YAAY;AACvB,YAAM,UAAU,MAAM,KAAK,QAAQ;AAAA,QACjC,QAAQ,WAAW;AAAA,QACnB,MAAM,YAAY,WAAW,OAAO;AAAA,QACpC,MAAM;AAAA,UACJ,QAAQ;AAAA,UACR,OAAO;AAAA,YACL,gBAAgB,SAAS,kBAAkB,QAAQ,OAAO;AAAA,YAC1D,OAAO,SAAS;AAAA,UAClB;AAAA,QACF;AAAA,QACA,UAAU;AAAA,QACV,QAAQ,SAAS;AAAA,QACjB,SAAS,EAAE,UAAU;AAAA,MACvB,CAAC;AACD,aAAO;AAAA,QACL,SAAS,QAAQ;AAAA,QACjB,QAAQ,oBAAoB,SAAS,QAAQ,QAAQ,EAAE;AAAA,QACvD,UAAU;AAAA,MACZ;AAAA,IACF;AAAA,IACA,YAAY,CAAC,cAAc,YACzB,KAAK,QAAQ;AAAA,MACX,QAAQ,WAAW;AAAA,MACnB,MAAM,YAAY,WAAW,gBAAgB,WAAW,YAAY,CAAC,EAAE;AAAA,MACvE,UAAU;AAAA,MACV,QAAQ,SAAS;AAAA,IACnB,CAAC;AAAA,IACH,KAAK,CAAC,YACJ,KAAK,QAAQ;AAAA,MACX,QAAQ,WAAW;AAAA,MACnB,MAAM,YAAY,SAAS;AAAA,MAC3B,UAAU;AAAA,MACV,QAAQ,SAAS;AAAA,IACnB,CAAC;AAAA,IACH,UAAU,CAAC,YACT,KAAK,QAAQ;AAAA,MACX,QAAQ,WAAW;AAAA,MACnB,MAAM,YAAY,WAAW,WAAW;AAAA,MACxC,UAAU;AAAA,MACV,QAAQ,SAAS;AAAA,IACnB,CAAC;AAAA,IACH,MAAM,OAAO,SAAS,YAAY;AAChC,YAAM,WAAW,MAAM,KAAK,QAAQ;AAAA,QAClC,QAAQ,WAAW;AAAA,QACnB,MAAM,YAAY,WAAW,SAAS;AAAA,QACtC,MAAM;AAAA,UACJ,QAAQ;AAAA,UACR,OAAO;AAAA,YACL;AAAA,YACA,YAAY,SAAS;AAAA,YACrB,gBAAgB,SAAS,kBAAkB,QAAQ,OAAO;AAAA,YAC1D,MAAM,SAAS;AAAA,YACf,qBAAqB,SAAS,uBAAuB,QAAQ,IAAI;AAAA,UACnE;AAAA,QACF;AAAA,QACA,UAAU;AAAA,QACV,QAAQ,SAAS;AAAA,QACjB,SAAS,EAAE,UAAU;AAAA,MACvB,CAAC;AACD,aAAO,WAAW,EAAE,SAAS,WAAW,SAAS,CAAC;AAAA,IACpD;AAAA,IACA,SAAS,CAAC,SAAS,YACjB,KAAK;AAAA,MACH,QAAQ;AAAA,MACR,MAAM;AAAA,QACJ,QAAQ;AAAA,QACR,OAAO;AAAA,UACL;AAAA,UACA,gBAAgB,SAAS,kBAAkB,QAAQ,OAAO;AAAA,UAC1D,MAAM,SAAS;AAAA,QACjB;AAAA,MACF;AAAA,MACA,QAAQ,SAAS;AAAA,IACnB,CAAC;AAAA,IACH,QAAQ,CAAC,YACP,oBAAoB;AAAA,MAClB;AAAA,MACA,SAAS,SAAS,WAAW;AAAA,MAC7B,QAAQ,SAAS,UAAU;AAAA,MAC3B,GAAG,aAAa,EAAE,SAAS,UAAU,CAAC;AAAA,MACtC,WAAW,QAAQ,SAAS;AAAA,MAC5B,QAAQ,QAAQ;AAAA,MAChB,QAAQ,SAAS;AAAA,MACjB,aAAa,QAAQ;AAAA,IACvB,CAAC;AAAA,IACH,YAAY,CAAC,YACX,wBAAwB,EAAE,SAAS,WAAW,QAAQ,SAAS,OAAO,CAAC;AAAA,IACzE,UAAU,CAAC,YAAY,eAAe,EAAE,SAAS,WAAW,QAAQ,SAAS,OAAO,CAAC;AAAA,IACrF,QAAQ,CAAC,YAAY,OAAO,EAAE,SAAS,WAAW,GAAG,QAAQ,CAAC;AAAA,IAC9D,SAAS,CAAC,YAAY,YAAY,EAAE,SAAS,WAAW,QAAQ,SAAS,OAAO,CAAC;AAAA,IACjF,MAAM,CAAC,QAAQ,YAAY,QAAQ,EAAE,SAAS,WAAW,QAAQ,QAAQ,SAAS,OAAO,CAAC;AAAA,IAC1F,UAAU,OAAO,QAAQ,YAAY;AACnC,YAAM,UAAU,MAAM,QAAQ,EAAE,SAAS,WAAW,QAAQ,QAAQ,SAAS,OAAO,CAAC;AACrF,aAAO,WAAW;AAAA,QAChB;AAAA,QACA;AAAA,QACA,UAAU;AAAA,UACR,QAAQ,QAAQ;AAAA,UAChB,WAAW,QAAQ;AAAA,UACnB,SAAS,QAAQ;AAAA,QACnB;AAAA,MACF,CAAC;AAAA,IACH;AAAA,IACA,SAAS,CAAC,MAAM,YACd,KAAK,QAAQ;AAAA,MACX,QAAQ,WAAW;AAAA,MACnB,MAAM,YAAY,WAAW,UAAU;AAAA,MACvC,MAAM;AAAA,QACJ,QAAQ;AAAA,QACR,OAAO,EAAE,WAAW,KAAK,WAAW,SAAS,UAAU,IAAI,EAAE;AAAA,MAC/D;AAAA,MACA,UAAU;AAAA,MACV,QAAQ,SAAS;AAAA,MACjB,SAAS,EAAE,WAAW,WAAW,KAAK,UAAU;AAAA,IAClD,CAAC;AAAA,IACH,QAAQ,CAAC,YACP,KAAK;AAAA,MACH,QAAQ;AAAA,MACR,MAAM,EAAE,QAAQ,qBAAqB,OAAO,EAAE,QAAQ,SAAS,OAAO,EAAE;AAAA,MACxE,QAAQ,SAAS;AAAA,IACnB,CAAC;AAAA,IACH,iBAAiB,CAAC,MAAM,YACtB,KAAK;AAAA,MACH,QAAQ;AAAA,MACR,MAAM,EAAE,QAAQ,8BAA8B,OAAO,KAAK;AAAA,MAC1D,QAAQ,SAAS;AAAA,IACnB,CAAC;AAAA,IACH,OAAO,CAAC,YAAY,KAAK,EAAE,QAAQ,UAAU,QAAQ,SAAS,OAAO,CAAC;AAAA,EACxE;AACF;AAEO,MAAM,oBAAoB,CAAC,aAAmD;AAAA,EACnF,QAAQ,OAAO,SAAS;AACtB,UAAM,UAAU,MAAM,QAAQ,KAAK,QAAQ;AAAA,MACzC,QAAQ,WAAW;AAAA,MACnB,MAAM;AAAA,MACN,MAAM;AAAA,QACJ,QAAQ;AAAA,QACR,OAAO;AAAA,UACL,OAAO,KAAK;AAAA,UACZ,YAAY,KAAK;AAAA,UACjB,SAAS,KAAK;AAAA,UACd,YAAY,KAAK;AAAA,UACjB,gBACE,KAAK,mBAAmB,KAAK,WAAW,OAAO,SAAY,QAAQ,OAAO;AAAA,UAC5E,OAAO,KAAK;AAAA,UACZ,MAAM,KAAK;AAAA,UACX,qBACE,KAAK,WAAW,OAAO,SAAa,KAAK,uBAAuB,QAAQ,IAAI;AAAA,QAChF;AAAA,MACF;AAAA,MACA,UAAU;AAAA,MACV,QAAQ,KAAK;AAAA,IACf,CAAC;AACD,UAAM,SAAS,oBAAoB,SAAS,QAAQ,QAAQ,EAAE;AAC9D,WAAO;AAAA,MACL,SAAS,QAAQ;AAAA,MACjB;AAAA,MACA,UACE,QAAQ,QAAQ,OACZ,OACA,WAAW,EAAE,SAAS,WAAW,QAAQ,QAAQ,IAAI,UAAU,QAAQ,KAAK,CAAC;AAAA,IACrF;AAAA,EACF;AAAA,EACA,MAAM,CAAC,WAAW,YAAY,oBAAoB,SAAS,SAAS,EAAE,KAAK,OAAO;AAAA,EAClF,KAAK,CAAC,WAAW,YAAY,oBAAoB,SAAS,SAAS,EAAE,IAAI,OAAO;AAAA,EAChF,QAAQ,CAAC,cAAc,oBAAoB,SAAS,SAAS;AAC/D;",
+  "sourcesContent": ["import type { JsonObjectIface, JsonValue } from '@finalai/agent-protocol';\nimport {\n  acpFrameEventSchema,\n  acpPreviewEventSchema,\n  agentRealtimeFrameSchema,\n  AgentRealtimeFrameType,\n  AgentRealtimeKind,\n  agentRealtimeTopics,\n  attachmentDownloadSchema,\n  cancelRequestSchema,\n  createSessionRequestSchema,\n  createSessionResponseSchema,\n  FIRST_ACP_FRAME_SEQ,\n  forkSessionRequestSchema,\n  observeSessionRequestSchema,\n  decisionRecordListSchema,\n  okResponseSchema,\n  promptAcceptedSchema,\n  promptSessionRequestSchema,\n  respondDecisionResponseSchema,\n  respondDecisionSchema,\n  sessionFramesPageSchema,\n  sessionManifestSchema,\n  sessionSchema,\n  setConfigOptionRequestSchema,\n  turnSchema,\n  type AcpFrameEventIface,\n  type AcpPreviewEventIface,\n  type AgentSessionIface,\n  type AgentTurnIface,\n  type AgentTurnPolicy,\n  type AttachmentDownloadIface,\n  type ContentInput,\n  type DecisionOutcomeInput,\n  type DecisionRecordIface,\n  type PromptAcceptedIface,\n  type RespondDecisionResponseIface,\n  type SessionFramesPageIface,\n  type SessionManifestIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { createTextCollector, isUserMessageFor, turnEndOf } from \"./acp-frames.mjs\";\nimport { createAsyncQueue, failOnAbort } from \"./async-queue.mjs\";\nimport {\n  encodePath,\n  type ClientContextIface,\n  type EnumInput,\n  type SignalOptionsIface,\n} from \"./context.mjs\";\nimport { isTerminalRealtimeError, realtimeSubscriptionError } from \"./errors.mjs\";\nimport { streamServerSentEvents } from \"./event-stream.mjs\";\nimport { streamSessionFrames } from \"./frame-stream.mjs\";\nimport { HttpMethod, type HttpBodyIface } from \"./http.mjs\";\nimport { streamSessionLiveEvents, type SessionLiveEvent } from \"./live-stream.mjs\";\nimport type { RealtimeTransportFrameIface } from \"./realtime.mjs\";\n\n/** Answer a decision by option id (permission) or with a full ACP outcome. */\nexport type RespondArgs =\n  | { decisionId: string; optionId: string }\n  | { decisionId: string; outcome: DecisionOutcomeInput };\n\nexport interface StreamOptionsIface extends SignalOptionsIface {\n  /** Inclusive; defaults to `FIRST_ACP_FRAME_SEQ` (the whole log). Earlier values are clamped. */\n  fromSeq?: number;\n  /** Keep streaming live frames after replay catches up; defaults to true. */\n  follow?: boolean;\n}\n\nexport interface TurnResultIface<MessageId extends string | null = string> {\n  messageId: MessageId;\n  turnId: string;\n  stopReason: string | null;\n  /** Visible agent text of the turn. */\n  text: string;\n  /** Seq of the frame that ended the turn. */\n  toSeq: number;\n}\n\n/** An accepted prompt. `stream()` yields this turn's frames; `result()` waits for its end. */\nexport interface TurnHandleIface<MessageId extends string | null = string> extends Omit<\n  PromptAcceptedIface,\n  'messageId'\n> {\n  messageId: MessageId;\n  sessionId: string;\n  get: (options?: SignalOptionsIface) => Promise<AgentTurnIface>;\n  stream: (options?: SignalOptionsIface) => AsyncIterableIterator<AcpFrameEventIface>;\n  result: (options?: SignalOptionsIface) => Promise<TurnResultIface<MessageId>>;\n}\n\nexport interface SendOptionsIface extends SignalOptionsIface {\n  turnPolicy?: EnumInput<AgentTurnPolicy>;\n  idempotencyKey?: string;\n  meta?: JsonObjectIface;\n  /** When the person submitted, for the prompt-to-inference trace; defaults to now. */\n  clientSubmittedAtMs?: number;\n}\n\nexport interface ForkSessionOptionsIface extends SignalOptionsIface {\n  /** Retain this key when retrying an interrupted fork. Defaults to a new key. */\n  idempotencyKey?: string;\n  title?: string;\n}\n\n/** An I/O-free handle on one session; every method is one HTTP call or one stream. */\nexport interface SessionHandleIface {\n  id: string;\n  /** Native fork of an idle source on its pinned revision; the standalone child has fresh scopes. */\n  fork: (options?: ForkSessionOptionsIface) => Promise<CreatedSessionIface>;\n  get: (options?: SignalOptionsIface) => Promise<AgentSessionIface>;\n  /** Resolves a `final-attachment:` resource link from this session's frames. */\n  attachment: (\n    attachmentId: string,\n    options?: SignalOptionsIface,\n  ) => Promise<AttachmentDownloadIface>;\n  send: (content: ContentInput, options?: SendOptionsIface) => Promise<TurnHandleIface>;\n  /** Adds content to history without a model call (`_final/session/observe`). */\n  observe: (\n    content: ContentInput,\n    options?: SignalOptionsIface & { idempotencyKey?: string; meta?: JsonObjectIface },\n  ) => Promise<void>;\n  stream: (options?: StreamOptionsIface) => AsyncIterableIterator<AcpFrameEventIface>;\n  /** Full provisional frames and reset notices; never a durable replay cursor or receipt. */\n  liveEvents: (options?: SignalOptionsIface) => AsyncIterableIterator<SessionLiveEvent>;\n  /**\n   * `acp.preview` events: the text of message and thought chunks as the session\n   * publishes them, live only (never replayed), for surfaces that render text\n   * ahead of the durable frames and the conversation's projected messages.\n   */\n  previews: (options?: SignalOptionsIface) => AsyncIterableIterator<AcpPreviewEventIface>;\n  /** One replay page (`GET /sessions/:id/frames`). */\n  frames: (\n    options: SignalOptionsIface & { fromSeq: number; limit?: number },\n  ) => Promise<SessionFramesPageIface>;\n  /** The session's open decisions (`GET /sessions/:id/decisions`). */\n  decisions: (options?: SignalOptionsIface) => Promise<DecisionRecordIface[]>;\n  turn: (turnId: string, options?: SignalOptionsIface) => Promise<AgentTurnIface>;\n  /** Reconstruct an accepted response from its durable turn id, without resending its prompt. */\n  response: (\n    turnId: string,\n    options?: SignalOptionsIface,\n  ) => Promise<TurnHandleIface<string | null>>;\n  respond: (\n    args: RespondArgs,\n    options?: SignalOptionsIface,\n  ) => Promise<RespondDecisionResponseIface>;\n  cancel: (options?: SignalOptionsIface & { reason?: string }) => Promise<void>;\n  /**\n   * ACP `session/set_config_option` (model, reasoning, mode, ...): `configId` and a value\n   * from the options the harness advertises (`get().configOptions`, `configSelectsOf`).\n   * Changing them takes the session's owner, or a conversation owner or admin.\n   */\n  setConfigOption: (\n    args: { configId: string; value: JsonValue },\n    options?: SignalOptionsIface,\n  ) => Promise<void>;\n  close: (options?: SignalOptionsIface) => Promise<void>;\n  /** Resolved manifest and resolver report; secret-bearing output requires agents:read and admin secret-binding access. */\n  manifest: (options?: SignalOptionsIface) => Promise<SessionManifestIface>;\n}\n\nexport interface CreateSessionArgsIface extends SignalOptionsIface {\n  /** Agent slug or id. */\n  agent: string;\n  /** Pin an author test session to a revision returned by definitions.testRevision. */\n  revisionId?: string;\n  message?: ContentInput;\n  turnPolicy?: EnumInput<AgentTurnPolicy>;\n  idempotencyKey?: string;\n  title?: string;\n  meta?: JsonObjectIface;\n  /** When the person submitted `message`; defaults to now. */\n  clientSubmittedAtMs?: number;\n}\n\nexport interface CreatedSessionIface {\n  session: AgentSessionIface;\n  handle: SessionHandleIface;\n  /** The first turn when `message` was given. */\n  response: TurnHandleIface | null;\n}\n\nexport interface SessionsApiIface {\n  create: (args: CreateSessionArgsIface) => Promise<CreatedSessionIface>;\n  fork: (sessionId: string, options?: ForkSessionOptionsIface) => Promise<CreatedSessionIface>;\n  get: (sessionId: string, options?: SignalOptionsIface) => Promise<AgentSessionIface>;\n  attach: (sessionId: string) => SessionHandleIface;\n}\n\nexport const outcomeOf = (args: RespondArgs): DecisionOutcomeInput =>\n  'optionId' in args ? { outcome: 'selected', optionId: args.optionId } : args.outcome;\n\nconst sessionPath = (sessionId: string, suffix = ''): string =>\n  `/v1/sessions/${encodePath(sessionId)}${suffix}`;\n\ninterface TurnHandleArgsIface<MessageId extends string | null> {\n  context: ClientContextIface;\n  sessionId: string;\n  accepted: Omit<PromptAcceptedIface, 'messageId'> & { messageId: MessageId };\n}\n\nconst turnHandle = <MessageId extends string | null>(\n  args: TurnHandleArgsIface<MessageId>,\n): TurnHandleIface<MessageId> => {\n  const { context, sessionId, accepted } = args;\n  const get = (options?: SignalOptionsIface) =>\n    getTurn({ context, sessionId, turnId: accepted.turnId, signal: options?.signal });\n  const stream = (options?: SignalOptionsIface): AsyncIterableIterator<AcpFrameEventIface> => {\n    // Without the prompt's seq, scan from the start for ACP's user message with this id.\n    // `until` runs as frames are queued and `next` as they are consumed, so each tracks its own start.\n    let queuedStart = accepted.messageId == null && accepted.fromSeq != null;\n    let started = queuedStart;\n    const frames = streamSessionFrames({\n      sessionId,\n      fromSeq: accepted.fromSeq ?? FIRST_ACP_FRAME_SEQ,\n      follow: true,\n      ...frameSources({ context, sessionId }),\n      transport: context.realtime(),\n      timing: context.timing,\n      signal: options?.signal,\n      closeSignal: context.closeSignal,\n      terminal: async (signal) => {\n        const receipt = await get({ signal });\n        return receipt.endedAt == null ? null : { throughSeq: receipt.toSeq ?? 0 };\n      },\n      until: (event) => {\n        if (\n          !queuedStart &&\n          accepted.messageId != null &&\n          isUserMessageFor(event, accepted.messageId)\n        )\n          queuedStart = true;\n        return queuedStart && turnEndOf(event) != null;\n      },\n    });\n    const iterator: AsyncIterableIterator<AcpFrameEventIface> = {\n      next: async () => {\n        for (;;) {\n          const next = await frames.next();\n          if (next.done === true || started) return next;\n          if (accepted.messageId != null && isUserMessageFor(next.value, accepted.messageId)) {\n            started = true;\n            return next;\n          }\n        }\n      },\n      return: () => frames.return?.() ?? Promise.resolve({ done: true, value: undefined }),\n      [Symbol.asyncIterator]: () => iterator,\n    };\n    return iterator;\n  };\n\n  const result = async (options?: SignalOptionsIface): Promise<TurnResultIface<MessageId>> => {\n    const text = createTextCollector();\n    let last: AcpFrameEventIface | null = null;\n    for await (const event of stream(options)) {\n      text.add(event);\n      last = event;\n    }\n    const end = last == null ? null : turnEndOf(last);\n    const receipt = await get(options);\n    return {\n      messageId: accepted.messageId,\n      turnId: accepted.turnId,\n      stopReason: receipt.stopReason ?? end?.stopReason ?? null,\n      text: text.text(),\n      toSeq: receipt.toSeq ?? last?.seq ?? accepted.fromSeq ?? 0,\n    };\n  };\n\n  return { ...accepted, sessionId, get, stream, result };\n};\n\nconst getTurn = (args: {\n  context: ClientContextIface;\n  sessionId: string;\n  turnId: string;\n  signal?: AbortSignal;\n}): Promise<AgentTurnIface> =>\n  args.context.http.request({\n    method: HttpMethod.Get,\n    path: sessionPath(args.sessionId, `/turns/${encodePath(args.turnId)}`),\n    response: turnSchema,\n    signal: args.signal,\n  });\n\ninterface ReplayArgsIface extends SignalOptionsIface {\n  context: ClientContextIface;\n  sessionId: string;\n  fromSeq: number;\n  limit?: number;\n}\n\nconst replay = (args: ReplayArgsIface): Promise<SessionFramesPageIface> =>\n  args.context.http.request({\n    method: HttpMethod.Get,\n    path: sessionPath(args.sessionId, '/frames'),\n    query: { fromSeq: args.fromSeq, limit: args.limit },\n    response: sessionFramesPageSchema,\n    signal: args.signal,\n  });\n\nconst openDecisions = async (args: {\n  context: ClientContextIface;\n  sessionId: string;\n  signal?: AbortSignal;\n}): Promise<DecisionRecordIface[]> =>\n  (\n    await args.context.http.request({\n      method: HttpMethod.Get,\n      path: sessionPath(args.sessionId, '/decisions'),\n      response: decisionRecordListSchema,\n      signal: args.signal,\n    })\n  ).decisions;\n\n/** The session's frames over Streamable HTTP (`GET /sessions/:id/frames/stream`), from `fromSeq`. */\nasync function* streamFramesOverHttp(args: {\n  context: ClientContextIface;\n  sessionId: string;\n  fromSeq: number;\n  signal: AbortSignal;\n}): AsyncGenerator<AcpFrameEventIface> {\n  for await (const message of streamServerSentEvents({\n    http: args.context.http,\n    path: sessionPath(args.sessionId, '/frames/stream'),\n    query: { fromSeq: args.fromSeq },\n    signal: AbortSignal.any([args.signal, args.context.closeSignal]),\n  })) {\n    if (message.event !== AgentRealtimeKind.AcpFrame) continue;\n    try {\n      const event = acpFrameEventSchema.safeParse(JSON.parse(message.data));\n      if (event.success) yield event.data;\n    } catch {\n      // A malformed event is skipped; replay fills any gap it leaves.\n    }\n  }\n}\n\n/** Live `acp.preview` events of the session topic. */\nconst streamPreviews = (args: {\n  context: ClientContextIface;\n  sessionId: string;\n  signal?: AbortSignal;\n}): AsyncIterableIterator<AcpPreviewEventIface> => {\n  const topic = agentRealtimeTopics.session(args.sessionId);\n  let unsubscribe: (() => void) | null = null;\n  let detachAbort: () => void = () => {};\n  let detachClose: () => void = () => {};\n  const queue = createAsyncQueue<AcpPreviewEventIface>(() => {\n    unsubscribe?.();\n    detachAbort();\n    detachClose();\n  });\n  const onFrame = (raw: RealtimeTransportFrameIface): void => {\n    const frame = agentRealtimeFrameSchema.safeParse(raw);\n    if (!frame.success) return;\n    if (frame.data.type === AgentRealtimeFrameType.Error && isTerminalRealtimeError(frame.data)) {\n      queue.fail(\n        realtimeSubscriptionError({\n          topic: frame.data.topic ?? topic,\n          code: frame.data.code ?? 'unknown',\n          message: frame.data.message ?? 'Realtime subscription was refused',\n        }),\n      );\n      return;\n    }\n    if (frame.data.type !== AgentRealtimeFrameType.Event) return;\n    if (frame.data.kind !== AgentRealtimeKind.AcpPreview) return;\n    const preview = acpPreviewEventSchema.safeParse(frame.data.payload);\n    if (preview.success) queue.push(preview.data);\n  };\n  detachAbort = failOnAbort(queue, args.signal);\n  detachClose = failOnAbort(queue, args.context.closeSignal);\n  if (!queue.closed()) {\n    const stop = args.context.realtime().subscribe(topic, onFrame);\n    if (queue.closed()) stop();\n    else unsubscribe = stop;\n  }\n  return queue.iterator;\n};\n\n/** Replay, open decisions and the Streamable HTTP fallback of one session's frame stream. */\nconst frameSources = (args: { context: ClientContextIface; sessionId: string }) => ({\n  replay: (page: { fromSeq: number; limit: number; signal?: AbortSignal }) =>\n    replay({ context: args.context, sessionId: args.sessionId, ...page }),\n  decisions: (signal?: AbortSignal) => openDecisions({ ...args, signal }),\n  httpStream: (stream: { fromSeq: number; signal: AbortSignal }) =>\n    streamFramesOverHttp({ ...args, ...stream }),\n});\n\nexport const createSessionHandle = (\n  context: ClientContextIface,\n  sessionId: string,\n): SessionHandleIface => {\n  const { http } = context;\n  const post = async (args: {\n    suffix: string;\n    body?: HttpBodyIface;\n    signal?: AbortSignal;\n  }): Promise<void> => {\n    await http.request({\n      method: HttpMethod.Post,\n      path: sessionPath(sessionId, args.suffix),\n      body: args.body,\n      response: okResponseSchema,\n      signal: args.signal,\n      context: { sessionId },\n    });\n  };\n\n  return {\n    id: sessionId,\n    fork: async (options) => {\n      const created = await http.request({\n        method: HttpMethod.Post,\n        path: sessionPath(sessionId, '/fork'),\n        body: {\n          schema: forkSessionRequestSchema,\n          value: {\n            idempotencyKey: options?.idempotencyKey ?? context.newKey(),\n            title: options?.title,\n          },\n        },\n        response: createSessionResponseSchema,\n        signal: options?.signal,\n        context: { sessionId },\n      });\n      return {\n        session: created.session,\n        handle: createSessionHandle(context, created.session.id),\n        response: null,\n      };\n    },\n    attachment: (attachmentId, options) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: sessionPath(sessionId, `/attachments/${encodePath(attachmentId)}`),\n        response: attachmentDownloadSchema,\n        signal: options?.signal,\n      }),\n    get: (options) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: sessionPath(sessionId),\n        response: sessionSchema,\n        signal: options?.signal,\n      }),\n    manifest: (options) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: sessionPath(sessionId, '/manifest'),\n        response: sessionManifestSchema,\n        signal: options?.signal,\n      }),\n    send: async (content, options) => {\n      const accepted = await http.request({\n        method: HttpMethod.Post,\n        path: sessionPath(sessionId, '/prompt'),\n        body: {\n          schema: promptSessionRequestSchema,\n          value: {\n            content,\n            turnPolicy: options?.turnPolicy,\n            idempotencyKey: options?.idempotencyKey ?? context.newKey(),\n            meta: options?.meta,\n            clientSubmittedAtMs: options?.clientSubmittedAtMs ?? context.now(),\n          },\n        },\n        response: promptAcceptedSchema,\n        signal: options?.signal,\n        context: { sessionId },\n      });\n      return turnHandle({ context, sessionId, accepted });\n    },\n    observe: (content, options) =>\n      post({\n        suffix: '/observe',\n        body: {\n          schema: observeSessionRequestSchema,\n          value: {\n            content,\n            idempotencyKey: options?.idempotencyKey ?? context.newKey(),\n            meta: options?.meta,\n          },\n        },\n        signal: options?.signal,\n      }),\n    stream: (options) =>\n      streamSessionFrames({\n        sessionId,\n        fromSeq: options?.fromSeq ?? FIRST_ACP_FRAME_SEQ,\n        follow: options?.follow ?? true,\n        ...frameSources({ context, sessionId }),\n        transport: context.realtime(),\n        timing: context.timing,\n        signal: options?.signal,\n        closeSignal: context.closeSignal,\n      }),\n    liveEvents: (options) =>\n      streamSessionLiveEvents({ context, sessionId, signal: options?.signal }),\n    previews: (options) => streamPreviews({ context, sessionId, signal: options?.signal }),\n    frames: (options) => replay({ context, sessionId, ...options }),\n    decisions: (options) => openDecisions({ context, sessionId, signal: options?.signal }),\n    turn: (turnId, options) => getTurn({ context, sessionId, turnId, signal: options?.signal }),\n    response: async (turnId, options) => {\n      const receipt = await getTurn({ context, sessionId, turnId, signal: options?.signal });\n      return turnHandle({\n        context,\n        sessionId,\n        accepted: {\n          turnId: receipt.id,\n          messageId: receipt.promptMessageId,\n          fromSeq: receipt.fromSeq,\n        },\n      });\n    },\n    respond: (args, options) =>\n      http.request({\n        method: HttpMethod.Post,\n        path: sessionPath(sessionId, '/respond'),\n        body: {\n          schema: respondDecisionSchema,\n          value: { decisionId: args.decisionId, outcome: outcomeOf(args) },\n        },\n        response: respondDecisionResponseSchema,\n        signal: options?.signal,\n        context: { sessionId, decisionId: args.decisionId },\n      }),\n    cancel: (options) =>\n      post({\n        suffix: '/cancel',\n        body: { schema: cancelRequestSchema, value: { reason: options?.reason } },\n        signal: options?.signal,\n      }),\n    setConfigOption: (args, options) =>\n      post({\n        suffix: '/config-option',\n        body: { schema: setConfigOptionRequestSchema, value: args },\n        signal: options?.signal,\n      }),\n    close: (options) => post({ suffix: '/close', signal: options?.signal }),\n  };\n};\n\nexport const createSessionsApi = (context: ClientContextIface): SessionsApiIface => ({\n  create: async (args) => {\n    const created = await context.http.request({\n      method: HttpMethod.Post,\n      path: '/v1/sessions',\n      body: {\n        schema: createSessionRequestSchema,\n        value: {\n          agent: args.agent,\n          revisionId: args.revisionId,\n          message: args.message,\n          turnPolicy: args.turnPolicy,\n          idempotencyKey:\n            args.idempotencyKey ?? (args.message == null ? undefined : context.newKey()),\n          title: args.title,\n          meta: args.meta,\n          clientSubmittedAtMs:\n            args.message == null ? undefined : (args.clientSubmittedAtMs ?? context.now()),\n        },\n      },\n      response: createSessionResponseSchema,\n      signal: args.signal,\n    });\n    const handle = createSessionHandle(context, created.session.id);\n    return {\n      session: created.session,\n      handle,\n      response:\n        created.turn == null\n          ? null\n          : turnHandle({ context, sessionId: created.session.id, accepted: created.turn }),\n    };\n  },\n  fork: (sessionId, options) => createSessionHandle(context, sessionId).fork(options),\n  get: (sessionId, options) => createSessionHandle(context, sessionId).get(options),\n  attach: (sessionId) => createSessionHandle(context, sessionId),\n});\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/cli/cli.mjs

@@ -30,7 +30,7 @@ const USAGE = [
   "  --timeout <ms>      conformance: per-case timeout",
   "  --json              conformance: print the report as JSON",
   "",
-  "FINAL_API_KEY authenticates (an organization API key). build checks compatibility only with it.",
+  "FINAL_API_KEY authenticates. build checks compatibility only with it.",
   "FINAL_API_HOST selects the deployment for build and publish; it does not rewrite authored URLs.",
   `dev reads route secrets from AGENT_LOCAL_SECRETS_JSON ({"name": "value"}), limited to the manifest's secrets.`
 ].join("\n");
@@ -114,7 +114,7 @@ const runAgentsCommand = async (deps) => {
       return 2;
     }
     if (apiKey == null) {
-      output.stderr("error: set FINAL_API_KEY to an organization API key");
+      output.stderr("error: set FINAL_API_KEY to a Final API key");
       return 2;
     }
     return runPublish({

package/dist/modules/cli/cli.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/cli/cli.ts"],
-  "sourcesContent": ["import { resolve } from 'node:path';\nimport { parseArgs } from 'node:util';\nimport * as z from 'zod';\nimport { createClient, type AgentClientIface } from \"../agent-client/client.mjs\";\nimport type { FetchIface } from \"../agent-client/http.mjs\";\nimport { runBuild } from \"./build.mjs\";\nimport { runConformance, type ImportModule } from \"./conformance.mjs\";\nimport { DEFAULT_DEV_PORT, runDev } from \"./dev.mjs\";\nimport { gitListFiles, type ListFiles } from \"./files.mjs\";\nimport type { OutputIface } from \"./output.mjs\";\nimport { runPublish } from \"./publish.mjs\";\n\n// Agent CLI commands:\n// `build` and `publish`, plus `dev` and `conformance`. Shipped as the `final-agents` bin until a general\n// `final` CLI exists; `runAgentsCommand` is what `final agents` would mount.\n\n// console-server's proxy to the agent platform API.\n// The session service accepts organization API keys; console-server's proxy is\n// for signed-in users only.\nexport const DEFAULT_AGENTS_HOST = 'https://agent-session.final.ai/api';\n\nconst DEFAULT_COMMIT_MESSAGE = 'Publish with final agents publish';\n\nconst USAGE = [\n  'usage: final-agents <command> [options]',\n  '',\n  'commands:',\n  '  build [dir]                       compile the agent directory and report on its harness',\n  '  dev [dir]                         serve its channel routes at http://localhost:<port>/<channel><path>',\n  '  publish [dir] --agent <slug>      commit the checkout to the agent and publish it',\n  '  conformance <module>              run the harness conformance kit against a harness the module exports',\n  '',\n  'options:',\n  '  --host <url>        agent platform API (overrides FINAL_API_HOST; default ' +\n    DEFAULT_AGENTS_HOST +\n    ')',\n  '  --agent <slug>      publish: the agent definition (slug or id)',\n  '  --ref <ref>         publish: the ref to publish (GitHub-backed agents)',\n  '  --message <text>    publish: commit message',\n  '  --note <text>       publish: revision note',\n  `  --port <port>       dev: port to listen on (default ${DEFAULT_DEV_PORT})`,\n  '  --export <name>     conformance: the export to test (default \"default\"): a HarnessIface or { harness, dial }',\n  '  --profile <name>    conformance: final (default) or plain-acp-v2',\n  '  --timeout <ms>      conformance: per-case timeout',\n  '  --json              conformance: print the report as JSON',\n  '',\n  'FINAL_API_KEY authenticates (an organization API key). build checks compatibility only with it.',\n  'FINAL_API_HOST selects the deployment for build and publish; it does not rewrite authored URLs.',\n  'dev reads route secrets from AGENT_LOCAL_SECRETS_JSON ({\"name\": \"value\"}), limited to the manifest\\'s secrets.',\n].join('\\n');\n\nconst envSchema = z.object({\n  FINAL_API_KEY: z.string().min(1).optional(),\n  FINAL_API_HOST: z.string().url().optional(),\n});\n\nexport interface AgentsCliDepsIface {\n  argv: string[];\n  env: Record<string, string | undefined>;\n  cwd: string;\n  output: OutputIface;\n  // Seams: API requests and the checkout's file listing.\n  fetch?: FetchIface;\n  listFiles?: ListFiles;\n  // Ends long-running commands (dev); main.ts aborts it on SIGINT and SIGTERM.\n  signal?: AbortSignal;\n  // Seam: loads the conformance module (dynamic import by file URL).\n  importModule?: ImportModule;\n}\n\nconst optionsConfig = {\n  host: { type: 'string' },\n  agent: { type: 'string' },\n  ref: { type: 'string' },\n  message: { type: 'string' },\n  note: { type: 'string' },\n  port: { type: 'string' },\n  export: { type: 'string' },\n  profile: { type: 'string' },\n  timeout: { type: 'string' },\n  json: { type: 'boolean' },\n  help: { type: 'boolean', short: 'h' },\n} as const;\n\nconst parseCommandLine = (argv: string[]) =>\n  parseArgs({ args: argv, options: optionsConfig, allowPositionals: true });\n\ntype ParsedResult =\n  | { ok: true; parsed: ReturnType<typeof parseCommandLine> }\n  | { ok: false; message: string };\n\nconst parse = (argv: string[]): ParsedResult => {\n  try {\n    return { ok: true, parsed: parseCommandLine(argv) };\n  } catch (cause) {\n    return { ok: false, message: cause instanceof Error ? cause.message : String(cause) };\n  }\n};\n\nexport const runAgentsCommand = async (deps: AgentsCliDepsIface): Promise<number> => {\n  const { output } = deps;\n  const parsedArgs = parse(deps.argv);\n  if (!parsedArgs.ok) {\n    output.stderr(`error: ${parsedArgs.message}`);\n    output.stderr(USAGE);\n    return 2;\n  }\n  const { values, positionals } = parsedArgs.parsed;\n  const [command, dirArg, ...extra] = positionals;\n  if (values.help === true || command == null || command === 'help') {\n    (command == null && values.help !== true ? output.stderr : output.stdout)(USAGE);\n    return command == null && values.help !== true ? 2 : 0;\n  }\n  if (extra.length > 0) {\n    output.stderr(`error: unexpected arguments: ${extra.join(' ')}`);\n    return 2;\n  }\n  const env = envSchema.safeParse(deps.env);\n  if (!env.success) {\n    output.stderr(\n      'error: FINAL_API_KEY must be nonempty and FINAL_API_HOST must be an absolute URL',\n    );\n    return 2;\n  }\n  const apiKey = env.success ? (env.data.FINAL_API_KEY ?? null) : null;\n  const dir = resolve(deps.cwd, dirArg ?? '.');\n  const client = (key: string): AgentClientIface =>\n    createClient({\n      host: values.host ?? env.data.FINAL_API_HOST ?? DEFAULT_AGENTS_HOST,\n      auth: { apiKey: key },\n      fetch: deps.fetch,\n    });\n\n  if (command === 'build') {\n    return runBuild({ dir, client: apiKey == null ? null : client(apiKey), output });\n  }\n  if (command === 'dev') {\n    const port = values.port == null ? DEFAULT_DEV_PORT : Number(values.port);\n    if (!Number.isInteger(port) || port < 0 || port > 65_535) {\n      output.stderr(`error: --port must be a port number`);\n      return 2;\n    }\n    return runDev({\n      dir,\n      port,\n      env: deps.env,\n      output,\n      signal: deps.signal ?? new AbortController().signal,\n    });\n  }\n  if (command === 'publish') {\n    if (values.agent == null) {\n      output.stderr('error: publish needs --agent <slug>');\n      return 2;\n    }\n    if (apiKey == null) {\n      output.stderr('error: set FINAL_API_KEY to an organization API key');\n      return 2;\n    }\n    return runPublish({\n      dir,\n      agent: values.agent,\n      ref: values.ref ?? null,\n      message: values.message ?? DEFAULT_COMMIT_MESSAGE,\n      note: values.note ?? null,\n      client: client(apiKey),\n      listFiles: deps.listFiles ?? gitListFiles,\n      output,\n    });\n  }\n  if (command === 'conformance') {\n    if (dirArg == null) {\n      output.stderr('error: conformance needs <module>');\n      return 2;\n    }\n    const timeoutMs = values.timeout == null ? null : Number(values.timeout);\n    if (timeoutMs != null && (!Number.isInteger(timeoutMs) || timeoutMs <= 0)) {\n      output.stderr('error: --timeout must be a positive number of milliseconds');\n      return 2;\n    }\n    return runConformance({\n      module: dirArg,\n      exportName: values.export ?? 'default',\n      profile: values.profile ?? 'final',\n      timeoutMs,\n      json: values.json === true,\n      cwd: deps.cwd,\n      output,\n      importModule: deps.importModule,\n      signal: deps.signal,\n    });\n  }\n  output.stderr(`error: unknown command ${command}`);\n  output.stderr(USAGE);\n  return 2;\n};\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { resolve } from 'node:path';\nimport { parseArgs } from 'node:util';\nimport * as z from 'zod';\nimport { createClient, type AgentClientIface } from \"../agent-client/client.mjs\";\nimport type { FetchIface } from \"../agent-client/http.mjs\";\nimport { runBuild } from \"./build.mjs\";\nimport { runConformance, type ImportModule } from \"./conformance.mjs\";\nimport { DEFAULT_DEV_PORT, runDev } from \"./dev.mjs\";\nimport { gitListFiles, type ListFiles } from \"./files.mjs\";\nimport type { OutputIface } from \"./output.mjs\";\nimport { runPublish } from \"./publish.mjs\";\n\n// Agent CLI commands:\n// `build` and `publish`, plus `dev` and `conformance`. Shipped as the `final-agents` bin until a general\n// `final` CLI exists; `runAgentsCommand` is what `final agents` would mount.\n\n// The agents API, authenticated with FINAL_API_KEY.\nexport const DEFAULT_AGENTS_HOST = 'https://agent-session.final.ai/api';\n\nconst DEFAULT_COMMIT_MESSAGE = 'Publish with final agents publish';\n\nconst USAGE = [\n  'usage: final-agents <command> [options]',\n  '',\n  'commands:',\n  '  build [dir]                       compile the agent directory and report on its harness',\n  '  dev [dir]                         serve its channel routes at http://localhost:<port>/<channel><path>',\n  '  publish [dir] --agent <slug>      commit the checkout to the agent and publish it',\n  '  conformance <module>              run the harness conformance kit against a harness the module exports',\n  '',\n  'options:',\n  '  --host <url>        agent platform API (overrides FINAL_API_HOST; default ' +\n    DEFAULT_AGENTS_HOST +\n    ')',\n  '  --agent <slug>      publish: the agent definition (slug or id)',\n  '  --ref <ref>         publish: the ref to publish (GitHub-backed agents)',\n  '  --message <text>    publish: commit message',\n  '  --note <text>       publish: revision note',\n  `  --port <port>       dev: port to listen on (default ${DEFAULT_DEV_PORT})`,\n  '  --export <name>     conformance: the export to test (default \"default\"): a HarnessIface or { harness, dial }',\n  '  --profile <name>    conformance: final (default) or plain-acp-v2',\n  '  --timeout <ms>      conformance: per-case timeout',\n  '  --json              conformance: print the report as JSON',\n  '',\n  'FINAL_API_KEY authenticates. build checks compatibility only with it.',\n  'FINAL_API_HOST selects the deployment for build and publish; it does not rewrite authored URLs.',\n  'dev reads route secrets from AGENT_LOCAL_SECRETS_JSON ({\"name\": \"value\"}), limited to the manifest\\'s secrets.',\n].join('\\n');\n\nconst envSchema = z.object({\n  FINAL_API_KEY: z.string().min(1).optional(),\n  FINAL_API_HOST: z.string().url().optional(),\n});\n\nexport interface AgentsCliDepsIface {\n  argv: string[];\n  env: Record<string, string | undefined>;\n  cwd: string;\n  output: OutputIface;\n  // Seams: API requests and the checkout's file listing.\n  fetch?: FetchIface;\n  listFiles?: ListFiles;\n  // Ends long-running commands (dev); main.ts aborts it on SIGINT and SIGTERM.\n  signal?: AbortSignal;\n  // Seam: loads the conformance module (dynamic import by file URL).\n  importModule?: ImportModule;\n}\n\nconst optionsConfig = {\n  host: { type: 'string' },\n  agent: { type: 'string' },\n  ref: { type: 'string' },\n  message: { type: 'string' },\n  note: { type: 'string' },\n  port: { type: 'string' },\n  export: { type: 'string' },\n  profile: { type: 'string' },\n  timeout: { type: 'string' },\n  json: { type: 'boolean' },\n  help: { type: 'boolean', short: 'h' },\n} as const;\n\nconst parseCommandLine = (argv: string[]) =>\n  parseArgs({ args: argv, options: optionsConfig, allowPositionals: true });\n\ntype ParsedResult =\n  | { ok: true; parsed: ReturnType<typeof parseCommandLine> }\n  | { ok: false; message: string };\n\nconst parse = (argv: string[]): ParsedResult => {\n  try {\n    return { ok: true, parsed: parseCommandLine(argv) };\n  } catch (cause) {\n    return { ok: false, message: cause instanceof Error ? cause.message : String(cause) };\n  }\n};\n\nexport const runAgentsCommand = async (deps: AgentsCliDepsIface): Promise<number> => {\n  const { output } = deps;\n  const parsedArgs = parse(deps.argv);\n  if (!parsedArgs.ok) {\n    output.stderr(`error: ${parsedArgs.message}`);\n    output.stderr(USAGE);\n    return 2;\n  }\n  const { values, positionals } = parsedArgs.parsed;\n  const [command, dirArg, ...extra] = positionals;\n  if (values.help === true || command == null || command === 'help') {\n    (command == null && values.help !== true ? output.stderr : output.stdout)(USAGE);\n    return command == null && values.help !== true ? 2 : 0;\n  }\n  if (extra.length > 0) {\n    output.stderr(`error: unexpected arguments: ${extra.join(' ')}`);\n    return 2;\n  }\n  const env = envSchema.safeParse(deps.env);\n  if (!env.success) {\n    output.stderr(\n      'error: FINAL_API_KEY must be nonempty and FINAL_API_HOST must be an absolute URL',\n    );\n    return 2;\n  }\n  const apiKey = env.success ? (env.data.FINAL_API_KEY ?? null) : null;\n  const dir = resolve(deps.cwd, dirArg ?? '.');\n  const client = (key: string): AgentClientIface =>\n    createClient({\n      host: values.host ?? env.data.FINAL_API_HOST ?? DEFAULT_AGENTS_HOST,\n      auth: { apiKey: key },\n      fetch: deps.fetch,\n    });\n\n  if (command === 'build') {\n    return runBuild({ dir, client: apiKey == null ? null : client(apiKey), output });\n  }\n  if (command === 'dev') {\n    const port = values.port == null ? DEFAULT_DEV_PORT : Number(values.port);\n    if (!Number.isInteger(port) || port < 0 || port > 65_535) {\n      output.stderr(`error: --port must be a port number`);\n      return 2;\n    }\n    return runDev({\n      dir,\n      port,\n      env: deps.env,\n      output,\n      signal: deps.signal ?? new AbortController().signal,\n    });\n  }\n  if (command === 'publish') {\n    if (values.agent == null) {\n      output.stderr('error: publish needs --agent <slug>');\n      return 2;\n    }\n    if (apiKey == null) {\n      output.stderr('error: set FINAL_API_KEY to a Final API key');\n      return 2;\n    }\n    return runPublish({\n      dir,\n      agent: values.agent,\n      ref: values.ref ?? null,\n      message: values.message ?? DEFAULT_COMMIT_MESSAGE,\n      note: values.note ?? null,\n      client: client(apiKey),\n      listFiles: deps.listFiles ?? gitListFiles,\n      output,\n    });\n  }\n  if (command === 'conformance') {\n    if (dirArg == null) {\n      output.stderr('error: conformance needs <module>');\n      return 2;\n    }\n    const timeoutMs = values.timeout == null ? null : Number(values.timeout);\n    if (timeoutMs != null && (!Number.isInteger(timeoutMs) || timeoutMs <= 0)) {\n      output.stderr('error: --timeout must be a positive number of milliseconds');\n      return 2;\n    }\n    return runConformance({\n      module: dirArg,\n      exportName: values.export ?? 'default',\n      profile: values.profile ?? 'final',\n      timeoutMs,\n      json: values.json === true,\n      cwd: deps.cwd,\n      output,\n      importModule: deps.importModule,\n      signal: deps.signal,\n    });\n  }\n  output.stderr(`error: unknown command ${command}`);\n  output.stderr(USAGE);\n  return 2;\n};\n"],
+  "mappings": "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",
   "names": []
 }

package/examples/release-scout/README.md

@@ -2,7 +2,7 @@
 
 `client.ts` exports separate operations so you choose which account mutations to run. Install `@finalai/agents` in a Node 26 project and import `connect`, `directSession`, `directConversation`, `groupConversation`, or `publish`. Create and publish Release Scout first; groups also require Deploy Bot. User participant IDs come from `client.people.all()`.
 
-Every function accepts an abort signal. Pending requests are reported for the caller to inspect: answer a permission with `conversation.respond({ pendingId, optionId })`, choosing an actual option from the pending request, or answer an elicitation with its ACP outcome. No example approves a request automatically. Use `conversation.cancel()` to stop every agent in a room; `client.close()` stops local subscriptions and releases owned realtime connections.
+Every function accepts an abort signal. Decisions are reported for the caller to inspect: answer a permission with `conversation.respond({ decisionId, optionId })`, choosing an actual option from the decision, or answer an elicitation with its ACP outcome. No example approves a request automatically. Use `conversation.cancel()` to stop every agent in a room; `client.close()` stops local subscriptions and releases owned realtime connections.
 
 Definition publication compiles the repository ref and activates its definition schedules and channels. It is an explicit operation. Use `definitions.compile()` or `definitions.testRevision()` for an unpublished snapshot. `schedules.runNow({ agent: 'release-scout', key: 'daily-digest' })` triggers an existing schedule. `client.acp.connect({ agent: 'release-scout' })` opens a native ACP client connection.
 

package/examples/release-scout/client.ts

@@ -17,7 +17,7 @@ export const directSession = async (client: AgentClientIface, signal?: AbortSign
     for await (const event of response.stream({ signal })) {
       const update = sessionUpdateOf(event);
       if (update?.sessionUpdate === 'agent_message_chunk') process.stdout.write(textOf(update));
-      if (event.pendingId != null) console.log('Awaiting a decision:', event.pendingId);
+      if (event.decisionId != null) console.log('Awaiting a decision:', event.decisionId);
     }
     console.log((await response.result({ signal })).stopReason);
     await handle.observe('The release was moved to Friday.', { signal });
@@ -54,7 +54,7 @@ export const directConversation = async (client: AgentClientIface, signal?: Abor
     for await (const event of response.stream({ signal })) {
       const update = sessionUpdateOf(event);
       if (update?.sessionUpdate === 'agent_message_chunk') process.stdout.write(textOf(update));
-      if (event.pendingId != null) console.log('Decision required:', event.pendingId);
+      if (event.decisionId != null) console.log('Decision required:', event.decisionId);
     }
     console.log((await response.result({ signal })).stopReason);
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finalai/agents",
-  "version": "0.4.4",
+  "version": "0.6.0",
   "private": false,
   "description": "Agent authoring, client APIs, and CLI.",
   "license": "Apache-2.0",
@@ -105,10 +105,10 @@
   },
   "dependencies": {
     "@agentclientprotocol/sdk": "1.8.0",
-    "@finalai/agent-definition": "0.4.3",
-    "@finalai/agent-protocol": "0.4.2",
-    "@finalai/agent-provider": "0.4.3",
-    "@finalai/final-agent-provider": "0.4.4",
+    "@finalai/agent-definition": "0.5.1",
+    "@finalai/agent-protocol": "0.6.0",
+    "@finalai/agent-provider": "0.5.1",
+    "@finalai/final-agent-provider": "0.6.0",
     "@finalai/websockets": "0.1.6",
     "ws": "^8.21.3",
     "zod": "4.6.5"