@finalai/final-agent-provider 0.10.1 → 0.11.0

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

@@ -1,284 +1,50 @@
-import { NetworkPolicy, SandboxAccess, SandboxAttach } from '@finalai/agent-provider';
 import * as z from 'zod';
-export declare const COMPUTER_SANDBOX_SPECIFIER = "@finalai/final-agent-provider/sandboxes/computer";
-export declare const DEVICE_SANDBOX_SPECIFIER = "@finalai/final-agent-provider/sandboxes/device";
+export declare const COMPUTER_PROVIDER = "computer";
+export declare const DEVICE_PROVIDER = "device";
 export declare const DEVICE_API_ACTING_USER_HEADER = "Final-Acting-User-Id";
-export declare enum ComputerWorkspacePolicy {
-    Session = "session",
-    Conversation = "conversation",
-    Ephemeral = "ephemeral"
-}
-export declare enum TemplateWhenMissing {
-    Skip = "skip",
-    Fail = "fail"
-}
-export declare const repositoryAliasSchema: z.ZodString;
-export declare const computerRepositorySchema: z.ZodObject<{
-    alias: z.ZodString;
-    repository: z.ZodString;
-    ref: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-}, z.core.$strip>;
-export declare const computerNetworkPolicySchema: z.ZodUnion<readonly [z.ZodEnum<typeof NetworkPolicy>, z.ZodObject<{
-    mode: z.ZodEnum<typeof NetworkPolicy>;
-    allow: z.ZodDefault<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>]>;
-export declare const computerParametersSchema: z.ZodObject<{
-    repositories: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        alias: z.ZodString;
-        repository: z.ZodString;
-        ref: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-    }, z.core.$strip>>>;
-    variables: z.ZodOptional<z.ZodArray<z.ZodString>>;
-    workspace: z.ZodOptional<z.ZodEnum<typeof ComputerWorkspacePolicy>>;
-    networkPolicy: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof NetworkPolicy>, z.ZodObject<{
-        mode: z.ZodEnum<typeof NetworkPolicy>;
-        allow: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>]>>;
-    env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-}, z.core.$strip>;
-export declare const computerTemplateSchema: z.ZodObject<{
-    version: z.ZodDefault<z.ZodLiteral<2>>;
-    build: z.ZodPrefault<z.ZodObject<{
-        timeoutMinutes: z.ZodDefault<z.ZodNumber>;
-        steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            run: z.ZodString;
-            cwd: z.ZodDefault<z.ZodString>;
-            whenMissing: z.ZodDefault<z.ZodNullable<z.ZodEnum<typeof TemplateWhenMissing>>>;
-            timeoutMinutes: z.ZodDefault<z.ZodNumber>;
-            required: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strip>>>;
-        verify: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            run: z.ZodString;
-            cwd: z.ZodDefault<z.ZodString>;
-            whenMissing: z.ZodDefault<z.ZodNullable<z.ZodEnum<typeof TemplateWhenMissing>>>;
-            timeoutMinutes: z.ZodDefault<z.ZodNumber>;
-            required: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>>;
-    workspace: z.ZodPrefault<z.ZodObject<{
-        setup: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            run: z.ZodString;
-            cwd: z.ZodDefault<z.ZodString>;
-            whenMissing: z.ZodDefault<z.ZodNullable<z.ZodEnum<typeof TemplateWhenMissing>>>;
-            timeoutMinutes: z.ZodDefault<z.ZodNumber>;
-            required: z.ZodDefault<z.ZodBoolean>;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>>;
-    services: z.ZodDefault<z.ZodArray<z.ZodObject<{
+export declare const DEFAULT_COMPUTER_IMAGE = "lineage:sandbox";
+export declare const computerBuildSchema: z.ZodObject<{
+    steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
         run: z.ZodString;
-        cwd: z.ZodDefault<z.ZodString>;
-        whenMissing: z.ZodDefault<z.ZodNullable<z.ZodEnum<typeof TemplateWhenMissing>>>;
         timeoutMinutes: z.ZodDefault<z.ZodNumber>;
-        required: z.ZodDefault<z.ZodBoolean>;
-        name: z.ZodString;
-        ready: z.ZodDefault<z.ZodNullable<z.ZodObject<{
-            url: z.ZodString;
-            timeoutSeconds: z.ZodDefault<z.ZodNumber>;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>>>;
-    commands: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+    }, z.core.$strict>>>;
+    verify: z.ZodDefault<z.ZodArray<z.ZodObject<{
         run: z.ZodString;
-        description: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-        cwd: z.ZodDefault<z.ZodString>;
-        whenMissing: z.ZodDefault<z.ZodNullable<z.ZodEnum<typeof TemplateWhenMissing>>>;
         timeoutMinutes: z.ZodDefault<z.ZodNumber>;
-    }, z.core.$strip>>>;
-}, z.core.$strip>;
-export declare const computerInlineGuideSchema: z.ZodObject<{
-    image: z.ZodString;
-    template: z.ZodPrefault<z.ZodObject<{
-        version: z.ZodDefault<z.ZodLiteral<2>>;
-        build: z.ZodPrefault<z.ZodObject<{
-            timeoutMinutes: z.ZodDefault<z.ZodNumber>;
-            steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                run: z.ZodString;
-                cwd: z.ZodDefault<z.ZodString>;
-                whenMissing: z.ZodDefault<z.ZodNullable<z.ZodEnum<typeof TemplateWhenMissing>>>;
-                timeoutMinutes: z.ZodDefault<z.ZodNumber>;
-                required: z.ZodDefault<z.ZodBoolean>;
-            }, z.core.$strip>>>;
-            verify: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                run: z.ZodString;
-                cwd: z.ZodDefault<z.ZodString>;
-                whenMissing: z.ZodDefault<z.ZodNullable<z.ZodEnum<typeof TemplateWhenMissing>>>;
-                timeoutMinutes: z.ZodDefault<z.ZodNumber>;
-                required: z.ZodDefault<z.ZodBoolean>;
-            }, z.core.$strip>>>;
-        }, z.core.$strip>>;
-        workspace: z.ZodPrefault<z.ZodObject<{
-            setup: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                run: z.ZodString;
-                cwd: z.ZodDefault<z.ZodString>;
-                whenMissing: z.ZodDefault<z.ZodNullable<z.ZodEnum<typeof TemplateWhenMissing>>>;
-                timeoutMinutes: z.ZodDefault<z.ZodNumber>;
-                required: z.ZodDefault<z.ZodBoolean>;
-            }, z.core.$strip>>>;
-        }, z.core.$strip>>;
-        services: z.ZodDefault<z.ZodArray<z.ZodObject<{
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export declare const computerMachineSchema: z.ZodObject<{
+    vcpu: z.ZodOptional<z.ZodNumber>;
+    memoryMb: z.ZodOptional<z.ZodNumber>;
+    diskGb: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strict>;
+export declare const computerEnvironmentSchema: z.ZodObject<{
+    image: z.ZodOptional<z.ZodString>;
+    build: z.ZodOptional<z.ZodObject<{
+        steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
             run: z.ZodString;
-            cwd: z.ZodDefault<z.ZodString>;
-            whenMissing: z.ZodDefault<z.ZodNullable<z.ZodEnum<typeof TemplateWhenMissing>>>;
             timeoutMinutes: z.ZodDefault<z.ZodNumber>;
-            required: z.ZodDefault<z.ZodBoolean>;
-            name: z.ZodString;
-            ready: z.ZodDefault<z.ZodNullable<z.ZodObject<{
-                url: z.ZodString;
-                timeoutSeconds: z.ZodDefault<z.ZodNumber>;
-            }, z.core.$strip>>>;
-        }, z.core.$strip>>>;
-        commands: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
+        }, z.core.$strict>>>;
+        verify: z.ZodDefault<z.ZodArray<z.ZodObject<{
             run: z.ZodString;
-            description: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-            cwd: z.ZodDefault<z.ZodString>;
-            whenMissing: z.ZodDefault<z.ZodNullable<z.ZodEnum<typeof TemplateWhenMissing>>>;
             timeoutMinutes: z.ZodDefault<z.ZodNumber>;
-        }, z.core.$strip>>>;
-    }, z.core.$strip>>;
-    repositories: z.ZodDefault<z.ZodArray<z.ZodObject<{
-        alias: z.ZodString;
-        repository: z.ZodString;
-        ref: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-    }, z.core.$strip>>>;
-    variables: z.ZodDefault<z.ZodArray<z.ZodString>>;
-}, z.core.$strip>;
-export declare const computerEnvironmentSchema: z.ZodUnion<readonly [z.ZodObject<{
-    guide: z.ZodObject<{
-        ref: z.ZodString;
-        version: z.ZodDefault<z.ZodUnion<readonly [z.ZodLiteral<"latest">, z.ZodNumber]>>;
-    }, z.core.$strict>;
-    parameters: z.ZodPrefault<z.ZodObject<{
-        repositories: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            alias: z.ZodString;
-            repository: z.ZodString;
-            ref: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-        }, z.core.$strip>>>;
-        variables: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        workspace: z.ZodOptional<z.ZodEnum<typeof ComputerWorkspacePolicy>>;
-        networkPolicy: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof NetworkPolicy>, z.ZodObject<{
-            mode: z.ZodEnum<typeof NetworkPolicy>;
-            allow: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>]>>;
-        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, z.core.$strip>>;
-}, z.core.$strict>, z.ZodObject<{
-    inline: z.ZodObject<{
-        image: z.ZodString;
-        template: z.ZodPrefault<z.ZodObject<{
-            version: z.ZodDefault<z.ZodLiteral<2>>;
-            build: z.ZodPrefault<z.ZodObject<{
-                timeoutMinutes: z.ZodDefault<z.ZodNumber>;
-                steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                    run: z.ZodString;
-                    cwd: z.ZodDefault<z.ZodString>;
-                    whenMissing: z.ZodDefault<z.ZodNullable<z.ZodEnum<typeof TemplateWhenMissing>>>;
-                    timeoutMinutes: z.ZodDefault<z.ZodNumber>;
-                    required: z.ZodDefault<z.ZodBoolean>;
-                }, z.core.$strip>>>;
-                verify: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                    run: z.ZodString;
-                    cwd: z.ZodDefault<z.ZodString>;
-                    whenMissing: z.ZodDefault<z.ZodNullable<z.ZodEnum<typeof TemplateWhenMissing>>>;
-                    timeoutMinutes: z.ZodDefault<z.ZodNumber>;
-                    required: z.ZodDefault<z.ZodBoolean>;
-                }, z.core.$strip>>>;
-            }, z.core.$strip>>;
-            workspace: z.ZodPrefault<z.ZodObject<{
-                setup: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                    run: z.ZodString;
-                    cwd: z.ZodDefault<z.ZodString>;
-                    whenMissing: z.ZodDefault<z.ZodNullable<z.ZodEnum<typeof TemplateWhenMissing>>>;
-                    timeoutMinutes: z.ZodDefault<z.ZodNumber>;
-                    required: z.ZodDefault<z.ZodBoolean>;
-                }, z.core.$strip>>>;
-            }, z.core.$strip>>;
-            services: z.ZodDefault<z.ZodArray<z.ZodObject<{
-                run: z.ZodString;
-                cwd: z.ZodDefault<z.ZodString>;
-                whenMissing: z.ZodDefault<z.ZodNullable<z.ZodEnum<typeof TemplateWhenMissing>>>;
-                timeoutMinutes: z.ZodDefault<z.ZodNumber>;
-                required: z.ZodDefault<z.ZodBoolean>;
-                name: z.ZodString;
-                ready: z.ZodDefault<z.ZodNullable<z.ZodObject<{
-                    url: z.ZodString;
-                    timeoutSeconds: z.ZodDefault<z.ZodNumber>;
-                }, z.core.$strip>>>;
-            }, z.core.$strip>>>;
-            commands: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodObject<{
-                run: z.ZodString;
-                description: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-                cwd: z.ZodDefault<z.ZodString>;
-                whenMissing: z.ZodDefault<z.ZodNullable<z.ZodEnum<typeof TemplateWhenMissing>>>;
-                timeoutMinutes: z.ZodDefault<z.ZodNumber>;
-            }, z.core.$strip>>>;
-        }, z.core.$strip>>;
-        repositories: z.ZodDefault<z.ZodArray<z.ZodObject<{
-            alias: z.ZodString;
-            repository: z.ZodString;
-            ref: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-        }, z.core.$strip>>>;
-        variables: z.ZodDefault<z.ZodArray<z.ZodString>>;
-    }, z.core.$strip>;
-    parameters: z.ZodPrefault<z.ZodObject<{
-        repositories: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            alias: z.ZodString;
-            repository: z.ZodString;
-            ref: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-        }, z.core.$strip>>>;
-        variables: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        workspace: z.ZodOptional<z.ZodEnum<typeof ComputerWorkspacePolicy>>;
-        networkPolicy: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof NetworkPolicy>, z.ZodObject<{
-            mode: z.ZodEnum<typeof NetworkPolicy>;
-            allow: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>]>>;
-        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, z.core.$strip>>;
-}, z.core.$strict>, z.ZodObject<{
-    image: z.ZodString;
-    parameters: z.ZodPrefault<z.ZodObject<{
-        repositories: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            alias: z.ZodString;
-            repository: z.ZodString;
-            ref: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-        }, z.core.$strip>>>;
-        variables: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        workspace: z.ZodOptional<z.ZodEnum<typeof ComputerWorkspacePolicy>>;
-        networkPolicy: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof NetworkPolicy>, z.ZodObject<{
-            mode: z.ZodEnum<typeof NetworkPolicy>;
-            allow: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>]>>;
-        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, z.core.$strip>>;
-}, z.core.$strict>, z.ZodObject<{
-    parameters: z.ZodPrefault<z.ZodObject<{
-        repositories: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            alias: z.ZodString;
-            repository: z.ZodString;
-            ref: z.ZodDefault<z.ZodNullable<z.ZodString>>;
-        }, z.core.$strip>>>;
-        variables: z.ZodOptional<z.ZodArray<z.ZodString>>;
-        workspace: z.ZodOptional<z.ZodEnum<typeof ComputerWorkspacePolicy>>;
-        networkPolicy: z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof NetworkPolicy>, z.ZodObject<{
-            mode: z.ZodEnum<typeof NetworkPolicy>;
-            allow: z.ZodDefault<z.ZodArray<z.ZodString>>;
-        }, z.core.$strip>]>>;
-        env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-    }, z.core.$strip>>;
-}, z.core.$strict>]>;
-export declare const computerOpenOptionsSchema: z.ZodObject<{
-    access: z.ZodDefault<z.ZodEnum<typeof SandboxAccess>>;
-    attach: z.ZodOptional<z.ZodEnum<typeof SandboxAttach>>;
+        }, z.core.$strict>>>;
+    }, z.core.$strict>>;
+    machine: z.ZodOptional<z.ZodObject<{
+        vcpu: z.ZodOptional<z.ZodNumber>;
+        memoryMb: z.ZodOptional<z.ZodNumber>;
+        diskGb: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strict>>;
+    region: z.ZodOptional<z.ZodString>;
+    idleTimeoutSeconds: z.ZodOptional<z.ZodNumber>;
 }, z.core.$strict>;
 export declare const deviceEnvironmentSchema: z.ZodUnion<readonly [z.ZodObject<{
     deviceId: z.ZodString;
 }, z.core.$strict>, z.ZodObject<{
     pairing: z.ZodString;
-}, z.core.$strict>, z.ZodObject<{}, z.core.$strict>]>;
-export type ComputerRepositoryIface = z.infer<typeof computerRepositorySchema>;
-export type ComputerParametersIface = z.infer<typeof computerParametersSchema>;
-export type ComputerTemplateIface = z.infer<typeof computerTemplateSchema>;
-export type ComputerTemplateInputIface = z.input<typeof computerTemplateSchema>;
-export type ComputerInlineGuideIface = z.infer<typeof computerInlineGuideSchema>;
-export type ComputerEnvironmentOptions = z.infer<typeof computerEnvironmentSchema>;
-export type ComputerOpenOptionsIface = z.infer<typeof computerOpenOptionsSchema>;
-export type ComputerNetworkPolicyOption = z.infer<typeof computerNetworkPolicySchema>;
-export type DeviceEnvironmentOptions = z.infer<typeof deviceEnvironmentSchema>;
+}, z.core.$strict>]>;
+export type ComputerBuildIface = z.output<typeof computerBuildSchema>;
+export type ComputerEnvironmentIface = z.output<typeof computerEnvironmentSchema>;
+export type ComputerEnvironmentInputIface = z.input<typeof computerEnvironmentSchema>;
+export type DeviceEnvironmentIface = z.output<typeof deviceEnvironmentSchema>;
+export type DeviceEnvironmentInputIface = z.input<typeof deviceEnvironmentSchema>;

package/dist/modules/sandboxes/environment.mjs

@@ -1,121 +1,44 @@
-import { NetworkPolicy, SandboxAccess, SandboxAttach } from "@finalai/agent-provider";
 import * as z from "zod";
-const COMPUTER_SANDBOX_SPECIFIER = "@finalai/final-agent-provider/sandboxes/computer";
-const DEVICE_SANDBOX_SPECIFIER = "@finalai/final-agent-provider/sandboxes/device";
+const COMPUTER_PROVIDER = "computer";
+const DEVICE_PROVIDER = "device";
 const DEVICE_API_ACTING_USER_HEADER = "Final-Acting-User-Id";
-var ComputerWorkspacePolicy = /* @__PURE__ */ ((ComputerWorkspacePolicy2) => {
-  ComputerWorkspacePolicy2["Session"] = "session";
-  ComputerWorkspacePolicy2["Conversation"] = "conversation";
-  ComputerWorkspacePolicy2["Ephemeral"] = "ephemeral";
-  return ComputerWorkspacePolicy2;
-})(ComputerWorkspacePolicy || {});
-var TemplateWhenMissing = /* @__PURE__ */ ((TemplateWhenMissing2) => {
-  TemplateWhenMissing2["Skip"] = "skip";
-  TemplateWhenMissing2["Fail"] = "fail";
-  return TemplateWhenMissing2;
-})(TemplateWhenMissing || {});
-const repositoryAliasSchema = z.string().regex(/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/).max(120);
-const variableNameSchema = z.string().regex(/^[A-Za-z_][A-Za-z0-9_]*$/).max(256);
-const computerRepositorySchema = z.object({
-  alias: repositoryAliasSchema,
-  // A repository the organization can reach, named as the host's repository
-  // resolver accepts it (a GitHub 'final/app', a Final repository id), or a git URL.
-  repository: z.string().min(1),
-  ref: z.string().min(1).nullable().default(null)
-});
-const computerNetworkPolicySchema = z.union([
-  z.nativeEnum(NetworkPolicy),
-  z.object({ mode: z.nativeEnum(NetworkPolicy), allow: z.array(z.string()).default([]) })
-]);
-const computerParametersSchema = z.object({
-  repositories: z.array(computerRepositorySchema).optional(),
-  // Names of variables (secrets); values are injected at start, never stored here.
-  variables: z.array(variableNameSchema).optional(),
-  workspace: z.nativeEnum(ComputerWorkspacePolicy).optional(),
-  networkPolicy: computerNetworkPolicySchema.optional(),
-  // Plain, non-secret environment values.
-  env: z.record(variableNameSchema, z.string().max(16 * 1024)).optional()
-});
-const templateStepSchema = z.object({
+const DEFAULT_COMPUTER_IMAGE = "lineage:sandbox";
+const buildStepSchema = z.strictObject({
   run: z.string().min(1).max(10 * 1024),
-  cwd: z.string().min(1).default("."),
-  whenMissing: z.nativeEnum(TemplateWhenMissing).nullable().default(null),
-  timeoutMinutes: z.number().int().min(1).max(120).default(20),
-  required: z.boolean().default(true)
-});
-const templateServiceSchema = templateStepSchema.extend({
-  name: z.string().regex(/^[a-z0-9][a-z0-9-]*$/).max(64),
-  ready: z.object({ url: z.string().url(), timeoutSeconds: z.number().int().min(1).max(600).default(90) }).nullable().default(null)
-});
-const templateCommandSchema = z.object({
-  run: z.string().min(1).max(10 * 1024),
-  description: z.string().min(1).max(500).nullable().default(null),
-  cwd: z.string().min(1).default("."),
-  whenMissing: z.nativeEnum(TemplateWhenMissing).nullable().default(null),
   timeoutMinutes: z.number().int().min(1).max(120).default(20)
 });
-const computerTemplateSchema = z.object({
-  version: z.literal(2).default(2),
-  build: z.object({
-    timeoutMinutes: z.number().int().min(1).max(120).default(30),
-    steps: z.array(templateStepSchema).max(30).default([]),
-    verify: z.array(templateStepSchema).max(30).default([])
-  }).prefault({}),
-  workspace: z.object({ setup: z.array(templateStepSchema).max(30).default([]) }).prefault({}),
-  services: z.array(templateServiceSchema).max(20).default([]),
-  commands: z.record(
-    z.string().regex(/^[a-z0-9][a-z0-9-]*$/).max(64),
-    templateCommandSchema
-  ).default({})
+const computerBuildSchema = z.strictObject({
+  steps: z.array(buildStepSchema).max(30).default([]),
+  // Checks that the built base works; a failing one fails the build.
+  verify: z.array(buildStepSchema).max(30).default([])
 });
-const computerInlineGuideSchema = z.object({
-  // An OCI image reference, or `lineage:<name>` for a platform image lineage.
-  image: z.string().min(1),
-  template: computerTemplateSchema.prefault({}),
-  repositories: z.array(computerRepositorySchema).default([]),
-  variables: z.array(variableNameSchema).default([])
+const computerMachineSchema = z.strictObject({
+  vcpu: z.number().int().min(1).max(64).optional(),
+  memoryMb: z.number().int().min(512).max(262144).optional(),
+  diskGb: z.number().int().min(1).max(2048).optional()
 });
-const computerEnvironmentSchema = z.union([
-  z.strictObject({
-    guide: z.strictObject({
-      ref: z.string().min(1),
-      version: z.union([z.literal("latest"), z.number().int().min(1)]).default("latest")
-    }),
-    parameters: computerParametersSchema.prefault({})
-  }),
-  z.strictObject({
-    inline: computerInlineGuideSchema,
-    parameters: computerParametersSchema.prefault({})
-  }),
-  z.strictObject({ image: z.string().min(1), parameters: computerParametersSchema.prefault({}) }),
-  // The organization's default guide.
-  z.strictObject({ parameters: computerParametersSchema.prefault({}) })
-]);
-const computerOpenOptionsSchema = z.strictObject({
-  access: z.nativeEnum(SandboxAccess).default(SandboxAccess.Write),
-  attach: z.nativeEnum(SandboxAttach).optional()
+const computerEnvironmentSchema = z.strictObject({
+  // An OCI image reference, or `lineage:<name>` for a platform image lineage.
+  image: z.string().min(1).max(512).optional(),
+  build: computerBuildSchema.optional(),
+  machine: computerMachineSchema.optional(),
+  region: z.string().min(1).max(64).optional(),
+  // Idle time before the computer pauses (its disk and processes kept).
+  idleTimeoutSeconds: z.number().int().min(60).max(7 * 24 * 60 * 60).optional()
 });
 const deviceEnvironmentSchema = z.union([
   z.strictObject({ deviceId: z.string().uuid() }),
   // A pairing code the owner approved; resolved to a device at prepare.
-  z.strictObject({ pairing: z.string().min(1) }),
-  // The only Device of the user the session acts for.
-  z.strictObject({})
+  z.strictObject({ pairing: z.string().min(1) })
 ]);
 export {
-  COMPUTER_SANDBOX_SPECIFIER,
-  ComputerWorkspacePolicy,
+  COMPUTER_PROVIDER,
+  DEFAULT_COMPUTER_IMAGE,
   DEVICE_API_ACTING_USER_HEADER,
-  DEVICE_SANDBOX_SPECIFIER,
-  TemplateWhenMissing,
+  DEVICE_PROVIDER,
+  computerBuildSchema,
   computerEnvironmentSchema,
-  computerInlineGuideSchema,
-  computerNetworkPolicySchema,
-  computerOpenOptionsSchema,
-  computerParametersSchema,
-  computerRepositorySchema,
-  computerTemplateSchema,
-  deviceEnvironmentSchema,
-  repositoryAliasSchema
+  computerMachineSchema,
+  deviceEnvironmentSchema
 };
 //# sourceMappingURL=environment.mjs.map

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

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../../src/sandboxes/environment.ts"],
-  "sourcesContent": ["import { NetworkPolicy, SandboxAccess, SandboxAttach } from '@finalai/agent-provider';\nimport * as z from 'zod';\n\n// Environment options of the `computer` and `device` sandboxes: the JSON a manifest's\n// sandbox binding carries as `environment`, validated by the provider. Pure (no\n// I/O) so authored definitions can import it.\n\nexport const COMPUTER_SANDBOX_SPECIFIER = '@finalai/final-agent-provider/sandboxes/computer';\nexport const DEVICE_SANDBOX_SPECIFIER = '@finalai/final-agent-provider/sandboxes/device';\n\n// The `computer` and `device` sandboxes read no secrets: they authenticate with\n// the context's `credentials.computersAccess` and `credentials.deviceAccess`.\nexport const DEVICE_API_ACTING_USER_HEADER = 'Final-Acting-User-Id';\n\nexport enum ComputerWorkspacePolicy {\n  // The disk lives as long as the agent's session.\n  Session = 'session',\n  // The disk belongs to the conversation: every agent in it shares it and a session reset keeps it.\n  Conversation = 'conversation',\n  // The disk is discarded when the sandbox is released.\n  Ephemeral = 'ephemeral',\n}\n\nexport enum TemplateWhenMissing {\n  Skip = 'skip',\n  Fail = 'fail',\n}\n\n// Repository aliases mount at /workspaces/<alias>.\nexport const repositoryAliasSchema = z\n  .string()\n  .regex(/^[a-zA-Z0-9][a-zA-Z0-9._-]*$/)\n  .max(120);\nconst variableNameSchema = z\n  .string()\n  .regex(/^[A-Za-z_][A-Za-z0-9_]*$/)\n  .max(256);\n\nexport const computerRepositorySchema = z.object({\n  alias: repositoryAliasSchema,\n  // A repository the organization can reach, named as the host's repository\n  // resolver accepts it (a GitHub 'final/app', a Final repository id), or a git URL.\n  repository: z.string().min(1),\n  ref: z.string().min(1).nullable().default(null),\n});\n\nexport const computerNetworkPolicySchema = z.union([\n  z.nativeEnum(NetworkPolicy),\n  z.object({ mode: z.nativeEnum(NetworkPolicy), allow: z.array(z.string()).default([]) }),\n]);\n\n// Start-time parameters; everything optional so a guide reference can override any subset.\nexport const computerParametersSchema = z.object({\n  repositories: z.array(computerRepositorySchema).optional(),\n  // Names of variables (secrets); values are injected at start, never stored here.\n  variables: z.array(variableNameSchema).optional(),\n  workspace: z.nativeEnum(ComputerWorkspacePolicy).optional(),\n  networkPolicy: computerNetworkPolicySchema.optional(),\n  // Plain, non-secret environment values.\n  env: z.record(variableNameSchema, z.string().max(16 * 1024)).optional(),\n});\n\n// The subset of `.final/sandbox-template.yaml` v2 the computer sandbox reads.\nconst templateStepSchema = z.object({\n  run: z\n    .string()\n    .min(1)\n    .max(10 * 1024),\n  cwd: z.string().min(1).default('.'),\n  whenMissing: z.nativeEnum(TemplateWhenMissing).nullable().default(null),\n  timeoutMinutes: z.number().int().min(1).max(120).default(20),\n  required: z.boolean().default(true),\n});\nconst templateServiceSchema = templateStepSchema.extend({\n  name: z\n    .string()\n    .regex(/^[a-z0-9][a-z0-9-]*$/)\n    .max(64),\n  ready: z\n    .object({ url: z.string().url(), timeoutSeconds: z.number().int().min(1).max(600).default(90) })\n    .nullable()\n    .default(null),\n});\nconst templateCommandSchema = z.object({\n  run: z\n    .string()\n    .min(1)\n    .max(10 * 1024),\n  description: z.string().min(1).max(500).nullable().default(null),\n  cwd: z.string().min(1).default('.'),\n  whenMissing: z.nativeEnum(TemplateWhenMissing).nullable().default(null),\n  timeoutMinutes: z.number().int().min(1).max(120).default(20),\n});\n\nexport const computerTemplateSchema = z.object({\n  version: z.literal(2).default(2),\n  build: z\n    .object({\n      timeoutMinutes: z.number().int().min(1).max(120).default(30),\n      steps: z.array(templateStepSchema).max(30).default([]),\n      verify: z.array(templateStepSchema).max(30).default([]),\n    })\n    .prefault({}),\n  workspace: z.object({ setup: z.array(templateStepSchema).max(30).default([]) }).prefault({}),\n  services: z.array(templateServiceSchema).max(20).default([]),\n  commands: z\n    .record(\n      z\n        .string()\n        .regex(/^[a-z0-9][a-z0-9-]*$/)\n        .max(64),\n      templateCommandSchema,\n    )\n    .default({}),\n});\n\nexport const computerInlineGuideSchema = z.object({\n  // An OCI image reference, or `lineage:<name>` for a platform image lineage.\n  image: z.string().min(1),\n  template: computerTemplateSchema.prefault({}),\n  repositories: z.array(computerRepositorySchema).default([]),\n  variables: z.array(variableNameSchema).default([]),\n});\n\nexport const computerEnvironmentSchema = z.union([\n  z.strictObject({\n    guide: z.strictObject({\n      ref: z.string().min(1),\n      version: z.union([z.literal('latest'), z.number().int().min(1)]).default('latest'),\n    }),\n    parameters: computerParametersSchema.prefault({}),\n  }),\n  z.strictObject({\n    inline: computerInlineGuideSchema,\n    parameters: computerParametersSchema.prefault({}),\n  }),\n  z.strictObject({ image: z.string().min(1), parameters: computerParametersSchema.prefault({}) }),\n  // The organization's default guide.\n  z.strictObject({ parameters: computerParametersSchema.prefault({}) }),\n]);\n\n// `.open({ access, attach })` of the `computer` and `device` sandboxes. `attach`\n// is the host's (lazy unless `on-prompt`); the provider reads only `access`.\nexport const computerOpenOptionsSchema = z.strictObject({\n  access: z.nativeEnum(SandboxAccess).default(SandboxAccess.Write),\n  attach: z.nativeEnum(SandboxAttach).optional(),\n});\n\nexport const deviceEnvironmentSchema = z.union([\n  z.strictObject({ deviceId: z.string().uuid() }),\n  // A pairing code the owner approved; resolved to a device at prepare.\n  z.strictObject({ pairing: z.string().min(1) }),\n  // The only Device of the user the session acts for.\n  z.strictObject({}),\n]);\n\nexport type ComputerRepositoryIface = z.infer<typeof computerRepositorySchema>;\nexport type ComputerParametersIface = z.infer<typeof computerParametersSchema>;\nexport type ComputerTemplateIface = z.infer<typeof computerTemplateSchema>;\nexport type ComputerTemplateInputIface = z.input<typeof computerTemplateSchema>;\nexport type ComputerInlineGuideIface = z.infer<typeof computerInlineGuideSchema>;\nexport type ComputerEnvironmentOptions = z.infer<typeof computerEnvironmentSchema>;\nexport type ComputerOpenOptionsIface = z.infer<typeof computerOpenOptionsSchema>;\nexport type ComputerNetworkPolicyOption = z.infer<typeof computerNetworkPolicySchema>;\nexport type DeviceEnvironmentOptions = z.infer<typeof deviceEnvironmentSchema>;\n"],
-  "mappings": "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",
-  "names": ["ComputerWorkspacePolicy", "TemplateWhenMissing"]
+  "sourcesContent": ["import * as z from 'zod';\n\n// Environment options of the `computer` and `device` providers: what a\n// `project.sandboxes.create(computer({...}))` call carries as the environment,\n// validated by the provider. Only what the provider itself controls lives\n// here (image, build, machine, region, idle policy); what should be on the\n// machine is the provider-neutral sandbox setup, which the platform applies.\n// Pure (no I/O) so callers can import it anywhere.\n\nexport const COMPUTER_PROVIDER = 'computer';\nexport const DEVICE_PROVIDER = 'device';\n\n// The Device API's header naming the user a request acts for.\nexport const DEVICE_API_ACTING_USER_HEADER = 'Final-Acting-User-Id';\n\n// The platform's image lineage computers start from when none is named.\nexport const DEFAULT_COMPUTER_IMAGE = 'lineage:sandbox';\n\nconst buildStepSchema = z.strictObject({\n  run: z\n    .string()\n    .min(1)\n    .max(10 * 1024),\n  timeoutMinutes: z.number().int().min(1).max(120).default(20),\n});\n\n// Steps baked into a base once (the provider's preparation), never run per sandbox.\nexport const computerBuildSchema = z.strictObject({\n  steps: z.array(buildStepSchema).max(30).default([]),\n  // Checks that the built base works; a failing one fails the build.\n  verify: z.array(buildStepSchema).max(30).default([]),\n});\n\nexport const computerMachineSchema = z.strictObject({\n  vcpu: z.number().int().min(1).max(64).optional(),\n  memoryMb: z.number().int().min(512).max(262_144).optional(),\n  diskGb: z.number().int().min(1).max(2048).optional(),\n});\n\nexport const computerEnvironmentSchema = z.strictObject({\n  // An OCI image reference, or `lineage:<name>` for a platform image lineage.\n  image: z.string().min(1).max(512).optional(),\n  build: computerBuildSchema.optional(),\n  machine: computerMachineSchema.optional(),\n  region: z.string().min(1).max(64).optional(),\n  // Idle time before the computer pauses (its disk and processes kept).\n  idleTimeoutSeconds: z\n    .number()\n    .int()\n    .min(60)\n    .max(7 * 24 * 60 * 60)\n    .optional(),\n});\n\nexport const deviceEnvironmentSchema = z.union([\n  z.strictObject({ deviceId: z.string().uuid() }),\n  // A pairing code the owner approved; resolved to a device at prepare.\n  z.strictObject({ pairing: z.string().min(1) }),\n]);\n\nexport type ComputerBuildIface = z.output<typeof computerBuildSchema>;\nexport type ComputerEnvironmentIface = z.output<typeof computerEnvironmentSchema>;\nexport type ComputerEnvironmentInputIface = z.input<typeof computerEnvironmentSchema>;\nexport type DeviceEnvironmentIface = z.output<typeof deviceEnvironmentSchema>;\nexport type DeviceEnvironmentInputIface = z.input<typeof deviceEnvironmentSchema>;\n"],
+  "mappings": "AAAA,YAAY,OAAO;AASZ,MAAM,oBAAoB;AAC1B,MAAM,kBAAkB;AAGxB,MAAM,gCAAgC;AAGtC,MAAM,yBAAyB;AAEtC,MAAM,kBAAkB,EAAE,aAAa;AAAA,EACrC,KAAK,EACF,OAAO,EACP,IAAI,CAAC,EACL,IAAI,KAAK,IAAI;AAAA,EAChB,gBAAgB,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,QAAQ,EAAE;AAC7D,CAAC;AAGM,MAAM,sBAAsB,EAAE,aAAa;AAAA,EAChD,OAAO,EAAE,MAAM,eAAe,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;AAAA;AAAA,EAElD,QAAQ,EAAE,MAAM,eAAe,EAAE,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;AACrD,CAAC;AAEM,MAAM,wBAAwB,EAAE,aAAa;AAAA,EAClD,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS;AAAA,EAC/C,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,GAAG,EAAE,IAAI,MAAO,EAAE,SAAS;AAAA,EAC1D,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,IAAI,EAAE,SAAS;AACrD,CAAC;AAEM,MAAM,4BAA4B,EAAE,aAAa;AAAA;AAAA,EAEtD,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA,EAC3C,OAAO,oBAAoB,SAAS;AAAA,EACpC,SAAS,sBAAsB,SAAS;AAAA,EACxC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,SAAS;AAAA;AAAA,EAE3C,oBAAoB,EACjB,OAAO,EACP,IAAI,EACJ,IAAI,EAAE,EACN,IAAI,IAAI,KAAK,KAAK,EAAE,EACpB,SAAS;AACd,CAAC;AAEM,MAAM,0BAA0B,EAAE,MAAM;AAAA,EAC7C,EAAE,aAAa,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAAA;AAAA,EAE9C,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC;AAC/C,CAAC;",
+  "names": []
 }

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

@@ -1,69 +1,9 @@
-import { type JsonObject, type NetworkPolicy, type NetworkSandboxSessionIface, type PackageProviderRefIface, type SandboxAccess, type SandboxAttach, type SandboxEnvironmentIface, type SandboxOpenRequestIface } from '@finalai/agent-provider';
-import { type ComputerTemplateInputIface, type ComputerWorkspacePolicy } from "./environment.mjs";
-export { COMPUTER_SANDBOX_SPECIFIER, computerEnvironmentSchema, ComputerWorkspacePolicy, DEVICE_API_ACTING_USER_HEADER, DEVICE_SANDBOX_SPECIFIER, deviceEnvironmentSchema, TemplateWhenMissing, } from "./environment.mjs";
-export type { ComputerEnvironmentOptions, ComputerRepositoryIface, ComputerTemplateIface, ComputerTemplateInputIface, DeviceEnvironmentOptions, } from "./environment.mjs";
-type EnumInput<E extends string> = E | `${E}`;
-export interface SandboxOpenInputIface {
-    access?: EnumInput<SandboxAccess>;
-    attach?: EnumInput<SandboxAttach>;
-}
-export interface InstalledSandboxOpenRequestIface extends SandboxOpenRequestIface<JsonObject, JsonObject> {
-    readonly provider: PackageProviderRefIface;
-    readonly providerRef: PackageProviderRefIface;
-}
-export interface InstalledSandboxEnvironmentIface extends SandboxEnvironmentIface<JsonObject, SandboxOpenInputIface> {
-    readonly provider: PackageProviderRefIface;
-    readonly providerRef: PackageProviderRefIface;
-    open(options?: SandboxOpenInputIface): InstalledSandboxOpenRequestIface & PromiseLike<NetworkSandboxSessionIface>;
-}
-export interface ComputerRepositoryInputIface {
-    alias: string;
-    repository: string;
-    ref?: string | null;
-}
-export interface ComputerParametersInputIface {
-    repositories?: ComputerRepositoryInputIface[];
-    variables?: string[];
-    workspace?: EnumInput<ComputerWorkspacePolicy>;
-    networkPolicy?: EnumInput<NetworkPolicy> | {
-        mode: EnumInput<NetworkPolicy>;
-        allow?: string[];
-    };
-    env?: Record<string, string>;
-}
-export interface ComputerSetupGuideInputIface extends ComputerParametersInputIface {
-    ref: string;
-    version?: number | 'latest';
-}
-export interface ComputerInlineGuideInputIface {
-    image: string;
-    template: ComputerTemplateInputIface;
-    repositories?: ComputerRepositoryInputIface[];
-    variables?: string[];
-}
-export interface ComputerInputIface extends ComputerParametersInputIface {
-    image?: string;
-}
-export interface DeviceInputIface {
-    deviceId?: string;
-    pairing?: string;
-}
-export declare const computerSetupGuide: ((input: ComputerSetupGuideInputIface) => InstalledSandboxEnvironmentIface) & {
-    define: (input: ComputerInlineGuideInputIface) => InstalledSandboxEnvironmentIface;
-    providerRef: {
-        kind: import("@finalai/agent-provider").ProviderRefKind.Package;
-        specifier: string;
-    };
-};
-export declare const computer: ((input?: ComputerInputIface) => InstalledSandboxEnvironmentIface) & {
-    providerRef: {
-        kind: import("@finalai/agent-provider").ProviderRefKind.Package;
-        specifier: string;
-    };
-};
-export declare const device: ((input?: DeviceInputIface) => InstalledSandboxEnvironmentIface) & {
-    providerRef: {
-        kind: import("@finalai/agent-provider").ProviderRefKind.Package;
-        specifier: string;
-    };
-};
+import { type JsonObject, type SandboxEnvironmentValueIface } from '@finalai/agent-provider';
+import { type ComputerEnvironmentInputIface, type DeviceEnvironmentInputIface } from "./environment.mjs";
+export declare const WORKERS_PROVIDER = "workers";
+export { COMPUTER_PROVIDER, computerEnvironmentSchema, DEFAULT_COMPUTER_IMAGE, DEVICE_API_ACTING_USER_HEADER, DEVICE_PROVIDER, deviceEnvironmentSchema, type ComputerBuildIface, type ComputerEnvironmentIface, type ComputerEnvironmentInputIface, type DeviceEnvironmentIface, type DeviceEnvironmentInputIface, } from "./environment.mjs";
+export { defineSandboxSetup, describeSandbox, LATEST_SANDBOX_SETUP_VERSION, type SandboxDescriptionIface, type SandboxSetupIface, type SandboxSetupInputIface, } from '@finalai/agent-provider/sandbox/setup';
+export type { SandboxEnvironmentValueIface } from '@finalai/agent-provider';
+export declare const computer: (options?: ComputerEnvironmentInputIface) => SandboxEnvironmentValueIface<JsonObject>;
+export declare const device: (options: DeviceEnvironmentInputIface) => SandboxEnvironmentValueIface<JsonObject>;
+export declare const workers: () => SandboxEnvironmentValueIface<null>;