@finalai/agents 0.10.0 → 0.12.0

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/agent-client/publishers.ts"],
+  "sourcesContent": ["import {\n  acpAdapterDefinitionListSchema,\n  agentListSchema,\n  channelListSchema,\n  claimPublisherRequestSchema,\n  harnessDefinitionListSchema,\n  okResponseSchema,\n  publicNameSchema,\n  publisherSchema,\n  publishNameRequestSchema,\n  type AcpAdapterDefinitionSummaryIface,\n  type AgentListIface,\n  type ChannelIface,\n  type HarnessDefinitionSummaryIface,\n  type PublicNameIface,\n  type PublicNameKind,\n  type PublisherIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport {\n  encodePath,\n  type ClientContextIface,\n  type EnumInput,\n  type SignalOptionsIface,\n} from \"./context.mjs\";\nimport { HttpMethod } from \"./http.mjs\";\n\n// Publishers: a project's one handle, under which the names it makes public\n// resolve as `handle/name` from any organization.\n\nexport interface ProjectPublisherApiIface {\n  /** Claims the project's handle: first come, once per project, never changed. */\n  claim: (args: { handle: string } & SignalOptionsIface) => Promise<PublisherIface>;\n  /** The project's handle; fails with `not_found` before one is claimed. */\n  get: (options?: SignalOptionsIface) => Promise<PublisherIface>;\n}\n\nexport interface PublicNamesApiIface {\n  /**\n   * Makes a name the project published resolvable as `handle/name`; every later\n   * publication under it is public too. Needs the project's publisher handle.\n   */\n  publish: (\n    args: { kind: EnumInput<PublicNameKind>; name: string } & SignalOptionsIface,\n  ) => Promise<PublicNameIface>;\n  /** Withdraws a public name; `handle/name` stops resolving. */\n  withdraw: (\n    args: { kind: EnumInput<PublicNameKind>; name: string } & SignalOptionsIface,\n  ) => Promise<void>;\n}\n\nexport interface PublisherHandleIface {\n  readonly handle: string;\n  info: (options?: SignalOptionsIface) => Promise<PublisherIface>;\n  agents: {\n    list: (\n      options?: SignalOptionsIface & { cursor?: string; limit?: number },\n    ) => Promise<AgentListIface>;\n  };\n  channels: { list: (options?: SignalOptionsIface) => Promise<ChannelIface[]> };\n  harnesses: { list: (options?: SignalOptionsIface) => Promise<HarnessDefinitionSummaryIface[]> };\n  adapters: {\n    list: (options?: SignalOptionsIface) => Promise<AcpAdapterDefinitionSummaryIface[]>;\n  };\n}\n\nexport interface PublishersApiIface {\n  /** A publisher's public names (I/O-free handle). */\n  get: (handle: string) => PublisherHandleIface;\n}\n\nexport const createProjectPublisherApi = (args: {\n  context: ClientContextIface;\n  projectId: string;\n}): ProjectPublisherApiIface => {\n  const { http } = args.context;\n  const path = `/v1/projects/${encodePath(args.projectId)}/publisher`;\n  return {\n    claim: ({ handle, signal }) =>\n      http.request({\n        method: HttpMethod.Put,\n        path,\n        body: { schema: claimPublisherRequestSchema, value: { handle } },\n        response: publisherSchema,\n        signal,\n      }),\n    get: (options) =>\n      http.request({\n        method: HttpMethod.Get,\n        path,\n        response: publisherSchema,\n        signal: options?.signal,\n      }),\n  };\n};\n\nexport const createPublicNamesApi = (args: {\n  context: ClientContextIface;\n  projectId: string;\n}): PublicNamesApiIface => {\n  const { http } = args.context;\n  const path = (kind: string, name: string): string =>\n    `/v1/projects/${encodePath(args.projectId)}/public-names/${encodePath(kind)}/${encodePath(name)}`;\n  return {\n    publish: ({ kind, name, signal }) =>\n      http.request({\n        method: HttpMethod.Put,\n        path: path(kind, name),\n        body: { schema: publishNameRequestSchema, value: {} },\n        response: publicNameSchema,\n        signal,\n      }),\n    withdraw: async ({ kind, name, signal }) => {\n      await http.request({\n        method: HttpMethod.Delete,\n        path: path(kind, name),\n        response: okResponseSchema,\n        signal,\n      });\n    },\n  };\n};\n\nexport const createPublishersApi = (context: ClientContextIface): PublishersApiIface => ({\n  get: (handle) => {\n    const { http } = context;\n    const path = (suffix = ''): string => `/v1/publishers/${encodePath(handle)}${suffix}`;\n    return {\n      handle,\n      info: (options) =>\n        http.request({\n          method: HttpMethod.Get,\n          path: path(),\n          response: publisherSchema,\n          signal: options?.signal,\n        }),\n      agents: {\n        list: (options) =>\n          http.request({\n            method: HttpMethod.Get,\n            path: path('/agents'),\n            query: { cursor: options?.cursor, limit: options?.limit },\n            response: agentListSchema,\n            signal: options?.signal,\n          }),\n      },\n      channels: {\n        list: async (options) =>\n          (\n            await http.request({\n              method: HttpMethod.Get,\n              path: path('/channels'),\n              response: channelListSchema,\n              signal: options?.signal,\n            })\n          ).channels,\n      },\n      harnesses: {\n        list: async (options) =>\n          (\n            await http.request({\n              method: HttpMethod.Get,\n              path: path('/harnesses'),\n              response: harnessDefinitionListSchema,\n              signal: options?.signal,\n            })\n          ).harnesses,\n      },\n      adapters: {\n        list: async (options) =>\n          (\n            await http.request({\n              method: HttpMethod.Get,\n              path: path('/acp-adapters'),\n              response: acpAdapterDefinitionListSchema,\n              signal: options?.signal,\n            })\n          ).adapters,\n      },\n    };\n  },\n});\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAQK;AACP;AAAA,EACE;AAAA,OAIK;AACP,SAAS,kBAAkB;AA8CpB,MAAM,4BAA4B,CAAC,SAGV;AAC9B,QAAM,EAAE,KAAK,IAAI,KAAK;AACtB,QAAM,OAAO,gBAAgB,WAAW,KAAK,SAAS,CAAC;AACvD,SAAO;AAAA,IACL,OAAO,CAAC,EAAE,QAAQ,OAAO,MACvB,KAAK,QAAQ;AAAA,MACX,QAAQ,WAAW;AAAA,MACnB;AAAA,MACA,MAAM,EAAE,QAAQ,6BAA6B,OAAO,EAAE,OAAO,EAAE;AAAA,MAC/D,UAAU;AAAA,MACV;AAAA,IACF,CAAC;AAAA,IACH,KAAK,CAAC,YACJ,KAAK,QAAQ;AAAA,MACX,QAAQ,WAAW;AAAA,MACnB;AAAA,MACA,UAAU;AAAA,MACV,QAAQ,SAAS;AAAA,IACnB,CAAC;AAAA,EACL;AACF;AAEO,MAAM,uBAAuB,CAAC,SAGV;AACzB,QAAM,EAAE,KAAK,IAAI,KAAK;AACtB,QAAM,OAAO,CAAC,MAAc,SAC1B,gBAAgB,WAAW,KAAK,SAAS,CAAC,iBAAiB,WAAW,IAAI,CAAC,IAAI,WAAW,IAAI,CAAC;AACjG,SAAO;AAAA,IACL,SAAS,CAAC,EAAE,MAAM,MAAM,OAAO,MAC7B,KAAK,QAAQ;AAAA,MACX,QAAQ,WAAW;AAAA,MACnB,MAAM,KAAK,MAAM,IAAI;AAAA,MACrB,MAAM,EAAE,QAAQ,0BAA0B,OAAO,CAAC,EAAE;AAAA,MACpD,UAAU;AAAA,MACV;AAAA,IACF,CAAC;AAAA,IACH,UAAU,OAAO,EAAE,MAAM,MAAM,OAAO,MAAM;AAC1C,YAAM,KAAK,QAAQ;AAAA,QACjB,QAAQ,WAAW;AAAA,QACnB,MAAM,KAAK,MAAM,IAAI;AAAA,QACrB,UAAU;AAAA,QACV;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;AAEO,MAAM,sBAAsB,CAAC,aAAqD;AAAA,EACvF,KAAK,CAAC,WAAW;AACf,UAAM,EAAE,KAAK,IAAI;AACjB,UAAM,OAAO,CAAC,SAAS,OAAe,kBAAkB,WAAW,MAAM,CAAC,GAAG,MAAM;AACnF,WAAO;AAAA,MACL;AAAA,MACA,MAAM,CAAC,YACL,KAAK,QAAQ;AAAA,QACX,QAAQ,WAAW;AAAA,QACnB,MAAM,KAAK;AAAA,QACX,UAAU;AAAA,QACV,QAAQ,SAAS;AAAA,MACnB,CAAC;AAAA,MACH,QAAQ;AAAA,QACN,MAAM,CAAC,YACL,KAAK,QAAQ;AAAA,UACX,QAAQ,WAAW;AAAA,UACnB,MAAM,KAAK,SAAS;AAAA,UACpB,OAAO,EAAE,QAAQ,SAAS,QAAQ,OAAO,SAAS,MAAM;AAAA,UACxD,UAAU;AAAA,UACV,QAAQ,SAAS;AAAA,QACnB,CAAC;AAAA,MACL;AAAA,MACA,UAAU;AAAA,QACR,MAAM,OAAO,aAET,MAAM,KAAK,QAAQ;AAAA,UACjB,QAAQ,WAAW;AAAA,UACnB,MAAM,KAAK,WAAW;AAAA,UACtB,UAAU;AAAA,UACV,QAAQ,SAAS;AAAA,QACnB,CAAC,GACD;AAAA,MACN;AAAA,MACA,WAAW;AAAA,QACT,MAAM,OAAO,aAET,MAAM,KAAK,QAAQ;AAAA,UACjB,QAAQ,WAAW;AAAA,UACnB,MAAM,KAAK,YAAY;AAAA,UACvB,UAAU;AAAA,UACV,QAAQ,SAAS;AAAA,QACnB,CAAC,GACD;AAAA,MACN;AAAA,MACA,UAAU;AAAA,QACR,MAAM,OAAO,aAET,MAAM,KAAK,QAAQ;AAAA,UACjB,QAAQ,WAAW;AAAA,UACnB,MAAM,KAAK,eAAe;AAAA,UAC1B,UAAU;AAAA,UACV,QAAQ,SAAS;AAAA,QACnB,CAAC,GACD;AAAA,MACN;AAAA,IACF;AAAA,EACF;AACF;",
+  "names": []
+}

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

@@ -0,0 +1,60 @@
+import { Capability } from '@finalai/agent-protocol';
+import { PermissionLevel, type HarnessCheckResponseIface, type ProvideDocumentIface, type UnmetRequirementIface } from '@finalai/agent-protocol/agent-platform';
+import type { ResolvedAgentIface } from "./agent-input.mjs";
+export interface LocalCheckArgsIface {
+    agent: ResolvedAgentIface;
+    provide: ProvideDocumentIface;
+    /** The platform's verdict on the harness settings, when the SDK asked for one. */
+    harness?: HarnessCheckResponseIface | null;
+    /** Whether this process will answer the agent's in-process code over its connection. */
+    servesCode: boolean;
+}
+export declare const parseProvide: (provide: ProvideDocumentIface) => {
+    harness?: {
+        harness: string;
+        configuration: {
+            [x: string]: unknown;
+            model?: string | undefined;
+            reasoning?: string | undefined;
+            inference?: ({
+                source: import("@finalai/agent-provider").InferenceSourceKind.Subscription;
+                credential: import("@finalai/agent-provider").CredentialScope;
+                vendor?: string | undefined;
+            } | {
+                source: import("@finalai/agent-provider").InferenceSourceKind.ApiKey;
+                secret: string;
+                baseUrl?: string | undefined;
+                vendor?: string | undefined;
+            } | {
+                source: import("@finalai/agent-provider").InferenceSourceKind.Final;
+                billTo: import("@finalai/agent-provider").InferenceBillTo;
+                budget?: string | undefined;
+            } | {
+                source: import("@finalai/agent-provider").InferenceSourceKind.Harness;
+            })[] | undefined;
+            permissionMode?: PermissionLevel | undefined;
+        };
+        adapter?: string | undefined;
+        environment?: string | {
+            url: string;
+            hop?: string | undefined;
+        } | undefined;
+    } | undefined;
+    compute?: Partial<Record<Capability, string>> | undefined;
+    integrations?: Record<string, string> | undefined;
+};
+export declare const localUnmetRequirements: (args: LocalCheckArgsIface) => UnmetRequirementIface[];
+/** Throws `requirements_unmet` when anything is missing. */
+export declare const assertRequirementsMet: (args: LocalCheckArgsIface) => void;
+/**
+ * The capabilities this process can provide for the agent from its own
+ * process: the files and shell it requires that the caller left out and the
+ * harness does not serve where it runs. A harness that uses them natively and
+ * names no environment runs where `shell` is provided, so this process serves
+ * it and becomes that harness's environment.
+ */
+export declare const capabilitiesToServeLocally: (args: {
+    agent: ResolvedAgentIface;
+    provide: ProvideDocumentIface;
+    harness: HarnessCheckResponseIface | null;
+}) => Capability[];

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

@@ -0,0 +1,83 @@
+import {
+  Capability,
+  DEFAULT_CAPABILITY_ACCESS,
+  PROCESS_CAPABILITIES
+} from "@finalai/agent-protocol";
+import {
+  AgentApiErrorCode,
+  HarnessComputeStatus,
+  isUrlEnvironment,
+  PermissionLevel,
+  provideDocumentSchema
+} from "@finalai/agent-protocol/agent-platform";
+import { computeRequirementsOf, HarnessFeature } from "@finalai/agent-provider/document";
+import { unmetRequirements } from "@finalai/agent-provider/requirements-check";
+import { clientError, ClientErrorCode, requirementsUnmetError } from "./errors.mjs";
+const ALL_FEATURES = Object.values(HarnessFeature);
+const parseProvide = (provide) => {
+  const parsed = provideDocumentSchema.safeParse(provide);
+  if (!parsed.success)
+    throw clientError({
+      message: `Invalid provide: ${parsed.error.message}`,
+      status: 0,
+      code: ClientErrorCode.InvalidRequest
+    });
+  return parsed.data;
+};
+const localUnmetRequirements = (args) => {
+  const provide = parseProvide(args.provide);
+  const compute = {};
+  for (const [capability, status] of Object.entries(args.harness?.compute ?? {})) {
+    const known = Object.values(Capability).find((value) => value === capability);
+    const served = Object.values(HarnessComputeStatus).find((value) => value === status.status);
+    if (known != null && served != null) compute[known] = served;
+  }
+  const settings = provide.harness?.environment;
+  const environment = isUrlEnvironment(settings) ? null : args.harness?.environment ?? settings ?? provide.compute?.[Capability.Shell] ?? provide.compute?.[Capability.Files] ?? null;
+  const unmet = unmetRequirements({
+    document: args.agent.document,
+    provide,
+    harness: provide.harness == null ? null : { supports: ALL_FEATURES, lowestPermission: PermissionLevel.Ask, compute, environment },
+    sandbox: () => ({ capabilities: DEFAULT_CAPABILITY_ACCESS }),
+    integrationExists: () => true,
+    inProcessCodeAvailable: args.servesCode || args.agent.inProcess.length === 0
+  });
+  return [
+    ...unmet.map((item) => ({ ...item })),
+    ...args.harness == null || args.harness.suitable ? [] : args.harness.problems
+  ];
+};
+const assertRequirementsMet = (args) => {
+  const unmet = localUnmetRequirements(args);
+  if (unmet.length === 0) return;
+  throw requirementsUnmetError({
+    status: 0,
+    code: AgentApiErrorCode.RequirementsUnmet,
+    agent: args.agent.hash,
+    requirements: unmet
+  });
+};
+const capabilitiesToServeLocally = (args) => {
+  const provided = args.provide.compute ?? {};
+  if (PROCESS_CAPABILITIES.some((capability) => provided[capability] != null)) return [];
+  const awaitsEnvironment = args.harness != null && args.harness.environment == null && args.provide.harness?.environment == null && PROCESS_CAPABILITIES.some(
+    (capability) => args.harness?.compute[capability]?.status === HarnessComputeStatus.Harness
+  );
+  const serve = [];
+  for (const [capability] of computeRequirementsOf(args.agent.document)) {
+    if (!PROCESS_CAPABILITIES.includes(capability)) continue;
+    const status = args.harness?.compute[capability]?.status;
+    if (status === HarnessComputeStatus.Unavailable) continue;
+    if (status === HarnessComputeStatus.Harness && !awaitsEnvironment) continue;
+    serve.push(capability);
+  }
+  if (awaitsEnvironment && !serve.includes(Capability.Shell)) serve.push(Capability.Shell);
+  return serve;
+};
+export {
+  assertRequirementsMet,
+  capabilitiesToServeLocally,
+  localUnmetRequirements,
+  parseProvide
+};
+//# sourceMappingURL=requirements.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/agent-client/requirements.ts"],
+  "sourcesContent": ["import {\n  Capability,\n  DEFAULT_CAPABILITY_ACCESS,\n  PROCESS_CAPABILITIES,\n} from '@finalai/agent-protocol';\nimport {\n  AgentApiErrorCode,\n  HarnessComputeStatus,\n  isUrlEnvironment,\n  PermissionLevel,\n  provideDocumentSchema,\n  type HarnessCheckResponseIface,\n  type ProvideDocumentIface,\n  type UnmetRequirementIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { computeRequirementsOf, HarnessFeature } from '@finalai/agent-provider/document';\nimport { unmetRequirements } from '@finalai/agent-provider/requirements-check';\nimport { clientError, ClientErrorCode, requirementsUnmetError } from \"./errors.mjs\";\nimport type { ResolvedAgentIface } from \"./agent-input.mjs\";\n\n// The SDK runs the platform's requirements check before sending, with what it\n// knows: what was provided, and whether this process holds the agent's\n// in-process code. What only the platform can judge (whether an id exists,\n// what a sandbox grants, whether a harness suits the agent) is assumed met\n// here and checked there.\n\nexport interface LocalCheckArgsIface {\n  agent: ResolvedAgentIface;\n  provide: ProvideDocumentIface;\n  /** The platform's verdict on the harness settings, when the SDK asked for one. */\n  harness?: HarnessCheckResponseIface | null;\n  /** Whether this process will answer the agent's in-process code over its connection. */\n  servesCode: boolean;\n}\n\nconst ALL_FEATURES = Object.values(HarnessFeature);\n\nexport const parseProvide = (provide: ProvideDocumentIface) => {\n  const parsed = provideDocumentSchema.safeParse(provide);\n  if (!parsed.success)\n    throw clientError({\n      message: `Invalid provide: ${parsed.error.message}`,\n      status: 0,\n      code: ClientErrorCode.InvalidRequest,\n    });\n  return parsed.data;\n};\n\nexport const localUnmetRequirements = (args: LocalCheckArgsIface): UnmetRequirementIface[] => {\n  const provide = parseProvide(args.provide);\n  const compute: Partial<Record<Capability, HarnessComputeStatus>> = {};\n  for (const [capability, status] of Object.entries(args.harness?.compute ?? {})) {\n    const known = Object.values(Capability).find((value) => value === capability);\n    const served = Object.values(HarnessComputeStatus).find((value) => value === status.status);\n    if (known != null && served != null) compute[known] = served;\n  }\n  // Native capabilities are the environment's: the platform's answer, else\n  // the settings', else (placed by `shell`) the sandbox provided for it.\n  const settings = provide.harness?.environment;\n  const environment = isUrlEnvironment(settings)\n    ? null\n    : (args.harness?.environment ??\n      settings ??\n      provide.compute?.[Capability.Shell] ??\n      provide.compute?.[Capability.Files] ??\n      null);\n  const unmet = unmetRequirements({\n    document: args.agent.document,\n    provide,\n    harness:\n      provide.harness == null\n        ? null\n        : { supports: ALL_FEATURES, lowestPermission: PermissionLevel.Ask, compute, environment },\n    sandbox: () => ({ capabilities: DEFAULT_CAPABILITY_ACCESS }),\n    integrationExists: () => true,\n    inProcessCodeAvailable: args.servesCode || args.agent.inProcess.length === 0,\n  });\n  return [\n    ...unmet.map((item) => ({ ...item })),\n    ...(args.harness == null || args.harness.suitable ? [] : args.harness.problems),\n  ];\n};\n\n/** Throws `requirements_unmet` when anything is missing. */\nexport const assertRequirementsMet = (args: LocalCheckArgsIface): void => {\n  const unmet = localUnmetRequirements(args);\n  if (unmet.length === 0) return;\n  throw requirementsUnmetError({\n    status: 0,\n    code: AgentApiErrorCode.RequirementsUnmet,\n    agent: args.agent.hash,\n    requirements: unmet,\n  });\n};\n\n/**\n * The capabilities this process can provide for the agent from its own\n * process: the files and shell it requires that the caller left out and the\n * harness does not serve where it runs. A harness that uses them natively and\n * names no environment runs where `shell` is provided, so this process serves\n * it and becomes that harness's environment.\n */\nexport const capabilitiesToServeLocally = (args: {\n  agent: ResolvedAgentIface;\n  provide: ProvideDocumentIface;\n  harness: HarnessCheckResponseIface | null;\n}): Capability[] => {\n  const provided = args.provide.compute ?? {};\n  // `files` and `shell` share one sandbox: once the caller named one for\n  // either, this process serves neither.\n  if (PROCESS_CAPABILITIES.some((capability) => provided[capability] != null)) return [];\n  const awaitsEnvironment =\n    args.harness != null &&\n    args.harness.environment == null &&\n    args.provide.harness?.environment == null &&\n    PROCESS_CAPABILITIES.some(\n      (capability) => args.harness?.compute[capability]?.status === HarnessComputeStatus.Harness,\n    );\n  const serve: Capability[] = [];\n  for (const [capability] of computeRequirementsOf(args.agent.document)) {\n    if (!PROCESS_CAPABILITIES.includes(capability)) continue;\n    const status = args.harness?.compute[capability]?.status;\n    if (status === HarnessComputeStatus.Unavailable) continue;\n    if (status === HarnessComputeStatus.Harness && !awaitsEnvironment) continue;\n    serve.push(capability);\n  }\n  if (awaitsEnvironment && !serve.includes(Capability.Shell)) serve.push(Capability.Shell);\n  return serve;\n};\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,34 @@
+import { type RegisterSandboxProviderRequestIface, type SandboxProviderInfoIface, type UpdateSandboxProviderRequestIface } from '@finalai/agent-protocol/agent-platform';
+import { type ClientContextIface, type SignalOptionsIface } from "./context.mjs";
+export interface SandboxProvidersApiIface {
+    /**
+     * Registers a provider served at `url` (see `serveSandboxProvider` in
+     * `@finalai/agent-provider/sandbox/remote`). The platform reads its discovery
+     * document first. `grants` lets it obtain assertions for those backends.
+     */
+    register: (args: RegisterSandboxProviderRequestIface & SignalOptionsIface) => Promise<SandboxProviderInfoIface>;
+    /** This project's registrations and its ancestors', the nearest per name. */
+    list: (options?: SignalOptionsIface) => Promise<SandboxProviderInfoIface[]>;
+    /** By id, or the registration `name` resolves to here. */
+    get: (selector: ({
+        id: string;
+    } | {
+        name: string;
+    }) & SignalOptionsIface) => Promise<SandboxProviderInfoIface>;
+    /** `grants` replaces the set. */
+    update: (args: {
+        id: string;
+    } & UpdateSandboxProviderRequestIface & SignalOptionsIface) => Promise<SandboxProviderInfoIface>;
+    /** Reads the provider's discovery document again. */
+    refresh: (args: {
+        id: string;
+    } & SignalOptionsIface) => Promise<SandboxProviderInfoIface>;
+    /** Refused with `in_use` while a sandbox that has not ended uses it. */
+    remove: (args: {
+        id: string;
+    } & SignalOptionsIface) => Promise<void>;
+}
+export declare const createSandboxProvidersApi: (args: {
+    context: ClientContextIface;
+    projectId: string;
+}) => SandboxProvidersApiIface;

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

@@ -0,0 +1,75 @@
+import {
+  okResponseSchema,
+  registerSandboxProviderRequestSchema,
+  sandboxProviderInfoListSchema,
+  sandboxProviderInfoSchema,
+  updateSandboxProviderRequestSchema
+} from "@finalai/agent-protocol/agent-platform";
+import * as z from "zod";
+import { encodePath } from "./context.mjs";
+import { clientError, ClientErrorCode } from "./errors.mjs";
+import { HttpMethod } from "./http.mjs";
+const emptyBodySchema = z.strictObject({});
+const createSandboxProvidersApi = (args) => {
+  const { http } = args.context;
+  const path = (suffix = "") => `/v1/projects/${encodePath(args.projectId)}/sandbox-providers${suffix}`;
+  const list = async (options) => (await http.request({
+    method: HttpMethod.Get,
+    path: path(),
+    response: sandboxProviderInfoListSchema,
+    signal: options?.signal
+  })).providers;
+  return {
+    register: ({ signal, ...value }) => http.request({
+      method: HttpMethod.Post,
+      path: path(),
+      body: { schema: registerSandboxProviderRequestSchema, value },
+      response: sandboxProviderInfoSchema,
+      signal
+    }),
+    list,
+    get: async ({ signal, ...selector }) => {
+      if ("id" in selector)
+        return http.request({
+          method: HttpMethod.Get,
+          path: path(`/${encodePath(selector.id)}`),
+          response: sandboxProviderInfoSchema,
+          signal
+        });
+      const found = (await list({ signal })).find((provider) => provider.name === selector.name);
+      if (found == null)
+        throw clientError({
+          message: `No sandbox provider named ${selector.name} in this project or above it`,
+          status: 404,
+          code: ClientErrorCode.NotFound
+        });
+      return found;
+    },
+    update: ({ id, signal, ...value }) => http.request({
+      method: HttpMethod.Patch,
+      path: path(`/${encodePath(id)}`),
+      body: { schema: updateSandboxProviderRequestSchema, value },
+      response: sandboxProviderInfoSchema,
+      signal
+    }),
+    refresh: ({ id, signal }) => http.request({
+      method: HttpMethod.Post,
+      path: path(`/${encodePath(id)}/refresh`),
+      body: { schema: emptyBodySchema, value: {} },
+      response: sandboxProviderInfoSchema,
+      signal
+    }),
+    remove: async ({ id, signal }) => {
+      await http.request({
+        method: HttpMethod.Delete,
+        path: path(`/${encodePath(id)}`),
+        response: okResponseSchema,
+        signal
+      });
+    }
+  };
+};
+export {
+  createSandboxProvidersApi
+};
+//# sourceMappingURL=sandbox-providers.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/agent-client/sandbox-providers.ts"],
+  "sourcesContent": ["import {\n  okResponseSchema,\n  registerSandboxProviderRequestSchema,\n  sandboxProviderInfoListSchema,\n  sandboxProviderInfoSchema,\n  updateSandboxProviderRequestSchema,\n  type RegisterSandboxProviderRequestIface,\n  type SandboxProviderInfoIface,\n  type UpdateSandboxProviderRequestIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport * as z from 'zod';\nimport { encodePath, type ClientContextIface, type SignalOptionsIface } from \"./context.mjs\";\nimport { clientError, ClientErrorCode } from \"./errors.mjs\";\nimport { HttpMethod } from \"./http.mjs\";\n\n// Sandbox providers registered on a project by URL. A project resolves a\n// provider by name through its own registrations and its ancestors', nearest\n// first.\n\nexport interface SandboxProvidersApiIface {\n  /**\n   * Registers a provider served at `url` (see `serveSandboxProvider` in\n   * `@finalai/agent-provider/sandbox/remote`). The platform reads its discovery\n   * document first. `grants` lets it obtain assertions for those backends.\n   */\n  register: (\n    args: RegisterSandboxProviderRequestIface & SignalOptionsIface,\n  ) => Promise<SandboxProviderInfoIface>;\n  /** This project's registrations and its ancestors', the nearest per name. */\n  list: (options?: SignalOptionsIface) => Promise<SandboxProviderInfoIface[]>;\n  /** By id, or the registration `name` resolves to here. */\n  get: (\n    selector: ({ id: string } | { name: string }) & SignalOptionsIface,\n  ) => Promise<SandboxProviderInfoIface>;\n  /** `grants` replaces the set. */\n  update: (\n    args: { id: string } & UpdateSandboxProviderRequestIface & SignalOptionsIface,\n  ) => Promise<SandboxProviderInfoIface>;\n  /** Reads the provider's discovery document again. */\n  refresh: (args: { id: string } & SignalOptionsIface) => Promise<SandboxProviderInfoIface>;\n  /** Refused with `in_use` while a sandbox that has not ended uses it. */\n  remove: (args: { id: string } & SignalOptionsIface) => Promise<void>;\n}\n\nconst emptyBodySchema = z.strictObject({});\n\nexport const createSandboxProvidersApi = (args: {\n  context: ClientContextIface;\n  projectId: string;\n}): SandboxProvidersApiIface => {\n  const { http } = args.context;\n  const path = (suffix = ''): string =>\n    `/v1/projects/${encodePath(args.projectId)}/sandbox-providers${suffix}`;\n  const list: SandboxProvidersApiIface['list'] = async (options) =>\n    (\n      await http.request({\n        method: HttpMethod.Get,\n        path: path(),\n        response: sandboxProviderInfoListSchema,\n        signal: options?.signal,\n      })\n    ).providers;\n  return {\n    register: ({ signal, ...value }) =>\n      http.request({\n        method: HttpMethod.Post,\n        path: path(),\n        body: { schema: registerSandboxProviderRequestSchema, value },\n        response: sandboxProviderInfoSchema,\n        signal,\n      }),\n    list,\n    get: async ({ signal, ...selector }) => {\n      if ('id' in selector)\n        return http.request({\n          method: HttpMethod.Get,\n          path: path(`/${encodePath(selector.id)}`),\n          response: sandboxProviderInfoSchema,\n          signal,\n        });\n      const found = (await list({ signal })).find((provider) => provider.name === selector.name);\n      if (found == null)\n        throw clientError({\n          message: `No sandbox provider named ${selector.name} in this project or above it`,\n          status: 404,\n          code: ClientErrorCode.NotFound,\n        });\n      return found;\n    },\n    update: ({ id, signal, ...value }) =>\n      http.request({\n        method: HttpMethod.Patch,\n        path: path(`/${encodePath(id)}`),\n        body: { schema: updateSandboxProviderRequestSchema, value },\n        response: sandboxProviderInfoSchema,\n        signal,\n      }),\n    refresh: ({ id, signal }) =>\n      http.request({\n        method: HttpMethod.Post,\n        path: path(`/${encodePath(id)}/refresh`),\n        body: { schema: emptyBodySchema, value: {} },\n        response: sandboxProviderInfoSchema,\n        signal,\n      }),\n    remove: async ({ id, signal }) => {\n      await http.request({\n        method: HttpMethod.Delete,\n        path: path(`/${encodePath(id)}`),\n        response: okResponseSchema,\n        signal,\n      });\n    },\n  };\n};\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AACP,YAAY,OAAO;AACnB,SAAS,kBAAoE;AAC7E,SAAS,aAAa,uBAAuB;AAC7C,SAAS,kBAAkB;AA+B3B,MAAM,kBAAkB,EAAE,aAAa,CAAC,CAAC;AAElC,MAAM,4BAA4B,CAAC,SAGV;AAC9B,QAAM,EAAE,KAAK,IAAI,KAAK;AACtB,QAAM,OAAO,CAAC,SAAS,OACrB,gBAAgB,WAAW,KAAK,SAAS,CAAC,qBAAqB,MAAM;AACvE,QAAM,OAAyC,OAAO,aAElD,MAAM,KAAK,QAAQ;AAAA,IACjB,QAAQ,WAAW;AAAA,IACnB,MAAM,KAAK;AAAA,IACX,UAAU;AAAA,IACV,QAAQ,SAAS;AAAA,EACnB,CAAC,GACD;AACJ,SAAO;AAAA,IACL,UAAU,CAAC,EAAE,QAAQ,GAAG,MAAM,MAC5B,KAAK,QAAQ;AAAA,MACX,QAAQ,WAAW;AAAA,MACnB,MAAM,KAAK;AAAA,MACX,MAAM,EAAE,QAAQ,sCAAsC,MAAM;AAAA,MAC5D,UAAU;AAAA,MACV;AAAA,IACF,CAAC;AAAA,IACH;AAAA,IACA,KAAK,OAAO,EAAE,QAAQ,GAAG,SAAS,MAAM;AACtC,UAAI,QAAQ;AACV,eAAO,KAAK,QAAQ;AAAA,UAClB,QAAQ,WAAW;AAAA,UACnB,MAAM,KAAK,IAAI,WAAW,SAAS,EAAE,CAAC,EAAE;AAAA,UACxC,UAAU;AAAA,UACV;AAAA,QACF,CAAC;AACH,YAAM,SAAS,MAAM,KAAK,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,aAAa,SAAS,SAAS,SAAS,IAAI;AACzF,UAAI,SAAS;AACX,cAAM,YAAY;AAAA,UAChB,SAAS,6BAA6B,SAAS,IAAI;AAAA,UACnD,QAAQ;AAAA,UACR,MAAM,gBAAgB;AAAA,QACxB,CAAC;AACH,aAAO;AAAA,IACT;AAAA,IACA,QAAQ,CAAC,EAAE,IAAI,QAAQ,GAAG,MAAM,MAC9B,KAAK,QAAQ;AAAA,MACX,QAAQ,WAAW;AAAA,MACnB,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC,EAAE;AAAA,MAC/B,MAAM,EAAE,QAAQ,oCAAoC,MAAM;AAAA,MAC1D,UAAU;AAAA,MACV;AAAA,IACF,CAAC;AAAA,IACH,SAAS,CAAC,EAAE,IAAI,OAAO,MACrB,KAAK,QAAQ;AAAA,MACX,QAAQ,WAAW;AAAA,MACnB,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC,UAAU;AAAA,MACvC,MAAM,EAAE,QAAQ,iBAAiB,OAAO,CAAC,EAAE;AAAA,MAC3C,UAAU;AAAA,MACV;AAAA,IACF,CAAC;AAAA,IACH,QAAQ,OAAO,EAAE,IAAI,OAAO,MAAM;AAChC,YAAM,KAAK,QAAQ;AAAA,QACjB,QAAQ,WAAW;AAAA,QACnB,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC,EAAE;AAAA,QAC/B,UAAU;AAAA,QACV;AAAA,MACF,CAAC;AAAA,IACH;AAAA,EACF;AACF;",
+  "names": []
+}

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

@@ -7,7 +7,7 @@ type ResultIface<T> = {
 };
 export interface SandboxFileTargetIface {
     conversationId: string;
-    bindingId: string;
+    sandboxId: string;
 }
 export interface SandboxFileUriIface {
     target: SandboxFileTargetIface;

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

@@ -12,19 +12,19 @@ const wireIdValid = (prefix, value) => {
     return false;
   }
 };
-const targetValid = (target) => wireIdValid("conv", target.conversationId) && wireIdValid("sbnd", target.bindingId);
+const targetValid = (target) => wireIdValid("conv", target.conversationId) && wireIdValid("asbx", target.sandboxId);
 const pathValid = (path) => path.length > 0 && path.length <= 4096 && !path.includes("\0");
 const createSandboxFileUri = (location) => {
   if (!targetValid(location.target) || !pathValid(location.path))
     throw new Error("Invalid sandbox file location");
   const query = new URLSearchParams({ path: location.path });
-  return `final-sandbox://${location.target.conversationId}/${location.target.bindingId}?${query}`;
+  return `final-sandbox://${location.target.conversationId}/${location.target.sandboxId}?${query}`;
 };
 const parseSandboxFileUri = (value) => {
   try {
     const uri = new URL(value);
-    const bindingId = uri.pathname.slice(1);
-    const target = { conversationId: uri.hostname, bindingId };
+    const sandboxId = uri.pathname.slice(1);
+    const target = { conversationId: uri.hostname, sandboxId };
     const paths = uri.searchParams.getAll("path");
     if (uri.protocol !== SANDBOX_FILE_URI_SCHEME || uri.username.length > 0 || uri.password.length > 0 || uri.port.length > 0 || uri.hash.length > 0 || !targetValid(target) || paths.length !== 1 || [...uri.searchParams.keys()].some((key) => key !== "path"))
       return err("Invalid sandbox file URI");

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/agent-client/sandbox-uri.ts"],
-  "sourcesContent": ["import { base58Decode } from '@finalai/agent-protocol/base58';\ntype ResultIface<T> = { ok: true; data: T } | { ok: false; error: string };\nconst err = (error: string): { ok: false; error: string } => ({ ok: false, error });\nconst ok = <T>(data: T): { ok: true; data: T } => ({ ok: true, data });\n\nexport interface SandboxFileTargetIface {\n  conversationId: string;\n  bindingId: string;\n}\n\nexport interface SandboxFileUriIface {\n  target: SandboxFileTargetIface;\n  path: string;\n}\n\nexport const SANDBOX_FILE_URI_SCHEME = 'final-sandbox:';\n\nconst wireIdValid = (prefix: string, value: string): boolean => {\n  if (!value.startsWith(prefix + '_')) return false;\n  const body = value.slice(prefix.length + 1);\n  if (body.length === 0 || body.length > 22) return false;\n  try {\n    return base58Decode(body).length === 16;\n  } catch {\n    return false;\n  }\n};\n\nconst targetValid = (target: SandboxFileTargetIface): boolean =>\n  wireIdValid('conv', target.conversationId) && wireIdValid('sbnd', target.bindingId);\n\nconst pathValid = (path: string): boolean =>\n  path.length > 0 && path.length <= 4096 && !path.includes('\\0');\n\nexport const createSandboxFileUri = (location: SandboxFileUriIface): string => {\n  if (!targetValid(location.target) || !pathValid(location.path))\n    throw new Error('Invalid sandbox file location');\n  const query = new URLSearchParams({ path: location.path });\n  return `final-sandbox://${location.target.conversationId}/${location.target.bindingId}?${query}`;\n};\n\nexport const parseSandboxFileUri = (value: string): ResultIface<SandboxFileUriIface> => {\n  try {\n    const uri = new URL(value);\n    const bindingId = uri.pathname.slice(1);\n    const target = { conversationId: uri.hostname, bindingId };\n    const paths = uri.searchParams.getAll('path');\n    if (\n      uri.protocol !== SANDBOX_FILE_URI_SCHEME ||\n      uri.username.length > 0 ||\n      uri.password.length > 0 ||\n      uri.port.length > 0 ||\n      uri.hash.length > 0 ||\n      !targetValid(target) ||\n      paths.length !== 1 ||\n      [...uri.searchParams.keys()].some((key) => key !== 'path')\n    )\n      return err('Invalid sandbox file URI');\n    const path = paths[0];\n    if (path == null || !pathValid(path)) return err('Invalid sandbox file path');\n    return ok({ target, path });\n  } catch {\n    return err('Invalid sandbox file URI');\n  }\n};\n"],
+  "sourcesContent": ["import { base58Decode } from '@finalai/agent-protocol/base58';\ntype ResultIface<T> = { ok: true; data: T } | { ok: false; error: string };\nconst err = (error: string): { ok: false; error: string } => ({ ok: false, error });\nconst ok = <T>(data: T): { ok: true; data: T } => ({ ok: true, data });\n\nexport interface SandboxFileTargetIface {\n  conversationId: string;\n  sandboxId: string;\n}\n\nexport interface SandboxFileUriIface {\n  target: SandboxFileTargetIface;\n  path: string;\n}\n\nexport const SANDBOX_FILE_URI_SCHEME = 'final-sandbox:';\n\nconst wireIdValid = (prefix: string, value: string): boolean => {\n  if (!value.startsWith(prefix + '_')) return false;\n  const body = value.slice(prefix.length + 1);\n  if (body.length === 0 || body.length > 22) return false;\n  try {\n    return base58Decode(body).length === 16;\n  } catch {\n    return false;\n  }\n};\n\nconst targetValid = (target: SandboxFileTargetIface): boolean =>\n  wireIdValid('conv', target.conversationId) && wireIdValid('asbx', target.sandboxId);\n\nconst pathValid = (path: string): boolean =>\n  path.length > 0 && path.length <= 4096 && !path.includes('\\0');\n\nexport const createSandboxFileUri = (location: SandboxFileUriIface): string => {\n  if (!targetValid(location.target) || !pathValid(location.path))\n    throw new Error('Invalid sandbox file location');\n  const query = new URLSearchParams({ path: location.path });\n  return `final-sandbox://${location.target.conversationId}/${location.target.sandboxId}?${query}`;\n};\n\nexport const parseSandboxFileUri = (value: string): ResultIface<SandboxFileUriIface> => {\n  try {\n    const uri = new URL(value);\n    const sandboxId = uri.pathname.slice(1);\n    const target = { conversationId: uri.hostname, sandboxId };\n    const paths = uri.searchParams.getAll('path');\n    if (\n      uri.protocol !== SANDBOX_FILE_URI_SCHEME ||\n      uri.username.length > 0 ||\n      uri.password.length > 0 ||\n      uri.port.length > 0 ||\n      uri.hash.length > 0 ||\n      !targetValid(target) ||\n      paths.length !== 1 ||\n      [...uri.searchParams.keys()].some((key) => key !== 'path')\n    )\n      return err('Invalid sandbox file URI');\n    const path = paths[0];\n    if (path == null || !pathValid(path)) return err('Invalid sandbox file path');\n    return ok({ target, path });\n  } catch {\n    return err('Invalid sandbox file URI');\n  }\n};\n"],
   "mappings": "AAAA,SAAS,oBAAoB;AAE7B,MAAM,MAAM,CAAC,WAAiD,EAAE,IAAI,OAAO,MAAM;AACjF,MAAM,KAAK,CAAI,UAAoC,EAAE,IAAI,MAAM,KAAK;AAY7D,MAAM,0BAA0B;AAEvC,MAAM,cAAc,CAAC,QAAgB,UAA2B;AAC9D,MAAI,CAAC,MAAM,WAAW,SAAS,GAAG,EAAG,QAAO;AAC5C,QAAM,OAAO,MAAM,MAAM,OAAO,SAAS,CAAC;AAC1C,MAAI,KAAK,WAAW,KAAK,KAAK,SAAS,GAAI,QAAO;AAClD,MAAI;AACF,WAAO,aAAa,IAAI,EAAE,WAAW;AAAA,EACvC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,MAAM,cAAc,CAAC,WACnB,YAAY,QAAQ,OAAO,cAAc,KAAK,YAAY,QAAQ,OAAO,SAAS;AAEpF,MAAM,YAAY,CAAC,SACjB,KAAK,SAAS,KAAK,KAAK,UAAU,QAAQ,CAAC,KAAK,SAAS,IAAI;AAExD,MAAM,uBAAuB,CAAC,aAA0C;AAC7E,MAAI,CAAC,YAAY,SAAS,MAAM,KAAK,CAAC,UAAU,SAAS,IAAI;AAC3D,UAAM,IAAI,MAAM,+BAA+B;AACjD,QAAM,QAAQ,IAAI,gBAAgB,EAAE,MAAM,SAAS,KAAK,CAAC;AACzD,SAAO,mBAAmB,SAAS,OAAO,cAAc,IAAI,SAAS,OAAO,SAAS,IAAI,KAAK;AAChG;AAEO,MAAM,sBAAsB,CAAC,UAAoD;AACtF,MAAI;AACF,UAAM,MAAM,IAAI,IAAI,KAAK;AACzB,UAAM,YAAY,IAAI,SAAS,MAAM,CAAC;AACtC,UAAM,SAAS,EAAE,gBAAgB,IAAI,UAAU,UAAU;AACzD,UAAM,QAAQ,IAAI,aAAa,OAAO,MAAM;AAC5C,QACE,IAAI,aAAa,2BACjB,IAAI,SAAS,SAAS,KACtB,IAAI,SAAS,SAAS,KACtB,IAAI,KAAK,SAAS,KAClB,IAAI,KAAK,SAAS,KAClB,CAAC,YAAY,MAAM,KACnB,MAAM,WAAW,KACjB,CAAC,GAAG,IAAI,aAAa,KAAK,CAAC,EAAE,KAAK,CAAC,QAAQ,QAAQ,MAAM;AAEzD,aAAO,IAAI,0BAA0B;AACvC,UAAM,OAAO,MAAM,CAAC;AACpB,QAAI,QAAQ,QAAQ,CAAC,UAAU,IAAI,EAAG,QAAO,IAAI,2BAA2B;AAC5E,WAAO,GAAG,EAAE,QAAQ,KAAK,CAAC;AAAA,EAC5B,QAAQ;AACN,WAAO,IAAI,0BAA0B;AAAA,EACvC;AACF;",
   "names": []
 }

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

@@ -0,0 +1,65 @@
+import type { SandboxEnvironmentValueIface } from '@finalai/agent-provider/sandbox/types';
+import { type PublishSandboxSetupResponseIface, type RunSandboxCommandRequestIface, type RunSandboxCommandResponseIface, type SandboxDescriptionIface, type SandboxListIface, type SandboxProviderIface, type SandboxResourceIface, type SandboxSetupInputIface, type SandboxSetupRefInputIface, type SandboxSetupResourceIface } from '@finalai/agent-protocol/agent-platform';
+import { type ClientContextIface, type SignalOptionsIface } from "./context.mjs";
+export type { SandboxEnvironmentValueIface };
+/** A published sandbox setup at a version, or `latest` (resolved once, at creation). */
+export type SandboxSetupRefIface = SandboxSetupRefInputIface;
+/** Who a sandbox belongs to; it is deleted with its owner. */
+export type SandboxOwnerIface = {
+    conversation: string;
+} | {
+    session: string;
+};
+export interface CreateSandboxOptionsIface extends SignalOptionsIface {
+    /** What should be on the machine: `defineSandboxSetup(...)`, or a published setup. */
+    setup?: SandboxSetupInputIface | SandboxSetupRefIface;
+    ownedBy?: SandboxOwnerIface;
+    /** A retry with the same key returns the sandbox the first call created. */
+    idempotencyKey?: string;
+}
+export interface SandboxHandleIface {
+    readonly id: string;
+    /** The sandbox as it was when this handle was made. */
+    readonly resource: SandboxResourceIface;
+    get: (options?: SignalOptionsIface) => Promise<SandboxResourceIface>;
+    /** Runs one command to completion, booting the sandbox if needed. */
+    run: (args: RunSandboxCommandRequestIface & SignalOptionsIface) => Promise<RunSandboxCommandResponseIface>;
+    /** What is known about the machine: checkouts, services, commands, notes. */
+    description: (options?: SignalOptionsIface) => Promise<SandboxDescriptionIface>;
+    delete: (options?: SignalOptionsIface) => Promise<void>;
+}
+export interface SandboxesApiIface {
+    create: (environment: SandboxEnvironmentValueIface, options?: CreateSandboxOptionsIface) => Promise<SandboxHandleIface>;
+    get: (sandboxId: string, options?: SignalOptionsIface) => Promise<SandboxHandleIface>;
+    list: (options?: SignalOptionsIface & {
+        conversation?: string;
+        session?: string;
+        cursor?: string;
+        limit?: number;
+    }) => Promise<SandboxListIface>;
+    /** The providers this project can create sandboxes on. */
+    providers: (options?: SignalOptionsIface) => Promise<SandboxProviderIface[]>;
+}
+export interface SandboxSetupsApiIface {
+    /** Publishes the next version of `name`. */
+    publish: (args: {
+        name: string;
+        setup: SandboxSetupInputIface;
+    } & SignalOptionsIface) => Promise<PublishSandboxSetupResponseIface>;
+    get: (args: {
+        id: string;
+        version?: number;
+    } & SignalOptionsIface) => Promise<SandboxSetupResourceIface>;
+    list: (options?: SignalOptionsIface & {
+        cursor?: string;
+        limit?: number;
+    }) => Promise<SandboxSetupResourceIface[]>;
+}
+export declare const createSandboxesApi: (args: {
+    context: ClientContextIface;
+    projectId: string;
+}) => SandboxesApiIface;
+export declare const createSandboxSetupsApi: (args: {
+    context: ClientContextIface;
+    projectId: string;
+}) => SandboxSetupsApiIface;

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

@@ -0,0 +1,130 @@
+import { jsonObjectSchema } from "@finalai/agent-protocol";
+import {
+  createSandboxRequestSchema,
+  okResponseSchema,
+  publishSandboxSetupRequestSchema,
+  publishSandboxSetupResponseSchema,
+  runSandboxCommandRequestSchema,
+  runSandboxCommandResponseSchema,
+  sandboxDescriptionSchema,
+  sandboxListSchema,
+  sandboxProviderListSchema,
+  sandboxResourceSchema,
+  sandboxSetupListSchema,
+  sandboxSetupResourceSchema
+} from "@finalai/agent-protocol/agent-platform";
+import { encodePath } from "./context.mjs";
+import { HttpMethod } from "./http.mjs";
+const projectPath = (projectId, suffix) => `/v1/projects/${encodePath(projectId)}${suffix}`;
+const createSandboxesApi = (args) => {
+  const { http } = args.context;
+  const sandboxPath = (sandboxId, suffix = "") => projectPath(args.projectId, `/sandboxes/${encodePath(sandboxId)}${suffix}`);
+  const handle = (resource) => ({
+    id: resource.id,
+    resource,
+    get: (options) => http.request({
+      method: HttpMethod.Get,
+      path: sandboxPath(resource.id),
+      response: sandboxResourceSchema,
+      signal: options?.signal
+    }),
+    run: ({ signal, ...value }) => http.request({
+      method: HttpMethod.Post,
+      path: sandboxPath(resource.id, "/run"),
+      body: { schema: runSandboxCommandRequestSchema, value },
+      response: runSandboxCommandResponseSchema,
+      signal
+    }),
+    description: (options) => http.request({
+      method: HttpMethod.Get,
+      path: sandboxPath(resource.id, "/description"),
+      response: sandboxDescriptionSchema,
+      signal: options?.signal
+    }),
+    delete: async (options) => {
+      await http.request({
+        method: HttpMethod.Delete,
+        path: sandboxPath(resource.id),
+        response: okResponseSchema,
+        signal: options?.signal
+      });
+    }
+  });
+  return {
+    create: async (environment, options) => handle(
+      await http.request({
+        method: HttpMethod.Post,
+        path: projectPath(args.projectId, "/sandboxes"),
+        body: {
+          schema: createSandboxRequestSchema,
+          value: {
+            provider: environment.provider,
+            environment: jsonObjectSchema.parse(environment.environment ?? {}),
+            setup: options?.setup,
+            ownedBy: options?.ownedBy,
+            idempotencyKey: options?.idempotencyKey
+          }
+        },
+        response: sandboxResourceSchema,
+        signal: options?.signal
+      })
+    ),
+    get: async (sandboxId, options) => handle(
+      await http.request({
+        method: HttpMethod.Get,
+        path: sandboxPath(sandboxId),
+        response: sandboxResourceSchema,
+        signal: options?.signal
+      })
+    ),
+    list: (options) => http.request({
+      method: HttpMethod.Get,
+      path: projectPath(args.projectId, "/sandboxes"),
+      query: {
+        conversation: options?.conversation,
+        session: options?.session,
+        cursor: options?.cursor,
+        limit: options?.limit
+      },
+      response: sandboxListSchema,
+      signal: options?.signal
+    }),
+    providers: async (options) => (await http.request({
+      method: HttpMethod.Get,
+      path: projectPath(args.projectId, "/sandbox-providers"),
+      response: sandboxProviderListSchema,
+      signal: options?.signal
+    })).providers
+  };
+};
+const createSandboxSetupsApi = (args) => {
+  const { http } = args.context;
+  return {
+    publish: ({ signal, ...value }) => http.request({
+      method: HttpMethod.Post,
+      path: projectPath(args.projectId, "/sandbox-setups"),
+      body: { schema: publishSandboxSetupRequestSchema, value },
+      response: publishSandboxSetupResponseSchema,
+      signal
+    }),
+    get: ({ id, version, signal }) => http.request({
+      method: HttpMethod.Get,
+      path: projectPath(args.projectId, `/sandbox-setups/${encodePath(id)}`),
+      query: { version },
+      response: sandboxSetupResourceSchema,
+      signal
+    }),
+    list: async (options) => (await http.request({
+      method: HttpMethod.Get,
+      path: projectPath(args.projectId, "/sandbox-setups"),
+      query: { cursor: options?.cursor, limit: options?.limit },
+      response: sandboxSetupListSchema,
+      signal: options?.signal
+    })).setups
+  };
+};
+export {
+  createSandboxSetupsApi,
+  createSandboxesApi
+};
+//# sourceMappingURL=sandboxes.mjs.map

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

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../../src/agent-client/sandboxes.ts"],
+  "sourcesContent": ["import { jsonObjectSchema } from '@finalai/agent-protocol';\nimport type { SandboxEnvironmentValueIface } from '@finalai/agent-provider/sandbox/types';\nimport {\n  createSandboxRequestSchema,\n  okResponseSchema,\n  publishSandboxSetupRequestSchema,\n  publishSandboxSetupResponseSchema,\n  runSandboxCommandRequestSchema,\n  runSandboxCommandResponseSchema,\n  sandboxDescriptionSchema,\n  sandboxListSchema,\n  sandboxProviderListSchema,\n  sandboxResourceSchema,\n  sandboxSetupListSchema,\n  sandboxSetupResourceSchema,\n  type PublishSandboxSetupResponseIface,\n  type RunSandboxCommandRequestIface,\n  type RunSandboxCommandResponseIface,\n  type SandboxDescriptionIface,\n  type SandboxListIface,\n  type SandboxProviderIface,\n  type SandboxResourceIface,\n  type SandboxSetupInputIface,\n  type SandboxSetupRefInputIface,\n  type SandboxSetupResourceIface,\n} from '@finalai/agent-protocol/agent-platform';\nimport { encodePath, type ClientContextIface, type SignalOptionsIface } from \"./context.mjs\";\nimport { HttpMethod } from \"./http.mjs\";\n\nexport type { SandboxEnvironmentValueIface };\n\n// Sandboxes are project resources: a machine and its disk from a provider,\n// provided to an agent per capability by id. Creating one boots nothing.\n\n/** A published sandbox setup at a version, or `latest` (resolved once, at creation). */\nexport type SandboxSetupRefIface = SandboxSetupRefInputIface;\n\n/** Who a sandbox belongs to; it is deleted with its owner. */\nexport type SandboxOwnerIface = { conversation: string } | { session: string };\n\nexport interface CreateSandboxOptionsIface extends SignalOptionsIface {\n  /** What should be on the machine: `defineSandboxSetup(...)`, or a published setup. */\n  setup?: SandboxSetupInputIface | SandboxSetupRefIface;\n  ownedBy?: SandboxOwnerIface;\n  /** A retry with the same key returns the sandbox the first call created. */\n  idempotencyKey?: string;\n}\n\nexport interface SandboxHandleIface {\n  readonly id: string;\n  /** The sandbox as it was when this handle was made. */\n  readonly resource: SandboxResourceIface;\n  get: (options?: SignalOptionsIface) => Promise<SandboxResourceIface>;\n  /** Runs one command to completion, booting the sandbox if needed. */\n  run: (\n    args: RunSandboxCommandRequestIface & SignalOptionsIface,\n  ) => Promise<RunSandboxCommandResponseIface>;\n  /** What is known about the machine: checkouts, services, commands, notes. */\n  description: (options?: SignalOptionsIface) => Promise<SandboxDescriptionIface>;\n  delete: (options?: SignalOptionsIface) => Promise<void>;\n}\n\nexport interface SandboxesApiIface {\n  create: (\n    environment: SandboxEnvironmentValueIface,\n    options?: CreateSandboxOptionsIface,\n  ) => Promise<SandboxHandleIface>;\n  get: (sandboxId: string, options?: SignalOptionsIface) => Promise<SandboxHandleIface>;\n  list: (\n    options?: SignalOptionsIface & {\n      conversation?: string;\n      session?: string;\n      cursor?: string;\n      limit?: number;\n    },\n  ) => Promise<SandboxListIface>;\n  /** The providers this project can create sandboxes on. */\n  providers: (options?: SignalOptionsIface) => Promise<SandboxProviderIface[]>;\n}\n\nexport interface SandboxSetupsApiIface {\n  /** Publishes the next version of `name`. */\n  publish: (\n    args: { name: string; setup: SandboxSetupInputIface } & SignalOptionsIface,\n  ) => Promise<PublishSandboxSetupResponseIface>;\n  get: (\n    args: { id: string; version?: number } & SignalOptionsIface,\n  ) => Promise<SandboxSetupResourceIface>;\n  list: (\n    options?: SignalOptionsIface & { cursor?: string; limit?: number },\n  ) => Promise<SandboxSetupResourceIface[]>;\n}\n\nconst projectPath = (projectId: string, suffix: string): string =>\n  `/v1/projects/${encodePath(projectId)}${suffix}`;\n\nexport const createSandboxesApi = (args: {\n  context: ClientContextIface;\n  projectId: string;\n}): SandboxesApiIface => {\n  const { http } = args.context;\n  const sandboxPath = (sandboxId: string, suffix = '') =>\n    projectPath(args.projectId, `/sandboxes/${encodePath(sandboxId)}${suffix}`);\n  const handle = (resource: SandboxResourceIface): SandboxHandleIface => ({\n    id: resource.id,\n    resource,\n    get: (options) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: sandboxPath(resource.id),\n        response: sandboxResourceSchema,\n        signal: options?.signal,\n      }),\n    run: ({ signal, ...value }) =>\n      http.request({\n        method: HttpMethod.Post,\n        path: sandboxPath(resource.id, '/run'),\n        body: { schema: runSandboxCommandRequestSchema, value },\n        response: runSandboxCommandResponseSchema,\n        signal,\n      }),\n    description: (options) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: sandboxPath(resource.id, '/description'),\n        response: sandboxDescriptionSchema,\n        signal: options?.signal,\n      }),\n    delete: async (options) => {\n      await http.request({\n        method: HttpMethod.Delete,\n        path: sandboxPath(resource.id),\n        response: okResponseSchema,\n        signal: options?.signal,\n      });\n    },\n  });\n  return {\n    create: async (environment, options) =>\n      handle(\n        await http.request({\n          method: HttpMethod.Post,\n          path: projectPath(args.projectId, '/sandboxes'),\n          body: {\n            schema: createSandboxRequestSchema,\n            value: {\n              provider: environment.provider,\n              environment: jsonObjectSchema.parse(environment.environment ?? {}),\n              setup: options?.setup,\n              ownedBy: options?.ownedBy,\n              idempotencyKey: options?.idempotencyKey,\n            },\n          },\n          response: sandboxResourceSchema,\n          signal: options?.signal,\n        }),\n      ),\n    get: async (sandboxId, options) =>\n      handle(\n        await http.request({\n          method: HttpMethod.Get,\n          path: sandboxPath(sandboxId),\n          response: sandboxResourceSchema,\n          signal: options?.signal,\n        }),\n      ),\n    list: (options) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: projectPath(args.projectId, '/sandboxes'),\n        query: {\n          conversation: options?.conversation,\n          session: options?.session,\n          cursor: options?.cursor,\n          limit: options?.limit,\n        },\n        response: sandboxListSchema,\n        signal: options?.signal,\n      }),\n    providers: async (options) =>\n      (\n        await http.request({\n          method: HttpMethod.Get,\n          path: projectPath(args.projectId, '/sandbox-providers'),\n          response: sandboxProviderListSchema,\n          signal: options?.signal,\n        })\n      ).providers,\n  };\n};\n\nexport const createSandboxSetupsApi = (args: {\n  context: ClientContextIface;\n  projectId: string;\n}): SandboxSetupsApiIface => {\n  const { http } = args.context;\n  return {\n    publish: ({ signal, ...value }) =>\n      http.request({\n        method: HttpMethod.Post,\n        path: projectPath(args.projectId, '/sandbox-setups'),\n        body: { schema: publishSandboxSetupRequestSchema, value },\n        response: publishSandboxSetupResponseSchema,\n        signal,\n      }),\n    get: ({ id, version, signal }) =>\n      http.request({\n        method: HttpMethod.Get,\n        path: projectPath(args.projectId, `/sandbox-setups/${encodePath(id)}`),\n        query: { version },\n        response: sandboxSetupResourceSchema,\n        signal,\n      }),\n    list: async (options) =>\n      (\n        await http.request({\n          method: HttpMethod.Get,\n          path: projectPath(args.projectId, '/sandbox-setups'),\n          query: { cursor: options?.cursor, limit: options?.limit },\n          response: sandboxSetupListSchema,\n          signal: options?.signal,\n        })\n      ).setups,\n  };\n};\n"],
+  "mappings": "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",
+  "names": []
+}

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

@@ -0,0 +1,24 @@
+import { type ScheduleIface, type ScheduleRunResultIface, type UpdateScheduleRequestIface } from '@finalai/agent-protocol/agent-platform';
+import { type ClientContextIface, type SignalOptionsIface } from "./context.mjs";
+import { type ProvideIface } from "./provide.mjs";
+export type ScheduleRef = {
+    scheduleId: string;
+} | {
+    agent: string;
+    key: string;
+};
+export interface ScheduleUpdateIface extends Omit<UpdateScheduleRequestIface, 'provide'> {
+    /** What its runs start with; fails with `requirements_unmet` unless it meets the agent's requirements. */
+    provide?: ProvideIface;
+}
+export interface SchedulesApiIface {
+    /** `agent` narrows to one agent's schedules, by its id. */
+    list: (options?: SignalOptionsIface & {
+        agent?: string;
+    }) => Promise<ScheduleIface[]>;
+    runNow: (args: ScheduleRef & SignalOptionsIface) => Promise<ScheduleRunResultIface>;
+    update: (args: {
+        scheduleId: string;
+    } & ScheduleUpdateIface & SignalOptionsIface) => Promise<ScheduleIface>;
+}
+export declare const createSchedulesApi: ({ http }: ClientContextIface) => SchedulesApiIface;