@finalai/agents 0.12.0 → 0.14.0

package/README.md

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

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

@@ -1,4 +1,4 @@
-import { type ChannelIface, type ChannelRouteIface, type ChannelSeenPlaceIface, type ConnectChannelPlaceRequestIface, type CreateChannelBindingResponseIface, type DefinitionVisibility, type PublishChannelResponseIface } from '@finalai/agent-protocol/agent-platform';
+import { type ActorInputIface, type ChannelAppIface, type ChannelBindingIface, type ChannelIdentityLinkIface, type ChannelIdentityLinkProgressIface, type ChannelIface, type ChannelSeenPlaceIface, type ChannelTenantTicketIface, type ChannelTicketIface, type CompleteChannelIdentityLinkRequestIface, type CompleteChannelPlaceConnectionRequestIface, type CreateChannelAppRequestIface, type DefinitionVisibility, type InstallChannelRequestIface, type InstalledChannelIface, type PublishChannelResponseIface, type UpdateChannelAppRequestIface, type UpdateChannelBindingRequestIface } from '@finalai/agent-protocol/agent-platform';
 import { type ClientContextIface, type EnumInput, type SignalOptionsIface } from "./context.mjs";
 import { type ProvideIface } from "./provide.mjs";
 /** A channel value's source, as `channels.publish({ channel })` sends it. */
@@ -12,27 +12,26 @@ export type PublishChannelArgsIface = {
     name: string;
     /** `public` also makes the name public under the project's publisher handle. */
     visibility?: EnumInput<DefinitionVisibility>;
+    /** A channel app of this project that installs of the publication use unless they bring their own. */
+    app?: string;
 } & SignalOptionsIface & ({
     channel: object;
 } | {
     source: string;
     export?: string;
 });
-export interface InstallChannelArgsIface extends SignalOptionsIface {
-    /** A published channel (`channels.get`), or `{ name }` to install what the name points at now. */
-    channel: Pick<ChannelIface, 'hash'> | {
-        name: string;
-    };
-    connectorInstallId: string;
-    /** What an agent gets in every chat this install creates. */
+export type InstallChannelArgsIface = Omit<InstallChannelRequestIface, 'agents'> & {
+    /** What the agent gets in every chat this install creates. */
     agents: {
         provide: ProvideIface;
     };
-    /** Explicitly replace an existing install of the same connector. */
-    replace?: boolean;
-    /** Reaches only the channel's own code. */
-    config?: Record<string, unknown>;
-}
+} & SignalOptionsIface;
+export type UpdateChannelBindingArgsIface = Omit<UpdateChannelBindingRequestIface, 'agents'> & {
+    bindingId: string;
+    agents?: {
+        provide: ProvideIface;
+    };
+} & SignalOptionsIface;
 export interface ProjectChannelsApiIface {
     publish: (args: PublishChannelArgsIface) => Promise<PublishChannelResponseIface>;
     get: (selector: ({
@@ -40,33 +39,97 @@ export interface ProjectChannelsApiIface {
     } | {
         hash: string;
     }) & SignalOptionsIface) => Promise<ChannelIface>;
-    /** Fails with `requirements_unmet` unless `agents.provide` meets the answering agent's requirements. */
-    install: (args: InstallChannelArgsIface) => Promise<CreateChannelBindingResponseIface>;
+    /**
+     * Installs a channel in the project. Fails with `requirements_unmet`, and
+     * installs nothing, unless `agents.provide` meets the agent's requirements
+     * and the channel's app requirement is met.
+     */
+    install: (args: InstallChannelArgsIface) => Promise<InstalledChannelIface>;
+    /** The project's installs, newest first. */
+    installs: (options?: SignalOptionsIface & {
+        includeArchived?: boolean;
+    }) => Promise<ChannelBindingIface[]>;
 }
 export interface ChannelBindingsApiIface {
-    places(args: {
+    /** One install, with whether its agent's requirements are met now. */
+    get: (args: {
         bindingId: string;
-    } & SignalOptionsIface): Promise<ChannelSeenPlaceIface[]>;
-    routes(args: {
-        conversationId: string;
-    } & SignalOptionsIface): Promise<ChannelRouteIface[]>;
-    connect(args: ConnectChannelPlaceRequestIface & {
-        conversationId: string;
-    } & SignalOptionsIface): Promise<{
-        id: string;
+    } & SignalOptionsIface) => Promise<ChannelBindingIface>;
+    /** Fails with `revision_conflict` unless `revision` is the one last read, and with `requirements_unmet` when the change would leave them unmet. */
+    update: (args: UpdateChannelBindingArgsIface) => Promise<InstalledChannelIface>;
+    /** Ends the install: its connected places, tenants, listeners and the links made through it. */
+    uninstall: (args: {
+        bindingId: string;
+    } & SignalOptionsIface) => Promise<{
+        archivedAt: string | null;
     }>;
-    disconnect(args: {
-        conversationId: string;
+    /** A single-use link that installs the provider app for one tenant (a workspace, a server). */
+    tenantTicket: (args: {
+        bindingId: string;
+    } & SignalOptionsIface) => Promise<ChannelTenantTicketIface>;
+    /** The provider places the install has seen. */
+    places: (args: {
+        bindingId: string;
+    } & SignalOptionsIface) => Promise<ChannelSeenPlaceIface[]>;
+}
+export interface ChannelAppsApiIface {
+    /** Registers the provider application's credentials; secret values stay project secrets. */
+    create: (args: CreateChannelAppRequestIface & SignalOptionsIface) => Promise<ChannelAppIface>;
+    /** The apps of the project and its ancestors. */
+    list: (options?: SignalOptionsIface) => Promise<ChannelAppIface[]>;
+    update: (args: UpdateChannelAppRequestIface & {
+        id: string;
+    } & SignalOptionsIface) => Promise<ChannelAppIface>;
+    /** Refused while a live install or publication uses the app. */
+    delete: (args: {
+        id: string;
+    } & SignalOptionsIface) => Promise<void>;
+}
+/** The actor an API key or app acts for, by its external id. */
+export interface ActorOptionIface {
+    actor?: string;
+}
+export interface ChannelTicketsApiIface {
+    /** What a ticket from an installer's link or connect page is for. */
+    get: (args: {
+        ticket: string;
+    } & ActorOptionIface & SignalOptionsIface) => Promise<ChannelTicketIface>;
+    /** Links the ticket's channel account to the caller's person, or to `actor`. */
+    link: (args: {
+        ticket: string;
+    } & CompleteChannelIdentityLinkRequestIface & SignalOptionsIface) => Promise<ChannelIdentityLinkProgressIface>;
+    /** Connects the ticket's place to a conversation the caller manages. */
+    connect: (args: {
+        ticket: string;
+    } & CompleteChannelPlaceConnectionRequestIface & SignalOptionsIface) => Promise<{
         routeId: string;
-    } & SignalOptionsIface): Promise<{
-        ok: boolean;
     }>;
 }
+export interface IdentityLinksApiIface {
+    /** The channel accounts linked to the caller's person, or to `actor`. */
+    list: (options?: ActorOptionIface & SignalOptionsIface) => Promise<ChannelIdentityLinkIface[]>;
+    /** Chooses where the person's direct messages to the channel land. */
+    update: (args: {
+        id: string;
+        directConversationId: string | null;
+        actor?: ActorInputIface;
+    } & SignalOptionsIface) => Promise<void>;
+    /** Unlinks the account. */
+    delete: (args: {
+        id: string;
+    } & ActorOptionIface & SignalOptionsIface) => Promise<void>;
+}
 export declare const createProjectChannelsApi: (args: {
     context: ClientContextIface;
     projectId: string;
     sourceOf: ChannelSourceOf;
 }) => ProjectChannelsApiIface;
 export declare const createChannelBindingsApi: (ctx: ClientContextIface) => ChannelBindingsApiIface;
+export declare const createChannelAppsApi: (args: {
+    context: ClientContextIface;
+    projectId: string;
+}) => ChannelAppsApiIface;
+export declare const createChannelTicketsApi: (ctx: ClientContextIface) => ChannelTicketsApiIface;
+export declare const createIdentityLinksApi: (ctx: ClientContextIface) => IdentityLinksApiIface;
 /** The default `ChannelSourceOf` when no codec is available. */
 export declare const noChannelSource: ChannelSourceOf;

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

@@ -1,14 +1,27 @@
 import {
+  channelAppListSchema,
+  channelAppResponseSchema,
+  channelBindingListSchema,
+  channelBindingResponseSchema,
+  channelIdentityLinkListSchema,
+  channelIdentityLinkProgressSchema,
+  channelPlaceConnectionResponseSchema,
   channelPlacesResponseSchema,
-  channelRoutesResponseSchema,
   channelSchema,
-  connectChannelPlaceRequestSchema,
-  connectChannelPlaceResponseSchema,
-  createChannelBindingRequestSchema,
-  createChannelBindingResponseSchema,
-  disconnectChannelRouteResponseSchema,
+  channelTenantTicketSchema,
+  channelTicketSchema,
+  completeChannelIdentityLinkRequestSchema,
+  completeChannelPlaceConnectionRequestSchema,
+  createChannelAppRequestSchema,
+  installChannelRequestSchema,
+  installedChannelResponseSchema,
+  okResponseSchema,
   publishChannelRequestSchema,
-  publishChannelResponseSchema
+  publishChannelResponseSchema,
+  uninstallChannelBindingResponseSchema,
+  updateChannelAppRequestSchema,
+  updateChannelBindingRequestSchema,
+  updateChannelIdentityLinkRequestSchema
 } from "@finalai/agent-protocol/agent-platform";
 import {
   encodePath
@@ -17,8 +30,10 @@ 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) : {
@@ -30,7 +45,12 @@ const createProjectChannelsApi = (args) => {
         path: channelsPath(args.projectId, "/publish"),
         body: {
           schema: publishChannelRequestSchema,
-          value: { name: publish.name, ...source, visibility: publish.visibility }
+          value: {
+            name: publish.name,
+            ...source,
+            visibility: publish.visibility,
+            app: publish.app
+          }
         },
         response: publishChannelResponseSchema,
         signal: publish.signal
@@ -46,55 +66,162 @@ const createProjectChannelsApi = (args) => {
       response: channelSchema,
       signal
     }),
-    install: (install) => {
-      const channel = "hash" in install.channel ? { hash: install.channel.hash } : { name: install.channel.name };
-      return http.request({
-        method: HttpMethod.Post,
-        path: "/v1/channel-bindings",
-        body: {
-          schema: createChannelBindingRequestSchema,
-          value: {
-            projectId: args.projectId,
-            channel,
-            connectorInstallId: install.connectorInstallId,
-            agents: { provide: provideDocumentOf(install.agents.provide) },
-            replace: install.replace,
-            config: install.config
-          }
-        },
-        response: createChannelBindingResponseSchema,
-        signal: install.signal
-      });
-    }
+    install: ({ signal, agents, ...install }) => http.request({
+      method: HttpMethod.Post,
+      path: installsPath,
+      body: {
+        schema: installChannelRequestSchema,
+        value: {
+          ...install,
+          channel: referenceOf(install.channel),
+          agent: referenceOf(install.agent),
+          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 referenceOf = (reference) => "hash" in reference ? { hash: reference.hash } : { name: reference.name };
 const createChannelBindingsApi = (ctx) => ({
-  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,
+        ...change.channel == null ? {} : { channel: referenceOf(change.channel) },
+        ...change.agent == null ? {} : { agent: referenceOf(change.agent) },
+        ...agents == null ? {} : { agents: { provide: provideDocumentOf(agents.provide) } }
+      }
+    },
+    response: installedChannelResponseSchema,
     signal
-  })).routes,
-  connect: ({ conversationId, signal, ...body }) => ctx.http.request({
+  }),
+  uninstall: ({ bindingId, signal }) => ctx.http.request({
+    method: HttpMethod.Delete,
+    path: bindingPath(bindingId),
+    response: uninstallChannelBindingResponseSchema,
+    signal
+  }),
+  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",
@@ -103,7 +230,10 @@ const noChannelSource = () => {
   });
 };
 export {
+  createChannelAppsApi,
   createChannelBindingsApi,
+  createChannelTicketsApi,
+  createIdentityLinksApi,
   createProjectChannelsApi,
   noChannelSource
 };

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  channelSchema,\n  connectChannelPlaceRequestSchema,\n  connectChannelPlaceResponseSchema,\n  createChannelBindingRequestSchema,\n  createChannelBindingResponseSchema,\n  disconnectChannelRouteResponseSchema,\n  publishChannelRequestSchema,\n  publishChannelResponseSchema,\n  type ChannelIface,\n  type ChannelRouteIface,\n  type ChannelSeenPlaceIface,\n  type ConnectChannelPlaceRequestIface,\n  type CreateChannelBindingResponseIface,\n  type DefinitionVisibility,\n  type PublishChannelResponseIface,\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.\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} & SignalOptionsIface &\n  ({ channel: object } | { source: string; export?: string });\n\nexport interface InstallChannelArgsIface extends SignalOptionsIface {\n  /** A published channel (`channels.get`), or `{ name }` to install what the name points at now. */\n  channel: Pick<ChannelIface, 'hash'> | { name: string };\n  connectorInstallId: string;\n  /** What an agent gets in every chat this install creates. */\n  agents: { provide: ProvideIface };\n  /** Explicitly replace an existing install of the same connector. */\n  replace?: boolean;\n  /** Reaches only the channel's own code. */\n  config?: Record<string, unknown>;\n}\n\nexport interface ProjectChannelsApiIface {\n  publish: (args: PublishChannelArgsIface) => Promise<PublishChannelResponseIface>;\n  get: (\n    selector: ({ name: string } | { hash: string }) & SignalOptionsIface,\n  ) => Promise<ChannelIface>;\n  /** Fails with `requirements_unmet` unless `agents.provide` meets the answering agent's requirements. */\n  install: (args: InstallChannelArgsIface) => Promise<CreateChannelBindingResponseIface>;\n}\n\nexport interface ChannelBindingsApiIface {\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}\n\nconst channelsPath = (projectId: string, suffix: string): string =>\n  `/v1/projects/${encodePath(projectId)}/channels${suffix}`;\n\nexport const createProjectChannelsApi = (args: {\n  context: ClientContextIface;\n  projectId: string;\n  sourceOf: ChannelSourceOf;\n}): ProjectChannelsApiIface => {\n  const { http } = args.context;\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: { name: publish.name, ...source, visibility: publish.visibility },\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: (install) => {\n      const channel =\n        'hash' in install.channel ? { hash: install.channel.hash } : { name: install.channel.name };\n      return http.request({\n        method: HttpMethod.Post,\n        path: '/v1/channel-bindings',\n        body: {\n          schema: createChannelBindingRequestSchema,\n          value: {\n            projectId: args.projectId,\n            channel,\n            connectorInstallId: install.connectorInstallId,\n            agents: { provide: provideDocumentOf(install.agents.provide) },\n            replace: install.replace,\n            config: install.config,\n          },\n        },\n        response: createChannelBindingResponseSchema,\n        signal: install.signal,\n      });\n    },\n  };\n};\n\nexport const createChannelBindingsApi = (ctx: ClientContextIface): ChannelBindingsApiIface => ({\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\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,7 +1,7 @@
-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 } from "./channels.mjs";
+import { type ChannelBindingsApiIface, type ChannelSourceOf, type ChannelTicketsApiIface, type IdentityLinksApiIface } from "./channels.mjs";
 import { type SignalOptionsIface } from "./context.mjs";
 import { type ConversationsApiIface } from "./conversations.mjs";
 import { type EventsApiIface, type EventSubscriptionsApiIface } from "./events.mjs";
@@ -11,8 +11,8 @@ 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 SchedulesApiIface } from "./schedules.mjs";
 import { type SessionsApiIface } from "./sessions.mjs";
 /** Final's agents API. */
 export declare const DEFAULT_AGENTS_HOST = "https://agent-session.final.ai";
@@ -75,6 +75,13 @@ export interface AgentsApiIface {
         limit?: number;
         projectId?: string;
     }) => Promise<AgentListIface>;
+    /**
+     * One agent the caller can use, by id, in whichever project owns it; also one that was never
+     * published (`hash` and `revisionId` are null). Archived agents are not found.
+     */
+    get: (args: {
+        id: string;
+    } & SignalOptionsIface) => Promise<AgentSummaryIface>;
 }
 export interface PeopleApiIface {
     /** One page of the caller's organization members, by name; pass `nextCursor` as `cursor` for the next. */
@@ -84,6 +91,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 {
     /**
@@ -138,6 +149,8 @@ export interface AgentClientIface {
     platformIdentity: PlatformIdentityApiIface;
     decisions: DecisionsApiIface;
     health: (options?: SignalOptionsIface) => Promise<HealthResponseIface>;
+    /** The caller's organization: model credentials, budgets and policies. */
+    organization: OrganizationApiIface;
     agents: AgentsApiIface;
     people: PeopleApiIface;
     realtime: RealtimeApiIface;
@@ -145,8 +158,10 @@ export interface AgentClientIface {
     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;
-    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`.