@finalai/agents 0.10.0 → 0.12.0

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

@@ -1,20 +1,36 @@
-import { type AgentInfoIface, type AgentListIface, type HealthResponseIface, type PersonIface, type PersonListIface, type RealtimeSessionResponseIface } from '@finalai/agent-protocol/agent-platform';
+import { type AgentListIface, type DecisionIface, type HealthResponseIface, type InferenceOfferingIface, type PersonIface, type PersonListIface, type PlatformIdentityExchangeRequestIface, type PlatformIdentityExchangeResponseIface, type RealtimeSessionResponseIface } from '@finalai/agent-protocol/agent-platform';
 import { type AcpApiIface } from "./acp.mjs";
-import { type ComputerSetupGuidesApiIface, type DefinitionsApiIface, type ProvidersApiIface, type SchedulesApiIface } from "./build.mjs";
+import type { AgentValueCodecIface } from "./agent-input.mjs";
+import { type ChannelBindingsApiIface, type ChannelSourceOf } from "./channels.mjs";
 import { type SignalOptionsIface } from "./context.mjs";
-import { type ChannelBindingsApiIface } from "./channels.mjs";
 import { type ConversationsApiIface } from "./conversations.mjs";
+import { type EventsApiIface, type EventSubscriptionsApiIface } from "./events.mjs";
 import { type StreamTimingIface } from "./frame-stream.mjs";
 import { type AgentClientAuth, type FetchIface, type HeadersOption } from "./http.mjs";
 import { type GatewayConnect, type RealtimeTransportIface } from "./realtime.mjs";
+import type { LocalComputeIface, LocalHostSocketIface } from "./local-host.mjs";
+import { type ProjectClientIface } from "./project.mjs";
+import { type ProjectsApiIface } from "./projects.mjs";
+import { type PublishersApiIface } from "./publishers.mjs";
+import { type SchedulesApiIface } from "./schedules.mjs";
 import { type SessionsApiIface } from "./sessions.mjs";
+/** Final's agents API. */
+export declare const DEFAULT_AGENTS_HOST = "https://agent-session.final.ai";
 export interface CreateClientOptionsIface {
+    auth: AgentClientAuth;
     /**
-     * The agents API origin (`https://agent-session.final.ai`; its API is under
-     * `/api` and ACP at `/acp/ws`), or a base URL the API routes are mounted under.
+     * Whether this process provides the files and shell an agent requires when
+     * the caller leaves them out (default true), so the model's file edits and
+     * commands run here, on this machine. A server should provide every
+     * capability explicitly and pass false, so an omission fails with
+     * `requirements_unmet` instead of giving the model a shell in the server.
      */
-    host: string;
-    auth: AgentClientAuth;
+    localCompute?: boolean;
+    /**
+     * The agents API origin (default `https://agent-session.final.ai`; its API is
+     * under `/api` and ACP at `/acp/ws`), or a base URL the API routes are mounted under.
+     */
+    host?: string;
     /** Extra headers per request; console clients send their client identity header here. */
     headers?: HeadersOption;
     /** API requests (the host's routes); carries auth and caller headers. */
@@ -36,24 +52,29 @@ export interface CreateClientOptionsIface {
     newKey?: () => string;
     /** Seam for the client clock (conversation recovery windows). */
     now?: () => number;
-}
-export interface AgentHandleIface {
-    slug: string;
-    info: (options?: SignalOptionsIface) => Promise<AgentInfoIface>;
+    /** Seam: how agent values become documents and in-process code. */
+    agentCodec?: AgentValueCodecIface;
+    /** Seam: how a channel value becomes its source. */
+    channelSourceOf?: ChannelSourceOf;
+    /** Seams for local hosts: the socket, and the sandbox this process serves. */
+    localHosts?: {
+        /** Opens the local host socket; abandons it when `signal` aborts. */
+        dial?: (path: string, signal?: AbortSignal) => Promise<LocalHostSocketIface>;
+        compute?: Partial<LocalComputeIface>;
+    };
 }
 export interface AgentsApiIface {
     /**
      * The agents the caller can use; with `projectId`, those usable there (its own and those
      * inherited from its ancestors). Without it, everything the caller can access (an API key: its
      * parent project and every project it is granted; a person: every project they can read).
+     * Fetch one as data with `client.project({ id }).agents.get`.
      */
     list: (options?: SignalOptionsIface & {
         cursor?: string;
         limit?: number;
         projectId?: string;
     }) => Promise<AgentListIface>;
-    /** I/O-free handle by slug or id. */
-    get: (slugOrId: string) => AgentHandleIface;
 }
 export interface PeopleApiIface {
     /** One page of the caller's organization members, by name; pass `nextCursor` as `cursor` for the next. */
@@ -72,17 +93,59 @@ export interface RealtimeApiIface {
      */
     createSession: (options?: SignalOptionsIface) => Promise<RealtimeSessionResponseIface>;
 }
+export interface InferenceApiIface {
+    /**
+     * The vendors and models the platform's own metered inference serves, with
+     * prices (`GET /v1/inference/offering`, public). A harness using the
+     * platform's inference can run only models listed here.
+     */
+    offering: (options?: SignalOptionsIface) => Promise<InferenceOfferingIface>;
+}
+export interface PlatformIdentityApiIface {
+    /**
+     * Exchanges a sandbox-provider (or downstream) assertion the platform issued
+     * for a fresh one: for the provider's own URL (a refresh) or a backend its
+     * registration was granted. The subject token is the credential.
+     */
+    exchange: (args: PlatformIdentityExchangeRequestIface & SignalOptionsIface) => Promise<PlatformIdentityExchangeResponseIface>;
+}
+export interface DecisionsApiIface {
+    /** One decision awaiting the caller's answer, as `conversations.decisions` lists it. */
+    get: (args: {
+        id: string;
+    } & SignalOptionsIface) => Promise<DecisionIface>;
+}
+export interface AppApiIface {
+    /**
+     * The calling app's event subscriptions, across every organization that
+     * installed it. Needs an app-level token.
+     */
+    eventSubscriptions: EventSubscriptionsApiIface;
+}
 export interface AgentClientIface {
+    /** One project: where sessions, conversations, sandboxes and integrations are created. */
+    project: (args: {
+        id: string;
+    }) => ProjectClientIface;
+    /** The project tree: list projects and create them. */
+    projects: ProjectsApiIface;
+    /** The event feed across everything the caller can see; `project({ id }).events` narrows it. */
+    events: EventsApiIface;
+    app: AppApiIface;
+    /** Publishers' public agents, channels, harnesses and ACP adapters. */
+    publishers: PublishersApiIface;
+    inference: InferenceApiIface;
+    platformIdentity: PlatformIdentityApiIface;
+    decisions: DecisionsApiIface;
     health: (options?: SignalOptionsIface) => Promise<HealthResponseIface>;
     agents: AgentsApiIface;
     people: PeopleApiIface;
     realtime: RealtimeApiIface;
+    /** Existing sessions by id; create them through `project({ id }).sessions`. */
     sessions: SessionsApiIface;
+    /** The caller's conversations; create them through `project({ id }).conversations`. */
     conversations: ConversationsApiIface;
     channelBindings: ChannelBindingsApiIface;
-    definitions: DefinitionsApiIface;
-    providers: ProvidersApiIface;
-    computerSetupGuides: ComputerSetupGuidesApiIface;
     schedules: SchedulesApiIface;
     /**
      * ACP-native access (`/acp/ws`): an ACP v2 ClientApp connection on which the
@@ -90,10 +153,12 @@ export interface AgentClientIface {
      */
     acp: AcpApiIface;
     /**
-     * Ends every stream (they reject with a `client_closed` ClientError) and, when
-     * the client created its own realtime transport, closes the gateway connection
-     * and cancels its retries. A transport passed in `realtime` belongs to the
-     * caller and is left open. Idempotent.
+     * Ends every stream (they reject with a `client_closed` ClientError) and every
+     * local host connection (the platform then reports this process's tools and
+     * compute as unavailable; sessions carry on) and, when the client created its
+     * own realtime transport, closes the gateway connection and cancels its
+     * retries. A transport passed in `realtime` belongs to the caller and is left
+     * open. Idempotent.
      */
     close: () => void;
     [Symbol.asyncDispose]: () => Promise<void>;

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

@@ -1,22 +1,31 @@
 import {
-  agentInfoSchema,
   agentListSchema,
   agentRealtimeTopics,
+  decisionResponseSchema,
   healthResponseSchema,
+  inferenceOfferingSchema,
   personListSchema,
+  platformIdentityExchangeRequestSchema,
+  platformIdentityExchangeResponseSchema,
   realtimeSessionResponseSchema
 } from "@finalai/agent-protocol/agent-platform";
 import { createAcpApi } from "./acp.mjs";
 import {
-  createComputerSetupGuidesApi,
-  createDefinitionsApi,
-  createProvidersApi,
-  createSchedulesApi
-} from "./build.mjs";
+  createChannelBindingsApi
+} from "./channels.mjs";
 import { encodePath } from "./context.mjs";
-import { createChannelBindingsApi } from "./channels.mjs";
 import { createConversationsApi } from "./conversations.mjs";
+import {
+  defaultAgentCodec,
+  defaultChannelSourceOf,
+  defaultLocalCompute,
+  defaultLocalHostDial
+} from "./defaults.mjs";
 import { clientError, ClientErrorCode } from "./errors.mjs";
+import {
+  createEventsApi,
+  createEventSubscriptionsApi
+} from "./events.mjs";
 import { defaultStreamTiming } from "./frame-stream.mjs";
 import {
   createHttp,
@@ -25,10 +34,15 @@ import {
 import {
   createGatewayRealtimeTransport
 } from "./realtime.mjs";
+import { createProjectClient } from "./project.mjs";
+import { createProjectsApi } from "./projects.mjs";
+import { createPublishersApi } from "./publishers.mjs";
+import { createSchedulesApi } from "./schedules.mjs";
 import { createSessionsApi } from "./sessions.mjs";
+const DEFAULT_AGENTS_HOST = "https://agent-session.final.ai";
 const createClient = (options) => {
   const http = createHttp({
-    host: options.host,
+    host: options.host ?? DEFAULT_AGENTS_HOST,
     auth: options.auth,
     headers: options.headers,
     fetch: options.fetch
@@ -92,11 +106,25 @@ const createClient = (options) => {
     newKey: options.newKey ?? (() => globalThis.crypto.randomUUID()),
     now: options.now ?? Date.now
   };
+  const hosts = /* @__PURE__ */ new Set();
+  const localCompute = defaultLocalCompute();
+  const start = {
+    context,
+    codec: options.agentCodec ?? defaultAgentCodec,
+    localCompute: options.localCompute ?? true,
+    compute: { ...localCompute, ...options.localHosts?.compute },
+    dial: options.localHosts?.dial ?? defaultLocalHostDial(http),
+    hosts
+  };
+  const channelSourceOf = options.channelSourceOf ?? defaultChannelSourceOf;
+  const clientLevel = { deps: start, projectId: null };
   const close = () => {
     if (closing.signal.aborted) return;
     closing.abort(
       clientError({ message: "Agent client closed", status: 0, code: ClientErrorCode.Closed })
     );
+    for (const host of hosts) host.close();
+    hosts.clear();
     ownTransport?.close();
   };
   return {
@@ -119,15 +147,6 @@ const createClient = (options) => {
         },
         response: agentListSchema,
         signal: listOptions?.signal
-      }),
-      get: (slugOrId) => ({
-        slug: slugOrId,
-        info: (infoOptions) => http.request({
-          method: HttpMethod.Get,
-          path: `/v1/agents/${encodePath(slugOrId)}`,
-          response: agentInfoSchema,
-          signal: infoOptions?.signal
-        })
       })
     },
     people: /* @__PURE__ */ (() => {
@@ -153,17 +172,51 @@ const createClient = (options) => {
       };
     })(),
     realtime: { createSession: createRealtimeSession },
+    project: ({ id }) => createProjectClient({ context, start, channelSourceOf, projectId: id }),
+    projects: createProjectsApi(context),
+    events: createEventsApi({ context, projectId: null }),
+    app: {
+      eventSubscriptions: createEventSubscriptionsApi({
+        context,
+        basePath: "/v1/apps/me/event-subscriptions"
+      })
+    },
+    publishers: createPublishersApi(context),
+    inference: {
+      offering: (offeringOptions) => http.request({
+        method: HttpMethod.Get,
+        path: "/v1/inference/offering",
+        response: inferenceOfferingSchema,
+        signal: offeringOptions?.signal
+      })
+    },
+    platformIdentity: {
+      exchange: ({ signal, ...value }) => http.request({
+        method: HttpMethod.Post,
+        path: "/v1/platform-identity/exchange",
+        body: { schema: platformIdentityExchangeRequestSchema, value },
+        response: platformIdentityExchangeResponseSchema,
+        signal
+      })
+    },
+    decisions: {
+      get: async ({ id, signal }) => (await http.request({
+        method: HttpMethod.Get,
+        path: `/v1/decisions/${encodePath(id)}`,
+        response: decisionResponseSchema,
+        signal,
+        context: { decisionId: id }
+      })).decision
+    },
     sessions: createSessionsApi(context),
-    conversations: createConversationsApi(context),
+    conversations: createConversationsApi(context, clientLevel),
     channelBindings: createChannelBindingsApi(context),
-    definitions: createDefinitionsApi(context),
-    providers: createProvidersApi(context),
-    computerSetupGuides: createComputerSetupGuidesApi(context),
     schedules: createSchedulesApi(context),
     acp: createAcpApi({ http })
   };
 };
 export {
+  DEFAULT_AGENTS_HOST,
   createClient
 };
 //# sourceMappingURL=client.mjs.map

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/agent-client/client.ts"],
-  "sourcesContent": ["import {\n  agentInfoSchema,\n  agentListSchema,\n  agentRealtimeTopics,\n  healthResponseSchema,\n  personListSchema,\n  realtimeSessionResponseSchema,\n  type AgentInfoIface,\n  type AgentListIface,\n  type HealthResponseIface,\n  type PersonIface,\n  type PersonListIface,\n  type RealtimeSessionResponseIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { createAcpApi, type AcpApiIface } from \"./acp.mjs\";\nimport {\n  createComputerSetupGuidesApi,\n  createDefinitionsApi,\n  createProvidersApi,\n  createSchedulesApi,\n  type ComputerSetupGuidesApiIface,\n  type DefinitionsApiIface,\n  type ProvidersApiIface,\n  type SchedulesApiIface,\n} from \"./build.mjs\";\nimport { encodePath, type ClientContextIface, type SignalOptionsIface } from \"./context.mjs\";\nimport { createChannelBindingsApi, type ChannelBindingsApiIface } from \"./channels.mjs\";\nimport { createConversationsApi, type ConversationsApiIface } from \"./conversations.mjs\";\nimport { clientError, ClientErrorCode } from \"./errors.mjs\";\nimport { defaultStreamTiming, type StreamTimingIface } from \"./frame-stream.mjs\";\nimport {\n  createHttp,\n  HttpMethod,\n  type AgentClientAuth,\n  type FetchIface,\n  type HeadersOption,\n} from \"./http.mjs\";\nimport {\n  createGatewayRealtimeTransport,\n  type GatewayConnect,\n  type GatewayRealtimeTransportIface,\n  type RealtimeTransportIface,\n} from \"./realtime.mjs\";\nimport { createSessionsApi, type SessionsApiIface } from \"./sessions.mjs\";\n\nexport interface CreateClientOptionsIface {\n  /**\n   * The agents API origin (`https://agent-session.final.ai`; its API is under\n   * `/api` and ACP at `/acp/ws`), or a base URL the API routes are mounted under.\n   */\n  host: string;\n  auth: AgentClientAuth;\n  /** Extra headers per request; console clients send their client identity header here. */\n  headers?: HeadersOption;\n  /** API requests (the host's routes); carries auth and caller headers. */\n  fetch?: FetchIface;\n  /**\n   * Presigned storage requests (attachment uploads). Gets only the headers the\n   * presign requires, never auth, client identity or cookies, so a storage\n   * bucket's CORS and third-party hosts see nothing of the caller. Defaults to\n   * `globalThis.fetch`; keep it free of header-injecting wrappers.\n   */\n  storageFetch?: FetchIface;\n  /** console-web and console-mobile pass their realtime clients; defaults to a gateway connection. */\n  realtime?: RealtimeTransportIface;\n  /** Seam for the default transport's gateway connection. */\n  gatewayConnect?: GatewayConnect;\n  /** Seam for stream retry timing (tests). */\n  timing?: Partial<StreamTimingIface>;\n  /** Seam for idempotency keys and client message ids; defaults to `crypto.randomUUID`. */\n  newKey?: () => string;\n  /** Seam for the client clock (conversation recovery windows). */\n  now?: () => number;\n}\n\nexport interface AgentHandleIface {\n  slug: string;\n  info: (options?: SignalOptionsIface) => Promise<AgentInfoIface>;\n}\n\nexport interface AgentsApiIface {\n  /**\n   * The agents the caller can use; with `projectId`, those usable there (its own and those\n   * inherited from its ancestors). Without it, everything the caller can access (an API key: its\n   * parent project and every project it is granted; a person: every project they can read).\n   */\n  list: (\n    options?: SignalOptionsIface & { cursor?: string; limit?: number; projectId?: string },\n  ) => Promise<AgentListIface>;\n  /** I/O-free handle by slug or id. */\n  get: (slugOrId: string) => AgentHandleIface;\n}\n\nexport interface PeopleApiIface {\n  /** One page of the caller's organization members, by name; pass `nextCursor` as `cursor` for the next. */\n  list: (\n    options?: SignalOptionsIface & { cursor?: string; limit?: number },\n  ) => Promise<PersonListIface>;\n  /** Every member of the caller's organization (all pages). */\n  all: (options?: SignalOptionsIface) => Promise<PersonIface[]>;\n}\n\nexport interface RealtimeApiIface {\n  /**\n   * Mints a gateway session (`POST /v1/realtime/session`) for the signed-in user:\n   * the gateway URL, a short-lived token, and the user id realtime topics are keyed by.\n   * Pass it as `createSession` to `createGatewayRealtimeTransport` when supplying a transport.\n   */\n  createSession: (options?: SignalOptionsIface) => Promise<RealtimeSessionResponseIface>;\n}\n\nexport interface AgentClientIface {\n  health: (options?: SignalOptionsIface) => Promise<HealthResponseIface>;\n  agents: AgentsApiIface;\n  people: PeopleApiIface;\n  realtime: RealtimeApiIface;\n  sessions: SessionsApiIface;\n  conversations: ConversationsApiIface;\n  channelBindings: ChannelBindingsApiIface;\n  definitions: DefinitionsApiIface;\n  providers: ProvidersApiIface;\n  computerSetupGuides: ComputerSetupGuidesApiIface;\n  schedules: SchedulesApiIface;\n  /**\n   * ACP-native access (`/acp/ws`): an ACP v2 ClientApp connection on which the\n   * agents API is the agent. The ACP SDK loads on the first `connect`.\n   */\n  acp: AcpApiIface;\n  /**\n   * Ends every stream (they reject with a `client_closed` ClientError) and, when\n   * the client created its own realtime transport, closes the gateway connection\n   * and cancels its retries. A transport passed in `realtime` belongs to the\n   * caller and is left open. Idempotent.\n   */\n  close: () => void;\n  [Symbol.asyncDispose]: () => Promise<void>;\n}\n\nexport const createClient = (options: CreateClientOptionsIface): AgentClientIface => {\n  const http = createHttp({\n    host: options.host,\n    auth: options.auth,\n    headers: options.headers,\n    fetch: options.fetch,\n  });\n  let realtime = options.realtime ?? null;\n  let ownTransport: GatewayRealtimeTransportIface | null = null;\n  const closing = new AbortController();\n  const createRealtimeSession: RealtimeApiIface['createSession'] = (sessionOptions) =>\n    http.request({\n      method: HttpMethod.Post,\n      path: '/v1/realtime/session',\n      response: realtimeSessionResponseSchema,\n      signal: sessionOptions?.signal,\n    });\n  let realtimeOwner: Promise<RealtimeSessionResponseIface> | null = null;\n  const realtimeOwnerSession = () => {\n    if (realtimeOwner != null) return realtimeOwner;\n    const pending = createRealtimeSession({ signal: closing.signal });\n    realtimeOwner = pending;\n    void pending.catch(() => {\n      if (realtimeOwner === pending) realtimeOwner = null;\n    });\n    return pending;\n  };\n  let realtimeUser: Promise<string> | null = null;\n  // Shared by every stream, so it is cancelled only with the client, never by one caller.\n  const realtimeUserId: ClientContextIface['realtimeUserId'] = () => {\n    if (realtimeUser != null) return realtimeUser;\n    const pending = realtimeOwnerSession().then((session) => {\n      if (session.userId == null)\n        throw new Error('This client authenticates as an API-key owner, not a user');\n      return session.userId;\n    });\n    realtimeUser = pending;\n    // A failed (or aborted) read is not cached.\n    pending.catch(() => {\n      if (realtimeUser === pending) realtimeUser = null;\n    });\n    return pending;\n  };\n  const context: ClientContextIface = {\n    http,\n    closeSignal: closing.signal,\n    realtimeUserId,\n    // Conversations is the only collection.\n    realtimeCollectionTopic: async () => {\n      const owner = await realtimeOwnerSession();\n      // API keys act in their project, not as members: they reach agents through channels.\n      if (owner.userId == null)\n        throw new Error('Collection streams belong to users; API-key owners use session streams');\n      return agentRealtimeTopics.userConversations(owner.userId);\n    },\n    storageFetch: options.storageFetch ?? ((input, init) => globalThis.fetch(input, init)),\n    realtime: () => {\n      if (realtime != null) return realtime;\n      ownTransport = createGatewayRealtimeTransport({\n        createSession: () => createRealtimeSession(),\n        connect: options.gatewayConnect,\n      });\n      if (closing.signal.aborted) ownTransport.close();\n      realtime = ownTransport;\n      return realtime;\n    },\n    timing: { ...defaultStreamTiming, ...options.timing },\n    newKey: options.newKey ?? (() => globalThis.crypto.randomUUID()),\n    now: options.now ?? Date.now,\n  };\n\n  const close = (): void => {\n    if (closing.signal.aborted) return;\n    closing.abort(\n      clientError({ message: 'Agent client closed', status: 0, code: ClientErrorCode.Closed }),\n    );\n    ownTransport?.close();\n  };\n\n  return {\n    close,\n    [Symbol.asyncDispose]: async () => close(),\n    health: (healthOptions) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: '/v1/health',\n        response: healthResponseSchema,\n        signal: healthOptions?.signal,\n      }),\n    agents: {\n      list: (listOptions) =>\n        http.request({\n          method: HttpMethod.Get,\n          path: '/v1/agents',\n          query: {\n            cursor: listOptions?.cursor,\n            limit: listOptions?.limit,\n            projectId: listOptions?.projectId,\n          },\n          response: agentListSchema,\n          signal: listOptions?.signal,\n        }),\n      get: (slugOrId) => ({\n        slug: slugOrId,\n        info: (infoOptions) =>\n          http.request({\n            method: HttpMethod.Get,\n            path: `/v1/agents/${encodePath(slugOrId)}`,\n            response: agentInfoSchema,\n            signal: infoOptions?.signal,\n          }),\n      }),\n    },\n    people: (() => {\n      const list: PeopleApiIface['list'] = (listOptions) =>\n        http.request({\n          method: HttpMethod.Get,\n          path: '/v1/people',\n          query: { cursor: listOptions?.cursor, limit: listOptions?.limit },\n          response: personListSchema,\n          signal: listOptions?.signal,\n        });\n      return {\n        list,\n        all: async (allOptions) => {\n          const all: PersonIface[] = [];\n          let cursor: string | undefined;\n          for (;;) {\n            const next = await list({ cursor, signal: allOptions?.signal });\n            all.push(...next.people);\n            if (next.nextCursor == null) return all;\n            cursor = next.nextCursor;\n          }\n        },\n      };\n    })(),\n    realtime: { createSession: createRealtimeSession },\n    sessions: createSessionsApi(context),\n    conversations: createConversationsApi(context),\n    channelBindings: createChannelBindingsApi(context),\n    definitions: createDefinitionsApi(context),\n    providers: createProvidersApi(context),\n    computerSetupGuides: createComputerSetupGuidesApi(context),\n    schedules: createSchedulesApi(context),\n    acp: createAcpApi({ http }),\n  };\n};\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {\n  agentListSchema,\n  agentRealtimeTopics,\n  decisionResponseSchema,\n  healthResponseSchema,\n  inferenceOfferingSchema,\n  personListSchema,\n  platformIdentityExchangeRequestSchema,\n  platformIdentityExchangeResponseSchema,\n  realtimeSessionResponseSchema,\n  type AgentListIface,\n  type DecisionIface,\n  type HealthResponseIface,\n  type InferenceOfferingIface,\n  type PersonIface,\n  type PersonListIface,\n  type PlatformIdentityExchangeRequestIface,\n  type PlatformIdentityExchangeResponseIface,\n  type RealtimeSessionResponseIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { createAcpApi, type AcpApiIface } from \"./acp.mjs\";\nimport type { AgentValueCodecIface } from \"./agent-input.mjs\";\nimport {\n  createChannelBindingsApi,\n  type ChannelBindingsApiIface,\n  type ChannelSourceOf,\n} from \"./channels.mjs\";\nimport { encodePath, type ClientContextIface, type SignalOptionsIface } from \"./context.mjs\";\nimport { createConversationsApi, type ConversationsApiIface } from \"./conversations.mjs\";\nimport {\n  defaultAgentCodec,\n  defaultChannelSourceOf,\n  defaultLocalCompute,\n  defaultLocalHostDial,\n} from \"./defaults.mjs\";\nimport { clientError, ClientErrorCode } from \"./errors.mjs\";\nimport {\n  createEventsApi,\n  createEventSubscriptionsApi,\n  type EventsApiIface,\n  type EventSubscriptionsApiIface,\n} from \"./events.mjs\";\nimport { defaultStreamTiming, type StreamTimingIface } from \"./frame-stream.mjs\";\nimport {\n  createHttp,\n  HttpMethod,\n  type AgentClientAuth,\n  type FetchIface,\n  type HeadersOption,\n} from \"./http.mjs\";\nimport {\n  createGatewayRealtimeTransport,\n  type GatewayConnect,\n  type GatewayRealtimeTransportIface,\n  type RealtimeTransportIface,\n} from \"./realtime.mjs\";\nimport type { LocalComputeIface, LocalHostIface, LocalHostSocketIface } from \"./local-host.mjs\";\nimport { createProjectClient, type ProjectClientIface } from \"./project.mjs\";\nimport { createProjectsApi, type ProjectsApiIface } from \"./projects.mjs\";\nimport { createPublishersApi, type PublishersApiIface } from \"./publishers.mjs\";\nimport { createSchedulesApi, type SchedulesApiIface } from \"./schedules.mjs\";\nimport { createSessionsApi, type SessionsApiIface } from \"./sessions.mjs\";\nimport type { AgentStartDepsIface } from \"./start.mjs\";\n\n/** Final's agents API. */\nexport const DEFAULT_AGENTS_HOST = 'https://agent-session.final.ai';\n\nexport interface CreateClientOptionsIface {\n  auth: AgentClientAuth;\n  /**\n   * Whether this process provides the files and shell an agent requires when\n   * the caller leaves them out (default true), so the model's file edits and\n   * commands run here, on this machine. A server should provide every\n   * capability explicitly and pass false, so an omission fails with\n   * `requirements_unmet` instead of giving the model a shell in the server.\n   */\n  localCompute?: boolean;\n  /**\n   * The agents API origin (default `https://agent-session.final.ai`; its API is\n   * under `/api` and ACP at `/acp/ws`), or a base URL the API routes are mounted under.\n   */\n  host?: string;\n  /** Extra headers per request; console clients send their client identity header here. */\n  headers?: HeadersOption;\n  /** API requests (the host's routes); carries auth and caller headers. */\n  fetch?: FetchIface;\n  /**\n   * Presigned storage requests (attachment uploads). Gets only the headers the\n   * presign requires, never auth, client identity or cookies, so a storage\n   * bucket's CORS and third-party hosts see nothing of the caller. Defaults to\n   * `globalThis.fetch`; keep it free of header-injecting wrappers.\n   */\n  storageFetch?: FetchIface;\n  /** console-web and console-mobile pass their realtime clients; defaults to a gateway connection. */\n  realtime?: RealtimeTransportIface;\n  /** Seam for the default transport's gateway connection. */\n  gatewayConnect?: GatewayConnect;\n  /** Seam for stream retry timing (tests). */\n  timing?: Partial<StreamTimingIface>;\n  /** Seam for idempotency keys and client message ids; defaults to `crypto.randomUUID`. */\n  newKey?: () => string;\n  /** Seam for the client clock (conversation recovery windows). */\n  now?: () => number;\n  /** Seam: how agent values become documents and in-process code. */\n  agentCodec?: AgentValueCodecIface;\n  /** Seam: how a channel value becomes its source. */\n  channelSourceOf?: ChannelSourceOf;\n  /** Seams for local hosts: the socket, and the sandbox this process serves. */\n  localHosts?: {\n    /** Opens the local host socket; abandons it when `signal` aborts. */\n    dial?: (path: string, signal?: AbortSignal) => Promise<LocalHostSocketIface>;\n    compute?: Partial<LocalComputeIface>;\n  };\n}\n\nexport interface AgentsApiIface {\n  /**\n   * The agents the caller can use; with `projectId`, those usable there (its own and those\n   * inherited from its ancestors). Without it, everything the caller can access (an API key: its\n   * parent project and every project it is granted; a person: every project they can read).\n   * Fetch one as data with `client.project({ id }).agents.get`.\n   */\n  list: (\n    options?: SignalOptionsIface & { cursor?: string; limit?: number; projectId?: string },\n  ) => Promise<AgentListIface>;\n}\n\nexport interface PeopleApiIface {\n  /** One page of the caller's organization members, by name; pass `nextCursor` as `cursor` for the next. */\n  list: (\n    options?: SignalOptionsIface & { cursor?: string; limit?: number },\n  ) => Promise<PersonListIface>;\n  /** Every member of the caller's organization (all pages). */\n  all: (options?: SignalOptionsIface) => Promise<PersonIface[]>;\n}\n\nexport interface RealtimeApiIface {\n  /**\n   * Mints a gateway session (`POST /v1/realtime/session`) for the signed-in user:\n   * the gateway URL, a short-lived token, and the user id realtime topics are keyed by.\n   * Pass it as `createSession` to `createGatewayRealtimeTransport` when supplying a transport.\n   */\n  createSession: (options?: SignalOptionsIface) => Promise<RealtimeSessionResponseIface>;\n}\n\nexport interface InferenceApiIface {\n  /**\n   * The vendors and models the platform's own metered inference serves, with\n   * prices (`GET /v1/inference/offering`, public). A harness using the\n   * platform's inference can run only models listed here.\n   */\n  offering: (options?: SignalOptionsIface) => Promise<InferenceOfferingIface>;\n}\n\nexport interface PlatformIdentityApiIface {\n  /**\n   * Exchanges a sandbox-provider (or downstream) assertion the platform issued\n   * for a fresh one: for the provider's own URL (a refresh) or a backend its\n   * registration was granted. The subject token is the credential.\n   */\n  exchange: (\n    args: PlatformIdentityExchangeRequestIface & SignalOptionsIface,\n  ) => Promise<PlatformIdentityExchangeResponseIface>;\n}\n\nexport interface DecisionsApiIface {\n  /** One decision awaiting the caller's answer, as `conversations.decisions` lists it. */\n  get: (args: { id: string } & SignalOptionsIface) => Promise<DecisionIface>;\n}\n\nexport interface AppApiIface {\n  /**\n   * The calling app's event subscriptions, across every organization that\n   * installed it. Needs an app-level token.\n   */\n  eventSubscriptions: EventSubscriptionsApiIface;\n}\n\nexport interface AgentClientIface {\n  /** One project: where sessions, conversations, sandboxes and integrations are created. */\n  project: (args: { id: string }) => ProjectClientIface;\n  /** The project tree: list projects and create them. */\n  projects: ProjectsApiIface;\n  /** The event feed across everything the caller can see; `project({ id }).events` narrows it. */\n  events: EventsApiIface;\n  app: AppApiIface;\n  /** Publishers' public agents, channels, harnesses and ACP adapters. */\n  publishers: PublishersApiIface;\n  inference: InferenceApiIface;\n  platformIdentity: PlatformIdentityApiIface;\n  decisions: DecisionsApiIface;\n  health: (options?: SignalOptionsIface) => Promise<HealthResponseIface>;\n  agents: AgentsApiIface;\n  people: PeopleApiIface;\n  realtime: RealtimeApiIface;\n  /** Existing sessions by id; create them through `project({ id }).sessions`. */\n  sessions: SessionsApiIface;\n  /** The caller's conversations; create them through `project({ id }).conversations`. */\n  conversations: ConversationsApiIface;\n  channelBindings: ChannelBindingsApiIface;\n  schedules: SchedulesApiIface;\n  /**\n   * ACP-native access (`/acp/ws`): an ACP v2 ClientApp connection on which the\n   * agents API is the agent. The ACP SDK loads on the first `connect`.\n   */\n  acp: AcpApiIface;\n  /**\n   * Ends every stream (they reject with a `client_closed` ClientError) and every\n   * local host connection (the platform then reports this process's tools and\n   * compute as unavailable; sessions carry on) and, when the client created its\n   * own realtime transport, closes the gateway connection and cancels its\n   * retries. A transport passed in `realtime` belongs to the caller and is left\n   * open. Idempotent.\n   */\n  close: () => void;\n  [Symbol.asyncDispose]: () => Promise<void>;\n}\n\nexport const createClient = (options: CreateClientOptionsIface): AgentClientIface => {\n  const http = createHttp({\n    host: options.host ?? DEFAULT_AGENTS_HOST,\n    auth: options.auth,\n    headers: options.headers,\n    fetch: options.fetch,\n  });\n  let realtime = options.realtime ?? null;\n  let ownTransport: GatewayRealtimeTransportIface | null = null;\n  const closing = new AbortController();\n  const createRealtimeSession: RealtimeApiIface['createSession'] = (sessionOptions) =>\n    http.request({\n      method: HttpMethod.Post,\n      path: '/v1/realtime/session',\n      response: realtimeSessionResponseSchema,\n      signal: sessionOptions?.signal,\n    });\n  let realtimeOwner: Promise<RealtimeSessionResponseIface> | null = null;\n  const realtimeOwnerSession = () => {\n    if (realtimeOwner != null) return realtimeOwner;\n    const pending = createRealtimeSession({ signal: closing.signal });\n    realtimeOwner = pending;\n    void pending.catch(() => {\n      if (realtimeOwner === pending) realtimeOwner = null;\n    });\n    return pending;\n  };\n  let realtimeUser: Promise<string> | null = null;\n  // Shared by every stream, so it is cancelled only with the client, never by one caller.\n  const realtimeUserId: ClientContextIface['realtimeUserId'] = () => {\n    if (realtimeUser != null) return realtimeUser;\n    const pending = realtimeOwnerSession().then((session) => {\n      if (session.userId == null)\n        throw new Error('This client authenticates as an API-key owner, not a user');\n      return session.userId;\n    });\n    realtimeUser = pending;\n    // A failed (or aborted) read is not cached.\n    pending.catch(() => {\n      if (realtimeUser === pending) realtimeUser = null;\n    });\n    return pending;\n  };\n  const context: ClientContextIface = {\n    http,\n    closeSignal: closing.signal,\n    realtimeUserId,\n    // Conversations is the only collection.\n    realtimeCollectionTopic: async () => {\n      const owner = await realtimeOwnerSession();\n      // API keys act in their project, not as members: they reach agents through channels.\n      if (owner.userId == null)\n        throw new Error('Collection streams belong to users; API-key owners use session streams');\n      return agentRealtimeTopics.userConversations(owner.userId);\n    },\n    storageFetch: options.storageFetch ?? ((input, init) => globalThis.fetch(input, init)),\n    realtime: () => {\n      if (realtime != null) return realtime;\n      ownTransport = createGatewayRealtimeTransport({\n        createSession: () => createRealtimeSession(),\n        connect: options.gatewayConnect,\n      });\n      if (closing.signal.aborted) ownTransport.close();\n      realtime = ownTransport;\n      return realtime;\n    },\n    timing: { ...defaultStreamTiming, ...options.timing },\n    newKey: options.newKey ?? (() => globalThis.crypto.randomUUID()),\n    now: options.now ?? Date.now,\n  };\n\n  const hosts = new Set<LocalHostIface>();\n  const localCompute = defaultLocalCompute();\n  const start: AgentStartDepsIface = {\n    context,\n    codec: options.agentCodec ?? defaultAgentCodec,\n    localCompute: options.localCompute ?? true,\n    compute: { ...localCompute, ...options.localHosts?.compute },\n    dial: options.localHosts?.dial ?? defaultLocalHostDial(http),\n    hosts,\n  };\n  const channelSourceOf = options.channelSourceOf ?? defaultChannelSourceOf;\n  const clientLevel = { deps: start, projectId: null };\n\n  const close = (): void => {\n    if (closing.signal.aborted) return;\n    closing.abort(\n      clientError({ message: 'Agent client closed', status: 0, code: ClientErrorCode.Closed }),\n    );\n    for (const host of hosts) host.close();\n    hosts.clear();\n    ownTransport?.close();\n  };\n\n  return {\n    close,\n    [Symbol.asyncDispose]: async () => close(),\n    health: (healthOptions) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: '/v1/health',\n        response: healthResponseSchema,\n        signal: healthOptions?.signal,\n      }),\n    agents: {\n      list: (listOptions) =>\n        http.request({\n          method: HttpMethod.Get,\n          path: '/v1/agents',\n          query: {\n            cursor: listOptions?.cursor,\n            limit: listOptions?.limit,\n            projectId: listOptions?.projectId,\n          },\n          response: agentListSchema,\n          signal: listOptions?.signal,\n        }),\n    },\n    people: (() => {\n      const list: PeopleApiIface['list'] = (listOptions) =>\n        http.request({\n          method: HttpMethod.Get,\n          path: '/v1/people',\n          query: { cursor: listOptions?.cursor, limit: listOptions?.limit },\n          response: personListSchema,\n          signal: listOptions?.signal,\n        });\n      return {\n        list,\n        all: async (allOptions) => {\n          const all: PersonIface[] = [];\n          let cursor: string | undefined;\n          for (;;) {\n            const next = await list({ cursor, signal: allOptions?.signal });\n            all.push(...next.people);\n            if (next.nextCursor == null) return all;\n            cursor = next.nextCursor;\n          }\n        },\n      };\n    })(),\n    realtime: { createSession: createRealtimeSession },\n    project: ({ id }) => createProjectClient({ context, start, channelSourceOf, projectId: id }),\n    projects: createProjectsApi(context),\n    events: createEventsApi({ context, projectId: null }),\n    app: {\n      eventSubscriptions: createEventSubscriptionsApi({\n        context,\n        basePath: '/v1/apps/me/event-subscriptions',\n      }),\n    },\n    publishers: createPublishersApi(context),\n    inference: {\n      offering: (offeringOptions) =>\n        http.request({\n          method: HttpMethod.Get,\n          path: '/v1/inference/offering',\n          response: inferenceOfferingSchema,\n          signal: offeringOptions?.signal,\n        }),\n    },\n    platformIdentity: {\n      exchange: ({ signal, ...value }) =>\n        http.request({\n          method: HttpMethod.Post,\n          path: '/v1/platform-identity/exchange',\n          body: { schema: platformIdentityExchangeRequestSchema, value },\n          response: platformIdentityExchangeResponseSchema,\n          signal,\n        }),\n    },\n    decisions: {\n      get: async ({ id, signal }) =>\n        (\n          await http.request({\n            method: HttpMethod.Get,\n            path: `/v1/decisions/${encodePath(id)}`,\n            response: decisionResponseSchema,\n            signal,\n            context: { decisionId: id },\n          })\n        ).decision,\n    },\n    sessions: createSessionsApi(context),\n    conversations: createConversationsApi(context, clientLevel),\n    channelBindings: createChannelBindingsApi(context),\n    schedules: createSchedulesApi(context),\n    acp: createAcpApi({ http }),\n  };\n};\n"],
+  "mappings": "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",
   "names": []
 }

package/dist/modules/agent-client/config-options.mjs

@@ -10,7 +10,6 @@ const groupSchema = z.looseObject({ options: z.array(choiceSchema) });
 const selectSchema = z.looseObject({
   type: z.string().optional(),
   configId: z.string().optional(),
-  id: z.string().optional(),
   name: z.string().optional(),
   category: z.string().nullish(),
   currentValue: z.string(),
@@ -20,7 +19,7 @@ const configSelectsOf = (configOptions) => configOptions.flatMap((option) => {
   const parsed = selectSchema.safeParse(option);
   if (!parsed.success) return [];
   const select = parsed.data;
-  const configId = select.configId ?? select.id;
+  const configId = select.configId;
   if (configId == null || select.type != null && select.type !== "select") return [];
   const choices = select.options.flatMap((entry) => {
     const single = choiceSchema.safeParse(entry);

package/dist/modules/agent-client/config-options.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/agent-client/config-options.ts"],
-  "sourcesContent": ["import type { AgentSessionIface } from '@finalai/agent-protocol/agent-platform';\nimport * as z from 'zod';\n\n// ACP session config options as a session's harness advertises them\n// (`AgentSessionIface.configOptions`), read as pickers: what the model picker\n// and the reasoning picker render, and what `setConfigOption` takes.\n\nexport type SessionConfigOptionIface = AgentSessionIface['configOptions'][number];\n\n/** ACP's semantic categories (UX only); harnesses may add their own. */\nexport enum ConfigOptionCategory {\n  Mode = 'mode',\n  Model = 'model',\n  ThoughtLevel = 'thought_level',\n}\n\nexport interface ConfigSelectChoiceIface {\n  value: string;\n  name: string;\n}\n\n/** A single-value selector: `setConfigOption({ configId, value })` with one of `choices`. */\nexport interface ConfigSelectIface {\n  configId: string;\n  name: string;\n  category: string | null;\n  currentValue: string;\n  choices: ConfigSelectChoiceIface[];\n}\n\nconst choiceSchema = z.looseObject({ value: z.string(), name: z.string().optional() });\nconst groupSchema = z.looseObject({ options: z.array(choiceSchema) });\nconst selectSchema = z.looseObject({\n  type: z.string().optional(),\n  configId: z.string().optional(),\n  id: z.string().optional(),\n  name: z.string().optional(),\n  category: z.string().nullish(),\n  currentValue: z.string(),\n  options: z.array(z.union([choiceSchema, groupSchema])),\n});\n\n/** The select options among a session's config options (booleans and unknown types skipped). */\nexport const configSelectsOf = (\n  configOptions: readonly SessionConfigOptionIface[],\n): ConfigSelectIface[] =>\n  configOptions.flatMap((option) => {\n    const parsed = selectSchema.safeParse(option);\n    if (!parsed.success) return [];\n    const select = parsed.data;\n    const configId = select.configId ?? select.id;\n    if (configId == null || (select.type != null && select.type !== 'select')) return [];\n    const choices = select.options.flatMap((entry) => {\n      const single = choiceSchema.safeParse(entry);\n      if (single.success) return [single.data];\n      return groupSchema.safeParse(entry).data?.options ?? [];\n    });\n    return [\n      {\n        configId,\n        name: select.name ?? configId,\n        category: select.category ?? null,\n        currentValue: select.currentValue,\n        choices: choices.map((choice) => ({\n          value: choice.value,\n          name: choice.name ?? choice.value,\n        })),\n      },\n    ];\n  });\n\n/** The first select of a category (`model`, `thought_level`), if the harness advertises one. */\nexport const configSelectFor = (\n  configOptions: readonly SessionConfigOptionIface[],\n  category: ConfigOptionCategory | string,\n): ConfigSelectIface | null =>\n  configSelectsOf(configOptions).find((select) => select.category === category) ?? null;\n"],
-  "mappings": "AACA,YAAY,OAAO;AASZ,IAAK,uBAAL,kBAAKA,0BAAL;AACL,EAAAA,sBAAA,UAAO;AACP,EAAAA,sBAAA,WAAQ;AACR,EAAAA,sBAAA,kBAAe;AAHL,SAAAA;AAAA,GAAA;AAoBZ,MAAM,eAAe,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACrF,MAAM,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,EAAE,CAAC;AACpE,MAAM,eAAe,EAAE,YAAY;AAAA,EACjC,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,UAAU,EAAE,OAAO,EAAE,SAAS;AAAA,EAC9B,IAAI,EAAE,OAAO,EAAE,SAAS;AAAA,EACxB,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,UAAU,EAAE,OAAO,EAAE,QAAQ;AAAA,EAC7B,cAAc,EAAE,OAAO;AAAA,EACvB,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,cAAc,WAAW,CAAC,CAAC;AACvD,CAAC;AAGM,MAAM,kBAAkB,CAC7B,kBAEA,cAAc,QAAQ,CAAC,WAAW;AAChC,QAAM,SAAS,aAAa,UAAU,MAAM;AAC5C,MAAI,CAAC,OAAO,QAAS,QAAO,CAAC;AAC7B,QAAM,SAAS,OAAO;AACtB,QAAM,WAAW,OAAO,YAAY,OAAO;AAC3C,MAAI,YAAY,QAAS,OAAO,QAAQ,QAAQ,OAAO,SAAS,SAAW,QAAO,CAAC;AACnF,QAAM,UAAU,OAAO,QAAQ,QAAQ,CAAC,UAAU;AAChD,UAAM,SAAS,aAAa,UAAU,KAAK;AAC3C,QAAI,OAAO,QAAS,QAAO,CAAC,OAAO,IAAI;AACvC,WAAO,YAAY,UAAU,KAAK,EAAE,MAAM,WAAW,CAAC;AAAA,EACxD,CAAC;AACD,SAAO;AAAA,IACL;AAAA,MACE;AAAA,MACA,MAAM,OAAO,QAAQ;AAAA,MACrB,UAAU,OAAO,YAAY;AAAA,MAC7B,cAAc,OAAO;AAAA,MACrB,SAAS,QAAQ,IAAI,CAAC,YAAY;AAAA,QAChC,OAAO,OAAO;AAAA,QACd,MAAM,OAAO,QAAQ,OAAO;AAAA,MAC9B,EAAE;AAAA,IACJ;AAAA,EACF;AACF,CAAC;AAGI,MAAM,kBAAkB,CAC7B,eACA,aAEA,gBAAgB,aAAa,EAAE,KAAK,CAAC,WAAW,OAAO,aAAa,QAAQ,KAAK;",
+  "sourcesContent": ["import type { AgentSessionIface } from '@finalai/agent-protocol/agent-platform';\nimport * as z from 'zod';\n\n// ACP session config options as a session's harness advertises them\n// (`AgentSessionIface.configOptions`), read as pickers: what the model picker\n// and the reasoning picker render, and what `setConfigOption` takes.\n\nexport type SessionConfigOptionIface = AgentSessionIface['configOptions'][number];\n\n/** ACP's semantic categories (UX only); harnesses may add their own. */\nexport enum ConfigOptionCategory {\n  Mode = 'mode',\n  Model = 'model',\n  ThoughtLevel = 'thought_level',\n}\n\nexport interface ConfigSelectChoiceIface {\n  value: string;\n  name: string;\n}\n\n/** A single-value selector: `setConfigOption({ configId, value })` with one of `choices`. */\nexport interface ConfigSelectIface {\n  configId: string;\n  name: string;\n  category: string | null;\n  currentValue: string;\n  choices: ConfigSelectChoiceIface[];\n}\n\nconst choiceSchema = z.looseObject({ value: z.string(), name: z.string().optional() });\nconst groupSchema = z.looseObject({ options: z.array(choiceSchema) });\nconst selectSchema = z.looseObject({\n  type: z.string().optional(),\n  configId: z.string().optional(),\n  name: z.string().optional(),\n  category: z.string().nullish(),\n  currentValue: z.string(),\n  options: z.array(z.union([choiceSchema, groupSchema])),\n});\n\n/** The select options among a session's config options (booleans and unknown types skipped). */\nexport const configSelectsOf = (\n  configOptions: readonly SessionConfigOptionIface[],\n): ConfigSelectIface[] =>\n  configOptions.flatMap((option) => {\n    const parsed = selectSchema.safeParse(option);\n    if (!parsed.success) return [];\n    const select = parsed.data;\n    const configId = select.configId;\n    if (configId == null || (select.type != null && select.type !== 'select')) return [];\n    const choices = select.options.flatMap((entry) => {\n      const single = choiceSchema.safeParse(entry);\n      if (single.success) return [single.data];\n      return groupSchema.safeParse(entry).data?.options ?? [];\n    });\n    return [\n      {\n        configId,\n        name: select.name ?? configId,\n        category: select.category ?? null,\n        currentValue: select.currentValue,\n        choices: choices.map((choice) => ({\n          value: choice.value,\n          name: choice.name ?? choice.value,\n        })),\n      },\n    ];\n  });\n\n/** The first select of a category (`model`, `thought_level`), if the harness advertises one. */\nexport const configSelectFor = (\n  configOptions: readonly SessionConfigOptionIface[],\n  category: ConfigOptionCategory | string,\n): ConfigSelectIface | null =>\n  configSelectsOf(configOptions).find((select) => select.category === category) ?? null;\n"],
+  "mappings": "AACA,YAAY,OAAO;AASZ,IAAK,uBAAL,kBAAKA,0BAAL;AACL,EAAAA,sBAAA,UAAO;AACP,EAAAA,sBAAA,WAAQ;AACR,EAAAA,sBAAA,kBAAe;AAHL,SAAAA;AAAA,GAAA;AAoBZ,MAAM,eAAe,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;AACrF,MAAM,cAAc,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,YAAY,EAAE,CAAC;AACpE,MAAM,eAAe,EAAE,YAAY;AAAA,EACjC,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,UAAU,EAAE,OAAO,EAAE,SAAS;AAAA,EAC9B,MAAM,EAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,UAAU,EAAE,OAAO,EAAE,QAAQ;AAAA,EAC7B,cAAc,EAAE,OAAO;AAAA,EACvB,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,cAAc,WAAW,CAAC,CAAC;AACvD,CAAC;AAGM,MAAM,kBAAkB,CAC7B,kBAEA,cAAc,QAAQ,CAAC,WAAW;AAChC,QAAM,SAAS,aAAa,UAAU,MAAM;AAC5C,MAAI,CAAC,OAAO,QAAS,QAAO,CAAC;AAC7B,QAAM,SAAS,OAAO;AACtB,QAAM,WAAW,OAAO;AACxB,MAAI,YAAY,QAAS,OAAO,QAAQ,QAAQ,OAAO,SAAS,SAAW,QAAO,CAAC;AACnF,QAAM,UAAU,OAAO,QAAQ,QAAQ,CAAC,UAAU;AAChD,UAAM,SAAS,aAAa,UAAU,KAAK;AAC3C,QAAI,OAAO,QAAS,QAAO,CAAC,OAAO,IAAI;AACvC,WAAO,YAAY,UAAU,KAAK,EAAE,MAAM,WAAW,CAAC;AAAA,EACxD,CAAC;AACD,SAAO;AAAA,IACL;AAAA,MACE;AAAA,MACA,MAAM,OAAO,QAAQ;AAAA,MACrB,UAAU,OAAO,YAAY;AAAA,MAC7B,cAAc,OAAO;AAAA,MACrB,SAAS,QAAQ,IAAI,CAAC,YAAY;AAAA,QAChC,OAAO,OAAO;AAAA,QACd,MAAM,OAAO,QAAQ,OAAO;AAAA,MAC9B,EAAE;AAAA,IACJ;AAAA,EACF;AACF,CAAC;AAGI,MAAM,kBAAkB,CAC7B,eACA,aAEA,gBAAgB,aAAa,EAAE,KAAK,CAAC,WAAW,OAAO,aAAa,QAAQ,KAAK;",
   "names": ["ConfigOptionCategory"]
 }

package/dist/modules/agent-client/conversation-resources.d.mts

@@ -0,0 +1,85 @@
+import { type ApiDecisionIface, type ConversationContextEntryIface, type ConversationContextRole, type ConversationReadGrantIface, type CreateConversationReadGrantRequestIface, type CreateResourceSubscriptionRequestIface, type InputReceiptIface, type PostConversationInputRequestIface, type RaiseConversationDecisionRequestIface, type ResourceSubscriptionIface } from '@finalai/agent-protocol/agent-platform';
+import { type ClientContextIface, type EnumInput, type SignalOptionsIface } from "./context.mjs";
+export interface ConversationLabelsApiIface {
+    /**
+     * Sets labels in the caller's namespace (`PATCH …/labels`); `null` removes a
+     * key and keys not named are kept. Needs `labels:write`. Returns every label
+     * the conversation now carries for the caller; `info()` carries them too.
+     */
+    set: (labels: Record<string, string | null>, options?: SignalOptionsIface) => Promise<Record<string, string>>;
+}
+export interface ConversationContextEntryInputIface {
+    role: EnumInput<ConversationContextRole>;
+    /** Delivered verbatim; the platform adds no headers. */
+    text: string;
+    /** The one agent participant it is for; omitted or null for every agent in the conversation. */
+    participantId?: string | null;
+}
+export interface ConversationContextApiIface {
+    /**
+     * Creates or replaces the caller's entry `key` (`PUT …/context/:key`). The
+     * agent gets the text at its next turn boundary, and again whenever it
+     * changes or the agent's context was compacted or restored.
+     */
+    set: (key: string, entry: ConversationContextEntryInputIface, options?: SignalOptionsIface) => Promise<ConversationContextEntryIface>;
+    /** Stops delivering an entry; the agent is told nothing (write replacement text to tell it). */
+    delete: (key: string, options?: SignalOptionsIface & {
+        participantId?: string;
+    }) => Promise<void>;
+    /** The caller's entries. */
+    list: (options?: SignalOptionsIface) => Promise<ConversationContextEntryIface[]>;
+}
+export interface ConversationReadGrantsApiIface {
+    /** Lets this conversation's agents read one message of another conversation (`POST …/read-grants`). */
+    create: (args: CreateConversationReadGrantRequestIface & SignalOptionsIface) => Promise<ConversationReadGrantIface>;
+    list: (options?: SignalOptionsIface) => Promise<ConversationReadGrantIface[]>;
+    revoke: (args: {
+        grantId: string;
+    } & SignalOptionsIface) => Promise<ConversationReadGrantIface>;
+}
+export type SendInputArgsIface = Omit<PostConversationInputRequestIface, 'idempotencyKey'> & {
+    /** Redelivering the same key from the same caller and `from.id` returns the first receipt; defaults to a new key. */
+    idempotencyKey?: string;
+} & SignalOptionsIface;
+export interface ConversationInputsApiIface {
+    /**
+     * Hands the conversation's agent something to act on that is not a message
+     * from a member (`POST …/inputs`). The reply arrives later as the agent's
+     * message, captioned with `label` (or "From <from.name>").
+     */
+    send: (args: SendInputArgsIface) => Promise<InputReceiptIface>;
+}
+export interface ConversationDecisionsApiIface {
+    /**
+     * Asks the audience a question card (`POST …/decisions`). The caller owns
+     * the decision; raising the same `requestKey` again returns it. Its
+     * resolution arrives as a `decision.resolved` event carrying `requestKey`.
+     */
+    raise: (args: RaiseConversationDecisionRequestIface & SignalOptionsIface) => Promise<ApiDecisionIface>;
+    /** A decision the caller raised (404 for anyone else's). */
+    get: (args: {
+        decisionId: string;
+    } & SignalOptionsIface) => Promise<ApiDecisionIface>;
+    cancel: (args: {
+        decisionId: string;
+    } & SignalOptionsIface) => Promise<ApiDecisionIface>;
+}
+export interface ResourceSubscriptionsApiIface {
+    /** The outside resources the caller's person follows from this conversation. */
+    list: (options?: SignalOptionsIface) => Promise<ResourceSubscriptionIface[]>;
+    /** Follows a resource; fails with `no_linked_channel` unless a linked channel handles it. */
+    create: (args: CreateResourceSubscriptionRequestIface & SignalOptionsIface) => Promise<ResourceSubscriptionIface>;
+    /** Stops following; resolves whether a follow ended. */
+    delete: (args: {
+        resourceKey: string;
+    } & SignalOptionsIface) => Promise<boolean>;
+}
+export interface ConversationResourcesIface {
+    labels: ConversationLabelsApiIface;
+    context: ConversationContextApiIface;
+    readGrants: ConversationReadGrantsApiIface;
+    inputs: ConversationInputsApiIface;
+    decisions: ConversationDecisionsApiIface;
+    resourceSubscriptions: ResourceSubscriptionsApiIface;
+}
+export declare const createConversationResources: (context: ClientContextIface, conversationId: string) => ConversationResourcesIface;