experimental-agent 0.2.3 → 0.4.0

package/dist/sandbox.mjs

@@ -0,0 +1,19 @@
+import {
+  vercelSandbox
+} from "./chunk-RT72C52I.mjs";
+import {
+  dockerSandbox
+} from "./chunk-BFFNCESS.mjs";
+import {
+  localSandbox
+} from "./chunk-ZUFJJYC4.mjs";
+import "./chunk-GKASMIBR.mjs";
+import "./chunk-JO3JDCH5.mjs";
+import "./chunk-MSWINCCM.mjs";
+import "./chunk-BJTO5JO5.mjs";
+export {
+  dockerSandbox,
+  localSandbox,
+  vercelSandbox
+};
+//# sourceMappingURL=data:application/json;base64,ewogICJ2ZXJzaW9uIjogMywKICAic291cmNlcyI6IFtdLAogICJzb3VyY2VzQ29udGVudCI6IFtdLAogICJtYXBwaW5ncyI6ICIiLAogICJuYW1lcyI6IFtdCn0K

package/dist/steps-BIsP57pm.d.mts

@@ -0,0 +1,173 @@
+import * as _vercel_sandbox from '@vercel/sandbox';
+import { f as Storage, b as Sandbox } from './adapter-zgOel4wW.mjs';
+
+type LogLevel = "info" | "warn" | "error" | "silent";
+type LogContext = {
+    sessionId?: string;
+    messageId?: string;
+    sandboxId?: string;
+    [key: string]: unknown;
+};
+type LoggingConfig = {
+    level?: LogLevel;
+    /**
+     * Top-level label for all log lines.
+     * @default "agent"
+     * @example "my-app" → [my-app:default:workflow]
+     */
+    prefix?: string;
+    name?: string;
+};
+declare class Logger {
+    readonly subsystem: string;
+    private readonly config;
+    private readonly context;
+    constructor({ subsystem, config, context, }: {
+        subsystem: string;
+        config: LoggingConfig;
+        context?: LogContext;
+    });
+    child({ subsystem, context, }: {
+        subsystem?: string;
+        context?: LogContext;
+    }): Logger;
+    withContext(context: LogContext): Logger;
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Returns a function that, when called, logs the elapsed time at info level.
+     * Pass `logOnStart: true` to also log when the timer begins.
+     *
+     * @example
+     * const done = log.time("sandbox setup", { sandboxId }, { logOnStart: true });
+     * await setup();
+     * done(); // start: [agent:default:sandbox] sandbox setup { sandboxId: '...' }
+     *         // end:   [agent:default:sandbox] sandbox setup { sandboxId: '...', durationMs: 123 }
+     */
+    time(message: string, data?: Record<string, unknown>, opts?: {
+        logOnStart?: boolean;
+    }): (endData?: Record<string, unknown>) => void;
+}
+
+type ExecResult = {
+    commandId: string;
+    logs: () => AsyncIterable<{
+        stream: "stdout" | "stderr";
+        data: string;
+    }>;
+    result: Promise<{
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    }>;
+};
+type UploadableFile = {
+    path: string;
+    content: string | Buffer;
+};
+interface SandboxInstance {
+    readonly cwd: string;
+    exec(opts: {
+        command: string;
+        args?: string[];
+        cwd?: string;
+        env?: Record<string, string>;
+        sudo?: boolean;
+        signal?: AbortSignal;
+    }): Promise<ExecResult>;
+    readFile(opts: {
+        path: string;
+        signal?: AbortSignal;
+    }): Promise<Buffer | null>;
+    writeFiles(opts: {
+        files: UploadableFile[];
+        destPath: string;
+        signal?: AbortSignal;
+    }): Promise<void>;
+    getDomain(opts: {
+        port: number;
+        signal?: AbortSignal;
+    }): Promise<string>;
+    updateNetworkPolicy(opts: {
+        policy: _vercel_sandbox.NetworkPolicy;
+        signal?: AbortSignal;
+    }): Promise<_vercel_sandbox.NetworkPolicy>;
+    start(opts?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    stop(opts?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    snapshot(opts?: {
+        signal?: AbortSignal;
+    }): Promise<{
+        snapshotId: string;
+    }>;
+    kill(opts: {
+        commandId: string;
+        signal?: AbortSignal;
+    }): Promise<void>;
+    getStatus(opts?: {
+        signal?: AbortSignal;
+    }): Promise<"pending" | "running" | "stopping" | "stopped" | "failed">;
+}
+type SandboxAgentRef = {
+    name: string;
+    storage: Storage;
+    options: {
+        logging?: Omit<LoggingConfig, "name">;
+    };
+};
+type WithConfig<TConfig> = unknown extends TConfig ? {
+    config?: Record<string, unknown>;
+} : Partial<TConfig> extends TConfig ? {
+    config?: TConfig;
+} : {
+    config: TConfig;
+};
+type SandboxSetupFields = Omit<Sandbox["setup"], "binding" | "completedAt">;
+type SandboxBinding<TType extends string = string, TConfig = any, TMetadata = any> = {
+    type: TType;
+    create(opts: {
+        cwd: string;
+        agent: SandboxAgentRef;
+        setup: SandboxSetupFields & {
+            run?: (sandbox: SandboxInstance) => Promise<void>;
+        } & WithConfig<TConfig>;
+        record?: Sandbox;
+        signal?: AbortSignal;
+        log: Logger;
+    }): Promise<{
+        instance: SandboxInstance;
+        metadata: TMetadata;
+    }>;
+    connect(opts: {
+        agent: SandboxAgentRef;
+        metadata: TMetadata;
+        signal?: AbortSignal;
+        log: Logger;
+    }): Promise<SandboxInstance>;
+};
+
+type LifecycleStepResult = {
+    action: "continue";
+    nextPollMs: number;
+} | {
+    action: "exit";
+    reason: "sandboxId_changed" | "idle" | "timeout" | "not_found";
+};
+type LifecycleConfig = {
+    pollIntervalMs?: number;
+    stopAfterInactiveMs?: number;
+    snapshotBeforeTimeoutMs?: number;
+};
+type LifecycleInput = {
+    agent: SandboxAgentRef;
+    sandboxId: string;
+    vercelSandboxId: string;
+    config?: LifecycleConfig;
+};
+declare function checkAndSnapshotStep(input: LifecycleInput): Promise<Error | LifecycleStepResult>;
+
+export { type ExecResult as E, type LifecycleInput as L, type SandboxBinding as S, type UploadableFile as U, type WithConfig as W, type SandboxSetupFields as a, type SandboxInstance as b, type LoggingConfig as c, type SandboxAgentRef as d, type LifecycleConfig as e, type LifecycleStepResult as f, checkAndSnapshotStep as g };

package/dist/steps-DShnXBLf.d.ts

@@ -0,0 +1,173 @@
+import * as _vercel_sandbox from '@vercel/sandbox';
+import { f as Storage, b as Sandbox } from './adapter-zgOel4wW.js';
+
+type LogLevel = "info" | "warn" | "error" | "silent";
+type LogContext = {
+    sessionId?: string;
+    messageId?: string;
+    sandboxId?: string;
+    [key: string]: unknown;
+};
+type LoggingConfig = {
+    level?: LogLevel;
+    /**
+     * Top-level label for all log lines.
+     * @default "agent"
+     * @example "my-app" → [my-app:default:workflow]
+     */
+    prefix?: string;
+    name?: string;
+};
+declare class Logger {
+    readonly subsystem: string;
+    private readonly config;
+    private readonly context;
+    constructor({ subsystem, config, context, }: {
+        subsystem: string;
+        config: LoggingConfig;
+        context?: LogContext;
+    });
+    child({ subsystem, context, }: {
+        subsystem?: string;
+        context?: LogContext;
+    }): Logger;
+    withContext(context: LogContext): Logger;
+    info(message: string, data?: Record<string, unknown>): void;
+    warn(message: string, data?: Record<string, unknown>): void;
+    error(message: string, data?: Record<string, unknown>): void;
+    /**
+     * Returns a function that, when called, logs the elapsed time at info level.
+     * Pass `logOnStart: true` to also log when the timer begins.
+     *
+     * @example
+     * const done = log.time("sandbox setup", { sandboxId }, { logOnStart: true });
+     * await setup();
+     * done(); // start: [agent:default:sandbox] sandbox setup { sandboxId: '...' }
+     *         // end:   [agent:default:sandbox] sandbox setup { sandboxId: '...', durationMs: 123 }
+     */
+    time(message: string, data?: Record<string, unknown>, opts?: {
+        logOnStart?: boolean;
+    }): (endData?: Record<string, unknown>) => void;
+}
+
+type ExecResult = {
+    commandId: string;
+    logs: () => AsyncIterable<{
+        stream: "stdout" | "stderr";
+        data: string;
+    }>;
+    result: Promise<{
+        stdout: string;
+        stderr: string;
+        exitCode: number;
+    }>;
+};
+type UploadableFile = {
+    path: string;
+    content: string | Buffer;
+};
+interface SandboxInstance {
+    readonly cwd: string;
+    exec(opts: {
+        command: string;
+        args?: string[];
+        cwd?: string;
+        env?: Record<string, string>;
+        sudo?: boolean;
+        signal?: AbortSignal;
+    }): Promise<ExecResult>;
+    readFile(opts: {
+        path: string;
+        signal?: AbortSignal;
+    }): Promise<Buffer | null>;
+    writeFiles(opts: {
+        files: UploadableFile[];
+        destPath: string;
+        signal?: AbortSignal;
+    }): Promise<void>;
+    getDomain(opts: {
+        port: number;
+        signal?: AbortSignal;
+    }): Promise<string>;
+    updateNetworkPolicy(opts: {
+        policy: _vercel_sandbox.NetworkPolicy;
+        signal?: AbortSignal;
+    }): Promise<_vercel_sandbox.NetworkPolicy>;
+    start(opts?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    stop(opts?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    snapshot(opts?: {
+        signal?: AbortSignal;
+    }): Promise<{
+        snapshotId: string;
+    }>;
+    kill(opts: {
+        commandId: string;
+        signal?: AbortSignal;
+    }): Promise<void>;
+    getStatus(opts?: {
+        signal?: AbortSignal;
+    }): Promise<"pending" | "running" | "stopping" | "stopped" | "failed">;
+}
+type SandboxAgentRef = {
+    name: string;
+    storage: Storage;
+    options: {
+        logging?: Omit<LoggingConfig, "name">;
+    };
+};
+type WithConfig<TConfig> = unknown extends TConfig ? {
+    config?: Record<string, unknown>;
+} : Partial<TConfig> extends TConfig ? {
+    config?: TConfig;
+} : {
+    config: TConfig;
+};
+type SandboxSetupFields = Omit<Sandbox["setup"], "binding" | "completedAt">;
+type SandboxBinding<TType extends string = string, TConfig = any, TMetadata = any> = {
+    type: TType;
+    create(opts: {
+        cwd: string;
+        agent: SandboxAgentRef;
+        setup: SandboxSetupFields & {
+            run?: (sandbox: SandboxInstance) => Promise<void>;
+        } & WithConfig<TConfig>;
+        record?: Sandbox;
+        signal?: AbortSignal;
+        log: Logger;
+    }): Promise<{
+        instance: SandboxInstance;
+        metadata: TMetadata;
+    }>;
+    connect(opts: {
+        agent: SandboxAgentRef;
+        metadata: TMetadata;
+        signal?: AbortSignal;
+        log: Logger;
+    }): Promise<SandboxInstance>;
+};
+
+type LifecycleStepResult = {
+    action: "continue";
+    nextPollMs: number;
+} | {
+    action: "exit";
+    reason: "sandboxId_changed" | "idle" | "timeout" | "not_found";
+};
+type LifecycleConfig = {
+    pollIntervalMs?: number;
+    stopAfterInactiveMs?: number;
+    snapshotBeforeTimeoutMs?: number;
+};
+type LifecycleInput = {
+    agent: SandboxAgentRef;
+    sandboxId: string;
+    vercelSandboxId: string;
+    config?: LifecycleConfig;
+};
+declare function checkAndSnapshotStep(input: LifecycleInput): Promise<Error | LifecycleStepResult>;
+
+export { type ExecResult as E, type LifecycleInput as L, type SandboxBinding as S, type UploadableFile as U, type WithConfig as W, type SandboxSetupFields as a, type SandboxInstance as b, type LoggingConfig as c, type SandboxAgentRef as d, type LifecycleConfig as e, type LifecycleStepResult as f, checkAndSnapshotStep as g };

package/dist/storage.d.mts

@@ -0,0 +1,17 @@
+import { S as StorageHandlers } from './adapter-zgOel4wW.mjs';
+export { G as GenerationOptions, M as Message, a as MessageUsage, P as Part, b as Sandbox, c as Session, d as Setup, e as SetupSnapshot, f as Storage, g as StorageCall, h as StorageStep, i as StorageStepFunction, t as toStorage } from './adapter-zgOel4wW.mjs';
+import '@workflow/serde';
+import '@vercel/sandbox';
+import 'ai';
+
+declare function kvStorageFallback(opts: {
+    prefix: string;
+}): StorageHandlers;
+
+declare function localStorage(opts?: {
+    dir?: string;
+}): StorageHandlers;
+
+declare function shouldFallbackToKV2(): boolean;
+
+export { StorageHandlers, kvStorageFallback, localStorage, shouldFallbackToKV2 };

package/dist/storage.d.ts

@@ -0,0 +1,17 @@
+import { S as StorageHandlers } from './adapter-zgOel4wW.js';
+export { G as GenerationOptions, M as Message, a as MessageUsage, P as Part, b as Sandbox, c as Session, d as Setup, e as SetupSnapshot, f as Storage, g as StorageCall, h as StorageStep, i as StorageStepFunction, t as toStorage } from './adapter-zgOel4wW.js';
+import '@workflow/serde';
+import '@vercel/sandbox';
+import 'ai';
+
+declare function kvStorageFallback(opts: {
+    prefix: string;
+}): StorageHandlers;
+
+declare function localStorage(opts?: {
+    dir?: string;
+}): StorageHandlers;
+
+declare function shouldFallbackToKV2(): boolean;
+
+export { StorageHandlers, kvStorageFallback, localStorage, shouldFallbackToKV2 };