@finalai/agents 0.8.0

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

@@ -0,0 +1,222 @@
+import {
+  attachChannelBindingRequestSchema,
+  attachChannelBindingResponseSchema,
+  commitDefinitionRequestSchema,
+  commitResultSchema,
+  compatibilityReportSchema,
+  compileDefinitionRequestSchema,
+  compileResultSchema,
+  computerSetupGuideDetailSchema,
+  computerSetupGuideListSchema,
+  createDefinitionRequestSchema,
+  credentialPolicyPreviewSchema,
+  definitionChannelsResponseSchema,
+  definitionCloneUrlSchema,
+  definitionFilesSchema,
+  definitionListSchema,
+  definitionSchema,
+  previewCredentialPolicyRequestSchema,
+  providerListSchema,
+  publishComputerSetupGuideRequestSchema,
+  publishComputerSetupGuideResultSchema,
+  publishDefinitionRequestSchema,
+  publishResultSchema,
+  revisionDiffSchema,
+  revisionListSchema,
+  revisionSchema,
+  scheduleListSchema,
+  scheduleRunResultSchema,
+  scheduleSchema,
+  updateScheduleRequestSchema
+} from "@finalai/agent-protocol/agent-platform";
+import { encodePath } from "./context.mjs";
+import { clientError, ClientErrorCode } from "./errors.mjs";
+import { HttpMethod } from "./http.mjs";
+const definitionPath = (definition, suffix = "") => `/v1/definitions/${encodePath(definition)}${suffix}`;
+const createDefinitionsApi = ({ http }) => ({
+  testRevision: ({ definition, signal, ...value }) => http.request({
+    method: HttpMethod.Post,
+    path: definitionPath(definition, "/test-revision"),
+    body: { schema: compileDefinitionRequestSchema, value },
+    response: revisionSchema,
+    signal
+  }),
+  previewCredentialPolicy: ({ definition, signal, ...value }) => http.request({
+    method: HttpMethod.Post,
+    path: definitionPath(definition, "/credential-policy/preview"),
+    body: { schema: previewCredentialPolicyRequestSchema, value },
+    response: credentialPolicyPreviewSchema,
+    signal
+  }),
+  list: (options) => http.request({
+    method: HttpMethod.Get,
+    path: "/v1/definitions",
+    query: { cursor: options?.cursor, limit: options?.limit },
+    response: definitionListSchema,
+    signal: options?.signal
+  }),
+  create: ({ signal, ...value }) => http.request({
+    method: HttpMethod.Post,
+    path: "/v1/definitions",
+    body: { schema: createDefinitionRequestSchema, value },
+    response: definitionSchema,
+    signal
+  }),
+  get: ({ definition, signal }) => http.request({
+    method: HttpMethod.Get,
+    path: definitionPath(definition),
+    response: definitionSchema,
+    signal
+  }),
+  compile: ({ definition, signal, ...value }) => http.request({
+    method: HttpMethod.Post,
+    path: definitionPath(definition, "/compile"),
+    body: { schema: compileDefinitionRequestSchema, value },
+    response: compileResultSchema,
+    signal
+  }),
+  commit: ({ definition, signal, ...value }) => http.request({
+    method: HttpMethod.Post,
+    path: definitionPath(definition, "/commit"),
+    body: { schema: commitDefinitionRequestSchema, value },
+    response: commitResultSchema,
+    signal
+  }),
+  publish: ({ definition, signal, ...value }) => http.request({
+    method: HttpMethod.Post,
+    path: definitionPath(definition, "/publish"),
+    body: { schema: publishDefinitionRequestSchema, value },
+    response: publishResultSchema,
+    signal
+  }),
+  files: ({ definition, ref, signal }) => http.request({
+    method: HttpMethod.Get,
+    path: definitionPath(definition, "/files"),
+    query: { ref },
+    response: definitionFilesSchema,
+    signal
+  }),
+  revisions: ({ definition, cursor, signal }) => http.request({
+    method: HttpMethod.Get,
+    path: definitionPath(definition, "/revisions"),
+    query: { cursor },
+    response: revisionListSchema,
+    signal
+  }),
+  revisionDiff: ({ definition, from, to, signal }) => http.request({
+    method: HttpMethod.Get,
+    path: definitionPath(definition, "/revisions/diff"),
+    query: { from, to },
+    response: revisionDiffSchema,
+    signal
+  }),
+  compatibility: ({ definition, harness, ref, signal }) => http.request({
+    method: HttpMethod.Get,
+    path: definitionPath(definition, "/compatibility"),
+    query: { harness, ref },
+    response: compatibilityReportSchema,
+    signal
+  }),
+  channels: async ({ definition, signal }) => (await http.request({
+    method: HttpMethod.Get,
+    path: definitionPath(definition, "/channels"),
+    response: definitionChannelsResponseSchema,
+    signal
+  })).channels,
+  attachChannel: ({ definition, bindingId, conversationId, signal }) => http.request({
+    method: HttpMethod.Put,
+    path: definitionPath(definition, `/channels/${encodePath(bindingId)}/conversation`),
+    body: { schema: attachChannelBindingRequestSchema, value: { conversationId } },
+    response: attachChannelBindingResponseSchema,
+    signal
+  }),
+  archive: ({ definition, signal }) => http.request({
+    method: HttpMethod.Post,
+    path: definitionPath(definition, "/archive"),
+    response: definitionSchema,
+    signal
+  }),
+  cloneUrl: ({ definition, signal }) => http.request({
+    method: HttpMethod.Post,
+    path: definitionPath(definition, "/clone-url"),
+    response: definitionCloneUrlSchema,
+    signal
+  })
+});
+const createProvidersApi = ({ http }) => ({
+  list: async (options) => (await http.request({
+    method: HttpMethod.Get,
+    path: "/v1/providers",
+    response: providerListSchema,
+    signal: options?.signal
+  })).providers
+});
+const createComputerSetupGuidesApi = ({
+  http
+}) => ({
+  list: async (options) => (await http.request({
+    method: HttpMethod.Get,
+    path: "/v1/computer-setup-guides",
+    response: computerSetupGuideListSchema,
+    signal: options?.signal
+  })).guides,
+  get: (ref, options) => http.request({
+    method: HttpMethod.Get,
+    path: `/v1/computer-setup-guides/${encodePath(ref)}`,
+    response: computerSetupGuideDetailSchema,
+    signal: options?.signal
+  }),
+  publish: ({ signal, ...value }) => http.request({
+    method: HttpMethod.Post,
+    path: "/v1/computer-setup-guides",
+    body: { schema: publishComputerSetupGuideRequestSchema, value },
+    response: publishComputerSetupGuideResultSchema,
+    signal
+  })
+});
+const createSchedulesApi = ({ http }) => {
+  const list = async (options) => (await http.request({
+    method: HttpMethod.Get,
+    path: "/v1/schedules",
+    query: { agent: options?.agent },
+    response: scheduleListSchema,
+    signal: options?.signal
+  })).schedules;
+  const scheduleIdOf = async (args) => {
+    if ("scheduleId" in args) return args.scheduleId;
+    const found = (await list({ agent: args.agent, signal: args.signal })).find(
+      (schedule) => schedule.key === args.key
+    );
+    if (found == null) {
+      throw clientError({
+        message: `No schedule ${args.key} on agent ${args.agent}`,
+        status: 0,
+        code: ClientErrorCode.NotFound
+      });
+    }
+    return found.id;
+  };
+  return {
+    list,
+    runNow: async (args) => http.request({
+      method: HttpMethod.Post,
+      path: `/v1/schedules/${encodePath(await scheduleIdOf(args))}/run-now`,
+      response: scheduleRunResultSchema,
+      signal: args.signal
+    }),
+    update: ({ scheduleId, signal, ...value }) => http.request({
+      method: HttpMethod.Patch,
+      path: `/v1/schedules/${encodePath(scheduleId)}`,
+      body: { schema: updateScheduleRequestSchema, value },
+      response: scheduleSchema,
+      signal
+    })
+  };
+};
+export {
+  createComputerSetupGuidesApi,
+  createDefinitionsApi,
+  createProvidersApi,
+  createSchedulesApi
+};
+//# sourceMappingURL=build.mjs.map

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

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

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

@@ -0,0 +1,111 @@
+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 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";
+import { type AgentClientAuth, type FetchIface, type HeadersOption } from "./http.mjs";
+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).
+     */
+    host: string;
+    auth: AgentClientAuth;
+    /** Extra headers per request; console clients send their client identity header here. */
+    headers?: HeadersOption;
+    /** API requests (the host's routes); carries auth and caller headers. */
+    fetch?: FetchIface;
+    /**
+     * Presigned storage requests (attachment uploads). Gets only the headers the
+     * presign requires, never auth, client identity or cookies, so a storage
+     * bucket's CORS and third-party hosts see nothing of the caller. Defaults to
+     * `globalThis.fetch`; keep it free of header-injecting wrappers.
+     */
+    storageFetch?: FetchIface;
+    /** console-web and console-mobile pass their realtime clients; defaults to a gateway connection. */
+    realtime?: RealtimeTransportIface;
+    /** Seam for the default transport's gateway connection. */
+    gatewayConnect?: GatewayConnect;
+    /** Seam for stream retry timing (tests). */
+    timing?: Partial<StreamTimingIface>;
+    /** Seam for idempotency keys and client message ids; defaults to `crypto.randomUUID`. */
+    newKey?: () => string;
+    /** Seam for the client clock (conversation recovery windows). */
+    now?: () => number;
+}
+export interface AgentHandleIface {
+    slug: string;
+    info: (options?: SignalOptionsIface) => Promise<AgentInfoIface>;
+}
+export interface AgentsApiIface {
+    list: (options?: SignalOptionsIface & {
+        cursor?: string;
+        limit?: number;
+    }) => 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 & {
+        cursor?: string;
+        limit?: number;
+    }) => Promise<PersonListIface>;
+    /** Every member of the caller's organization (all pages). */
+    all: (options?: SignalOptionsIface) => Promise<PersonIface[]>;
+}
+export interface RealtimeApiIface {
+    /**
+     * Mints a gateway session (`POST /v1/realtime/session`) for the signed-in user:
+     * the gateway URL, a short-lived token, and the user id realtime topics are keyed by.
+     * Pass it as `createSession` to `createGatewayRealtimeTransport` when supplying a transport.
+     */
+    createSession: (options?: SignalOptionsIface) => Promise<RealtimeSessionResponseIface>;
+}
+export interface AgentClientIface {
+    health: (options?: SignalOptionsIface) => Promise<HealthResponseIface>;
+    agents: AgentsApiIface;
+    people: PeopleApiIface;
+    realtime: RealtimeApiIface;
+    sessions: SessionsApiIface;
+    conversations: ConversationsApiIface;
+    definitions: DefinitionsApiIface;
+    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`.
+     */
+    acp: AcpApiIface;
+    /**
+     * Ends every stream (they reject with a `client_closed` ClientError) and, when
+     * the client created its own realtime transport, closes the gateway connection
+     * and cancels its retries. A transport passed in `realtime` belongs to the
+     * caller and is left open. Idempotent.
+     */
+    close: () => void;
+    [Symbol.asyncDispose]: () => Promise<void>;
+}
+export declare const createClient: (options: CreateClientOptionsIface) => AgentClientIface;

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

@@ -0,0 +1,198 @@
+import {
+  agentInfoSchema,
+  agentListSchema,
+  agentRealtimeTopics,
+  healthResponseSchema,
+  pendingRequestListSchema,
+  personListSchema,
+  realtimeSessionResponseSchema
+} from "@finalai/agent-protocol/agent-platform";
+import { createAcpApi } from "./acp.mjs";
+import {
+  createComputerSetupGuidesApi,
+  createDefinitionsApi,
+  createProvidersApi,
+  createSchedulesApi
+} from "./build.mjs";
+import {
+  streamCollectionEvents
+} from "./collection-events.mjs";
+import {
+  ClientCollection,
+  encodePath
+} from "./context.mjs";
+import { createConversationsApi } from "./conversations.mjs";
+import { clientError, ClientErrorCode } from "./errors.mjs";
+import { defaultStreamTiming } from "./frame-stream.mjs";
+import {
+  createHttp,
+  HttpMethod
+} from "./http.mjs";
+import {
+  createGatewayRealtimeTransport
+} from "./realtime.mjs";
+import { createSessionsApi } from "./sessions.mjs";
+const createClient = (options) => {
+  const http = createHttp({
+    host: options.host,
+    auth: options.auth,
+    headers: options.headers,
+    fetch: options.fetch
+  });
+  let realtime = options.realtime ?? null;
+  let ownTransport = null;
+  const closing = new AbortController();
+  const createRealtimeSession = (sessionOptions) => http.request({
+    method: HttpMethod.Post,
+    path: "/v1/realtime/session",
+    response: realtimeSessionResponseSchema,
+    signal: sessionOptions?.signal
+  });
+  let realtimeOwner = null;
+  const realtimeOwnerSession = () => {
+    if (realtimeOwner != null) return realtimeOwner;
+    const pending = createRealtimeSession({ signal: closing.signal });
+    realtimeOwner = pending;
+    void pending.catch(() => {
+      if (realtimeOwner === pending) realtimeOwner = null;
+    });
+    return pending;
+  };
+  let realtimeUser = null;
+  const realtimeUserId = () => {
+    if (realtimeUser != null) return realtimeUser;
+    const pending = realtimeOwnerSession().then((session) => {
+      if (session.userId == null)
+        throw new Error("This client authenticates as an API-key owner, not a user");
+      return session.userId;
+    });
+    realtimeUser = pending;
+    pending.catch(() => {
+      if (realtimeUser === pending) realtimeUser = null;
+    });
+    return pending;
+  };
+  const context = {
+    http,
+    closeSignal: closing.signal,
+    realtimeUserId,
+    realtimeCollectionTopic: async (collection) => {
+      const owner = await realtimeOwnerSession();
+      if (owner.apiKeyPrincipalId != null)
+        return collection === ClientCollection.Pending ? agentRealtimeTopics.apiKeyPending(owner.apiKeyPrincipalId) : agentRealtimeTopics.apiKeyConversations(owner.apiKeyPrincipalId);
+      if (owner.userId == null) throw new Error("Realtime session has no collection owner");
+      return collection === ClientCollection.Pending ? agentRealtimeTopics.userPending(owner.userId) : agentRealtimeTopics.userConversations(owner.userId);
+    },
+    storageFetch: options.storageFetch ?? ((input, init) => globalThis.fetch(input, init)),
+    realtime: () => {
+      if (realtime != null) return realtime;
+      ownTransport = createGatewayRealtimeTransport({
+        createSession: () => createRealtimeSession(),
+        connect: options.gatewayConnect
+      });
+      if (closing.signal.aborted) ownTransport.close();
+      realtime = ownTransport;
+      return realtime;
+    },
+    timing: { ...defaultStreamTiming, ...options.timing },
+    newKey: options.newKey ?? (() => globalThis.crypto.randomUUID()),
+    now: options.now ?? Date.now
+  };
+  const close = () => {
+    if (closing.signal.aborted) return;
+    closing.abort(
+      clientError({ message: "Agent client closed", status: 0, code: ClientErrorCode.Closed })
+    );
+    ownTransport?.close();
+  };
+  return {
+    close,
+    [Symbol.asyncDispose]: async () => close(),
+    health: (healthOptions) => http.request({
+      method: HttpMethod.Get,
+      path: "/v1/health",
+      response: healthResponseSchema,
+      signal: healthOptions?.signal
+    }),
+    agents: {
+      list: (listOptions) => http.request({
+        method: HttpMethod.Get,
+        path: "/v1/agents",
+        query: { cursor: listOptions?.cursor, limit: listOptions?.limit },
+        response: agentListSchema,
+        signal: listOptions?.signal
+      }),
+      get: (slugOrId) => ({
+        slug: slugOrId,
+        info: (infoOptions) => http.request({
+          method: HttpMethod.Get,
+          path: `/v1/agents/${encodePath(slugOrId)}`,
+          response: agentInfoSchema,
+          signal: infoOptions?.signal
+        })
+      })
+    },
+    people: /* @__PURE__ */ (() => {
+      const list = (listOptions) => http.request({
+        method: HttpMethod.Get,
+        path: "/v1/people",
+        query: { cursor: listOptions?.cursor, limit: listOptions?.limit },
+        response: personListSchema,
+        signal: listOptions?.signal
+      });
+      return {
+        list,
+        all: async (allOptions) => {
+          const all = [];
+          let cursor;
+          for (; ; ) {
+            const next = await list({ cursor, signal: allOptions?.signal });
+            all.push(...next.people);
+            if (next.nextCursor == null) return all;
+            cursor = next.nextCursor;
+          }
+        }
+      };
+    })(),
+    realtime: { createSession: createRealtimeSession },
+    sessions: createSessionsApi(context),
+    conversations: createConversationsApi(context),
+    definitions: createDefinitionsApi(context),
+    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;
+          }
+        }
+      };
+    })()
+  };
+};
+export {
+  createClient
+};
+//# sourceMappingURL=client.mjs.map

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

@@ -0,0 +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      if (owner.apiKeyPrincipalId != null)\n        return collection === ClientCollection.Pending\n          ? agentRealtimeTopics.apiKeyPending(owner.apiKeyPrincipalId)\n          : agentRealtimeTopics.apiKeyConversations(owner.apiKeyPrincipalId);\n      if (owner.userId == null) throw new Error('Realtime session has no collection owner');\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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",
+  "names": []
+}

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

@@ -0,0 +1,35 @@
+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. */
+    Resync = "collection.resync"
+}
+export declare enum CollectionResyncReason {
+    Subscribed = "subscribed",
+    ResyncRequired = "resync_required",
+    /** The realtime transport is down; repeated every `timing.conversationPollIntervalMs`. */
+    Degraded = "degraded"
+}
+export interface CollectionResyncEventIface {
+    kind: CollectionEventKind.Resync;
+    /** Null while the signed-in user, and so the topic, could not be read yet. */
+    topic: string | null;
+    reason: CollectionResyncReason;
+}
+/** A realtime event of the collection topic, or a cue to re-read the collection. */
+export type CollectionEvent = ConversationEvent | CollectionResyncEventIface;
+export interface CollectionEventsOptionsIface extends SignalOptionsIface {
+    /** Keep streaming; false ends after the first resync. Defaults to true. */
+    follow?: boolean;
+    /**
+     * The signed-in user the topics are keyed by. Defaults to the user of a
+     * minted realtime session (`realtime.createSession()`).
+     */
+    userId?: string;
+}
+export declare const streamCollectionEvents: (args: {
+    context: ClientContextIface;
+    topicFor: (userId: string) => string;
+    collection?: ClientCollection;
+    options: CollectionEventsOptionsIface | undefined;
+}) => AsyncIterableIterator<CollectionEvent>;