@finalai/agents 0.13.0 → 0.14.0

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

@@ -39,7 +39,6 @@ const providePatchOf = (patch) => ({
   ...patch.harness == null ? {} : { harness: patch.harness },
   ...patch.compute == null ? {} : { compute: computePatchOf(patch.compute) },
   ...patch.integrations == null ? {} : { integrations: slotPatchOf(patch.integrations) },
-  ...patch.instructions === void 0 ? {} : { instructions: patch.instructions },
   ...patch.tools === void 0 ? {} : { tools: patch.tools },
   ...patch.revision == null ? {} : { revision: patch.revision }
 });

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/agent-client/provide.ts"],
-  "sourcesContent": ["import { CAPABILITIES, type Capability } from '@finalai/agent-protocol';\nimport {\n  harnessSettingsSchema,\n  type HarnessSettingsIface,\n  type HarnessSettingsViewIface,\n  type ProvideDocumentIface,\n  type ProvideDocumentViewIface,\n  type ProvideParticipantRequestIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { clientError, ClientErrorCode } from \"./errors.mjs\";\n\n// What a caller provides to meet an agent's requirements, as the SDK accepts\n// it: the wire document, except that a sandbox or an integration may be given\n// as the handle `project.sandboxes.create` or `project.integrations.create`\n// returned. Handles are sent as their ids.\n\n/** Anything with the id of a project resource: a handle, or a fetched record. */\nexport interface ResourceRefIface {\n  readonly id: string;\n}\n\nexport type ResourceRef = string | ResourceRefIface;\n\nexport interface ProvideIface {\n  /** Harness settings, inline: `serverlessPi({ model, inference })`. */\n  harness?: HarnessSettingsIface;\n  /**\n   * Capability \u2192 the sandbox that provides it. `files` and `shell` must name the\n   * same sandbox. A capability left out runs in this process unless the client\n   * was created with `localCompute: false`.\n   */\n  compute?: Partial<Record<Capability | `${Capability}`, ResourceRef>>;\n  /** Integration slot \u2192 the integration that fills it. */\n  integrations?: Record<string, ResourceRef>;\n}\n\n/** A change to one agent participant's settings; `null` removes a capability or slot. */\nexport interface ProvidePatchIface {\n  harness?: HarnessSettingsIface;\n  compute?: Partial<Record<Capability | `${Capability}`, ResourceRef | null>>;\n  integrations?: Record<string, ResourceRef | null>;\n  instructions?: string | null;\n  tools?: string[] | null;\n  /** The settings revision you read; a stale one fails with `conflict`. */\n  revision?: number;\n}\n\nexport const resourceIdOf = (ref: ResourceRef): string => (typeof ref === 'string' ? ref : ref.id);\n\nconst capabilityOf = (key: string): Capability => {\n  const capability = CAPABILITIES.find((candidate) => candidate === key);\n  if (capability == null)\n    throw clientError({\n      message: `Unknown compute capability ${key}: use ${CAPABILITIES.join(', ')}`,\n      status: 0,\n      code: ClientErrorCode.InvalidRequest,\n    });\n  return capability;\n};\n\nconst computeIdsOf = (\n  refs: Partial<Record<string, ResourceRef>>,\n): Partial<Record<Capability, string>> => {\n  const ids: Partial<Record<Capability, string>> = {};\n  for (const [key, ref] of Object.entries(refs))\n    if (ref != null) ids[capabilityOf(key)] = resourceIdOf(ref);\n  return ids;\n};\n\nconst computePatchOf = (\n  refs: Partial<Record<string, ResourceRef | null>>,\n): Partial<Record<Capability, string | null>> => {\n  const ids: Partial<Record<Capability, string | null>> = {};\n  for (const [key, ref] of Object.entries(refs))\n    if (ref !== undefined) ids[capabilityOf(key)] = ref == null ? null : resourceIdOf(ref);\n  return ids;\n};\n\nconst slotIdsOf = (refs: Record<string, ResourceRef>): Record<string, string> =>\n  Object.fromEntries(Object.entries(refs).map(([slot, ref]) => [slot, resourceIdOf(ref)]));\n\nconst slotPatchOf = (refs: Record<string, ResourceRef | null>): Record<string, string | null> =>\n  Object.fromEntries(\n    Object.entries(refs).map(([slot, ref]) => [slot, ref == null ? null : resourceIdOf(ref)]),\n  );\n\n/** The wire document for `provide`: handles become ids. */\nexport const provideDocumentOf = (provide: ProvideIface): ProvideDocumentIface => ({\n  ...(provide.harness == null ? {} : { harness: provide.harness }),\n  ...(provide.compute == null ? {} : { compute: computeIdsOf(provide.compute) }),\n  ...(provide.integrations == null ? {} : { integrations: slotIdsOf(provide.integrations) }),\n});\n\nexport const providePatchOf = (patch: ProvidePatchIface): ProvideParticipantRequestIface => ({\n  ...(patch.harness == null ? {} : { harness: patch.harness }),\n  ...(patch.compute == null ? {} : { compute: computePatchOf(patch.compute) }),\n  ...(patch.integrations == null ? {} : { integrations: slotPatchOf(patch.integrations) }),\n  ...(patch.instructions === undefined ? {} : { instructions: patch.instructions }),\n  ...(patch.tools === undefined ? {} : { tools: patch.tools }),\n  ...(patch.revision == null ? {} : { revision: patch.revision }),\n});\n\n// Settings the SDK cannot read back in full (a newer server's inference\n// source) still name the harness, which is what the local check needs.\nconst harnessOfView = (view: HarnessSettingsViewIface): HarnessSettingsIface => {\n  const environment =\n    view.environment == null\n      ? {}\n      : {\n          environment:\n            typeof view.environment === 'string'\n              ? view.environment\n              : {\n                  url: view.environment.url,\n                  ...(view.environment.hop == null ? {} : { hop: view.environment.hop }),\n                },\n        };\n  const parsed = harnessSettingsSchema.safeParse({\n    harness: view.harness,\n    ...(view.adapter == null ? {} : { adapter: view.adapter }),\n    configuration: view.configuration,\n    ...environment,\n  });\n  return parsed.success ? parsed.data : { harness: view.harness };\n};\n\n/** A provide document as the server returns it, back in the form calls send. */\nexport const provideDocumentOfView = (view: ProvideDocumentViewIface): ProvideDocumentIface => {\n  const compute: Partial<Record<Capability, string>> = {};\n  for (const [key, id] of Object.entries(view.compute)) {\n    const capability = CAPABILITIES.find((candidate) => candidate === key);\n    if (capability != null) compute[capability] = id;\n  }\n  return {\n    ...(view.harness == null ? {} : { harness: harnessOfView(view.harness) }),\n    ...(Object.keys(compute).length === 0 ? {} : { compute }),\n    ...(Object.keys(view.integrations).length === 0 ? {} : { integrations: view.integrations }),\n  };\n};\n\n/**\n * What an agent is provided, as the platform layers it: the nearest scope that\n * sets a top-level key wins it whole, so compute never mixes sandboxes from\n * two scopes.\n */\nexport const layerProvide = (\n  own: ProvideDocumentIface,\n  shared: ProvideDocumentIface | null,\n): ProvideDocumentIface => {\n  const harness = own.harness ?? shared?.harness;\n  const compute = own.compute ?? shared?.compute;\n  const integrations = own.integrations ?? shared?.integrations;\n  return {\n    ...(harness == null ? {} : { harness }),\n    ...(compute == null ? {} : { compute }),\n    ...(integrations == null ? {} : { integrations }),\n  };\n};\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { CAPABILITIES, type Capability } from '@finalai/agent-protocol';\nimport {\n  harnessSettingsSchema,\n  type HarnessSettingsIface,\n  type HarnessSettingsViewIface,\n  type ProvideDocumentIface,\n  type ProvideDocumentViewIface,\n  type ProvideParticipantRequestIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { clientError, ClientErrorCode } from \"./errors.mjs\";\n\n// What a caller provides to meet an agent's requirements, as the SDK accepts\n// it: the wire document, except that a sandbox or an integration may be given\n// as the handle `project.sandboxes.create` or `project.integrations.create`\n// returned. Handles are sent as their ids.\n\n/** Anything with the id of a project resource: a handle, or a fetched record. */\nexport interface ResourceRefIface {\n  readonly id: string;\n}\n\nexport type ResourceRef = string | ResourceRefIface;\n\nexport interface ProvideIface {\n  /** Harness settings, inline: `serverlessPi({ model, inference })`. */\n  harness?: HarnessSettingsIface;\n  /**\n   * Capability \u2192 the sandbox that provides it. `files` and `shell` must name the\n   * same sandbox. A capability left out runs in this process unless the client\n   * was created with `localCompute: false`.\n   */\n  compute?: Partial<Record<Capability | `${Capability}`, ResourceRef>>;\n  /** Integration slot \u2192 the integration that fills it. */\n  integrations?: Record<string, ResourceRef>;\n}\n\n/** A change to one agent participant's settings; `null` removes a capability or slot. */\nexport interface ProvidePatchIface {\n  harness?: HarnessSettingsIface;\n  compute?: Partial<Record<Capability | `${Capability}`, ResourceRef | null>>;\n  integrations?: Record<string, ResourceRef | null>;\n  tools?: string[] | null;\n  /** The settings revision you read; a stale one fails with `conflict`. */\n  revision?: number;\n}\n\nexport const resourceIdOf = (ref: ResourceRef): string => (typeof ref === 'string' ? ref : ref.id);\n\nconst capabilityOf = (key: string): Capability => {\n  const capability = CAPABILITIES.find((candidate) => candidate === key);\n  if (capability == null)\n    throw clientError({\n      message: `Unknown compute capability ${key}: use ${CAPABILITIES.join(', ')}`,\n      status: 0,\n      code: ClientErrorCode.InvalidRequest,\n    });\n  return capability;\n};\n\nconst computeIdsOf = (\n  refs: Partial<Record<string, ResourceRef>>,\n): Partial<Record<Capability, string>> => {\n  const ids: Partial<Record<Capability, string>> = {};\n  for (const [key, ref] of Object.entries(refs))\n    if (ref != null) ids[capabilityOf(key)] = resourceIdOf(ref);\n  return ids;\n};\n\nconst computePatchOf = (\n  refs: Partial<Record<string, ResourceRef | null>>,\n): Partial<Record<Capability, string | null>> => {\n  const ids: Partial<Record<Capability, string | null>> = {};\n  for (const [key, ref] of Object.entries(refs))\n    if (ref !== undefined) ids[capabilityOf(key)] = ref == null ? null : resourceIdOf(ref);\n  return ids;\n};\n\nconst slotIdsOf = (refs: Record<string, ResourceRef>): Record<string, string> =>\n  Object.fromEntries(Object.entries(refs).map(([slot, ref]) => [slot, resourceIdOf(ref)]));\n\nconst slotPatchOf = (refs: Record<string, ResourceRef | null>): Record<string, string | null> =>\n  Object.fromEntries(\n    Object.entries(refs).map(([slot, ref]) => [slot, ref == null ? null : resourceIdOf(ref)]),\n  );\n\n/** The wire document for `provide`: handles become ids. */\nexport const provideDocumentOf = (provide: ProvideIface): ProvideDocumentIface => ({\n  ...(provide.harness == null ? {} : { harness: provide.harness }),\n  ...(provide.compute == null ? {} : { compute: computeIdsOf(provide.compute) }),\n  ...(provide.integrations == null ? {} : { integrations: slotIdsOf(provide.integrations) }),\n});\n\nexport const providePatchOf = (patch: ProvidePatchIface): ProvideParticipantRequestIface => ({\n  ...(patch.harness == null ? {} : { harness: patch.harness }),\n  ...(patch.compute == null ? {} : { compute: computePatchOf(patch.compute) }),\n  ...(patch.integrations == null ? {} : { integrations: slotPatchOf(patch.integrations) }),\n  ...(patch.tools === undefined ? {} : { tools: patch.tools }),\n  ...(patch.revision == null ? {} : { revision: patch.revision }),\n});\n\n// Settings the SDK cannot read back in full (a newer server's inference\n// source) still name the harness, which is what the local check needs.\nconst harnessOfView = (view: HarnessSettingsViewIface): HarnessSettingsIface => {\n  const environment =\n    view.environment == null\n      ? {}\n      : {\n          environment:\n            typeof view.environment === 'string'\n              ? view.environment\n              : {\n                  url: view.environment.url,\n                  ...(view.environment.hop == null ? {} : { hop: view.environment.hop }),\n                },\n        };\n  const parsed = harnessSettingsSchema.safeParse({\n    harness: view.harness,\n    ...(view.adapter == null ? {} : { adapter: view.adapter }),\n    configuration: view.configuration,\n    ...environment,\n  });\n  return parsed.success ? parsed.data : { harness: view.harness };\n};\n\n/** A provide document as the server returns it, back in the form calls send. */\nexport const provideDocumentOfView = (view: ProvideDocumentViewIface): ProvideDocumentIface => {\n  const compute: Partial<Record<Capability, string>> = {};\n  for (const [key, id] of Object.entries(view.compute)) {\n    const capability = CAPABILITIES.find((candidate) => candidate === key);\n    if (capability != null) compute[capability] = id;\n  }\n  return {\n    ...(view.harness == null ? {} : { harness: harnessOfView(view.harness) }),\n    ...(Object.keys(compute).length === 0 ? {} : { compute }),\n    ...(Object.keys(view.integrations).length === 0 ? {} : { integrations: view.integrations }),\n  };\n};\n\n/**\n * What an agent is provided, as the platform layers it: the nearest scope that\n * sets a top-level key wins it whole, so compute never mixes sandboxes from\n * two scopes.\n */\nexport const layerProvide = (\n  own: ProvideDocumentIface,\n  shared: ProvideDocumentIface | null,\n): ProvideDocumentIface => {\n  const harness = own.harness ?? shared?.harness;\n  const compute = own.compute ?? shared?.compute;\n  const integrations = own.integrations ?? shared?.integrations;\n  return {\n    ...(harness == null ? {} : { harness }),\n    ...(compute == null ? {} : { compute }),\n    ...(integrations == null ? {} : { integrations }),\n  };\n};\n"],
+  "mappings": "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",
   "names": []
 }

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

@@ -1,5 +1,5 @@
 import type { JsonObjectIface, JsonValue } from '@finalai/agent-protocol';
-import { type AcpFrameEventIface, type AcpPreviewEventIface, type ActorIface, type AgentSessionIface, type AgentTurnIface, type AgentTurnPolicy, type AttachmentDownloadIface, type ContentInput, type DecisionOutcomeInput, type DecisionRecordIface, type PromptAcceptedIface, type ProvideDocumentViewIface, type RequirementStatusIface, type RespondDecisionResponseIface, type SessionFramesPageIface, type SessionManifestIface, type SessionPlanIface } from '@finalai/agent-protocol/agent-platform';
+import { type AcpFrameEventIface, type AcpLiveTextEventIface, type AcpPreviewEventIface, type ActorIface, type AgentSessionIface, type AgentTurnIface, type AgentTurnPolicy, type AttachmentDownloadIface, type ContentInput, type DecisionOutcomeInput, type DecisionRecordIface, type PromptAcceptedIface, type ProvideDocumentViewIface, type RequirementStatusIface, type RespondDecisionResponseIface, type SessionFramesPageIface, type SessionLiveTextIface, type SessionManifestIface, type SessionPlanIface } from '@finalai/agent-protocol/agent-platform';
 import type { AgentInput } from "./agent-input.mjs";
 import { type ClientContextIface, type EnumInput, type SignalOptionsIface } from "./context.mjs";
 import { type SessionLiveEvent } from "./live-stream.mjs";
@@ -73,6 +73,13 @@ export interface SessionHandleIface {
      * ahead of the durable frames and the conversation's projected messages.
      */
     previews: (options?: SignalOptionsIface) => AsyncIterableIterator<AcpPreviewEventIface>;
+    /**
+     * The agent's text as it streams, in arrival order: the saved chunks (`acp.preview`) and the
+     * model's live text ahead of them (`acp.live_text`). Live only; start from `liveText()`.
+     */
+    textEvents: (options?: SignalOptionsIface) => AsyncIterableIterator<AcpPreviewEventIface | AcpLiveTextEventIface>;
+    /** What each agent message of the session's open turns has streamed so far. */
+    liveText: (options?: SignalOptionsIface) => Promise<SessionLiveTextIface>;
     /** One replay page (`GET /sessions/:id/frames`). */
     frames: (options: SignalOptionsIface & {
         fromSeq: number;

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

@@ -1,5 +1,6 @@
 import {
   acpFrameEventSchema,
+  acpLiveTextEventSchema,
   acpPreviewEventSchema,
   agentRealtimeFrameSchema,
   AgentRealtimeFrameType,
@@ -19,6 +20,8 @@ import {
   respondDecisionResponseSchema,
   respondDecisionSchema,
   sessionFramesPageSchema,
+  sessionLiveTextSchema,
+  SessionRealtimeKind,
   sessionManifestSchema,
   sessionPlanResponseSchema,
   sessionRequirementsSchema,
@@ -141,7 +144,7 @@ async function* streamFramesOverHttp(args) {
     }
   }
 }
-const streamPreviews = (args) => {
+const streamSessionEvents = (args) => {
   const topic = agentRealtimeTopics.session(args.sessionId);
   let unsubscribe = null;
   let detachAbort = () => {
@@ -167,9 +170,8 @@ const streamPreviews = (args) => {
       return;
     }
     if (frame.data.type !== AgentRealtimeFrameType.Event) return;
-    if (frame.data.kind !== AgentRealtimeKind.AcpPreview) return;
-    const preview = acpPreviewEventSchema.safeParse(frame.data.payload);
-    if (preview.success) queue.push(preview.data);
+    const value = args.parse(frame.data.kind, frame.data.payload);
+    if (value != null) queue.push(value);
   };
   detachAbort = failOnAbort(queue, args.signal);
   detachClose = failOnAbort(queue, args.context.closeSignal);
@@ -180,6 +182,16 @@ const streamPreviews = (args) => {
   }
   return queue.iterator;
 };
+const parsePreview = (kind, payload) => {
+  if (kind !== AgentRealtimeKind.AcpPreview) return null;
+  const preview = acpPreviewEventSchema.safeParse(payload);
+  return preview.success ? preview.data : null;
+};
+const parseTextEvent = (kind, payload) => {
+  if (kind !== SessionRealtimeKind.AcpLiveText) return parsePreview(kind, payload);
+  const live = acpLiveTextEventSchema.safeParse(payload);
+  return live.success ? live.data : null;
+};
 const frameSources = (args) => ({
   replay: (page) => replay({ context: args.context, sessionId: args.sessionId, ...page }),
   decisions: (signal) => openDecisions({ ...args, signal }),
@@ -293,7 +305,14 @@ const createSessionHandle = (context, sessionId) => {
       closeSignal: context.closeSignal
     }),
     liveEvents: (options) => streamSessionLiveEvents({ context, sessionId, signal: options?.signal }),
-    previews: (options) => streamPreviews({ context, sessionId, signal: options?.signal }),
+    previews: (options) => streamSessionEvents({ context, sessionId, signal: options?.signal, parse: parsePreview }),
+    textEvents: (options) => streamSessionEvents({ context, sessionId, signal: options?.signal, parse: parseTextEvent }),
+    liveText: (options) => http.request({
+      method: HttpMethod.Get,
+      path: sessionPath(sessionId, "/live-text"),
+      response: sessionLiveTextSchema,
+      signal: options?.signal
+    }),
     frames: (options) => replay({ context, sessionId, ...options }),
     decisions: (options) => openDecisions({ context, sessionId, signal: options?.signal }),
     turn: (turnId, options) => getTurn({ context, sessionId, turnId, signal: options?.signal }),

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  decisionRecordListSchema,\n  okResponseSchema,\n  promptAcceptedSchema,\n  promptSessionRequestSchema,\n  respondDecisionResponseSchema,\n  respondDecisionSchema,\n  sessionFramesPageSchema,\n  sessionManifestSchema,\n  sessionPlanResponseSchema,\n  sessionRequirementsSchema,\n  sessionSchema,\n  setConfigOptionRequestSchema,\n  turnSchema,\n  type AcpFrameEventIface,\n  type AcpPreviewEventIface,\n  type ActorIface,\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 ProvideDocumentViewIface,\n  type RequirementStatusIface,\n  type RespondDecisionResponseIface,\n  type SessionFramesPageIface,\n  type SessionManifestIface,\n  type SessionPlanIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { createTextCollector, isUserMessageFor, turnEndOf } from \"./acp-frames.mjs\";\nimport type { AgentInput } from \"./agent-input.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 { LocalHostOwnerKind } from \"./local-host-protocol.mjs\";\nimport type { ProvideIface } from \"./provide.mjs\";\nimport type { RealtimeTransportFrameIface } from \"./realtime.mjs\";\nimport { serveCodeFor, startAgent, type AgentStartDepsIface } from \"./start.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  /** The turn's visible agent text, once it ends. */\n  text: (options?: SignalOptionsIface) => Promise<string>;\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 agent hash; 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  /** The agent document the session pins and the provide document it was resolved with. */\n  manifest: (options?: SignalOptionsIface) => Promise<SessionManifestIface>;\n  /** Each of the agent's requirements and what provides it now. */\n  requirements: (options?: SignalOptionsIface) => Promise<RequirementStatusIface[]>;\n  /** What the session was provided; null before its first open. */\n  provide: (options?: SignalOptionsIface) => Promise<ProvideDocumentViewIface | null>;\n  /**\n   * The latest plan the agent reported, with its history (`GET \u2026/plan`); null\n   * until it reports one. Each update raises `revision` and emits a\n   * `session.plan_updated` event.\n   */\n  plan: (options?: SignalOptionsIface) => Promise<SessionPlanIface | null>;\n}\n\nexport interface CreateSessionArgsIface extends SignalOptionsIface {\n  /**\n   * A session id you chose, so whatever you create for it first (a sandbox it\n   * owns) can name it. Creating with an id that exists returns that session.\n   */\n  id?: string;\n  /** The agent you defined, or one fetched with `project.agents.get`; never a string. */\n  agent: AgentInput;\n  /**\n   * What the agent requires. Files and shell left out run in this process\n   * unless the client was created with `localCompute: false`.\n   */\n  provide: ProvideIface;\n  /** Your app's end user the first turn acts for. */\n  actor?: Omit<ActorIface, 'displayName'> & { displayName?: 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  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 {\n    ...accepted,\n    sessionId,\n    get,\n    stream,\n    result,\n    text: async (options) => (await result(options)).text,\n  };\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    requirements: async (options) =>\n      (\n        await http.request({\n          method: HttpMethod.Get,\n          path: sessionPath(sessionId, '/requirements'),\n          response: sessionRequirementsSchema,\n          signal: options?.signal,\n        })\n      ).requirements,\n    provide: async (options) =>\n      (\n        await http.request({\n          method: HttpMethod.Get,\n          path: sessionPath(sessionId, '/manifest'),\n          response: sessionManifestSchema,\n          signal: options?.signal,\n        })\n      ).provide,\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    plan: async (options) =>\n      (\n        await http.request({\n          method: HttpMethod.Get,\n          path: sessionPath(sessionId, '/plan'),\n          response: sessionPlanResponseSchema,\n          signal: options?.signal,\n        })\n      ).plan,\n  };\n};\n\nexport const createSessionsApi = (context: ClientContextIface): SessionsApiIface => ({\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\nexport interface ProjectSessionsApiIface extends SessionsApiIface {\n  /**\n   * Starts a session. Fails with `requirements_unmet`, creating nothing, unless\n   * every requirement the agent does not mark optional is provided.\n   */\n  create: (args: CreateSessionArgsIface) => Promise<CreatedSessionIface>;\n}\n\nexport const createProjectSessionsApi = (args: {\n  context: ClientContextIface;\n  projectId: string;\n  start: AgentStartDepsIface;\n}): ProjectSessionsApiIface => {\n  const { context } = args;\n  return {\n    ...createSessionsApi(context),\n    create: async (create) => {\n      const started = await startAgent(args.start, {\n        projectId: args.projectId,\n        agent: create.agent,\n        provide: create.provide,\n        owner: { kind: LocalHostOwnerKind.Session, id: create.id },\n        signal: create.signal,\n      });\n      try {\n        const created = await context.http.request({\n          method: HttpMethod.Post,\n          path: '/v1/sessions',\n          body: {\n            schema: createSessionRequestSchema,\n            value: {\n              id: started.ownerId ?? create.id,\n              projectId: args.projectId,\n              agent: started.ref,\n              provide: started.provide,\n              actor: create.actor,\n              message: create.message,\n              turnPolicy: create.turnPolicy,\n              idempotencyKey:\n                create.idempotencyKey ?? (create.message == null ? undefined : context.newKey()),\n              title: create.title,\n              meta: create.meta,\n              clientSubmittedAtMs:\n                create.message == null ? undefined : (create.clientSubmittedAtMs ?? context.now()),\n            },\n          },\n          response: createSessionResponseSchema,\n          signal: create.signal,\n        });\n        const reserved = started.ownerId ?? create.id;\n        if (reserved != null && created.session.id !== reserved) {\n          // The idempotency key replayed an earlier creation: the session is that one, not\n          // the id this call reserved, and what was started for that id serves nothing. Its\n          // in-process code is served for it from here; its compute stays what that\n          // creation named, which nothing can change now.\n          started.abandon();\n          if (started.host != null)\n            await serveCodeFor(args.start, {\n              projectId: args.projectId,\n              agent: create.agent,\n              owner: { kind: LocalHostOwnerKind.Session, id: created.session.id },\n              signal: create.signal,\n            });\n        } else started.established();\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      } catch (cause) {\n        started.abandon();\n        throw cause;\n      }\n    },\n  };\n};\n"],
-  "mappings": "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",
+  "sourcesContent": ["import type { JsonObjectIface, JsonValue } from '@finalai/agent-protocol';\nimport {\n  acpFrameEventSchema,\n  acpLiveTextEventSchema,\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  sessionLiveTextSchema,\n  SessionRealtimeKind,\n  sessionManifestSchema,\n  sessionPlanResponseSchema,\n  sessionRequirementsSchema,\n  sessionSchema,\n  setConfigOptionRequestSchema,\n  turnSchema,\n  type AcpFrameEventIface,\n  type AcpLiveTextEventIface,\n  type AcpPreviewEventIface,\n  type ActorIface,\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 ProvideDocumentViewIface,\n  type RequirementStatusIface,\n  type RespondDecisionResponseIface,\n  type SessionFramesPageIface,\n  type SessionLiveTextIface,\n  type SessionManifestIface,\n  type SessionPlanIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { createTextCollector, isUserMessageFor, turnEndOf } from \"./acp-frames.mjs\";\nimport type { AgentInput } from \"./agent-input.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 { LocalHostOwnerKind } from \"./local-host-protocol.mjs\";\nimport type { ProvideIface } from \"./provide.mjs\";\nimport type { RealtimeTransportFrameIface } from \"./realtime.mjs\";\nimport { serveCodeFor, startAgent, type AgentStartDepsIface } from \"./start.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  /** The turn's visible agent text, once it ends. */\n  text: (options?: SignalOptionsIface) => Promise<string>;\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 agent hash; 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  /**\n   * The agent's text as it streams, in arrival order: the saved chunks (`acp.preview`) and the\n   * model's live text ahead of them (`acp.live_text`). Live only; start from `liveText()`.\n   */\n  textEvents: (\n    options?: SignalOptionsIface,\n  ) => AsyncIterableIterator<AcpPreviewEventIface | AcpLiveTextEventIface>;\n  /** What each agent message of the session's open turns has streamed so far. */\n  liveText: (options?: SignalOptionsIface) => Promise<SessionLiveTextIface>;\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  /** The agent document the session pins and the provide document it was resolved with. */\n  manifest: (options?: SignalOptionsIface) => Promise<SessionManifestIface>;\n  /** Each of the agent's requirements and what provides it now. */\n  requirements: (options?: SignalOptionsIface) => Promise<RequirementStatusIface[]>;\n  /** What the session was provided; null before its first open. */\n  provide: (options?: SignalOptionsIface) => Promise<ProvideDocumentViewIface | null>;\n  /**\n   * The latest plan the agent reported, with its history (`GET \u2026/plan`); null\n   * until it reports one. Each update raises `revision` and emits a\n   * `session.plan_updated` event.\n   */\n  plan: (options?: SignalOptionsIface) => Promise<SessionPlanIface | null>;\n}\n\nexport interface CreateSessionArgsIface extends SignalOptionsIface {\n  /**\n   * A session id you chose, so whatever you create for it first (a sandbox it\n   * owns) can name it. Creating with an id that exists returns that session.\n   */\n  id?: string;\n  /** The agent you defined, or one fetched with `project.agents.get`; never a string. */\n  agent: AgentInput;\n  /**\n   * What the agent requires. Files and shell left out run in this process\n   * unless the client was created with `localCompute: false`.\n   */\n  provide: ProvideIface;\n  /** Your app's end user the first turn acts for. */\n  actor?: Omit<ActorIface, 'displayName'> & { displayName?: 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  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 {\n    ...accepted,\n    sessionId,\n    get,\n    stream,\n    result,\n    text: async (options) => (await result(options)).text,\n  };\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 streamSessionEvents = <Value>(args: {\n  context: ClientContextIface;\n  sessionId: string;\n  signal?: AbortSignal;\n  /** The event a frame's kind and payload carry, or null to skip the frame. */\n  parse: (kind: string, payload: unknown) => Value | null;\n}): AsyncIterableIterator<Value> => {\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<Value>(() => {\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    const value = args.parse(frame.data.kind, frame.data.payload);\n    if (value != null) queue.push(value);\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\nconst parsePreview = (kind: string, payload: unknown): AcpPreviewEventIface | null => {\n  if (kind !== AgentRealtimeKind.AcpPreview) return null;\n  const preview = acpPreviewEventSchema.safeParse(payload);\n  return preview.success ? preview.data : null;\n};\n\nconst parseTextEvent = (\n  kind: string,\n  payload: unknown,\n): AcpPreviewEventIface | AcpLiveTextEventIface | null => {\n  if (kind !== SessionRealtimeKind.AcpLiveText) return parsePreview(kind, payload);\n  const live = acpLiveTextEventSchema.safeParse(payload);\n  return live.success ? live.data : null;\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    requirements: async (options) =>\n      (\n        await http.request({\n          method: HttpMethod.Get,\n          path: sessionPath(sessionId, '/requirements'),\n          response: sessionRequirementsSchema,\n          signal: options?.signal,\n        })\n      ).requirements,\n    provide: async (options) =>\n      (\n        await http.request({\n          method: HttpMethod.Get,\n          path: sessionPath(sessionId, '/manifest'),\n          response: sessionManifestSchema,\n          signal: options?.signal,\n        })\n      ).provide,\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) =>\n      streamSessionEvents({ context, sessionId, signal: options?.signal, parse: parsePreview }),\n    textEvents: (options) =>\n      streamSessionEvents({ context, sessionId, signal: options?.signal, parse: parseTextEvent }),\n    liveText: (options) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: sessionPath(sessionId, '/live-text'),\n        response: sessionLiveTextSchema,\n        signal: options?.signal,\n      }),\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    plan: async (options) =>\n      (\n        await http.request({\n          method: HttpMethod.Get,\n          path: sessionPath(sessionId, '/plan'),\n          response: sessionPlanResponseSchema,\n          signal: options?.signal,\n        })\n      ).plan,\n  };\n};\n\nexport const createSessionsApi = (context: ClientContextIface): SessionsApiIface => ({\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\nexport interface ProjectSessionsApiIface extends SessionsApiIface {\n  /**\n   * Starts a session. Fails with `requirements_unmet`, creating nothing, unless\n   * every requirement the agent does not mark optional is provided.\n   */\n  create: (args: CreateSessionArgsIface) => Promise<CreatedSessionIface>;\n}\n\nexport const createProjectSessionsApi = (args: {\n  context: ClientContextIface;\n  projectId: string;\n  start: AgentStartDepsIface;\n}): ProjectSessionsApiIface => {\n  const { context } = args;\n  return {\n    ...createSessionsApi(context),\n    create: async (create) => {\n      const started = await startAgent(args.start, {\n        projectId: args.projectId,\n        agent: create.agent,\n        provide: create.provide,\n        owner: { kind: LocalHostOwnerKind.Session, id: create.id },\n        signal: create.signal,\n      });\n      try {\n        const created = await context.http.request({\n          method: HttpMethod.Post,\n          path: '/v1/sessions',\n          body: {\n            schema: createSessionRequestSchema,\n            value: {\n              id: started.ownerId ?? create.id,\n              projectId: args.projectId,\n              agent: started.ref,\n              provide: started.provide,\n              actor: create.actor,\n              message: create.message,\n              turnPolicy: create.turnPolicy,\n              idempotencyKey:\n                create.idempotencyKey ?? (create.message == null ? undefined : context.newKey()),\n              title: create.title,\n              meta: create.meta,\n              clientSubmittedAtMs:\n                create.message == null ? undefined : (create.clientSubmittedAtMs ?? context.now()),\n            },\n          },\n          response: createSessionResponseSchema,\n          signal: create.signal,\n        });\n        const reserved = started.ownerId ?? create.id;\n        if (reserved != null && created.session.id !== reserved) {\n          // The idempotency key replayed an earlier creation: the session is that one, not\n          // the id this call reserved, and what was started for that id serves nothing. Its\n          // in-process code is served for it from here; its compute stays what that\n          // creation named, which nothing can change now.\n          started.abandon();\n          if (started.host != null)\n            await serveCodeFor(args.start, {\n              projectId: args.projectId,\n              agent: create.agent,\n              owner: { kind: LocalHostOwnerKind.Session, id: created.session.id },\n              signal: create.signal,\n            });\n        } else started.established();\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      } catch (cause) {\n        started.abandon();\n        throw cause;\n      }\n    },\n  };\n};\n"],
+  "mappings": "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",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@finalai/agents",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "private": false,
   "description": "Agent authoring, client APIs, and CLI.",
   "license": "Apache-2.0",
@@ -114,10 +114,10 @@
   },
   "dependencies": {
     "@agentclientprotocol/sdk": "1.8.0",
-    "@finalai/agent-definition": "0.10.0",
-    "@finalai/agent-protocol": "0.10.0",
-    "@finalai/agent-provider": "0.11.0",
-    "@finalai/final-agent-provider": "0.12.0",
+    "@finalai/agent-definition": "0.11.0",
+    "@finalai/agent-protocol": "0.11.0",
+    "@finalai/agent-provider": "0.12.0",
+    "@finalai/final-agent-provider": "0.13.0",
     "@finalai/websockets": "0.1.8",
     "ws": "^8.21.3",
     "zod": "4.6.6"