@finalai/agents 0.8.0

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

@@ -0,0 +1,124 @@
+import type { JsonObjectIface, JsonValue } from '@finalai/agent-protocol';
+import { type AcpFrameEventIface, type AcpPreviewEventIface, type AgentSessionIface, type AgentTurnIface, type AgentTurnPolicy, type AttachmentDownloadIface, type ContentInput, type PendingOutcomeInput, type PendingRequestIface, type PromptAcceptedIface, type RespondPendingResponseIface, type SessionFramesPageIface, type SessionManifestIface } from '@finalai/agent-protocol/agent-platform';
+import { type ClientContextIface, type EnumInput, type SignalOptionsIface } from "./context.mjs";
+import { type SessionLiveEvent } from "./live-stream.mjs";
+/** Answer a pending request by option id (permission) or with a full ACP outcome. */
+export type RespondArgs = {
+    pendingId: string;
+    optionId: string;
+} | {
+    pendingId: string;
+    outcome: PendingOutcomeInput;
+};
+export interface StreamOptionsIface extends SignalOptionsIface {
+    /** Inclusive; defaults to `FIRST_ACP_FRAME_SEQ` (the whole log). Earlier values are clamped. */
+    fromSeq?: number;
+    /** Keep streaming live frames after replay catches up; defaults to true. */
+    follow?: boolean;
+}
+export interface TurnResultIface<MessageId extends string | null = string> {
+    messageId: MessageId;
+    turnId: string;
+    stopReason: string | null;
+    /** Visible agent text of the turn. */
+    text: string;
+    /** Seq of the frame that ended the turn. */
+    toSeq: number;
+}
+/** An accepted prompt. `stream()` yields this turn's frames; `result()` waits for its end. */
+export interface TurnHandleIface<MessageId extends string | null = string> extends Omit<PromptAcceptedIface, 'messageId'> {
+    messageId: MessageId;
+    sessionId: string;
+    get: (options?: SignalOptionsIface) => Promise<AgentTurnIface>;
+    stream: (options?: SignalOptionsIface) => AsyncIterableIterator<AcpFrameEventIface>;
+    result: (options?: SignalOptionsIface) => Promise<TurnResultIface<MessageId>>;
+}
+export interface SendOptionsIface extends SignalOptionsIface {
+    turnPolicy?: EnumInput<AgentTurnPolicy>;
+    idempotencyKey?: string;
+    meta?: JsonObjectIface;
+    /** When the person submitted, for the prompt-to-inference trace; defaults to now. */
+    clientSubmittedAtMs?: number;
+}
+export interface ForkSessionOptionsIface extends SignalOptionsIface {
+    /** Retain this key when retrying an interrupted fork. Defaults to a new key. */
+    idempotencyKey?: string;
+    title?: string;
+}
+/** 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. */
+    fork: (options?: ForkSessionOptionsIface) => Promise<CreatedSessionIface>;
+    get: (options?: SignalOptionsIface) => Promise<AgentSessionIface>;
+    /** Resolves a `final-attachment:` resource link from this session's frames. */
+    attachment: (attachmentId: string, options?: SignalOptionsIface) => Promise<AttachmentDownloadIface>;
+    send: (content: ContentInput, options?: SendOptionsIface) => Promise<TurnHandleIface>;
+    /** Adds content to history without a model call (`_final/session/observe`). */
+    observe: (content: ContentInput, options?: SignalOptionsIface & {
+        idempotencyKey?: string;
+        meta?: JsonObjectIface;
+    }) => Promise<void>;
+    stream: (options?: StreamOptionsIface) => AsyncIterableIterator<AcpFrameEventIface>;
+    /** Full provisional frames and reset notices; never a durable replay cursor or receipt. */
+    liveEvents: (options?: SignalOptionsIface) => AsyncIterableIterator<SessionLiveEvent>;
+    /**
+     * `acp.preview` events: the text of message and thought chunks as the session
+     * publishes them, live only (never replayed), for surfaces that render text
+     * ahead of the durable frames and the conversation's projected messages.
+     */
+    previews: (options?: SignalOptionsIface) => AsyncIterableIterator<AcpPreviewEventIface>;
+    /** One replay page (`GET /sessions/:id/frames`). */
+    frames: (options: SignalOptionsIface & {
+        fromSeq: number;
+        limit?: number;
+    }) => Promise<SessionFramesPageIface>;
+    pending: (options?: SignalOptionsIface) => Promise<PendingRequestIface[]>;
+    turn: (turnId: string, options?: SignalOptionsIface) => Promise<AgentTurnIface>;
+    /** Reconstruct an accepted response from its durable turn id, without resending its prompt. */
+    response: (turnId: string, options?: SignalOptionsIface) => Promise<TurnHandleIface<string | null>>;
+    respond: (args: RespondArgs, options?: SignalOptionsIface) => Promise<RespondPendingResponseIface>;
+    cancel: (options?: SignalOptionsIface & {
+        reason?: string;
+    }) => Promise<void>;
+    /**
+     * ACP `session/set_config_option` (model, reasoning, mode, ...): `configId` and a value
+     * from the options the harness advertises (`get().configOptions`, `configSelectsOf`).
+     * Changing them takes the session's owner, or a conversation owner or admin.
+     */
+    setConfigOption: (args: {
+        configId: string;
+        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. */
+    manifest: (options?: SignalOptionsIface) => Promise<SessionManifestIface>;
+}
+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;
+    message?: ContentInput;
+    turnPolicy?: EnumInput<AgentTurnPolicy>;
+    idempotencyKey?: string;
+    title?: string;
+    meta?: JsonObjectIface;
+    /** When the person submitted `message`; defaults to now. */
+    clientSubmittedAtMs?: number;
+}
+export interface CreatedSessionIface {
+    session: AgentSessionIface;
+    handle: SessionHandleIface;
+    /** The first turn when `message` was given. */
+    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;
+}
+export declare const outcomeOf: (args: RespondArgs) => PendingOutcomeInput;
+export declare const createSessionHandle: (context: ClientContextIface, sessionId: string) => SessionHandleIface;
+export declare const createSessionsApi: (context: ClientContextIface) => SessionsApiIface;

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

@@ -0,0 +1,350 @@
+import {
+  acpFrameEventSchema,
+  acpPreviewEventSchema,
+  agentRealtimeFrameSchema,
+  AgentRealtimeFrameType,
+  AgentRealtimeKind,
+  agentRealtimeTopics,
+  attachmentDownloadSchema,
+  cancelRequestSchema,
+  createSessionRequestSchema,
+  createSessionResponseSchema,
+  FIRST_ACP_FRAME_SEQ,
+  forkSessionRequestSchema,
+  observeSessionRequestSchema,
+  okResponseSchema,
+  pendingRequestListSchema,
+  promptAcceptedSchema,
+  promptSessionRequestSchema,
+  respondPendingRequestSchema,
+  respondPendingResponseSchema,
+  sessionFramesPageSchema,
+  sessionManifestSchema,
+  sessionSchema,
+  setConfigOptionRequestSchema,
+  turnSchema
+} from "@finalai/agent-protocol/agent-platform";
+import { createTextCollector, isUserMessageFor, turnEndOf } from "./acp-frames.mjs";
+import { createAsyncQueue, failOnAbort } from "./async-queue.mjs";
+import {
+  encodePath
+} from "./context.mjs";
+import { isTerminalRealtimeError, realtimeSubscriptionError } from "./errors.mjs";
+import { streamServerSentEvents } from "./event-stream.mjs";
+import { streamSessionFrames } from "./frame-stream.mjs";
+import { HttpMethod } from "./http.mjs";
+import { streamSessionLiveEvents } from "./live-stream.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) => {
+  const { context, sessionId, accepted } = args;
+  const get = (options) => getTurn({ context, sessionId, turnId: accepted.turnId, signal: options?.signal });
+  const stream = (options) => {
+    let queuedStart = accepted.messageId == null && accepted.fromSeq != null;
+    let started = queuedStart;
+    const frames = streamSessionFrames({
+      sessionId,
+      fromSeq: accepted.fromSeq ?? FIRST_ACP_FRAME_SEQ,
+      follow: true,
+      ...frameSources({ context, sessionId }),
+      transport: context.realtime(),
+      timing: context.timing,
+      signal: options?.signal,
+      closeSignal: context.closeSignal,
+      terminal: async (signal) => {
+        const receipt = await get({ signal });
+        return receipt.endedAt == null ? null : { throughSeq: receipt.toSeq ?? 0 };
+      },
+      until: (event) => {
+        if (!queuedStart && accepted.messageId != null && isUserMessageFor(event, accepted.messageId))
+          queuedStart = true;
+        return queuedStart && turnEndOf(event) != null;
+      }
+    });
+    const iterator = {
+      next: async () => {
+        for (; ; ) {
+          const next = await frames.next();
+          if (next.done === true || started) return next;
+          if (accepted.messageId != null && isUserMessageFor(next.value, accepted.messageId)) {
+            started = true;
+            return next;
+          }
+        }
+      },
+      return: () => frames.return?.() ?? Promise.resolve({ done: true, value: void 0 }),
+      [Symbol.asyncIterator]: () => iterator
+    };
+    return iterator;
+  };
+  const result = async (options) => {
+    const text = createTextCollector();
+    let last = null;
+    for await (const event of stream(options)) {
+      text.add(event);
+      last = event;
+    }
+    const end = last == null ? null : turnEndOf(last);
+    const receipt = await get(options);
+    return {
+      messageId: accepted.messageId,
+      turnId: accepted.turnId,
+      stopReason: receipt.stopReason ?? end?.stopReason ?? null,
+      text: text.text(),
+      toSeq: receipt.toSeq ?? last?.seq ?? accepted.fromSeq ?? 0
+    };
+  };
+  return { ...accepted, sessionId, get, stream, result };
+};
+const getTurn = (args) => args.context.http.request({
+  method: HttpMethod.Get,
+  path: sessionPath(args.sessionId, `/turns/${encodePath(args.turnId)}`),
+  response: turnSchema,
+  signal: args.signal
+});
+const replay = (args) => args.context.http.request({
+  method: HttpMethod.Get,
+  path: sessionPath(args.sessionId, "/frames"),
+  query: { fromSeq: args.fromSeq, limit: args.limit },
+  response: sessionFramesPageSchema,
+  signal: args.signal
+});
+const openPending = async (args) => (await args.context.http.request({
+  method: HttpMethod.Get,
+  path: sessionPath(args.sessionId, "/pending"),
+  response: pendingRequestListSchema,
+  signal: args.signal
+})).pending;
+async function* streamFramesOverHttp(args) {
+  for await (const message of streamServerSentEvents({
+    http: args.context.http,
+    path: sessionPath(args.sessionId, "/frames/stream"),
+    query: { fromSeq: args.fromSeq },
+    signal: AbortSignal.any([args.signal, args.context.closeSignal])
+  })) {
+    if (message.event !== AgentRealtimeKind.AcpFrame) continue;
+    try {
+      const event = acpFrameEventSchema.safeParse(JSON.parse(message.data));
+      if (event.success) yield event.data;
+    } catch {
+    }
+  }
+}
+const streamPreviews = (args) => {
+  const topic = agentRealtimeTopics.session(args.sessionId);
+  let unsubscribe = null;
+  let detachAbort = () => {
+  };
+  let detachClose = () => {
+  };
+  const queue = createAsyncQueue(() => {
+    unsubscribe?.();
+    detachAbort();
+    detachClose();
+  });
+  const onFrame = (raw) => {
+    const frame = agentRealtimeFrameSchema.safeParse(raw);
+    if (!frame.success) return;
+    if (frame.data.type === AgentRealtimeFrameType.Error && isTerminalRealtimeError(frame.data)) {
+      queue.fail(
+        realtimeSubscriptionError({
+          topic: frame.data.topic ?? topic,
+          code: frame.data.code ?? "unknown",
+          message: frame.data.message ?? "Realtime subscription was refused"
+        })
+      );
+      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);
+  };
+  detachAbort = failOnAbort(queue, args.signal);
+  detachClose = failOnAbort(queue, args.context.closeSignal);
+  if (!queue.closed()) {
+    const stop = args.context.realtime().subscribe(topic, onFrame);
+    if (queue.closed()) stop();
+    else unsubscribe = stop;
+  }
+  return queue.iterator;
+};
+const frameSources = (args) => ({
+  replay: (page) => replay({ context: args.context, sessionId: args.sessionId, ...page }),
+  pending: (signal) => openPending({ ...args, signal }),
+  httpStream: (stream) => streamFramesOverHttp({ ...args, ...stream })
+});
+const createSessionHandle = (context, sessionId) => {
+  const { http } = context;
+  const post = async (args) => {
+    await http.request({
+      method: HttpMethod.Post,
+      path: sessionPath(sessionId, args.suffix),
+      body: args.body,
+      response: okResponseSchema,
+      signal: args.signal,
+      context: { sessionId }
+    });
+  };
+  return {
+    id: sessionId,
+    fork: async (options) => {
+      const created = await http.request({
+        method: HttpMethod.Post,
+        path: sessionPath(sessionId, "/fork"),
+        body: {
+          schema: forkSessionRequestSchema,
+          value: {
+            idempotencyKey: options?.idempotencyKey ?? context.newKey(),
+            title: options?.title
+          }
+        },
+        response: createSessionResponseSchema,
+        signal: options?.signal,
+        context: { sessionId }
+      });
+      return {
+        session: created.session,
+        handle: createSessionHandle(context, created.session.id),
+        response: null
+      };
+    },
+    attachment: (attachmentId, options) => http.request({
+      method: HttpMethod.Get,
+      path: sessionPath(sessionId, `/attachments/${encodePath(attachmentId)}`),
+      response: attachmentDownloadSchema,
+      signal: options?.signal
+    }),
+    get: (options) => http.request({
+      method: HttpMethod.Get,
+      path: sessionPath(sessionId),
+      response: sessionSchema,
+      signal: options?.signal
+    }),
+    manifest: (options) => http.request({
+      method: HttpMethod.Get,
+      path: sessionPath(sessionId, "/manifest"),
+      response: sessionManifestSchema,
+      signal: options?.signal
+    }),
+    send: async (content, options) => {
+      const accepted = await http.request({
+        method: HttpMethod.Post,
+        path: sessionPath(sessionId, "/prompt"),
+        body: {
+          schema: promptSessionRequestSchema,
+          value: {
+            content,
+            turnPolicy: options?.turnPolicy,
+            idempotencyKey: options?.idempotencyKey ?? context.newKey(),
+            meta: options?.meta,
+            clientSubmittedAtMs: options?.clientSubmittedAtMs ?? context.now()
+          }
+        },
+        response: promptAcceptedSchema,
+        signal: options?.signal,
+        context: { sessionId }
+      });
+      return turnHandle({ context, sessionId, accepted });
+    },
+    observe: (content, options) => post({
+      suffix: "/observe",
+      body: {
+        schema: observeSessionRequestSchema,
+        value: {
+          content,
+          idempotencyKey: options?.idempotencyKey ?? context.newKey(),
+          meta: options?.meta
+        }
+      },
+      signal: options?.signal
+    }),
+    stream: (options) => streamSessionFrames({
+      sessionId,
+      fromSeq: options?.fromSeq ?? FIRST_ACP_FRAME_SEQ,
+      follow: options?.follow ?? true,
+      ...frameSources({ context, sessionId }),
+      transport: context.realtime(),
+      timing: context.timing,
+      signal: options?.signal,
+      closeSignal: context.closeSignal
+    }),
+    liveEvents: (options) => streamSessionLiveEvents({ context, sessionId, signal: options?.signal }),
+    previews: (options) => streamPreviews({ context, sessionId, signal: options?.signal }),
+    frames: (options) => replay({ context, sessionId, ...options }),
+    pending: (options) => openPending({ context, sessionId, signal: options?.signal }),
+    turn: (turnId, options) => getTurn({ context, sessionId, turnId, signal: options?.signal }),
+    response: async (turnId, options) => {
+      const receipt = await getTurn({ context, sessionId, turnId, signal: options?.signal });
+      return turnHandle({
+        context,
+        sessionId,
+        accepted: {
+          turnId: receipt.id,
+          messageId: receipt.promptMessageId,
+          fromSeq: receipt.fromSeq
+        }
+      });
+    },
+    respond: (args, options) => http.request({
+      method: HttpMethod.Post,
+      path: sessionPath(sessionId, "/respond"),
+      body: {
+        schema: respondPendingRequestSchema,
+        value: { pendingId: args.pendingId, outcome: outcomeOf(args) }
+      },
+      response: respondPendingResponseSchema,
+      signal: options?.signal,
+      context: { sessionId, pendingId: args.pendingId }
+    }),
+    cancel: (options) => post({
+      suffix: "/cancel",
+      body: { schema: cancelRequestSchema, value: { reason: options?.reason } },
+      signal: options?.signal
+    }),
+    setConfigOption: (args, options) => post({
+      suffix: "/config-option",
+      body: { schema: setConfigOptionRequestSchema, value: args },
+      signal: options?.signal
+    }),
+    close: (options) => post({ suffix: "/close", signal: options?.signal })
+  };
+};
+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)
+});
+export {
+  createSessionHandle,
+  createSessionsApi,
+  outcomeOf
+};
+//# sourceMappingURL=sessions.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/agent-client/sessions.ts"],
+  "sourcesContent": ["import type { JsonObjectIface, JsonValue } from '@finalai/agent-protocol';\nimport {\n  acpFrameEventSchema,\n  acpPreviewEventSchema,\n  agentRealtimeFrameSchema,\n  AgentRealtimeFrameType,\n  AgentRealtimeKind,\n  agentRealtimeTopics,\n  attachmentDownloadSchema,\n  cancelRequestSchema,\n  createSessionRequestSchema,\n  createSessionResponseSchema,\n  FIRST_ACP_FRAME_SEQ,\n  forkSessionRequestSchema,\n  observeSessionRequestSchema,\n  okResponseSchema,\n  pendingRequestListSchema,\n  promptAcceptedSchema,\n  promptSessionRequestSchema,\n  respondPendingRequestSchema,\n  respondPendingResponseSchema,\n  sessionFramesPageSchema,\n  sessionManifestSchema,\n  sessionSchema,\n  setConfigOptionRequestSchema,\n  turnSchema,\n  type AcpFrameEventIface,\n  type AcpPreviewEventIface,\n  type AgentSessionIface,\n  type AgentTurnIface,\n  type AgentTurnPolicy,\n  type AttachmentDownloadIface,\n  type ContentInput,\n  type PendingOutcomeInput,\n  type PendingRequestIface,\n  type PromptAcceptedIface,\n  type RespondPendingResponseIface,\n  type SessionFramesPageIface,\n  type SessionManifestIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { createTextCollector, isUserMessageFor, turnEndOf } from \"./acp-frames.mjs\";\nimport { createAsyncQueue, failOnAbort } from \"./async-queue.mjs\";\nimport {\n  encodePath,\n  type ClientContextIface,\n  type EnumInput,\n  type SignalOptionsIface,\n} from \"./context.mjs\";\nimport { isTerminalRealtimeError, realtimeSubscriptionError } from \"./errors.mjs\";\nimport { streamServerSentEvents } from \"./event-stream.mjs\";\nimport { streamSessionFrames } from \"./frame-stream.mjs\";\nimport { HttpMethod, type HttpBodyIface } from \"./http.mjs\";\nimport { streamSessionLiveEvents, type SessionLiveEvent } from \"./live-stream.mjs\";\nimport type { RealtimeTransportFrameIface } from \"./realtime.mjs\";\n\n/** Answer a pending request by option id (permission) or with a full ACP outcome. */\nexport type RespondArgs =\n  | { pendingId: string; optionId: string }\n  | { pendingId: string; outcome: PendingOutcomeInput };\n\nexport interface StreamOptionsIface extends SignalOptionsIface {\n  /** Inclusive; defaults to `FIRST_ACP_FRAME_SEQ` (the whole log). Earlier values are clamped. */\n  fromSeq?: number;\n  /** Keep streaming live frames after replay catches up; defaults to true. */\n  follow?: boolean;\n}\n\nexport interface TurnResultIface<MessageId extends string | null = string> {\n  messageId: MessageId;\n  turnId: string;\n  stopReason: string | null;\n  /** Visible agent text of the turn. */\n  text: string;\n  /** Seq of the frame that ended the turn. */\n  toSeq: number;\n}\n\n/** An accepted prompt. `stream()` yields this turn's frames; `result()` waits for its end. */\nexport interface TurnHandleIface<MessageId extends string | null = string> extends Omit<\n  PromptAcceptedIface,\n  'messageId'\n> {\n  messageId: MessageId;\n  sessionId: string;\n  get: (options?: SignalOptionsIface) => Promise<AgentTurnIface>;\n  stream: (options?: SignalOptionsIface) => AsyncIterableIterator<AcpFrameEventIface>;\n  result: (options?: SignalOptionsIface) => Promise<TurnResultIface<MessageId>>;\n}\n\nexport interface SendOptionsIface extends SignalOptionsIface {\n  turnPolicy?: EnumInput<AgentTurnPolicy>;\n  idempotencyKey?: string;\n  meta?: JsonObjectIface;\n  /** When the person submitted, for the prompt-to-inference trace; defaults to now. */\n  clientSubmittedAtMs?: number;\n}\n\nexport interface ForkSessionOptionsIface extends SignalOptionsIface {\n  /** Retain this key when retrying an interrupted fork. Defaults to a new key. */\n  idempotencyKey?: string;\n  title?: string;\n}\n\n/** An I/O-free handle on one session; every method is one HTTP call or one stream. */\nexport interface SessionHandleIface {\n  id: string;\n  /** Native fork of an idle source on its pinned revision; the standalone child has fresh scopes. */\n  fork: (options?: ForkSessionOptionsIface) => Promise<CreatedSessionIface>;\n  get: (options?: SignalOptionsIface) => Promise<AgentSessionIface>;\n  /** Resolves a `final-attachment:` resource link from this session's frames. */\n  attachment: (\n    attachmentId: string,\n    options?: SignalOptionsIface,\n  ) => Promise<AttachmentDownloadIface>;\n  send: (content: ContentInput, options?: SendOptionsIface) => Promise<TurnHandleIface>;\n  /** Adds content to history without a model call (`_final/session/observe`). */\n  observe: (\n    content: ContentInput,\n    options?: SignalOptionsIface & { idempotencyKey?: string; meta?: JsonObjectIface },\n  ) => Promise<void>;\n  stream: (options?: StreamOptionsIface) => AsyncIterableIterator<AcpFrameEventIface>;\n  /** Full provisional frames and reset notices; never a durable replay cursor or receipt. */\n  liveEvents: (options?: SignalOptionsIface) => AsyncIterableIterator<SessionLiveEvent>;\n  /**\n   * `acp.preview` events: the text of message and thought chunks as the session\n   * publishes them, live only (never replayed), for surfaces that render text\n   * ahead of the durable frames and the conversation's projected messages.\n   */\n  previews: (options?: SignalOptionsIface) => AsyncIterableIterator<AcpPreviewEventIface>;\n  /** One replay page (`GET /sessions/:id/frames`). */\n  frames: (\n    options: SignalOptionsIface & { fromSeq: number; limit?: number },\n  ) => Promise<SessionFramesPageIface>;\n  pending: (options?: SignalOptionsIface) => Promise<PendingRequestIface[]>;\n  turn: (turnId: string, options?: SignalOptionsIface) => Promise<AgentTurnIface>;\n  /** Reconstruct an accepted response from its durable turn id, without resending its prompt. */\n  response: (\n    turnId: string,\n    options?: SignalOptionsIface,\n  ) => Promise<TurnHandleIface<string | null>>;\n  respond: (\n    args: RespondArgs,\n    options?: SignalOptionsIface,\n  ) => Promise<RespondPendingResponseIface>;\n  cancel: (options?: SignalOptionsIface & { reason?: string }) => Promise<void>;\n  /**\n   * ACP `session/set_config_option` (model, reasoning, mode, ...): `configId` and a value\n   * from the options the harness advertises (`get().configOptions`, `configSelectsOf`).\n   * Changing them takes the session's owner, or a conversation owner or admin.\n   */\n  setConfigOption: (\n    args: { configId: string; value: JsonValue },\n    options?: SignalOptionsIface,\n  ) => Promise<void>;\n  close: (options?: SignalOptionsIface) => Promise<void>;\n  /** Resolved manifest and resolver report; secret-bearing output requires agents:read and admin secret-binding access. */\n  manifest: (options?: SignalOptionsIface) => Promise<SessionManifestIface>;\n}\n\nexport interface CreateSessionArgsIface extends SignalOptionsIface {\n  /** Agent slug or id. */\n  agent: string;\n  /** Pin an author test session to a revision returned by definitions.testRevision. */\n  revisionId?: string;\n  message?: ContentInput;\n  turnPolicy?: EnumInput<AgentTurnPolicy>;\n  idempotencyKey?: string;\n  title?: string;\n  meta?: JsonObjectIface;\n  /** When the person submitted `message`; defaults to now. */\n  clientSubmittedAtMs?: number;\n}\n\nexport interface CreatedSessionIface {\n  session: AgentSessionIface;\n  handle: SessionHandleIface;\n  /** The first turn when `message` was given. */\n  response: TurnHandleIface | null;\n}\n\nexport interface SessionsApiIface {\n  create: (args: CreateSessionArgsIface) => Promise<CreatedSessionIface>;\n  fork: (sessionId: string, options?: ForkSessionOptionsIface) => Promise<CreatedSessionIface>;\n  get: (sessionId: string, options?: SignalOptionsIface) => Promise<AgentSessionIface>;\n  attach: (sessionId: string) => SessionHandleIface;\n}\n\nexport const outcomeOf = (args: RespondArgs): PendingOutcomeInput =>\n  'optionId' in args ? { outcome: 'selected', optionId: args.optionId } : args.outcome;\n\nconst sessionPath = (sessionId: string, suffix = ''): string =>\n  `/v1/sessions/${encodePath(sessionId)}${suffix}`;\n\ninterface TurnHandleArgsIface<MessageId extends string | null> {\n  context: ClientContextIface;\n  sessionId: string;\n  accepted: Omit<PromptAcceptedIface, 'messageId'> & { messageId: MessageId };\n}\n\nconst turnHandle = <MessageId extends string | null>(\n  args: TurnHandleArgsIface<MessageId>,\n): TurnHandleIface<MessageId> => {\n  const { context, sessionId, accepted } = args;\n  const get = (options?: SignalOptionsIface) =>\n    getTurn({ context, sessionId, turnId: accepted.turnId, signal: options?.signal });\n  const stream = (options?: SignalOptionsIface): AsyncIterableIterator<AcpFrameEventIface> => {\n    // Without the prompt's seq, scan from the start for ACP's user message with this id.\n    // `until` runs as frames are queued and `next` as they are consumed, so each tracks its own start.\n    let queuedStart = accepted.messageId == null && accepted.fromSeq != null;\n    let started = queuedStart;\n    const frames = streamSessionFrames({\n      sessionId,\n      fromSeq: accepted.fromSeq ?? FIRST_ACP_FRAME_SEQ,\n      follow: true,\n      ...frameSources({ context, sessionId }),\n      transport: context.realtime(),\n      timing: context.timing,\n      signal: options?.signal,\n      closeSignal: context.closeSignal,\n      terminal: async (signal) => {\n        const receipt = await get({ signal });\n        return receipt.endedAt == null ? null : { throughSeq: receipt.toSeq ?? 0 };\n      },\n      until: (event) => {\n        if (\n          !queuedStart &&\n          accepted.messageId != null &&\n          isUserMessageFor(event, accepted.messageId)\n        )\n          queuedStart = true;\n        return queuedStart && turnEndOf(event) != null;\n      },\n    });\n    const iterator: AsyncIterableIterator<AcpFrameEventIface> = {\n      next: async () => {\n        for (;;) {\n          const next = await frames.next();\n          if (next.done === true || started) return next;\n          if (accepted.messageId != null && isUserMessageFor(next.value, accepted.messageId)) {\n            started = true;\n            return next;\n          }\n        }\n      },\n      return: () => frames.return?.() ?? Promise.resolve({ done: true, value: undefined }),\n      [Symbol.asyncIterator]: () => iterator,\n    };\n    return iterator;\n  };\n\n  const result = async (options?: SignalOptionsIface): Promise<TurnResultIface<MessageId>> => {\n    const text = createTextCollector();\n    let last: AcpFrameEventIface | null = null;\n    for await (const event of stream(options)) {\n      text.add(event);\n      last = event;\n    }\n    const end = last == null ? null : turnEndOf(last);\n    const receipt = await get(options);\n    return {\n      messageId: accepted.messageId,\n      turnId: accepted.turnId,\n      stopReason: receipt.stopReason ?? end?.stopReason ?? null,\n      text: text.text(),\n      toSeq: receipt.toSeq ?? last?.seq ?? accepted.fromSeq ?? 0,\n    };\n  };\n\n  return { ...accepted, sessionId, get, stream, result };\n};\n\nconst getTurn = (args: {\n  context: ClientContextIface;\n  sessionId: string;\n  turnId: string;\n  signal?: AbortSignal;\n}): Promise<AgentTurnIface> =>\n  args.context.http.request({\n    method: HttpMethod.Get,\n    path: sessionPath(args.sessionId, `/turns/${encodePath(args.turnId)}`),\n    response: turnSchema,\n    signal: args.signal,\n  });\n\ninterface ReplayArgsIface extends SignalOptionsIface {\n  context: ClientContextIface;\n  sessionId: string;\n  fromSeq: number;\n  limit?: number;\n}\n\nconst replay = (args: ReplayArgsIface): Promise<SessionFramesPageIface> =>\n  args.context.http.request({\n    method: HttpMethod.Get,\n    path: sessionPath(args.sessionId, '/frames'),\n    query: { fromSeq: args.fromSeq, limit: args.limit },\n    response: sessionFramesPageSchema,\n    signal: args.signal,\n  });\n\nconst openPending = async (args: {\n  context: ClientContextIface;\n  sessionId: string;\n  signal?: AbortSignal;\n}): Promise<PendingRequestIface[]> =>\n  (\n    await args.context.http.request({\n      method: HttpMethod.Get,\n      path: sessionPath(args.sessionId, '/pending'),\n      response: pendingRequestListSchema,\n      signal: args.signal,\n    })\n  ).pending;\n\n/** The session's frames over Streamable HTTP (`GET /sessions/:id/frames/stream`), from `fromSeq`. */\nasync function* streamFramesOverHttp(args: {\n  context: ClientContextIface;\n  sessionId: string;\n  fromSeq: number;\n  signal: AbortSignal;\n}): AsyncGenerator<AcpFrameEventIface> {\n  for await (const message of streamServerSentEvents({\n    http: args.context.http,\n    path: sessionPath(args.sessionId, '/frames/stream'),\n    query: { fromSeq: args.fromSeq },\n    signal: AbortSignal.any([args.signal, args.context.closeSignal]),\n  })) {\n    if (message.event !== AgentRealtimeKind.AcpFrame) continue;\n    try {\n      const event = acpFrameEventSchema.safeParse(JSON.parse(message.data));\n      if (event.success) yield event.data;\n    } catch {\n      // A malformed event is skipped; replay fills any gap it leaves.\n    }\n  }\n}\n\n/** Live `acp.preview` events of the session topic. */\nconst streamPreviews = (args: {\n  context: ClientContextIface;\n  sessionId: string;\n  signal?: AbortSignal;\n}): AsyncIterableIterator<AcpPreviewEventIface> => {\n  const topic = agentRealtimeTopics.session(args.sessionId);\n  let unsubscribe: (() => void) | null = null;\n  let detachAbort: () => void = () => {};\n  let detachClose: () => void = () => {};\n  const queue = createAsyncQueue<AcpPreviewEventIface>(() => {\n    unsubscribe?.();\n    detachAbort();\n    detachClose();\n  });\n  const onFrame = (raw: RealtimeTransportFrameIface): void => {\n    const frame = agentRealtimeFrameSchema.safeParse(raw);\n    if (!frame.success) return;\n    if (frame.data.type === AgentRealtimeFrameType.Error && isTerminalRealtimeError(frame.data)) {\n      queue.fail(\n        realtimeSubscriptionError({\n          topic: frame.data.topic ?? topic,\n          code: frame.data.code ?? 'unknown',\n          message: frame.data.message ?? 'Realtime subscription was refused',\n        }),\n      );\n      return;\n    }\n    if (frame.data.type !== AgentRealtimeFrameType.Event) return;\n    if (frame.data.kind !== AgentRealtimeKind.AcpPreview) return;\n    const preview = acpPreviewEventSchema.safeParse(frame.data.payload);\n    if (preview.success) queue.push(preview.data);\n  };\n  detachAbort = failOnAbort(queue, args.signal);\n  detachClose = failOnAbort(queue, args.context.closeSignal);\n  if (!queue.closed()) {\n    const stop = args.context.realtime().subscribe(topic, onFrame);\n    if (queue.closed()) stop();\n    else unsubscribe = stop;\n  }\n  return queue.iterator;\n};\n\n/** Replay, open pending requests and the Streamable HTTP fallback of one session's frame stream. */\nconst frameSources = (args: { context: ClientContextIface; sessionId: string }) => ({\n  replay: (page: { fromSeq: number; limit: number; signal?: AbortSignal }) =>\n    replay({ context: args.context, sessionId: args.sessionId, ...page }),\n  pending: (signal?: AbortSignal) => openPending({ ...args, signal }),\n  httpStream: (stream: { fromSeq: number; signal: AbortSignal }) =>\n    streamFramesOverHttp({ ...args, ...stream }),\n});\n\nexport const createSessionHandle = (\n  context: ClientContextIface,\n  sessionId: string,\n): SessionHandleIface => {\n  const { http } = context;\n  const post = async (args: {\n    suffix: string;\n    body?: HttpBodyIface;\n    signal?: AbortSignal;\n  }): Promise<void> => {\n    await http.request({\n      method: HttpMethod.Post,\n      path: sessionPath(sessionId, args.suffix),\n      body: args.body,\n      response: okResponseSchema,\n      signal: args.signal,\n      context: { sessionId },\n    });\n  };\n\n  return {\n    id: sessionId,\n    fork: async (options) => {\n      const created = await http.request({\n        method: HttpMethod.Post,\n        path: sessionPath(sessionId, '/fork'),\n        body: {\n          schema: forkSessionRequestSchema,\n          value: {\n            idempotencyKey: options?.idempotencyKey ?? context.newKey(),\n            title: options?.title,\n          },\n        },\n        response: createSessionResponseSchema,\n        signal: options?.signal,\n        context: { sessionId },\n      });\n      return {\n        session: created.session,\n        handle: createSessionHandle(context, created.session.id),\n        response: null,\n      };\n    },\n    attachment: (attachmentId, options) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: sessionPath(sessionId, `/attachments/${encodePath(attachmentId)}`),\n        response: attachmentDownloadSchema,\n        signal: options?.signal,\n      }),\n    get: (options) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: sessionPath(sessionId),\n        response: sessionSchema,\n        signal: options?.signal,\n      }),\n    manifest: (options) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: sessionPath(sessionId, '/manifest'),\n        response: sessionManifestSchema,\n        signal: options?.signal,\n      }),\n    send: async (content, options) => {\n      const accepted = await http.request({\n        method: HttpMethod.Post,\n        path: sessionPath(sessionId, '/prompt'),\n        body: {\n          schema: promptSessionRequestSchema,\n          value: {\n            content,\n            turnPolicy: options?.turnPolicy,\n            idempotencyKey: options?.idempotencyKey ?? context.newKey(),\n            meta: options?.meta,\n            clientSubmittedAtMs: options?.clientSubmittedAtMs ?? context.now(),\n          },\n        },\n        response: promptAcceptedSchema,\n        signal: options?.signal,\n        context: { sessionId },\n      });\n      return turnHandle({ context, sessionId, accepted });\n    },\n    observe: (content, options) =>\n      post({\n        suffix: '/observe',\n        body: {\n          schema: observeSessionRequestSchema,\n          value: {\n            content,\n            idempotencyKey: options?.idempotencyKey ?? context.newKey(),\n            meta: options?.meta,\n          },\n        },\n        signal: options?.signal,\n      }),\n    stream: (options) =>\n      streamSessionFrames({\n        sessionId,\n        fromSeq: options?.fromSeq ?? FIRST_ACP_FRAME_SEQ,\n        follow: options?.follow ?? true,\n        ...frameSources({ context, sessionId }),\n        transport: context.realtime(),\n        timing: context.timing,\n        signal: options?.signal,\n        closeSignal: context.closeSignal,\n      }),\n    liveEvents: (options) =>\n      streamSessionLiveEvents({ context, sessionId, signal: options?.signal }),\n    previews: (options) => streamPreviews({ context, sessionId, signal: options?.signal }),\n    frames: (options) => replay({ context, sessionId, ...options }),\n    pending: (options) => openPending({ context, sessionId, signal: options?.signal }),\n    turn: (turnId, options) => getTurn({ context, sessionId, turnId, signal: options?.signal }),\n    response: async (turnId, options) => {\n      const receipt = await getTurn({ context, sessionId, turnId, signal: options?.signal });\n      return turnHandle({\n        context,\n        sessionId,\n        accepted: {\n          turnId: receipt.id,\n          messageId: receipt.promptMessageId,\n          fromSeq: receipt.fromSeq,\n        },\n      });\n    },\n    respond: (args, options) =>\n      http.request({\n        method: HttpMethod.Post,\n        path: sessionPath(sessionId, '/respond'),\n        body: {\n          schema: respondPendingRequestSchema,\n          value: { pendingId: args.pendingId, outcome: outcomeOf(args) },\n        },\n        response: respondPendingResponseSchema,\n        signal: options?.signal,\n        context: { sessionId, pendingId: args.pendingId },\n      }),\n    cancel: (options) =>\n      post({\n        suffix: '/cancel',\n        body: { schema: cancelRequestSchema, value: { reason: options?.reason } },\n        signal: options?.signal,\n      }),\n    setConfigOption: (args, options) =>\n      post({\n        suffix: '/config-option',\n        body: { schema: setConfigOptionRequestSchema, value: args },\n        signal: options?.signal,\n      }),\n    close: (options) => post({ suffix: '/close', signal: options?.signal }),\n  };\n};\n\nexport const createSessionsApi = (context: ClientContextIface): SessionsApiIface => ({\n  create: async (args) => {\n    const created = await context.http.request({\n      method: HttpMethod.Post,\n      path: '/v1/sessions',\n      body: {\n        schema: createSessionRequestSchema,\n        value: {\n          agent: args.agent,\n          revisionId: args.revisionId,\n          message: args.message,\n          turnPolicy: args.turnPolicy,\n          idempotencyKey:\n            args.idempotencyKey ?? (args.message == null ? undefined : context.newKey()),\n          title: args.title,\n          meta: args.meta,\n          clientSubmittedAtMs:\n            args.message == null ? undefined : (args.clientSubmittedAtMs ?? context.now()),\n        },\n      },\n      response: createSessionResponseSchema,\n      signal: args.signal,\n    });\n    const handle = createSessionHandle(context, created.session.id);\n    return {\n      session: created.session,\n      handle,\n      response:\n        created.turn == null\n          ? null\n          : turnHandle({ context, sessionId: created.session.id, accepted: created.turn }),\n    };\n  },\n  fork: (sessionId, options) => createSessionHandle(context, sessionId).fork(options),\n  get: (sessionId, options) => createSessionHandle(context, sessionId).get(options),\n  attach: (sessionId) => createSessionHandle(context, sessionId),\n});\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/modules/agent-client/test-fakes.d.mts

@@ -0,0 +1,40 @@
+import type { JsonValue } from '@finalai/agent-protocol';
+import type { FetchIface } from "./http.mjs";
+import type { RealtimeTransportFrameIface, RealtimeTransportIface } from "./realtime.mjs";
+export interface RecordedRequestIface {
+    method: string;
+    path: string;
+    query: URLSearchParams;
+    headers: Record<string, string>;
+    credentials: RequestCredentials | undefined;
+    body: JsonValue | null;
+}
+export interface FakeResponseIface {
+    status?: number;
+    json?: JsonValue;
+    text?: string;
+}
+export type FakeRoute = (request: RecordedRequestIface) => FakeResponseIface;
+export declare const createFakeFetch: (routes: Record<string, FakeRoute>) => {
+    fetch: FetchIface;
+    requests: RecordedRequestIface[];
+};
+export declare const createFakeTransport: () => {
+    transport: RealtimeTransportIface;
+    emit: (topic: string, frame: RealtimeTransportFrameIface) => void;
+    subscriptions: string[];
+    listenerCount: (topic: string) => number;
+};
+export declare const eventFrame: (args: {
+    topic: string;
+    kind: string;
+    payload: JsonValue;
+}) => RealtimeTransportFrameIface;
+export declare const sessionUpdateFrame: (args: {
+    seq: number;
+    update: JsonValue;
+    direction?: string;
+}) => JsonValue;
+export declare const promptFrame: (seq: number) => JsonValue;
+/** Lets pending promise callbacks (replay fetches) run. */
+export declare const flush: () => Promise<void>;