@finalai/final-agent-provider 0.10.1 → 0.11.0

package/dist/modules/sandboxes/index.mjs

@@ -1,118 +1,58 @@
 import {
-  awaitableOpenRequest,
-  jsonObjectSchema,
-  packageRef
+  jsonObjectSchema
 } from "@finalai/agent-provider";
-import * as z from "zod";
 import {
-  COMPUTER_SANDBOX_SPECIFIER,
+  COMPUTER_PROVIDER,
   computerEnvironmentSchema,
-  computerOpenOptionsSchema,
-  DEVICE_SANDBOX_SPECIFIER,
+  DEVICE_PROVIDER,
   deviceEnvironmentSchema
 } from "./environment.mjs";
+const WORKERS_PROVIDER = "workers";
 import {
-  COMPUTER_SANDBOX_SPECIFIER as COMPUTER_SANDBOX_SPECIFIER2,
+  COMPUTER_PROVIDER as COMPUTER_PROVIDER2,
   computerEnvironmentSchema as computerEnvironmentSchema2,
-  ComputerWorkspacePolicy,
+  DEFAULT_COMPUTER_IMAGE,
   DEVICE_API_ACTING_USER_HEADER,
-  DEVICE_SANDBOX_SPECIFIER as DEVICE_SANDBOX_SPECIFIER2,
-  deviceEnvironmentSchema as deviceEnvironmentSchema2,
-  TemplateWhenMissing
+  DEVICE_PROVIDER as DEVICE_PROVIDER2,
+  deviceEnvironmentSchema as deviceEnvironmentSchema2
 } from "./environment.mjs";
-const recorded = (value) => jsonObjectSchema.parse(JSON.parse(JSON.stringify(value)));
-const validated = (schema, value, label) => {
-  const parsed = schema.safeParse(value);
-  if (!parsed.success) throw new Error(`invalid ${label}: ${parsed.error.message}`);
-  return value;
-};
-const validatedOpen = (openOptions, providerName) => {
-  const parsed = computerOpenOptionsSchema.safeParse(openOptions);
+import {
+  defineSandboxSetup,
+  describeSandbox,
+  LATEST_SANDBOX_SETUP_VERSION
+} from "@finalai/agent-provider/sandbox/setup";
+const environmentValue = (args) => {
+  const parsed = args.schema.safeParse(args.input);
   if (!parsed.success)
-    throw new Error(`invalid ${providerName} open options: ${parsed.error.message}`);
-  return parsed.data;
-};
-const environmentFor = (args) => {
-  const provider = packageRef(args.specifier);
+    throw new Error(`invalid ${args.provider} environment: ${parsed.error.message}`);
   return {
-    provider,
-    providerRef: provider,
-    providerName: args.providerName,
-    options: args.options,
-    authoringWarnings: args.authoringWarnings,
-    open: (openOptions) => awaitableOpenRequest({
-      provider,
-      providerRef: provider,
-      providerName: args.providerName,
-      environmentOptions: args.options,
-      openOptions: recorded(validatedOpen(openOptions ?? {}, args.providerName)),
-      authoringWarnings: args.authoringWarnings
-    })
+    provider: args.provider,
+    environment: jsonObjectSchema.parse(JSON.parse(JSON.stringify(args.input)))
   };
 };
-const computerProviderRef = packageRef(COMPUTER_SANDBOX_SPECIFIER);
-const computerEnvironment = (options) => {
-  const environment = {
-    providerName: "computer",
-    specifier: COMPUTER_SANDBOX_SPECIFIER,
-    options: validated(computerEnvironmentSchema, options, "computer environment")
-  };
-  if (options["inline"] != null)
-    environment.authoringWarnings = [
-      "This inline computer guide builds its base on first use, which may take minutes. Publish a saved setup guide to prepare the base ahead of time."
-    ];
-  return environmentFor(environment);
-};
-const parametersOf = (input) => recorded({
-  repositories: input.repositories,
-  variables: input.variables,
-  workspace: input.workspace,
-  networkPolicy: input.networkPolicy,
-  env: input.env
-});
-const guideReference = (input) => computerEnvironment({
-  guide: { ref: input.ref, version: input.version ?? "latest" },
-  parameters: parametersOf(input)
-});
-const inlineGuide = (input) => computerEnvironment({
-  inline: recorded({
-    image: input.image,
-    template: input.template,
-    repositories: input.repositories ?? [],
-    variables: input.variables ?? []
-  })
+const computer = (options = {}) => environmentValue({
+  provider: COMPUTER_PROVIDER,
+  schema: computerEnvironmentSchema,
+  input: options
 });
-const computerSetupGuide = Object.assign(guideReference, {
-  define: inlineGuide,
-  providerRef: computerProviderRef
+const device = (options) => environmentValue({ provider: DEVICE_PROVIDER, schema: deviceEnvironmentSchema, input: options });
+const workers = () => ({
+  provider: WORKERS_PROVIDER,
+  environment: null
 });
-const computer = Object.assign(
-  (input = {}) => {
-    const parameters = parametersOf({ workspace: "ephemeral", ...input });
-    return computerEnvironment(
-      input.image == null ? { parameters } : { image: input.image, parameters }
-    );
-  },
-  { providerRef: computerProviderRef }
-);
-const device = Object.assign(
-  (input = {}) => environmentFor({
-    providerName: "device",
-    specifier: DEVICE_SANDBOX_SPECIFIER,
-    options: validated(deviceEnvironmentSchema, recorded(input), "device environment")
-  }),
-  { providerRef: packageRef(DEVICE_SANDBOX_SPECIFIER) }
-);
 export {
-  COMPUTER_SANDBOX_SPECIFIER2 as COMPUTER_SANDBOX_SPECIFIER,
-  ComputerWorkspacePolicy,
+  COMPUTER_PROVIDER2 as COMPUTER_PROVIDER,
+  DEFAULT_COMPUTER_IMAGE,
   DEVICE_API_ACTING_USER_HEADER,
-  DEVICE_SANDBOX_SPECIFIER2 as DEVICE_SANDBOX_SPECIFIER,
-  TemplateWhenMissing,
+  DEVICE_PROVIDER2 as DEVICE_PROVIDER,
+  LATEST_SANDBOX_SETUP_VERSION,
+  WORKERS_PROVIDER,
   computer,
   computerEnvironmentSchema2 as computerEnvironmentSchema,
-  computerSetupGuide,
+  defineSandboxSetup,
+  describeSandbox,
   device,
-  deviceEnvironmentSchema2 as deviceEnvironmentSchema
+  deviceEnvironmentSchema2 as deviceEnvironmentSchema,
+  workers
 };
 //# sourceMappingURL=index.mjs.map

package/dist/modules/sandboxes/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/sandboxes/index.ts"],
-  "sourcesContent": ["import {\n  awaitableOpenRequest,\n  jsonObjectSchema,\n  packageRef,\n  type JsonObject,\n  type NetworkPolicy,\n  type NetworkSandboxSessionIface,\n  type PackageProviderRefIface,\n  type SandboxAccess,\n  type SandboxAttach,\n  type SandboxEnvironmentIface,\n  type SandboxOpenRequestIface,\n} from '@finalai/agent-provider';\nimport * as z from 'zod';\nimport {\n  COMPUTER_SANDBOX_SPECIFIER,\n  computerEnvironmentSchema,\n  computerOpenOptionsSchema,\n  DEVICE_SANDBOX_SPECIFIER,\n  deviceEnvironmentSchema,\n  type ComputerOpenOptionsIface,\n  type ComputerTemplateInputIface,\n  type ComputerWorkspacePolicy,\n} from \"./environment.mjs\";\n\n// Authoring helpers for `computer` and `device` in sandbox.ts. Each returns\n// a sandbox environment whose `.open()` yields the\n// binding request the compiler records (`providerRef`, as every provider package's\n// helpers name it). The agent compiler bundles this module itself, so what an\n// authored definition records is exactly what the provider validates. Runtime\n// factories live in `./sandboxes/computer` and `./sandboxes/device`.\n\nexport {\n  COMPUTER_SANDBOX_SPECIFIER,\n  computerEnvironmentSchema,\n  ComputerWorkspacePolicy,\n  DEVICE_API_ACTING_USER_HEADER,\n  DEVICE_SANDBOX_SPECIFIER,\n  deviceEnvironmentSchema,\n  TemplateWhenMissing,\n} from \"./environment.mjs\";\nexport type {\n  ComputerEnvironmentOptions,\n  ComputerRepositoryIface,\n  ComputerTemplateIface,\n  ComputerTemplateInputIface,\n  DeviceEnvironmentOptions,\n} from \"./environment.mjs\";\n\ntype EnumInput<E extends string> = E | `${E}`;\n\nexport interface SandboxOpenInputIface {\n  access?: EnumInput<SandboxAccess>;\n  // `on-prompt` attaches when a prompt arrives instead of on the first tool call.\n  attach?: EnumInput<SandboxAttach>;\n}\n\nexport interface InstalledSandboxOpenRequestIface extends SandboxOpenRequestIface<\n  JsonObject,\n  JsonObject\n> {\n  readonly provider: PackageProviderRefIface;\n  readonly providerRef: PackageProviderRefIface;\n}\n\nexport interface InstalledSandboxEnvironmentIface extends SandboxEnvironmentIface<\n  JsonObject,\n  SandboxOpenInputIface\n> {\n  readonly provider: PackageProviderRefIface;\n  readonly providerRef: PackageProviderRefIface;\n  // Awaitable inside a sandbox.ts selector, where it opens the sandbox.\n  open(\n    options?: SandboxOpenInputIface,\n  ): InstalledSandboxOpenRequestIface & PromiseLike<NetworkSandboxSessionIface>;\n}\n\nexport interface ComputerRepositoryInputIface {\n  alias: string;\n  repository: string;\n  ref?: string | null;\n}\n\nexport interface ComputerParametersInputIface {\n  repositories?: ComputerRepositoryInputIface[];\n  // Names of variables (secrets managed in Build); values are injected at start.\n  variables?: string[];\n  workspace?: EnumInput<ComputerWorkspacePolicy>;\n  networkPolicy?: EnumInput<NetworkPolicy> | { mode: EnumInput<NetworkPolicy>; allow?: string[] };\n  // Plain, non-secret values; secrets can only be named in `variables`.\n  env?: Record<string, string>;\n}\n\nexport interface ComputerSetupGuideInputIface extends ComputerParametersInputIface {\n  // Slug of a guide saved in Build.\n  ref: string;\n  version?: number | 'latest';\n}\n\nexport interface ComputerInlineGuideInputIface {\n  // An OCI image reference, or `lineage:<name>` for a platform image lineage.\n  image: string;\n  template: ComputerTemplateInputIface;\n  repositories?: ComputerRepositoryInputIface[];\n  variables?: string[];\n}\n\nexport interface ComputerInputIface extends ComputerParametersInputIface {\n  image?: string;\n}\n\nexport interface DeviceInputIface {\n  deviceId?: string;\n  pairing?: string;\n}\n\ninterface RecordedInlineGuideIface {\n  image: string;\n  template: ComputerTemplateInputIface;\n  repositories: ComputerRepositoryInputIface[];\n  variables: string[];\n}\n\ntype RecordedInput =\n  | ComputerParametersInputIface\n  | DeviceInputIface\n  | RecordedInlineGuideIface\n  | ComputerOpenOptionsIface;\n\n// The helper's input as JSON; JSON.stringify drops undefined members, so the\n// recorded manifest is stable.\nconst recorded = (value: RecordedInput): JsonObject =>\n  jsonObjectSchema.parse(JSON.parse(JSON.stringify(value)));\n\nconst validated = (schema: z.ZodType, value: JsonObject, label: string): JsonObject => {\n  const parsed = schema.safeParse(value);\n  if (!parsed.success) throw new Error(`invalid ${label}: ${parsed.error.message}`);\n  return value;\n};\n\nconst validatedOpen = (\n  openOptions: SandboxOpenInputIface,\n  providerName: string,\n): ComputerOpenOptionsIface => {\n  const parsed = computerOpenOptionsSchema.safeParse(openOptions);\n  if (!parsed.success)\n    throw new Error(`invalid ${providerName} open options: ${parsed.error.message}`);\n  return parsed.data;\n};\n\nconst environmentFor = (args: {\n  providerName: string;\n  specifier: string;\n  options: JsonObject;\n  authoringWarnings?: readonly string[];\n}): InstalledSandboxEnvironmentIface => {\n  const provider = packageRef(args.specifier);\n  return {\n    provider,\n    providerRef: provider,\n    providerName: args.providerName,\n    options: args.options,\n    authoringWarnings: args.authoringWarnings,\n    open: (openOptions) =>\n      awaitableOpenRequest({\n        provider,\n        providerRef: provider,\n        providerName: args.providerName,\n        environmentOptions: args.options,\n        openOptions: recorded(validatedOpen(openOptions ?? {}, args.providerName)),\n        authoringWarnings: args.authoringWarnings,\n      }),\n  };\n};\n\nconst computerProviderRef = packageRef(COMPUTER_SANDBOX_SPECIFIER);\n\nconst computerEnvironment = (options: JsonObject): InstalledSandboxEnvironmentIface => {\n  const environment: Parameters<typeof environmentFor>[0] = {\n    providerName: 'computer',\n    specifier: COMPUTER_SANDBOX_SPECIFIER,\n    options: validated(computerEnvironmentSchema, options, 'computer environment'),\n  };\n  if (options['inline'] != null)\n    environment.authoringWarnings = [\n      'This inline computer guide builds its base on first use, which may take minutes. Publish a saved setup guide to prepare the base ahead of time.',\n    ];\n  return environmentFor(environment);\n};\n\nconst parametersOf = (input: ComputerParametersInputIface): JsonObject =>\n  recorded({\n    repositories: input.repositories,\n    variables: input.variables,\n    workspace: input.workspace,\n    networkPolicy: input.networkPolicy,\n    env: input.env,\n  });\n\nconst guideReference = (input: ComputerSetupGuideInputIface): InstalledSandboxEnvironmentIface =>\n  computerEnvironment({\n    guide: { ref: input.ref, version: input.version ?? 'latest' },\n    parameters: parametersOf(input),\n  });\n\nconst inlineGuide = (input: ComputerInlineGuideInputIface): InstalledSandboxEnvironmentIface =>\n  computerEnvironment({\n    inline: recorded({\n      image: input.image,\n      template: input.template,\n      repositories: input.repositories ?? [],\n      variables: input.variables ?? [],\n    }),\n  });\n\n// A saved computer setup guide by reference; every argument after `ref`/`version`\n// overrides that version's saved defaults. `.define(...)` binds an inline guide,\n// whose base is built on first use.\n// `providerRef` names the provider for `defineDynamic({ provider: computer, ... })`.\nexport const computerSetupGuide = Object.assign(guideReference, {\n  define: inlineGuide,\n  providerRef: computerProviderRef,\n});\n\n// The organization's default guide with an ephemeral workspace, or just an image.\nexport const computer = Object.assign(\n  (input: ComputerInputIface = {}): InstalledSandboxEnvironmentIface => {\n    const parameters = parametersOf({ workspace: 'ephemeral', ...input });\n    return computerEnvironment(\n      input.image == null ? { parameters } : { image: input.image, parameters },\n    );\n  },\n  { providerRef: computerProviderRef },\n);\n\n// A Final Device: by id, by an approved pairing code, or the organization's default.\nexport const device = Object.assign(\n  (input: DeviceInputIface = {}): InstalledSandboxEnvironmentIface =>\n    environmentFor({\n      providerName: 'device',\n      specifier: DEVICE_SANDBOX_SPECIFIER,\n      options: validated(deviceEnvironmentSchema, recorded(input), 'device environment'),\n    }),\n  { providerRef: packageRef(DEVICE_SANDBOX_SPECIFIER) },\n);\n"],
-  "mappings": "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",
-  "names": ["COMPUTER_SANDBOX_SPECIFIER", "computerEnvironmentSchema", "DEVICE_SANDBOX_SPECIFIER", "deviceEnvironmentSchema"]
+  "sourcesContent": ["import {\n  jsonObjectSchema,\n  type JsonObject,\n  type SandboxEnvironmentValueIface,\n} from '@finalai/agent-provider';\nimport type * as z from 'zod';\nimport {\n  COMPUTER_PROVIDER,\n  computerEnvironmentSchema,\n  DEVICE_PROVIDER,\n  deviceEnvironmentSchema,\n  type ComputerEnvironmentInputIface,\n  type DeviceEnvironmentInputIface,\n} from \"./environment.mjs\";\n\n// Environments of Final's sandbox providers, as plain data a caller creates\n// sandboxes from: `project.sandboxes.create(computer({ image }), { setup })`.\n// What goes on the machine is the sandbox setup (`defineSandboxSetup`), which\n// works on any provider. The providers themselves live in\n// `./sandboxes/computer` and `./sandboxes/device`.\n\nexport const WORKERS_PROVIDER = 'workers';\n\nexport {\n  COMPUTER_PROVIDER,\n  computerEnvironmentSchema,\n  DEFAULT_COMPUTER_IMAGE,\n  DEVICE_API_ACTING_USER_HEADER,\n  DEVICE_PROVIDER,\n  deviceEnvironmentSchema,\n  type ComputerBuildIface,\n  type ComputerEnvironmentIface,\n  type ComputerEnvironmentInputIface,\n  type DeviceEnvironmentIface,\n  type DeviceEnvironmentInputIface,\n} from \"./environment.mjs\";\nexport {\n  defineSandboxSetup,\n  describeSandbox,\n  LATEST_SANDBOX_SETUP_VERSION,\n  type SandboxDescriptionIface,\n  type SandboxSetupIface,\n  type SandboxSetupInputIface,\n} from '@finalai/agent-provider/sandbox/setup';\nexport type { SandboxEnvironmentValueIface } from '@finalai/agent-provider';\n\nconst environmentValue = (args: {\n  provider: string;\n  schema: z.ZodType;\n  input: unknown;\n}): SandboxEnvironmentValueIface<JsonObject> => {\n  const parsed = args.schema.safeParse(args.input);\n  if (!parsed.success)\n    throw new Error(`invalid ${args.provider} environment: ${parsed.error.message}`);\n  // The input as written (defaults are the provider's), with undefined members dropped.\n  return {\n    provider: args.provider,\n    environment: jsonObjectSchema.parse(JSON.parse(JSON.stringify(args.input))),\n  };\n};\n\n// A Final computer: a VM from the Computers API, created from `image` (the\n// platform's sandbox lineage by default), with `build` baked into its base.\nexport const computer = (\n  options: ComputerEnvironmentInputIface = {},\n): SandboxEnvironmentValueIface<JsonObject> =>\n  environmentValue({\n    provider: COMPUTER_PROVIDER,\n    schema: computerEnvironmentSchema,\n    input: options,\n  });\n\n// A person's own computer running Final Device, by id or by an approved pairing code.\nexport const device = (\n  options: DeviceEnvironmentInputIface,\n): SandboxEnvironmentValueIface<JsonObject> =>\n  environmentValue({ provider: DEVICE_PROVIDER, schema: deviceEnvironmentSchema, input: options });\n\n// Final's Workers runtime: runs the worker programs of Final's harnesses\n// (`final`, `pi`, `nanocode-claude`, `nanocode-codex`) and offers the model no\n// files or shell. Clients create one, owned by the session or conversation,\n// for those harnesses' settings that name no `environment`.\nexport const workers = (): SandboxEnvironmentValueIface<null> => ({\n  provider: WORKERS_PROVIDER,\n  environment: null,\n});\n"],
+  "mappings": "AAAA;AAAA,EACE;AAAA,OAGK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAQA,MAAM,mBAAmB;AAEhC;AAAA,EACE,qBAAAA;AAAA,EACA,6BAAAC;AAAA,EACA;AAAA,EACA;AAAA,EACA,mBAAAC;AAAA,EACA,2BAAAC;AAAA,OAMK;AACP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AAGP,MAAM,mBAAmB,CAAC,SAIsB;AAC9C,QAAM,SAAS,KAAK,OAAO,UAAU,KAAK,KAAK;AAC/C,MAAI,CAAC,OAAO;AACV,UAAM,IAAI,MAAM,WAAW,KAAK,QAAQ,iBAAiB,OAAO,MAAM,OAAO,EAAE;AAEjF,SAAO;AAAA,IACL,UAAU,KAAK;AAAA,IACf,aAAa,iBAAiB,MAAM,KAAK,MAAM,KAAK,UAAU,KAAK,KAAK,CAAC,CAAC;AAAA,EAC5E;AACF;AAIO,MAAM,WAAW,CACtB,UAAyC,CAAC,MAE1C,iBAAiB;AAAA,EACf,UAAU;AAAA,EACV,QAAQ;AAAA,EACR,OAAO;AACT,CAAC;AAGI,MAAM,SAAS,CACpB,YAEA,iBAAiB,EAAE,UAAU,iBAAiB,QAAQ,yBAAyB,OAAO,QAAQ,CAAC;AAM1F,MAAM,UAAU,OAA2C;AAAA,EAChE,UAAU;AAAA,EACV,aAAa;AACf;",
+  "names": ["COMPUTER_PROVIDER", "computerEnvironmentSchema", "DEVICE_PROVIDER", "deviceEnvironmentSchema"]
 }

package/dist/modules/sandboxes/local.d.mts

@@ -0,0 +1,28 @@
+import type { JsonValue } from '@finalai/agent-provider';
+import { type NetworkSandboxSessionIface, type SandboxProviderIface } from '@finalai/agent-provider/sandbox';
+import * as z from 'zod';
+export declare const LOCAL_PROVIDER = "local";
+export declare const LOCAL_INHERITED_ENV: string[];
+export interface LocalSandboxOptionsIface {
+    root: string;
+    env?: Record<string, string>;
+    inheritEnv?: string[];
+    id?: string;
+    baseEnv?: () => Promise<Record<string, string>>;
+}
+export interface LocalSandboxIface extends NetworkSandboxSessionIface {
+    readonly root: string;
+}
+export declare const LOCAL_STOP_GRACE_MS = 2000;
+export declare const createLocalSandbox: (options: LocalSandboxOptionsIface) => Promise<LocalSandboxIface>;
+declare const localStateSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    root: z.ZodString;
+}, z.core.$strip>;
+type LocalArtifact = {
+    version: 1;
+    root: string;
+};
+type LocalState = z.infer<typeof localStateSchema>;
+export declare const createLocalSandboxProvider: () => SandboxProviderIface<JsonValue, LocalArtifact, LocalState, LocalSandboxIface>;
+export {};