@finalai/agents 0.6.3 → 0.9.0

package/HOSTING.md

@@ -240,7 +240,7 @@ before running. Shared manifest resolution rejects null results for required slo
 even if a host catches a resolver exception and returns null. Hosts must propagate
 that failure to startup. Session-started values stay pinned across turns and resume.
 
-This PR adds no configuration UI. A host can use the compiled requirements to show
+Hosts can use the compiled requirements to show
 which names need configuration and return an actionable deployment-specific error.
 
 ## Host integration
@@ -269,6 +269,6 @@ Optional readers preserve source compatibility with existing hosts. Definitions
 requesting bindings fail clearly if hosting does not provide them. Installing these
 packages alone does not change Final's deployed service wiring or provision secrets.
 
-New compiles emit manifest version 3, so older hosts reject them rather than
-stripping required-binding metadata. Updated readers still accept persisted
-version 2 revisions. Upgrade hosting before publishing newly compiled agents.
+New compiles emit manifest version 4. Hosts and stored revisions must use v4;
+recompile older definitions before loading them. Upgrade hosting before
+publishing newly compiled agents.

package/README.md

@@ -35,3 +35,5 @@ connection resolved by hosting at session start. `defineFinalConnection()` uses
 the same path with the `final` binding. Explicit URL declarations remain static.
 See the repository's [hosting guide](HOSTING.md) for provider contexts,
 resource lookup, and the required hosting integration.
+
+Local provider webhook previews can use `AGENT_LOCAL_APP_INFO_JSON`, a JSON object keyed by the declared application name, for example `slack`. Each value contains `clientId`, `clientSecret`, and optional `signingSecret`. Only that channel's declared application's metadata is supplied, and access tokens are never included. Member, chat, and media operations still require a real host.

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/agent-client/acp.ts"],
-  "sourcesContent": ["import type {\n  AnyWireMessage,\n  ClientApp,\n  ClientConnection,\n} from '@agentclientprotocol/sdk/experimental/v2';\nimport type { WebSocketConstructor } from '@agentclientprotocol/sdk/experimental/ws-client';\nimport {\n  ACP_TICKET_SUBPROTOCOL_PREFIX,\n  ACP_WS_SUBPROTOCOL,\n  acpTicketRequestSchema,\n  acpTicketSchema,\n} from '@finalai/agent-protocol/agent-platform';\nimport type { SignalOptionsIface } from \"./context.mjs\";\nimport { createHttp, HttpMethod, type CreateHttpOptionsIface, type HttpIface } from \"./http.mjs\";\n\n// ACP-native access: the session service serves a standard ACP v2 agent at\n// `/acp/ws`. Callers bring a ClientApp with their handlers (session updates,\n// permission requests); `?agent=` is the agent a plain `session/new` opens,\n// and `_meta[\"final.ai\"].agent` names one per session.\n\n/** How the WebSocket upgrade authenticates. */\nexport enum AcpAuthMode {\n  /** The client's authorization header (Node and other runtimes that can set headers). */\n  Headers = 'headers',\n  /**\n   * A single-use ticket minted over HTTP (`POST /v1/acp/tickets`) and offered\n   * as a subprotocol: for browsers, whose WebSocket cannot send headers.\n   */\n  Ticket = 'ticket',\n}\n\nexport interface AcpConnectArgsIface extends SignalOptionsIface {\n  /** Agent slug or id; may instead be given in `session/new` `_meta`. */\n  agent?: string;\n  /** The ClientApp to connect; defaults to an app with no handlers. */\n  app?: ClientApp;\n  /** WebSocket constructor for Node (for example `ws.WebSocket`); browsers use the global. */\n  WebSocket?: WebSocketConstructor;\n  /** Defaults to `Ticket` for cookie-authenticated (browser) clients, `Headers` otherwise. */\n  authMode?: AcpAuthMode;\n}\n\nexport interface AcpApiIface {\n  connect: (args?: AcpConnectArgsIface) => Promise<ClientConnection>;\n}\n\nexport const acpWebSocketUrl = (args: { host: URL; agent?: string; endpoint?: string }): string => {\n  // ACP is served at the session service's origin, not under the API prefix (a\n  // ticket names it, which matters behind console-server's HTTP-only proxy).\n  const url = args.endpoint == null ? new URL('/acp/ws', args.host) : new URL(args.endpoint);\n  url.protocol = url.protocol === 'http:' || url.protocol === 'ws:' ? 'ws:' : 'wss:';\n  if (args.agent != null) url.searchParams.set('agent', args.agent);\n  return url.toString();\n};\n\nexport interface AcpTransportIface {\n  url: string;\n  headers: Record<string, string>;\n  protocols: string[] | undefined;\n}\n\n/** Where and how `connect` opens the socket; exported for tests. */\nexport const resolveAcpTransport = async (\n  http: HttpIface,\n  args: AcpConnectArgsIface | undefined,\n): Promise<AcpTransportIface> => {\n  const mode = args?.authMode ?? (http.usesCookies ? AcpAuthMode.Ticket : AcpAuthMode.Headers);\n  if (mode === AcpAuthMode.Headers) {\n    return {\n      url: acpWebSocketUrl({ host: http.url(''), agent: args?.agent }),\n      headers: await http.headers(),\n      protocols: undefined,\n    };\n  }\n  const ticket = await http.request({\n    method: HttpMethod.Post,\n    path: '/v1/acp/tickets',\n    body: { schema: acpTicketRequestSchema, value: { agent: args?.agent } },\n    response: acpTicketSchema,\n    signal: args?.signal,\n  });\n  return {\n    url: acpWebSocketUrl({\n      host: http.url(''),\n      agent: args?.agent,\n      endpoint: ticket.url ?? undefined,\n    }),\n    headers: {},\n    protocols: [ACP_WS_SUBPROTOCOL, `${ACP_TICKET_SUBPROTOCOL_PREFIX}${ticket.ticket}`],\n  };\n};\n\nexport const createAcpApi = (context: { http: HttpIface }): AcpApiIface => ({\n  connect: async (args) => {\n    // The ACP SDK loads on first use: bundlers that split code keep it out of\n    // HTTP-only pages.\n    const [{ client }, { createWebSocketStream }] = await Promise.all([\n      import('@agentclientprotocol/sdk/experimental/v2'),\n      import('@agentclientprotocol/sdk/experimental/ws-client'),\n    ]);\n    const transport = await resolveAcpTransport(context.http, args);\n    const stream = createWebSocketStream<AnyWireMessage>(transport.url, {\n      headers: transport.headers,\n      protocols: transport.protocols,\n      // The ticket is the credential; the session service has no cookie auth.\n      cookies: 'omit',\n      WebSocket: args?.WebSocket,\n    });\n    const connection = (args?.app ?? client({ name: '@finalai/agents' })).connect(stream);\n    const signal = args?.signal;\n    if (signal != null) {\n      if (signal.aborted) connection.close(signal.reason);\n      else signal.addEventListener('abort', () => connection.close(signal.reason), { once: true });\n    }\n    return connection;\n  },\n});\n\n// `client.acp` without the rest of the client (`@finalai/agents/client/acp`).\nexport const createAcpClient = (options: CreateHttpOptionsIface): AcpApiIface =>\n  createAcpApi({ http: createHttp(options) });\n"],
-  "mappings": "AAMA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,YAAY,kBAA+D;AAQ7E,IAAK,cAAL,kBAAKA,iBAAL;AAEL,EAAAA,aAAA,aAAU;AAKV,EAAAA,aAAA,YAAS;AAPC,SAAAA;AAAA,GAAA;AAyBL,MAAM,kBAAkB,CAAC,SAAmE;AAGjG,QAAM,MAAM,KAAK,YAAY,OAAO,IAAI,IAAI,WAAW,KAAK,IAAI,IAAI,IAAI,IAAI,KAAK,QAAQ;AACzF,MAAI,WAAW,IAAI,aAAa,WAAW,IAAI,aAAa,QAAQ,QAAQ;AAC5E,MAAI,KAAK,SAAS,KAAM,KAAI,aAAa,IAAI,SAAS,KAAK,KAAK;AAChE,SAAO,IAAI,SAAS;AACtB;AASO,MAAM,sBAAsB,OACjC,MACA,SAC+B;AAC/B,QAAM,OAAO,MAAM,aAAa,KAAK,cAAc,wBAAqB;AACxE,MAAI,SAAS,yBAAqB;AAChC,WAAO;AAAA,MACL,KAAK,gBAAgB,EAAE,MAAM,KAAK,IAAI,EAAE,GAAG,OAAO,MAAM,MAAM,CAAC;AAAA,MAC/D,SAAS,MAAM,KAAK,QAAQ;AAAA,MAC5B,WAAW;AAAA,IACb;AAAA,EACF;AACA,QAAM,SAAS,MAAM,KAAK,QAAQ;AAAA,IAChC,QAAQ,WAAW;AAAA,IACnB,MAAM;AAAA,IACN,MAAM,EAAE,QAAQ,wBAAwB,OAAO,EAAE,OAAO,MAAM,MAAM,EAAE;AAAA,IACtE,UAAU;AAAA,IACV,QAAQ,MAAM;AAAA,EAChB,CAAC;AACD,SAAO;AAAA,IACL,KAAK,gBAAgB;AAAA,MACnB,MAAM,KAAK,IAAI,EAAE;AAAA,MACjB,OAAO,MAAM;AAAA,MACb,UAAU,OAAO,OAAO;AAAA,IAC1B,CAAC;AAAA,IACD,SAAS,CAAC;AAAA,IACV,WAAW,CAAC,oBAAoB,GAAG,6BAA6B,GAAG,OAAO,MAAM,EAAE;AAAA,EACpF;AACF;AAEO,MAAM,eAAe,CAAC,aAA+C;AAAA,EAC1E,SAAS,OAAO,SAAS;AAGvB,UAAM,CAAC,EAAE,OAAO,GAAG,EAAE,sBAAsB,CAAC,IAAI,MAAM,QAAQ,IAAI;AAAA,MAChE,OAAO,0CAA0C;AAAA,MACjD,OAAO,iDAAiD;AAAA,IAC1D,CAAC;AACD,UAAM,YAAY,MAAM,oBAAoB,QAAQ,MAAM,IAAI;AAC9D,UAAM,SAAS,sBAAsC,UAAU,KAAK;AAAA,MAClE,SAAS,UAAU;AAAA,MACnB,WAAW,UAAU;AAAA;AAAA,MAErB,SAAS;AAAA,MACT,WAAW,MAAM;AAAA,IACnB,CAAC;AACD,UAAM,cAAc,MAAM,OAAO,OAAO,EAAE,MAAM,kBAAkB,CAAC,GAAG,QAAQ,MAAM;AACpF,UAAM,SAAS,MAAM;AACrB,QAAI,UAAU,MAAM;AAClB,UAAI,OAAO,QAAS,YAAW,MAAM,OAAO,MAAM;AAAA,UAC7C,QAAO,iBAAiB,SAAS,MAAM,WAAW,MAAM,OAAO,MAAM,GAAG,EAAE,MAAM,KAAK,CAAC;AAAA,IAC7F;AACA,WAAO;AAAA,EACT;AACF;AAGO,MAAM,kBAAkB,CAAC,YAC9B,aAAa,EAAE,MAAM,WAAW,OAAO,EAAE,CAAC;",
+  "sourcesContent": ["import type {\n  AnyWireMessage,\n  ClientApp,\n  ClientConnection,\n} from '@agentclientprotocol/sdk/experimental/v2';\nimport type { WebSocketConstructor } from '@agentclientprotocol/sdk/experimental/ws-client';\nimport {\n  ACP_TICKET_SUBPROTOCOL_PREFIX,\n  ACP_WS_SUBPROTOCOL,\n  acpTicketRequestSchema,\n  acpTicketSchema,\n} from '@finalai/agent-protocol/agent-platform';\nimport type { SignalOptionsIface } from \"./context.mjs\";\nimport { createHttp, HttpMethod, type CreateHttpOptionsIface, type HttpIface } from \"./http.mjs\";\n\n// ACP-native access: the session service serves a standard ACP v2 agent at\n// `/acp/ws`. Callers bring a ClientApp with their handlers (session updates,\n// permission requests); `?agent=` is the agent a plain `session/new` opens,\n// and `_meta[\"final.ai\"].agent` names one per session.\n\n/** How the WebSocket upgrade authenticates. */\nexport enum AcpAuthMode {\n  /** The client's authorization header (Node and other runtimes that can set headers). */\n  Headers = 'headers',\n  /**\n   * A single-use ticket minted over HTTP (`POST /v1/acp/tickets`) and offered\n   * as a subprotocol: for browsers, whose WebSocket cannot send headers.\n   */\n  Ticket = 'ticket',\n}\n\nexport interface AcpConnectArgsIface extends SignalOptionsIface {\n  /** Agent slug or id; may instead be given in `session/new` `_meta`. */\n  agent?: string;\n  /** The ClientApp to connect; defaults to an app with no handlers. */\n  app?: ClientApp;\n  /** WebSocket constructor for Node (for example `ws.WebSocket`); browsers use the global. */\n  WebSocket?: WebSocketConstructor;\n  /** Defaults to `Ticket` for cookie-authenticated (browser) clients, `Headers` otherwise. */\n  authMode?: AcpAuthMode;\n}\n\nexport interface AcpApiIface {\n  connect: (args?: AcpConnectArgsIface) => Promise<ClientConnection>;\n}\n\nexport const acpWebSocketUrl = (args: { host: URL; agent?: string; endpoint?: string }): string => {\n  // A connection ticket can select a WebSocket endpoint outside the HTTP API prefix.\n  const url = args.endpoint == null ? new URL('/acp/ws', args.host) : new URL(args.endpoint);\n  url.protocol = url.protocol === 'http:' || url.protocol === 'ws:' ? 'ws:' : 'wss:';\n  if (args.agent != null) url.searchParams.set('agent', args.agent);\n  return url.toString();\n};\n\nexport interface AcpTransportIface {\n  url: string;\n  headers: Record<string, string>;\n  protocols: string[] | undefined;\n}\n\n/** Where and how `connect` opens the socket; exported for tests. */\nexport const resolveAcpTransport = async (\n  http: HttpIface,\n  args: AcpConnectArgsIface | undefined,\n): Promise<AcpTransportIface> => {\n  const mode = args?.authMode ?? (http.usesCookies ? AcpAuthMode.Ticket : AcpAuthMode.Headers);\n  if (mode === AcpAuthMode.Headers) {\n    return {\n      url: acpWebSocketUrl({ host: http.url(''), agent: args?.agent }),\n      headers: await http.headers(),\n      protocols: undefined,\n    };\n  }\n  const ticket = await http.request({\n    method: HttpMethod.Post,\n    path: '/v1/acp/tickets',\n    body: { schema: acpTicketRequestSchema, value: { agent: args?.agent } },\n    response: acpTicketSchema,\n    signal: args?.signal,\n  });\n  return {\n    url: acpWebSocketUrl({\n      host: http.url(''),\n      agent: args?.agent,\n      endpoint: ticket.url ?? undefined,\n    }),\n    headers: {},\n    protocols: [ACP_WS_SUBPROTOCOL, `${ACP_TICKET_SUBPROTOCOL_PREFIX}${ticket.ticket}`],\n  };\n};\n\nexport const createAcpApi = (context: { http: HttpIface }): AcpApiIface => ({\n  connect: async (args) => {\n    // The ACP SDK loads on first use: bundlers that split code keep it out of\n    // HTTP-only pages.\n    const [{ client }, { createWebSocketStream }] = await Promise.all([\n      import('@agentclientprotocol/sdk/experimental/v2'),\n      import('@agentclientprotocol/sdk/experimental/ws-client'),\n    ]);\n    const transport = await resolveAcpTransport(context.http, args);\n    const stream = createWebSocketStream<AnyWireMessage>(transport.url, {\n      headers: transport.headers,\n      protocols: transport.protocols,\n      // The ticket is the credential; the session service has no cookie auth.\n      cookies: 'omit',\n      WebSocket: args?.WebSocket,\n    });\n    const connection = (args?.app ?? client({ name: '@finalai/agents' })).connect(stream);\n    const signal = args?.signal;\n    if (signal != null) {\n      if (signal.aborted) connection.close(signal.reason);\n      else signal.addEventListener('abort', () => connection.close(signal.reason), { once: true });\n    }\n    return connection;\n  },\n});\n\n// `client.acp` without the rest of the client (`@finalai/agents/client/acp`).\nexport const createAcpClient = (options: CreateHttpOptionsIface): AcpApiIface =>\n  createAcpApi({ http: createHttp(options) });\n"],
+  "mappings": "AAMA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEP,SAAS,YAAY,kBAA+D;AAQ7E,IAAK,cAAL,kBAAKA,iBAAL;AAEL,EAAAA,aAAA,aAAU;AAKV,EAAAA,aAAA,YAAS;AAPC,SAAAA;AAAA,GAAA;AAyBL,MAAM,kBAAkB,CAAC,SAAmE;AAEjG,QAAM,MAAM,KAAK,YAAY,OAAO,IAAI,IAAI,WAAW,KAAK,IAAI,IAAI,IAAI,IAAI,KAAK,QAAQ;AACzF,MAAI,WAAW,IAAI,aAAa,WAAW,IAAI,aAAa,QAAQ,QAAQ;AAC5E,MAAI,KAAK,SAAS,KAAM,KAAI,aAAa,IAAI,SAAS,KAAK,KAAK;AAChE,SAAO,IAAI,SAAS;AACtB;AASO,MAAM,sBAAsB,OACjC,MACA,SAC+B;AAC/B,QAAM,OAAO,MAAM,aAAa,KAAK,cAAc,wBAAqB;AACxE,MAAI,SAAS,yBAAqB;AAChC,WAAO;AAAA,MACL,KAAK,gBAAgB,EAAE,MAAM,KAAK,IAAI,EAAE,GAAG,OAAO,MAAM,MAAM,CAAC;AAAA,MAC/D,SAAS,MAAM,KAAK,QAAQ;AAAA,MAC5B,WAAW;AAAA,IACb;AAAA,EACF;AACA,QAAM,SAAS,MAAM,KAAK,QAAQ;AAAA,IAChC,QAAQ,WAAW;AAAA,IACnB,MAAM;AAAA,IACN,MAAM,EAAE,QAAQ,wBAAwB,OAAO,EAAE,OAAO,MAAM,MAAM,EAAE;AAAA,IACtE,UAAU;AAAA,IACV,QAAQ,MAAM;AAAA,EAChB,CAAC;AACD,SAAO;AAAA,IACL,KAAK,gBAAgB;AAAA,MACnB,MAAM,KAAK,IAAI,EAAE;AAAA,MACjB,OAAO,MAAM;AAAA,MACb,UAAU,OAAO,OAAO;AAAA,IAC1B,CAAC;AAAA,IACD,SAAS,CAAC;AAAA,IACV,WAAW,CAAC,oBAAoB,GAAG,6BAA6B,GAAG,OAAO,MAAM,EAAE;AAAA,EACpF;AACF;AAEO,MAAM,eAAe,CAAC,aAA+C;AAAA,EAC1E,SAAS,OAAO,SAAS;AAGvB,UAAM,CAAC,EAAE,OAAO,GAAG,EAAE,sBAAsB,CAAC,IAAI,MAAM,QAAQ,IAAI;AAAA,MAChE,OAAO,0CAA0C;AAAA,MACjD,OAAO,iDAAiD;AAAA,IAC1D,CAAC;AACD,UAAM,YAAY,MAAM,oBAAoB,QAAQ,MAAM,IAAI;AAC9D,UAAM,SAAS,sBAAsC,UAAU,KAAK;AAAA,MAClE,SAAS,UAAU;AAAA,MACnB,WAAW,UAAU;AAAA;AAAA,MAErB,SAAS;AAAA,MACT,WAAW,MAAM;AAAA,IACnB,CAAC;AACD,UAAM,cAAc,MAAM,OAAO,OAAO,EAAE,MAAM,kBAAkB,CAAC,GAAG,QAAQ,MAAM;AACpF,UAAM,SAAS,MAAM;AACrB,QAAI,UAAU,MAAM;AAClB,UAAI,OAAO,QAAS,YAAW,MAAM,OAAO,MAAM;AAAA,UAC7C,QAAO,iBAAiB,SAAS,MAAM,WAAW,MAAM,OAAO,MAAM,GAAG,EAAE,MAAM,KAAK,CAAC;AAAA,IAC7F;AACA,WAAO;AAAA,EACT;AACF;AAGO,MAAM,kBAAkB,CAAC,YAC9B,aAAa,EAAE,MAAM,WAAW,OAAO,EAAE,CAAC;",
   "names": ["AcpAuthMode"]
 }

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

@@ -1,4 +1,4 @@
-import { type AttachChannelBindingResponseIface, type CommitDefinitionRequestIface, type CommitResultIface, type CompatibilityReportIface, type CompileResultIface, type ComputerSetupGuideDetailIface, type ComputerSetupGuideIface, type ComputerSetupGuideVersionIface, type CreateDefinitionRequestIface, type CredentialPolicyPreviewIface, type DefinitionChannelIface, type DefinitionCloneUrlIface, type DefinitionFilesIface, type DefinitionIface, type PreviewCredentialPolicyRequestIface, type ProviderEntryIface, type PublishComputerSetupGuideRequestIface, type PublishResultIface, type RevisionDiffIface, type RevisionIface, type ScheduleIface, type ScheduleRunResultIface, type UpdateScheduleRequestIface } from '@finalai/agent-protocol/agent-platform';
+import { type CommitDefinitionRequestIface, type CommitResultIface, type CompatibilityReportIface, type CompileResultIface, type ComputerSetupGuideDetailIface, type ComputerSetupGuideIface, type ComputerSetupGuideVersionIface, type CreateDefinitionRequestIface, type CredentialPolicyPreviewIface, type DefinitionChannelIface, type DefinitionCloneUrlIface, type DefinitionFilesIface, type DefinitionIface, type PreviewCredentialPolicyRequestIface, type ProviderEntryIface, type PublishComputerSetupGuideRequestIface, type PublishResultIface, type RevisionDiffIface, type RevisionIface, type ScheduleIface, type ScheduleRunResultIface, type UpdateScheduleRequestIface } from '@finalai/agent-protocol/agent-platform';
 import { type ClientContextIface, type SignalOptionsIface } from "./context.mjs";
 export interface DefinitionRefIface extends SignalOptionsIface {
     /** Definition id or slug. */
@@ -62,16 +62,8 @@ export interface DefinitionsApiIface {
         harness: string;
         ref?: string;
     }) => Promise<CompatibilityReportIface>;
-    /** The agent's live channel bindings, with the conversation each is attached to. */
+    /** The agent's live channel bindings and their public route URLs. */
     channels: (args: DefinitionRefIface) => Promise<DefinitionChannelIface[]>;
-    /**
-     * Attaches a channel binding to a conversation the agent and the caller take
-     * part in (its events and bound-conversation schedules post there); null detaches.
-     */
-    attachChannel: (args: DefinitionRefIface & {
-        bindingId: string;
-        conversationId: string | null;
-    }) => Promise<AttachChannelBindingResponseIface>;
     /**
      * Archives the definition: it leaves listings, its schedules and channel
      * bindings stop, and new sessions are refused. Its repository is kept.

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

@@ -1,6 +1,4 @@
 import {
-  attachChannelBindingRequestSchema,
-  attachChannelBindingResponseSchema,
   commitDefinitionRequestSchema,
   commitResultSchema,
   compatibilityReportSchema,
@@ -123,13 +121,6 @@ const createDefinitionsApi = ({ http }) => ({
     response: definitionChannelsResponseSchema,
     signal
   })).channels,
-  attachChannel: ({ definition, bindingId, conversationId, signal }) => http.request({
-    method: HttpMethod.Put,
-    path: definitionPath(definition, `/channels/${encodePath(bindingId)}/conversation`),
-    body: { schema: attachChannelBindingRequestSchema, value: { conversationId } },
-    response: attachChannelBindingResponseSchema,
-    signal
-  }),
   archive: ({ definition, signal }) => http.request({
     method: HttpMethod.Post,
     path: definitionPath(definition, "/archive"),

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/agent-client/build.ts"],
-  "sourcesContent": ["import {\n  attachChannelBindingRequestSchema,\n  attachChannelBindingResponseSchema,\n  commitDefinitionRequestSchema,\n  commitResultSchema,\n  compatibilityReportSchema,\n  compileDefinitionRequestSchema,\n  compileResultSchema,\n  computerSetupGuideDetailSchema,\n  computerSetupGuideListSchema,\n  createDefinitionRequestSchema,\n  credentialPolicyPreviewSchema,\n  definitionChannelsResponseSchema,\n  definitionCloneUrlSchema,\n  definitionFilesSchema,\n  definitionListSchema,\n  definitionSchema,\n  previewCredentialPolicyRequestSchema,\n  providerListSchema,\n  publishComputerSetupGuideRequestSchema,\n  publishComputerSetupGuideResultSchema,\n  publishDefinitionRequestSchema,\n  publishResultSchema,\n  revisionDiffSchema,\n  revisionListSchema,\n  revisionSchema,\n  scheduleListSchema,\n  scheduleRunResultSchema,\n  scheduleSchema,\n  updateScheduleRequestSchema,\n  type AttachChannelBindingResponseIface,\n  type CommitDefinitionRequestIface,\n  type CommitResultIface,\n  type CompatibilityReportIface,\n  type CompileResultIface,\n  type ComputerSetupGuideDetailIface,\n  type ComputerSetupGuideIface,\n  type ComputerSetupGuideVersionIface,\n  type CreateDefinitionRequestIface,\n  type CredentialPolicyPreviewIface,\n  type DefinitionChannelIface,\n  type DefinitionCloneUrlIface,\n  type DefinitionFilesIface,\n  type DefinitionIface,\n  type PreviewCredentialPolicyRequestIface,\n  type ProviderEntryIface,\n  type PublishComputerSetupGuideRequestIface,\n  type PublishResultIface,\n  type RevisionDiffIface,\n  type RevisionIface,\n  type ScheduleIface,\n  type ScheduleRunResultIface,\n  type UpdateScheduleRequestIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { encodePath, type ClientContextIface, type SignalOptionsIface } from \"./context.mjs\";\nimport { clientError, ClientErrorCode } from \"./errors.mjs\";\nimport { HttpMethod } from \"./http.mjs\";\n\n// Definitions, providers, setup guides, schedules, credentials and budgets:\n// what Build, settings and CI use.\n\nexport interface DefinitionRefIface extends SignalOptionsIface {\n  /** Definition id or slug. */\n  definition: string;\n}\n\nexport interface DefinitionsApiIface {\n  /** Compiles a draft into an immutable test snapshot without publishing or activating schedules/channels. */\n  testRevision: (args: DefinitionRefIface & { ref: string }) => Promise<RevisionIface>;\n  previewCredentialPolicy: (\n    args: DefinitionRefIface & PreviewCredentialPolicyRequestIface,\n  ) => Promise<CredentialPolicyPreviewIface>;\n  /**\n   * With `projectId`, its definitions and those inherited from its ancestors. Without it,\n   * everything the caller can access (an API key: its parent project and every project it is\n   * granted; a person: every project they can read).\n   */\n  list: (\n    options?: SignalOptionsIface & { cursor?: string; limit?: number; projectId?: string },\n  ) => Promise<{ definitions: DefinitionIface[]; nextCursor: string | null }>;\n  /**\n   * Creates the definition in `projectId` (editors of that project); omitted, the API key's parent\n   * project (a signed-in person's: My Work).\n   */\n  create: (args: CreateDefinitionRequestIface & SignalOptionsIface) => Promise<DefinitionIface>;\n  get: (args: DefinitionRefIface) => Promise<DefinitionIface>;\n  /** Compiles the directory at `ref` server-side without publishing. */\n  compile: (\n    args: DefinitionRefIface & { ref: string; harness?: string },\n  ) => Promise<CompileResultIface>;\n  commit: (args: DefinitionRefIface & CommitDefinitionRequestIface) => Promise<CommitResultIface>;\n  /** Compiles `ref`, stores a revision and makes it current. */\n  publish: (\n    args: DefinitionRefIface & { ref: string; note?: string },\n  ) => Promise<PublishResultIface>;\n  /** The agent directory's files at `ref` (default branch when omitted). */\n  files: (args: DefinitionRefIface & { ref?: string }) => Promise<DefinitionFilesIface>;\n  revisions: (\n    args: DefinitionRefIface & { cursor?: string },\n  ) => Promise<{ revisions: RevisionIface[]; nextCursor: string | null }>;\n  /**\n   * What changed in the compiled manifest between two revisions (revision ids\n   * or numbers); `to` defaults to the current revision.\n   */\n  revisionDiff: (\n    args: DefinitionRefIface & { from: string | number; to?: string | number },\n  ) => Promise<RevisionDiffIface>;\n  compatibility: (\n    args: DefinitionRefIface & { harness: string; ref?: string },\n  ) => Promise<CompatibilityReportIface>;\n  /** The agent's live channel bindings, with the conversation each is attached to. */\n  channels: (args: DefinitionRefIface) => Promise<DefinitionChannelIface[]>;\n  /**\n   * Attaches a channel binding to a conversation the agent and the caller take\n   * part in (its events and bound-conversation schedules post there); null detaches.\n   */\n  attachChannel: (\n    args: DefinitionRefIface & { bindingId: string; conversationId: string | null },\n  ) => Promise<AttachChannelBindingResponseIface>;\n  /**\n   * Archives the definition: it leaves listings, its schedules and channel\n   * bindings stop, and new sessions are refused. Its repository is kept.\n   */\n  archive: (args: DefinitionRefIface) => Promise<DefinitionIface>;\n  /**\n   * A short-lived, read-only git remote for a Final-hosted repository, for\n   * `git clone` (editors of the definition's project).\n   */\n  cloneUrl: (args: DefinitionRefIface) => Promise<DefinitionCloneUrlIface>;\n}\n\nexport interface ProvidersApiIface {\n  list: (options?: SignalOptionsIface) => Promise<ProviderEntryIface[]>;\n}\n\nexport interface ComputerSetupGuidesApiIface {\n  list: (options?: SignalOptionsIface) => Promise<ComputerSetupGuideIface[]>;\n  /** Guide by slug or id, with its versions. */\n  get: (ref: string, options?: SignalOptionsIface) => Promise<ComputerSetupGuideDetailIface>;\n  /** Publishes a new version (creating the guide on first publish). */\n  publish: (\n    args: PublishComputerSetupGuideRequestIface & SignalOptionsIface,\n  ) => Promise<{ guide: ComputerSetupGuideIface; version: ComputerSetupGuideVersionIface }>;\n}\n\nexport type ScheduleRef = { scheduleId: string } | { agent: string; key: string };\n\nexport interface SchedulesApiIface {\n  list: (options?: SignalOptionsIface & { agent?: string }) => Promise<ScheduleIface[]>;\n  runNow: (args: ScheduleRef & SignalOptionsIface) => Promise<ScheduleRunResultIface>;\n  update: (\n    args: { scheduleId: string } & UpdateScheduleRequestIface & SignalOptionsIface,\n  ) => Promise<ScheduleIface>;\n}\n\nconst definitionPath = (definition: string, suffix = ''): string =>\n  `/v1/definitions/${encodePath(definition)}${suffix}`;\n\nexport const createDefinitionsApi = ({ http }: ClientContextIface): DefinitionsApiIface => ({\n  testRevision: ({ definition, signal, ...value }) =>\n    http.request({\n      method: HttpMethod.Post,\n      path: definitionPath(definition, '/test-revision'),\n      body: { schema: compileDefinitionRequestSchema, value },\n      response: revisionSchema,\n      signal,\n    }),\n  previewCredentialPolicy: ({ definition, signal, ...value }) =>\n    http.request({\n      method: HttpMethod.Post,\n      path: definitionPath(definition, '/credential-policy/preview'),\n      body: { schema: previewCredentialPolicyRequestSchema, value },\n      response: credentialPolicyPreviewSchema,\n      signal,\n    }),\n  list: (options) =>\n    http.request({\n      method: HttpMethod.Get,\n      path: '/v1/definitions',\n      query: { cursor: options?.cursor, limit: options?.limit, projectId: options?.projectId },\n      response: definitionListSchema,\n      signal: options?.signal,\n    }),\n  create: ({ signal, ...value }) =>\n    http.request({\n      method: HttpMethod.Post,\n      path: '/v1/definitions',\n      body: { schema: createDefinitionRequestSchema, value },\n      response: definitionSchema,\n      signal,\n    }),\n  get: ({ definition, signal }) =>\n    http.request({\n      method: HttpMethod.Get,\n      path: definitionPath(definition),\n      response: definitionSchema,\n      signal,\n    }),\n  compile: ({ definition, signal, ...value }) =>\n    http.request({\n      method: HttpMethod.Post,\n      path: definitionPath(definition, '/compile'),\n      body: { schema: compileDefinitionRequestSchema, value },\n      response: compileResultSchema,\n      signal,\n    }),\n  commit: ({ definition, signal, ...value }) =>\n    http.request({\n      method: HttpMethod.Post,\n      path: definitionPath(definition, '/commit'),\n      body: { schema: commitDefinitionRequestSchema, value },\n      response: commitResultSchema,\n      signal,\n    }),\n  publish: ({ definition, signal, ...value }) =>\n    http.request({\n      method: HttpMethod.Post,\n      path: definitionPath(definition, '/publish'),\n      body: { schema: publishDefinitionRequestSchema, value },\n      response: publishResultSchema,\n      signal,\n    }),\n  files: ({ definition, ref, signal }) =>\n    http.request({\n      method: HttpMethod.Get,\n      path: definitionPath(definition, '/files'),\n      query: { ref },\n      response: definitionFilesSchema,\n      signal,\n    }),\n  revisions: ({ definition, cursor, signal }) =>\n    http.request({\n      method: HttpMethod.Get,\n      path: definitionPath(definition, '/revisions'),\n      query: { cursor },\n      response: revisionListSchema,\n      signal,\n    }),\n  revisionDiff: ({ definition, from, to, signal }) =>\n    http.request({\n      method: HttpMethod.Get,\n      path: definitionPath(definition, '/revisions/diff'),\n      query: { from, to },\n      response: revisionDiffSchema,\n      signal,\n    }),\n  compatibility: ({ definition, harness, ref, signal }) =>\n    http.request({\n      method: HttpMethod.Get,\n      path: definitionPath(definition, '/compatibility'),\n      query: { harness, ref },\n      response: compatibilityReportSchema,\n      signal,\n    }),\n  channels: async ({ definition, signal }) =>\n    (\n      await http.request({\n        method: HttpMethod.Get,\n        path: definitionPath(definition, '/channels'),\n        response: definitionChannelsResponseSchema,\n        signal,\n      })\n    ).channels,\n  attachChannel: ({ definition, bindingId, conversationId, signal }) =>\n    http.request({\n      method: HttpMethod.Put,\n      path: definitionPath(definition, `/channels/${encodePath(bindingId)}/conversation`),\n      body: { schema: attachChannelBindingRequestSchema, value: { conversationId } },\n      response: attachChannelBindingResponseSchema,\n      signal,\n    }),\n  archive: ({ definition, signal }) =>\n    http.request({\n      method: HttpMethod.Post,\n      path: definitionPath(definition, '/archive'),\n      response: definitionSchema,\n      signal,\n    }),\n  cloneUrl: ({ definition, signal }) =>\n    http.request({\n      method: HttpMethod.Post,\n      path: definitionPath(definition, '/clone-url'),\n      response: definitionCloneUrlSchema,\n      signal,\n    }),\n});\n\nexport const createProvidersApi = ({ http }: ClientContextIface): ProvidersApiIface => ({\n  list: async (options) =>\n    (\n      await http.request({\n        method: HttpMethod.Get,\n        path: '/v1/providers',\n        response: providerListSchema,\n        signal: options?.signal,\n      })\n    ).providers,\n});\n\nexport const createComputerSetupGuidesApi = ({\n  http,\n}: ClientContextIface): ComputerSetupGuidesApiIface => ({\n  list: async (options) =>\n    (\n      await http.request({\n        method: HttpMethod.Get,\n        path: '/v1/computer-setup-guides',\n        response: computerSetupGuideListSchema,\n        signal: options?.signal,\n      })\n    ).guides,\n  get: (ref, options) =>\n    http.request({\n      method: HttpMethod.Get,\n      path: `/v1/computer-setup-guides/${encodePath(ref)}`,\n      response: computerSetupGuideDetailSchema,\n      signal: options?.signal,\n    }),\n  publish: ({ signal, ...value }) =>\n    http.request({\n      method: HttpMethod.Post,\n      path: '/v1/computer-setup-guides',\n      body: { schema: publishComputerSetupGuideRequestSchema, value },\n      response: publishComputerSetupGuideResultSchema,\n      signal,\n    }),\n});\n\nexport const createSchedulesApi = ({ http }: ClientContextIface): SchedulesApiIface => {\n  const list: SchedulesApiIface['list'] = async (options) =>\n    (\n      await http.request({\n        method: HttpMethod.Get,\n        path: '/v1/schedules',\n        query: { agent: options?.agent },\n        response: scheduleListSchema,\n        signal: options?.signal,\n      })\n    ).schedules;\n\n  const scheduleIdOf = async (args: ScheduleRef & SignalOptionsIface): Promise<string> => {\n    if ('scheduleId' in args) return args.scheduleId;\n    const found = (await list({ agent: args.agent, signal: args.signal })).find(\n      (schedule) => schedule.key === args.key,\n    );\n    if (found == null) {\n      throw clientError({\n        message: `No schedule ${args.key} on agent ${args.agent}`,\n        status: 0,\n        code: ClientErrorCode.NotFound,\n      });\n    }\n    return found.id;\n  };\n\n  return {\n    list,\n    runNow: async (args) =>\n      http.request({\n        method: HttpMethod.Post,\n        path: `/v1/schedules/${encodePath(await scheduleIdOf(args))}/run-now`,\n        response: scheduleRunResultSchema,\n        signal: args.signal,\n      }),\n    update: ({ scheduleId, signal, ...value }) =>\n      http.request({\n        method: HttpMethod.Patch,\n        path: `/v1/schedules/${encodePath(scheduleId)}`,\n        body: { schema: updateScheduleRequestSchema, value },\n        response: scheduleSchema,\n        signal,\n      }),\n  };\n};\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {\n  commitDefinitionRequestSchema,\n  commitResultSchema,\n  compatibilityReportSchema,\n  compileDefinitionRequestSchema,\n  compileResultSchema,\n  computerSetupGuideDetailSchema,\n  computerSetupGuideListSchema,\n  createDefinitionRequestSchema,\n  credentialPolicyPreviewSchema,\n  definitionChannelsResponseSchema,\n  definitionCloneUrlSchema,\n  definitionFilesSchema,\n  definitionListSchema,\n  definitionSchema,\n  previewCredentialPolicyRequestSchema,\n  providerListSchema,\n  publishComputerSetupGuideRequestSchema,\n  publishComputerSetupGuideResultSchema,\n  publishDefinitionRequestSchema,\n  publishResultSchema,\n  revisionDiffSchema,\n  revisionListSchema,\n  revisionSchema,\n  scheduleListSchema,\n  scheduleRunResultSchema,\n  scheduleSchema,\n  updateScheduleRequestSchema,\n  type CommitDefinitionRequestIface,\n  type CommitResultIface,\n  type CompatibilityReportIface,\n  type CompileResultIface,\n  type ComputerSetupGuideDetailIface,\n  type ComputerSetupGuideIface,\n  type ComputerSetupGuideVersionIface,\n  type CreateDefinitionRequestIface,\n  type CredentialPolicyPreviewIface,\n  type DefinitionChannelIface,\n  type DefinitionCloneUrlIface,\n  type DefinitionFilesIface,\n  type DefinitionIface,\n  type PreviewCredentialPolicyRequestIface,\n  type ProviderEntryIface,\n  type PublishComputerSetupGuideRequestIface,\n  type PublishResultIface,\n  type RevisionDiffIface,\n  type RevisionIface,\n  type ScheduleIface,\n  type ScheduleRunResultIface,\n  type UpdateScheduleRequestIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { encodePath, type ClientContextIface, type SignalOptionsIface } from \"./context.mjs\";\nimport { clientError, ClientErrorCode } from \"./errors.mjs\";\nimport { HttpMethod } from \"./http.mjs\";\n\n// Definitions, providers, setup guides, schedules, credentials and budgets:\n// what Build, settings and CI use.\n\nexport interface DefinitionRefIface extends SignalOptionsIface {\n  /** Definition id or slug. */\n  definition: string;\n}\n\nexport interface DefinitionsApiIface {\n  /** Compiles a draft into an immutable test snapshot without publishing or activating schedules/channels. */\n  testRevision: (args: DefinitionRefIface & { ref: string }) => Promise<RevisionIface>;\n  previewCredentialPolicy: (\n    args: DefinitionRefIface & PreviewCredentialPolicyRequestIface,\n  ) => Promise<CredentialPolicyPreviewIface>;\n  /**\n   * With `projectId`, its definitions and those inherited from its ancestors. Without it,\n   * everything the caller can access (an API key: its parent project and every project it is\n   * granted; a person: every project they can read).\n   */\n  list: (\n    options?: SignalOptionsIface & { cursor?: string; limit?: number; projectId?: string },\n  ) => Promise<{ definitions: DefinitionIface[]; nextCursor: string | null }>;\n  /**\n   * Creates the definition in `projectId` (editors of that project); omitted, the API key's parent\n   * project (a signed-in person's: My Work).\n   */\n  create: (args: CreateDefinitionRequestIface & SignalOptionsIface) => Promise<DefinitionIface>;\n  get: (args: DefinitionRefIface) => Promise<DefinitionIface>;\n  /** Compiles the directory at `ref` server-side without publishing. */\n  compile: (\n    args: DefinitionRefIface & { ref: string; harness?: string },\n  ) => Promise<CompileResultIface>;\n  commit: (args: DefinitionRefIface & CommitDefinitionRequestIface) => Promise<CommitResultIface>;\n  /** Compiles `ref`, stores a revision and makes it current. */\n  publish: (\n    args: DefinitionRefIface & { ref: string; note?: string },\n  ) => Promise<PublishResultIface>;\n  /** The agent directory's files at `ref` (default branch when omitted). */\n  files: (args: DefinitionRefIface & { ref?: string }) => Promise<DefinitionFilesIface>;\n  revisions: (\n    args: DefinitionRefIface & { cursor?: string },\n  ) => Promise<{ revisions: RevisionIface[]; nextCursor: string | null }>;\n  /**\n   * What changed in the compiled manifest between two revisions (revision ids\n   * or numbers); `to` defaults to the current revision.\n   */\n  revisionDiff: (\n    args: DefinitionRefIface & { from: string | number; to?: string | number },\n  ) => Promise<RevisionDiffIface>;\n  compatibility: (\n    args: DefinitionRefIface & { harness: string; ref?: string },\n  ) => Promise<CompatibilityReportIface>;\n  /** The agent's live channel bindings and their public route URLs. */\n  channels: (args: DefinitionRefIface) => Promise<DefinitionChannelIface[]>;\n  /**\n   * Archives the definition: it leaves listings, its schedules and channel\n   * bindings stop, and new sessions are refused. Its repository is kept.\n   */\n  archive: (args: DefinitionRefIface) => Promise<DefinitionIface>;\n  /**\n   * A short-lived, read-only git remote for a Final-hosted repository, for\n   * `git clone` (editors of the definition's project).\n   */\n  cloneUrl: (args: DefinitionRefIface) => Promise<DefinitionCloneUrlIface>;\n}\n\nexport interface ProvidersApiIface {\n  list: (options?: SignalOptionsIface) => Promise<ProviderEntryIface[]>;\n}\n\nexport interface ComputerSetupGuidesApiIface {\n  list: (options?: SignalOptionsIface) => Promise<ComputerSetupGuideIface[]>;\n  /** Guide by slug or id, with its versions. */\n  get: (ref: string, options?: SignalOptionsIface) => Promise<ComputerSetupGuideDetailIface>;\n  /** Publishes a new version (creating the guide on first publish). */\n  publish: (\n    args: PublishComputerSetupGuideRequestIface & SignalOptionsIface,\n  ) => Promise<{ guide: ComputerSetupGuideIface; version: ComputerSetupGuideVersionIface }>;\n}\n\nexport type ScheduleRef = { scheduleId: string } | { agent: string; key: string };\n\nexport interface SchedulesApiIface {\n  list: (options?: SignalOptionsIface & { agent?: string }) => Promise<ScheduleIface[]>;\n  runNow: (args: ScheduleRef & SignalOptionsIface) => Promise<ScheduleRunResultIface>;\n  update: (\n    args: { scheduleId: string } & UpdateScheduleRequestIface & SignalOptionsIface,\n  ) => Promise<ScheduleIface>;\n}\n\nconst definitionPath = (definition: string, suffix = ''): string =>\n  `/v1/definitions/${encodePath(definition)}${suffix}`;\n\nexport const createDefinitionsApi = ({ http }: ClientContextIface): DefinitionsApiIface => ({\n  testRevision: ({ definition, signal, ...value }) =>\n    http.request({\n      method: HttpMethod.Post,\n      path: definitionPath(definition, '/test-revision'),\n      body: { schema: compileDefinitionRequestSchema, value },\n      response: revisionSchema,\n      signal,\n    }),\n  previewCredentialPolicy: ({ definition, signal, ...value }) =>\n    http.request({\n      method: HttpMethod.Post,\n      path: definitionPath(definition, '/credential-policy/preview'),\n      body: { schema: previewCredentialPolicyRequestSchema, value },\n      response: credentialPolicyPreviewSchema,\n      signal,\n    }),\n  list: (options) =>\n    http.request({\n      method: HttpMethod.Get,\n      path: '/v1/definitions',\n      query: { cursor: options?.cursor, limit: options?.limit, projectId: options?.projectId },\n      response: definitionListSchema,\n      signal: options?.signal,\n    }),\n  create: ({ signal, ...value }) =>\n    http.request({\n      method: HttpMethod.Post,\n      path: '/v1/definitions',\n      body: { schema: createDefinitionRequestSchema, value },\n      response: definitionSchema,\n      signal,\n    }),\n  get: ({ definition, signal }) =>\n    http.request({\n      method: HttpMethod.Get,\n      path: definitionPath(definition),\n      response: definitionSchema,\n      signal,\n    }),\n  compile: ({ definition, signal, ...value }) =>\n    http.request({\n      method: HttpMethod.Post,\n      path: definitionPath(definition, '/compile'),\n      body: { schema: compileDefinitionRequestSchema, value },\n      response: compileResultSchema,\n      signal,\n    }),\n  commit: ({ definition, signal, ...value }) =>\n    http.request({\n      method: HttpMethod.Post,\n      path: definitionPath(definition, '/commit'),\n      body: { schema: commitDefinitionRequestSchema, value },\n      response: commitResultSchema,\n      signal,\n    }),\n  publish: ({ definition, signal, ...value }) =>\n    http.request({\n      method: HttpMethod.Post,\n      path: definitionPath(definition, '/publish'),\n      body: { schema: publishDefinitionRequestSchema, value },\n      response: publishResultSchema,\n      signal,\n    }),\n  files: ({ definition, ref, signal }) =>\n    http.request({\n      method: HttpMethod.Get,\n      path: definitionPath(definition, '/files'),\n      query: { ref },\n      response: definitionFilesSchema,\n      signal,\n    }),\n  revisions: ({ definition, cursor, signal }) =>\n    http.request({\n      method: HttpMethod.Get,\n      path: definitionPath(definition, '/revisions'),\n      query: { cursor },\n      response: revisionListSchema,\n      signal,\n    }),\n  revisionDiff: ({ definition, from, to, signal }) =>\n    http.request({\n      method: HttpMethod.Get,\n      path: definitionPath(definition, '/revisions/diff'),\n      query: { from, to },\n      response: revisionDiffSchema,\n      signal,\n    }),\n  compatibility: ({ definition, harness, ref, signal }) =>\n    http.request({\n      method: HttpMethod.Get,\n      path: definitionPath(definition, '/compatibility'),\n      query: { harness, ref },\n      response: compatibilityReportSchema,\n      signal,\n    }),\n  channels: async ({ definition, signal }) =>\n    (\n      await http.request({\n        method: HttpMethod.Get,\n        path: definitionPath(definition, '/channels'),\n        response: definitionChannelsResponseSchema,\n        signal,\n      })\n    ).channels,\n  archive: ({ definition, signal }) =>\n    http.request({\n      method: HttpMethod.Post,\n      path: definitionPath(definition, '/archive'),\n      response: definitionSchema,\n      signal,\n    }),\n  cloneUrl: ({ definition, signal }) =>\n    http.request({\n      method: HttpMethod.Post,\n      path: definitionPath(definition, '/clone-url'),\n      response: definitionCloneUrlSchema,\n      signal,\n    }),\n});\n\nexport const createProvidersApi = ({ http }: ClientContextIface): ProvidersApiIface => ({\n  list: async (options) =>\n    (\n      await http.request({\n        method: HttpMethod.Get,\n        path: '/v1/providers',\n        response: providerListSchema,\n        signal: options?.signal,\n      })\n    ).providers,\n});\n\nexport const createComputerSetupGuidesApi = ({\n  http,\n}: ClientContextIface): ComputerSetupGuidesApiIface => ({\n  list: async (options) =>\n    (\n      await http.request({\n        method: HttpMethod.Get,\n        path: '/v1/computer-setup-guides',\n        response: computerSetupGuideListSchema,\n        signal: options?.signal,\n      })\n    ).guides,\n  get: (ref, options) =>\n    http.request({\n      method: HttpMethod.Get,\n      path: `/v1/computer-setup-guides/${encodePath(ref)}`,\n      response: computerSetupGuideDetailSchema,\n      signal: options?.signal,\n    }),\n  publish: ({ signal, ...value }) =>\n    http.request({\n      method: HttpMethod.Post,\n      path: '/v1/computer-setup-guides',\n      body: { schema: publishComputerSetupGuideRequestSchema, value },\n      response: publishComputerSetupGuideResultSchema,\n      signal,\n    }),\n});\n\nexport const createSchedulesApi = ({ http }: ClientContextIface): SchedulesApiIface => {\n  const list: SchedulesApiIface['list'] = async (options) =>\n    (\n      await http.request({\n        method: HttpMethod.Get,\n        path: '/v1/schedules',\n        query: { agent: options?.agent },\n        response: scheduleListSchema,\n        signal: options?.signal,\n      })\n    ).schedules;\n\n  const scheduleIdOf = async (args: ScheduleRef & SignalOptionsIface): Promise<string> => {\n    if ('scheduleId' in args) return args.scheduleId;\n    const found = (await list({ agent: args.agent, signal: args.signal })).find(\n      (schedule) => schedule.key === args.key,\n    );\n    if (found == null) {\n      throw clientError({\n        message: `No schedule ${args.key} on agent ${args.agent}`,\n        status: 0,\n        code: ClientErrorCode.NotFound,\n      });\n    }\n    return found.id;\n  };\n\n  return {\n    list,\n    runNow: async (args) =>\n      http.request({\n        method: HttpMethod.Post,\n        path: `/v1/schedules/${encodePath(await scheduleIdOf(args))}/run-now`,\n        response: scheduleRunResultSchema,\n        signal: args.signal,\n      }),\n    update: ({ scheduleId, signal, ...value }) =>\n      http.request({\n        method: HttpMethod.Patch,\n        path: `/v1/schedules/${encodePath(scheduleId)}`,\n        body: { schema: updateScheduleRequestSchema, value },\n        response: scheduleSchema,\n        signal,\n      }),\n  };\n};\n"],
+  "mappings": "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",
   "names": []
 }

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

@@ -0,0 +1,23 @@
+import { type ChannelRouteIface, type ChannelSeenPlaceIface, type ConnectChannelPlaceRequestIface, type CreateChannelBindingRequestIface, type CreateChannelBindingResponseIface } from '@finalai/agent-protocol/agent-platform';
+import { type ClientContextIface, type SignalOptionsIface } from "./context.mjs";
+export interface ChannelBindingsApiIface {
+    create(args: CreateChannelBindingRequestIface & SignalOptionsIface): Promise<CreateChannelBindingResponseIface>;
+    places(args: {
+        bindingId: string;
+    } & SignalOptionsIface): Promise<ChannelSeenPlaceIface[]>;
+    routes(args: {
+        conversationId: string;
+    } & SignalOptionsIface): Promise<ChannelRouteIface[]>;
+    connect(args: ConnectChannelPlaceRequestIface & {
+        conversationId: string;
+    } & SignalOptionsIface): Promise<{
+        id: string;
+    }>;
+    disconnect(args: {
+        conversationId: string;
+        routeId: string;
+    } & SignalOptionsIface): Promise<{
+        ok: boolean;
+    }>;
+}
+export declare const createChannelBindingsApi: (ctx: ClientContextIface) => ChannelBindingsApiIface;

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

@@ -0,0 +1,49 @@
+import {
+  channelPlacesResponseSchema,
+  channelRoutesResponseSchema,
+  connectChannelPlaceRequestSchema,
+  connectChannelPlaceResponseSchema,
+  createChannelBindingRequestSchema,
+  createChannelBindingResponseSchema,
+  disconnectChannelRouteResponseSchema
+} from "@finalai/agent-protocol/agent-platform";
+import { encodePath } from "./context.mjs";
+import { HttpMethod } from "./http.mjs";
+const createChannelBindingsApi = (ctx) => ({
+  create: ({ signal, ...body }) => ctx.http.request({
+    method: HttpMethod.Post,
+    path: "/v1/channel-bindings",
+    body: { schema: createChannelBindingRequestSchema, value: body },
+    response: createChannelBindingResponseSchema,
+    signal
+  }),
+  places: async ({ bindingId, signal }) => (await ctx.http.request({
+    method: HttpMethod.Get,
+    path: `/v1/channel-bindings/${encodePath(bindingId)}/places`,
+    response: channelPlacesResponseSchema,
+    signal
+  })).places,
+  routes: async ({ conversationId, signal }) => (await ctx.http.request({
+    method: HttpMethod.Get,
+    path: `/v1/conversations/${encodePath(conversationId)}/channel-routes`,
+    response: channelRoutesResponseSchema,
+    signal
+  })).routes,
+  connect: ({ conversationId, signal, ...body }) => ctx.http.request({
+    method: HttpMethod.Post,
+    path: `/v1/conversations/${encodePath(conversationId)}/channel-routes`,
+    body: { schema: connectChannelPlaceRequestSchema, value: body },
+    response: connectChannelPlaceResponseSchema,
+    signal
+  }),
+  disconnect: ({ conversationId, routeId, signal }) => ctx.http.request({
+    method: HttpMethod.Delete,
+    path: `/v1/conversations/${encodePath(conversationId)}/channel-routes/${encodePath(routeId)}`,
+    response: disconnectChannelRouteResponseSchema,
+    signal
+  })
+});
+export {
+  createChannelBindingsApi
+};
+//# sourceMappingURL=channels.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/agent-client/channels.ts"],
+  "sourcesContent": ["import {\n  channelPlacesResponseSchema,\n  channelRoutesResponseSchema,\n  connectChannelPlaceRequestSchema,\n  connectChannelPlaceResponseSchema,\n  createChannelBindingRequestSchema,\n  createChannelBindingResponseSchema,\n  disconnectChannelRouteResponseSchema,\n  type ChannelRouteIface,\n  type ChannelSeenPlaceIface,\n  type ConnectChannelPlaceRequestIface,\n  type CreateChannelBindingRequestIface,\n  type CreateChannelBindingResponseIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { encodePath, type ClientContextIface, type SignalOptionsIface } from \"./context.mjs\";\nimport { HttpMethod } from \"./http.mjs\";\nexport interface ChannelBindingsApiIface {\n  create(\n    args: CreateChannelBindingRequestIface & SignalOptionsIface,\n  ): Promise<CreateChannelBindingResponseIface>;\n  places(args: { bindingId: string } & SignalOptionsIface): Promise<ChannelSeenPlaceIface[]>;\n  routes(args: { conversationId: string } & SignalOptionsIface): Promise<ChannelRouteIface[]>;\n  connect(\n    args: ConnectChannelPlaceRequestIface & { conversationId: string } & SignalOptionsIface,\n  ): Promise<{ id: string }>;\n  disconnect(\n    args: { conversationId: string; routeId: string } & SignalOptionsIface,\n  ): Promise<{ ok: boolean }>;\n}\nexport const createChannelBindingsApi = (ctx: ClientContextIface): ChannelBindingsApiIface => ({\n  create: ({ signal, ...body }) =>\n    ctx.http.request({\n      method: HttpMethod.Post,\n      path: '/v1/channel-bindings',\n      body: { schema: createChannelBindingRequestSchema, value: body },\n      response: createChannelBindingResponseSchema,\n      signal,\n    }),\n  places: async ({ bindingId, signal }) =>\n    (\n      await ctx.http.request({\n        method: HttpMethod.Get,\n        path: `/v1/channel-bindings/${encodePath(bindingId)}/places`,\n        response: channelPlacesResponseSchema,\n        signal,\n      })\n    ).places,\n  routes: async ({ conversationId, signal }) =>\n    (\n      await ctx.http.request({\n        method: HttpMethod.Get,\n        path: `/v1/conversations/${encodePath(conversationId)}/channel-routes`,\n        response: channelRoutesResponseSchema,\n        signal,\n      })\n    ).routes,\n  connect: ({ conversationId, signal, ...body }) =>\n    ctx.http.request({\n      method: HttpMethod.Post,\n      path: `/v1/conversations/${encodePath(conversationId)}/channel-routes`,\n      body: { schema: connectChannelPlaceRequestSchema, value: body },\n      response: connectChannelPlaceResponseSchema,\n      signal,\n    }),\n  disconnect: ({ conversationId, routeId, signal }) =>\n    ctx.http.request({\n      method: HttpMethod.Delete,\n      path: `/v1/conversations/${encodePath(conversationId)}/channel-routes/${encodePath(routeId)}`,\n      response: disconnectChannelRouteResponseSchema,\n      signal,\n    }),\n});\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAMK;AACP,SAAS,kBAAoE;AAC7E,SAAS,kBAAkB;AAcpB,MAAM,2BAA2B,CAAC,SAAsD;AAAA,EAC7F,QAAQ,CAAC,EAAE,QAAQ,GAAG,KAAK,MACzB,IAAI,KAAK,QAAQ;AAAA,IACf,QAAQ,WAAW;AAAA,IACnB,MAAM;AAAA,IACN,MAAM,EAAE,QAAQ,mCAAmC,OAAO,KAAK;AAAA,IAC/D,UAAU;AAAA,IACV;AAAA,EACF,CAAC;AAAA,EACH,QAAQ,OAAO,EAAE,WAAW,OAAO,OAE/B,MAAM,IAAI,KAAK,QAAQ;AAAA,IACrB,QAAQ,WAAW;AAAA,IACnB,MAAM,wBAAwB,WAAW,SAAS,CAAC;AAAA,IACnD,UAAU;AAAA,IACV;AAAA,EACF,CAAC,GACD;AAAA,EACJ,QAAQ,OAAO,EAAE,gBAAgB,OAAO,OAEpC,MAAM,IAAI,KAAK,QAAQ;AAAA,IACrB,QAAQ,WAAW;AAAA,IACnB,MAAM,qBAAqB,WAAW,cAAc,CAAC;AAAA,IACrD,UAAU;AAAA,IACV;AAAA,EACF,CAAC,GACD;AAAA,EACJ,SAAS,CAAC,EAAE,gBAAgB,QAAQ,GAAG,KAAK,MAC1C,IAAI,KAAK,QAAQ;AAAA,IACf,QAAQ,WAAW;AAAA,IACnB,MAAM,qBAAqB,WAAW,cAAc,CAAC;AAAA,IACrD,MAAM,EAAE,QAAQ,kCAAkC,OAAO,KAAK;AAAA,IAC9D,UAAU;AAAA,IACV;AAAA,EACF,CAAC;AAAA,EACH,YAAY,CAAC,EAAE,gBAAgB,SAAS,OAAO,MAC7C,IAAI,KAAK,QAAQ;AAAA,IACf,QAAQ,WAAW;AAAA,IACnB,MAAM,qBAAqB,WAAW,cAAc,CAAC,mBAAmB,WAAW,OAAO,CAAC;AAAA,IAC3F,UAAU;AAAA,IACV;AAAA,EACF,CAAC;AACL;",
+  "names": []
+}

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

@@ -2,6 +2,7 @@ import { type AgentInfoIface, type AgentListIface, type HealthResponseIface, typ
 import { type AcpApiIface } from "./acp.mjs";
 import { type ComputerSetupGuidesApiIface, type DefinitionsApiIface, type ProvidersApiIface, type SchedulesApiIface } from "./build.mjs";
 import { type SignalOptionsIface } from "./context.mjs";
+import { type ChannelBindingsApiIface } from "./channels.mjs";
 import { type ConversationsApiIface } from "./conversations.mjs";
 import { type StreamTimingIface } from "./frame-stream.mjs";
 import { type AgentClientAuth, type FetchIface, type HeadersOption } from "./http.mjs";
@@ -78,6 +79,7 @@ export interface AgentClientIface {
     realtime: RealtimeApiIface;
     sessions: SessionsApiIface;
     conversations: ConversationsApiIface;
+    channelBindings: ChannelBindingsApiIface;
     definitions: DefinitionsApiIface;
     providers: ProvidersApiIface;
     computerSetupGuides: ComputerSetupGuidesApiIface;

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

@@ -14,6 +14,7 @@ import {
   createSchedulesApi
 } from "./build.mjs";
 import { encodePath } from "./context.mjs";
+import { createChannelBindingsApi } from "./channels.mjs";
 import { createConversationsApi } from "./conversations.mjs";
 import { clientError, ClientErrorCode } from "./errors.mjs";
 import { defaultStreamTiming } from "./frame-stream.mjs";
@@ -154,6 +155,7 @@ const createClient = (options) => {
     realtime: { createSession: createRealtimeSession },
     sessions: createSessionsApi(context),
     conversations: createConversationsApi(context),
+    channelBindings: createChannelBindingsApi(context),
     definitions: createDefinitionsApi(context),
     providers: createProvidersApi(context),
     computerSetupGuides: createComputerSetupGuidesApi(context),

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 { 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  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    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  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": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAOK;AACP,SAAS,oBAAsC;AAC/C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAKK;AACP,SAAS,kBAAoE;AAC7E,SAAS,gCAA8D;AACvE,SAAS,8BAA0D;AACnE,SAAS,aAAa,uBAAuB;AAC7C,SAAS,2BAAmD;AAC5D;AAAA,EACE;AAAA,EACA;AAAA,OAIK;AACP;AAAA,EACE;AAAA,OAIK;AACP,SAAS,yBAAgD;AA+FlD,MAAM,eAAe,CAAC,YAAwD;AACnF,QAAM,OAAO,WAAW;AAAA,IACtB,MAAM,QAAQ;AAAA,IACd,MAAM,QAAQ;AAAA,IACd,SAAS,QAAQ;AAAA,IACjB,OAAO,QAAQ;AAAA,EACjB,CAAC;AACD,MAAI,WAAW,QAAQ,YAAY;AACnC,MAAI,eAAqD;AACzD,QAAM,UAAU,IAAI,gBAAgB;AACpC,QAAM,wBAA2D,CAAC,mBAChE,KAAK,QAAQ;AAAA,IACX,QAAQ,WAAW;AAAA,IACnB,MAAM;AAAA,IACN,UAAU;AAAA,IACV,QAAQ,gBAAgB;AAAA,EAC1B,CAAC;AACH,MAAI,gBAA8D;AAClE,QAAM,uBAAuB,MAAM;AACjC,QAAI,iBAAiB,KAAM,QAAO;AAClC,UAAM,UAAU,sBAAsB,EAAE,QAAQ,QAAQ,OAAO,CAAC;AAChE,oBAAgB;AAChB,SAAK,QAAQ,MAAM,MAAM;AACvB,UAAI,kBAAkB,QAAS,iBAAgB;AAAA,IACjD,CAAC;AACD,WAAO;AAAA,EACT;AACA,MAAI,eAAuC;AAE3C,QAAM,iBAAuD,MAAM;AACjE,QAAI,gBAAgB,KAAM,QAAO;AACjC,UAAM,UAAU,qBAAqB,EAAE,KAAK,CAAC,YAAY;AACvD,UAAI,QAAQ,UAAU;AACpB,cAAM,IAAI,MAAM,2DAA2D;AAC7E,aAAO,QAAQ;AAAA,IACjB,CAAC;AACD,mBAAe;AAEf,YAAQ,MAAM,MAAM;AAClB,UAAI,iBAAiB,QAAS,gBAAe;AAAA,IAC/C,CAAC;AACD,WAAO;AAAA,EACT;AACA,QAAM,UAA8B;AAAA,IAClC;AAAA,IACA,aAAa,QAAQ;AAAA,IACrB;AAAA;AAAA,IAEA,yBAAyB,YAAY;AACnC,YAAM,QAAQ,MAAM,qBAAqB;AAEzC,UAAI,MAAM,UAAU;AAClB,cAAM,IAAI,MAAM,wEAAwE;AAC1F,aAAO,oBAAoB,kBAAkB,MAAM,MAAM;AAAA,IAC3D;AAAA,IACA,cAAc,QAAQ,iBAAiB,CAAC,OAAO,SAAS,WAAW,MAAM,OAAO,IAAI;AAAA,IACpF,UAAU,MAAM;AACd,UAAI,YAAY,KAAM,QAAO;AAC7B,qBAAe,+BAA+B;AAAA,QAC5C,eAAe,MAAM,sBAAsB;AAAA,QAC3C,SAAS,QAAQ;AAAA,MACnB,CAAC;AACD,UAAI,QAAQ,OAAO,QAAS,cAAa,MAAM;AAC/C,iBAAW;AACX,aAAO;AAAA,IACT;AAAA,IACA,QAAQ,EAAE,GAAG,qBAAqB,GAAG,QAAQ,OAAO;AAAA,IACpD,QAAQ,QAAQ,WAAW,MAAM,WAAW,OAAO,WAAW;AAAA,IAC9D,KAAK,QAAQ,OAAO,KAAK;AAAA,EAC3B;AAEA,QAAM,QAAQ,MAAY;AACxB,QAAI,QAAQ,OAAO,QAAS;AAC5B,YAAQ;AAAA,MACN,YAAY,EAAE,SAAS,uBAAuB,QAAQ,GAAG,MAAM,gBAAgB,OAAO,CAAC;AAAA,IACzF;AACA,kBAAc,MAAM;AAAA,EACtB;AAEA,SAAO;AAAA,IACL;AAAA,IACA,CAAC,OAAO,YAAY,GAAG,YAAY,MAAM;AAAA,IACzC,QAAQ,CAAC,kBACP,KAAK,QAAQ;AAAA,MACX,QAAQ,WAAW;AAAA,MACnB,MAAM;AAAA,MACN,UAAU;AAAA,MACV,QAAQ,eAAe;AAAA,IACzB,CAAC;AAAA,IACH,QAAQ;AAAA,MACN,MAAM,CAAC,gBACL,KAAK,QAAQ;AAAA,QACX,QAAQ,WAAW;AAAA,QACnB,MAAM;AAAA,QACN,OAAO;AAAA,UACL,QAAQ,aAAa;AAAA,UACrB,OAAO,aAAa;AAAA,UACpB,WAAW,aAAa;AAAA,QAC1B;AAAA,QACA,UAAU;AAAA,QACV,QAAQ,aAAa;AAAA,MACvB,CAAC;AAAA,MACH,KAAK,CAAC,cAAc;AAAA,QAClB,MAAM;AAAA,QACN,MAAM,CAAC,gBACL,KAAK,QAAQ;AAAA,UACX,QAAQ,WAAW;AAAA,UACnB,MAAM,cAAc,WAAW,QAAQ,CAAC;AAAA,UACxC,UAAU;AAAA,UACV,QAAQ,aAAa;AAAA,QACvB,CAAC;AAAA,MACL;AAAA,IACF;AAAA,IACA,QAAS,uBAAM;AACb,YAAM,OAA+B,CAAC,gBACpC,KAAK,QAAQ;AAAA,QACX,QAAQ,WAAW;AAAA,QACnB,MAAM;AAAA,QACN,OAAO,EAAE,QAAQ,aAAa,QAAQ,OAAO,aAAa,MAAM;AAAA,QAChE,UAAU;AAAA,QACV,QAAQ,aAAa;AAAA,MACvB,CAAC;AACH,aAAO;AAAA,QACL;AAAA,QACA,KAAK,OAAO,eAAe;AACzB,gBAAM,MAAqB,CAAC;AAC5B,cAAI;AACJ,qBAAS;AACP,kBAAM,OAAO,MAAM,KAAK,EAAE,QAAQ,QAAQ,YAAY,OAAO,CAAC;AAC9D,gBAAI,KAAK,GAAG,KAAK,MAAM;AACvB,gBAAI,KAAK,cAAc,KAAM,QAAO;AACpC,qBAAS,KAAK;AAAA,UAChB;AAAA,QACF;AAAA,MACF;AAAA,IACF,GAAG;AAAA,IACH,UAAU,EAAE,eAAe,sBAAsB;AAAA,IACjD,UAAU,kBAAkB,OAAO;AAAA,IACnC,eAAe,uBAAuB,OAAO;AAAA,IAC7C,iBAAiB,yBAAyB,OAAO;AAAA,IACjD,aAAa,qBAAqB,OAAO;AAAA,IACzC,WAAW,mBAAmB,OAAO;AAAA,IACrC,qBAAqB,6BAA6B,OAAO;AAAA,IACzD,WAAW,mBAAmB,OAAO;AAAA,IACrC,KAAK,aAAa,EAAE,KAAK,CAAC;AAAA,EAC5B;AACF;",
   "names": []
 }

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

@@ -314,8 +314,8 @@ export interface OpenedConversationIface extends ConversationHandleIface {
 }
 export interface CreateConversationArgsIface extends SignalOptionsIface {
     /**
-     * The project (`prj_...`) a group chat is created in (editors only); omitted,
-     * the API key's parent project (a signed-in person's: My Work).
+     * The project (`prj_...`) a signed-in person creates a group chat in (editors only).
+     * Omitted: their personal project. Project API keys cannot create person-owned chats.
      * A direct chat is the caller's own and lives in their personal project.
      */
     projectId?: string;
@@ -326,10 +326,9 @@ export interface CreateConversationArgsIface extends SignalOptionsIface {
 }
 export interface ConversationsApiIface {
     /**
-     * The conversations the caller can read.
-     * Without `projectId`: everything the caller can access (an API key: its parent project and
-     * every project it is granted; a person: every project they can read). `projectId` narrows to
-     * that project and the projects below it.
+     * A signed-in person's conversations. Without `projectId`, lists their participant inbox.
+     * With `projectId`, also includes readable Shared chats in that project and its descendants.
+     * A project API key has no person inbox and receives an empty list.
      */
     list: (options?: SignalOptionsIface & {
         cursor?: string;
@@ -343,7 +342,7 @@ export interface ConversationsApiIface {
     } & SignalOptionsIface) => Promise<OpenedConversationIface>;
     /**
      * Finds or creates the caller's own Project Agent thread in `projectId`, which
-     * omitted, is the API key's parent project (a signed-in person's: My Work).
+     * omitted, is the signed-in person's personal project. Requires person authority.
      */
     home: (options?: SignalOptionsIface & {
         projectId?: string;
@@ -367,9 +366,8 @@ export interface ConversationsApiIface {
     listEvents: (options?: CollectionEventsOptionsIface) => AsyncIterableIterator<CollectionEvent>;
     /**
      * What awaits the caller's answer across conversations.
-     * Without `projectId`: everything the caller can access (an API key: its parent project and
-     * every project it is granted; a person: every project they can read). `projectId` narrows to
-     * that project and the projects below it.
+     * Decisions in the selected project and its descendants; omitted, the signed-in person's
+     * personal project. A project API key has no person inbox and receives an empty list.
      */
     decisions: (options?: SignalOptionsIface & {
         cursor?: string;