experimental-agent 0.4.0 → 0.5.0

package/dist/entry-QNyd4S1s.d.ts

@@ -0,0 +1,45 @@
+import { a as SandboxSetupFields, b as SandboxInstance, S as SandboxBinding, e as LifecycleConfig } from './steps-XA4wG8W3.js';
+import * as _vercel_sandbox from '@vercel/sandbox';
+
+type DockerBindingConfig = {
+    cwd?: string;
+};
+type DockerBindingMetadata = {
+    sandboxName: string;
+};
+declare function dockerSandbox(defaults?: Partial<SandboxSetupFields> & {
+    run?: (sandbox: SandboxInstance) => Promise<void>;
+    config?: DockerBindingConfig;
+}): SandboxBinding<"docker", DockerBindingConfig, DockerBindingMetadata>;
+
+type LocalBindingConfig = {
+    cwd?: string;
+};
+type LocalBindingMetadata = {
+    basePath: string;
+    pid: number;
+};
+declare function localSandbox(defaults?: Partial<SandboxSetupFields> & {
+    run?: (sandbox: SandboxInstance) => Promise<void>;
+    config?: LocalBindingConfig;
+}): SandboxBinding<"local", LocalBindingConfig, LocalBindingMetadata>;
+
+type VercelBindingConfig = {
+    cwd?: string;
+    resources?: {
+        vcpus: number;
+    };
+    ports?: number[];
+    networkPolicy?: _vercel_sandbox.NetworkPolicy;
+    snapshotId?: string;
+    lifecycle?: LifecycleConfig;
+};
+type VercelBindingMetadata = {
+    sandboxId: string;
+};
+declare function vercelSandbox(defaults?: Partial<SandboxSetupFields> & {
+    run?: (sandbox: SandboxInstance) => Promise<void>;
+    config?: VercelBindingConfig;
+}): SandboxBinding<"vercel", VercelBindingConfig, VercelBindingMetadata>;
+
+export { type DockerBindingConfig as D, type LocalBindingConfig as L, type VercelBindingConfig as V, type LocalBindingMetadata as a, type VercelBindingMetadata as b, type DockerBindingMetadata as c, dockerSandbox as d, localSandbox as l, vercelSandbox as v };

package/dist/index.d.mts

@@ -1,21 +1,16 @@
 import * as _vercel_sandbox from '@vercel/sandbox';
-import { S as SandboxBinding, a as SandboxSetupFields, b as SandboxInstance, W as WithConfig, c as LoggingConfig, E as ExecResult, U as UploadableFile } from './steps-BIsP57pm.mjs';
-export { d as SandboxAgentRef } from './steps-BIsP57pm.mjs';
-import { L as LocalBindingConfig, a as LocalBindingMetadata, V as VercelBindingConfig, b as VercelBindingMetadata, D as DockerBindingConfig, c as DockerBindingMetadata } from './entry-6HYg5qqg.mjs';
+import { S as SandboxBinding, a as SandboxSetupFields, b as SandboxInstance, W as WithConfig, c as LoggingConfig, E as ExecResult, U as UploadableFile } from './steps-eTytqxQb.mjs';
+export { d as SandboxAgentRef } from './steps-eTytqxQb.mjs';
+import { L as LocalBindingConfig, a as LocalBindingMetadata, V as VercelBindingConfig, b as VercelBindingMetadata, D as DockerBindingConfig, c as DockerBindingMetadata } from './entry-Bs17QEiq.mjs';
+import { G as GenerationOptions, j as StorageInput, f as Storage, c as Session } from './adapter-Cl735Kp4.mjs';
 import * as ai from 'ai';
-import { InferToolInput, ModelMessage, ToolSet, UIMessage, InferUITools, GatewayModelId } from 'ai';
+import { ToolSet, InferToolInput, ModelMessage, UIMessage, InferUITools, GatewayModelId } from 'ai';
 import { z } from 'zod';
-import { c as Session, f as Storage, j as SkillInput, k as StorageInput } from './adapter-zgOel4wW.mjs';
-export { l as GitSkillEntry, m as GitSkillInput, H as HostSkillEntry, n as HostSkillInput, I as InlineSkillEntry, o as InlineSkillInput, p as SandboxSkillEntry, q as SandboxSkillInput, r as SkillEntry, s as SkillSourceType } from './adapter-zgOel4wW.mjs';
 import { WORKFLOW_SERIALIZE, WORKFLOW_DESERIALIZE } from '@workflow/serde';
 import * as errore from 'errore';
 
 type BuiltInBindings = SandboxBinding<"local", LocalBindingConfig, LocalBindingMetadata> | SandboxBinding<"vercel", VercelBindingConfig, VercelBindingMetadata> | SandboxBinding<"docker", DockerBindingConfig, DockerBindingMetadata>;
 
-type SandboxOptions = {
-    id?: string;
-};
-
 type SetupCommonFields = Partial<SandboxSetupFields> & {
     cwd?: string;
     run?: (sandbox: SandboxInstance) => Promise<void>;
@@ -33,6 +28,10 @@ type SetupResult = {
     done: Promise<SandboxInstance>;
 };
 
+type SandboxOptions = {
+    id?: string;
+};
+
 type StepUsage = {
     stepIndex: number;
     model: string;
@@ -60,12 +59,59 @@ type SessionUsage = {
     byMessageId: Record<string, UsageSummary | null>;
 };
 
-type ToolContext<TContext = Record<string, unknown>> = {
-    session: Session;
-    sandbox: SandboxInstance;
-    storage: Storage;
-    context: TContext;
+type SkillSourceType = "sandbox" | "host" | "git" | "inline";
+type SandboxSkillInput = {
+    type: "sandbox";
+    path: string;
+};
+type HostSkillInput = {
+    type: "host";
+    path: string;
+};
+type GitSkillInput = {
+    type: "git";
+    repo: string;
+    ref?: string;
+    path?: string;
+    /**
+     * Skill directory name under `path`.
+     */
+    name?: string;
 };
+type InlineSkillInput = {
+    type: "inline";
+    name: string;
+    description: string;
+    instructions: string;
+};
+type SkillInput = SandboxSkillInput | HostSkillInput | GitSkillInput | InlineSkillInput;
+type SandboxSkillEntry = {
+    type: "sandbox";
+    path: string;
+};
+type HostSkillEntry = {
+    type: "host";
+    path: string;
+};
+type GitSkillEntry = {
+    type: "git";
+    repo: string;
+    ref?: string;
+    path?: string;
+    /**
+     * Skill directory name under `path`.
+     */
+    name?: string;
+};
+type InlineSkillEntry = {
+    type: "inline";
+    name: string;
+    description: string;
+    instructions: string;
+};
+type SkillEntry = SandboxSkillEntry | HostSkillEntry | GitSkillEntry | InlineSkillEntry;
+
+type ToolContext<TContext = Record<string, unknown>, Tools extends ToolSet = ToolSet> = ResolvableArgs<TContext, Tools>;
 declare const builtInTools: {
     Read: ai.Tool<{
         label: string;
@@ -238,11 +284,6 @@ type WorkflowRunLike = {
     }): ReadableStream;
 };
 
-type UpdateOptions<Tools extends ToolSet> = Partial<Omit<Session, "id" | "activeTools" | "model"> & {
-    model?: GatewayModelId;
-    activeTools?: (Extract<keyof Tools, string> | BuiltInToolName)[];
-}>;
-
 type ApprovalData = {
     approvalId: string;
     approved: boolean;
@@ -261,7 +302,7 @@ type SendInput<Tools extends ToolSet> = string | MessageData<Tools> | {
     type: "approval";
     approval: ApprovalData;
 };
-type SendOptions<Tools extends ToolSet, TContext> = {
+type SendOptions<TContext> = {
     interruptIfStreaming?: boolean | {
         lastPart: {
             index: number;
@@ -270,7 +311,8 @@ type SendOptions<Tools extends ToolSet, TContext> = {
     };
     context?: TContext;
     abortSignal?: AbortSignal;
-} & UpdateOptions<Tools>;
+    sandboxId?: string;
+};
 type SendResult = {
     assistantMessageId: string;
     done: true | Promise<true>;
@@ -283,14 +325,21 @@ type InterruptOptions = {
     };
 };
 
-type SessionDefaults<Tools extends ToolSet = ToolSet> = {
-    model?: GatewayModelId;
-    system?: string;
-    generation?: Session["generation"];
-    activeTools?: (Extract<keyof Tools, string> | BuiltInToolName)[];
-    skills?: SkillInput[];
+type ResolvableArgs<TContext = Record<string, unknown>, Tools extends ToolSet = ToolSet> = {
+    context: TContext;
+    sessionId: string;
+    sandbox: SandboxInstance;
+    messages: UIMessage<unknown, AgentDataTypes, InferUITools<Tools>>[];
+};
+type Resolvable<T, TContext = Record<string, unknown>, Tools extends ToolSet = ToolSet> = T | ((args: ResolvableArgs<TContext, Tools>) => T | Promise<T>);
+type SessionDefaults<Tools extends ToolSet = ToolSet, TContext extends Record<string, unknown> = Record<string, unknown>> = {
+    model?: Resolvable<GatewayModelId | undefined, TContext, Tools>;
+    system?: Resolvable<string | string[] | undefined, TContext, Tools>;
+    generation?: Resolvable<GenerationOptions | undefined, TContext, Tools>;
+    activeTools?: Resolvable<readonly (Extract<keyof Tools, string> | BuiltInToolName)[] | undefined, TContext, Tools>;
+    skills?: Resolvable<SkillInput[] | undefined, TContext, Tools>;
 };
-type AgentOptions<Tools extends ToolSet = any, TSandboxBindings extends SandboxBinding | SandboxBinding[] = SandboxBinding, TContext extends Record<string, unknown> = Record<string, never>> = SessionDefaults<Tools> & {
+type AgentOptions<Tools extends ToolSet = any, TSandboxBindings extends SandboxBinding | SandboxBinding[] = SandboxBinding, TContext extends Record<string, unknown> = Record<string, never>> = SessionDefaults<Tools, TContext> & {
     storage?: StorageInput;
     sandbox?: TSandboxBindings;
     tools?: Tools;
@@ -315,14 +364,13 @@ declare class Agent<TMessageMetadata = unknown, Tools extends ToolSet = ToolSet,
     private _resolvedStorage;
     get storage(): Storage;
     get tools(): typeof builtInTools & Tools;
-    get sessionDefaults(): SessionDefaults;
     get hooks(): AgentHooks;
     readonly session: (id?: string | {
         id?: string;
     } | undefined) => {
         id: string;
-        send: (input: SendInput<Tools> | SendInput<Tools>[], opts?: SendOptions<Tools, TContext> | undefined) => Promise<SendResult>;
-        stream: (runOrOpts?: WorkflowRunLike | StreamOptions | undefined) => Promise<ReadableStream<ai.UIMessageChunk>>;
+        send: (input: SendInput<Tools> | SendInput<Tools>[], opts?: SendOptions<TContext> | undefined) => Promise<SendResult>;
+        stream: (runOrOpts?: StreamOptions | WorkflowRunLike | undefined) => Promise<ReadableStream<ai.UIMessageChunk>>;
         history: () => Promise<{
             messages: UIMessage<unknown, AgentDataTypes, InferUITools<Tools>>[];
             streamingMessageId: string | null;
@@ -330,10 +378,53 @@ declare class Agent<TMessageMetadata = unknown, Tools extends ToolSet = ToolSet,
         }>;
         interrupt: (opts?: InterruptOptions | undefined) => Promise<void>;
         usage: () => Promise<SessionUsage>;
-        update: (opts: Partial<Omit<Session, "id" | "model" | "activeTools"> & {
-            model?: GatewayModelId;
-            activeTools?: ("Read" | "Grep" | "List" | "Write" | "Edit" | "Bash" | "Skill" | "JavaScript" | Extract<keyof Tools, string>)[] | undefined;
-        }>) => Promise<void>;
+        update: (opts: Partial<Omit<Session, "id" | "createdAt" | "updatedAt">>) => Promise<void>;
+        sandbox: {
+            setup: (opts?: SetupOpts<TSandboxBindings> | undefined) => Promise<SetupResult>;
+            exec: (opts: {
+                command: string;
+                args?: string[];
+                cwd?: string;
+                env?: Record<string, string>;
+                sudo?: boolean;
+                signal?: AbortSignal;
+            }) => Promise<ExecResult>;
+            stop: (opts?: {
+                signal?: AbortSignal;
+            } | undefined) => Promise<void>;
+            snapshot: (opts?: {
+                signal?: AbortSignal;
+            } | undefined) => Promise<{
+                snapshotId: string;
+            }>;
+            getDomain: (opts: {
+                port: number;
+                signal?: AbortSignal;
+            }) => Promise<string>;
+            getStatus: (opts?: {
+                signal?: AbortSignal;
+            } | undefined) => Promise<"pending" | "running" | "stopping" | "stopped" | "failed">;
+            kill: (opts: {
+                commandId: string;
+                signal?: AbortSignal;
+            }) => Promise<void>;
+            readFile: (opts: {
+                path: string;
+                signal?: AbortSignal;
+            }) => Promise<Buffer | null>;
+            start: (opts?: {
+                signal?: AbortSignal;
+            } | undefined) => Promise<void>;
+            updateNetworkPolicy: (opts: {
+                policy: _vercel_sandbox.NetworkPolicy;
+                signal?: AbortSignal;
+            }) => Promise<_vercel_sandbox.NetworkPolicy>;
+            writeFiles: (opts: {
+                files: UploadableFile[];
+                destPath: string;
+                signal?: AbortSignal;
+            }) => Promise<void>;
+        };
     };
     readonly sandbox: (id?: string | SandboxOptions | undefined) => {
         id: string;
@@ -407,4 +498,4 @@ declare const MessageNotFoundError_base: errore.FactoryTaggedErrorClass<"Message
 declare class MessageNotFoundError extends MessageNotFoundError_base {
 }
 
-export { type AgentDataTypes, type AgentHooks, type AgentOptions, AgentStatus, type AnyAgent, type ApprovalData, type BuiltInToolName, ExecResult, type InferSession, type InferUIMessage, MessageNotFoundError, type NeedsApprovalMap, SandboxBinding, SandboxError, SandboxInstance, SandboxNotFoundError, SandboxSetupFields, type SendInput, type SessionDefaults, SessionNotFoundError, type SessionSendArgs, SkillInput, type StepUsage, StorageConflictError, StorageError, type ToolContext, UploadableFile, type UsageSummary, type WorkflowRunLike, agent, builtinToolNames };
+export { type AgentDataTypes, type AgentHooks, type AgentOptions, AgentStatus, type AnyAgent, type ApprovalData, type BuiltInToolName, ExecResult, type GitSkillEntry, type GitSkillInput, type HostSkillEntry, type HostSkillInput, type InferSession, type InferUIMessage, type InlineSkillEntry, type InlineSkillInput, MessageNotFoundError, type NeedsApprovalMap, type Resolvable, type ResolvableArgs, SandboxBinding, SandboxError, SandboxInstance, SandboxNotFoundError, SandboxSetupFields, type SandboxSkillEntry, type SandboxSkillInput, type SendInput, type SessionDefaults, SessionNotFoundError, type SessionSendArgs, type SkillEntry, type SkillInput, type SkillSourceType, type StepUsage, StorageConflictError, StorageError, type ToolContext, UploadableFile, type UsageSummary, type WorkflowRunLike, agent, builtinToolNames };

package/dist/index.d.ts

@@ -1,21 +1,16 @@
 import * as _vercel_sandbox from '@vercel/sandbox';
-import { S as SandboxBinding, a as SandboxSetupFields, b as SandboxInstance, W as WithConfig, c as LoggingConfig, E as ExecResult, U as UploadableFile } from './steps-DShnXBLf.js';
-export { d as SandboxAgentRef } from './steps-DShnXBLf.js';
-import { L as LocalBindingConfig, a as LocalBindingMetadata, V as VercelBindingConfig, b as VercelBindingMetadata, D as DockerBindingConfig, c as DockerBindingMetadata } from './entry-BrWOmEK2.js';
+import { S as SandboxBinding, a as SandboxSetupFields, b as SandboxInstance, W as WithConfig, c as LoggingConfig, E as ExecResult, U as UploadableFile } from './steps-XA4wG8W3.js';
+export { d as SandboxAgentRef } from './steps-XA4wG8W3.js';
+import { L as LocalBindingConfig, a as LocalBindingMetadata, V as VercelBindingConfig, b as VercelBindingMetadata, D as DockerBindingConfig, c as DockerBindingMetadata } from './entry-QNyd4S1s.js';
+import { G as GenerationOptions, j as StorageInput, f as Storage, c as Session } from './adapter-Cl735Kp4.js';
 import * as ai from 'ai';
-import { InferToolInput, ModelMessage, ToolSet, UIMessage, InferUITools, GatewayModelId } from 'ai';
+import { ToolSet, InferToolInput, ModelMessage, UIMessage, InferUITools, GatewayModelId } from 'ai';
 import { z } from 'zod';
-import { c as Session, f as Storage, j as SkillInput, k as StorageInput } from './adapter-zgOel4wW.js';
-export { l as GitSkillEntry, m as GitSkillInput, H as HostSkillEntry, n as HostSkillInput, I as InlineSkillEntry, o as InlineSkillInput, p as SandboxSkillEntry, q as SandboxSkillInput, r as SkillEntry, s as SkillSourceType } from './adapter-zgOel4wW.js';
 import { WORKFLOW_SERIALIZE, WORKFLOW_DESERIALIZE } from '@workflow/serde';
 import * as errore from 'errore';
 
 type BuiltInBindings = SandboxBinding<"local", LocalBindingConfig, LocalBindingMetadata> | SandboxBinding<"vercel", VercelBindingConfig, VercelBindingMetadata> | SandboxBinding<"docker", DockerBindingConfig, DockerBindingMetadata>;
 
-type SandboxOptions = {
-    id?: string;
-};
-
 type SetupCommonFields = Partial<SandboxSetupFields> & {
     cwd?: string;
     run?: (sandbox: SandboxInstance) => Promise<void>;
@@ -33,6 +28,10 @@ type SetupResult = {
     done: Promise<SandboxInstance>;
 };
 
+type SandboxOptions = {
+    id?: string;
+};
+
 type StepUsage = {
     stepIndex: number;
     model: string;
@@ -60,12 +59,59 @@ type SessionUsage = {
     byMessageId: Record<string, UsageSummary | null>;
 };
 
-type ToolContext<TContext = Record<string, unknown>> = {
-    session: Session;
-    sandbox: SandboxInstance;
-    storage: Storage;
-    context: TContext;
+type SkillSourceType = "sandbox" | "host" | "git" | "inline";
+type SandboxSkillInput = {
+    type: "sandbox";
+    path: string;
+};
+type HostSkillInput = {
+    type: "host";
+    path: string;
+};
+type GitSkillInput = {
+    type: "git";
+    repo: string;
+    ref?: string;
+    path?: string;
+    /**
+     * Skill directory name under `path`.
+     */
+    name?: string;
 };
+type InlineSkillInput = {
+    type: "inline";
+    name: string;
+    description: string;
+    instructions: string;
+};
+type SkillInput = SandboxSkillInput | HostSkillInput | GitSkillInput | InlineSkillInput;
+type SandboxSkillEntry = {
+    type: "sandbox";
+    path: string;
+};
+type HostSkillEntry = {
+    type: "host";
+    path: string;
+};
+type GitSkillEntry = {
+    type: "git";
+    repo: string;
+    ref?: string;
+    path?: string;
+    /**
+     * Skill directory name under `path`.
+     */
+    name?: string;
+};
+type InlineSkillEntry = {
+    type: "inline";
+    name: string;
+    description: string;
+    instructions: string;
+};
+type SkillEntry = SandboxSkillEntry | HostSkillEntry | GitSkillEntry | InlineSkillEntry;
+
+type ToolContext<TContext = Record<string, unknown>, Tools extends ToolSet = ToolSet> = ResolvableArgs<TContext, Tools>;
 declare const builtInTools: {
     Read: ai.Tool<{
         label: string;
@@ -238,11 +284,6 @@ type WorkflowRunLike = {
     }): ReadableStream;
 };
 
-type UpdateOptions<Tools extends ToolSet> = Partial<Omit<Session, "id" | "activeTools" | "model"> & {
-    model?: GatewayModelId;
-    activeTools?: (Extract<keyof Tools, string> | BuiltInToolName)[];
-}>;
-
 type ApprovalData = {
     approvalId: string;
     approved: boolean;
@@ -261,7 +302,7 @@ type SendInput<Tools extends ToolSet> = string | MessageData<Tools> | {
     type: "approval";
     approval: ApprovalData;
 };
-type SendOptions<Tools extends ToolSet, TContext> = {
+type SendOptions<TContext> = {
     interruptIfStreaming?: boolean | {
         lastPart: {
             index: number;
@@ -270,7 +311,8 @@ type SendOptions<Tools extends ToolSet, TContext> = {
     };
     context?: TContext;
     abortSignal?: AbortSignal;
-} & UpdateOptions<Tools>;
+    sandboxId?: string;
+};
 type SendResult = {
     assistantMessageId: string;
     done: true | Promise<true>;
@@ -283,14 +325,21 @@ type InterruptOptions = {
     };
 };
 
-type SessionDefaults<Tools extends ToolSet = ToolSet> = {
-    model?: GatewayModelId;
-    system?: string;
-    generation?: Session["generation"];
-    activeTools?: (Extract<keyof Tools, string> | BuiltInToolName)[];
-    skills?: SkillInput[];
+type ResolvableArgs<TContext = Record<string, unknown>, Tools extends ToolSet = ToolSet> = {
+    context: TContext;
+    sessionId: string;
+    sandbox: SandboxInstance;
+    messages: UIMessage<unknown, AgentDataTypes, InferUITools<Tools>>[];
+};
+type Resolvable<T, TContext = Record<string, unknown>, Tools extends ToolSet = ToolSet> = T | ((args: ResolvableArgs<TContext, Tools>) => T | Promise<T>);
+type SessionDefaults<Tools extends ToolSet = ToolSet, TContext extends Record<string, unknown> = Record<string, unknown>> = {
+    model?: Resolvable<GatewayModelId | undefined, TContext, Tools>;
+    system?: Resolvable<string | string[] | undefined, TContext, Tools>;
+    generation?: Resolvable<GenerationOptions | undefined, TContext, Tools>;
+    activeTools?: Resolvable<readonly (Extract<keyof Tools, string> | BuiltInToolName)[] | undefined, TContext, Tools>;
+    skills?: Resolvable<SkillInput[] | undefined, TContext, Tools>;
 };
-type AgentOptions<Tools extends ToolSet = any, TSandboxBindings extends SandboxBinding | SandboxBinding[] = SandboxBinding, TContext extends Record<string, unknown> = Record<string, never>> = SessionDefaults<Tools> & {
+type AgentOptions<Tools extends ToolSet = any, TSandboxBindings extends SandboxBinding | SandboxBinding[] = SandboxBinding, TContext extends Record<string, unknown> = Record<string, never>> = SessionDefaults<Tools, TContext> & {
     storage?: StorageInput;
     sandbox?: TSandboxBindings;
     tools?: Tools;
@@ -315,14 +364,13 @@ declare class Agent<TMessageMetadata = unknown, Tools extends ToolSet = ToolSet,
     private _resolvedStorage;
     get storage(): Storage;
     get tools(): typeof builtInTools & Tools;
-    get sessionDefaults(): SessionDefaults;
     get hooks(): AgentHooks;
     readonly session: (id?: string | {
         id?: string;
     } | undefined) => {
         id: string;
-        send: (input: SendInput<Tools> | SendInput<Tools>[], opts?: SendOptions<Tools, TContext> | undefined) => Promise<SendResult>;
-        stream: (runOrOpts?: WorkflowRunLike | StreamOptions | undefined) => Promise<ReadableStream<ai.UIMessageChunk>>;
+        send: (input: SendInput<Tools> | SendInput<Tools>[], opts?: SendOptions<TContext> | undefined) => Promise<SendResult>;
+        stream: (runOrOpts?: StreamOptions | WorkflowRunLike | undefined) => Promise<ReadableStream<ai.UIMessageChunk>>;
         history: () => Promise<{
             messages: UIMessage<unknown, AgentDataTypes, InferUITools<Tools>>[];
             streamingMessageId: string | null;
@@ -330,10 +378,53 @@ declare class Agent<TMessageMetadata = unknown, Tools extends ToolSet = ToolSet,
         }>;
         interrupt: (opts?: InterruptOptions | undefined) => Promise<void>;
         usage: () => Promise<SessionUsage>;
-        update: (opts: Partial<Omit<Session, "id" | "model" | "activeTools"> & {
-            model?: GatewayModelId;
-            activeTools?: ("Read" | "Grep" | "List" | "Write" | "Edit" | "Bash" | "Skill" | "JavaScript" | Extract<keyof Tools, string>)[] | undefined;
-        }>) => Promise<void>;
+        update: (opts: Partial<Omit<Session, "id" | "createdAt" | "updatedAt">>) => Promise<void>;
+        sandbox: {
+            setup: (opts?: SetupOpts<TSandboxBindings> | undefined) => Promise<SetupResult>;
+            exec: (opts: {
+                command: string;
+                args?: string[];
+                cwd?: string;
+                env?: Record<string, string>;
+                sudo?: boolean;
+                signal?: AbortSignal;
+            }) => Promise<ExecResult>;
+            stop: (opts?: {
+                signal?: AbortSignal;
+            } | undefined) => Promise<void>;
+            snapshot: (opts?: {
+                signal?: AbortSignal;
+            } | undefined) => Promise<{
+                snapshotId: string;
+            }>;
+            getDomain: (opts: {
+                port: number;
+                signal?: AbortSignal;
+            }) => Promise<string>;
+            getStatus: (opts?: {
+                signal?: AbortSignal;
+            } | undefined) => Promise<"pending" | "running" | "stopping" | "stopped" | "failed">;
+            kill: (opts: {
+                commandId: string;
+                signal?: AbortSignal;
+            }) => Promise<void>;
+            readFile: (opts: {
+                path: string;
+                signal?: AbortSignal;
+            }) => Promise<Buffer | null>;
+            start: (opts?: {
+                signal?: AbortSignal;
+            } | undefined) => Promise<void>;
+            updateNetworkPolicy: (opts: {
+                policy: _vercel_sandbox.NetworkPolicy;
+                signal?: AbortSignal;
+            }) => Promise<_vercel_sandbox.NetworkPolicy>;
+            writeFiles: (opts: {
+                files: UploadableFile[];
+                destPath: string;
+                signal?: AbortSignal;
+            }) => Promise<void>;
+        };
     };
     readonly sandbox: (id?: string | SandboxOptions | undefined) => {
         id: string;
@@ -407,4 +498,4 @@ declare const MessageNotFoundError_base: errore.FactoryTaggedErrorClass<"Message
 declare class MessageNotFoundError extends MessageNotFoundError_base {
 }
 
-export { type AgentDataTypes, type AgentHooks, type AgentOptions, AgentStatus, type AnyAgent, type ApprovalData, type BuiltInToolName, ExecResult, type InferSession, type InferUIMessage, MessageNotFoundError, type NeedsApprovalMap, SandboxBinding, SandboxError, SandboxInstance, SandboxNotFoundError, SandboxSetupFields, type SendInput, type SessionDefaults, SessionNotFoundError, type SessionSendArgs, SkillInput, type StepUsage, StorageConflictError, StorageError, type ToolContext, UploadableFile, type UsageSummary, type WorkflowRunLike, agent, builtinToolNames };
+export { type AgentDataTypes, type AgentHooks, type AgentOptions, AgentStatus, type AnyAgent, type ApprovalData, type BuiltInToolName, ExecResult, type GitSkillEntry, type GitSkillInput, type HostSkillEntry, type HostSkillInput, type InferSession, type InferUIMessage, type InlineSkillEntry, type InlineSkillInput, MessageNotFoundError, type NeedsApprovalMap, type Resolvable, type ResolvableArgs, SandboxBinding, SandboxError, SandboxInstance, SandboxNotFoundError, SandboxSetupFields, type SandboxSkillEntry, type SandboxSkillInput, type SendInput, type SessionDefaults, SessionNotFoundError, type SessionSendArgs, type SkillEntry, type SkillInput, type SkillSourceType, type StepUsage, StorageConflictError, StorageError, type ToolContext, UploadableFile, type UsageSummary, type WorkflowRunLike, agent, builtinToolNames };