@deepagents/context 7.10.2 → 7.12.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,8 +1,8 @@
1
- import { type BashToolkit, type CreateBashToolOptions } from './types.ts';
1
+ import { type BashToolkit, type CreateBashToolOptions, type SandboxSession } from './types.ts';
2
2
  /**
3
3
  * Build the DeepAgents-owned bash/readFile/writeFile toolkit around a sandbox.
4
4
  * The sandbox provides isolation and execution; these tools only translate AI
5
5
  * SDK tool calls into that backend contract.
6
6
  */
7
- export declare function createBashTool(options: CreateBashToolOptions): Promise<BashToolkit>;
7
+ export declare function createBashTool<SANDBOX extends SandboxSession>(options: CreateBashToolOptions<SANDBOX>): Promise<BashToolkit<SANDBOX>>;
8
8
  //# sourceMappingURL=bash-tool.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"bash-tool.d.ts","sources":["../../../src/lib/sandbox/bash-tool.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,KAAK,WAAW,EAEhB,KAAK,qBAAqB,EAI3B,MAAM,YAAY,CAAC;AAoGpB;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,WAAW,CAAC,CA8HtB"}
1
+ {"version":3,"file":"bash-tool.d.ts","sources":["../../../src/lib/sandbox/bash-tool.ts"],"names":[],"mappings":"AAaA,OAAO,EAEL,KAAK,WAAW,EAEhB,KAAK,qBAAqB,EAC1B,KAAK,cAAc,EAGpB,MAAM,YAAY,CAAC;AAoGpB;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,OAAO,SAAS,cAAc,EACjE,OAAO,EAAE,qBAAqB,CAAC,OAAO,CAAC,GACtC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CA8H/B"}
@@ -55,6 +55,19 @@ export interface SandboxNamedVolume {
55
55
  removeOnDispose?: boolean;
56
56
  }
57
57
  export type SandboxVolume = SandboxBindVolume | SandboxNamedVolume;
58
+ /** A named volume that exists before the sandbox. The framework never creates or removes it. */
59
+ export interface SandboxExternalVolume {
60
+ type: 'volume';
61
+ lifecycle?: 'external';
62
+ name: string;
63
+ containerPath: string;
64
+ /** Default: `true`. */
65
+ readOnly?: boolean;
66
+ subPath?: string;
67
+ noCopy?: boolean;
68
+ }
69
+ /** What a chat sandbox mounts: its durable files live in volumes the host provides. */
70
+ export type ChatSandboxVolume = SandboxBindVolume | SandboxExternalVolume;
58
71
  /**
59
72
  * The options the shared skeleton is allowed to read. Each engine extends this
60
73
  * with its own dialect knobs (Docker's `container` create body; Apple's `arch`),
@@ -195,4 +208,29 @@ export interface ContainerEngine<TOpts extends CommonSandboxOptions = CommonSand
195
208
  /** Releases what the engine holds, such as its connection. */
196
209
  dispose(): Promise<void>;
197
210
  }
211
+ /** The container of a chat, which the engine keeps when it stops. */
212
+ export interface ChatEngineContainer extends EngineContainer {
213
+ /**
214
+ * Makes this container run: starts it when it is stopped, unpauses it when
215
+ * it is paused. Rejects with `SandboxNotFoundError` when it is gone, or when
216
+ * another container now has its name. Never creates one.
217
+ */
218
+ resume(): Promise<void>;
219
+ /** Removes it, running or not, with its anonymous volumes. Resolves when it is gone. */
220
+ remove(): Promise<void>;
221
+ }
222
+ /** An engine that runs the containers of chats beside one-off containers. */
223
+ export interface ChatContainerEngine<TOpts extends CommonSandboxOptions = CommonSandboxOptions> extends ContainerEngine<TOpts> {
224
+ /** The container named `name`, as it is; `undefined` when there is none. */
225
+ find(name: string): Promise<ChatEngineContainer | undefined>;
226
+ /**
227
+ * Creates and starts the chat container `name`, kept when it stops and
228
+ * marked with `labels`. `created: false` gives the container that another
229
+ * caller made under the name, which may not run yet.
230
+ */
231
+ createChat(image: string, name: string, opts: TOpts, workdir: string, labels: Record<string, string>): Promise<{
232
+ created: boolean;
233
+ container: ChatEngineContainer;
234
+ }>;
235
+ }
198
236
  //# sourceMappingURL=container-engine.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"container-engine.d.ts","sources":["../../../src/lib/sandbox/container-engine.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"container-engine.d.ts","sources":["../../../src/lib/sandbox/container-engine.ts"],"names":[],"mappings":"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"}
@@ -1,6 +1,6 @@
1
- import type { CommonSandboxOptions, ContainerEngine, ContainerErrorFactory, EngineContainer, SandboxVolume } from './container-engine.ts';
1
+ import type { ChatContainerEngine, ChatEngineContainer, CommonSandboxOptions, ContainerEngine, ContainerErrorFactory, EngineContainer, SandboxVolume } from './container-engine.ts';
2
2
  import { type Installer } from './installers/installer.ts';
3
- import type { DisposableSandbox } from './types.ts';
3
+ import { type DisposableSandbox } from './types.ts';
4
4
  /**
5
5
  * A container the strategy runs in, and whether an earlier caller created it.
6
6
  * An attached container is borrowed: the sandbox never stops it.
@@ -23,19 +23,26 @@ export declare function validateSandboxOptions(opts: CommonSandboxOptions, error
23
23
  * {@link CommonSandboxOptions} so the skeleton can never read an engine-only
24
24
  * knob.
25
25
  */
26
- export declare abstract class ContainerSandboxStrategy<TOpts extends CommonSandboxOptions = CommonSandboxOptions> {
27
- protected engine: ContainerEngine<TOpts>;
26
+ export declare abstract class ContainerSandboxStrategy<TOpts extends CommonSandboxOptions = CommonSandboxOptions, TEngine extends ContainerEngine<TOpts> = ContainerEngine<TOpts>> {
27
+ protected engine: TEngine;
28
28
  protected opts: TOpts;
29
29
  protected volumes: SandboxVolume[];
30
30
  protected name?: string;
31
31
  protected workdir: string;
32
32
  private createdVolumes;
33
- constructor(opts: TOpts, engine: ContainerEngine<TOpts>);
33
+ constructor(opts: TOpts, engine: TEngine);
34
34
  /**
35
35
  * Creates the sandbox. On failure, everything it made is released and the
36
36
  * engine is disposed.
37
37
  */
38
38
  create(): Promise<DisposableSandbox>;
39
+ /**
40
+ * The running chat container `name`: unpaused or started when it exists,
41
+ * created with `labels` and configured when it does not. A create that
42
+ * another caller won takes the winner's container. A container this call
43
+ * created and could not configure is removed. The engine stays open.
44
+ */
45
+ openChat(this: ContainerSandboxStrategy<TOpts, ChatContainerEngine<TOpts>>, name: string, labels: Record<string, string>): Promise<ChatEngineContainer>;
39
46
  protected containerName(): string;
40
47
  protected acquireContainer(image: string): Promise<AcquiredContainer>;
41
48
  private waitForRacedContainer;
@@ -55,10 +62,10 @@ export declare abstract class ContainerSandboxStrategy<TOpts extends CommonSandb
55
62
  * both engines — the post-start installer context comes from the engine's
56
63
  * container, so the same class drives Docker and Apple `container` installs.
57
64
  */
58
- export declare class RuntimeStrategy<TOpts extends CommonSandboxOptions = CommonSandboxOptions> extends ContainerSandboxStrategy<TOpts> {
65
+ export declare class RuntimeStrategy<TOpts extends CommonSandboxOptions = CommonSandboxOptions, TEngine extends ContainerEngine<TOpts> = ContainerEngine<TOpts>> extends ContainerSandboxStrategy<TOpts, TEngine> {
59
66
  private image;
60
67
  private installers;
61
- constructor(opts: TOpts, engine: ContainerEngine<TOpts>, mode: {
68
+ constructor(opts: TOpts, engine: TEngine, mode: {
62
69
  image: string;
63
70
  installers: Installer[];
64
71
  });
@@ -71,12 +78,12 @@ export declare class RuntimeStrategy<TOpts extends CommonSandboxOptions = Common
71
78
  * computation and existence check are common; only the build dialect differs.
72
79
  * Runs no post-start configuration — the Dockerfile defines the image.
73
80
  */
74
- export declare class ContainerfileStrategy<TOpts extends CommonSandboxOptions = CommonSandboxOptions> extends ContainerSandboxStrategy<TOpts> {
81
+ export declare class ContainerfileStrategy<TOpts extends CommonSandboxOptions = CommonSandboxOptions, TEngine extends ContainerEngine<TOpts> = ContainerEngine<TOpts>> extends ContainerSandboxStrategy<TOpts, TEngine> {
75
82
  private dockerfile;
76
83
  private dockerContext;
77
84
  private showBuildLogs;
78
85
  private identity?;
79
- constructor(opts: TOpts, engine: ContainerEngine<TOpts>, mode: {
86
+ constructor(opts: TOpts, engine: TEngine, mode: {
80
87
  dockerfile: string;
81
88
  context: string;
82
89
  showBuildLogs: boolean;
@@ -1 +1 @@
1
- {"version":3,"file":"container-sandbox.d.ts","sources":["../../../src/lib/sandbox/container-sandbox.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"container-sandbox.d.ts","sources":["../../../src/lib/sandbox/container-sandbox.ts"],"names":[],"mappings":"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"}
@@ -1,6 +1,6 @@
1
1
  import { type Experimental_SandboxFileStat } from '@ai-sdk/provider-utils';
2
- import type { ContainerErrorFactory, EngineContainer, EngineProcess } from './container-engine.ts';
3
- import type { CommandResult, DisposableSandbox } from './types.ts';
2
+ import type { ChatEngineContainer, ContainerErrorFactory, EngineContainer, EngineProcess } from './container-engine.ts';
3
+ import type { ChatSandbox, CommandResult, DisposableSandbox } from './types.ts';
4
4
  export declare const FILE_STAT_TYPES: readonly ["file", "directory", "other"];
5
5
  /** The stat of `path` through a command, for what no engine request reaches. */
6
6
  export declare function statOverExec(container: Pick<EngineContainer, 'exec'>, path: string, signal: AbortSignal | undefined): Promise<Experimental_SandboxFileStat | null>;
@@ -16,4 +16,10 @@ export declare function validateEnv(env: Record<string, string> | undefined, err
16
16
  * gives. Disposal is added by the strategy that owns the container.
17
17
  */
18
18
  export declare function containerSession(container: EngineContainer, errors: ContainerErrorFactory): Omit<DisposableSandbox, 'dispose' | typeof Symbol.asyncDispose>;
19
+ /**
20
+ * The handle of a chat's container: its session, `resume`, and a `close` that
21
+ * runs `release` once and never touches the container. Once closed, every
22
+ * operation rejects with an error that names the chat.
23
+ */
24
+ export declare function chatContainerSandbox(container: ChatEngineContainer, errors: ContainerErrorFactory, chatId: string, release: () => Promise<void>): ChatSandbox;
19
25
  //# sourceMappingURL=container-session.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"container-session.d.ts","sources":["../../../src/lib/sandbox/container-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,4BAA4B,EAOlC,MAAM,wBAAwB,CAAC;AAKhC,OAAO,KAAK,EACV,qBAAqB,EACrB,eAAe,EACf,aAAa,EAEd,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAUnE,eAAO,MAAM,eAAe,yCAIwC,CAAC;AAkFrE,gFAAgF;AAChF,wBAAsB,YAAY,CAChC,SAAS,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,EACxC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAiB9C;AAED,iFAAiF;AACjF,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,EACxC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAY5B;AAED,2EAA2E;AAC3E,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,EACxC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,IAAI,CAAC,CAef;AAoDD,kCAAkC;AAClC,wBAAsB,aAAa,CACjC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,CAAC,CAOxB;AAkFD,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACvC,MAAM,EAAE,qBAAqB,GAC5B,IAAI,CAMN;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,eAAe,EAC1B,MAAM,EAAE,qBAAqB,GAC5B,IAAI,CAAC,iBAAiB,EAAE,SAAS,GAAG,OAAO,MAAM,CAAC,YAAY,CAAC,CAsGjE"}
1
+ {"version":3,"file":"container-session.d.ts","sources":["../../../src/lib/sandbox/container-session.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,4BAA4B,EAOlC,MAAM,wBAAwB,CAAC;AAKhC,OAAO,KAAK,EACV,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,aAAa,EAEd,MAAM,uBAAuB,CAAC;AAG/B,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAUhF,eAAO,MAAM,eAAe,yCAIwC,CAAC;AAkFrE,gFAAgF;AAChF,wBAAsB,YAAY,CAChC,SAAS,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,EACxC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAiB9C;AAED,iFAAiF;AACjF,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,EACxC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAY5B;AAED,2EAA2E;AAC3E,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,EACxC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,IAAI,CAAC,CAef;AA0DD,kCAAkC;AAClC,wBAAsB,aAAa,CACjC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,CAAC,CAOxB;AA0FD,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EACvC,MAAM,EAAE,qBAAqB,GAC5B,IAAI,CAMN;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,eAAe,EAC1B,MAAM,EAAE,qBAAqB,GAC5B,IAAI,CAAC,iBAAiB,EAAE,SAAS,GAAG,OAAO,MAAM,CAAC,YAAY,CAAC,CAsGjE;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,mBAAmB,EAC9B,MAAM,EAAE,qBAAqB,EAC7B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAC3B,WAAW,CA8Bb"}
@@ -1,9 +1,9 @@
1
1
  import type { Experimental_SandboxFileStat } from '@ai-sdk/provider-utils';
2
- import { type Container, Docker, type EngineApi, type Environment } from '@zukhruf/docker';
3
- import type { CommonSandboxOptions, ContainerEngine, ContainerErrorFactory, EngineContainer, EngineExecOptions, EngineProcess, EngineSpawnOptions, ImageBuildSpec, RunResult, SandboxNamedVolume, SandboxVolume } from './container-engine.ts';
2
+ import { type Container, type Containers, Docker, type EngineApi, type Environment } from '@zukhruf/docker';
3
+ import type { ChatContainerEngine, ChatEngineContainer, ChatSandboxVolume, CommonSandboxOptions, ContainerErrorFactory, EngineContainer, EngineExecOptions, EngineProcess, EngineSpawnOptions, ImageBuildSpec, RunResult, SandboxNamedVolume, SandboxVolume } from './container-engine.ts';
4
4
  import { type AcquiredContainer, ContainerSandboxStrategy } from './container-sandbox.ts';
5
5
  import { type Installer, type InstallerContext } from './installers/installer.ts';
6
- import { type CommandResult, type DisposableSandbox } from './types.ts';
6
+ import { type ChatSandbox, type CommandResult, type DisposableSandbox, type SandboxContext, type StoppableSandboxEnvironment } from './types.ts';
7
7
  export type { SandboxBindVolume as DockerBindVolume, SandboxNamedVolume as DockerNamedVolume, SandboxVolume as DockerSandboxVolume, } from './container-engine.ts';
8
8
  export { ComposeStartError, ContainerCreationError, DockerNotAvailableError, DockerSandboxError, DockerfileBuildError, type InstallErrorOptions, type InstallKind, InstallError, MissingRuntimeError, PackageInstallError, VolumeCreateError, VolumeInspectError, VolumePathError, VolumeRemoveError, } from './docker-sandbox-errors.ts';
9
9
  /**
@@ -98,6 +98,14 @@ declare class DockerContainer implements EngineContainer {
98
98
  installerContext(image: string): InstallerContext;
99
99
  stop(): Promise<void>;
100
100
  }
101
+ /** The container of a chat, which the engine keeps when it stops. */
102
+ declare class DockerChatContainer extends DockerContainer implements ChatEngineContainer {
103
+ #private;
104
+ constructor(name: string, container: Container, layout: FileLayout, commandTimeout: number | undefined, containers: Containers);
105
+ /** Inspects by name, so a container that now has the name is not this one. */
106
+ resume(): Promise<void>;
107
+ remove(): Promise<void>;
108
+ }
101
109
  /**
102
110
  * The Docker engine, reached through the Engine API of `@zukhruf/docker`. It
103
111
  * selects the engine that the Docker CLI selects (`DOCKER_HOST`,
@@ -105,7 +113,7 @@ declare class DockerContainer implements EngineContainer {
105
113
  * does for the CLI. Image builds and Compose stay on the CLI, sent to the same
106
114
  * engine through `docker.cliEnvironment`.
107
115
  */
108
- export declare class DockerEngine implements ContainerEngine<DockerCommonOptions> {
116
+ export declare class DockerEngine implements ChatContainerEngine<DockerCommonOptions> {
109
117
  #private;
110
118
  readonly bindMountsOnClient = false;
111
119
  readonly defaultImage = "bash:5.3-alpine3.24";
@@ -121,6 +129,11 @@ export declare class DockerEngine implements ContainerEngine<DockerCommonOptions
121
129
  static connect(environment: Environment, commandTimeout: number | undefined): Promise<DockerEngine>;
122
130
  /** A sandbox container handle for a container of this engine. */
123
131
  container(name: string, container: Container, info: EngineApi.ContainerInspectResponse): DockerContainer;
132
+ find(name: string): Promise<DockerChatContainer | undefined>;
133
+ createChat(image: string, name: string, opts: DockerCommonOptions, workdir: string, labels: Record<string, string>): Promise<{
134
+ created: boolean;
135
+ container: DockerChatContainer;
136
+ }>;
124
137
  attach(name: string, image: string): Promise<DockerContainer | undefined>;
125
138
  run(image: string, name: string, opts: DockerCommonOptions, workdir: string): Promise<RunResult>;
126
139
  volumeExists(name: string): Promise<boolean>;
@@ -154,6 +167,59 @@ export declare class ComposeStrategy extends ContainerSandboxStrategy<DockerComm
154
167
  protected configure(): Promise<void>;
155
168
  protected release(): Promise<void>;
156
169
  }
170
+ /**
171
+ * The create body that a chat container passes through. The environment also
172
+ * owns `HostConfig.Init`, and `Labels` get the chat's labels, which win.
173
+ */
174
+ export type DockerChatContainerConfig = Omit<DockerContainerConfig, 'HostConfig'> & {
175
+ HostConfig?: Omit<NonNullable<DockerContainerConfig['HostConfig']>, 'Init'>;
176
+ };
177
+ /** What a chat environment takes beside a backend's options. */
178
+ interface DockerChatOptions {
179
+ /**
180
+ * With a chat's id, names that chat's container. Two environments with the
181
+ * same namespace on one engine reach the same containers; give each app or
182
+ * deployment its own.
183
+ */
184
+ namespace: string;
185
+ /**
186
+ * The volumes of a chat's container, given when `open` creates it. Its
187
+ * durable files belong here: the rest is lost when the container is deleted.
188
+ */
189
+ volumes?: (chat: SandboxContext) => ChatSandboxVolume[];
190
+ container?: DockerChatContainerConfig;
191
+ }
192
+ type ChatEnvironmentBase<T extends DockerCommonOptions> = Omit<T, 'volumes' | 'name' | 'container'> & DockerChatOptions;
193
+ /**
194
+ * The options of a {@link DockerSandboxEnvironment}: an image, or a Dockerfile
195
+ * that builds one. A chat container has no installers: a second worker could
196
+ * attach to it before they finish, so what it needs belongs in its image.
197
+ */
198
+ export type DockerSandboxEnvironmentOptions = (ChatEnvironmentBase<Omit<RuntimeSandboxOptions, 'installers'>> & {
199
+ dockerfile?: never;
200
+ }) | (ChatEnvironmentBase<DockerfileSandboxOptions> & {
201
+ image?: never;
202
+ });
203
+ /**
204
+ * Chat containers on the Docker engine that `environment` selects
205
+ * (`DOCKER_HOST`, a context, `ssh://`). A chat's container is named from the
206
+ * namespace and the chat's id, and carries the labels
207
+ * `deepagents.sandbox.namespace` and `deepagents.sandbox.chat`. It has no
208
+ * AutoRemove, so `stop` (`docker stop`) keeps it and its files, and the next
209
+ * `open` or `resume` starts it; `delete` is `docker rm -f`. Its PID 1 is the
210
+ * engine's init, which reaps what killed commands leave behind. The open
211
+ * handles share one engine client, which the first `open` connects and the
212
+ * last `close` closes.
213
+ */
214
+ export declare class DockerSandboxEnvironment implements StoppableSandboxEnvironment {
215
+ #private;
216
+ constructor(options: DockerSandboxEnvironmentOptions);
217
+ open(chat: SandboxContext): Promise<ChatSandbox>;
218
+ /** `docker stop` with the engine's grace, which the init cuts short. */
219
+ stop(chat: SandboxContext): Promise<void>;
220
+ /** `docker rm -f` with the container's anonymous volumes; named volumes stay. */
221
+ delete(chat: SandboxContext): Promise<void>;
222
+ }
157
223
  /**
158
224
  * Create a Docker-backed sandbox.
159
225
  *
@@ -1 +1 @@
1
- {"version":3,"file":"docker-sandbox.d.ts","sources":["../../../src/lib/sandbox/docker-sandbox.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EAGL,KAAK,SAAS,EAGd,MAAM,EAGN,KAAK,SAAS,EACd,KAAK,WAAW,EAMjB,MAAM,iBAAiB,CAAC;AAMzB,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,iBAAiB,EACjB,aAAa,EAEb,kBAAkB,EAClB,cAAc,EACd,SAAS,EAET,kBAAkB,EAClB,aAAa,EACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,KAAK,iBAAiB,EACtB,wBAAwB,EAIzB,MAAM,wBAAwB,CAAC;AAiBhC,OAAO,EACL,KAAK,SAAS,EACd,KAAK,gBAAgB,EAEtB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EAEvB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,iBAAiB,IAAI,gBAAgB,EACrC,kBAAkB,IAAI,iBAAiB,EACvC,aAAa,IAAI,mBAAmB,GACrC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,uBAAuB,EACvB,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,WAAW,EAChB,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,GAClB,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;GAOG;AACH,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,SAAS,CAAC,sBAAsB,EAChC,OAAO,GAAG,YAAY,GAAG,KAAK,GAAG,KAAK,GAAG,YAAY,CACtD,GAAG;IACF,UAAU,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,YAAY,GAAG,QAAQ,CAAC,CAAC;CAClE,CAAC;AAEF,2EAA2E;AAC3E,MAAM,WAAW,mBAAoB,SAAQ,oBAAoB;IAC/D;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,yFAAyF;IACzF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,SAAS,CAAC,EAAE,qBAAqB,CAAC;CACnC;AAED,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,wBAAyB,SAAQ,mBAAmB;IACnE,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,yFAAyF;IACzF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,oBAAoB,GAC9B,qBAAqB,GAAG,wBAAwB,GAAG,qBAAqB,CAAC;AAE3E,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,oBAAoB,GACzB,IAAI,IAAI,wBAAwB,CAElC;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,oBAAoB,GACzB,IAAI,IAAI,qBAAqB,CAE/B;AAoID,oEAAoE;AACpE,UAAU,UAAU;IAClB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAiCD,gDAAgD;AAChD,cAAM,eAAgB,YAAW,eAAe;;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAK5C,YACE,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,SAAS,EACpB,MAAM,EAAE,UAAU,EAClB,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,UAAU,EAAE,OAAO,EAQpB;IAoBK,IAAI,CACR,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,aAAa,CAAC,CAgBxB;IAEK,KAAK,CACT,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,aAAa,CAAC,CAUxB;IAwCK,QAAQ,CACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAM5B;IA2BK,IAAI,CACR,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAc9C;IAEK,SAAS,CACb,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,IAAI,CAAC,CAqBf;IAED,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAUhD;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAc1B;CACF;AAED;;;;;;GAMG;AACH,qBAAa,YAAa,YAAW,eAAe,CAAC,mBAAmB,CAAC;;IACvE,QAAQ,CAAC,kBAAkB,SAAS;IACpC,QAAQ,CAAC,YAAY,yBAAyB;IAC9C,QAAQ,CAAC,MAAM,wBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC;IAGnC,OAAO,eAIN;IAED;;;OAGG;IACH,OAAa,OAAO,CAClB,WAAW,EAAE,WAAW,EACxB,cAAc,EAAE,MAAM,GAAG,SAAS,GACjC,OAAO,CAAC,YAAY,CAAC,CASvB;IAED,iEAAiE;IACjE,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,SAAS,CAAC,wBAAwB,GACvC,eAAe,CAQjB;IAEK,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAQtC;IAEK,GAAG,CACP,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,CAAC,CAapB;IA2DK,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAYjD;IAEK,YAAY,CAChB,MAAM,EAAE,kBAAkB,EAC1B,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC,CAqBf;IAEK,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS9C;IAEK,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAG;IAEjC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAE/C;IAED,iEAAiE;IAC3D,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA6BpD;IAED,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAEvB;CACF;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,SAAQ,wBAAwB,CAAC,mBAAmB,CAAC;IAChF,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAe;IAEnC,YAAY,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,YAAY,EAM1D;IAED,OAAO,CAAC,OAAO;IAQf,UAAgB,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAE1C;IAED,UAAyB,gBAAgB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAoCtE;IAED,UAAgB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAEzC;IAED,UAAyB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAGhD;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,iBAAiB,CAAC,CAiC5B;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,OAAO,EAAE,oBAAoB,EAC7B,EAAE,EAAE,CAAC,OAAO,EAAE,iBAAiB,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7C,OAAO,CAAC,CAAC,CAAC,CAIZ"}
1
+ {"version":3,"file":"docker-sandbox.d.ts","sources":["../../../src/lib/sandbox/docker-sandbox.ts"],"names":[],"mappings":"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"}
@@ -1,6 +1,6 @@
1
- import type { DisposableSandbox, ReadFileTool } from '../types.ts';
1
+ import type { ReadFileTool, SandboxSession } from '../types.ts';
2
2
  export declare function createReadFileTool({ sandbox, workingDirectory, }: {
3
- sandbox: DisposableSandbox;
3
+ sandbox: SandboxSession;
4
4
  workingDirectory: string | undefined;
5
5
  }): ReadFileTool;
6
6
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sources":["../../../../src/lib/sandbox/read-file-tool/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAgCnE,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,gBAAgB,GACjB,EAAE;IACD,OAAO,EAAE,iBAAiB,CAAC;IAC3B,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,GAAG,YAAY,CAiCf"}
1
+ {"version":3,"file":"index.d.ts","sources":["../../../../src/lib/sandbox/read-file-tool/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAgChE,wBAAgB,kBAAkB,CAAC,EACjC,OAAO,EACP,gBAAgB,GACjB,EAAE;IACD,OAAO,EAAE,cAAc,CAAC;IACxB,gBAAgB,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,GAAG,YAAY,CAiCf"}
@@ -1,5 +1,9 @@
1
1
  import { type Experimental_SandboxProcess } from '@ai-sdk/provider-utils';
2
- import type { CommandResult, DisposableSandbox } from './types.ts';
2
+ import type { CommandResult, DisposableSandbox, SandboxContext } from './types.ts';
3
+ /** The native name of a chat's sandbox: one per namespace and chat, valid on every backend. */
4
+ export declare function chatSandboxName(namespace: string, chat: SandboxContext): string;
5
+ /** The labels every chat sandbox carries, so an operator or a test finds it by chat. */
6
+ export declare function chatSandboxLabels(namespace: string, chat: SandboxContext): Record<string, string>;
3
7
  /**
4
8
  * `path` against `directory` when it is relative. Joined, not normalized, so
5
9
  * that `link/..` follows the link, as it does in a command.
@@ -1 +1 @@
1
- {"version":3,"file":"session.d.ts","sources":["../../../src/lib/sandbox/session.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,2BAA2B,EAEjC,MAAM,wBAAwB,CAAC;AAIhC,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAcnE;;;GAGG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,0DAA0D;AAC1D,wBAAgB,SAAS,CAAC,EACxB,cAAc,EACd,eAAe,GAChB,EAAE,IAAI,CAAC,iBAAiB,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,GAAG,IAAI,CACrE,iBAAiB,EACjB,cAAc,GAAG,eAAe,CACjC,CAiBA;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,IAAI,EAAE,IAAI,EACV,WAAW,GACZ,EAAE;IACD,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,WAAW,EAAE,WAAW,GAAG,SAAS,CAAC;CACtC,GAAG;IACF,IAAI,EAAE,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B,CAmBA;AAED,+DAA+D;AAC/D,wBAAsB,OAAO,CAC3B,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,aAAa,CAAC,CAOxB;AAED,UAAU,YAAY;IACpB,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACnC,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,KAAK,IAAI,IAAI,CAAC;IACd,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAkCjD"}
1
+ {"version":3,"file":"session.d.ts","sources":["../../../src/lib/sandbox/session.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,2BAA2B,EAEjC,MAAM,wBAAwB,CAAC;AAKhC,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,cAAc,EACf,MAAM,YAAY,CAAC;AAMpB,+FAA+F;AAC/F,wBAAgB,eAAe,CAC7B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,cAAc,GACnB,MAAM,CAER;AAED,wFAAwF;AACxF,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,cAAc,GACnB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKxB;AAUD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,0DAA0D;AAC1D,wBAAgB,SAAS,CAAC,EACxB,cAAc,EACd,eAAe,GAChB,EAAE,IAAI,CAAC,iBAAiB,EAAE,gBAAgB,GAAG,iBAAiB,CAAC,GAAG,IAAI,CACrE,iBAAiB,EACjB,cAAc,GAAG,eAAe,CACjC,CAiBA;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,IAAI,EAAE,IAAI,EACV,WAAW,GACZ,EAAE;IACD,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,WAAW,EAAE,WAAW,GAAG,SAAS,CAAC;CACtC,GAAG;IACF,IAAI,EAAE,2BAA2B,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B,CAmBA;AAED,+DAA+D;AAC/D,wBAAsB,OAAO,CAC3B,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,aAAa,CAAC,CAOxB;AAED,UAAU,YAAY;IACpB,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IACnC,OAAO,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;IACjC,KAAK,IAAI,IAAI,CAAC;IACd,KAAK,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAkCjD"}
@@ -12,12 +12,16 @@ export interface CommandResult {
12
12
  }>;
13
13
  }
14
14
  /**
15
- * The AI SDK sandbox session plus the lifecycle the session contract leaves to
16
- * its owner. `run` may return {@link CommandResult}'s host-only fields; a value
17
- * of this type is still a valid `Experimental_SandboxSession`.
15
+ * What every sandbox offers its user: the AI SDK sandbox session, whose `run`
16
+ * may also return {@link CommandResult}'s host-only fields. A value of this
17
+ * type is a valid `Experimental_SandboxSession`. It has no lifecycle: who ends
18
+ * a sandbox, and how, depends on how it was made.
18
19
  */
19
- export interface DisposableSandbox extends Omit<Experimental_SandboxSession, 'run'>, AsyncDisposable {
20
+ export interface SandboxSession extends Omit<Experimental_SandboxSession, 'run'> {
20
21
  readonly run: (options: Experimental_SandboxRunOptions) => PromiseLike<CommandResult>;
22
+ }
23
+ /** A sandbox from a `create*Sandbox` factory, which its owner disposes. */
24
+ export interface DisposableSandbox extends SandboxSession, AsyncDisposable {
21
25
  /**
22
26
  * Release what this sandbox created, and leave what it attached to (a
23
27
  * container, VM or remote sandbox it found by name or id). Called
@@ -25,21 +29,84 @@ export interface DisposableSandbox extends Omit<Experimental_SandboxSession, 'ru
25
29
  */
26
30
  dispose(): Promise<void>;
27
31
  }
32
+ /** The chat whose sandbox an environment opens, stops or deletes. */
33
+ export interface SandboxContext {
34
+ readonly chatId: string;
35
+ readonly userId: string;
36
+ }
37
+ /**
38
+ * A live handle to one chat's sandbox, from {@link SandboxEnvironment.open}.
39
+ * Other handles, in this process or another, can reach the same sandbox.
40
+ * Once {@link SandboxEnvironment.delete} removes the chat's sandbox, every
41
+ * operation of a handle opened before it (`run`, `spawn`, each file
42
+ * operation and `resume`) rejects with {@link SandboxNotFoundError}, also
43
+ * after the chat is opened again; the owner closes the handle and opens the
44
+ * chat again.
45
+ */
46
+ export interface ChatSandbox extends SandboxSession, AsyncDisposable {
47
+ /**
48
+ * Makes the sandbox this handle holds usable again: starts it when it is
49
+ * stopped, and resolves at once when it runs. Rejects with
50
+ * {@link SandboxNotFoundError} when the sandbox no longer exists, or when
51
+ * another sandbox now has its name; the owner then closes this handle and
52
+ * opens the chat again. Never creates a sandbox.
53
+ */
54
+ resume(): Promise<void>;
55
+ /**
56
+ * Releases what this process holds for the sandbox, such as the engine
57
+ * client or the VM connection. Never stops, starts or removes the sandbox.
58
+ * Runs once; `[Symbol.asyncDispose]` is the same call. Afterwards every
59
+ * operation of this handle rejects, and never with
60
+ * {@link SandboxNotFoundError}: using a closed handle is a bug in its
61
+ * owner, not a sandbox that is gone.
62
+ */
63
+ close(): Promise<void>;
64
+ }
65
+ /**
66
+ * Where the sandboxes of chats live: a backend's options and a namespace.
67
+ * Building one does no I/O. Each chat has one sandbox, which the backend
68
+ * names from the namespace and the chat's id; the caller never names it.
69
+ * Options apply only when `open` creates the sandbox: an existing sandbox
70
+ * keeps the configuration it was created with.
71
+ */
72
+ export interface SandboxEnvironment {
73
+ /**
74
+ * The chat's sandbox, live: attached when it runs, started when it is
75
+ * stopped, created when there is none. Two callers that open the same chat
76
+ * at once get the same sandbox.
77
+ */
78
+ open(chat: SandboxContext): Promise<ChatSandbox>;
79
+ /**
80
+ * Removes the chat's sandbox and everything in it outside its volumes.
81
+ * Never starts it, never touches a volume, and resolves when there is none.
82
+ */
83
+ delete(chat: SandboxContext): Promise<void>;
84
+ }
85
+ /** An environment whose sandboxes can stop and keep their files. */
86
+ export interface StoppableSandboxEnvironment extends SandboxEnvironment {
87
+ /**
88
+ * Stops the chat's sandbox and keeps its files, so the next `open` or
89
+ * `resume` starts it again. Never starts it; resolves when it is already
90
+ * stopped or there is none.
91
+ */
92
+ stop(chat: SandboxContext): Promise<void>;
93
+ }
28
94
  /**
29
95
  * The environment behind a sandbox no longer exists (its container was
30
96
  * removed), so every operation of that sandbox rejects with this error until
31
- * its owner acquires a new one by name. A failed command is not this error.
97
+ * its owner acquires a new one by name, or closes the handle and opens the
98
+ * chat again. A failed command is not this error.
32
99
  */
33
100
  export declare class SandboxNotFoundError extends Error {
34
101
  constructor(sandbox: string, options?: ErrorOptions);
35
102
  }
36
103
  /**
37
- * Readiness option accepted by every sandbox factory. Readiness is workload
38
- * policy supplied by the caller — the hook runs once after boot and gates the
39
- * factory's return; on failure the sandbox is disposed and the error
40
- * propagates, so callers either receive a sandbox that satisfies their
41
- * readiness condition or no sandbox at all. Recurring health monitoring stays
42
- * the caller's responsibility.
104
+ * Readiness option accepted by every sandbox factory and environment.
105
+ * Readiness is workload policy supplied by the caller. The hook runs once per
106
+ * `create` or `open`, so it must be safe to repeat, and gates its return; on
107
+ * failure the sandbox is released and the error propagates, so callers either
108
+ * receive a sandbox that satisfies their readiness condition or no sandbox at
109
+ * all. Recurring health monitoring stays the caller's responsibility.
43
110
  *
44
111
  * @example
45
112
  * ```typescript
@@ -50,7 +117,7 @@ export declare class SandboxNotFoundError extends Error {
50
117
  * ```
51
118
  */
52
119
  export interface SandboxReadinessOptions {
53
- readiness?: (sandbox: DisposableSandbox) => void | Promise<void>;
120
+ readiness?: (sandbox: SandboxSession) => void | Promise<void>;
54
121
  }
55
122
  /**
56
123
  * Input schema exposed by the bash tool. `reasoning` is required for an
@@ -89,8 +156,8 @@ export interface AfterBashCallOutput {
89
156
  result?: CommandResult;
90
157
  meta?: Record<string, unknown>;
91
158
  }
92
- export interface CreateBashToolOptions {
93
- sandbox: DisposableSandbox;
159
+ export interface CreateBashToolOptions<SANDBOX extends SandboxSession = SandboxSession> {
160
+ sandbox: SANDBOX;
94
161
  /**
95
162
  * Absolute directory every command starts in, created when the tool is created.
96
163
  * When omitted, commands run in the sandbox's default working directory and
@@ -129,12 +196,12 @@ export type BashToolkitTools = SandboxTools & {
129
196
  * model `tools` and the AI SDK `sandbox`; it calls no tool by name, so a host
130
197
  * that shows the model only bash passes `{ tools: { bash }, sandbox }`.
131
198
  */
132
- export interface AgentSandbox<TOOLS extends SandboxTools = SandboxTools> {
199
+ export interface AgentSandbox<TOOLS extends SandboxTools = SandboxTools, SANDBOX extends SandboxSession = SandboxSession> {
133
200
  tools: TOOLS;
134
- sandbox: DisposableSandbox;
201
+ sandbox: SANDBOX;
135
202
  }
136
203
  /** What `createBashTool` returns: every tool it builds, and its sandbox. */
137
- export interface BashToolkit extends AgentSandbox<BashToolkitTools> {
204
+ export interface BashToolkit<SANDBOX extends SandboxSession = SandboxSession> extends AgentSandbox<BashToolkitTools, SANDBOX> {
138
205
  bash: WrappedBashTool;
139
206
  }
140
207
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sources":["../../../src/lib/sandbox/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sources":["../../../src/lib/sandbox/types.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,5 @@
1
1
  import { type CustomCommand, type IFileSystem, type SandboxOptions } from 'just-bash';
2
- import type { DisposableSandbox, SandboxReadinessOptions } from './types.ts';
2
+ import { type ChatSandbox, type DisposableSandbox, type SandboxContext, type SandboxEnvironment, type SandboxReadinessOptions } from './types.ts';
3
3
  export interface CreateVirtualSandboxOptions extends SandboxReadinessOptions {
4
4
  fs: IFileSystem;
5
5
  cwd?: string;
@@ -8,4 +8,22 @@ export interface CreateVirtualSandboxOptions extends SandboxReadinessOptions {
8
8
  customCommands?: CustomCommand[];
9
9
  }
10
10
  export declare function createVirtualSandbox({ readiness, ...options }: CreateVirtualSandboxOptions): Promise<DisposableSandbox>;
11
+ export type VirtualSandboxEnvironmentOptions = Omit<CreateVirtualSandboxOptions, 'fs'>;
12
+ /**
13
+ * Chat sandboxes of just-bash in this process, each over its own in-memory
14
+ * filesystem, which the environment keeps until `delete`. Another process or
15
+ * another environment does not reach them. Nothing runs between commands, so
16
+ * it has no `stop`. Each handle runs its own interpreter over the chat's
17
+ * filesystem; `close` ends that interpreter and keeps the files. A handle
18
+ * whose chat was deleted rejects every operation with
19
+ * {@link SandboxNotFoundError}, and a closed handle rejects every operation:
20
+ * just-bash itself keeps serving a stopped interpreter, and a deleted chat's
21
+ * filesystem lives on in the handles that hold it.
22
+ */
23
+ export declare class VirtualSandboxEnvironment implements SandboxEnvironment {
24
+ #private;
25
+ constructor(options?: VirtualSandboxEnvironmentOptions);
26
+ open(chat: SandboxContext): Promise<ChatSandbox>;
27
+ delete(chat: SandboxContext): Promise<void>;
28
+ }
11
29
  //# sourceMappingURL=virtual-sandbox.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"virtual-sandbox.d.ts","sources":["../../../src/lib/sandbox/virtual-sandbox.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,WAAW,EAEhB,KAAK,cAAc,EACpB,MAAM,WAAW,CAAC;AAEnB,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE7E,MAAM,WAAW,2BAA4B,SAAQ,uBAAuB;IAC1E,EAAE,EAAE,WAAW,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,UAAU,CAAC,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;IAC1C,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CAClC;AAED,wBAAsB,oBAAoB,CAAC,EACzC,SAAS,EACT,GAAG,OAAO,EACX,EAAE,2BAA2B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqB1D"}
1
+ {"version":3,"file":"virtual-sandbox.d.ts","sources":["../../../src/lib/sandbox/virtual-sandbox.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,WAAW,EAGhB,KAAK,cAAc,EACpB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EAEvB,KAAK,uBAAuB,EAC7B,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,2BAA4B,SAAQ,uBAAuB;IAC1E,EAAE,EAAE,WAAW,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,UAAU,CAAC,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;IAC1C,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;CAClC;AAED,wBAAsB,oBAAoB,CAAC,EACzC,SAAS,EACT,GAAG,OAAO,EACX,EAAE,2BAA2B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAqB1D;AAED,MAAM,MAAM,gCAAgC,GAAG,IAAI,CACjD,2BAA2B,EAC3B,IAAI,CACL,CAAC;AAEF;;;;;;;;;;GAUG;AACH,qBAAa,yBAA0B,YAAW,kBAAkB;;IAIlE,YAAY,OAAO,GAAE,gCAAqC,EAEzD;IAEK,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,CAwCrD;IAEK,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhD;CACF"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@deepagents/context",
3
- "version": "7.10.2",
3
+ "version": "7.12.0",
4
4
  "license": "MIT",
5
5
  "repository": {
6
6
  "type": "git",
@@ -70,7 +70,7 @@
70
70
  "@ai-sdk/provider-utils": "^5.0.76",
71
71
  "@ai-sdk/sandbox-just-bash": "^1.0.177",
72
72
  "@ai-sdk/tool-bash": "^1.0.20",
73
- "@deepagents/agent": "7.10.2",
73
+ "@deepagents/agent": "7.12.0",
74
74
  "@zukhruf/async": "^0.8.41",
75
75
  "@zukhruf/docker": "^0.8.41",
76
76
  "@zukhruf/fs": "^0.8.41",