@finalai/agents 0.13.0 → 0.15.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
 
@@ -118,6 +118,12 @@ gives the model a shell in that backend. A server provides every capability and
 creates its client with `createClient({ auth, localCompute: false })`, so an
 omission fails instead.
 
+In browsers, React Native and Workers, `@finalai/agents/client` resolves (through
+its `browser` and `react-native` export conditions) to a build that imports
+nothing Node-only and serves no compute: `localCompute` defaults to false there,
+and serving in-process tools needs your own `localHosts.dial`. No bundler
+configuration is needed.
+
 An agent is always passed as an object: the value you defined, or one fetched
 with `project.agents.get({ name } | { id } | { hash })`. A fetched agent is data
 only; starting one that has in-process tools fails and names them.

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

@@ -0,0 +1,35 @@
+export * from '@finalai/agent-protocol/agent-platform';
+export { Capability, FilesAccess, ScreenAccess, ShellAccess, type CapabilityAccess, } from '@finalai/agent-protocol';
+export { AcpAuthMode, type AcpApiIface, type AcpConnectArgsIface } from "./acp.mjs";
+export { createTextCollector, isUserMessageFor, sessionUpdateOf, textOf, turnEndOf, type AcpSessionUpdateIface, type TurnEndIface, } from "./acp-frames.mjs";
+export type { AgentInput, AgentValue, AgentValueCodecIface } from "./agent-input.mjs";
+export type { ActorOptionIface, ChannelAppsApiIface, ChannelBindingsApiIface, ChannelSourceIface, ChannelSourceOf, ChannelTicketsApiIface, IdentityLinksApiIface, InstallChannelArgsIface, ProjectChannelsApiIface, PublishChannelArgsIface, UpdateChannelBindingArgsIface, } from "./channels.mjs";
+export { DEFAULT_AGENTS_HOST, type AgentClientIface, type AgentsApiIface, type AppApiIface, type CreateClientOptionsIface, type DecisionsApiIface, type InferenceApiIface, type PeopleApiIface, type PlatformIdentityApiIface, type RealtimeApiIface, } from "./client.mjs";
+export { CollectionEventKind, CollectionResyncReason, type CollectionEvent, type CollectionEventsOptionsIface, type CollectionResyncEventIface, } from "./collection-events.mjs";
+export { ConfigOptionCategory, configSelectFor, configSelectsOf, type ConfigSelectChoiceIface, type ConfigSelectIface, type SessionConfigOptionIface, } from "./config-options.mjs";
+export type { EnumInput, SignalOptionsIface } from "./context.mjs";
+export type { AllowedEndpointsApiIface, BudgetsApiIface, ModelCredentialGrantsApiIface, ModelCredentialsApiIface, OrganizationApiIface, OrganizationPolicyApiIface, SpendingRestrictionsApiIface, } from "./organization.mjs";
+export type { ParticipantConfigurationApiIface } from "./participant-configuration.mjs";
+export type { ConversationChannelRoutesApiIface, ConversationContextApiIface, ConversationContextEntryInputIface, ConversationDecisionsApiIface, ConversationInputsApiIface, ConversationLabelsApiIface, ConversationReadGrantsApiIface, ConversationResourcesIface, ResourceSubscriptionsApiIface, SendInputArgsIface, } from "./conversation-resources.mjs";
+export { TURN_OPEN_SESSION_STATES, isNewerMessageVersion, messageVersionOf, type MessageVersionIface, } from "./conversations.mjs";
+export type { ConversationAgentTurnIface, ConversationEvent, ConversationEventMetaIface, ConversationEventsOptionsIface, ConversationHandleIface, ConversationsApiIface, CreateConversationArgsIface, ListMessagesOptionsIface, OpenedConversationIface, ParticipantCreateInput, ParticipantsApiIface, ProjectConversationsApiIface, SandboxFileContentArgsIface, SandboxFileContentRequestIface, SendMessageOptionsIface, SentMessageIface, UploadAttachmentArgsIface, } from "./conversations.mjs";
+export { AgentClientErrorName, ClientErrorCode, DecisionErrorReason, clientError, decisionError, isClientError, isDecisionError, isRealtimeSubscriptionError, isRequirementsUnmetError, isTerminalRealtimeError, isTurnRejectedError, realtimeSubscriptionError, requirementsUnmetError, turnRejectedError, type AgentClientError, type ClientErrorIface, type DecisionErrorIface, type RealtimeSubscriptionErrorIface, type RequirementsUnmetErrorIface, type TurnRejectedErrorIface, } from "./errors.mjs";
+export { EVENTS_POLL_INTERVAL_MS, type EventsApiIface, type EventSubscriptionsApiIface, type ListEventsOptionsIface, type StreamEventsOptionsIface, } from "./events.mjs";
+export { defaultStreamTiming, type StreamTimingIface } from "./frame-stream.mjs";
+export type { AgentClientAuth, FetchIface, HeadersOption } from "./http.mjs";
+export type { AcpAdaptersApiIface, DefinitionSelectorIface, HarnessesApiIface, SubscriptionAllowancesApiIface, } from "./harnesses.mjs";
+export type { IntegrationsApiIface } from "./integrations.mjs";
+export { SessionLiveEventKind, type SessionLiveEvent } from "./live-stream.mjs";
+export type { LocalComputeIface } from "./local-host.mjs";
+export type { OAuthClientsApiIface, SignInReturnOriginsApiIface } from "./oauth-clients.mjs";
+export type { ProjectClientIface } from "./project.mjs";
+export type { AgentSelectorIface, ProjectAgentsApiIface } from "./project-agents.mjs";
+export type { ProjectApiKeysApiIface, ProjectMembersApiIface, ProjectResourceApiIface, ProjectsApiIface, } from "./projects.mjs";
+export type { ProjectPublisherApiIface, PublicNamesApiIface, PublisherHandleIface, PublishersApiIface, } from "./publishers.mjs";
+export { provideDocumentOf, resourceIdOf, type ProvideIface, type ProvidePatchIface, type ResourceRef, type ResourceRefIface, } from "./provide.mjs";
+export { createGatewayRealtimeTransport, type GatewayConnect, type GatewayConnectionIface, type GatewayRealtimeTransportOptionsIface, type RealtimeSubscribeOptionsIface, type RealtimeTransportFrameIface, type RealtimeTransportIface, } from "./realtime.mjs";
+export { SANDBOX_FILE_URI_SCHEME, createSandboxFileUri, parseSandboxFileUri, type SandboxFileTargetIface, } from "./sandbox-uri.mjs";
+export type { SandboxProvidersApiIface } from "./sandbox-providers.mjs";
+export type { CreateSandboxOptionsIface, SandboxEnvironmentValueIface, SandboxHandleIface, SandboxOwnerIface, SandboxSetupRefIface, SandboxSetupsApiIface, SandboxesApiIface, } from "./sandboxes.mjs";
+export type { ProjectSchedulesApiIface } from "./schedules.mjs";
+export type { CreateSessionArgsIface, CreatedSessionIface, ForkSessionOptionsIface, ProjectSessionsApiIface, RespondArgs, SendOptionsIface, SessionHandleIface, SessionsApiIface, StreamOptionsIface, TurnHandleIface, TurnResultIface, } from "./sessions.mjs";

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

@@ -0,0 +1,110 @@
+export * from "@finalai/agent-protocol/agent-platform";
+import {
+  Capability,
+  FilesAccess,
+  ScreenAccess,
+  ShellAccess
+} from "@finalai/agent-protocol";
+import { AcpAuthMode } from "./acp.mjs";
+import {
+  createTextCollector,
+  isUserMessageFor,
+  sessionUpdateOf,
+  textOf,
+  turnEndOf
+} from "./acp-frames.mjs";
+import {
+  DEFAULT_AGENTS_HOST
+} from "./client.mjs";
+import {
+  CollectionEventKind,
+  CollectionResyncReason
+} from "./collection-events.mjs";
+import {
+  ConfigOptionCategory,
+  configSelectFor,
+  configSelectsOf
+} from "./config-options.mjs";
+import {
+  TURN_OPEN_SESSION_STATES,
+  isNewerMessageVersion,
+  messageVersionOf
+} from "./conversations.mjs";
+import {
+  AgentClientErrorName,
+  ClientErrorCode,
+  DecisionErrorReason,
+  clientError,
+  decisionError,
+  isClientError,
+  isDecisionError,
+  isRealtimeSubscriptionError,
+  isRequirementsUnmetError,
+  isTerminalRealtimeError,
+  isTurnRejectedError,
+  realtimeSubscriptionError,
+  requirementsUnmetError,
+  turnRejectedError
+} from "./errors.mjs";
+import {
+  EVENTS_POLL_INTERVAL_MS
+} from "./events.mjs";
+import { defaultStreamTiming } from "./frame-stream.mjs";
+import { SessionLiveEventKind } from "./live-stream.mjs";
+import {
+  provideDocumentOf,
+  resourceIdOf
+} from "./provide.mjs";
+import {
+  createGatewayRealtimeTransport
+} from "./realtime.mjs";
+import {
+  SANDBOX_FILE_URI_SCHEME,
+  createSandboxFileUri,
+  parseSandboxFileUri
+} from "./sandbox-uri.mjs";
+export {
+  AcpAuthMode,
+  AgentClientErrorName,
+  Capability,
+  ClientErrorCode,
+  CollectionEventKind,
+  CollectionResyncReason,
+  ConfigOptionCategory,
+  DEFAULT_AGENTS_HOST,
+  DecisionErrorReason,
+  EVENTS_POLL_INTERVAL_MS,
+  FilesAccess,
+  SANDBOX_FILE_URI_SCHEME,
+  ScreenAccess,
+  SessionLiveEventKind,
+  ShellAccess,
+  TURN_OPEN_SESSION_STATES,
+  clientError,
+  configSelectFor,
+  configSelectsOf,
+  createGatewayRealtimeTransport,
+  createSandboxFileUri,
+  createTextCollector,
+  decisionError,
+  defaultStreamTiming,
+  isClientError,
+  isDecisionError,
+  isNewerMessageVersion,
+  isRealtimeSubscriptionError,
+  isRequirementsUnmetError,
+  isTerminalRealtimeError,
+  isTurnRejectedError,
+  isUserMessageFor,
+  messageVersionOf,
+  parseSandboxFileUri,
+  provideDocumentOf,
+  realtimeSubscriptionError,
+  requirementsUnmetError,
+  resourceIdOf,
+  sessionUpdateOf,
+  textOf,
+  turnEndOf,
+  turnRejectedError
+};
+//# sourceMappingURL=api.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/agent-client/api.ts"],
+  "sourcesContent": ["// Everything `@finalai/agents/client` exports in every runtime except\n// `createClient`, which each runtime's entry binds to its own defaults.\n// Wire types come from `@finalai/agent-protocol/agent-platform`, re-exported\n// here so consumers need one import.\n\nexport * from '@finalai/agent-protocol/agent-platform';\nexport {\n  Capability,\n  FilesAccess,\n  ScreenAccess,\n  ShellAccess,\n  type CapabilityAccess,\n} from '@finalai/agent-protocol';\nexport { AcpAuthMode, type AcpApiIface, type AcpConnectArgsIface } from \"./acp.mjs\";\nexport {\n  createTextCollector,\n  isUserMessageFor,\n  sessionUpdateOf,\n  textOf,\n  turnEndOf,\n  type AcpSessionUpdateIface,\n  type TurnEndIface,\n} from \"./acp-frames.mjs\";\nexport type { AgentInput, AgentValue, AgentValueCodecIface } from \"./agent-input.mjs\";\nexport type {\n  ActorOptionIface,\n  ChannelAppsApiIface,\n  ChannelBindingsApiIface,\n  ChannelSourceIface,\n  ChannelSourceOf,\n  ChannelTicketsApiIface,\n  IdentityLinksApiIface,\n  InstallChannelArgsIface,\n  ProjectChannelsApiIface,\n  PublishChannelArgsIface,\n  UpdateChannelBindingArgsIface,\n} from \"./channels.mjs\";\nexport {\n  DEFAULT_AGENTS_HOST,\n  type AgentClientIface,\n  type AgentsApiIface,\n  type AppApiIface,\n  type CreateClientOptionsIface,\n  type DecisionsApiIface,\n  type InferenceApiIface,\n  type PeopleApiIface,\n  type PlatformIdentityApiIface,\n  type RealtimeApiIface,\n} from \"./client.mjs\";\nexport {\n  CollectionEventKind,\n  CollectionResyncReason,\n  type CollectionEvent,\n  type CollectionEventsOptionsIface,\n  type CollectionResyncEventIface,\n} from \"./collection-events.mjs\";\nexport {\n  ConfigOptionCategory,\n  configSelectFor,\n  configSelectsOf,\n  type ConfigSelectChoiceIface,\n  type ConfigSelectIface,\n  type SessionConfigOptionIface,\n} from \"./config-options.mjs\";\nexport type { EnumInput, SignalOptionsIface } from \"./context.mjs\";\nexport type {\n  AllowedEndpointsApiIface,\n  BudgetsApiIface,\n  ModelCredentialGrantsApiIface,\n  ModelCredentialsApiIface,\n  OrganizationApiIface,\n  OrganizationPolicyApiIface,\n  SpendingRestrictionsApiIface,\n} from \"./organization.mjs\";\nexport type { ParticipantConfigurationApiIface } from \"./participant-configuration.mjs\";\nexport type {\n  ConversationChannelRoutesApiIface,\n  ConversationContextApiIface,\n  ConversationContextEntryInputIface,\n  ConversationDecisionsApiIface,\n  ConversationInputsApiIface,\n  ConversationLabelsApiIface,\n  ConversationReadGrantsApiIface,\n  ConversationResourcesIface,\n  ResourceSubscriptionsApiIface,\n  SendInputArgsIface,\n} from \"./conversation-resources.mjs\";\nexport {\n  TURN_OPEN_SESSION_STATES,\n  isNewerMessageVersion,\n  messageVersionOf,\n  type MessageVersionIface,\n} from \"./conversations.mjs\";\nexport type {\n  ConversationAgentTurnIface,\n  ConversationEvent,\n  ConversationEventMetaIface,\n  ConversationEventsOptionsIface,\n  ConversationHandleIface,\n  ConversationsApiIface,\n  CreateConversationArgsIface,\n  ListMessagesOptionsIface,\n  OpenedConversationIface,\n  ParticipantCreateInput,\n  ParticipantsApiIface,\n  ProjectConversationsApiIface,\n  SandboxFileContentArgsIface,\n  SandboxFileContentRequestIface,\n  SendMessageOptionsIface,\n  SentMessageIface,\n  UploadAttachmentArgsIface,\n} from \"./conversations.mjs\";\nexport {\n  AgentClientErrorName,\n  ClientErrorCode,\n  DecisionErrorReason,\n  clientError,\n  decisionError,\n  isClientError,\n  isDecisionError,\n  isRealtimeSubscriptionError,\n  isRequirementsUnmetError,\n  isTerminalRealtimeError,\n  isTurnRejectedError,\n  realtimeSubscriptionError,\n  requirementsUnmetError,\n  turnRejectedError,\n  type AgentClientError,\n  type ClientErrorIface,\n  type DecisionErrorIface,\n  type RealtimeSubscriptionErrorIface,\n  type RequirementsUnmetErrorIface,\n  type TurnRejectedErrorIface,\n} from \"./errors.mjs\";\nexport {\n  EVENTS_POLL_INTERVAL_MS,\n  type EventsApiIface,\n  type EventSubscriptionsApiIface,\n  type ListEventsOptionsIface,\n  type StreamEventsOptionsIface,\n} from \"./events.mjs\";\nexport { defaultStreamTiming, type StreamTimingIface } from \"./frame-stream.mjs\";\nexport type { AgentClientAuth, FetchIface, HeadersOption } from \"./http.mjs\";\nexport type {\n  AcpAdaptersApiIface,\n  DefinitionSelectorIface,\n  HarnessesApiIface,\n  SubscriptionAllowancesApiIface,\n} from \"./harnesses.mjs\";\nexport type { IntegrationsApiIface } from \"./integrations.mjs\";\nexport { SessionLiveEventKind, type SessionLiveEvent } from \"./live-stream.mjs\";\nexport type { LocalComputeIface } from \"./local-host.mjs\";\nexport type { OAuthClientsApiIface, SignInReturnOriginsApiIface } from \"./oauth-clients.mjs\";\nexport type { ProjectClientIface } from \"./project.mjs\";\nexport type { AgentSelectorIface, ProjectAgentsApiIface } from \"./project-agents.mjs\";\nexport type {\n  ProjectApiKeysApiIface,\n  ProjectMembersApiIface,\n  ProjectResourceApiIface,\n  ProjectsApiIface,\n} from \"./projects.mjs\";\nexport type {\n  ProjectPublisherApiIface,\n  PublicNamesApiIface,\n  PublisherHandleIface,\n  PublishersApiIface,\n} from \"./publishers.mjs\";\nexport {\n  provideDocumentOf,\n  resourceIdOf,\n  type ProvideIface,\n  type ProvidePatchIface,\n  type ResourceRef,\n  type ResourceRefIface,\n} from \"./provide.mjs\";\nexport {\n  createGatewayRealtimeTransport,\n  type GatewayConnect,\n  type GatewayConnectionIface,\n  type GatewayRealtimeTransportOptionsIface,\n  type RealtimeSubscribeOptionsIface,\n  type RealtimeTransportFrameIface,\n  type RealtimeTransportIface,\n} from \"./realtime.mjs\";\nexport {\n  SANDBOX_FILE_URI_SCHEME,\n  createSandboxFileUri,\n  parseSandboxFileUri,\n  type SandboxFileTargetIface,\n} from \"./sandbox-uri.mjs\";\nexport type { SandboxProvidersApiIface } from \"./sandbox-providers.mjs\";\nexport type {\n  CreateSandboxOptionsIface,\n  SandboxEnvironmentValueIface,\n  SandboxHandleIface,\n  SandboxOwnerIface,\n  SandboxSetupRefIface,\n  SandboxSetupsApiIface,\n  SandboxesApiIface,\n} from \"./sandboxes.mjs\";\nexport type { ProjectSchedulesApiIface } from \"./schedules.mjs\";\nexport type {\n  CreateSessionArgsIface,\n  CreatedSessionIface,\n  ForkSessionOptionsIface,\n  ProjectSessionsApiIface,\n  RespondArgs,\n  SendOptionsIface,\n  SessionHandleIface,\n  SessionsApiIface,\n  StreamOptionsIface,\n  TurnHandleIface,\n  TurnResultIface,\n} from \"./sessions.mjs\";\n"],
+  "mappings": "AAKA,cAAc;AACd;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AACP,SAAS,mBAA+D;AACxE;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAeP;AAAA,EACE;AAAA,OAUK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OAIK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AAwBP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;AAoBP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAOK;AACP;AAAA,EACE;AAAA,OAKK;AACP,SAAS,2BAAmD;AAS5D,SAAS,4BAAmD;AAiB5D;AAAA,EACE;AAAA,EACA;AAAA,OAKK;AACP;AAAA,EACE;AAAA,OAOK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAEK;",
+  "names": []
+}

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";
@@ -6,11 +6,12 @@ import { type SignalOptionsIface } from "./context.mjs";
 import { type ConversationsApiIface } from "./conversations.mjs";
 import { type EventsApiIface, type EventSubscriptionsApiIface } from "./events.mjs";
 import { type StreamTimingIface } from "./frame-stream.mjs";
-import { type AgentClientAuth, type FetchIface, type HeadersOption } from "./http.mjs";
+import { type AgentClientAuth, type FetchIface, type HeadersOption, type HttpIface } from "./http.mjs";
 import { type GatewayConnect, type RealtimeTransportIface } from "./realtime.mjs";
 import type { LocalComputeIface, LocalHostSocketIface } from "./local-host.mjs";
 import { type ProjectClientIface } from "./project.mjs";
 import { type ProjectsApiIface } from "./projects.mjs";
+import { type OrganizationApiIface } from "./organization.mjs";
 import { type PublishersApiIface } from "./publishers.mjs";
 import { type SessionsApiIface } from "./sessions.mjs";
 /** Final's agents API. */
@@ -19,10 +20,11 @@ export interface CreateClientOptionsIface {
     auth: AgentClientAuth;
     /**
      * Whether this process provides the files and shell an agent requires when
-     * the caller leaves them out (default true), so the model's file edits and
-     * commands run here, on this machine. A server should provide every
-     * capability explicitly and pass false, so an omission fails with
-     * `requirements_unmet` instead of giving the model a shell in the server.
+     * the caller leaves them out, so the model's file edits and commands run
+     * here, on this machine. Defaults to true in Node and false in browsers and
+     * React Native, which have no files or shell to give. A server should
+     * provide every capability explicitly and pass false, so an omission fails
+     * with `requirements_unmet` instead of giving the model a shell in the server.
      */
     localCompute?: boolean;
     /**
@@ -74,6 +76,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 +150,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;
@@ -168,4 +179,15 @@ export interface AgentClientIface {
     close: () => void;
     [Symbol.asyncDispose]: () => Promise<void>;
 }
-export declare const createClient: (options: CreateClientOptionsIface) => AgentClientIface;
+/**
+ * What `createClient` uses unless a seam replaces it, where that differs by
+ * runtime: Node serves compute and dials the local host socket itself;
+ * browsers and React Native do neither unless the caller passes the seams.
+ */
+export interface ClientRuntimeIface {
+    /** `localCompute` when the caller leaves it out. */
+    localCompute: boolean;
+    compute: () => LocalComputeIface;
+    dial: (http: HttpIface) => (path: string, signal?: AbortSignal) => Promise<LocalHostSocketIface>;
+}
+export declare const createClientFor: (runtime: ClientRuntimeIface, options: CreateClientOptionsIface) => AgentClientIface;

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

@@ -1,6 +1,7 @@
 import {
   agentListSchema,
   agentRealtimeTopics,
+  agentSummarySchema,
   decisionResponseSchema,
   healthResponseSchema,
   inferenceOfferingSchema,
@@ -17,12 +18,7 @@ import {
 } from "./channels.mjs";
 import { encodePath } from "./context.mjs";
 import { createConversationsApi } from "./conversations.mjs";
-import {
-  defaultAgentCodec,
-  defaultChannelSourceOf,
-  defaultLocalCompute,
-  defaultLocalHostDial
-} from "./defaults.mjs";
+import { defaultAgentCodec, defaultChannelSourceOf } from "./defaults.mjs";
 import { clientError, ClientErrorCode } from "./errors.mjs";
 import {
   createEventsApi,
@@ -38,10 +34,11 @@ 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";
-const createClient = (options) => {
+const createClientFor = (runtime, options) => {
   const http = createHttp({
     host: options.host ?? DEFAULT_AGENTS_HOST,
     auth: options.auth,
@@ -108,13 +105,12 @@ const createClient = (options) => {
     now: options.now ?? Date.now
   };
   const hosts = /* @__PURE__ */ new Set();
-  const localCompute = defaultLocalCompute();
   const start = {
     context,
     codec: options.agentCodec ?? defaultAgentCodec,
-    localCompute: options.localCompute ?? true,
-    compute: { ...localCompute, ...options.localHosts?.compute },
-    dial: options.localHosts?.dial ?? defaultLocalHostDial(http),
+    localCompute: options.localCompute ?? runtime.localCompute,
+    compute: { ...runtime.compute(), ...options.localHosts?.compute },
+    dial: options.localHosts?.dial ?? runtime.dial(http),
     hosts
   };
   const channelSourceOf = options.channelSourceOf ?? defaultChannelSourceOf;
@@ -148,6 +144,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 +179,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,
@@ -219,6 +222,6 @@ const createClient = (options) => {
 };
 export {
   DEFAULT_AGENTS_HOST,
-  createClient
+  createClientFor
 };
 //# sourceMappingURL=client.mjs.map

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/agent-client/client.ts"],
-  "sourcesContent": ["import {\n  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": "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",
+  "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 { defaultAgentCodec, defaultChannelSourceOf } 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  type HttpIface,\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, so the model's file edits and commands run\n   * here, on this machine. Defaults to true in Node and false in browsers and\n   * React Native, which have no files or shell to give. A server should\n   * provide every capability explicitly and pass false, so an omission fails\n   * with `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\n/**\n * What `createClient` uses unless a seam replaces it, where that differs by\n * runtime: Node serves compute and dials the local host socket itself;\n * browsers and React Native do neither unless the caller passes the seams.\n */\nexport interface ClientRuntimeIface {\n  /** `localCompute` when the caller leaves it out. */\n  localCompute: boolean;\n  compute: () => LocalComputeIface;\n  dial: (http: HttpIface) => (path: string, signal?: AbortSignal) => Promise<LocalHostSocketIface>;\n}\n\nexport const createClientFor = (\n  runtime: ClientRuntimeIface,\n  options: CreateClientOptionsIface,\n): 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 start: AgentStartDepsIface = {\n    context,\n    codec: options.agentCodec ?? defaultAgentCodec,\n    localCompute: options.localCompute ?? runtime.localCompute,\n    compute: { ...runtime.compute(), ...options.localHosts?.compute },\n    dial: options.localHosts?.dial ?? runtime.dial(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": []
 }