@finalai/agents 0.4.4 → 0.6.0

package/HOSTING.md

@@ -7,13 +7,13 @@ resolve against dev and production configuration without source edits.
 ## Selecting a deployment
 
 ```sh
-export FINAL_API_HOST=https://agent-session.primary-dev.final.ai/api
-export FINAL_API_KEY=<dev-organization-key>
+export FINAL_API_HOST=https://<dev-agents-api-host>/api
+export FINAL_API_KEY=<dev-api-key>
 pnpm exec final-agents build ./agent
 pnpm exec final-agents publish ./agent --agent my-agent
 ```
 
-Choose production by changing the host and organization key. `--host` overrides
+Choose production by changing the host and API key. `--host` overrides
 `FINAL_API_HOST`; without either, the existing production default remains. Build
 compiles locally and optionally checks installed-harness compatibility. Publish
 compiles again and sends source/release requests to the selected deployment.

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

@@ -10,13 +10,23 @@ export interface DefinitionsApiIface {
         ref: string;
     }) => Promise<RevisionIface>;
     previewCredentialPolicy: (args: DefinitionRefIface & PreviewCredentialPolicyRequestIface) => Promise<CredentialPolicyPreviewIface>;
+    /**
+     * With `projectId`, its definitions 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).
+     */
     list: (options?: SignalOptionsIface & {
         cursor?: string;
         limit?: number;
+        projectId?: string;
     }) => Promise<{
         definitions: DefinitionIface[];
         nextCursor: string | null;
     }>;
+    /**
+     * Creates the definition in `projectId` (editors of that project); omitted, the API key's parent
+     * project (a signed-in person's: My Work).
+     */
     create: (args: CreateDefinitionRequestIface & SignalOptionsIface) => Promise<DefinitionIface>;
     get: (args: DefinitionRefIface) => Promise<DefinitionIface>;
     /** Compiles the directory at `ref` server-side without publishing. */
@@ -69,7 +79,7 @@ export interface DefinitionsApiIface {
     archive: (args: DefinitionRefIface) => Promise<DefinitionIface>;
     /**
      * A short-lived, read-only git remote for a Final-hosted repository, for
-     * `git clone` (owners of personal agents, organization admins otherwise).
+     * `git clone` (editors of the definition's project).
      */
     cloneUrl: (args: DefinitionRefIface) => Promise<DefinitionCloneUrlIface>;
 }

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

@@ -51,7 +51,7 @@ const createDefinitionsApi = ({ http }) => ({
   list: (options) => http.request({
     method: HttpMethod.Get,
     path: "/v1/definitions",
-    query: { cursor: options?.cursor, limit: options?.limit },
+    query: { cursor: options?.cursor, limit: options?.limit, projectId: options?.projectId },
     response: definitionListSchema,
     signal: options?.signal
   }),

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  list: (\n    options?: SignalOptionsIface & { cursor?: string; limit?: number },\n  ) => Promise<{ definitions: DefinitionIface[]; nextCursor: string | null }>;\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` (owners of personal agents, organization admins otherwise).\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 },\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": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAwBK;AACP,SAAS,kBAAoE;AAC7E,SAAS,aAAa,uBAAuB;AAC7C,SAAS,kBAAkB;AA0F3B,MAAM,iBAAiB,CAAC,YAAoB,SAAS,OACnD,mBAAmB,WAAW,UAAU,CAAC,GAAG,MAAM;AAE7C,MAAM,uBAAuB,CAAC,EAAE,KAAK,OAAgD;AAAA,EAC1F,cAAc,CAAC,EAAE,YAAY,QAAQ,GAAG,MAAM,MAC5C,KAAK,QAAQ;AAAA,IACX,QAAQ,WAAW;AAAA,IACnB,MAAM,eAAe,YAAY,gBAAgB;AAAA,IACjD,MAAM,EAAE,QAAQ,gCAAgC,MAAM;AAAA,IACtD,UAAU;AAAA,IACV;AAAA,EACF,CAAC;AAAA,EACH,yBAAyB,CAAC,EAAE,YAAY,QAAQ,GAAG,MAAM,MACvD,KAAK,QAAQ;AAAA,IACX,QAAQ,WAAW;AAAA,IACnB,MAAM,eAAe,YAAY,4BAA4B;AAAA,IAC7D,MAAM,EAAE,QAAQ,sCAAsC,MAAM;AAAA,IAC5D,UAAU;AAAA,IACV;AAAA,EACF,CAAC;AAAA,EACH,MAAM,CAAC,YACL,KAAK,QAAQ;AAAA,IACX,QAAQ,WAAW;AAAA,IACnB,MAAM;AAAA,IACN,OAAO,EAAE,QAAQ,SAAS,QAAQ,OAAO,SAAS,MAAM;AAAA,IACxD,UAAU;AAAA,IACV,QAAQ,SAAS;AAAA,EACnB,CAAC;AAAA,EACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,MAC1B,KAAK,QAAQ;AAAA,IACX,QAAQ,WAAW;AAAA,IACnB,MAAM;AAAA,IACN,MAAM,EAAE,QAAQ,+BAA+B,MAAM;AAAA,IACrD,UAAU;AAAA,IACV;AAAA,EACF,CAAC;AAAA,EACH,KAAK,CAAC,EAAE,YAAY,OAAO,MACzB,KAAK,QAAQ;AAAA,IACX,QAAQ,WAAW;AAAA,IACnB,MAAM,eAAe,UAAU;AAAA,IAC/B,UAAU;AAAA,IACV;AAAA,EACF,CAAC;AAAA,EACH,SAAS,CAAC,EAAE,YAAY,QAAQ,GAAG,MAAM,MACvC,KAAK,QAAQ;AAAA,IACX,QAAQ,WAAW;AAAA,IACnB,MAAM,eAAe,YAAY,UAAU;AAAA,IAC3C,MAAM,EAAE,QAAQ,gCAAgC,MAAM;AAAA,IACtD,UAAU;AAAA,IACV;AAAA,EACF,CAAC;AAAA,EACH,QAAQ,CAAC,EAAE,YAAY,QAAQ,GAAG,MAAM,MACtC,KAAK,QAAQ;AAAA,IACX,QAAQ,WAAW;AAAA,IACnB,MAAM,eAAe,YAAY,SAAS;AAAA,IAC1C,MAAM,EAAE,QAAQ,+BAA+B,MAAM;AAAA,IACrD,UAAU;AAAA,IACV;AAAA,EACF,CAAC;AAAA,EACH,SAAS,CAAC,EAAE,YAAY,QAAQ,GAAG,MAAM,MACvC,KAAK,QAAQ;AAAA,IACX,QAAQ,WAAW;AAAA,IACnB,MAAM,eAAe,YAAY,UAAU;AAAA,IAC3C,MAAM,EAAE,QAAQ,gCAAgC,MAAM;AAAA,IACtD,UAAU;AAAA,IACV;AAAA,EACF,CAAC;AAAA,EACH,OAAO,CAAC,EAAE,YAAY,KAAK,OAAO,MAChC,KAAK,QAAQ;AAAA,IACX,QAAQ,WAAW;AAAA,IACnB,MAAM,eAAe,YAAY,QAAQ;AAAA,IACzC,OAAO,EAAE,IAAI;AAAA,IACb,UAAU;AAAA,IACV;AAAA,EACF,CAAC;AAAA,EACH,WAAW,CAAC,EAAE,YAAY,QAAQ,OAAO,MACvC,KAAK,QAAQ;AAAA,IACX,QAAQ,WAAW;AAAA,IACnB,MAAM,eAAe,YAAY,YAAY;AAAA,IAC7C,OAAO,EAAE,OAAO;AAAA,IAChB,UAAU;AAAA,IACV;AAAA,EACF,CAAC;AAAA,EACH,cAAc,CAAC,EAAE,YAAY,MAAM,IAAI,OAAO,MAC5C,KAAK,QAAQ;AAAA,IACX,QAAQ,WAAW;AAAA,IACnB,MAAM,eAAe,YAAY,iBAAiB;AAAA,IAClD,OAAO,EAAE,MAAM,GAAG;AAAA,IAClB,UAAU;AAAA,IACV;AAAA,EACF,CAAC;AAAA,EACH,eAAe,CAAC,EAAE,YAAY,SAAS,KAAK,OAAO,MACjD,KAAK,QAAQ;AAAA,IACX,QAAQ,WAAW;AAAA,IACnB,MAAM,eAAe,YAAY,gBAAgB;AAAA,IACjD,OAAO,EAAE,SAAS,IAAI;AAAA,IACtB,UAAU;AAAA,IACV;AAAA,EACF,CAAC;AAAA,EACH,UAAU,OAAO,EAAE,YAAY,OAAO,OAElC,MAAM,KAAK,QAAQ;AAAA,IACjB,QAAQ,WAAW;AAAA,IACnB,MAAM,eAAe,YAAY,WAAW;AAAA,IAC5C,UAAU;AAAA,IACV;AAAA,EACF,CAAC,GACD;AAAA,EACJ,eAAe,CAAC,EAAE,YAAY,WAAW,gBAAgB,OAAO,MAC9D,KAAK,QAAQ;AAAA,IACX,QAAQ,WAAW;AAAA,IACnB,MAAM,eAAe,YAAY,aAAa,WAAW,SAAS,CAAC,eAAe;AAAA,IAClF,MAAM,EAAE,QAAQ,mCAAmC,OAAO,EAAE,eAAe,EAAE;AAAA,IAC7E,UAAU;AAAA,IACV;AAAA,EACF,CAAC;AAAA,EACH,SAAS,CAAC,EAAE,YAAY,OAAO,MAC7B,KAAK,QAAQ;AAAA,IACX,QAAQ,WAAW;AAAA,IACnB,MAAM,eAAe,YAAY,UAAU;AAAA,IAC3C,UAAU;AAAA,IACV;AAAA,EACF,CAAC;AAAA,EACH,UAAU,CAAC,EAAE,YAAY,OAAO,MAC9B,KAAK,QAAQ;AAAA,IACX,QAAQ,WAAW;AAAA,IACnB,MAAM,eAAe,YAAY,YAAY;AAAA,IAC7C,UAAU;AAAA,IACV;AAAA,EACF,CAAC;AACL;AAEO,MAAM,qBAAqB,CAAC,EAAE,KAAK,OAA8C;AAAA,EACtF,MAAM,OAAO,aAET,MAAM,KAAK,QAAQ;AAAA,IACjB,QAAQ,WAAW;AAAA,IACnB,MAAM;AAAA,IACN,UAAU;AAAA,IACV,QAAQ,SAAS;AAAA,EACnB,CAAC,GACD;AACN;AAEO,MAAM,+BAA+B,CAAC;AAAA,EAC3C;AACF,OAAwD;AAAA,EACtD,MAAM,OAAO,aAET,MAAM,KAAK,QAAQ;AAAA,IACjB,QAAQ,WAAW;AAAA,IACnB,MAAM;AAAA,IACN,UAAU;AAAA,IACV,QAAQ,SAAS;AAAA,EACnB,CAAC,GACD;AAAA,EACJ,KAAK,CAAC,KAAK,YACT,KAAK,QAAQ;AAAA,IACX,QAAQ,WAAW;AAAA,IACnB,MAAM,6BAA6B,WAAW,GAAG,CAAC;AAAA,IAClD,UAAU;AAAA,IACV,QAAQ,SAAS;AAAA,EACnB,CAAC;AAAA,EACH,SAAS,CAAC,EAAE,QAAQ,GAAG,MAAM,MAC3B,KAAK,QAAQ;AAAA,IACX,QAAQ,WAAW;AAAA,IACnB,MAAM;AAAA,IACN,MAAM,EAAE,QAAQ,wCAAwC,MAAM;AAAA,IAC9D,UAAU;AAAA,IACV;AAAA,EACF,CAAC;AACL;AAEO,MAAM,qBAAqB,CAAC,EAAE,KAAK,MAA6C;AACrF,QAAM,OAAkC,OAAO,aAE3C,MAAM,KAAK,QAAQ;AAAA,IACjB,QAAQ,WAAW;AAAA,IACnB,MAAM;AAAA,IACN,OAAO,EAAE,OAAO,SAAS,MAAM;AAAA,IAC/B,UAAU;AAAA,IACV,QAAQ,SAAS;AAAA,EACnB,CAAC,GACD;AAEJ,QAAM,eAAe,OAAO,SAA4D;AACtF,QAAI,gBAAgB,KAAM,QAAO,KAAK;AACtC,UAAM,SAAS,MAAM,KAAK,EAAE,OAAO,KAAK,OAAO,QAAQ,KAAK,OAAO,CAAC,GAAG;AAAA,MACrE,CAAC,aAAa,SAAS,QAAQ,KAAK;AAAA,IACtC;AACA,QAAI,SAAS,MAAM;AACjB,YAAM,YAAY;AAAA,QAChB,SAAS,eAAe,KAAK,GAAG,aAAa,KAAK,KAAK;AAAA,QACvD,QAAQ;AAAA,QACR,MAAM,gBAAgB;AAAA,MACxB,CAAC;AAAA,IACH;AACA,WAAO,MAAM;AAAA,EACf;AAEA,SAAO;AAAA,IACL;AAAA,IACA,QAAQ,OAAO,SACb,KAAK,QAAQ;AAAA,MACX,QAAQ,WAAW;AAAA,MACnB,MAAM,iBAAiB,WAAW,MAAM,aAAa,IAAI,CAAC,CAAC;AAAA,MAC3D,UAAU;AAAA,MACV,QAAQ,KAAK;AAAA,IACf,CAAC;AAAA,IACH,QAAQ,CAAC,EAAE,YAAY,QAAQ,GAAG,MAAM,MACtC,KAAK,QAAQ;AAAA,MACX,QAAQ,WAAW;AAAA,MACnB,MAAM,iBAAiB,WAAW,UAAU,CAAC;AAAA,MAC7C,MAAM,EAAE,QAAQ,6BAA6B,MAAM;AAAA,MACnD,UAAU;AAAA,MACV;AAAA,IACF,CAAC;AAAA,EACL;AACF;",
+  "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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",
   "names": []
 }

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

@@ -1,7 +1,6 @@
-import { type AgentInfoIface, type AgentListIface, type HealthResponseIface, type PendingRequestIface, type PendingRequestListIface, type PersonIface, type PersonListIface, type RealtimeSessionResponseIface } from '@finalai/agent-protocol/agent-platform';
+import { type AgentInfoIface, type AgentListIface, type HealthResponseIface, type PersonIface, type PersonListIface, 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 CollectionEvent, type CollectionEventsOptionsIface } from "./collection-events.mjs";
 import { type SignalOptionsIface } from "./context.mjs";
 import { type ConversationsApiIface } from "./conversations.mjs";
 import { type StreamTimingIface } from "./frame-stream.mjs";
@@ -10,9 +9,8 @@ import { type GatewayConnect, type RealtimeTransportIface } from "./realtime.mjs
 import { type SessionsApiIface } from "./sessions.mjs";
 export interface CreateClientOptionsIface {
     /**
-     * The session service's 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 (console-server's `https://<console>/api/agent-platform` proxy).
+     * 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.
      */
     host: string;
     auth: AgentClientAuth;
@@ -43,28 +41,19 @@ export interface AgentHandleIface {
     info: (options?: SignalOptionsIface) => Promise<AgentInfoIface>;
 }
 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).
+     */
     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 PendingApiIface {
-    /**
-     * The caller's pending topic (`user.collection:<userId>:pending`): `acp.pending`
-     * events for requests addressed to them, and a `collection.resync` whenever
-     * `mine()` must be re-read (on every subscription, resync and while realtime is down).
-     */
-    events: (options?: CollectionEventsOptionsIface) => AsyncIterableIterator<CollectionEvent>;
-    /** Every open permission and elicitation request whose audience includes the caller, newest first (all pages). */
-    mine: (options?: SignalOptionsIface) => Promise<PendingRequestIface[]>;
-    /** One page, newest first; pass `nextCursor` as `cursor` for the next. */
-    page: (options?: SignalOptionsIface & {
-        cursor?: string;
-        limit?: number;
-    }) => Promise<PendingRequestListIface>;
-}
 export interface PeopleApiIface {
     /** One page of the caller's organization members, by name; pass `nextCursor` as `cursor` for the next. */
     list: (options?: SignalOptionsIface & {
@@ -93,10 +82,9 @@ export interface AgentClientIface {
     providers: ProvidersApiIface;
     computerSetupGuides: ComputerSetupGuidesApiIface;
     schedules: SchedulesApiIface;
-    pending: PendingApiIface;
     /**
      * ACP-native access (`/acp/ws`): an ACP v2 ClientApp connection on which the
-     * session service is the agent. The ACP SDK loads on the first `connect`.
+     * agents API is the agent. The ACP SDK loads on the first `connect`.
      */
     acp: AcpApiIface;
     /**

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

@@ -3,7 +3,6 @@ import {
   agentListSchema,
   agentRealtimeTopics,
   healthResponseSchema,
-  pendingRequestListSchema,
   personListSchema,
   realtimeSessionResponseSchema
 } from "@finalai/agent-protocol/agent-platform";
@@ -14,13 +13,7 @@ import {
   createProvidersApi,
   createSchedulesApi
 } from "./build.mjs";
-import {
-  streamCollectionEvents
-} from "./collection-events.mjs";
-import {
-  ClientCollection,
-  encodePath
-} from "./context.mjs";
+import { encodePath } from "./context.mjs";
 import { createConversationsApi } from "./conversations.mjs";
 import { clientError, ClientErrorCode } from "./errors.mjs";
 import { defaultStreamTiming } from "./frame-stream.mjs";
@@ -76,11 +69,12 @@ const createClient = (options) => {
     http,
     closeSignal: closing.signal,
     realtimeUserId,
-    realtimeCollectionTopic: async (collection) => {
+    // Conversations is the only collection.
+    realtimeCollectionTopic: async () => {
       const owner = await realtimeOwnerSession();
       if (owner.userId == null)
         throw new Error("Collection streams belong to users; API-key owners use session streams");
-      return collection === ClientCollection.Pending ? agentRealtimeTopics.userPending(owner.userId) : agentRealtimeTopics.userConversations(owner.userId);
+      return agentRealtimeTopics.userConversations(owner.userId);
     },
     storageFetch: options.storageFetch ?? ((input, init) => globalThis.fetch(input, init)),
     realtime: () => {
@@ -117,7 +111,11 @@ const createClient = (options) => {
       list: (listOptions) => http.request({
         method: HttpMethod.Get,
         path: "/v1/agents",
-        query: { cursor: listOptions?.cursor, limit: listOptions?.limit },
+        query: {
+          cursor: listOptions?.cursor,
+          limit: listOptions?.limit,
+          projectId: listOptions?.projectId
+        },
         response: agentListSchema,
         signal: listOptions?.signal
       }),
@@ -160,35 +158,7 @@ const createClient = (options) => {
     providers: createProvidersApi(context),
     computerSetupGuides: createComputerSetupGuidesApi(context),
     schedules: createSchedulesApi(context),
-    acp: createAcpApi({ http }),
-    pending: /* @__PURE__ */ (() => {
-      const page = (pageOptions) => http.request({
-        method: HttpMethod.Get,
-        path: "/v1/pending",
-        query: { cursor: pageOptions?.cursor, limit: pageOptions?.limit },
-        response: pendingRequestListSchema,
-        signal: pageOptions?.signal
-      });
-      return {
-        page,
-        events: (eventsOptions) => streamCollectionEvents({
-          context,
-          topicFor: agentRealtimeTopics.userPending,
-          collection: ClientCollection.Pending,
-          options: eventsOptions
-        }),
-        mine: async (mineOptions) => {
-          const all = [];
-          let cursor;
-          for (; ; ) {
-            const next = await page({ cursor, signal: mineOptions?.signal });
-            all.push(...next.pending);
-            if (next.nextCursor == null) return all;
-            cursor = next.nextCursor;
-          }
-        }
-      };
-    })()
+    acp: createAcpApi({ http })
   };
 };
 export {

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  pendingRequestListSchema,\n  personListSchema,\n  realtimeSessionResponseSchema,\n  type AgentInfoIface,\n  type AgentListIface,\n  type HealthResponseIface,\n  type PendingRequestIface,\n  type PendingRequestListIface,\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 {\n  streamCollectionEvents,\n  type CollectionEvent,\n  type CollectionEventsOptionsIface,\n} from \"./collection-events.mjs\";\nimport {\n  ClientCollection,\n  encodePath,\n  type ClientContextIface,\n  type SignalOptionsIface,\n} 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 session service's origin (`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\n   * under (console-server's `https://<console>/api/agent-platform` proxy).\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  list: (\n    options?: SignalOptionsIface & { cursor?: string; limit?: number },\n  ) => Promise<AgentListIface>;\n  /** I/O-free handle by slug or id. */\n  get: (slugOrId: string) => AgentHandleIface;\n}\n\nexport interface PendingApiIface {\n  /**\n   * The caller's pending topic (`user.collection:<userId>:pending`): `acp.pending`\n   * events for requests addressed to them, and a `collection.resync` whenever\n   * `mine()` must be re-read (on every subscription, resync and while realtime is down).\n   */\n  events: (options?: CollectionEventsOptionsIface) => AsyncIterableIterator<CollectionEvent>;\n  /** Every open permission and elicitation request whose audience includes the caller, newest first (all pages). */\n  mine: (options?: SignalOptionsIface) => Promise<PendingRequestIface[]>;\n  /** One page, newest first; pass `nextCursor` as `cursor` for the next. */\n  page: (\n    options?: SignalOptionsIface & { cursor?: string; limit?: number },\n  ) => Promise<PendingRequestListIface>;\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  pending: PendingApiIface;\n  /**\n   * ACP-native access (`/acp/ws`): an ACP v2 ClientApp connection on which the\n   * session service 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    realtimeCollectionTopic: async (collection) => {\n      const owner = await realtimeOwnerSession();\n      // Organization and team keys are no conversation 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 collection === ClientCollection.Pending\n        ? agentRealtimeTopics.userPending(owner.userId)\n        : 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: { cursor: listOptions?.cursor, limit: listOptions?.limit },\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    pending: (() => {\n      const page: PendingApiIface['page'] = (pageOptions) =>\n        http.request({\n          method: HttpMethod.Get,\n          path: '/v1/pending',\n          query: { cursor: pageOptions?.cursor, limit: pageOptions?.limit },\n          response: pendingRequestListSchema,\n          signal: pageOptions?.signal,\n        });\n      return {\n        page,\n        events: (eventsOptions) =>\n          streamCollectionEvents({\n            context,\n            topicFor: agentRealtimeTopics.userPending,\n            collection: ClientCollection.Pending,\n            options: eventsOptions,\n          }),\n        mine: async (mineOptions) => {\n          const all: PendingRequestIface[] = [];\n          let cursor: string | undefined;\n          for (;;) {\n            const next = await page({ cursor, signal: mineOptions?.signal });\n            all.push(...next.pending);\n            if (next.nextCursor == null) return all;\n            cursor = next.nextCursor;\n          }\n        },\n      };\n    })(),\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 { 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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",
   "names": []
 }

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

@@ -1,7 +1,7 @@
 import type { ClientCollection, ClientContextIface, SignalOptionsIface } from "./context.mjs";
 import type { ConversationEvent } from "./conversations.mjs";
 export declare enum CollectionEventKind {
-    /** Re-read the collection (`conversations.list()`, `pending.mine()`); events may have been missed. */
+    /** Re-read the collection (`conversations.list()`); events may have been missed. */
     Resync = "collection.resync"
 }
 export declare enum CollectionResyncReason {

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/agent-client/collection-events.ts"],
-  "sourcesContent": ["import {\n  agentRealtimeFrameSchema,\n  AgentRealtimeFrameType,\n  parseAgentRealtimeEvent,\n} from '@finalai/agent-protocol/agent-platform';\nimport { createAsyncQueue, failOnAbort } from \"./async-queue.mjs\";\nimport type { ClientCollection, ClientContextIface, SignalOptionsIface } from \"./context.mjs\";\nimport type { ConversationEvent } from \"./conversations.mjs\";\nimport {\n  isRetryableClientError,\n  isTerminalRealtimeError,\n  realtimeSubscriptionError,\n} from \"./errors.mjs\";\nimport type { RealtimeTransportFrameIface } from \"./realtime.mjs\";\n\n// The caller's collection topics (`user.collection:<userId>:conversations` and\n// `:pending`). They carry no replay, so a stream says when the\n// caller must re-read the collection over HTTP: on every (re)subscription and\n// resync, and while the realtime transport reports errors.\n\nexport enum CollectionEventKind {\n  /** Re-read the collection (`conversations.list()`, `pending.mine()`); events may have been missed. */\n  Resync = 'collection.resync',\n}\n\nexport enum CollectionResyncReason {\n  Subscribed = 'subscribed',\n  ResyncRequired = 'resync_required',\n  /** The realtime transport is down; repeated every `timing.conversationPollIntervalMs`. */\n  Degraded = 'degraded',\n}\n\nexport interface CollectionResyncEventIface {\n  kind: CollectionEventKind.Resync;\n  /** Null while the signed-in user, and so the topic, could not be read yet. */\n  topic: string | null;\n  reason: CollectionResyncReason;\n}\n\n/** A realtime event of the collection topic, or a cue to re-read the collection. */\nexport type CollectionEvent = ConversationEvent | CollectionResyncEventIface;\n\nexport interface CollectionEventsOptionsIface extends SignalOptionsIface {\n  /** Keep streaming; false ends after the first resync. Defaults to true. */\n  follow?: boolean;\n  /**\n   * The signed-in user the topics are keyed by. Defaults to the user of a\n   * minted realtime session (`realtime.createSession()`).\n   */\n  userId?: string;\n}\n\nconst MAX_LOOKUP_RETRY_MS = 30_000;\n\nexport const streamCollectionEvents = (args: {\n  context: ClientContextIface;\n  topicFor: (userId: string) => string;\n  collection?: ClientCollection;\n  options: CollectionEventsOptionsIface | undefined;\n}): AsyncIterableIterator<CollectionEvent> => {\n  const follow = args.options?.follow ?? true;\n  const controller = new AbortController();\n  const signal = AbortSignal.any([\n    controller.signal,\n    args.context.closeSignal,\n    ...(args.options?.signal == null ? [] : [args.options.signal]),\n  ]);\n  let unsubscribe: (() => void) | null = null;\n  let pollTimer: ReturnType<typeof setTimeout> | null = null;\n  let lookupTimer: ReturnType<typeof setTimeout> | null = null;\n  const clearPoll = (): void => {\n    if (pollTimer != null) clearTimeout(pollTimer);\n    pollTimer = null;\n  };\n  let detachAbort: () => void = () => {};\n  let detachClose: () => void = () => {};\n  const queue = createAsyncQueue<CollectionEvent>(() => {\n    controller.abort();\n    clearPoll();\n    if (lookupTimer != null) clearTimeout(lookupTimer);\n    unsubscribe?.();\n    detachAbort();\n    detachClose();\n  });\n\n  const resync = (topic: string | null, reason: CollectionResyncReason): void => {\n    queue.push({ kind: CollectionEventKind.Resync, topic, reason });\n    if (!follow) queue.end();\n  };\n\n  const degrade = (topic: string): void => {\n    if (pollTimer != null || queue.closed()) return;\n    resync(topic, CollectionResyncReason.Degraded);\n    if (!follow || queue.closed()) return;\n    pollTimer = setTimeout(() => {\n      pollTimer = null;\n      degrade(topic);\n    }, args.context.timing.conversationPollIntervalMs);\n  };\n\n  const onFrame =\n    (topic: string) =>\n    (raw: RealtimeTransportFrameIface): void => {\n      const frame = agentRealtimeFrameSchema.safeParse(raw);\n      if (!frame.success || queue.closed()) return;\n      switch (frame.data.type) {\n        case AgentRealtimeFrameType.Event: {\n          const envelope = frame.data;\n          queue.push({\n            ...parseAgentRealtimeEvent(envelope),\n            topic: envelope.topic,\n            cursor: envelope.cursor,\n            createdAt: envelope.createdAt,\n            replayed: false,\n          });\n          return;\n        }\n        case AgentRealtimeFrameType.Subscribed:\n          clearPoll();\n          resync(topic, CollectionResyncReason.Subscribed);\n          return;\n        case AgentRealtimeFrameType.ResyncRequired:\n          resync(topic, CollectionResyncReason.ResyncRequired);\n          return;\n        case AgentRealtimeFrameType.Error:\n          if (isTerminalRealtimeError(frame.data)) {\n            queue.fail(\n              realtimeSubscriptionError({\n                topic: frame.data.topic ?? topic,\n                code: frame.data.code ?? 'unknown',\n                message: frame.data.message ?? 'Realtime subscription was refused',\n              }),\n            );\n            return;\n          }\n          // The transport resubscribes; until then the caller re-reads periodically.\n          degrade(topic);\n          return;\n        default:\n          return;\n      }\n    };\n\n  detachAbort = failOnAbort(queue, signal);\n  detachClose = failOnAbort(queue, args.context.closeSignal);\n  const userId = args.options?.userId;\n  let lookupFailures = 0;\n  const start = (): void => {\n    lookupTimer = null;\n    if (queue.closed()) return;\n    const topic =\n      userId != null\n        ? Promise.resolve(args.topicFor(userId))\n        : args.collection != null && args.context.realtimeCollectionTopic != null\n          ? args.context.realtimeCollectionTopic(args.collection)\n          : args.context.realtimeUserId().then(args.topicFor);\n    void topic.then(\n      (topic) => {\n        if (queue.closed()) return;\n        const stop = args.context.realtime().subscribe(topic, onFrame(topic));\n        if (queue.closed()) stop();\n        else unsubscribe = stop;\n      },\n      (cause: unknown) => {\n        if (queue.closed()) return;\n        if (!isRetryableClientError(cause)) {\n          queue.fail(cause);\n          return;\n        }\n        // The user lookup is unreachable: the caller re-reads meanwhile, and it is retried.\n        resync(null, CollectionResyncReason.Degraded);\n        if (queue.closed()) return;\n        const delay = Math.min(\n          MAX_LOOKUP_RETRY_MS,\n          args.context.timing.conversationPollIntervalMs * 2 ** lookupFailures,\n        );\n        lookupFailures += 1;\n        lookupTimer = setTimeout(start, delay);\n      },\n    );\n  };\n  start();\n  return queue.iterator;\n};\n"],
+  "sourcesContent": ["import {\n  agentRealtimeFrameSchema,\n  AgentRealtimeFrameType,\n  parseAgentRealtimeEvent,\n} from '@finalai/agent-protocol/agent-platform';\nimport { createAsyncQueue, failOnAbort } from \"./async-queue.mjs\";\nimport type { ClientCollection, ClientContextIface, SignalOptionsIface } from \"./context.mjs\";\nimport type { ConversationEvent } from \"./conversations.mjs\";\nimport {\n  isRetryableClientError,\n  isTerminalRealtimeError,\n  realtimeSubscriptionError,\n} from \"./errors.mjs\";\nimport type { RealtimeTransportFrameIface } from \"./realtime.mjs\";\n\n// The caller's collection topic (`user.collection:<userId>:conversations`).\n// It carries no replay, so a stream says when the\n// caller must re-read the collection over HTTP: on every (re)subscription and\n// resync, and while the realtime transport reports errors.\n\nexport enum CollectionEventKind {\n  /** Re-read the collection (`conversations.list()`); events may have been missed. */\n  Resync = 'collection.resync',\n}\n\nexport enum CollectionResyncReason {\n  Subscribed = 'subscribed',\n  ResyncRequired = 'resync_required',\n  /** The realtime transport is down; repeated every `timing.conversationPollIntervalMs`. */\n  Degraded = 'degraded',\n}\n\nexport interface CollectionResyncEventIface {\n  kind: CollectionEventKind.Resync;\n  /** Null while the signed-in user, and so the topic, could not be read yet. */\n  topic: string | null;\n  reason: CollectionResyncReason;\n}\n\n/** A realtime event of the collection topic, or a cue to re-read the collection. */\nexport type CollectionEvent = ConversationEvent | CollectionResyncEventIface;\n\nexport interface CollectionEventsOptionsIface extends SignalOptionsIface {\n  /** Keep streaming; false ends after the first resync. Defaults to true. */\n  follow?: boolean;\n  /**\n   * The signed-in user the topics are keyed by. Defaults to the user of a\n   * minted realtime session (`realtime.createSession()`).\n   */\n  userId?: string;\n}\n\nconst MAX_LOOKUP_RETRY_MS = 30_000;\n\nexport const streamCollectionEvents = (args: {\n  context: ClientContextIface;\n  topicFor: (userId: string) => string;\n  collection?: ClientCollection;\n  options: CollectionEventsOptionsIface | undefined;\n}): AsyncIterableIterator<CollectionEvent> => {\n  const follow = args.options?.follow ?? true;\n  const controller = new AbortController();\n  const signal = AbortSignal.any([\n    controller.signal,\n    args.context.closeSignal,\n    ...(args.options?.signal == null ? [] : [args.options.signal]),\n  ]);\n  let unsubscribe: (() => void) | null = null;\n  let pollTimer: ReturnType<typeof setTimeout> | null = null;\n  let lookupTimer: ReturnType<typeof setTimeout> | null = null;\n  const clearPoll = (): void => {\n    if (pollTimer != null) clearTimeout(pollTimer);\n    pollTimer = null;\n  };\n  let detachAbort: () => void = () => {};\n  let detachClose: () => void = () => {};\n  const queue = createAsyncQueue<CollectionEvent>(() => {\n    controller.abort();\n    clearPoll();\n    if (lookupTimer != null) clearTimeout(lookupTimer);\n    unsubscribe?.();\n    detachAbort();\n    detachClose();\n  });\n\n  const resync = (topic: string | null, reason: CollectionResyncReason): void => {\n    queue.push({ kind: CollectionEventKind.Resync, topic, reason });\n    if (!follow) queue.end();\n  };\n\n  const degrade = (topic: string): void => {\n    if (pollTimer != null || queue.closed()) return;\n    resync(topic, CollectionResyncReason.Degraded);\n    if (!follow || queue.closed()) return;\n    pollTimer = setTimeout(() => {\n      pollTimer = null;\n      degrade(topic);\n    }, args.context.timing.conversationPollIntervalMs);\n  };\n\n  const onFrame =\n    (topic: string) =>\n    (raw: RealtimeTransportFrameIface): void => {\n      const frame = agentRealtimeFrameSchema.safeParse(raw);\n      if (!frame.success || queue.closed()) return;\n      switch (frame.data.type) {\n        case AgentRealtimeFrameType.Event: {\n          const envelope = frame.data;\n          queue.push({\n            ...parseAgentRealtimeEvent(envelope),\n            topic: envelope.topic,\n            cursor: envelope.cursor,\n            createdAt: envelope.createdAt,\n            replayed: false,\n          });\n          return;\n        }\n        case AgentRealtimeFrameType.Subscribed:\n          clearPoll();\n          resync(topic, CollectionResyncReason.Subscribed);\n          return;\n        case AgentRealtimeFrameType.ResyncRequired:\n          resync(topic, CollectionResyncReason.ResyncRequired);\n          return;\n        case AgentRealtimeFrameType.Error:\n          if (isTerminalRealtimeError(frame.data)) {\n            queue.fail(\n              realtimeSubscriptionError({\n                topic: frame.data.topic ?? topic,\n                code: frame.data.code ?? 'unknown',\n                message: frame.data.message ?? 'Realtime subscription was refused',\n              }),\n            );\n            return;\n          }\n          // The transport resubscribes; until then the caller re-reads periodically.\n          degrade(topic);\n          return;\n        default:\n          return;\n      }\n    };\n\n  detachAbort = failOnAbort(queue, signal);\n  detachClose = failOnAbort(queue, args.context.closeSignal);\n  const userId = args.options?.userId;\n  let lookupFailures = 0;\n  const start = (): void => {\n    lookupTimer = null;\n    if (queue.closed()) return;\n    const topic =\n      userId != null\n        ? Promise.resolve(args.topicFor(userId))\n        : args.collection != null && args.context.realtimeCollectionTopic != null\n          ? args.context.realtimeCollectionTopic(args.collection)\n          : args.context.realtimeUserId().then(args.topicFor);\n    void topic.then(\n      (topic) => {\n        if (queue.closed()) return;\n        const stop = args.context.realtime().subscribe(topic, onFrame(topic));\n        if (queue.closed()) stop();\n        else unsubscribe = stop;\n      },\n      (cause: unknown) => {\n        if (queue.closed()) return;\n        if (!isRetryableClientError(cause)) {\n          queue.fail(cause);\n          return;\n        }\n        // The user lookup is unreachable: the caller re-reads meanwhile, and it is retried.\n        resync(null, CollectionResyncReason.Degraded);\n        if (queue.closed()) return;\n        const delay = Math.min(\n          MAX_LOOKUP_RETRY_MS,\n          args.context.timing.conversationPollIntervalMs * 2 ** lookupFailures,\n        );\n        lookupFailures += 1;\n        lookupTimer = setTimeout(start, delay);\n      },\n    );\n  };\n  start();\n  return queue.iterator;\n};\n"],
   "mappings": "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",
   "names": ["CollectionEventKind", "CollectionResyncReason", "topic"]
 }

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

@@ -2,8 +2,7 @@ import type { StreamTimingIface } from "./frame-stream.mjs";
 import type { FetchIface, HttpIface } from "./http.mjs";
 import type { RealtimeTransportIface } from "./realtime.mjs";
 export declare enum ClientCollection {
-    Conversations = "conversations",
-    Pending = "pending"
+    Conversations = "conversations"
 }
 /** What every API group gets from `createClient`. */
 export interface ClientContextIface {

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

@@ -1,6 +1,5 @@
 var ClientCollection = /* @__PURE__ */ ((ClientCollection2) => {
   ClientCollection2["Conversations"] = "conversations";
-  ClientCollection2["Pending"] = "pending";
   return ClientCollection2;
 })(ClientCollection || {});
 const encodePath = (segment) => encodeURIComponent(segment);

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/agent-client/context.ts"],
-  "sourcesContent": ["import type { StreamTimingIface } from \"./frame-stream.mjs\";\nimport type { FetchIface, HttpIface } from \"./http.mjs\";\nimport type { RealtimeTransportIface } from \"./realtime.mjs\";\n\nexport enum ClientCollection {\n  Conversations = 'conversations',\n  Pending = 'pending',\n}\n\n/** What every API group gets from `createClient`. */\nexport interface ClientContextIface {\n  http: HttpIface;\n  /** Aborts when `client.close()` is called; every stream ends with it. */\n  closeSignal: AbortSignal;\n  /** Presigned storage requests: no API credentials, client identity or cookies. */\n  storageFetch: FetchIface;\n  /** Resolved on first use, so clients that never stream never mint a gateway token. */\n  realtime: () => RealtimeTransportIface;\n  /** The signed-in user realtime topics are keyed by (a minted realtime session's); cached. */\n  realtimeUserId: () => Promise<string>;\n  realtimeCollectionTopic?: (collection: ClientCollection) => Promise<string>;\n  timing: StreamTimingIface;\n  /** Idempotency keys and client message ids. */\n  newKey: () => string;\n  /** Client clock in epoch ms. */\n  now: () => number;\n}\n\nexport interface SignalOptionsIface {\n  signal?: AbortSignal;\n}\n\n/** Author calls may use the wire spelling or the exported enum constant. */\nexport type EnumInput<E extends string> = E | `${E}`;\n\nexport const encodePath = (segment: string): string => encodeURIComponent(segment);\n"],
-  "mappings": "AAIO,IAAK,mBAAL,kBAAKA,sBAAL;AACL,EAAAA,kBAAA,mBAAgB;AAChB,EAAAA,kBAAA,aAAU;AAFA,SAAAA;AAAA,GAAA;AA+BL,MAAM,aAAa,CAAC,YAA4B,mBAAmB,OAAO;",
+  "sourcesContent": ["import type { StreamTimingIface } from \"./frame-stream.mjs\";\nimport type { FetchIface, HttpIface } from \"./http.mjs\";\nimport type { RealtimeTransportIface } from \"./realtime.mjs\";\n\nexport enum ClientCollection {\n  Conversations = 'conversations',\n}\n\n/** What every API group gets from `createClient`. */\nexport interface ClientContextIface {\n  http: HttpIface;\n  /** Aborts when `client.close()` is called; every stream ends with it. */\n  closeSignal: AbortSignal;\n  /** Presigned storage requests: no API credentials, client identity or cookies. */\n  storageFetch: FetchIface;\n  /** Resolved on first use, so clients that never stream never mint a gateway token. */\n  realtime: () => RealtimeTransportIface;\n  /** The signed-in user realtime topics are keyed by (a minted realtime session's); cached. */\n  realtimeUserId: () => Promise<string>;\n  realtimeCollectionTopic?: (collection: ClientCollection) => Promise<string>;\n  timing: StreamTimingIface;\n  /** Idempotency keys and client message ids. */\n  newKey: () => string;\n  /** Client clock in epoch ms. */\n  now: () => number;\n}\n\nexport interface SignalOptionsIface {\n  signal?: AbortSignal;\n}\n\n/** Author calls may use the wire spelling or the exported enum constant. */\nexport type EnumInput<E extends string> = E | `${E}`;\n\nexport const encodePath = (segment: string): string => encodeURIComponent(segment);\n"],
+  "mappings": "AAIO,IAAK,mBAAL,kBAAKA,sBAAL;AACL,EAAAA,kBAAA,mBAAgB;AADN,SAAAA;AAAA,GAAA;AA8BL,MAAM,aAAa,CAAC,YAA4B,mBAAmB,OAAO;",
   "names": ["ClientCollection"]
 }

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

@@ -1,5 +1,5 @@
 import { type ProcessInspectionRequestIface, type ProcessInspectionResultIface } from '@finalai/agent-protocol';
-import { AgentSessionState, type PostConversationEventResponseIface, type AgentRealtimeEvent, type AgentTurnPolicy, type AttachmentDownloadIface, type AttachmentUploadIface, type ContentInput, type ConversationIface, type ConversationKind, type ConversationLinkIface, type ConversationListIface, type ConversationMessageIface, type ConversationMessagesPageIface, type ConversationSandboxIface, type ConversationScheduleIface, type CreateConversationScheduleRequestIface, type DecisionsPageIface, type MessageDeliveryIface, type ParticipantIface, type ParticipantInput, type PostConversationEventRequestIface, type ReactionIface, type ReadStateIface, type RespondPendingResponseIface, type SandboxDirectoryIface, type SandboxEditorSessionIface, type SandboxFileIface, type SandboxPathIface, type SandboxPreviewType, type SandboxSearchIface, type SearchMessagesPageIface, type UpdateConversationRequestIface, type UpdateConversationScheduleRequestIface, type UpdateParticipantRequestIface, type WireFallback } from '@finalai/agent-protocol/agent-platform';
+import { AgentSessionState, type PostConversationEventResponseIface, type AgentRealtimeEvent, type AgentTurnPolicy, type AttachmentDownloadIface, type AttachmentUploadIface, type ContentInput, type ConversationIface, type ConversationKind, type ConversationLinkIface, type ConversationListIface, type ConversationMessageIface, type ConversationMessagesPageIface, type ConversationSandboxIface, type ConversationScheduleIface, type CreateConversationScheduleRequestIface, type DecisionsPageIface, type MessageDeliveryIface, type ParticipantIface, type ParticipantInput, type PostConversationEventRequestIface, type ReactionIface, type ReadStateIface, type RespondDecisionResponseIface, type SandboxDirectoryIface, type SandboxEditorSessionIface, type SandboxFileIface, type SandboxPathIface, type SandboxPreviewType, type SandboxSearchIface, type SearchMessagesPageIface, type UpdateConversationRequestIface, type UpdateConversationScheduleRequestIface, type UpdateParticipantRequestIface, type WireFallback } from '@finalai/agent-protocol/agent-platform';
 import { type CollectionEvent, type CollectionEventsOptionsIface } from "./collection-events.mjs";
 import { type ClientContextIface, type EnumInput, type SignalOptionsIface } from "./context.mjs";
 import { type RespondArgs } from "./sessions.mjs";
@@ -24,7 +24,7 @@ export interface ConversationEventMetaIface {
     /** True for messages the SDK fetched over HTTP to fill a realtime gap. */
     replayed: boolean;
 }
-/** A realtime event of the conversation topic, flattened (`event.message`, `event.pending`). */
+/** A realtime event of the conversation topic, flattened (`event.message`, `event.decision`). */
 export type ConversationEvent = AgentRealtimeEvent & ConversationEventMetaIface;
 export interface ConversationEventsOptionsIface extends SignalOptionsIface {
     /** Keep streaming; false ends once the subscription is current. Defaults to true. */
@@ -49,9 +49,10 @@ export interface ConversationEventsOptionsIface extends SignalOptionsIface {
     /**
      * Also recover what only realtime carries (default true). On every
      * (re)subscribe, resync and fallback poll the stream re-reads the open
-     * permission and elicitation requests of the conversation's agent sessions
-     * and emits replayed `acp.pending` events: `created` for an open request it
-     * has not emitted, `resolved` for one it emitted open that no longer is. And
+     * permission and elicitation decisions of the conversation's agent sessions
+     * and emits replayed `decision.changed` events: `created` for an open
+     * decision it has not emitted, `resolved` for one it emitted open that no
+     * longer is. And
      * for every turn it saw start whose session is no longer running, it emits a
      * replayed `conversation.turn.ended` (stop reason null). Turns that started
      * and ended while it was away arrive only as messages.
@@ -155,7 +156,7 @@ export interface ConversationHandleIface {
      * source is accepted once; the receipt says whether the agent was prompted.
      */
     postEvent: (event: PostConversationEventRequestIface, options?: SignalOptionsIface) => Promise<PostConversationEventResponseIface>;
-    respond: (args: RespondArgs, options?: SignalOptionsIface) => Promise<RespondPendingResponseIface>;
+    respond: (args: RespondArgs, options?: SignalOptionsIface) => Promise<RespondDecisionResponseIface>;
     /** Stops the agents' running turns in this conversation. */
     cancel: (options?: SignalOptionsIface & {
         reason?: string;
@@ -303,7 +304,7 @@ export interface ConversationAgentTurnIface {
     participantId: string;
     sessionId: string;
     state: AgentSessionState | WireFallback;
-    /** A turn is running or waiting on a pending request. */
+    /** A turn is running or waiting on a decision. */
     running: boolean;
 }
 /** Session states in which a turn is open. */
@@ -312,23 +313,41 @@ export interface OpenedConversationIface extends ConversationHandleIface {
     conversation: ConversationIface;
 }
 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).
+     * A direct chat is the caller's own and lives in their personal project.
+     */
+    projectId?: string;
     kind: EnumInput<ConversationKind>;
     title?: string;
     participants: ParticipantCreateInput[];
     turnPolicy?: EnumInput<AgentTurnPolicy>;
 }
 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.
+     */
     list: (options?: SignalOptionsIface & {
         cursor?: string;
         limit?: number;
         includeArchived?: boolean;
+        projectId?: string;
     }) => Promise<ConversationListIface>;
     /** Finds or creates the caller's direct conversation with an agent. */
     direct: (args: {
         agent: string;
     } & SignalOptionsIface) => Promise<OpenedConversationIface>;
-    /** Finds or creates the caller's Home conversation. */
-    home: (options?: 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).
+     */
+    home: (options?: SignalOptionsIface & {
+        projectId?: string;
+    }) => Promise<OpenedConversationIface>;
     create: (args: CreateConversationArgsIface) => Promise<OpenedConversationIface>;
     /** I/O-free handle. */
     get: (conversationId: string) => ConversationHandleIface;
@@ -346,10 +365,16 @@ export interface ConversationsApiIface {
      * subscription, resync and while realtime is down).
      */
     listEvents: (options?: CollectionEventsOptionsIface) => AsyncIterableIterator<CollectionEvent>;
-    /** Everything awaiting the caller's answer across conversations. */
+    /**
+     * 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: (options?: SignalOptionsIface & {
         cursor?: string;
         limit?: number;
+        projectId?: string;
     }) => Promise<DecisionsPageIface>;
 }
 /**