@finalai/agents 0.13.0 → 0.14.0

package/README.md

@@ -98,7 +98,7 @@ requirements check the platform runs; anything missing throws a
 `sessions.create` and `conversations.create` take an `id` you choose, so a
 sandbox created first can be owned by the session or conversation it is for
 (`project.sandboxes.create(environment, { setup, ownedBy, idempotencyKey })`).
-`conversations.findHome()` and `findDirect({ agent })` look up without creating.
+`conversations.findDirect({ agent })` looks up without creating.
 
 ## Where things run
 

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

@@ -71,7 +71,12 @@ const createProjectChannelsApi = (args) => {
       path: installsPath,
       body: {
         schema: installChannelRequestSchema,
-        value: { ...install, agents: { provide: provideDocumentOf(agents.provide) } }
+        value: {
+          ...install,
+          channel: referenceOf(install.channel),
+          agent: referenceOf(install.agent),
+          agents: { provide: provideDocumentOf(agents.provide) }
+        }
       },
       response: installedChannelResponseSchema,
       signal
@@ -85,6 +90,7 @@ const createProjectChannelsApi = (args) => {
     })).bindings
   };
 };
+const referenceOf = (reference) => "hash" in reference ? { hash: reference.hash } : { name: reference.name };
 const createChannelBindingsApi = (ctx) => ({
   get: async ({ bindingId, signal }) => (await ctx.http.request({
     method: HttpMethod.Get,
@@ -99,6 +105,8 @@ const createChannelBindingsApi = (ctx) => ({
       schema: updateChannelBindingRequestSchema,
       value: {
         ...change,
+        ...change.channel == null ? {} : { channel: referenceOf(change.channel) },
+        ...change.agent == null ? {} : { agent: referenceOf(change.agent) },
         ...agents == null ? {} : { agents: { provide: provideDocumentOf(agents.provide) } }
       }
     },

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/agent-client/channels.ts"],
-  "sourcesContent": ["import {\n  channelAppListSchema,\n  channelAppResponseSchema,\n  channelBindingListSchema,\n  channelBindingResponseSchema,\n  channelIdentityLinkListSchema,\n  channelIdentityLinkProgressSchema,\n  channelPlaceConnectionResponseSchema,\n  channelPlacesResponseSchema,\n  channelSchema,\n  channelTenantTicketSchema,\n  channelTicketSchema,\n  completeChannelIdentityLinkRequestSchema,\n  completeChannelPlaceConnectionRequestSchema,\n  createChannelAppRequestSchema,\n  installChannelRequestSchema,\n  installedChannelResponseSchema,\n  okResponseSchema,\n  publishChannelRequestSchema,\n  publishChannelResponseSchema,\n  uninstallChannelBindingResponseSchema,\n  updateChannelAppRequestSchema,\n  updateChannelBindingRequestSchema,\n  updateChannelIdentityLinkRequestSchema,\n  type ActorInputIface,\n  type ChannelAppIface,\n  type ChannelBindingIface,\n  type ChannelIdentityLinkIface,\n  type ChannelIdentityLinkProgressIface,\n  type ChannelIface,\n  type ChannelSeenPlaceIface,\n  type ChannelTenantTicketIface,\n  type ChannelTicketIface,\n  type CompleteChannelIdentityLinkRequestIface,\n  type CompleteChannelPlaceConnectionRequestIface,\n  type CreateChannelAppRequestIface,\n  type DefinitionVisibility,\n  type InstallChannelRequestIface,\n  type InstalledChannelIface,\n  type PublishChannelResponseIface,\n  type UpdateChannelAppRequestIface,\n  type UpdateChannelBindingRequestIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport {\n  encodePath,\n  type ClientContextIface,\n  type EnumInput,\n  type SignalOptionsIface,\n} from \"./context.mjs\";\nimport { clientError, ClientErrorCode } from \"./errors.mjs\";\nimport { HttpMethod } from \"./http.mjs\";\nimport { provideDocumentOf, type ProvideIface } from \"./provide.mjs\";\n\n// Channels connect a provider (Slack, email, a webhook) to a project's chats.\n// A channel is one self-contained module, published by name and stored by\n// content hash; its handlers always run on Final's serverless runtime. An\n// install (a channel binding) runs a channel in a project, a channel app holds\n// the provider application's credentials, and tickets let the installer's own\n// pages link people and connect places.\n\n/** A channel value's source, as `channels.publish({ channel })` sends it. */\nexport interface ChannelSourceIface {\n  source: string;\n  export?: string;\n}\n\n/** How the SDK turns a channel value into its source; a seam over `@finalai/agent-definition`. */\nexport type ChannelSourceOf = (channel: object) => ChannelSourceIface;\n\nexport type PublishChannelArgsIface = {\n  name: string;\n  /** `public` also makes the name public under the project's publisher handle. */\n  visibility?: EnumInput<DefinitionVisibility>;\n  /** A channel app of this project that installs of the publication use unless they bring their own. */\n  app?: string;\n} & SignalOptionsIface &\n  ({ channel: object } | { source: string; export?: string });\n\nexport type InstallChannelArgsIface = Omit<InstallChannelRequestIface, 'agents'> & {\n  /** What the agent gets in every chat this install creates. */\n  agents: { provide: ProvideIface };\n} & SignalOptionsIface;\n\nexport type UpdateChannelBindingArgsIface = Omit<UpdateChannelBindingRequestIface, 'agents'> & {\n  bindingId: string;\n  agents?: { provide: ProvideIface };\n} & SignalOptionsIface;\n\nexport interface ProjectChannelsApiIface {\n  publish: (args: PublishChannelArgsIface) => Promise<PublishChannelResponseIface>;\n  get: (\n    selector: ({ name: string } | { hash: string }) & SignalOptionsIface,\n  ) => Promise<ChannelIface>;\n  /**\n   * Installs a channel in the project. Fails with `requirements_unmet`, and\n   * installs nothing, unless `agents.provide` meets the agent's requirements\n   * and the channel's app requirement is met.\n   */\n  install: (args: InstallChannelArgsIface) => Promise<InstalledChannelIface>;\n  /** The project's installs, newest first. */\n  installs: (\n    options?: SignalOptionsIface & { includeArchived?: boolean },\n  ) => Promise<ChannelBindingIface[]>;\n}\n\nexport interface ChannelBindingsApiIface {\n  /** One install, with whether its agent's requirements are met now. */\n  get: (args: { bindingId: string } & SignalOptionsIface) => Promise<ChannelBindingIface>;\n  /** Fails with `revision_conflict` unless `revision` is the one last read, and with `requirements_unmet` when the change would leave them unmet. */\n  update: (args: UpdateChannelBindingArgsIface) => Promise<InstalledChannelIface>;\n  /** Ends the install: its connected places, tenants, listeners and the links made through it. */\n  uninstall: (\n    args: { bindingId: string } & SignalOptionsIface,\n  ) => Promise<{ archivedAt: string | null }>;\n  /** A single-use link that installs the provider app for one tenant (a workspace, a server). */\n  tenantTicket: (\n    args: { bindingId: string } & SignalOptionsIface,\n  ) => Promise<ChannelTenantTicketIface>;\n  /** The provider places the install has seen. */\n  places: (args: { bindingId: string } & SignalOptionsIface) => Promise<ChannelSeenPlaceIface[]>;\n}\n\nexport interface ChannelAppsApiIface {\n  /** Registers the provider application's credentials; secret values stay project secrets. */\n  create: (args: CreateChannelAppRequestIface & SignalOptionsIface) => Promise<ChannelAppIface>;\n  /** The apps of the project and its ancestors. */\n  list: (options?: SignalOptionsIface) => Promise<ChannelAppIface[]>;\n  update: (\n    args: UpdateChannelAppRequestIface & { id: string } & SignalOptionsIface,\n  ) => Promise<ChannelAppIface>;\n  /** Refused while a live install or publication uses the app. */\n  delete: (args: { id: string } & SignalOptionsIface) => Promise<void>;\n}\n\n/** The actor an API key or app acts for, by its external id. */\nexport interface ActorOptionIface {\n  actor?: string;\n}\n\nexport interface ChannelTicketsApiIface {\n  /** What a ticket from an installer's link or connect page is for. */\n  get: (\n    args: { ticket: string } & ActorOptionIface & SignalOptionsIface,\n  ) => Promise<ChannelTicketIface>;\n  /** Links the ticket's channel account to the caller's person, or to `actor`. */\n  link: (\n    args: { ticket: string } & CompleteChannelIdentityLinkRequestIface & SignalOptionsIface,\n  ) => Promise<ChannelIdentityLinkProgressIface>;\n  /** Connects the ticket's place to a conversation the caller manages. */\n  connect: (\n    args: { ticket: string } & CompleteChannelPlaceConnectionRequestIface & SignalOptionsIface,\n  ) => Promise<{ routeId: string }>;\n}\n\nexport interface IdentityLinksApiIface {\n  /** The channel accounts linked to the caller's person, or to `actor`. */\n  list: (options?: ActorOptionIface & SignalOptionsIface) => Promise<ChannelIdentityLinkIface[]>;\n  /** Chooses where the person's direct messages to the channel land. */\n  update: (\n    args: {\n      id: string;\n      directConversationId: string | null;\n      actor?: ActorInputIface;\n    } & SignalOptionsIface,\n  ) => Promise<void>;\n  /** Unlinks the account. */\n  delete: (args: { id: string } & ActorOptionIface & SignalOptionsIface) => Promise<void>;\n}\n\nconst channelsPath = (projectId: string, suffix: string): string =>\n  `/v1/projects/${encodePath(projectId)}/channels${suffix}`;\n\nconst bindingPath = (bindingId: string, suffix = ''): string =>\n  `/v1/channel-bindings/${encodePath(bindingId)}${suffix}`;\n\nexport const createProjectChannelsApi = (args: {\n  context: ClientContextIface;\n  projectId: string;\n  sourceOf: ChannelSourceOf;\n}): ProjectChannelsApiIface => {\n  const { http } = args.context;\n  const installsPath = `/v1/projects/${encodePath(args.projectId)}/channel-bindings`;\n  return {\n    publish: (publish) => {\n      const source: ChannelSourceIface =\n        'channel' in publish\n          ? args.sourceOf(publish.channel)\n          : {\n              source: publish.source,\n              ...(publish.export == null ? {} : { export: publish.export }),\n            };\n      return http.request({\n        method: HttpMethod.Post,\n        path: channelsPath(args.projectId, '/publish'),\n        body: {\n          schema: publishChannelRequestSchema,\n          value: {\n            name: publish.name,\n            ...source,\n            visibility: publish.visibility,\n            app: publish.app,\n          },\n        },\n        response: publishChannelResponseSchema,\n        signal: publish.signal,\n      });\n    },\n    get: ({ signal, ...selector }) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: channelsPath(args.projectId, '/lookup'),\n        query: {\n          name: 'name' in selector ? selector.name : undefined,\n          hash: 'hash' in selector ? selector.hash : undefined,\n        },\n        response: channelSchema,\n        signal,\n      }),\n    install: ({ signal, agents, ...install }) =>\n      http.request({\n        method: HttpMethod.Post,\n        path: installsPath,\n        body: {\n          schema: installChannelRequestSchema,\n          value: { ...install, agents: { provide: provideDocumentOf(agents.provide) } },\n        },\n        response: installedChannelResponseSchema,\n        signal,\n      }),\n    installs: async (options) =>\n      (\n        await http.request({\n          method: HttpMethod.Get,\n          path: installsPath,\n          query: { includeArchived: options?.includeArchived === true ? 'true' : undefined },\n          response: channelBindingListSchema,\n          signal: options?.signal,\n        })\n      ).bindings,\n  };\n};\n\nexport const createChannelBindingsApi = (ctx: ClientContextIface): ChannelBindingsApiIface => ({\n  get: async ({ bindingId, signal }) =>\n    (\n      await ctx.http.request({\n        method: HttpMethod.Get,\n        path: bindingPath(bindingId),\n        response: channelBindingResponseSchema,\n        signal,\n      })\n    ).binding,\n  update: ({ bindingId, signal, agents, ...change }) =>\n    ctx.http.request({\n      method: HttpMethod.Patch,\n      path: bindingPath(bindingId),\n      body: {\n        schema: updateChannelBindingRequestSchema,\n        value: {\n          ...change,\n          ...(agents == null ? {} : { agents: { provide: provideDocumentOf(agents.provide) } }),\n        },\n      },\n      response: installedChannelResponseSchema,\n      signal,\n    }),\n  uninstall: ({ bindingId, signal }) =>\n    ctx.http.request({\n      method: HttpMethod.Delete,\n      path: bindingPath(bindingId),\n      response: uninstallChannelBindingResponseSchema,\n      signal,\n    }),\n  tenantTicket: ({ bindingId, signal }) =>\n    ctx.http.request({\n      method: HttpMethod.Post,\n      path: bindingPath(bindingId, '/tenant-tickets'),\n      response: channelTenantTicketSchema,\n      signal,\n    }),\n  places: async ({ bindingId, signal }) =>\n    (\n      await ctx.http.request({\n        method: HttpMethod.Get,\n        path: bindingPath(bindingId, '/places'),\n        response: channelPlacesResponseSchema,\n        signal,\n      })\n    ).places,\n});\n\nexport const createChannelAppsApi = (args: {\n  context: ClientContextIface;\n  projectId: string;\n}): ChannelAppsApiIface => {\n  const { http } = args.context;\n  const appPath = (id: string): string => `/v1/channel-apps/${encodePath(id)}`;\n  return {\n    create: async ({ signal, ...value }) =>\n      (\n        await http.request({\n          method: HttpMethod.Post,\n          path: `/v1/projects/${encodePath(args.projectId)}/channel-apps`,\n          body: { schema: createChannelAppRequestSchema, value },\n          response: channelAppResponseSchema,\n          signal,\n        })\n      ).app,\n    list: async (options) =>\n      (\n        await http.request({\n          method: HttpMethod.Get,\n          path: `/v1/projects/${encodePath(args.projectId)}/channel-apps`,\n          response: channelAppListSchema,\n          signal: options?.signal,\n        })\n      ).apps,\n    update: async ({ id, signal, ...value }) =>\n      (\n        await http.request({\n          method: HttpMethod.Patch,\n          path: appPath(id),\n          body: { schema: updateChannelAppRequestSchema, value },\n          response: channelAppResponseSchema,\n          signal,\n        })\n      ).app,\n    delete: async ({ id, signal }) => {\n      await http.request({\n        method: HttpMethod.Delete,\n        path: appPath(id),\n        response: okResponseSchema,\n        signal,\n      });\n    },\n  };\n};\n\nexport const createChannelTicketsApi = (ctx: ClientContextIface): ChannelTicketsApiIface => {\n  const ticketPath = (ticket: string, suffix = ''): string =>\n    `/v1/channel-tickets/${encodePath(ticket)}${suffix}`;\n  return {\n    get: ({ ticket, actor, signal }) =>\n      ctx.http.request({\n        method: HttpMethod.Get,\n        path: ticketPath(ticket),\n        query: { actor },\n        response: channelTicketSchema,\n        signal,\n      }),\n    link: ({ ticket, signal, ...value }) =>\n      ctx.http.request({\n        method: HttpMethod.Post,\n        path: ticketPath(ticket, '/identity-link'),\n        body: { schema: completeChannelIdentityLinkRequestSchema, value },\n        response: channelIdentityLinkProgressSchema,\n        signal,\n      }),\n    connect: ({ ticket, signal, ...value }) =>\n      ctx.http.request({\n        method: HttpMethod.Post,\n        path: ticketPath(ticket, '/place-connection'),\n        body: { schema: completeChannelPlaceConnectionRequestSchema, value },\n        response: channelPlaceConnectionResponseSchema,\n        signal,\n      }),\n  };\n};\n\nexport const createIdentityLinksApi = (ctx: ClientContextIface): IdentityLinksApiIface => {\n  const linksPath = (suffix = ''): string => `/v1/people/me/identity-links${suffix}`;\n  return {\n    list: async (options) =>\n      (\n        await ctx.http.request({\n          method: HttpMethod.Get,\n          path: linksPath(),\n          query: { actor: options?.actor },\n          response: channelIdentityLinkListSchema,\n          signal: options?.signal,\n        })\n      ).links,\n    update: async ({ id, signal, ...value }) => {\n      await ctx.http.request({\n        method: HttpMethod.Patch,\n        path: linksPath(`/${encodePath(id)}`),\n        body: { schema: updateChannelIdentityLinkRequestSchema, value },\n        response: okResponseSchema,\n        signal,\n      });\n    },\n    delete: async ({ id, actor, signal }) => {\n      await ctx.http.request({\n        method: HttpMethod.Delete,\n        path: linksPath(`/${encodePath(id)}`),\n        query: { actor },\n        response: okResponseSchema,\n        signal,\n      });\n    },\n  };\n};\n\n/** The default `ChannelSourceOf` when no codec is available. */\nexport const noChannelSource: ChannelSourceOf = () => {\n  throw clientError({\n    message: 'Publish a channel as `source`: this build cannot capture a channel value',\n    status: 0,\n    code: ClientErrorCode.InvalidRequest,\n  });\n};\n"],
-  "mappings": "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",
+  "sourcesContent": ["import {\n  channelAppListSchema,\n  channelAppResponseSchema,\n  channelBindingListSchema,\n  channelBindingResponseSchema,\n  channelIdentityLinkListSchema,\n  channelIdentityLinkProgressSchema,\n  channelPlaceConnectionResponseSchema,\n  channelPlacesResponseSchema,\n  channelSchema,\n  channelTenantTicketSchema,\n  channelTicketSchema,\n  completeChannelIdentityLinkRequestSchema,\n  completeChannelPlaceConnectionRequestSchema,\n  createChannelAppRequestSchema,\n  installChannelRequestSchema,\n  installedChannelResponseSchema,\n  okResponseSchema,\n  publishChannelRequestSchema,\n  publishChannelResponseSchema,\n  uninstallChannelBindingResponseSchema,\n  updateChannelAppRequestSchema,\n  updateChannelBindingRequestSchema,\n  updateChannelIdentityLinkRequestSchema,\n  type ActorInputIface,\n  type ChannelAppIface,\n  type ChannelBindingIface,\n  type ChannelIdentityLinkIface,\n  type ChannelIdentityLinkProgressIface,\n  type ChannelIface,\n  type ChannelSeenPlaceIface,\n  type ChannelTenantTicketIface,\n  type ChannelTicketIface,\n  type CompleteChannelIdentityLinkRequestIface,\n  type CompleteChannelPlaceConnectionRequestIface,\n  type CreateChannelAppRequestIface,\n  type DefinitionVisibility,\n  type InstallChannelRequestIface,\n  type InstalledChannelIface,\n  type PublishChannelResponseIface,\n  type UpdateChannelAppRequestIface,\n  type UpdateChannelBindingRequestIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport {\n  encodePath,\n  type ClientContextIface,\n  type EnumInput,\n  type SignalOptionsIface,\n} from \"./context.mjs\";\nimport { clientError, ClientErrorCode } from \"./errors.mjs\";\nimport { HttpMethod } from \"./http.mjs\";\nimport { provideDocumentOf, type ProvideIface } from \"./provide.mjs\";\n\n// Channels connect a provider (Slack, email, a webhook) to a project's chats.\n// A channel is one self-contained module, published by name and stored by\n// content hash; its handlers always run on Final's serverless runtime. An\n// install (a channel binding) runs a channel in a project, a channel app holds\n// the provider application's credentials, and tickets let the installer's own\n// pages link people and connect places.\n\n/** A channel value's source, as `channels.publish({ channel })` sends it. */\nexport interface ChannelSourceIface {\n  source: string;\n  export?: string;\n}\n\n/** How the SDK turns a channel value into its source; a seam over `@finalai/agent-definition`. */\nexport type ChannelSourceOf = (channel: object) => ChannelSourceIface;\n\nexport type PublishChannelArgsIface = {\n  name: string;\n  /** `public` also makes the name public under the project's publisher handle. */\n  visibility?: EnumInput<DefinitionVisibility>;\n  /** A channel app of this project that installs of the publication use unless they bring their own. */\n  app?: string;\n} & SignalOptionsIface &\n  ({ channel: object } | { source: string; export?: string });\n\nexport type InstallChannelArgsIface = Omit<InstallChannelRequestIface, 'agents'> & {\n  /** What the agent gets in every chat this install creates. */\n  agents: { provide: ProvideIface };\n} & SignalOptionsIface;\n\nexport type UpdateChannelBindingArgsIface = Omit<UpdateChannelBindingRequestIface, 'agents'> & {\n  bindingId: string;\n  agents?: { provide: ProvideIface };\n} & SignalOptionsIface;\n\nexport interface ProjectChannelsApiIface {\n  publish: (args: PublishChannelArgsIface) => Promise<PublishChannelResponseIface>;\n  get: (\n    selector: ({ name: string } | { hash: string }) & SignalOptionsIface,\n  ) => Promise<ChannelIface>;\n  /**\n   * Installs a channel in the project. Fails with `requirements_unmet`, and\n   * installs nothing, unless `agents.provide` meets the agent's requirements\n   * and the channel's app requirement is met.\n   */\n  install: (args: InstallChannelArgsIface) => Promise<InstalledChannelIface>;\n  /** The project's installs, newest first. */\n  installs: (\n    options?: SignalOptionsIface & { includeArchived?: boolean },\n  ) => Promise<ChannelBindingIface[]>;\n}\n\nexport interface ChannelBindingsApiIface {\n  /** One install, with whether its agent's requirements are met now. */\n  get: (args: { bindingId: string } & SignalOptionsIface) => Promise<ChannelBindingIface>;\n  /** Fails with `revision_conflict` unless `revision` is the one last read, and with `requirements_unmet` when the change would leave them unmet. */\n  update: (args: UpdateChannelBindingArgsIface) => Promise<InstalledChannelIface>;\n  /** Ends the install: its connected places, tenants, listeners and the links made through it. */\n  uninstall: (\n    args: { bindingId: string } & SignalOptionsIface,\n  ) => Promise<{ archivedAt: string | null }>;\n  /** A single-use link that installs the provider app for one tenant (a workspace, a server). */\n  tenantTicket: (\n    args: { bindingId: string } & SignalOptionsIface,\n  ) => Promise<ChannelTenantTicketIface>;\n  /** The provider places the install has seen. */\n  places: (args: { bindingId: string } & SignalOptionsIface) => Promise<ChannelSeenPlaceIface[]>;\n}\n\nexport interface ChannelAppsApiIface {\n  /** Registers the provider application's credentials; secret values stay project secrets. */\n  create: (args: CreateChannelAppRequestIface & SignalOptionsIface) => Promise<ChannelAppIface>;\n  /** The apps of the project and its ancestors. */\n  list: (options?: SignalOptionsIface) => Promise<ChannelAppIface[]>;\n  update: (\n    args: UpdateChannelAppRequestIface & { id: string } & SignalOptionsIface,\n  ) => Promise<ChannelAppIface>;\n  /** Refused while a live install or publication uses the app. */\n  delete: (args: { id: string } & SignalOptionsIface) => Promise<void>;\n}\n\n/** The actor an API key or app acts for, by its external id. */\nexport interface ActorOptionIface {\n  actor?: string;\n}\n\nexport interface ChannelTicketsApiIface {\n  /** What a ticket from an installer's link or connect page is for. */\n  get: (\n    args: { ticket: string } & ActorOptionIface & SignalOptionsIface,\n  ) => Promise<ChannelTicketIface>;\n  /** Links the ticket's channel account to the caller's person, or to `actor`. */\n  link: (\n    args: { ticket: string } & CompleteChannelIdentityLinkRequestIface & SignalOptionsIface,\n  ) => Promise<ChannelIdentityLinkProgressIface>;\n  /** Connects the ticket's place to a conversation the caller manages. */\n  connect: (\n    args: { ticket: string } & CompleteChannelPlaceConnectionRequestIface & SignalOptionsIface,\n  ) => Promise<{ routeId: string }>;\n}\n\nexport interface IdentityLinksApiIface {\n  /** The channel accounts linked to the caller's person, or to `actor`. */\n  list: (options?: ActorOptionIface & SignalOptionsIface) => Promise<ChannelIdentityLinkIface[]>;\n  /** Chooses where the person's direct messages to the channel land. */\n  update: (\n    args: {\n      id: string;\n      directConversationId: string | null;\n      actor?: ActorInputIface;\n    } & SignalOptionsIface,\n  ) => Promise<void>;\n  /** Unlinks the account. */\n  delete: (args: { id: string } & ActorOptionIface & SignalOptionsIface) => Promise<void>;\n}\n\nconst channelsPath = (projectId: string, suffix: string): string =>\n  `/v1/projects/${encodePath(projectId)}/channels${suffix}`;\n\nconst bindingPath = (bindingId: string, suffix = ''): string =>\n  `/v1/channel-bindings/${encodePath(bindingId)}${suffix}`;\n\nexport const createProjectChannelsApi = (args: {\n  context: ClientContextIface;\n  projectId: string;\n  sourceOf: ChannelSourceOf;\n}): ProjectChannelsApiIface => {\n  const { http } = args.context;\n  const installsPath = `/v1/projects/${encodePath(args.projectId)}/channel-bindings`;\n  return {\n    publish: (publish) => {\n      const source: ChannelSourceIface =\n        'channel' in publish\n          ? args.sourceOf(publish.channel)\n          : {\n              source: publish.source,\n              ...(publish.export == null ? {} : { export: publish.export }),\n            };\n      return http.request({\n        method: HttpMethod.Post,\n        path: channelsPath(args.projectId, '/publish'),\n        body: {\n          schema: publishChannelRequestSchema,\n          value: {\n            name: publish.name,\n            ...source,\n            visibility: publish.visibility,\n            app: publish.app,\n          },\n        },\n        response: publishChannelResponseSchema,\n        signal: publish.signal,\n      });\n    },\n    get: ({ signal, ...selector }) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: channelsPath(args.projectId, '/lookup'),\n        query: {\n          name: 'name' in selector ? selector.name : undefined,\n          hash: 'hash' in selector ? selector.hash : undefined,\n        },\n        response: channelSchema,\n        signal,\n      }),\n    install: ({ signal, agents, ...install }) =>\n      http.request({\n        method: HttpMethod.Post,\n        path: installsPath,\n        body: {\n          schema: installChannelRequestSchema,\n          value: {\n            ...install,\n            channel: referenceOf(install.channel),\n            agent: referenceOf(install.agent),\n            agents: { provide: provideDocumentOf(agents.provide) },\n          },\n        },\n        response: installedChannelResponseSchema,\n        signal,\n      }),\n    installs: async (options) =>\n      (\n        await http.request({\n          method: HttpMethod.Get,\n          path: installsPath,\n          query: { includeArchived: options?.includeArchived === true ? 'true' : undefined },\n          response: channelBindingListSchema,\n          signal: options?.signal,\n        })\n      ).bindings,\n  };\n};\n\n// A channel or agent reference as the wire takes it: a published value (with its id, name and\n// more) narrows to its hash, which pins what was read.\nconst referenceOf = (reference: { hash: string } | { name: string }) =>\n  'hash' in reference ? { hash: reference.hash } : { name: reference.name };\n\nexport const createChannelBindingsApi = (ctx: ClientContextIface): ChannelBindingsApiIface => ({\n  get: async ({ bindingId, signal }) =>\n    (\n      await ctx.http.request({\n        method: HttpMethod.Get,\n        path: bindingPath(bindingId),\n        response: channelBindingResponseSchema,\n        signal,\n      })\n    ).binding,\n  update: ({ bindingId, signal, agents, ...change }) =>\n    ctx.http.request({\n      method: HttpMethod.Patch,\n      path: bindingPath(bindingId),\n      body: {\n        schema: updateChannelBindingRequestSchema,\n        value: {\n          ...change,\n          ...(change.channel == null ? {} : { channel: referenceOf(change.channel) }),\n          ...(change.agent == null ? {} : { agent: referenceOf(change.agent) }),\n          ...(agents == null ? {} : { agents: { provide: provideDocumentOf(agents.provide) } }),\n        },\n      },\n      response: installedChannelResponseSchema,\n      signal,\n    }),\n  uninstall: ({ bindingId, signal }) =>\n    ctx.http.request({\n      method: HttpMethod.Delete,\n      path: bindingPath(bindingId),\n      response: uninstallChannelBindingResponseSchema,\n      signal,\n    }),\n  tenantTicket: ({ bindingId, signal }) =>\n    ctx.http.request({\n      method: HttpMethod.Post,\n      path: bindingPath(bindingId, '/tenant-tickets'),\n      response: channelTenantTicketSchema,\n      signal,\n    }),\n  places: async ({ bindingId, signal }) =>\n    (\n      await ctx.http.request({\n        method: HttpMethod.Get,\n        path: bindingPath(bindingId, '/places'),\n        response: channelPlacesResponseSchema,\n        signal,\n      })\n    ).places,\n});\n\nexport const createChannelAppsApi = (args: {\n  context: ClientContextIface;\n  projectId: string;\n}): ChannelAppsApiIface => {\n  const { http } = args.context;\n  const appPath = (id: string): string => `/v1/channel-apps/${encodePath(id)}`;\n  return {\n    create: async ({ signal, ...value }) =>\n      (\n        await http.request({\n          method: HttpMethod.Post,\n          path: `/v1/projects/${encodePath(args.projectId)}/channel-apps`,\n          body: { schema: createChannelAppRequestSchema, value },\n          response: channelAppResponseSchema,\n          signal,\n        })\n      ).app,\n    list: async (options) =>\n      (\n        await http.request({\n          method: HttpMethod.Get,\n          path: `/v1/projects/${encodePath(args.projectId)}/channel-apps`,\n          response: channelAppListSchema,\n          signal: options?.signal,\n        })\n      ).apps,\n    update: async ({ id, signal, ...value }) =>\n      (\n        await http.request({\n          method: HttpMethod.Patch,\n          path: appPath(id),\n          body: { schema: updateChannelAppRequestSchema, value },\n          response: channelAppResponseSchema,\n          signal,\n        })\n      ).app,\n    delete: async ({ id, signal }) => {\n      await http.request({\n        method: HttpMethod.Delete,\n        path: appPath(id),\n        response: okResponseSchema,\n        signal,\n      });\n    },\n  };\n};\n\nexport const createChannelTicketsApi = (ctx: ClientContextIface): ChannelTicketsApiIface => {\n  const ticketPath = (ticket: string, suffix = ''): string =>\n    `/v1/channel-tickets/${encodePath(ticket)}${suffix}`;\n  return {\n    get: ({ ticket, actor, signal }) =>\n      ctx.http.request({\n        method: HttpMethod.Get,\n        path: ticketPath(ticket),\n        query: { actor },\n        response: channelTicketSchema,\n        signal,\n      }),\n    link: ({ ticket, signal, ...value }) =>\n      ctx.http.request({\n        method: HttpMethod.Post,\n        path: ticketPath(ticket, '/identity-link'),\n        body: { schema: completeChannelIdentityLinkRequestSchema, value },\n        response: channelIdentityLinkProgressSchema,\n        signal,\n      }),\n    connect: ({ ticket, signal, ...value }) =>\n      ctx.http.request({\n        method: HttpMethod.Post,\n        path: ticketPath(ticket, '/place-connection'),\n        body: { schema: completeChannelPlaceConnectionRequestSchema, value },\n        response: channelPlaceConnectionResponseSchema,\n        signal,\n      }),\n  };\n};\n\nexport const createIdentityLinksApi = (ctx: ClientContextIface): IdentityLinksApiIface => {\n  const linksPath = (suffix = ''): string => `/v1/people/me/identity-links${suffix}`;\n  return {\n    list: async (options) =>\n      (\n        await ctx.http.request({\n          method: HttpMethod.Get,\n          path: linksPath(),\n          query: { actor: options?.actor },\n          response: channelIdentityLinkListSchema,\n          signal: options?.signal,\n        })\n      ).links,\n    update: async ({ id, signal, ...value }) => {\n      await ctx.http.request({\n        method: HttpMethod.Patch,\n        path: linksPath(`/${encodePath(id)}`),\n        body: { schema: updateChannelIdentityLinkRequestSchema, value },\n        response: okResponseSchema,\n        signal,\n      });\n    },\n    delete: async ({ id, actor, signal }) => {\n      await ctx.http.request({\n        method: HttpMethod.Delete,\n        path: linksPath(`/${encodePath(id)}`),\n        query: { actor },\n        response: okResponseSchema,\n        signal,\n      });\n    },\n  };\n};\n\n/** The default `ChannelSourceOf` when no codec is available. */\nexport const noChannelSource: ChannelSourceOf = () => {\n  throw clientError({\n    message: 'Publish a channel as `source`: this build cannot capture a channel value',\n    status: 0,\n    code: ClientErrorCode.InvalidRequest,\n  });\n};\n"],
+  "mappings": "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",
   "names": []
 }

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

@@ -1,4 +1,4 @@
-import { type AgentListIface, type DecisionIface, type HealthResponseIface, type InferenceOfferingIface, type PersonIface, type PersonListIface, type PlatformIdentityExchangeRequestIface, type PlatformIdentityExchangeResponseIface, type RealtimeSessionResponseIface } from '@finalai/agent-protocol/agent-platform';
+import { type AgentListIface, type AgentSummaryIface, type DecisionIface, type HealthResponseIface, type InferenceOfferingIface, type PersonIface, type PersonListIface, type PlatformIdentityExchangeRequestIface, type PlatformIdentityExchangeResponseIface, type RealtimeSessionResponseIface } from '@finalai/agent-protocol/agent-platform';
 import { type AcpApiIface } from "./acp.mjs";
 import type { AgentValueCodecIface } from "./agent-input.mjs";
 import { type ChannelBindingsApiIface, type ChannelSourceOf, type ChannelTicketsApiIface, type IdentityLinksApiIface } from "./channels.mjs";
@@ -11,6 +11,7 @@ import { type GatewayConnect, type RealtimeTransportIface } from "./realtime.mjs
 import type { LocalComputeIface, LocalHostSocketIface } from "./local-host.mjs";
 import { type ProjectClientIface } from "./project.mjs";
 import { type ProjectsApiIface } from "./projects.mjs";
+import { type OrganizationApiIface } from "./organization.mjs";
 import { type PublishersApiIface } from "./publishers.mjs";
 import { type SessionsApiIface } from "./sessions.mjs";
 /** Final's agents API. */
@@ -74,6 +75,13 @@ export interface AgentsApiIface {
         limit?: number;
         projectId?: string;
     }) => Promise<AgentListIface>;
+    /**
+     * One agent the caller can use, by id, in whichever project owns it; also one that was never
+     * published (`hash` and `revisionId` are null). Archived agents are not found.
+     */
+    get: (args: {
+        id: string;
+    } & SignalOptionsIface) => Promise<AgentSummaryIface>;
 }
 export interface PeopleApiIface {
     /** One page of the caller's organization members, by name; pass `nextCursor` as `cursor` for the next. */
@@ -141,6 +149,8 @@ export interface AgentClientIface {
     platformIdentity: PlatformIdentityApiIface;
     decisions: DecisionsApiIface;
     health: (options?: SignalOptionsIface) => Promise<HealthResponseIface>;
+    /** The caller's organization: model credentials, budgets and policies. */
+    organization: OrganizationApiIface;
     agents: AgentsApiIface;
     people: PeopleApiIface;
     realtime: RealtimeApiIface;

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

@@ -1,6 +1,7 @@
 import {
   agentListSchema,
   agentRealtimeTopics,
+  agentSummarySchema,
   decisionResponseSchema,
   healthResponseSchema,
   inferenceOfferingSchema,
@@ -38,6 +39,7 @@ import {
 } from "./realtime.mjs";
 import { createProjectClient } from "./project.mjs";
 import { createProjectsApi } from "./projects.mjs";
+import { createOrganizationApi } from "./organization.mjs";
 import { createPublishersApi } from "./publishers.mjs";
 import { createSessionsApi } from "./sessions.mjs";
 const DEFAULT_AGENTS_HOST = "https://agent-session.final.ai";
@@ -148,6 +150,12 @@ const createClient = (options) => {
         },
         response: agentListSchema,
         signal: listOptions?.signal
+      }),
+      get: ({ id, signal }) => http.request({
+        method: HttpMethod.Get,
+        path: `/v1/agents/${encodePath(id)}`,
+        response: agentSummarySchema,
+        signal
       })
     },
     people: (() => {
@@ -177,6 +185,7 @@ const createClient = (options) => {
     project: ({ id }) => createProjectClient({ context, start, channelSourceOf, projectId: id }),
     projects: createProjectsApi(context),
     events: createEventsApi({ context, projectId: null }),
+    organization: createOrganizationApi(context),
     app: {
       eventSubscriptions: createEventSubscriptionsApi({
         context,

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/agent-client/client.ts"],
-  "sourcesContent": ["import {\n  agentListSchema,\n  agentRealtimeTopics,\n  decisionResponseSchema,\n  healthResponseSchema,\n  inferenceOfferingSchema,\n  personListSchema,\n  platformIdentityExchangeRequestSchema,\n  platformIdentityExchangeResponseSchema,\n  realtimeSessionResponseSchema,\n  type AgentListIface,\n  type DecisionIface,\n  type HealthResponseIface,\n  type InferenceOfferingIface,\n  type PersonIface,\n  type PersonListIface,\n  type PlatformIdentityExchangeRequestIface,\n  type PlatformIdentityExchangeResponseIface,\n  type RealtimeSessionResponseIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { createAcpApi, type AcpApiIface } from \"./acp.mjs\";\nimport type { AgentValueCodecIface } from \"./agent-input.mjs\";\nimport {\n  createChannelBindingsApi,\n  createChannelTicketsApi,\n  createIdentityLinksApi,\n  type ChannelBindingsApiIface,\n  type ChannelSourceOf,\n  type ChannelTicketsApiIface,\n  type IdentityLinksApiIface,\n} from \"./channels.mjs\";\nimport { encodePath, type ClientContextIface, type SignalOptionsIface } from \"./context.mjs\";\nimport { createConversationsApi, type ConversationsApiIface } from \"./conversations.mjs\";\nimport {\n  defaultAgentCodec,\n  defaultChannelSourceOf,\n  defaultLocalCompute,\n  defaultLocalHostDial,\n} from \"./defaults.mjs\";\nimport { clientError, ClientErrorCode } from \"./errors.mjs\";\nimport {\n  createEventsApi,\n  createEventSubscriptionsApi,\n  type EventsApiIface,\n  type EventSubscriptionsApiIface,\n} from \"./events.mjs\";\nimport { defaultStreamTiming, type StreamTimingIface } from \"./frame-stream.mjs\";\nimport {\n  createHttp,\n  HttpMethod,\n  type AgentClientAuth,\n  type FetchIface,\n  type HeadersOption,\n} from \"./http.mjs\";\nimport {\n  createGatewayRealtimeTransport,\n  type GatewayConnect,\n  type GatewayRealtimeTransportIface,\n  type RealtimeTransportIface,\n} from \"./realtime.mjs\";\nimport type { LocalComputeIface, LocalHostIface, LocalHostSocketIface } from \"./local-host.mjs\";\nimport { createProjectClient, type ProjectClientIface } from \"./project.mjs\";\nimport { createProjectsApi, type ProjectsApiIface } from \"./projects.mjs\";\nimport { createPublishersApi, type PublishersApiIface } from \"./publishers.mjs\";\nimport { createSessionsApi, type SessionsApiIface } from \"./sessions.mjs\";\nimport type { AgentStartDepsIface } from \"./start.mjs\";\n\n/** Final's agents API. */\nexport const DEFAULT_AGENTS_HOST = 'https://agent-session.final.ai';\n\nexport interface CreateClientOptionsIface {\n  auth: AgentClientAuth;\n  /**\n   * Whether this process provides the files and shell an agent requires when\n   * the caller leaves them out (default true), so the model's file edits and\n   * commands run here, on this machine. A server should provide every\n   * capability explicitly and pass false, so an omission fails with\n   * `requirements_unmet` instead of giving the model a shell in the server.\n   */\n  localCompute?: boolean;\n  /**\n   * The agents API origin (default `https://agent-session.final.ai`; its API is\n   * under `/api` and ACP at `/acp/ws`), or a base URL the API routes are mounted under.\n   */\n  host?: string;\n  /** Extra headers per request; console clients send their client identity header here. */\n  headers?: HeadersOption;\n  /** API requests (the host's routes); carries auth and caller headers. */\n  fetch?: FetchIface;\n  /**\n   * Presigned storage requests (attachment uploads). Gets only the headers the\n   * presign requires, never auth, client identity or cookies, so a storage\n   * bucket's CORS and third-party hosts see nothing of the caller. Defaults to\n   * `globalThis.fetch`; keep it free of header-injecting wrappers.\n   */\n  storageFetch?: FetchIface;\n  /** console-web and console-mobile pass their realtime clients; defaults to a gateway connection. */\n  realtime?: RealtimeTransportIface;\n  /** Seam for the default transport's gateway connection. */\n  gatewayConnect?: GatewayConnect;\n  /** Seam for stream retry timing (tests). */\n  timing?: Partial<StreamTimingIface>;\n  /** Seam for idempotency keys and client message ids; defaults to `crypto.randomUUID`. */\n  newKey?: () => string;\n  /** Seam for the client clock (conversation recovery windows). */\n  now?: () => number;\n  /** Seam: how agent values become documents and in-process code. */\n  agentCodec?: AgentValueCodecIface;\n  /** Seam: how a channel value becomes its source. */\n  channelSourceOf?: ChannelSourceOf;\n  /** Seams for local hosts: the socket, and the sandbox this process serves. */\n  localHosts?: {\n    /** Opens the local host socket; abandons it when `signal` aborts. */\n    dial?: (path: string, signal?: AbortSignal) => Promise<LocalHostSocketIface>;\n    compute?: Partial<LocalComputeIface>;\n  };\n}\n\nexport interface AgentsApiIface {\n  /**\n   * The agents the caller can use; with `projectId`, those usable there (its own and those\n   * inherited from its ancestors). Without it, everything the caller can access (an API key: its\n   * parent project and every project it is granted; a person: every project they can read).\n   * Fetch one as data with `client.project({ id }).agents.get`.\n   */\n  list: (\n    options?: SignalOptionsIface & { cursor?: string; limit?: number; projectId?: string },\n  ) => Promise<AgentListIface>;\n}\n\nexport interface PeopleApiIface {\n  /** One page of the caller's organization members, by name; pass `nextCursor` as `cursor` for the next. */\n  list: (\n    options?: SignalOptionsIface & { cursor?: string; limit?: number },\n  ) => Promise<PersonListIface>;\n  /** Every member of the caller's organization (all pages). */\n  all: (options?: SignalOptionsIface) => Promise<PersonIface[]>;\n  /** The caller's own person (or, for an API key or app, the actor it names). */\n  me: { identityLinks: IdentityLinksApiIface };\n}\n\nexport interface RealtimeApiIface {\n  /**\n   * Mints a gateway session (`POST /v1/realtime/session`) for the signed-in user:\n   * the gateway URL, a short-lived token, and the user id realtime topics are keyed by.\n   * Pass it as `createSession` to `createGatewayRealtimeTransport` when supplying a transport.\n   */\n  createSession: (options?: SignalOptionsIface) => Promise<RealtimeSessionResponseIface>;\n}\n\nexport interface InferenceApiIface {\n  /**\n   * The vendors and models the platform's own metered inference serves, with\n   * prices (`GET /v1/inference/offering`, public). A harness using the\n   * platform's inference can run only models listed here.\n   */\n  offering: (options?: SignalOptionsIface) => Promise<InferenceOfferingIface>;\n}\n\nexport interface PlatformIdentityApiIface {\n  /**\n   * Exchanges a sandbox-provider (or downstream) assertion the platform issued\n   * for a fresh one: for the provider's own URL (a refresh) or a backend its\n   * registration was granted. The subject token is the credential.\n   */\n  exchange: (\n    args: PlatformIdentityExchangeRequestIface & SignalOptionsIface,\n  ) => Promise<PlatformIdentityExchangeResponseIface>;\n}\n\nexport interface DecisionsApiIface {\n  /** One decision awaiting the caller's answer, as `conversations.decisions` lists it. */\n  get: (args: { id: string } & SignalOptionsIface) => Promise<DecisionIface>;\n}\n\nexport interface AppApiIface {\n  /**\n   * The calling app's event subscriptions, across every organization that\n   * installed it. Needs an app-level token.\n   */\n  eventSubscriptions: EventSubscriptionsApiIface;\n}\n\nexport interface AgentClientIface {\n  /** One project: where sessions, conversations, sandboxes and integrations are created. */\n  project: (args: { id: string }) => ProjectClientIface;\n  /** The project tree: list projects and create them. */\n  projects: ProjectsApiIface;\n  /** The event feed across everything the caller can see; `project({ id }).events` narrows it. */\n  events: EventsApiIface;\n  app: AppApiIface;\n  /** Publishers' public agents, channels, harnesses and ACP adapters. */\n  publishers: PublishersApiIface;\n  inference: InferenceApiIface;\n  platformIdentity: PlatformIdentityApiIface;\n  decisions: DecisionsApiIface;\n  health: (options?: SignalOptionsIface) => Promise<HealthResponseIface>;\n  agents: AgentsApiIface;\n  people: PeopleApiIface;\n  realtime: RealtimeApiIface;\n  /** Existing sessions by id; create them through `project({ id }).sessions`. */\n  sessions: SessionsApiIface;\n  /** The caller's conversations; create them through `project({ id }).conversations`. */\n  conversations: ConversationsApiIface;\n  /** Channel installs by id; install them through `project({ id }).channels`. */\n  channelBindings: ChannelBindingsApiIface;\n  /** Tickets from an installer's link and connect pages. */\n  channelTickets: ChannelTicketsApiIface;\n  /**\n   * ACP-native access (`/acp/ws`): an ACP v2 ClientApp connection on which the\n   * agents API is the agent. The ACP SDK loads on the first `connect`.\n   */\n  acp: AcpApiIface;\n  /**\n   * Ends every stream (they reject with a `client_closed` ClientError) and every\n   * local host connection (the platform then reports this process's tools and\n   * compute as unavailable; sessions carry on) and, when the client created its\n   * own realtime transport, closes the gateway connection and cancels its\n   * retries. A transport passed in `realtime` belongs to the caller and is left\n   * open. Idempotent.\n   */\n  close: () => void;\n  [Symbol.asyncDispose]: () => Promise<void>;\n}\n\nexport const createClient = (options: CreateClientOptionsIface): AgentClientIface => {\n  const http = createHttp({\n    host: options.host ?? DEFAULT_AGENTS_HOST,\n    auth: options.auth,\n    headers: options.headers,\n    fetch: options.fetch,\n  });\n  let realtime = options.realtime ?? null;\n  let ownTransport: GatewayRealtimeTransportIface | null = null;\n  const closing = new AbortController();\n  const createRealtimeSession: RealtimeApiIface['createSession'] = (sessionOptions) =>\n    http.request({\n      method: HttpMethod.Post,\n      path: '/v1/realtime/session',\n      response: realtimeSessionResponseSchema,\n      signal: sessionOptions?.signal,\n    });\n  let realtimeOwner: Promise<RealtimeSessionResponseIface> | null = null;\n  const realtimeOwnerSession = () => {\n    if (realtimeOwner != null) return realtimeOwner;\n    const pending = createRealtimeSession({ signal: closing.signal });\n    realtimeOwner = pending;\n    void pending.catch(() => {\n      if (realtimeOwner === pending) realtimeOwner = null;\n    });\n    return pending;\n  };\n  let realtimeUser: Promise<string> | null = null;\n  // Shared by every stream, so it is cancelled only with the client, never by one caller.\n  const realtimeUserId: ClientContextIface['realtimeUserId'] = () => {\n    if (realtimeUser != null) return realtimeUser;\n    const pending = realtimeOwnerSession().then((session) => {\n      if (session.userId == null)\n        throw new Error('This client authenticates as an API-key owner, not a user');\n      return session.userId;\n    });\n    realtimeUser = pending;\n    // A failed (or aborted) read is not cached.\n    pending.catch(() => {\n      if (realtimeUser === pending) realtimeUser = null;\n    });\n    return pending;\n  };\n  const context: ClientContextIface = {\n    http,\n    closeSignal: closing.signal,\n    realtimeUserId,\n    // Conversations is the only collection.\n    realtimeCollectionTopic: async () => {\n      const owner = await realtimeOwnerSession();\n      // API keys act in their project, not as members: they reach agents through channels.\n      if (owner.userId == null)\n        throw new Error('Collection streams belong to users; API-key owners use session streams');\n      return agentRealtimeTopics.userConversations(owner.userId);\n    },\n    storageFetch: options.storageFetch ?? ((input, init) => globalThis.fetch(input, init)),\n    realtime: () => {\n      if (realtime != null) return realtime;\n      ownTransport = createGatewayRealtimeTransport({\n        createSession: () => createRealtimeSession(),\n        connect: options.gatewayConnect,\n      });\n      if (closing.signal.aborted) ownTransport.close();\n      realtime = ownTransport;\n      return realtime;\n    },\n    timing: { ...defaultStreamTiming, ...options.timing },\n    newKey: options.newKey ?? (() => globalThis.crypto.randomUUID()),\n    now: options.now ?? Date.now,\n  };\n\n  const hosts = new Set<LocalHostIface>();\n  const localCompute = defaultLocalCompute();\n  const start: AgentStartDepsIface = {\n    context,\n    codec: options.agentCodec ?? defaultAgentCodec,\n    localCompute: options.localCompute ?? true,\n    compute: { ...localCompute, ...options.localHosts?.compute },\n    dial: options.localHosts?.dial ?? defaultLocalHostDial(http),\n    hosts,\n  };\n  const channelSourceOf = options.channelSourceOf ?? defaultChannelSourceOf;\n  const clientLevel = { deps: start, projectId: null };\n\n  const close = (): void => {\n    if (closing.signal.aborted) return;\n    closing.abort(\n      clientError({ message: 'Agent client closed', status: 0, code: ClientErrorCode.Closed }),\n    );\n    for (const host of hosts) host.close();\n    hosts.clear();\n    ownTransport?.close();\n  };\n\n  return {\n    close,\n    [Symbol.asyncDispose]: async () => close(),\n    health: (healthOptions) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: '/v1/health',\n        response: healthResponseSchema,\n        signal: healthOptions?.signal,\n      }),\n    agents: {\n      list: (listOptions) =>\n        http.request({\n          method: HttpMethod.Get,\n          path: '/v1/agents',\n          query: {\n            cursor: listOptions?.cursor,\n            limit: listOptions?.limit,\n            projectId: listOptions?.projectId,\n          },\n          response: agentListSchema,\n          signal: listOptions?.signal,\n        }),\n    },\n    people: (() => {\n      const list: PeopleApiIface['list'] = (listOptions) =>\n        http.request({\n          method: HttpMethod.Get,\n          path: '/v1/people',\n          query: { cursor: listOptions?.cursor, limit: listOptions?.limit },\n          response: personListSchema,\n          signal: listOptions?.signal,\n        });\n      return {\n        list,\n        all: async (allOptions) => {\n          const all: PersonIface[] = [];\n          let cursor: string | undefined;\n          for (;;) {\n            const next = await list({ cursor, signal: allOptions?.signal });\n            all.push(...next.people);\n            if (next.nextCursor == null) return all;\n            cursor = next.nextCursor;\n          }\n        },\n        me: { identityLinks: createIdentityLinksApi(context) },\n      };\n    })(),\n    realtime: { createSession: createRealtimeSession },\n    project: ({ id }) => createProjectClient({ context, start, channelSourceOf, projectId: id }),\n    projects: createProjectsApi(context),\n    events: createEventsApi({ context, projectId: null }),\n    app: {\n      eventSubscriptions: createEventSubscriptionsApi({\n        context,\n        basePath: '/v1/apps/me/event-subscriptions',\n      }),\n    },\n    publishers: createPublishersApi(context),\n    inference: {\n      offering: (offeringOptions) =>\n        http.request({\n          method: HttpMethod.Get,\n          path: '/v1/inference/offering',\n          response: inferenceOfferingSchema,\n          signal: offeringOptions?.signal,\n        }),\n    },\n    platformIdentity: {\n      exchange: ({ signal, ...value }) =>\n        http.request({\n          method: HttpMethod.Post,\n          path: '/v1/platform-identity/exchange',\n          body: { schema: platformIdentityExchangeRequestSchema, value },\n          response: platformIdentityExchangeResponseSchema,\n          signal,\n        }),\n    },\n    decisions: {\n      get: async ({ id, signal }) =>\n        (\n          await http.request({\n            method: HttpMethod.Get,\n            path: `/v1/decisions/${encodePath(id)}`,\n            response: decisionResponseSchema,\n            signal,\n            context: { decisionId: id },\n          })\n        ).decision,\n    },\n    sessions: createSessionsApi(context),\n    conversations: createConversationsApi(context, clientLevel),\n    channelBindings: createChannelBindingsApi(context),\n    channelTickets: createChannelTicketsApi(context),\n    acp: createAcpApi({ http }),\n  };\n};\n"],
-  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAUK;AACP,SAAS,oBAAsC;AAE/C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAKK;AACP,SAAS,kBAAoE;AAC7E,SAAS,8BAA0D;AACnE;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,aAAa,uBAAuB;AAC7C;AAAA,EACE;AAAA,EACA;AAAA,OAGK;AACP,SAAS,2BAAmD;AAC5D;AAAA,EACE;AAAA,EACA;AAAA,OAIK;AACP;AAAA,EACE;AAAA,OAIK;AAEP,SAAS,2BAAoD;AAC7D,SAAS,yBAAgD;AACzD,SAAS,2BAAoD;AAC7D,SAAS,yBAAgD;AAIlD,MAAM,sBAAsB;AA6J5B,MAAM,eAAe,CAAC,YAAwD;AACnF,QAAM,OAAO,WAAW;AAAA,IACtB,MAAM,QAAQ,QAAQ;AAAA,IACtB,MAAM,QAAQ;AAAA,IACd,SAAS,QAAQ;AAAA,IACjB,OAAO,QAAQ;AAAA,EACjB,CAAC;AACD,MAAI,WAAW,QAAQ,YAAY;AACnC,MAAI,eAAqD;AACzD,QAAM,UAAU,IAAI,gBAAgB;AACpC,QAAM,wBAA2D,CAAC,mBAChE,KAAK,QAAQ;AAAA,IACX,QAAQ,WAAW;AAAA,IACnB,MAAM;AAAA,IACN,UAAU;AAAA,IACV,QAAQ,gBAAgB;AAAA,EAC1B,CAAC;AACH,MAAI,gBAA8D;AAClE,QAAM,uBAAuB,MAAM;AACjC,QAAI,iBAAiB,KAAM,QAAO;AAClC,UAAM,UAAU,sBAAsB,EAAE,QAAQ,QAAQ,OAAO,CAAC;AAChE,oBAAgB;AAChB,SAAK,QAAQ,MAAM,MAAM;AACvB,UAAI,kBAAkB,QAAS,iBAAgB;AAAA,IACjD,CAAC;AACD,WAAO;AAAA,EACT;AACA,MAAI,eAAuC;AAE3C,QAAM,iBAAuD,MAAM;AACjE,QAAI,gBAAgB,KAAM,QAAO;AACjC,UAAM,UAAU,qBAAqB,EAAE,KAAK,CAAC,YAAY;AACvD,UAAI,QAAQ,UAAU;AACpB,cAAM,IAAI,MAAM,2DAA2D;AAC7E,aAAO,QAAQ;AAAA,IACjB,CAAC;AACD,mBAAe;AAEf,YAAQ,MAAM,MAAM;AAClB,UAAI,iBAAiB,QAAS,gBAAe;AAAA,IAC/C,CAAC;AACD,WAAO;AAAA,EACT;AACA,QAAM,UAA8B;AAAA,IAClC;AAAA,IACA,aAAa,QAAQ;AAAA,IACrB;AAAA;AAAA,IAEA,yBAAyB,YAAY;AACnC,YAAM,QAAQ,MAAM,qBAAqB;AAEzC,UAAI,MAAM,UAAU;AAClB,cAAM,IAAI,MAAM,wEAAwE;AAC1F,aAAO,oBAAoB,kBAAkB,MAAM,MAAM;AAAA,IAC3D;AAAA,IACA,cAAc,QAAQ,iBAAiB,CAAC,OAAO,SAAS,WAAW,MAAM,OAAO,IAAI;AAAA,IACpF,UAAU,MAAM;AACd,UAAI,YAAY,KAAM,QAAO;AAC7B,qBAAe,+BAA+B;AAAA,QAC5C,eAAe,MAAM,sBAAsB;AAAA,QAC3C,SAAS,QAAQ;AAAA,MACnB,CAAC;AACD,UAAI,QAAQ,OAAO,QAAS,cAAa,MAAM;AAC/C,iBAAW;AACX,aAAO;AAAA,IACT;AAAA,IACA,QAAQ,EAAE,GAAG,qBAAqB,GAAG,QAAQ,OAAO;AAAA,IACpD,QAAQ,QAAQ,WAAW,MAAM,WAAW,OAAO,WAAW;AAAA,IAC9D,KAAK,QAAQ,OAAO,KAAK;AAAA,EAC3B;AAEA,QAAM,QAAQ,oBAAI,IAAoB;AACtC,QAAM,eAAe,oBAAoB;AACzC,QAAM,QAA6B;AAAA,IACjC;AAAA,IACA,OAAO,QAAQ,cAAc;AAAA,IAC7B,cAAc,QAAQ,gBAAgB;AAAA,IACtC,SAAS,EAAE,GAAG,cAAc,GAAG,QAAQ,YAAY,QAAQ;AAAA,IAC3D,MAAM,QAAQ,YAAY,QAAQ,qBAAqB,IAAI;AAAA,IAC3D;AAAA,EACF;AACA,QAAM,kBAAkB,QAAQ,mBAAmB;AACnD,QAAM,cAAc,EAAE,MAAM,OAAO,WAAW,KAAK;AAEnD,QAAM,QAAQ,MAAY;AACxB,QAAI,QAAQ,OAAO,QAAS;AAC5B,YAAQ;AAAA,MACN,YAAY,EAAE,SAAS,uBAAuB,QAAQ,GAAG,MAAM,gBAAgB,OAAO,CAAC;AAAA,IACzF;AACA,eAAW,QAAQ,MAAO,MAAK,MAAM;AACrC,UAAM,MAAM;AACZ,kBAAc,MAAM;AAAA,EACtB;AAEA,SAAO;AAAA,IACL;AAAA,IACA,CAAC,OAAO,YAAY,GAAG,YAAY,MAAM;AAAA,IACzC,QAAQ,CAAC,kBACP,KAAK,QAAQ;AAAA,MACX,QAAQ,WAAW;AAAA,MACnB,MAAM;AAAA,MACN,UAAU;AAAA,MACV,QAAQ,eAAe;AAAA,IACzB,CAAC;AAAA,IACH,QAAQ;AAAA,MACN,MAAM,CAAC,gBACL,KAAK,QAAQ;AAAA,QACX,QAAQ,WAAW;AAAA,QACnB,MAAM;AAAA,QACN,OAAO;AAAA,UACL,QAAQ,aAAa;AAAA,UACrB,OAAO,aAAa;AAAA,UACpB,WAAW,aAAa;AAAA,QAC1B;AAAA,QACA,UAAU;AAAA,QACV,QAAQ,aAAa;AAAA,MACvB,CAAC;AAAA,IACL;AAAA,IACA,SAAS,MAAM;AACb,YAAM,OAA+B,CAAC,gBACpC,KAAK,QAAQ;AAAA,QACX,QAAQ,WAAW;AAAA,QACnB,MAAM;AAAA,QACN,OAAO,EAAE,QAAQ,aAAa,QAAQ,OAAO,aAAa,MAAM;AAAA,QAChE,UAAU;AAAA,QACV,QAAQ,aAAa;AAAA,MACvB,CAAC;AACH,aAAO;AAAA,QACL;AAAA,QACA,KAAK,OAAO,eAAe;AACzB,gBAAM,MAAqB,CAAC;AAC5B,cAAI;AACJ,qBAAS;AACP,kBAAM,OAAO,MAAM,KAAK,EAAE,QAAQ,QAAQ,YAAY,OAAO,CAAC;AAC9D,gBAAI,KAAK,GAAG,KAAK,MAAM;AACvB,gBAAI,KAAK,cAAc,KAAM,QAAO;AACpC,qBAAS,KAAK;AAAA,UAChB;AAAA,QACF;AAAA,QACA,IAAI,EAAE,eAAe,uBAAuB,OAAO,EAAE;AAAA,MACvD;AAAA,IACF,GAAG;AAAA,IACH,UAAU,EAAE,eAAe,sBAAsB;AAAA,IACjD,SAAS,CAAC,EAAE,GAAG,MAAM,oBAAoB,EAAE,SAAS,OAAO,iBAAiB,WAAW,GAAG,CAAC;AAAA,IAC3F,UAAU,kBAAkB,OAAO;AAAA,IACnC,QAAQ,gBAAgB,EAAE,SAAS,WAAW,KAAK,CAAC;AAAA,IACpD,KAAK;AAAA,MACH,oBAAoB,4BAA4B;AAAA,QAC9C;AAAA,QACA,UAAU;AAAA,MACZ,CAAC;AAAA,IACH;AAAA,IACA,YAAY,oBAAoB,OAAO;AAAA,IACvC,WAAW;AAAA,MACT,UAAU,CAAC,oBACT,KAAK,QAAQ;AAAA,QACX,QAAQ,WAAW;AAAA,QACnB,MAAM;AAAA,QACN,UAAU;AAAA,QACV,QAAQ,iBAAiB;AAAA,MAC3B,CAAC;AAAA,IACL;AAAA,IACA,kBAAkB;AAAA,MAChB,UAAU,CAAC,EAAE,QAAQ,GAAG,MAAM,MAC5B,KAAK,QAAQ;AAAA,QACX,QAAQ,WAAW;AAAA,QACnB,MAAM;AAAA,QACN,MAAM,EAAE,QAAQ,uCAAuC,MAAM;AAAA,QAC7D,UAAU;AAAA,QACV;AAAA,MACF,CAAC;AAAA,IACL;AAAA,IACA,WAAW;AAAA,MACT,KAAK,OAAO,EAAE,IAAI,OAAO,OAErB,MAAM,KAAK,QAAQ;AAAA,QACjB,QAAQ,WAAW;AAAA,QACnB,MAAM,iBAAiB,WAAW,EAAE,CAAC;AAAA,QACrC,UAAU;AAAA,QACV;AAAA,QACA,SAAS,EAAE,YAAY,GAAG;AAAA,MAC5B,CAAC,GACD;AAAA,IACN;AAAA,IACA,UAAU,kBAAkB,OAAO;AAAA,IACnC,eAAe,uBAAuB,SAAS,WAAW;AAAA,IAC1D,iBAAiB,yBAAyB,OAAO;AAAA,IACjD,gBAAgB,wBAAwB,OAAO;AAAA,IAC/C,KAAK,aAAa,EAAE,KAAK,CAAC;AAAA,EAC5B;AACF;",
+  "sourcesContent": ["import {\n  agentListSchema,\n  agentRealtimeTopics,\n  agentSummarySchema,\n  decisionResponseSchema,\n  healthResponseSchema,\n  inferenceOfferingSchema,\n  personListSchema,\n  platformIdentityExchangeRequestSchema,\n  platformIdentityExchangeResponseSchema,\n  realtimeSessionResponseSchema,\n  type AgentListIface,\n  type AgentSummaryIface,\n  type DecisionIface,\n  type HealthResponseIface,\n  type InferenceOfferingIface,\n  type PersonIface,\n  type PersonListIface,\n  type PlatformIdentityExchangeRequestIface,\n  type PlatformIdentityExchangeResponseIface,\n  type RealtimeSessionResponseIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { createAcpApi, type AcpApiIface } from \"./acp.mjs\";\nimport type { AgentValueCodecIface } from \"./agent-input.mjs\";\nimport {\n  createChannelBindingsApi,\n  createChannelTicketsApi,\n  createIdentityLinksApi,\n  type ChannelBindingsApiIface,\n  type ChannelSourceOf,\n  type ChannelTicketsApiIface,\n  type IdentityLinksApiIface,\n} from \"./channels.mjs\";\nimport { encodePath, type ClientContextIface, type SignalOptionsIface } from \"./context.mjs\";\nimport { createConversationsApi, type ConversationsApiIface } from \"./conversations.mjs\";\nimport {\n  defaultAgentCodec,\n  defaultChannelSourceOf,\n  defaultLocalCompute,\n  defaultLocalHostDial,\n} from \"./defaults.mjs\";\nimport { clientError, ClientErrorCode } from \"./errors.mjs\";\nimport {\n  createEventsApi,\n  createEventSubscriptionsApi,\n  type EventsApiIface,\n  type EventSubscriptionsApiIface,\n} from \"./events.mjs\";\nimport { defaultStreamTiming, type StreamTimingIface } from \"./frame-stream.mjs\";\nimport {\n  createHttp,\n  HttpMethod,\n  type AgentClientAuth,\n  type FetchIface,\n  type HeadersOption,\n} from \"./http.mjs\";\nimport {\n  createGatewayRealtimeTransport,\n  type GatewayConnect,\n  type GatewayRealtimeTransportIface,\n  type RealtimeTransportIface,\n} from \"./realtime.mjs\";\nimport type { LocalComputeIface, LocalHostIface, LocalHostSocketIface } from \"./local-host.mjs\";\nimport { createProjectClient, type ProjectClientIface } from \"./project.mjs\";\nimport { createProjectsApi, type ProjectsApiIface } from \"./projects.mjs\";\nimport { createOrganizationApi, type OrganizationApiIface } from \"./organization.mjs\";\nimport { createPublishersApi, type PublishersApiIface } from \"./publishers.mjs\";\nimport { createSessionsApi, type SessionsApiIface } from \"./sessions.mjs\";\nimport type { AgentStartDepsIface } from \"./start.mjs\";\n\n/** Final's agents API. */\nexport const DEFAULT_AGENTS_HOST = 'https://agent-session.final.ai';\n\nexport interface CreateClientOptionsIface {\n  auth: AgentClientAuth;\n  /**\n   * Whether this process provides the files and shell an agent requires when\n   * the caller leaves them out (default true), so the model's file edits and\n   * commands run here, on this machine. A server should provide every\n   * capability explicitly and pass false, so an omission fails with\n   * `requirements_unmet` instead of giving the model a shell in the server.\n   */\n  localCompute?: boolean;\n  /**\n   * The agents API origin (default `https://agent-session.final.ai`; its API is\n   * under `/api` and ACP at `/acp/ws`), or a base URL the API routes are mounted under.\n   */\n  host?: string;\n  /** Extra headers per request; console clients send their client identity header here. */\n  headers?: HeadersOption;\n  /** API requests (the host's routes); carries auth and caller headers. */\n  fetch?: FetchIface;\n  /**\n   * Presigned storage requests (attachment uploads). Gets only the headers the\n   * presign requires, never auth, client identity or cookies, so a storage\n   * bucket's CORS and third-party hosts see nothing of the caller. Defaults to\n   * `globalThis.fetch`; keep it free of header-injecting wrappers.\n   */\n  storageFetch?: FetchIface;\n  /** console-web and console-mobile pass their realtime clients; defaults to a gateway connection. */\n  realtime?: RealtimeTransportIface;\n  /** Seam for the default transport's gateway connection. */\n  gatewayConnect?: GatewayConnect;\n  /** Seam for stream retry timing (tests). */\n  timing?: Partial<StreamTimingIface>;\n  /** Seam for idempotency keys and client message ids; defaults to `crypto.randomUUID`. */\n  newKey?: () => string;\n  /** Seam for the client clock (conversation recovery windows). */\n  now?: () => number;\n  /** Seam: how agent values become documents and in-process code. */\n  agentCodec?: AgentValueCodecIface;\n  /** Seam: how a channel value becomes its source. */\n  channelSourceOf?: ChannelSourceOf;\n  /** Seams for local hosts: the socket, and the sandbox this process serves. */\n  localHosts?: {\n    /** Opens the local host socket; abandons it when `signal` aborts. */\n    dial?: (path: string, signal?: AbortSignal) => Promise<LocalHostSocketIface>;\n    compute?: Partial<LocalComputeIface>;\n  };\n}\n\nexport interface AgentsApiIface {\n  /**\n   * The agents the caller can use; with `projectId`, those usable there (its own and those\n   * inherited from its ancestors). Without it, everything the caller can access (an API key: its\n   * parent project and every project it is granted; a person: every project they can read).\n   * Fetch one as data with `client.project({ id }).agents.get`.\n   */\n  list: (\n    options?: SignalOptionsIface & { cursor?: string; limit?: number; projectId?: string },\n  ) => Promise<AgentListIface>;\n  /**\n   * One agent the caller can use, by id, in whichever project owns it; also one that was never\n   * published (`hash` and `revisionId` are null). Archived agents are not found.\n   */\n  get: (args: { id: string } & SignalOptionsIface) => Promise<AgentSummaryIface>;\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  /** The caller's own person (or, for an API key or app, the actor it names). */\n  me: { identityLinks: IdentityLinksApiIface };\n}\n\nexport interface RealtimeApiIface {\n  /**\n   * Mints a gateway session (`POST /v1/realtime/session`) for the signed-in user:\n   * the gateway URL, a short-lived token, and the user id realtime topics are keyed by.\n   * Pass it as `createSession` to `createGatewayRealtimeTransport` when supplying a transport.\n   */\n  createSession: (options?: SignalOptionsIface) => Promise<RealtimeSessionResponseIface>;\n}\n\nexport interface InferenceApiIface {\n  /**\n   * The vendors and models the platform's own metered inference serves, with\n   * prices (`GET /v1/inference/offering`, public). A harness using the\n   * platform's inference can run only models listed here.\n   */\n  offering: (options?: SignalOptionsIface) => Promise<InferenceOfferingIface>;\n}\n\nexport interface PlatformIdentityApiIface {\n  /**\n   * Exchanges a sandbox-provider (or downstream) assertion the platform issued\n   * for a fresh one: for the provider's own URL (a refresh) or a backend its\n   * registration was granted. The subject token is the credential.\n   */\n  exchange: (\n    args: PlatformIdentityExchangeRequestIface & SignalOptionsIface,\n  ) => Promise<PlatformIdentityExchangeResponseIface>;\n}\n\nexport interface DecisionsApiIface {\n  /** One decision awaiting the caller's answer, as `conversations.decisions` lists it. */\n  get: (args: { id: string } & SignalOptionsIface) => Promise<DecisionIface>;\n}\n\nexport interface AppApiIface {\n  /**\n   * The calling app's event subscriptions, across every organization that\n   * installed it. Needs an app-level token.\n   */\n  eventSubscriptions: EventSubscriptionsApiIface;\n}\n\nexport interface AgentClientIface {\n  /** One project: where sessions, conversations, sandboxes and integrations are created. */\n  project: (args: { id: string }) => ProjectClientIface;\n  /** The project tree: list projects and create them. */\n  projects: ProjectsApiIface;\n  /** The event feed across everything the caller can see; `project({ id }).events` narrows it. */\n  events: EventsApiIface;\n  app: AppApiIface;\n  /** Publishers' public agents, channels, harnesses and ACP adapters. */\n  publishers: PublishersApiIface;\n  inference: InferenceApiIface;\n  platformIdentity: PlatformIdentityApiIface;\n  decisions: DecisionsApiIface;\n  health: (options?: SignalOptionsIface) => Promise<HealthResponseIface>;\n  /** The caller's organization: model credentials, budgets and policies. */\n  organization: OrganizationApiIface;\n  agents: AgentsApiIface;\n  people: PeopleApiIface;\n  realtime: RealtimeApiIface;\n  /** Existing sessions by id; create them through `project({ id }).sessions`. */\n  sessions: SessionsApiIface;\n  /** The caller's conversations; create them through `project({ id }).conversations`. */\n  conversations: ConversationsApiIface;\n  /** Channel installs by id; install them through `project({ id }).channels`. */\n  channelBindings: ChannelBindingsApiIface;\n  /** Tickets from an installer's link and connect pages. */\n  channelTickets: ChannelTicketsApiIface;\n  /**\n   * ACP-native access (`/acp/ws`): an ACP v2 ClientApp connection on which the\n   * agents API is the agent. The ACP SDK loads on the first `connect`.\n   */\n  acp: AcpApiIface;\n  /**\n   * Ends every stream (they reject with a `client_closed` ClientError) and every\n   * local host connection (the platform then reports this process's tools and\n   * compute as unavailable; sessions carry on) and, when the client created its\n   * own realtime transport, closes the gateway connection and cancels its\n   * retries. A transport passed in `realtime` belongs to the caller and is left\n   * open. Idempotent.\n   */\n  close: () => void;\n  [Symbol.asyncDispose]: () => Promise<void>;\n}\n\nexport const createClient = (options: CreateClientOptionsIface): AgentClientIface => {\n  const http = createHttp({\n    host: options.host ?? DEFAULT_AGENTS_HOST,\n    auth: options.auth,\n    headers: options.headers,\n    fetch: options.fetch,\n  });\n  let realtime = options.realtime ?? null;\n  let ownTransport: GatewayRealtimeTransportIface | null = null;\n  const closing = new AbortController();\n  const createRealtimeSession: RealtimeApiIface['createSession'] = (sessionOptions) =>\n    http.request({\n      method: HttpMethod.Post,\n      path: '/v1/realtime/session',\n      response: realtimeSessionResponseSchema,\n      signal: sessionOptions?.signal,\n    });\n  let realtimeOwner: Promise<RealtimeSessionResponseIface> | null = null;\n  const realtimeOwnerSession = () => {\n    if (realtimeOwner != null) return realtimeOwner;\n    const pending = createRealtimeSession({ signal: closing.signal });\n    realtimeOwner = pending;\n    void pending.catch(() => {\n      if (realtimeOwner === pending) realtimeOwner = null;\n    });\n    return pending;\n  };\n  let realtimeUser: Promise<string> | null = null;\n  // Shared by every stream, so it is cancelled only with the client, never by one caller.\n  const realtimeUserId: ClientContextIface['realtimeUserId'] = () => {\n    if (realtimeUser != null) return realtimeUser;\n    const pending = realtimeOwnerSession().then((session) => {\n      if (session.userId == null)\n        throw new Error('This client authenticates as an API-key owner, not a user');\n      return session.userId;\n    });\n    realtimeUser = pending;\n    // A failed (or aborted) read is not cached.\n    pending.catch(() => {\n      if (realtimeUser === pending) realtimeUser = null;\n    });\n    return pending;\n  };\n  const context: ClientContextIface = {\n    http,\n    closeSignal: closing.signal,\n    realtimeUserId,\n    // Conversations is the only collection.\n    realtimeCollectionTopic: async () => {\n      const owner = await realtimeOwnerSession();\n      // API keys act in their project, not as members: they reach agents through channels.\n      if (owner.userId == null)\n        throw new Error('Collection streams belong to users; API-key owners use session streams');\n      return agentRealtimeTopics.userConversations(owner.userId);\n    },\n    storageFetch: options.storageFetch ?? ((input, init) => globalThis.fetch(input, init)),\n    realtime: () => {\n      if (realtime != null) return realtime;\n      ownTransport = createGatewayRealtimeTransport({\n        createSession: () => createRealtimeSession(),\n        connect: options.gatewayConnect,\n      });\n      if (closing.signal.aborted) ownTransport.close();\n      realtime = ownTransport;\n      return realtime;\n    },\n    timing: { ...defaultStreamTiming, ...options.timing },\n    newKey: options.newKey ?? (() => globalThis.crypto.randomUUID()),\n    now: options.now ?? Date.now,\n  };\n\n  const hosts = new Set<LocalHostIface>();\n  const localCompute = defaultLocalCompute();\n  const start: AgentStartDepsIface = {\n    context,\n    codec: options.agentCodec ?? defaultAgentCodec,\n    localCompute: options.localCompute ?? true,\n    compute: { ...localCompute, ...options.localHosts?.compute },\n    dial: options.localHosts?.dial ?? defaultLocalHostDial(http),\n    hosts,\n  };\n  const channelSourceOf = options.channelSourceOf ?? defaultChannelSourceOf;\n  const clientLevel = { deps: start, projectId: null };\n\n  const close = (): void => {\n    if (closing.signal.aborted) return;\n    closing.abort(\n      clientError({ message: 'Agent client closed', status: 0, code: ClientErrorCode.Closed }),\n    );\n    for (const host of hosts) host.close();\n    hosts.clear();\n    ownTransport?.close();\n  };\n\n  return {\n    close,\n    [Symbol.asyncDispose]: async () => close(),\n    health: (healthOptions) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: '/v1/health',\n        response: healthResponseSchema,\n        signal: healthOptions?.signal,\n      }),\n    agents: {\n      list: (listOptions) =>\n        http.request({\n          method: HttpMethod.Get,\n          path: '/v1/agents',\n          query: {\n            cursor: listOptions?.cursor,\n            limit: listOptions?.limit,\n            projectId: listOptions?.projectId,\n          },\n          response: agentListSchema,\n          signal: listOptions?.signal,\n        }),\n      get: ({ id, signal }) =>\n        http.request({\n          method: HttpMethod.Get,\n          path: `/v1/agents/${encodePath(id)}`,\n          response: agentSummarySchema,\n          signal,\n        }),\n    },\n    people: (() => {\n      const list: PeopleApiIface['list'] = (listOptions) =>\n        http.request({\n          method: HttpMethod.Get,\n          path: '/v1/people',\n          query: { cursor: listOptions?.cursor, limit: listOptions?.limit },\n          response: personListSchema,\n          signal: listOptions?.signal,\n        });\n      return {\n        list,\n        all: async (allOptions) => {\n          const all: PersonIface[] = [];\n          let cursor: string | undefined;\n          for (;;) {\n            const next = await list({ cursor, signal: allOptions?.signal });\n            all.push(...next.people);\n            if (next.nextCursor == null) return all;\n            cursor = next.nextCursor;\n          }\n        },\n        me: { identityLinks: createIdentityLinksApi(context) },\n      };\n    })(),\n    realtime: { createSession: createRealtimeSession },\n    project: ({ id }) => createProjectClient({ context, start, channelSourceOf, projectId: id }),\n    projects: createProjectsApi(context),\n    events: createEventsApi({ context, projectId: null }),\n    organization: createOrganizationApi(context),\n    app: {\n      eventSubscriptions: createEventSubscriptionsApi({\n        context,\n        basePath: '/v1/apps/me/event-subscriptions',\n      }),\n    },\n    publishers: createPublishersApi(context),\n    inference: {\n      offering: (offeringOptions) =>\n        http.request({\n          method: HttpMethod.Get,\n          path: '/v1/inference/offering',\n          response: inferenceOfferingSchema,\n          signal: offeringOptions?.signal,\n        }),\n    },\n    platformIdentity: {\n      exchange: ({ signal, ...value }) =>\n        http.request({\n          method: HttpMethod.Post,\n          path: '/v1/platform-identity/exchange',\n          body: { schema: platformIdentityExchangeRequestSchema, value },\n          response: platformIdentityExchangeResponseSchema,\n          signal,\n        }),\n    },\n    decisions: {\n      get: async ({ id, signal }) =>\n        (\n          await http.request({\n            method: HttpMethod.Get,\n            path: `/v1/decisions/${encodePath(id)}`,\n            response: decisionResponseSchema,\n            signal,\n            context: { decisionId: id },\n          })\n        ).decision,\n    },\n    sessions: createSessionsApi(context),\n    conversations: createConversationsApi(context, clientLevel),\n    channelBindings: createChannelBindingsApi(context),\n    channelTickets: createChannelTicketsApi(context),\n    acp: createAcpApi({ http }),\n  };\n};\n"],
+  "mappings": "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",
   "names": []
 }

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

@@ -1,5 +1,6 @@
+import { type ParticipantConfigurationApiIface } from "./participant-configuration.mjs";
 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 ActorInputIface, type ParticipantInput, type ParticipantProvideResponseIface, 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 ScheduleRunResultIface, type UpdateParticipantRequestIface, type WireFallback } from '@finalai/agent-protocol/agent-platform';
+import { AgentSessionState, 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 ActorInputIface, type ParticipantInput, type ParticipantProvideResponseIface, 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 ScheduleRunResultIface, type UpdateParticipantRequestIface, type WireFallback } from '@finalai/agent-protocol/agent-platform';
 import type { AgentInput } from "./agent-input.mjs";
 import { type ConversationResourcesIface } from "./conversation-resources.mjs";
 import { type CollectionEvent, type CollectionEventsOptionsIface } from "./collection-events.mjs";
@@ -104,6 +105,8 @@ export interface ParticipantsApiIface {
      * `harness_unsuitable` for harness settings it cannot run on.
      */
     provide: (participantId: string, patch: ProvidePatchIface, options?: SignalOptionsIface) => Promise<ParticipantProvideResponseIface>;
+    /** Changes to an agent participant's settings through proposals a manager decides. */
+    configuration: ParticipantConfigurationApiIface;
 }
 export interface SentMessageIface {
     message: ConversationMessageIface;
@@ -138,9 +141,16 @@ export interface ConversationHandleIface extends ConversationResourcesIface {
     send: (content: ContentInput, options?: SendMessageOptionsIface) => Promise<SentMessageIface>;
     events: (options?: ConversationEventsOptionsIface) => AsyncIterableIterator<ConversationEvent>;
     messages: (options?: ListMessagesOptionsIface) => Promise<ConversationMessagesPageIface>;
-    /** One message by id (`GET /v1/conversations/:id/messages/:messageId`), e.g. a thread root. */
+    /**
+     * One message: by id (`GET /v1/conversations/:id/messages/:messageId`), e.g. a thread root,
+     * or the reply a turn's streamed text became, by the session seq its text started at (a
+     * preview's `fromSeq`).
+     */
     message: (args: {
         messageId: string;
+    } | {
+        turnId: string;
+        fromSeq: number;
     }, options?: SignalOptionsIface) => Promise<ConversationMessageIface>;
     react: (args: {
         messageId: string;
@@ -150,11 +160,6 @@ export interface ConversationHandleIface extends ConversationResourcesIface {
         messageId: string;
         emoji: string;
     }, options?: SignalOptionsIface) => Promise<ReactionIface[]>;
-    recordPushOpen: (args: {
-        deliveryId: string;
-    }, options?: SignalOptionsIface) => Promise<{
-        recorded: boolean;
-    }>;
     markRead: (args: {
         throughSeq: number;
     }, options?: SignalOptionsIface) => Promise<ReadStateIface>;
@@ -175,13 +180,6 @@ export interface ConversationHandleIface extends ConversationResourcesIface {
     typing: (args: {
         typing: boolean;
     }, options?: SignalOptionsIface) => Promise<void>;
-    /**
-     * Hands something that happened outside the conversation (`POST …/events`)
-     * to its Default agent as input from you, not as a message: the agent's
-     * reply carries the source as its caption. The same `eventId` from the same
-     * 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<RespondDecisionResponseIface>;
     /** Stops the agents' running turns in this conversation. */
     cancel: (options?: SignalOptionsIface & {
@@ -371,16 +369,6 @@ export interface ProjectConversationsApiIface extends ConversationsApiIface {
      * creating nothing, unless each agent's requirements are met.
      */
     create: (args: CreateConversationArgsIface) => Promise<OpenedConversationIface>;
-    /**
-     * The caller's own Home thread with the project's agent, found or created.
-     * `provide` is stored only when the agent has no settings there yet.
-     */
-    home: (args: {
-        id?: string;
-        provide: ProvideIface;
-    } & SignalOptionsIface) => Promise<OpenedConversationIface>;
-    /** The caller's Home thread, if there is one. Creates nothing. */
-    findHome: (options?: SignalOptionsIface) => Promise<ConversationIface | null>;
     /**
      * The caller's direct conversation with an agent, found or created.
      * `provide` is stored only when the agent has no settings there yet.
@@ -420,10 +408,14 @@ export interface ConversationsApiIface {
     }) => Promise<ConversationListIface>;
     /** I/O-free handle. */
     get: (conversationId: string) => ConversationHandleIface;
-    /** Full-text search over the caller's conversations (or one), newest first. */
+    /**
+     * Full-text search over the caller's conversations (or one, or those in a project and the
+     * projects below it), newest first.
+     */
     search: (args: {
         q: string;
         conversationId?: string;
+        projectId?: string;
         cursor?: string;
         limit?: number;
     } & SignalOptionsIface) => Promise<SearchMessagesPageIface>;

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

@@ -1,3 +1,6 @@
+import {
+  createParticipantConfigurationApi
+} from "./participant-configuration.mjs";
 import {
   PROCESS_CAPABILITIES,
   ProcessInspectionOperation,
@@ -34,7 +37,6 @@ import {
   scheduleRunResultSchema,
   DecisionEventState,
   decisionRecordListSchema,
-  homeConversationRequestSchema,
   decisionsPageSchema,
   markReadRequestSchema,
   messageDeliveriesSchema,
@@ -47,10 +49,7 @@ import {
   participantListSchema,
   participantProvideResponseSchema,
   participantSchema,
-  postConversationEventRequestSchema,
   provideParticipantRequestSchema,
-  postConversationEventResponseSchema,
-  pushDeliveryOpenResponseSchema,
   reactionRequestSchema,
   reactionsResponseSchema,
   readStateSchema,
@@ -722,7 +721,10 @@ const createConversationHandle = (context, conversationId, starter) => {
     })).deliveries,
     message: (args, options) => http.request({
       method: HttpMethod.Get,
-      path: messagePath(conversationId, args.messageId),
+      path: "messageId" in args ? messagePath(conversationId, args.messageId) : conversationPath(
+        conversationId,
+        `/turns/${encodePath(args.turnId)}/messages/${args.fromSeq}`
+      ),
       response: conversationMessageSchema,
       signal: options?.signal
     }),
@@ -737,13 +739,6 @@ const createConversationHandle = (context, conversationId, starter) => {
         signal: options?.signal
       });
     },
-    postEvent: (event, options) => http.request({
-      method: HttpMethod.Post,
-      path: conversationPath(conversationId, "/events"),
-      body: { schema: postConversationEventRequestSchema, value: event },
-      response: postConversationEventResponseSchema,
-      signal: options?.signal
-    }),
     typing: async (args, options) => {
       await http.request({
         method: HttpMethod.Post,
@@ -753,15 +748,6 @@ const createConversationHandle = (context, conversationId, starter) => {
         signal: options?.signal
       });
     },
-    recordPushOpen: (args, options) => http.request({
-      method: HttpMethod.Post,
-      path: conversationPath(
-        conversationId,
-        `/push-deliveries/${encodeURIComponent(args.deliveryId)}/open`
-      ),
-      response: pushDeliveryOpenResponseSchema,
-      signal: options?.signal
-    }),
     markRead: (args, options) => http.request({
       method: HttpMethod.Post,
       path: conversationPath(conversationId, "/read"),
@@ -819,7 +805,8 @@ const createConversationHandle = (context, conversationId, starter) => {
             response: participantProvideResponseSchema,
             signal: options?.signal
           });
-        }
+        },
+        configuration: createParticipantConfigurationApi({ context, conversationId })
       }
     ),
     turns: async (options) => {
@@ -1189,6 +1176,7 @@ const createConversationsApi = (context, starter) => {
       query: {
         q: args.q,
         conversationId: args.conversationId,
+        projectId: args.projectId,
         cursor: args.cursor,
         limit: args.limit
       },
@@ -1349,46 +1337,6 @@ const createProjectConversationsApi = (args) => {
       }
       return opened(conversation);
     },
-    home: async ({ id, provide, signal }) => {
-      const document = provideDocumentOf(provide);
-      const placed = document.harness == null ? null : await withWorkersEnvironment({
-        context,
-        projectId,
-        harness: document.harness,
-        owner: { kind: LocalHostOwnerKind.Conversation, id },
-        signal
-      });
-      const homeId = placed?.ownerId ?? id;
-      const discard = () => void placed?.created?.discard().catch(() => void 0);
-      try {
-        const { conversation } = await context.http.request({
-          method: HttpMethod.Post,
-          path: "/v1/conversations/home",
-          body: {
-            schema: homeConversationRequestSchema,
-            value: {
-              projectId,
-              id: homeId,
-              provide: placed == null ? document : { ...document, harness: placed.harness }
-            }
-          },
-          response: conversationResponseSchema,
-          signal
-        });
-        if (conversation.id !== homeId) discard();
-        return opened(conversation);
-      } catch (cause) {
-        discard();
-        throw cause;
-      }
-    },
-    findHome: async (options) => (await context.http.request({
-      method: HttpMethod.Get,
-      path: "/v1/conversations/home",
-      query: { projectId },
-      response: conversationLookupSchema,
-      signal: options?.signal
-    })).conversation,
     direct: async ({ id, agent, provide, actor, signal }) => {
       const started = await startAgent(args.start, {
         projectId,