@finalai/agents 0.11.0 → 0.12.0

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

@@ -0,0 +1,66 @@
+import {
+  createChannelBindingsApi,
+  createProjectChannelsApi
+} from "./channels.mjs";
+import { encodePath } from "./context.mjs";
+import { createProjectConversationsApi } from "./conversations.mjs";
+import {
+  createEventsApi,
+  createEventSubscriptionsApi
+} from "./events.mjs";
+import {
+  createAcpAdaptersApi,
+  createHarnessesApi
+} from "./harnesses.mjs";
+import { createIntegrationsApi } from "./integrations.mjs";
+import {
+  createOAuthClientsApi,
+  createSignInReturnOriginsApi
+} from "./oauth-clients.mjs";
+import { createProjectAgentsApi } from "./project-agents.mjs";
+import { createProjectResourceApi } from "./projects.mjs";
+import {
+  createProjectPublisherApi,
+  createPublicNamesApi
+} from "./publishers.mjs";
+import { createSandboxProvidersApi } from "./sandbox-providers.mjs";
+import {
+  createSandboxesApi,
+  createSandboxSetupsApi
+} from "./sandboxes.mjs";
+import { createProjectSessionsApi } from "./sessions.mjs";
+const createProjectClient = (args) => {
+  const { context, projectId } = args;
+  const agents = createProjectAgentsApi({ context, projectId, codec: args.start.codec });
+  const store = async (agent, signal) => (await agents.store({ agent, signal })).hash;
+  return {
+    ...createProjectResourceApi({ context, projectId }),
+    id: projectId,
+    sessions: createProjectSessionsApi({ context, projectId, start: args.start }),
+    conversations: createProjectConversationsApi({ context, projectId, start: args.start }),
+    agents,
+    sandboxes: createSandboxesApi({ context, projectId }),
+    sandboxSetups: createSandboxSetupsApi({ context, projectId }),
+    integrations: createIntegrationsApi({ context, projectId }),
+    harnesses: createHarnessesApi({ context, projectId, store }),
+    acpAdapters: createAcpAdaptersApi({ context, projectId }),
+    channels: {
+      ...createProjectChannelsApi({ context, projectId, sourceOf: args.channelSourceOf }),
+      ...createChannelBindingsApi(context)
+    },
+    events: createEventsApi({ context, projectId }),
+    eventSubscriptions: createEventSubscriptionsApi({
+      context,
+      basePath: `/v1/projects/${encodePath(projectId)}/event-subscriptions`
+    }),
+    sandboxProviders: createSandboxProvidersApi({ context, projectId }),
+    oauthClients: createOAuthClientsApi({ context, projectId }),
+    signInReturnOrigins: createSignInReturnOriginsApi({ context, projectId }),
+    publisher: createProjectPublisherApi({ context, projectId }),
+    publicNames: createPublicNamesApi({ context, projectId })
+  };
+};
+export {
+  createProjectClient
+};
+//# sourceMappingURL=project.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/agent-client/project.ts"],
+  "sourcesContent": ["import type { AgentInput } from \"./agent-input.mjs\";\nimport {\n  createChannelBindingsApi,\n  createProjectChannelsApi,\n  type ChannelBindingsApiIface,\n  type ChannelSourceOf,\n  type ProjectChannelsApiIface,\n} from \"./channels.mjs\";\nimport { encodePath, type ClientContextIface } from \"./context.mjs\";\nimport { createProjectConversationsApi, type ProjectConversationsApiIface } from \"./conversations.mjs\";\nimport {\n  createEventsApi,\n  createEventSubscriptionsApi,\n  type EventsApiIface,\n  type EventSubscriptionsApiIface,\n} from \"./events.mjs\";\nimport {\n  createAcpAdaptersApi,\n  createHarnessesApi,\n  type AcpAdaptersApiIface,\n  type HarnessesApiIface,\n} from \"./harnesses.mjs\";\nimport { createIntegrationsApi, type IntegrationsApiIface } from \"./integrations.mjs\";\nimport {\n  createOAuthClientsApi,\n  createSignInReturnOriginsApi,\n  type OAuthClientsApiIface,\n  type SignInReturnOriginsApiIface,\n} from \"./oauth-clients.mjs\";\nimport { createProjectAgentsApi, type ProjectAgentsApiIface } from \"./project-agents.mjs\";\nimport { createProjectResourceApi, type ProjectResourceApiIface } from \"./projects.mjs\";\nimport {\n  createProjectPublisherApi,\n  createPublicNamesApi,\n  type ProjectPublisherApiIface,\n  type PublicNamesApiIface,\n} from \"./publishers.mjs\";\nimport { createSandboxProvidersApi, type SandboxProvidersApiIface } from \"./sandbox-providers.mjs\";\nimport {\n  createSandboxesApi,\n  createSandboxSetupsApi,\n  type SandboxesApiIface,\n  type SandboxSetupsApiIface,\n} from \"./sandboxes.mjs\";\nimport { createProjectSessionsApi, type ProjectSessionsApiIface } from \"./sessions.mjs\";\nimport type { AgentStartDepsIface } from \"./start.mjs\";\n\n// One project: everything is created through it, and a session can only be\n// provided things from its own project.\n\nexport interface ProjectClientIface extends ProjectResourceApiIface {\n  readonly id: string;\n  sessions: ProjectSessionsApiIface;\n  conversations: ProjectConversationsApiIface;\n  agents: ProjectAgentsApiIface;\n  sandboxes: SandboxesApiIface;\n  sandboxSetups: SandboxSetupsApiIface;\n  integrations: IntegrationsApiIface;\n  harnesses: HarnessesApiIface;\n  acpAdapters: AcpAdaptersApiIface;\n  channels: ProjectChannelsApiIface & ChannelBindingsApiIface;\n  /** The event feed for this project and those below it. */\n  events: EventsApiIface;\n  /** Pushes this project's feed to a URL (`webhooks:write`, project admin). */\n  eventSubscriptions: EventSubscriptionsApiIface;\n  sandboxProviders: SandboxProvidersApiIface;\n  oauthClients: OAuthClientsApiIface;\n  signInReturnOrigins: SignInReturnOriginsApiIface;\n  /** The project's publisher handle. */\n  publisher: ProjectPublisherApiIface;\n  /** Which of the project's names resolve as `handle/name` from any organization. */\n  publicNames: PublicNamesApiIface;\n}\n\nexport const createProjectClient = (args: {\n  context: ClientContextIface;\n  start: AgentStartDepsIface;\n  channelSourceOf: ChannelSourceOf;\n  projectId: string;\n}): ProjectClientIface => {\n  const { context, projectId } = args;\n  const agents = createProjectAgentsApi({ context, projectId, codec: args.start.codec });\n  // The document must be stored before the platform can check a harness against it.\n  const store = async (agent: AgentInput, signal?: AbortSignal): Promise<string> =>\n    (await agents.store({ agent, signal })).hash;\n  return {\n    ...createProjectResourceApi({ context, projectId }),\n    id: projectId,\n    sessions: createProjectSessionsApi({ context, projectId, start: args.start }),\n    conversations: createProjectConversationsApi({ context, projectId, start: args.start }),\n    agents,\n    sandboxes: createSandboxesApi({ context, projectId }),\n    sandboxSetups: createSandboxSetupsApi({ context, projectId }),\n    integrations: createIntegrationsApi({ context, projectId }),\n    harnesses: createHarnessesApi({ context, projectId, store }),\n    acpAdapters: createAcpAdaptersApi({ context, projectId }),\n    channels: {\n      ...createProjectChannelsApi({ context, projectId, sourceOf: args.channelSourceOf }),\n      ...createChannelBindingsApi(context),\n    },\n    events: createEventsApi({ context, projectId }),\n    eventSubscriptions: createEventSubscriptionsApi({\n      context,\n      basePath: `/v1/projects/${encodePath(projectId)}/event-subscriptions`,\n    }),\n    sandboxProviders: createSandboxProvidersApi({ context, projectId }),\n    oauthClients: createOAuthClientsApi({ context, projectId }),\n    signInReturnOrigins: createSignInReturnOriginsApi({ context, projectId }),\n    publisher: createProjectPublisherApi({ context, projectId }),\n    publicNames: createPublicNamesApi({ context, projectId }),\n  };\n};\n"],
+  "mappings": "AACA;AAAA,EACE;AAAA,EACA;AAAA,OAIK;AACP,SAAS,kBAA2C;AACpD,SAAS,qCAAwE;AACjF;AAAA,EACE;AAAA,EACA;AAAA,OAGK;AACP;AAAA,EACE;AAAA,EACA;AAAA,OAGK;AACP,SAAS,6BAAwD;AACjE;AAAA,EACE;AAAA,EACA;AAAA,OAGK;AACP,SAAS,8BAA0D;AACnE,SAAS,gCAA8D;AACvE;AAAA,EACE;AAAA,EACA;AAAA,OAGK;AACP,SAAS,iCAAgE;AACzE;AAAA,EACE;AAAA,EACA;AAAA,OAGK;AACP,SAAS,gCAA8D;AA8BhE,MAAM,sBAAsB,CAAC,SAKV;AACxB,QAAM,EAAE,SAAS,UAAU,IAAI;AAC/B,QAAM,SAAS,uBAAuB,EAAE,SAAS,WAAW,OAAO,KAAK,MAAM,MAAM,CAAC;AAErF,QAAM,QAAQ,OAAO,OAAmB,YACrC,MAAM,OAAO,MAAM,EAAE,OAAO,OAAO,CAAC,GAAG;AAC1C,SAAO;AAAA,IACL,GAAG,yBAAyB,EAAE,SAAS,UAAU,CAAC;AAAA,IAClD,IAAI;AAAA,IACJ,UAAU,yBAAyB,EAAE,SAAS,WAAW,OAAO,KAAK,MAAM,CAAC;AAAA,IAC5E,eAAe,8BAA8B,EAAE,SAAS,WAAW,OAAO,KAAK,MAAM,CAAC;AAAA,IACtF;AAAA,IACA,WAAW,mBAAmB,EAAE,SAAS,UAAU,CAAC;AAAA,IACpD,eAAe,uBAAuB,EAAE,SAAS,UAAU,CAAC;AAAA,IAC5D,cAAc,sBAAsB,EAAE,SAAS,UAAU,CAAC;AAAA,IAC1D,WAAW,mBAAmB,EAAE,SAAS,WAAW,MAAM,CAAC;AAAA,IAC3D,aAAa,qBAAqB,EAAE,SAAS,UAAU,CAAC;AAAA,IACxD,UAAU;AAAA,MACR,GAAG,yBAAyB,EAAE,SAAS,WAAW,UAAU,KAAK,gBAAgB,CAAC;AAAA,MAClF,GAAG,yBAAyB,OAAO;AAAA,IACrC;AAAA,IACA,QAAQ,gBAAgB,EAAE,SAAS,UAAU,CAAC;AAAA,IAC9C,oBAAoB,4BAA4B;AAAA,MAC9C;AAAA,MACA,UAAU,gBAAgB,WAAW,SAAS,CAAC;AAAA,IACjD,CAAC;AAAA,IACD,kBAAkB,0BAA0B,EAAE,SAAS,UAAU,CAAC;AAAA,IAClE,cAAc,sBAAsB,EAAE,SAAS,UAAU,CAAC;AAAA,IAC1D,qBAAqB,6BAA6B,EAAE,SAAS,UAAU,CAAC;AAAA,IACxE,WAAW,0BAA0B,EAAE,SAAS,UAAU,CAAC;AAAA,IAC3D,aAAa,qBAAqB,EAAE,SAAS,UAAU,CAAC;AAAA,EAC1D;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,61 @@
+import { type AddProjectMemberRequestIface, type ApiKeyIface, type CreateApiKeyRequestIface, type CreateApiKeyResponseIface, type CreateProjectRequestIface, type ProjectIface, type ProjectMemberIface, type ProjectMovePreviewIface, type ProjectRole, type UpdateProjectRequestIface } from '@finalai/agent-protocol/agent-platform';
+import { type ClientContextIface, type EnumInput, type SignalOptionsIface } from "./context.mjs";
+export interface ProjectsApiIface {
+    /** Every project the caller can see, or the children of `parentId`. */
+    list: (options?: SignalOptionsIface & {
+        parentId?: string;
+        includeArchived?: boolean;
+    }) => Promise<ProjectIface[]>;
+    /** Creates a project; open it with `client.project({ id })`. */
+    create: (args: CreateProjectRequestIface & SignalOptionsIface) => Promise<ProjectIface>;
+}
+export interface ProjectMembersApiIface {
+    /** Everyone with a role here, inherited roles included. */
+    list: (options?: SignalOptionsIface) => Promise<ProjectMemberIface[]>;
+    /** Grants a person or an API key a role here; never more than the caller's own. */
+    add: (args: Omit<AddProjectMemberRequestIface, 'role'> & {
+        role: EnumInput<ProjectRole>;
+    } & SignalOptionsIface) => Promise<ProjectMemberIface>;
+    /** `memberId` is the member's user (`usr_...`) or API key (`ak_...`) id. */
+    update: (args: {
+        memberId: string;
+        role: EnumInput<ProjectRole>;
+    } & SignalOptionsIface) => Promise<ProjectMemberIface>;
+    remove: (args: {
+        memberId: string;
+    } & SignalOptionsIface) => Promise<void>;
+}
+export interface ProjectApiKeysApiIface {
+    /** Creates a key acting in this project; its `value` is returned only here. */
+    create: (args: CreateApiKeyRequestIface & SignalOptionsIface) => Promise<CreateApiKeyResponseIface>;
+    list: (options?: SignalOptionsIface) => Promise<ApiKeyIface[]>;
+    delete: (args: {
+        id: string;
+    } & SignalOptionsIface) => Promise<boolean>;
+}
+export interface ProjectResourceApiIface {
+    /** The project itself, with the caller's effective role. */
+    info: (options?: SignalOptionsIface) => Promise<ProjectIface>;
+    update: (patch: UpdateProjectRequestIface, options?: SignalOptionsIface) => Promise<ProjectIface>;
+    archive: (options?: SignalOptionsIface) => Promise<ProjectIface>;
+    unarchive: (options?: SignalOptionsIface) => Promise<ProjectIface>;
+    /**
+     * Who would gain and lose a role if the project moved under `parentId`
+     * (omitted or null: the top of the organization). Pass its fingerprint to `move`.
+     */
+    movePreview: (args?: {
+        parentId?: string | null;
+    } & SignalOptionsIface) => Promise<ProjectMovePreviewIface>;
+    /** Refused if access would now change differently from the preview `fingerprint` came from. */
+    move: (args: {
+        parentId: string | null;
+        fingerprint: string;
+    } & SignalOptionsIface) => Promise<ProjectIface>;
+    members: ProjectMembersApiIface;
+    apiKeys: ProjectApiKeysApiIface;
+}
+export declare const createProjectsApi: (context: ClientContextIface) => ProjectsApiIface;
+export declare const createProjectResourceApi: (args: {
+    context: ClientContextIface;
+    projectId: string;
+}) => ProjectResourceApiIface;

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

@@ -0,0 +1,145 @@
+import {
+  addProjectMemberRequestSchema,
+  apiKeyListSchema,
+  createApiKeyRequestSchema,
+  createApiKeyResponseSchema,
+  createProjectRequestSchema,
+  deleteApiKeyResponseSchema,
+  moveProjectRequestSchema,
+  okResponseSchema,
+  projectListSchema,
+  projectMemberListSchema,
+  projectMemberResponseSchema,
+  projectMovePreviewSchema,
+  projectResponseSchema,
+  updateProjectMemberRequestSchema,
+  updateProjectRequestSchema
+} from "@finalai/agent-protocol/agent-platform";
+import * as z from "zod";
+import {
+  encodePath
+} from "./context.mjs";
+import { HttpMethod } from "./http.mjs";
+const emptyBodySchema = z.strictObject({});
+const createProjectsApi = (context) => ({
+  list: async (options) => (await context.http.request({
+    method: HttpMethod.Get,
+    path: "/v1/projects",
+    query: { parentId: options?.parentId, includeArchived: options?.includeArchived },
+    response: projectListSchema,
+    signal: options?.signal
+  })).projects,
+  create: async ({ signal, ...value }) => (await context.http.request({
+    method: HttpMethod.Post,
+    path: "/v1/projects",
+    body: { schema: createProjectRequestSchema, value },
+    response: projectResponseSchema,
+    signal
+  })).project
+});
+const createProjectResourceApi = (args) => {
+  const { http } = args.context;
+  const path = (suffix = "") => `/v1/projects/${encodePath(args.projectId)}${suffix}`;
+  const project = async (request, signal) => (await http.request({
+    method: request.method,
+    path: path(request.suffix),
+    body: request.body,
+    response: projectResponseSchema,
+    signal
+  })).project;
+  const memberPath = (memberId) => path(`/members/${encodePath(memberId)}`);
+  return {
+    info: (options) => project({ method: HttpMethod.Get }, options?.signal),
+    update: (patch, options) => project(
+      { method: HttpMethod.Patch, body: { schema: updateProjectRequestSchema, value: patch } },
+      options?.signal
+    ),
+    archive: (options) => project(
+      {
+        method: HttpMethod.Post,
+        suffix: "/archive",
+        body: { schema: emptyBodySchema, value: {} }
+      },
+      options?.signal
+    ),
+    unarchive: (options) => project(
+      {
+        method: HttpMethod.Post,
+        suffix: "/unarchive",
+        body: { schema: emptyBodySchema, value: {} }
+      },
+      options?.signal
+    ),
+    movePreview: (options) => http.request({
+      method: HttpMethod.Get,
+      path: path("/move-preview"),
+      query: { parentId: options?.parentId ?? void 0 },
+      response: projectMovePreviewSchema,
+      signal: options?.signal
+    }),
+    move: ({ signal, ...value }) => project(
+      {
+        method: HttpMethod.Post,
+        suffix: "/move",
+        body: { schema: moveProjectRequestSchema, value }
+      },
+      signal
+    ),
+    members: {
+      list: async (options) => (await http.request({
+        method: HttpMethod.Get,
+        path: path("/members"),
+        response: projectMemberListSchema,
+        signal: options?.signal
+      })).members,
+      add: async ({ signal, ...value }) => (await http.request({
+        method: HttpMethod.Post,
+        path: path("/members"),
+        body: { schema: addProjectMemberRequestSchema, value },
+        response: projectMemberResponseSchema,
+        signal
+      })).member,
+      update: async ({ memberId, role, signal }) => (await http.request({
+        method: HttpMethod.Patch,
+        path: memberPath(memberId),
+        body: { schema: updateProjectMemberRequestSchema, value: { role } },
+        response: projectMemberResponseSchema,
+        signal
+      })).member,
+      remove: async ({ memberId, signal }) => {
+        await http.request({
+          method: HttpMethod.Delete,
+          path: memberPath(memberId),
+          response: okResponseSchema,
+          signal
+        });
+      }
+    },
+    apiKeys: {
+      create: ({ signal, ...value }) => http.request({
+        method: HttpMethod.Post,
+        path: path("/api-keys"),
+        body: { schema: createApiKeyRequestSchema, value },
+        response: createApiKeyResponseSchema,
+        signal
+      }),
+      list: async (options) => (await http.request({
+        method: HttpMethod.Get,
+        path: path("/api-keys"),
+        response: apiKeyListSchema,
+        signal: options?.signal
+      })).apiKeys,
+      delete: async ({ id, signal }) => (await http.request({
+        method: HttpMethod.Delete,
+        path: path(`/api-keys/${encodePath(id)}`),
+        response: deleteApiKeyResponseSchema,
+        signal
+      })).deleted
+    }
+  };
+};
+export {
+  createProjectResourceApi,
+  createProjectsApi
+};
+//# sourceMappingURL=projects.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/agent-client/projects.ts"],
+  "sourcesContent": ["import {\n  addProjectMemberRequestSchema,\n  apiKeyListSchema,\n  createApiKeyRequestSchema,\n  createApiKeyResponseSchema,\n  createProjectRequestSchema,\n  deleteApiKeyResponseSchema,\n  moveProjectRequestSchema,\n  okResponseSchema,\n  projectListSchema,\n  projectMemberListSchema,\n  projectMemberResponseSchema,\n  projectMovePreviewSchema,\n  projectResponseSchema,\n  updateProjectMemberRequestSchema,\n  updateProjectRequestSchema,\n  type AddProjectMemberRequestIface,\n  type ApiKeyIface,\n  type CreateApiKeyRequestIface,\n  type CreateApiKeyResponseIface,\n  type CreateProjectRequestIface,\n  type ProjectIface,\n  type ProjectMemberIface,\n  type ProjectMovePreviewIface,\n  type ProjectRole,\n  type UpdateProjectRequestIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport * as z from 'zod';\nimport {\n  encodePath,\n  type ClientContextIface,\n  type EnumInput,\n  type SignalOptionsIface,\n} from \"./context.mjs\";\nimport { HttpMethod, type HttpBodyIface } from \"./http.mjs\";\n\n// Projects as a resource: the tree itself, its members and its API keys.\n\nexport interface ProjectsApiIface {\n  /** Every project the caller can see, or the children of `parentId`. */\n  list: (\n    options?: SignalOptionsIface & { parentId?: string; includeArchived?: boolean },\n  ) => Promise<ProjectIface[]>;\n  /** Creates a project; open it with `client.project({ id })`. */\n  create: (args: CreateProjectRequestIface & SignalOptionsIface) => Promise<ProjectIface>;\n}\n\nexport interface ProjectMembersApiIface {\n  /** Everyone with a role here, inherited roles included. */\n  list: (options?: SignalOptionsIface) => Promise<ProjectMemberIface[]>;\n  /** Grants a person or an API key a role here; never more than the caller's own. */\n  add: (\n    args: Omit<AddProjectMemberRequestIface, 'role'> & {\n      role: EnumInput<ProjectRole>;\n    } & SignalOptionsIface,\n  ) => Promise<ProjectMemberIface>;\n  /** `memberId` is the member's user (`usr_...`) or API key (`ak_...`) id. */\n  update: (\n    args: { memberId: string; role: EnumInput<ProjectRole> } & SignalOptionsIface,\n  ) => Promise<ProjectMemberIface>;\n  remove: (args: { memberId: string } & SignalOptionsIface) => Promise<void>;\n}\n\nexport interface ProjectApiKeysApiIface {\n  /** Creates a key acting in this project; its `value` is returned only here. */\n  create: (\n    args: CreateApiKeyRequestIface & SignalOptionsIface,\n  ) => Promise<CreateApiKeyResponseIface>;\n  list: (options?: SignalOptionsIface) => Promise<ApiKeyIface[]>;\n  delete: (args: { id: string } & SignalOptionsIface) => Promise<boolean>;\n}\n\nexport interface ProjectResourceApiIface {\n  /** The project itself, with the caller's effective role. */\n  info: (options?: SignalOptionsIface) => Promise<ProjectIface>;\n  update: (patch: UpdateProjectRequestIface, options?: SignalOptionsIface) => Promise<ProjectIface>;\n  archive: (options?: SignalOptionsIface) => Promise<ProjectIface>;\n  unarchive: (options?: SignalOptionsIface) => Promise<ProjectIface>;\n  /**\n   * Who would gain and lose a role if the project moved under `parentId`\n   * (omitted or null: the top of the organization). Pass its fingerprint to `move`.\n   */\n  movePreview: (\n    args?: { parentId?: string | null } & SignalOptionsIface,\n  ) => Promise<ProjectMovePreviewIface>;\n  /** Refused if access would now change differently from the preview `fingerprint` came from. */\n  move: (\n    args: { parentId: string | null; fingerprint: string } & SignalOptionsIface,\n  ) => Promise<ProjectIface>;\n  members: ProjectMembersApiIface;\n  apiKeys: ProjectApiKeysApiIface;\n}\n\nconst emptyBodySchema = z.strictObject({});\n\nexport const createProjectsApi = (context: ClientContextIface): ProjectsApiIface => ({\n  list: async (options) =>\n    (\n      await context.http.request({\n        method: HttpMethod.Get,\n        path: '/v1/projects',\n        query: { parentId: options?.parentId, includeArchived: options?.includeArchived },\n        response: projectListSchema,\n        signal: options?.signal,\n      })\n    ).projects,\n  create: async ({ signal, ...value }) =>\n    (\n      await context.http.request({\n        method: HttpMethod.Post,\n        path: '/v1/projects',\n        body: { schema: createProjectRequestSchema, value },\n        response: projectResponseSchema,\n        signal,\n      })\n    ).project,\n});\n\nexport const createProjectResourceApi = (args: {\n  context: ClientContextIface;\n  projectId: string;\n}): ProjectResourceApiIface => {\n  const { http } = args.context;\n  const path = (suffix = ''): string => `/v1/projects/${encodePath(args.projectId)}${suffix}`;\n  const project = async (\n    request: { method: HttpMethod; suffix?: string; body?: HttpBodyIface },\n    signal: AbortSignal | undefined,\n  ): Promise<ProjectIface> =>\n    (\n      await http.request({\n        method: request.method,\n        path: path(request.suffix),\n        body: request.body,\n        response: projectResponseSchema,\n        signal,\n      })\n    ).project;\n  const memberPath = (memberId: string): string => path(`/members/${encodePath(memberId)}`);\n  return {\n    info: (options) => project({ method: HttpMethod.Get }, options?.signal),\n    update: (patch, options) =>\n      project(\n        { method: HttpMethod.Patch, body: { schema: updateProjectRequestSchema, value: patch } },\n        options?.signal,\n      ),\n    archive: (options) =>\n      project(\n        {\n          method: HttpMethod.Post,\n          suffix: '/archive',\n          body: { schema: emptyBodySchema, value: {} },\n        },\n        options?.signal,\n      ),\n    unarchive: (options) =>\n      project(\n        {\n          method: HttpMethod.Post,\n          suffix: '/unarchive',\n          body: { schema: emptyBodySchema, value: {} },\n        },\n        options?.signal,\n      ),\n    movePreview: (options) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: path('/move-preview'),\n        query: { parentId: options?.parentId ?? undefined },\n        response: projectMovePreviewSchema,\n        signal: options?.signal,\n      }),\n    move: ({ signal, ...value }) =>\n      project(\n        {\n          method: HttpMethod.Post,\n          suffix: '/move',\n          body: { schema: moveProjectRequestSchema, value },\n        },\n        signal,\n      ),\n    members: {\n      list: async (options) =>\n        (\n          await http.request({\n            method: HttpMethod.Get,\n            path: path('/members'),\n            response: projectMemberListSchema,\n            signal: options?.signal,\n          })\n        ).members,\n      add: async ({ signal, ...value }) =>\n        (\n          await http.request({\n            method: HttpMethod.Post,\n            path: path('/members'),\n            body: { schema: addProjectMemberRequestSchema, value },\n            response: projectMemberResponseSchema,\n            signal,\n          })\n        ).member,\n      update: async ({ memberId, role, signal }) =>\n        (\n          await http.request({\n            method: HttpMethod.Patch,\n            path: memberPath(memberId),\n            body: { schema: updateProjectMemberRequestSchema, value: { role } },\n            response: projectMemberResponseSchema,\n            signal,\n          })\n        ).member,\n      remove: async ({ memberId, signal }) => {\n        await http.request({\n          method: HttpMethod.Delete,\n          path: memberPath(memberId),\n          response: okResponseSchema,\n          signal,\n        });\n      },\n    },\n    apiKeys: {\n      create: ({ signal, ...value }) =>\n        http.request({\n          method: HttpMethod.Post,\n          path: path('/api-keys'),\n          body: { schema: createApiKeyRequestSchema, value },\n          response: createApiKeyResponseSchema,\n          signal,\n        }),\n      list: async (options) =>\n        (\n          await http.request({\n            method: HttpMethod.Get,\n            path: path('/api-keys'),\n            response: apiKeyListSchema,\n            signal: options?.signal,\n          })\n        ).apiKeys,\n      delete: async ({ id, signal }) =>\n        (\n          await http.request({\n            method: HttpMethod.Delete,\n            path: path(`/api-keys/${encodePath(id)}`),\n            response: deleteApiKeyResponseSchema,\n            signal,\n          })\n        ).deleted,\n    },\n  };\n};\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,41 @@
+import { type Capability } from '@finalai/agent-protocol';
+import { type HarnessSettingsIface, type ProvideDocumentIface, type ProvideDocumentViewIface, type ProvideParticipantRequestIface } from '@finalai/agent-protocol/agent-platform';
+/** Anything with the id of a project resource: a handle, or a fetched record. */
+export interface ResourceRefIface {
+    readonly id: string;
+}
+export type ResourceRef = string | ResourceRefIface;
+export interface ProvideIface {
+    /** Harness settings, inline: `serverlessPi({ model, inference })`. */
+    harness?: HarnessSettingsIface;
+    /**
+     * Capability → the sandbox that provides it. `files` and `shell` must name the
+     * same sandbox. A capability left out runs in this process unless the client
+     * was created with `localCompute: false`.
+     */
+    compute?: Partial<Record<Capability | `${Capability}`, ResourceRef>>;
+    /** Integration slot → the integration that fills it. */
+    integrations?: Record<string, ResourceRef>;
+}
+/** A change to one agent participant's settings; `null` removes a capability or slot. */
+export interface ProvidePatchIface {
+    harness?: HarnessSettingsIface;
+    compute?: Partial<Record<Capability | `${Capability}`, ResourceRef | null>>;
+    integrations?: Record<string, ResourceRef | null>;
+    instructions?: string | null;
+    tools?: string[] | null;
+    /** The settings revision you read; a stale one fails with `conflict`. */
+    revision?: number;
+}
+export declare const resourceIdOf: (ref: ResourceRef) => string;
+/** The wire document for `provide`: handles become ids. */
+export declare const provideDocumentOf: (provide: ProvideIface) => ProvideDocumentIface;
+export declare const providePatchOf: (patch: ProvidePatchIface) => ProvideParticipantRequestIface;
+/** A provide document as the server returns it, back in the form calls send. */
+export declare const provideDocumentOfView: (view: ProvideDocumentViewIface) => ProvideDocumentIface;
+/**
+ * What an agent is provided, as the platform layers it: the nearest scope that
+ * sets a top-level key wins it whole, so compute never mixes sandboxes from
+ * two scopes.
+ */
+export declare const layerProvide: (own: ProvideDocumentIface, shared: ProvideDocumentIface | null) => ProvideDocumentIface;

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

@@ -0,0 +1,90 @@
+import { CAPABILITIES } from "@finalai/agent-protocol";
+import {
+  harnessSettingsSchema
+} from "@finalai/agent-protocol/agent-platform";
+import { clientError, ClientErrorCode } from "./errors.mjs";
+const resourceIdOf = (ref) => typeof ref === "string" ? ref : ref.id;
+const capabilityOf = (key) => {
+  const capability = CAPABILITIES.find((candidate) => candidate === key);
+  if (capability == null)
+    throw clientError({
+      message: `Unknown compute capability ${key}: use ${CAPABILITIES.join(", ")}`,
+      status: 0,
+      code: ClientErrorCode.InvalidRequest
+    });
+  return capability;
+};
+const computeIdsOf = (refs) => {
+  const ids = {};
+  for (const [key, ref] of Object.entries(refs))
+    if (ref != null) ids[capabilityOf(key)] = resourceIdOf(ref);
+  return ids;
+};
+const computePatchOf = (refs) => {
+  const ids = {};
+  for (const [key, ref] of Object.entries(refs))
+    if (ref !== void 0) ids[capabilityOf(key)] = ref == null ? null : resourceIdOf(ref);
+  return ids;
+};
+const slotIdsOf = (refs) => Object.fromEntries(Object.entries(refs).map(([slot, ref]) => [slot, resourceIdOf(ref)]));
+const slotPatchOf = (refs) => Object.fromEntries(
+  Object.entries(refs).map(([slot, ref]) => [slot, ref == null ? null : resourceIdOf(ref)])
+);
+const provideDocumentOf = (provide) => ({
+  ...provide.harness == null ? {} : { harness: provide.harness },
+  ...provide.compute == null ? {} : { compute: computeIdsOf(provide.compute) },
+  ...provide.integrations == null ? {} : { integrations: slotIdsOf(provide.integrations) }
+});
+const providePatchOf = (patch) => ({
+  ...patch.harness == null ? {} : { harness: patch.harness },
+  ...patch.compute == null ? {} : { compute: computePatchOf(patch.compute) },
+  ...patch.integrations == null ? {} : { integrations: slotPatchOf(patch.integrations) },
+  ...patch.instructions === void 0 ? {} : { instructions: patch.instructions },
+  ...patch.tools === void 0 ? {} : { tools: patch.tools },
+  ...patch.revision == null ? {} : { revision: patch.revision }
+});
+const harnessOfView = (view) => {
+  const environment = view.environment == null ? {} : {
+    environment: typeof view.environment === "string" ? view.environment : {
+      url: view.environment.url,
+      ...view.environment.hop == null ? {} : { hop: view.environment.hop }
+    }
+  };
+  const parsed = harnessSettingsSchema.safeParse({
+    harness: view.harness,
+    ...view.adapter == null ? {} : { adapter: view.adapter },
+    configuration: view.configuration,
+    ...environment
+  });
+  return parsed.success ? parsed.data : { harness: view.harness };
+};
+const provideDocumentOfView = (view) => {
+  const compute = {};
+  for (const [key, id] of Object.entries(view.compute)) {
+    const capability = CAPABILITIES.find((candidate) => candidate === key);
+    if (capability != null) compute[capability] = id;
+  }
+  return {
+    ...view.harness == null ? {} : { harness: harnessOfView(view.harness) },
+    ...Object.keys(compute).length === 0 ? {} : { compute },
+    ...Object.keys(view.integrations).length === 0 ? {} : { integrations: view.integrations }
+  };
+};
+const layerProvide = (own, shared) => {
+  const harness = own.harness ?? shared?.harness;
+  const compute = own.compute ?? shared?.compute;
+  const integrations = own.integrations ?? shared?.integrations;
+  return {
+    ...harness == null ? {} : { harness },
+    ...compute == null ? {} : { compute },
+    ...integrations == null ? {} : { integrations }
+  };
+};
+export {
+  layerProvide,
+  provideDocumentOf,
+  provideDocumentOfView,
+  providePatchOf,
+  resourceIdOf
+};
+//# sourceMappingURL=provide.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/agent-client/provide.ts"],
+  "sourcesContent": ["import { CAPABILITIES, type Capability } from '@finalai/agent-protocol';\nimport {\n  harnessSettingsSchema,\n  type HarnessSettingsIface,\n  type HarnessSettingsViewIface,\n  type ProvideDocumentIface,\n  type ProvideDocumentViewIface,\n  type ProvideParticipantRequestIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { clientError, ClientErrorCode } from \"./errors.mjs\";\n\n// What a caller provides to meet an agent's requirements, as the SDK accepts\n// it: the wire document, except that a sandbox or an integration may be given\n// as the handle `project.sandboxes.create` or `project.integrations.create`\n// returned. Handles are sent as their ids.\n\n/** Anything with the id of a project resource: a handle, or a fetched record. */\nexport interface ResourceRefIface {\n  readonly id: string;\n}\n\nexport type ResourceRef = string | ResourceRefIface;\n\nexport interface ProvideIface {\n  /** Harness settings, inline: `serverlessPi({ model, inference })`. */\n  harness?: HarnessSettingsIface;\n  /**\n   * Capability \u2192 the sandbox that provides it. `files` and `shell` must name the\n   * same sandbox. A capability left out runs in this process unless the client\n   * was created with `localCompute: false`.\n   */\n  compute?: Partial<Record<Capability | `${Capability}`, ResourceRef>>;\n  /** Integration slot \u2192 the integration that fills it. */\n  integrations?: Record<string, ResourceRef>;\n}\n\n/** A change to one agent participant's settings; `null` removes a capability or slot. */\nexport interface ProvidePatchIface {\n  harness?: HarnessSettingsIface;\n  compute?: Partial<Record<Capability | `${Capability}`, ResourceRef | null>>;\n  integrations?: Record<string, ResourceRef | null>;\n  instructions?: string | null;\n  tools?: string[] | null;\n  /** The settings revision you read; a stale one fails with `conflict`. */\n  revision?: number;\n}\n\nexport const resourceIdOf = (ref: ResourceRef): string => (typeof ref === 'string' ? ref : ref.id);\n\nconst capabilityOf = (key: string): Capability => {\n  const capability = CAPABILITIES.find((candidate) => candidate === key);\n  if (capability == null)\n    throw clientError({\n      message: `Unknown compute capability ${key}: use ${CAPABILITIES.join(', ')}`,\n      status: 0,\n      code: ClientErrorCode.InvalidRequest,\n    });\n  return capability;\n};\n\nconst computeIdsOf = (\n  refs: Partial<Record<string, ResourceRef>>,\n): Partial<Record<Capability, string>> => {\n  const ids: Partial<Record<Capability, string>> = {};\n  for (const [key, ref] of Object.entries(refs))\n    if (ref != null) ids[capabilityOf(key)] = resourceIdOf(ref);\n  return ids;\n};\n\nconst computePatchOf = (\n  refs: Partial<Record<string, ResourceRef | null>>,\n): Partial<Record<Capability, string | null>> => {\n  const ids: Partial<Record<Capability, string | null>> = {};\n  for (const [key, ref] of Object.entries(refs))\n    if (ref !== undefined) ids[capabilityOf(key)] = ref == null ? null : resourceIdOf(ref);\n  return ids;\n};\n\nconst slotIdsOf = (refs: Record<string, ResourceRef>): Record<string, string> =>\n  Object.fromEntries(Object.entries(refs).map(([slot, ref]) => [slot, resourceIdOf(ref)]));\n\nconst slotPatchOf = (refs: Record<string, ResourceRef | null>): Record<string, string | null> =>\n  Object.fromEntries(\n    Object.entries(refs).map(([slot, ref]) => [slot, ref == null ? null : resourceIdOf(ref)]),\n  );\n\n/** The wire document for `provide`: handles become ids. */\nexport const provideDocumentOf = (provide: ProvideIface): ProvideDocumentIface => ({\n  ...(provide.harness == null ? {} : { harness: provide.harness }),\n  ...(provide.compute == null ? {} : { compute: computeIdsOf(provide.compute) }),\n  ...(provide.integrations == null ? {} : { integrations: slotIdsOf(provide.integrations) }),\n});\n\nexport const providePatchOf = (patch: ProvidePatchIface): ProvideParticipantRequestIface => ({\n  ...(patch.harness == null ? {} : { harness: patch.harness }),\n  ...(patch.compute == null ? {} : { compute: computePatchOf(patch.compute) }),\n  ...(patch.integrations == null ? {} : { integrations: slotPatchOf(patch.integrations) }),\n  ...(patch.instructions === undefined ? {} : { instructions: patch.instructions }),\n  ...(patch.tools === undefined ? {} : { tools: patch.tools }),\n  ...(patch.revision == null ? {} : { revision: patch.revision }),\n});\n\n// Settings the SDK cannot read back in full (a newer server's inference\n// source) still name the harness, which is what the local check needs.\nconst harnessOfView = (view: HarnessSettingsViewIface): HarnessSettingsIface => {\n  const environment =\n    view.environment == null\n      ? {}\n      : {\n          environment:\n            typeof view.environment === 'string'\n              ? view.environment\n              : {\n                  url: view.environment.url,\n                  ...(view.environment.hop == null ? {} : { hop: view.environment.hop }),\n                },\n        };\n  const parsed = harnessSettingsSchema.safeParse({\n    harness: view.harness,\n    ...(view.adapter == null ? {} : { adapter: view.adapter }),\n    configuration: view.configuration,\n    ...environment,\n  });\n  return parsed.success ? parsed.data : { harness: view.harness };\n};\n\n/** A provide document as the server returns it, back in the form calls send. */\nexport const provideDocumentOfView = (view: ProvideDocumentViewIface): ProvideDocumentIface => {\n  const compute: Partial<Record<Capability, string>> = {};\n  for (const [key, id] of Object.entries(view.compute)) {\n    const capability = CAPABILITIES.find((candidate) => candidate === key);\n    if (capability != null) compute[capability] = id;\n  }\n  return {\n    ...(view.harness == null ? {} : { harness: harnessOfView(view.harness) }),\n    ...(Object.keys(compute).length === 0 ? {} : { compute }),\n    ...(Object.keys(view.integrations).length === 0 ? {} : { integrations: view.integrations }),\n  };\n};\n\n/**\n * What an agent is provided, as the platform layers it: the nearest scope that\n * sets a top-level key wins it whole, so compute never mixes sandboxes from\n * two scopes.\n */\nexport const layerProvide = (\n  own: ProvideDocumentIface,\n  shared: ProvideDocumentIface | null,\n): ProvideDocumentIface => {\n  const harness = own.harness ?? shared?.harness;\n  const compute = own.compute ?? shared?.compute;\n  const integrations = own.integrations ?? shared?.integrations;\n  return {\n    ...(harness == null ? {} : { harness }),\n    ...(compute == null ? {} : { compute }),\n    ...(integrations == null ? {} : { integrations }),\n  };\n};\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,57 @@
+import { type AcpAdapterDefinitionSummaryIface, type AgentListIface, type ChannelIface, type HarnessDefinitionSummaryIface, type PublicNameIface, type PublicNameKind, type PublisherIface } from '@finalai/agent-protocol/agent-platform';
+import { type ClientContextIface, type EnumInput, type SignalOptionsIface } from "./context.mjs";
+export interface ProjectPublisherApiIface {
+    /** Claims the project's handle: first come, once per project, never changed. */
+    claim: (args: {
+        handle: string;
+    } & SignalOptionsIface) => Promise<PublisherIface>;
+    /** The project's handle; fails with `not_found` before one is claimed. */
+    get: (options?: SignalOptionsIface) => Promise<PublisherIface>;
+}
+export interface PublicNamesApiIface {
+    /**
+     * Makes a name the project published resolvable as `handle/name`; every later
+     * publication under it is public too. Needs the project's publisher handle.
+     */
+    publish: (args: {
+        kind: EnumInput<PublicNameKind>;
+        name: string;
+    } & SignalOptionsIface) => Promise<PublicNameIface>;
+    /** Withdraws a public name; `handle/name` stops resolving. */
+    withdraw: (args: {
+        kind: EnumInput<PublicNameKind>;
+        name: string;
+    } & SignalOptionsIface) => Promise<void>;
+}
+export interface PublisherHandleIface {
+    readonly handle: string;
+    info: (options?: SignalOptionsIface) => Promise<PublisherIface>;
+    agents: {
+        list: (options?: SignalOptionsIface & {
+            cursor?: string;
+            limit?: number;
+        }) => Promise<AgentListIface>;
+    };
+    channels: {
+        list: (options?: SignalOptionsIface) => Promise<ChannelIface[]>;
+    };
+    harnesses: {
+        list: (options?: SignalOptionsIface) => Promise<HarnessDefinitionSummaryIface[]>;
+    };
+    adapters: {
+        list: (options?: SignalOptionsIface) => Promise<AcpAdapterDefinitionSummaryIface[]>;
+    };
+}
+export interface PublishersApiIface {
+    /** A publisher's public names (I/O-free handle). */
+    get: (handle: string) => PublisherHandleIface;
+}
+export declare const createProjectPublisherApi: (args: {
+    context: ClientContextIface;
+    projectId: string;
+}) => ProjectPublisherApiIface;
+export declare const createPublicNamesApi: (args: {
+    context: ClientContextIface;
+    projectId: string;
+}) => PublicNamesApiIface;
+export declare const createPublishersApi: (context: ClientContextIface) => PublishersApiIface;

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

@@ -0,0 +1,109 @@
+import {
+  acpAdapterDefinitionListSchema,
+  agentListSchema,
+  channelListSchema,
+  claimPublisherRequestSchema,
+  harnessDefinitionListSchema,
+  okResponseSchema,
+  publicNameSchema,
+  publisherSchema,
+  publishNameRequestSchema
+} from "@finalai/agent-protocol/agent-platform";
+import {
+  encodePath
+} from "./context.mjs";
+import { HttpMethod } from "./http.mjs";
+const createProjectPublisherApi = (args) => {
+  const { http } = args.context;
+  const path = `/v1/projects/${encodePath(args.projectId)}/publisher`;
+  return {
+    claim: ({ handle, signal }) => http.request({
+      method: HttpMethod.Put,
+      path,
+      body: { schema: claimPublisherRequestSchema, value: { handle } },
+      response: publisherSchema,
+      signal
+    }),
+    get: (options) => http.request({
+      method: HttpMethod.Get,
+      path,
+      response: publisherSchema,
+      signal: options?.signal
+    })
+  };
+};
+const createPublicNamesApi = (args) => {
+  const { http } = args.context;
+  const path = (kind, name) => `/v1/projects/${encodePath(args.projectId)}/public-names/${encodePath(kind)}/${encodePath(name)}`;
+  return {
+    publish: ({ kind, name, signal }) => http.request({
+      method: HttpMethod.Put,
+      path: path(kind, name),
+      body: { schema: publishNameRequestSchema, value: {} },
+      response: publicNameSchema,
+      signal
+    }),
+    withdraw: async ({ kind, name, signal }) => {
+      await http.request({
+        method: HttpMethod.Delete,
+        path: path(kind, name),
+        response: okResponseSchema,
+        signal
+      });
+    }
+  };
+};
+const createPublishersApi = (context) => ({
+  get: (handle) => {
+    const { http } = context;
+    const path = (suffix = "") => `/v1/publishers/${encodePath(handle)}${suffix}`;
+    return {
+      handle,
+      info: (options) => http.request({
+        method: HttpMethod.Get,
+        path: path(),
+        response: publisherSchema,
+        signal: options?.signal
+      }),
+      agents: {
+        list: (options) => http.request({
+          method: HttpMethod.Get,
+          path: path("/agents"),
+          query: { cursor: options?.cursor, limit: options?.limit },
+          response: agentListSchema,
+          signal: options?.signal
+        })
+      },
+      channels: {
+        list: async (options) => (await http.request({
+          method: HttpMethod.Get,
+          path: path("/channels"),
+          response: channelListSchema,
+          signal: options?.signal
+        })).channels
+      },
+      harnesses: {
+        list: async (options) => (await http.request({
+          method: HttpMethod.Get,
+          path: path("/harnesses"),
+          response: harnessDefinitionListSchema,
+          signal: options?.signal
+        })).harnesses
+      },
+      adapters: {
+        list: async (options) => (await http.request({
+          method: HttpMethod.Get,
+          path: path("/acp-adapters"),
+          response: acpAdapterDefinitionListSchema,
+          signal: options?.signal
+        })).adapters
+      }
+    };
+  }
+});
+export {
+  createProjectPublisherApi,
+  createPublicNamesApi,
+  createPublishersApi
+};
+//# sourceMappingURL=publishers.mjs.map