@finalai/agents 0.11.0 → 0.13.0

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

@@ -1,49 +1,232 @@
 import {
+  channelAppListSchema,
+  channelAppResponseSchema,
+  channelBindingListSchema,
+  channelBindingResponseSchema,
+  channelIdentityLinkListSchema,
+  channelIdentityLinkProgressSchema,
+  channelPlaceConnectionResponseSchema,
   channelPlacesResponseSchema,
-  channelRoutesResponseSchema,
-  connectChannelPlaceRequestSchema,
-  connectChannelPlaceResponseSchema,
-  createChannelBindingRequestSchema,
-  createChannelBindingResponseSchema,
-  disconnectChannelRouteResponseSchema
+  channelSchema,
+  channelTenantTicketSchema,
+  channelTicketSchema,
+  completeChannelIdentityLinkRequestSchema,
+  completeChannelPlaceConnectionRequestSchema,
+  createChannelAppRequestSchema,
+  installChannelRequestSchema,
+  installedChannelResponseSchema,
+  okResponseSchema,
+  publishChannelRequestSchema,
+  publishChannelResponseSchema,
+  uninstallChannelBindingResponseSchema,
+  updateChannelAppRequestSchema,
+  updateChannelBindingRequestSchema,
+  updateChannelIdentityLinkRequestSchema
 } from "@finalai/agent-protocol/agent-platform";
-import { encodePath } from "./context.mjs";
+import {
+  encodePath
+} from "./context.mjs";
+import { clientError, ClientErrorCode } from "./errors.mjs";
 import { HttpMethod } from "./http.mjs";
+import { provideDocumentOf } from "./provide.mjs";
+const channelsPath = (projectId, suffix) => `/v1/projects/${encodePath(projectId)}/channels${suffix}`;
+const bindingPath = (bindingId, suffix = "") => `/v1/channel-bindings/${encodePath(bindingId)}${suffix}`;
+const createProjectChannelsApi = (args) => {
+  const { http } = args.context;
+  const installsPath = `/v1/projects/${encodePath(args.projectId)}/channel-bindings`;
+  return {
+    publish: (publish) => {
+      const source = "channel" in publish ? args.sourceOf(publish.channel) : {
+        source: publish.source,
+        ...publish.export == null ? {} : { export: publish.export }
+      };
+      return http.request({
+        method: HttpMethod.Post,
+        path: channelsPath(args.projectId, "/publish"),
+        body: {
+          schema: publishChannelRequestSchema,
+          value: {
+            name: publish.name,
+            ...source,
+            visibility: publish.visibility,
+            app: publish.app
+          }
+        },
+        response: publishChannelResponseSchema,
+        signal: publish.signal
+      });
+    },
+    get: ({ signal, ...selector }) => http.request({
+      method: HttpMethod.Get,
+      path: channelsPath(args.projectId, "/lookup"),
+      query: {
+        name: "name" in selector ? selector.name : void 0,
+        hash: "hash" in selector ? selector.hash : void 0
+      },
+      response: channelSchema,
+      signal
+    }),
+    install: ({ signal, agents, ...install }) => http.request({
+      method: HttpMethod.Post,
+      path: installsPath,
+      body: {
+        schema: installChannelRequestSchema,
+        value: { ...install, agents: { provide: provideDocumentOf(agents.provide) } }
+      },
+      response: installedChannelResponseSchema,
+      signal
+    }),
+    installs: async (options) => (await http.request({
+      method: HttpMethod.Get,
+      path: installsPath,
+      query: { includeArchived: options?.includeArchived === true ? "true" : void 0 },
+      response: channelBindingListSchema,
+      signal: options?.signal
+    })).bindings
+  };
+};
 const createChannelBindingsApi = (ctx) => ({
-  create: ({ signal, ...body }) => ctx.http.request({
-    method: HttpMethod.Post,
-    path: "/v1/channel-bindings",
-    body: { schema: createChannelBindingRequestSchema, value: body },
-    response: createChannelBindingResponseSchema,
-    signal
-  }),
-  places: async ({ bindingId, signal }) => (await ctx.http.request({
+  get: async ({ bindingId, signal }) => (await ctx.http.request({
     method: HttpMethod.Get,
-    path: `/v1/channel-bindings/${encodePath(bindingId)}/places`,
-    response: channelPlacesResponseSchema,
+    path: bindingPath(bindingId),
+    response: channelBindingResponseSchema,
     signal
-  })).places,
-  routes: async ({ conversationId, signal }) => (await ctx.http.request({
-    method: HttpMethod.Get,
-    path: `/v1/conversations/${encodePath(conversationId)}/channel-routes`,
-    response: channelRoutesResponseSchema,
+  })).binding,
+  update: ({ bindingId, signal, agents, ...change }) => ctx.http.request({
+    method: HttpMethod.Patch,
+    path: bindingPath(bindingId),
+    body: {
+      schema: updateChannelBindingRequestSchema,
+      value: {
+        ...change,
+        ...agents == null ? {} : { agents: { provide: provideDocumentOf(agents.provide) } }
+      }
+    },
+    response: installedChannelResponseSchema,
+    signal
+  }),
+  uninstall: ({ bindingId, signal }) => ctx.http.request({
+    method: HttpMethod.Delete,
+    path: bindingPath(bindingId),
+    response: uninstallChannelBindingResponseSchema,
     signal
-  })).routes,
-  connect: ({ conversationId, signal, ...body }) => ctx.http.request({
+  }),
+  tenantTicket: ({ bindingId, signal }) => ctx.http.request({
     method: HttpMethod.Post,
-    path: `/v1/conversations/${encodePath(conversationId)}/channel-routes`,
-    body: { schema: connectChannelPlaceRequestSchema, value: body },
-    response: connectChannelPlaceResponseSchema,
+    path: bindingPath(bindingId, "/tenant-tickets"),
+    response: channelTenantTicketSchema,
     signal
   }),
-  disconnect: ({ conversationId, routeId, signal }) => ctx.http.request({
-    method: HttpMethod.Delete,
-    path: `/v1/conversations/${encodePath(conversationId)}/channel-routes/${encodePath(routeId)}`,
-    response: disconnectChannelRouteResponseSchema,
+  places: async ({ bindingId, signal }) => (await ctx.http.request({
+    method: HttpMethod.Get,
+    path: bindingPath(bindingId, "/places"),
+    response: channelPlacesResponseSchema,
     signal
-  })
+  })).places
 });
+const createChannelAppsApi = (args) => {
+  const { http } = args.context;
+  const appPath = (id) => `/v1/channel-apps/${encodePath(id)}`;
+  return {
+    create: async ({ signal, ...value }) => (await http.request({
+      method: HttpMethod.Post,
+      path: `/v1/projects/${encodePath(args.projectId)}/channel-apps`,
+      body: { schema: createChannelAppRequestSchema, value },
+      response: channelAppResponseSchema,
+      signal
+    })).app,
+    list: async (options) => (await http.request({
+      method: HttpMethod.Get,
+      path: `/v1/projects/${encodePath(args.projectId)}/channel-apps`,
+      response: channelAppListSchema,
+      signal: options?.signal
+    })).apps,
+    update: async ({ id, signal, ...value }) => (await http.request({
+      method: HttpMethod.Patch,
+      path: appPath(id),
+      body: { schema: updateChannelAppRequestSchema, value },
+      response: channelAppResponseSchema,
+      signal
+    })).app,
+    delete: async ({ id, signal }) => {
+      await http.request({
+        method: HttpMethod.Delete,
+        path: appPath(id),
+        response: okResponseSchema,
+        signal
+      });
+    }
+  };
+};
+const createChannelTicketsApi = (ctx) => {
+  const ticketPath = (ticket, suffix = "") => `/v1/channel-tickets/${encodePath(ticket)}${suffix}`;
+  return {
+    get: ({ ticket, actor, signal }) => ctx.http.request({
+      method: HttpMethod.Get,
+      path: ticketPath(ticket),
+      query: { actor },
+      response: channelTicketSchema,
+      signal
+    }),
+    link: ({ ticket, signal, ...value }) => ctx.http.request({
+      method: HttpMethod.Post,
+      path: ticketPath(ticket, "/identity-link"),
+      body: { schema: completeChannelIdentityLinkRequestSchema, value },
+      response: channelIdentityLinkProgressSchema,
+      signal
+    }),
+    connect: ({ ticket, signal, ...value }) => ctx.http.request({
+      method: HttpMethod.Post,
+      path: ticketPath(ticket, "/place-connection"),
+      body: { schema: completeChannelPlaceConnectionRequestSchema, value },
+      response: channelPlaceConnectionResponseSchema,
+      signal
+    })
+  };
+};
+const createIdentityLinksApi = (ctx) => {
+  const linksPath = (suffix = "") => `/v1/people/me/identity-links${suffix}`;
+  return {
+    list: async (options) => (await ctx.http.request({
+      method: HttpMethod.Get,
+      path: linksPath(),
+      query: { actor: options?.actor },
+      response: channelIdentityLinkListSchema,
+      signal: options?.signal
+    })).links,
+    update: async ({ id, signal, ...value }) => {
+      await ctx.http.request({
+        method: HttpMethod.Patch,
+        path: linksPath(`/${encodePath(id)}`),
+        body: { schema: updateChannelIdentityLinkRequestSchema, value },
+        response: okResponseSchema,
+        signal
+      });
+    },
+    delete: async ({ id, actor, signal }) => {
+      await ctx.http.request({
+        method: HttpMethod.Delete,
+        path: linksPath(`/${encodePath(id)}`),
+        query: { actor },
+        response: okResponseSchema,
+        signal
+      });
+    }
+  };
+};
+const noChannelSource = () => {
+  throw clientError({
+    message: "Publish a channel as `source`: this build cannot capture a channel value",
+    status: 0,
+    code: ClientErrorCode.InvalidRequest
+  });
+};
 export {
-  createChannelBindingsApi
+  createChannelAppsApi,
+  createChannelBindingsApi,
+  createChannelTicketsApi,
+  createIdentityLinksApi,
+  createProjectChannelsApi,
+  noChannelSource
 };
 //# sourceMappingURL=channels.mjs.map

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

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

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

@@ -1,20 +1,35 @@
-import { type AgentInfoIface, type AgentListIface, type HealthResponseIface, type PersonIface, type PersonListIface, type RealtimeSessionResponseIface } from '@finalai/agent-protocol/agent-platform';
+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 AcpApiIface } from "./acp.mjs";
-import { type ComputerSetupGuidesApiIface, type DefinitionsApiIface, type ProvidersApiIface, type SchedulesApiIface } from "./build.mjs";
+import type { AgentValueCodecIface } from "./agent-input.mjs";
+import { type ChannelBindingsApiIface, type ChannelSourceOf, type ChannelTicketsApiIface, type IdentityLinksApiIface } from "./channels.mjs";
 import { type SignalOptionsIface } from "./context.mjs";
-import { type ChannelBindingsApiIface } from "./channels.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 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 PublishersApiIface } from "./publishers.mjs";
 import { type SessionsApiIface } from "./sessions.mjs";
+/** Final's agents API. */
+export declare const DEFAULT_AGENTS_HOST = "https://agent-session.final.ai";
 export interface CreateClientOptionsIface {
+    auth: AgentClientAuth;
     /**
-     * The agents API origin (`https://agent-session.final.ai`; its API is under
-     * `/api` and ACP at `/acp/ws`), or a base URL the API routes are mounted under.
+     * 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.
      */
-    host: string;
-    auth: AgentClientAuth;
+    localCompute?: boolean;
+    /**
+     * The agents API origin (default `https://agent-session.final.ai`; its API is
+     * under `/api` and ACP at `/acp/ws`), or a base URL the API routes are mounted under.
+     */
+    host?: string;
     /** Extra headers per request; console clients send their client identity header here. */
     headers?: HeadersOption;
     /** API requests (the host's routes); carries auth and caller headers. */
@@ -36,24 +51,29 @@ export interface CreateClientOptionsIface {
     newKey?: () => string;
     /** Seam for the client clock (conversation recovery windows). */
     now?: () => number;
-}
-export interface AgentHandleIface {
-    slug: string;
-    info: (options?: SignalOptionsIface) => Promise<AgentInfoIface>;
+    /** Seam: how agent values become documents and in-process code. */
+    agentCodec?: AgentValueCodecIface;
+    /** Seam: how a channel value becomes its source. */
+    channelSourceOf?: ChannelSourceOf;
+    /** Seams for local hosts: the socket, and the sandbox this process serves. */
+    localHosts?: {
+        /** Opens the local host socket; abandons it when `signal` aborts. */
+        dial?: (path: string, signal?: AbortSignal) => Promise<LocalHostSocketIface>;
+        compute?: Partial<LocalComputeIface>;
+    };
 }
 export interface AgentsApiIface {
     /**
      * The agents the caller can use; with `projectId`, those usable there (its own and those
      * inherited from its ancestors). Without it, everything the caller can access (an API key: its
      * parent project and every project it is granted; a person: every project they can read).
+     * Fetch one as data with `client.project({ id }).agents.get`.
      */
     list: (options?: SignalOptionsIface & {
         cursor?: string;
         limit?: number;
         projectId?: string;
     }) => Promise<AgentListIface>;
-    /** I/O-free handle by slug or id. */
-    get: (slugOrId: string) => AgentHandleIface;
 }
 export interface PeopleApiIface {
     /** One page of the caller's organization members, by name; pass `nextCursor` as `cursor` for the next. */
@@ -63,6 +83,10 @@ export interface PeopleApiIface {
     }) => Promise<PersonListIface>;
     /** Every member of the caller's organization (all pages). */
     all: (options?: SignalOptionsIface) => Promise<PersonIface[]>;
+    /** The caller's own person (or, for an API key or app, the actor it names). */
+    me: {
+        identityLinks: IdentityLinksApiIface;
+    };
 }
 export interface RealtimeApiIface {
     /**
@@ -72,28 +96,74 @@ export interface RealtimeApiIface {
      */
     createSession: (options?: SignalOptionsIface) => Promise<RealtimeSessionResponseIface>;
 }
+export interface InferenceApiIface {
+    /**
+     * The vendors and models the platform's own metered inference serves, with
+     * prices (`GET /v1/inference/offering`, public). A harness using the
+     * platform's inference can run only models listed here.
+     */
+    offering: (options?: SignalOptionsIface) => Promise<InferenceOfferingIface>;
+}
+export interface PlatformIdentityApiIface {
+    /**
+     * Exchanges a sandbox-provider (or downstream) assertion the platform issued
+     * for a fresh one: for the provider's own URL (a refresh) or a backend its
+     * registration was granted. The subject token is the credential.
+     */
+    exchange: (args: PlatformIdentityExchangeRequestIface & SignalOptionsIface) => Promise<PlatformIdentityExchangeResponseIface>;
+}
+export interface DecisionsApiIface {
+    /** One decision awaiting the caller's answer, as `conversations.decisions` lists it. */
+    get: (args: {
+        id: string;
+    } & SignalOptionsIface) => Promise<DecisionIface>;
+}
+export interface AppApiIface {
+    /**
+     * The calling app's event subscriptions, across every organization that
+     * installed it. Needs an app-level token.
+     */
+    eventSubscriptions: EventSubscriptionsApiIface;
+}
 export interface AgentClientIface {
+    /** One project: where sessions, conversations, sandboxes and integrations are created. */
+    project: (args: {
+        id: string;
+    }) => ProjectClientIface;
+    /** The project tree: list projects and create them. */
+    projects: ProjectsApiIface;
+    /** The event feed across everything the caller can see; `project({ id }).events` narrows it. */
+    events: EventsApiIface;
+    app: AppApiIface;
+    /** Publishers' public agents, channels, harnesses and ACP adapters. */
+    publishers: PublishersApiIface;
+    inference: InferenceApiIface;
+    platformIdentity: PlatformIdentityApiIface;
+    decisions: DecisionsApiIface;
     health: (options?: SignalOptionsIface) => Promise<HealthResponseIface>;
     agents: AgentsApiIface;
     people: PeopleApiIface;
     realtime: RealtimeApiIface;
+    /** Existing sessions by id; create them through `project({ id }).sessions`. */
     sessions: SessionsApiIface;
+    /** The caller's conversations; create them through `project({ id }).conversations`. */
     conversations: ConversationsApiIface;
+    /** Channel installs by id; install them through `project({ id }).channels`. */
     channelBindings: ChannelBindingsApiIface;
-    definitions: DefinitionsApiIface;
-    providers: ProvidersApiIface;
-    computerSetupGuides: ComputerSetupGuidesApiIface;
-    schedules: SchedulesApiIface;
+    /** Tickets from an installer's link and connect pages. */
+    channelTickets: ChannelTicketsApiIface;
     /**
      * ACP-native access (`/acp/ws`): an ACP v2 ClientApp connection on which the
      * agents API is the agent. The ACP SDK loads on the first `connect`.
      */
     acp: AcpApiIface;
     /**
-     * Ends every stream (they reject with a `client_closed` ClientError) and, when
-     * the client created its own realtime transport, closes the gateway connection
-     * and cancels its retries. A transport passed in `realtime` belongs to the
-     * caller and is left open. Idempotent.
+     * Ends every stream (they reject with a `client_closed` ClientError) and every
+     * local host connection (the platform then reports this process's tools and
+     * compute as unavailable; sessions carry on) and, when the client created its
+     * own realtime transport, closes the gateway connection and cancels its
+     * retries. A transport passed in `realtime` belongs to the caller and is left
+     * open. Idempotent.
      */
     close: () => void;
     [Symbol.asyncDispose]: () => Promise<void>;

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

@@ -1,22 +1,33 @@
 import {
-  agentInfoSchema,
   agentListSchema,
   agentRealtimeTopics,
+  decisionResponseSchema,
   healthResponseSchema,
+  inferenceOfferingSchema,
   personListSchema,
+  platformIdentityExchangeRequestSchema,
+  platformIdentityExchangeResponseSchema,
   realtimeSessionResponseSchema
 } from "@finalai/agent-protocol/agent-platform";
 import { createAcpApi } from "./acp.mjs";
 import {
-  createComputerSetupGuidesApi,
-  createDefinitionsApi,
-  createProvidersApi,
-  createSchedulesApi
-} from "./build.mjs";
+  createChannelBindingsApi,
+  createChannelTicketsApi,
+  createIdentityLinksApi
+} from "./channels.mjs";
 import { encodePath } from "./context.mjs";
-import { createChannelBindingsApi } from "./channels.mjs";
 import { createConversationsApi } from "./conversations.mjs";
+import {
+  defaultAgentCodec,
+  defaultChannelSourceOf,
+  defaultLocalCompute,
+  defaultLocalHostDial
+} from "./defaults.mjs";
 import { clientError, ClientErrorCode } from "./errors.mjs";
+import {
+  createEventsApi,
+  createEventSubscriptionsApi
+} from "./events.mjs";
 import { defaultStreamTiming } from "./frame-stream.mjs";
 import {
   createHttp,
@@ -25,10 +36,14 @@ import {
 import {
   createGatewayRealtimeTransport
 } from "./realtime.mjs";
+import { createProjectClient } from "./project.mjs";
+import { createProjectsApi } from "./projects.mjs";
+import { createPublishersApi } from "./publishers.mjs";
 import { createSessionsApi } from "./sessions.mjs";
+const DEFAULT_AGENTS_HOST = "https://agent-session.final.ai";
 const createClient = (options) => {
   const http = createHttp({
-    host: options.host,
+    host: options.host ?? DEFAULT_AGENTS_HOST,
     auth: options.auth,
     headers: options.headers,
     fetch: options.fetch
@@ -92,11 +107,25 @@ const createClient = (options) => {
     newKey: options.newKey ?? (() => globalThis.crypto.randomUUID()),
     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),
+    hosts
+  };
+  const channelSourceOf = options.channelSourceOf ?? defaultChannelSourceOf;
+  const clientLevel = { deps: start, projectId: null };
   const close = () => {
     if (closing.signal.aborted) return;
     closing.abort(
       clientError({ message: "Agent client closed", status: 0, code: ClientErrorCode.Closed })
     );
+    for (const host of hosts) host.close();
+    hosts.clear();
     ownTransport?.close();
   };
   return {
@@ -119,18 +148,9 @@ const createClient = (options) => {
         },
         response: agentListSchema,
         signal: listOptions?.signal
-      }),
-      get: (slugOrId) => ({
-        slug: slugOrId,
-        info: (infoOptions) => http.request({
-          method: HttpMethod.Get,
-          path: `/v1/agents/${encodePath(slugOrId)}`,
-          response: agentInfoSchema,
-          signal: infoOptions?.signal
-        })
       })
     },
-    people: /* @__PURE__ */ (() => {
+    people: (() => {
       const list = (listOptions) => http.request({
         method: HttpMethod.Get,
         path: "/v1/people",
@@ -149,21 +169,56 @@ const createClient = (options) => {
             if (next.nextCursor == null) return all;
             cursor = next.nextCursor;
           }
-        }
+        },
+        me: { identityLinks: createIdentityLinksApi(context) }
       };
     })(),
     realtime: { createSession: createRealtimeSession },
+    project: ({ id }) => createProjectClient({ context, start, channelSourceOf, projectId: id }),
+    projects: createProjectsApi(context),
+    events: createEventsApi({ context, projectId: null }),
+    app: {
+      eventSubscriptions: createEventSubscriptionsApi({
+        context,
+        basePath: "/v1/apps/me/event-subscriptions"
+      })
+    },
+    publishers: createPublishersApi(context),
+    inference: {
+      offering: (offeringOptions) => http.request({
+        method: HttpMethod.Get,
+        path: "/v1/inference/offering",
+        response: inferenceOfferingSchema,
+        signal: offeringOptions?.signal
+      })
+    },
+    platformIdentity: {
+      exchange: ({ signal, ...value }) => http.request({
+        method: HttpMethod.Post,
+        path: "/v1/platform-identity/exchange",
+        body: { schema: platformIdentityExchangeRequestSchema, value },
+        response: platformIdentityExchangeResponseSchema,
+        signal
+      })
+    },
+    decisions: {
+      get: async ({ id, signal }) => (await http.request({
+        method: HttpMethod.Get,
+        path: `/v1/decisions/${encodePath(id)}`,
+        response: decisionResponseSchema,
+        signal,
+        context: { decisionId: id }
+      })).decision
+    },
     sessions: createSessionsApi(context),
-    conversations: createConversationsApi(context),
+    conversations: createConversationsApi(context, clientLevel),
     channelBindings: createChannelBindingsApi(context),
-    definitions: createDefinitionsApi(context),
-    providers: createProvidersApi(context),
-    computerSetupGuides: createComputerSetupGuidesApi(context),
-    schedules: createSchedulesApi(context),
+    channelTickets: createChannelTicketsApi(context),
     acp: createAcpApi({ http })
   };
 };
 export {
+  DEFAULT_AGENTS_HOST,
   createClient
 };
 //# sourceMappingURL=client.mjs.map