@finalai/agents 0.10.0 → 0.12.0

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

@@ -0,0 +1,56 @@
+import {
+  scheduleListSchema,
+  scheduleRunResultSchema,
+  scheduleSchema,
+  updateScheduleRequestSchema
+} from "@finalai/agent-protocol/agent-platform";
+import { encodePath } from "./context.mjs";
+import { clientError, ClientErrorCode } from "./errors.mjs";
+import { HttpMethod } from "./http.mjs";
+import { provideDocumentOf } from "./provide.mjs";
+const createSchedulesApi = ({ http }) => {
+  const list = async (options) => (await http.request({
+    method: HttpMethod.Get,
+    path: "/v1/schedules",
+    query: { agent: options?.agent },
+    response: scheduleListSchema,
+    signal: options?.signal
+  })).schedules;
+  const scheduleIdOf = async (args) => {
+    if ("scheduleId" in args) return args.scheduleId;
+    const found = (await list({ agent: args.agent, signal: args.signal })).find(
+      (schedule) => schedule.key === args.key
+    );
+    if (found == null) {
+      throw clientError({
+        message: `No schedule ${args.key} on agent ${args.agent}`,
+        status: 0,
+        code: ClientErrorCode.NotFound
+      });
+    }
+    return found.id;
+  };
+  return {
+    list,
+    runNow: async (args) => http.request({
+      method: HttpMethod.Post,
+      path: `/v1/schedules/${encodePath(await scheduleIdOf(args))}/run-now`,
+      response: scheduleRunResultSchema,
+      signal: args.signal
+    }),
+    update: ({ scheduleId, signal, provide, ...value }) => http.request({
+      method: HttpMethod.Patch,
+      path: `/v1/schedules/${encodePath(scheduleId)}`,
+      body: {
+        schema: updateScheduleRequestSchema,
+        value: { ...value, ...provide == null ? {} : { provide: provideDocumentOf(provide) } }
+      },
+      response: scheduleSchema,
+      signal
+    })
+  };
+};
+export {
+  createSchedulesApi
+};
+//# sourceMappingURL=schedules.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/agent-client/schedules.ts"],
+  "sourcesContent": ["import {\n  scheduleListSchema,\n  scheduleRunResultSchema,\n  scheduleSchema,\n  updateScheduleRequestSchema,\n  type ScheduleIface,\n  type ScheduleRunResultIface,\n  type UpdateScheduleRequestIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { encodePath, type ClientContextIface, type SignalOptionsIface } from \"./context.mjs\";\nimport { clientError, ClientErrorCode } from \"./errors.mjs\";\nimport { HttpMethod } from \"./http.mjs\";\nimport { provideDocumentOf, type ProvideIface } from \"./provide.mjs\";\n\n// An agent's own schedules. Nobody is calling when one fires, so each carries\n// what its runs are provided.\n\nexport type ScheduleRef = { scheduleId: string } | { agent: string; key: string };\n\nexport interface ScheduleUpdateIface extends Omit<UpdateScheduleRequestIface, 'provide'> {\n  /** What its runs start with; fails with `requirements_unmet` unless it meets the agent's requirements. */\n  provide?: ProvideIface;\n}\n\nexport interface SchedulesApiIface {\n  /** `agent` narrows to one agent's schedules, by its id. */\n  list: (options?: SignalOptionsIface & { agent?: string }) => Promise<ScheduleIface[]>;\n  runNow: (args: ScheduleRef & SignalOptionsIface) => Promise<ScheduleRunResultIface>;\n  update: (\n    args: { scheduleId: string } & ScheduleUpdateIface & SignalOptionsIface,\n  ) => Promise<ScheduleIface>;\n}\n\nexport const createSchedulesApi = ({ http }: ClientContextIface): SchedulesApiIface => {\n  const list: SchedulesApiIface['list'] = async (options) =>\n    (\n      await http.request({\n        method: HttpMethod.Get,\n        path: '/v1/schedules',\n        query: { agent: options?.agent },\n        response: scheduleListSchema,\n        signal: options?.signal,\n      })\n    ).schedules;\n\n  const scheduleIdOf = async (args: ScheduleRef & SignalOptionsIface): Promise<string> => {\n    if ('scheduleId' in args) return args.scheduleId;\n    const found = (await list({ agent: args.agent, signal: args.signal })).find(\n      (schedule) => schedule.key === args.key,\n    );\n    if (found == null) {\n      throw clientError({\n        message: `No schedule ${args.key} on agent ${args.agent}`,\n        status: 0,\n        code: ClientErrorCode.NotFound,\n      });\n    }\n    return found.id;\n  };\n\n  return {\n    list,\n    runNow: async (args) =>\n      http.request({\n        method: HttpMethod.Post,\n        path: `/v1/schedules/${encodePath(await scheduleIdOf(args))}/run-now`,\n        response: scheduleRunResultSchema,\n        signal: args.signal,\n      }),\n    update: ({ scheduleId, signal, provide, ...value }) =>\n      http.request({\n        method: HttpMethod.Patch,\n        path: `/v1/schedules/${encodePath(scheduleId)}`,\n        body: {\n          schema: updateScheduleRequestSchema,\n          value: { ...value, ...(provide == null ? {} : { provide: provideDocumentOf(provide) }) },\n        },\n        response: scheduleSchema,\n        signal,\n      }),\n  };\n};\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AACP,SAAS,kBAAoE;AAC7E,SAAS,aAAa,uBAAuB;AAC7C,SAAS,kBAAkB;AAC3B,SAAS,yBAA4C;AAqB9C,MAAM,qBAAqB,CAAC,EAAE,KAAK,MAA6C;AACrF,QAAM,OAAkC,OAAO,aAE3C,MAAM,KAAK,QAAQ;AAAA,IACjB,QAAQ,WAAW;AAAA,IACnB,MAAM;AAAA,IACN,OAAO,EAAE,OAAO,SAAS,MAAM;AAAA,IAC/B,UAAU;AAAA,IACV,QAAQ,SAAS;AAAA,EACnB,CAAC,GACD;AAEJ,QAAM,eAAe,OAAO,SAA4D;AACtF,QAAI,gBAAgB,KAAM,QAAO,KAAK;AACtC,UAAM,SAAS,MAAM,KAAK,EAAE,OAAO,KAAK,OAAO,QAAQ,KAAK,OAAO,CAAC,GAAG;AAAA,MACrE,CAAC,aAAa,SAAS,QAAQ,KAAK;AAAA,IACtC;AACA,QAAI,SAAS,MAAM;AACjB,YAAM,YAAY;AAAA,QAChB,SAAS,eAAe,KAAK,GAAG,aAAa,KAAK,KAAK;AAAA,QACvD,QAAQ;AAAA,QACR,MAAM,gBAAgB;AAAA,MACxB,CAAC;AAAA,IACH;AACA,WAAO,MAAM;AAAA,EACf;AAEA,SAAO;AAAA,IACL;AAAA,IACA,QAAQ,OAAO,SACb,KAAK,QAAQ;AAAA,MACX,QAAQ,WAAW;AAAA,MACnB,MAAM,iBAAiB,WAAW,MAAM,aAAa,IAAI,CAAC,CAAC;AAAA,MAC3D,UAAU;AAAA,MACV,QAAQ,KAAK;AAAA,IACf,CAAC;AAAA,IACH,QAAQ,CAAC,EAAE,YAAY,QAAQ,SAAS,GAAG,MAAM,MAC/C,KAAK,QAAQ;AAAA,MACX,QAAQ,WAAW;AAAA,MACnB,MAAM,iBAAiB,WAAW,UAAU,CAAC;AAAA,MAC7C,MAAM;AAAA,QACJ,QAAQ;AAAA,QACR,OAAO,EAAE,GAAG,OAAO,GAAI,WAAW,OAAO,CAAC,IAAI,EAAE,SAAS,kBAAkB,OAAO,EAAE,EAAG;AAAA,MACzF;AAAA,MACA,UAAU;AAAA,MACV;AAAA,IACF,CAAC;AAAA,EACL;AACF;",
+  "names": []
+}

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

@@ -1,7 +1,10 @@
 import type { JsonObjectIface, JsonValue } from '@finalai/agent-protocol';
-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 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 { AgentInput } from "./agent-input.mjs";
 import { type ClientContextIface, type EnumInput, type SignalOptionsIface } from "./context.mjs";
 import { type SessionLiveEvent } from "./live-stream.mjs";
+import type { ProvideIface } from "./provide.mjs";
+import { type AgentStartDepsIface } from "./start.mjs";
 /** Answer a decision by option id (permission) or with a full ACP outcome. */
 export type RespondArgs = {
     decisionId: string;
@@ -32,6 +35,8 @@ export interface TurnHandleIface<MessageId extends string | null = string> exten
     get: (options?: SignalOptionsIface) => Promise<AgentTurnIface>;
     stream: (options?: SignalOptionsIface) => AsyncIterableIterator<AcpFrameEventIface>;
     result: (options?: SignalOptionsIface) => Promise<TurnResultIface<MessageId>>;
+    /** The turn's visible agent text, once it ends. */
+    text: (options?: SignalOptionsIface) => Promise<string>;
 }
 export interface SendOptionsIface extends SignalOptionsIface {
     turnPolicy?: EnumInput<AgentTurnPolicy>;
@@ -48,7 +53,7 @@ export interface ForkSessionOptionsIface extends SignalOptionsIface {
 /** An I/O-free handle on one session; every method is one HTTP call or one stream. */
 export interface SessionHandleIface {
     id: string;
-    /** Native fork of an idle source on its pinned revision; the standalone child has fresh scopes. */
+    /** Native fork of an idle source on its pinned agent hash; the standalone child has fresh scopes. */
     fork: (options?: ForkSessionOptionsIface) => Promise<CreatedSessionIface>;
     get: (options?: SignalOptionsIface) => Promise<AgentSessionIface>;
     /** Resolves a `final-attachment:` resource link from this session's frames. */
@@ -92,14 +97,36 @@ export interface SessionHandleIface {
         value: JsonValue;
     }, options?: SignalOptionsIface) => Promise<void>;
     close: (options?: SignalOptionsIface) => Promise<void>;
-    /** Resolved manifest and resolver report; secret-bearing output requires agents:read and admin secret-binding access. */
+    /** The agent document the session pins and the provide document it was resolved with. */
     manifest: (options?: SignalOptionsIface) => Promise<SessionManifestIface>;
+    /** Each of the agent's requirements and what provides it now. */
+    requirements: (options?: SignalOptionsIface) => Promise<RequirementStatusIface[]>;
+    /** What the session was provided; null before its first open. */
+    provide: (options?: SignalOptionsIface) => Promise<ProvideDocumentViewIface | null>;
+    /**
+     * The latest plan the agent reported, with its history (`GET …/plan`); null
+     * until it reports one. Each update raises `revision` and emits a
+     * `session.plan_updated` event.
+     */
+    plan: (options?: SignalOptionsIface) => Promise<SessionPlanIface | null>;
 }
 export interface CreateSessionArgsIface extends SignalOptionsIface {
-    /** Agent slug or id. */
-    agent: string;
-    /** Pin an author test session to a revision returned by definitions.testRevision. */
-    revisionId?: string;
+    /**
+     * A session id you chose, so whatever you create for it first (a sandbox it
+     * owns) can name it. Creating with an id that exists returns that session.
+     */
+    id?: string;
+    /** The agent you defined, or one fetched with `project.agents.get`; never a string. */
+    agent: AgentInput;
+    /**
+     * What the agent requires. Files and shell left out run in this process
+     * unless the client was created with `localCompute: false`.
+     */
+    provide: ProvideIface;
+    /** Your app's end user the first turn acts for. */
+    actor?: Omit<ActorIface, 'displayName'> & {
+        displayName?: string;
+    };
     message?: ContentInput;
     turnPolicy?: EnumInput<AgentTurnPolicy>;
     idempotencyKey?: string;
@@ -115,7 +142,6 @@ export interface CreatedSessionIface {
     response: TurnHandleIface | null;
 }
 export interface SessionsApiIface {
-    create: (args: CreateSessionArgsIface) => Promise<CreatedSessionIface>;
     fork: (sessionId: string, options?: ForkSessionOptionsIface) => Promise<CreatedSessionIface>;
     get: (sessionId: string, options?: SignalOptionsIface) => Promise<AgentSessionIface>;
     attach: (sessionId: string) => SessionHandleIface;
@@ -123,3 +149,15 @@ export interface SessionsApiIface {
 export declare const outcomeOf: (args: RespondArgs) => DecisionOutcomeInput;
 export declare const createSessionHandle: (context: ClientContextIface, sessionId: string) => SessionHandleIface;
 export declare const createSessionsApi: (context: ClientContextIface) => SessionsApiIface;
+export interface ProjectSessionsApiIface extends SessionsApiIface {
+    /**
+     * Starts a session. Fails with `requirements_unmet`, creating nothing, unless
+     * every requirement the agent does not mark optional is provided.
+     */
+    create: (args: CreateSessionArgsIface) => Promise<CreatedSessionIface>;
+}
+export declare const createProjectSessionsApi: (args: {
+    context: ClientContextIface;
+    projectId: string;
+    start: AgentStartDepsIface;
+}) => ProjectSessionsApiIface;

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

@@ -20,6 +20,8 @@ import {
   respondDecisionSchema,
   sessionFramesPageSchema,
   sessionManifestSchema,
+  sessionPlanResponseSchema,
+  sessionRequirementsSchema,
   sessionSchema,
   setConfigOptionRequestSchema,
   turnSchema
@@ -34,6 +36,8 @@ import { streamServerSentEvents } from "./event-stream.mjs";
 import { streamSessionFrames } from "./frame-stream.mjs";
 import { HttpMethod } from "./http.mjs";
 import { streamSessionLiveEvents } from "./live-stream.mjs";
+import { LocalHostOwnerKind } from "./local-host-protocol.mjs";
+import { serveCodeFor, startAgent } from "./start.mjs";
 const outcomeOf = (args) => "optionId" in args ? { outcome: "selected", optionId: args.optionId } : args.outcome;
 const sessionPath = (sessionId, suffix = "") => `/v1/sessions/${encodePath(sessionId)}${suffix}`;
 const turnHandle = (args) => {
@@ -94,7 +98,14 @@ const turnHandle = (args) => {
       toSeq: receipt.toSeq ?? last?.seq ?? accepted.fromSeq ?? 0
     };
   };
-  return { ...accepted, sessionId, get, stream, result };
+  return {
+    ...accepted,
+    sessionId,
+    get,
+    stream,
+    result,
+    text: async (options) => (await result(options)).text
+  };
 };
 const getTurn = (args) => args.context.http.request({
   method: HttpMethod.Get,
@@ -227,6 +238,18 @@ const createSessionHandle = (context, sessionId) => {
       response: sessionManifestSchema,
       signal: options?.signal
     }),
+    requirements: async (options) => (await http.request({
+      method: HttpMethod.Get,
+      path: sessionPath(sessionId, "/requirements"),
+      response: sessionRequirementsSchema,
+      signal: options?.signal
+    })).requirements,
+    provide: async (options) => (await http.request({
+      method: HttpMethod.Get,
+      path: sessionPath(sessionId, "/manifest"),
+      response: sessionManifestSchema,
+      signal: options?.signal
+    })).provide,
     send: async (content, options) => {
       const accepted = await http.request({
         method: HttpMethod.Post,
@@ -307,42 +330,81 @@ const createSessionHandle = (context, sessionId) => {
       body: { schema: setConfigOptionRequestSchema, value: args },
       signal: options?.signal
     }),
-    close: (options) => post({ suffix: "/close", signal: options?.signal })
+    close: (options) => post({ suffix: "/close", signal: options?.signal }),
+    plan: async (options) => (await http.request({
+      method: HttpMethod.Get,
+      path: sessionPath(sessionId, "/plan"),
+      response: sessionPlanResponseSchema,
+      signal: options?.signal
+    })).plan
   };
 };
 const createSessionsApi = (context) => ({
-  create: async (args) => {
-    const created = await context.http.request({
-      method: HttpMethod.Post,
-      path: "/v1/sessions",
-      body: {
-        schema: createSessionRequestSchema,
-        value: {
-          agent: args.agent,
-          revisionId: args.revisionId,
-          message: args.message,
-          turnPolicy: args.turnPolicy,
-          idempotencyKey: args.idempotencyKey ?? (args.message == null ? void 0 : context.newKey()),
-          title: args.title,
-          meta: args.meta,
-          clientSubmittedAtMs: args.message == null ? void 0 : args.clientSubmittedAtMs ?? context.now()
-        }
-      },
-      response: createSessionResponseSchema,
-      signal: args.signal
-    });
-    const handle = createSessionHandle(context, created.session.id);
-    return {
-      session: created.session,
-      handle,
-      response: created.turn == null ? null : turnHandle({ context, sessionId: created.session.id, accepted: created.turn })
-    };
-  },
   fork: (sessionId, options) => createSessionHandle(context, sessionId).fork(options),
   get: (sessionId, options) => createSessionHandle(context, sessionId).get(options),
   attach: (sessionId) => createSessionHandle(context, sessionId)
 });
+const createProjectSessionsApi = (args) => {
+  const { context } = args;
+  return {
+    ...createSessionsApi(context),
+    create: async (create) => {
+      const started = await startAgent(args.start, {
+        projectId: args.projectId,
+        agent: create.agent,
+        provide: create.provide,
+        owner: { kind: LocalHostOwnerKind.Session, id: create.id },
+        signal: create.signal
+      });
+      try {
+        const created = await context.http.request({
+          method: HttpMethod.Post,
+          path: "/v1/sessions",
+          body: {
+            schema: createSessionRequestSchema,
+            value: {
+              id: started.ownerId ?? create.id,
+              projectId: args.projectId,
+              agent: started.ref,
+              provide: started.provide,
+              actor: create.actor,
+              message: create.message,
+              turnPolicy: create.turnPolicy,
+              idempotencyKey: create.idempotencyKey ?? (create.message == null ? void 0 : context.newKey()),
+              title: create.title,
+              meta: create.meta,
+              clientSubmittedAtMs: create.message == null ? void 0 : create.clientSubmittedAtMs ?? context.now()
+            }
+          },
+          response: createSessionResponseSchema,
+          signal: create.signal
+        });
+        const reserved = started.ownerId ?? create.id;
+        if (reserved != null && created.session.id !== reserved) {
+          started.abandon();
+          if (started.host != null)
+            await serveCodeFor(args.start, {
+              projectId: args.projectId,
+              agent: create.agent,
+              owner: { kind: LocalHostOwnerKind.Session, id: created.session.id },
+              signal: create.signal
+            });
+        } else started.established();
+        const handle = createSessionHandle(context, created.session.id);
+        return {
+          session: created.session,
+          handle,
+          response: created.turn == null ? null : turnHandle({ context, sessionId: created.session.id, accepted: created.turn })
+        };
+      } catch (cause) {
+        started.abandon();
+        throw cause;
+      }
+    }
+  };
+};
 export {
+  createProjectSessionsApi,
   createSessionHandle,
   createSessionsApi,
   outcomeOf

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  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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",
+  "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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",
   "names": []
 }

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

@@ -0,0 +1,101 @@
+import { type AgentRefInputIface, type HarnessCheckResponseIface, type ProvideDocumentIface } from '@finalai/agent-protocol/agent-platform';
+import { type AgentValueCodecIface } from "./agent-input.mjs";
+import { type ClientContextIface } from "./context.mjs";
+import { type LocalComputeIface, type LocalHostIface, type LocalHostSocketIface } from "./local-host.mjs";
+import { LocalHostOwnerKind, type LocalHostOwnerIface } from "./local-host-protocol.mjs";
+import { type ProvideIface } from "./provide.mjs";
+/** What the project client needs to start agents; built once per client. */
+export interface AgentStartDepsIface {
+    context: ClientContextIface;
+    codec: AgentValueCodecIface;
+    /** False: never serve compute from this process (`createClient({ localCompute: false })`). */
+    localCompute: boolean;
+    compute: LocalComputeIface;
+    dial: (path: string, signal?: AbortSignal) => Promise<LocalHostSocketIface>;
+    /** Every open local host, so `client.close()` ends them. */
+    hosts: Set<LocalHostIface>;
+}
+export interface StartAgentArgsIface {
+    projectId: string | null;
+    agent: unknown;
+    provide: ProvideIface;
+    /** Provided alongside by a conversation; the participant's own wins each top-level key whole. */
+    shared?: ProvideDocumentIface | null;
+    owner: LocalHostOwnerIface;
+    /** The owner id was reserved for this call (by a local host), not chosen by the caller. */
+    ownerIdReserved?: boolean;
+    signal?: AbortSignal;
+}
+export interface StartedAgentIface {
+    ref: AgentRefInputIface;
+    /** The participant's or session's own provide, with this process's compute filled in. */
+    provide: ProvideDocumentIface;
+    /** The owner id, when a local host reserved or confirmed one, or the SDK chose one for a Workers sandbox. */
+    ownerId: string | undefined;
+    host: LocalHostIface | null;
+    /**
+     * Ends the local host when the call that would have used it failed, and
+     * deletes a Workers sandbox created for an owner id the SDK chose once the
+     * owner is confirmed not to exist.
+     */
+    abandon: () => void;
+    /** The call that uses it succeeded: the local host stops keeping the process alive while idle. */
+    established: () => void;
+}
+export interface WorkersEnvironmentIface {
+    /** The harness settings with the Workers sandbox as their environment; unchanged when none was needed. */
+    harness: NonNullable<ProvideDocumentIface['harness']>;
+    /** The owner id the sandbox was created for: the caller's, else one the SDK chose. */
+    ownerId: string | undefined;
+    /**
+     * When the SDK chose the owner id: deletes the sandbox unless its owner was
+     * created after all (a lost response does not prove the creation failed).
+     */
+    created: {
+        discard: () => Promise<void>;
+    } | null;
+    /**
+     * Capabilities the harness uses natively from where it runs, when its
+     * settings name no environment; such a harness runs where `shell` is.
+     */
+    native: readonly string[];
+}
+/**
+ * Gives harness settings that name no environment, for a harness that runs
+ * only as a worker program, a Workers sandbox owned by the session or
+ * conversation: the same one on a retry with the same owner id. A caller that
+ * chose no owner id gets one chosen here, which the session or conversation
+ * must then be created with.
+ */
+export declare const withWorkersEnvironment: (args: {
+    context: ClientContextIface;
+    projectId: string;
+    harness: NonNullable<ProvideDocumentIface["harness"]>;
+    owner: LocalHostOwnerIface;
+    /** The owner id was reserved for this call, not chosen by the caller. */
+    ownerIdReserved?: boolean;
+    signal: AbortSignal | undefined;
+}) => Promise<WorkersEnvironmentIface>;
+export declare const checkHarness: (args: {
+    context: ClientContextIface;
+    projectId: string;
+    hash: string;
+    harness: NonNullable<ProvideDocumentIface["harness"]>;
+    compute?: ProvideDocumentIface["compute"];
+    signal?: AbortSignal;
+}) => Promise<HarnessCheckResponseIface>;
+export declare const startAgent: (deps: AgentStartDepsIface, args: StartAgentArgsIface) => Promise<StartedAgentIface>;
+/**
+ * Serves the agent's in-process code to an existing session or conversation
+ * from this process, without compute: its provide is already what an earlier
+ * call stored. Null when the agent has no in-process code.
+ */
+export declare const serveCodeFor: (deps: AgentStartDepsIface, args: {
+    projectId: string;
+    agent: unknown;
+    owner: {
+        kind: LocalHostOwnerKind;
+        id: string;
+    };
+    signal?: AbortSignal;
+}) => Promise<LocalHostIface | null>;