@deepagents/context 7.11.0 → 7.13.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.
- package/dist/index.js +287 -23
- package/dist/index.js.map +4 -4
- package/dist/lib/sandbox/container-engine.d.ts +38 -0
- package/dist/lib/sandbox/container-engine.d.ts.map +1 -1
- package/dist/lib/sandbox/container-sandbox.d.ts +16 -9
- package/dist/lib/sandbox/container-sandbox.d.ts.map +1 -1
- package/dist/lib/sandbox/container-session.d.ts +8 -2
- package/dist/lib/sandbox/container-session.d.ts.map +1 -1
- package/dist/lib/sandbox/docker-sandbox.d.ts +70 -4
- package/dist/lib/sandbox/docker-sandbox.d.ts.map +1 -1
- package/package.json +2 -2
|
@@ -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":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,wBAAwB,CAAC;AAE3E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAEzE,uFAAuF;AACvF,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,qBAAqB,CAAC;IACtE,UAAU,CACR,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,GACb,qBAAqB,CAAC;IACzB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,qBAAqB,CAAC;IACnE,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,qBAAqB,CAAC;CACnE;AAED,2EAA2E;AAC3E,MAAM,WAAW,cAAc;IAC7B,gEAAgE;IAChE,GAAG,EAAE,MAAM,CAAC;IACZ,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,aAAa,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,6BAA6B;IAC7B,SAAS,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACnC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mEAAmE;IACnE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,MAAM,aAAa,GAAG,iBAAiB,GAAG,kBAAkB,CAAC;AAEnE,gGAAgG;AAChG,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB;IACvB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,uFAAuF;AACvF,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,GAAG,qBAAqB,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,WAAW,oBAAqB,SAAQ,uBAAuB;IACnE,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;;;;;;;;;;;OAaG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAAC;IACnC,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACnC,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAkB,SAAQ,oBAAoB;IAC7D,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,iDAAiD;IACjD,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,+CAA+C;AAC/C,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IAC5C,yDAAyD;IACzD,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;IAC5C,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,gEAAgE;IAChE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2DAA2D;IAC3D,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC1E,4CAA4C;IAC5C,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC3E,wEAAwE;IACxE,QAAQ,CACN,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC9B,0EAA0E;IAC1E,SAAS,CACP,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,UAAU,EACnB,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,0EAA0E;IAC1E,IAAI,CACF,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,4BAA4B,GAAG,IAAI,CAAC,CAAC;IAChD;;;OAGG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAAC;IAClD,0FAA0F;IAC1F,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,oGAAoG;AACpG,MAAM,MAAM,SAAS,GACnB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,SAAS,EAAE,eAAe,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAA;CAAE,CAAC;AAErE;;;;;;;;;GASG;AACH,MAAM,WAAW,eAAe,CAC9B,KAAK,SAAS,oBAAoB,GAAG,oBAAoB;IAEzD,8EAA8E;IAC9E,QAAQ,CAAC,kBAAkB,EAAE,OAAO,CAAC;IACrC,kDAAkD;IAClD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC;IAC1E;;;OAGG;IACH,GAAG,CACD,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,CAAC,CAAC;IACtB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,YAAY,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C;;;;OAIG;IACH,aAAa,CAAC,SAAS,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,gFAAgF;IAChF,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,8EAA8E;IAC9E,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,8DAA8D;IAC9D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,qEAAqE;AACrE,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D;;;;OAIG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB,wFAAwF;IACxF,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,6EAA6E;AAC7E,MAAM,WAAW,mBAAmB,CAClC,KAAK,SAAS,oBAAoB,GAAG,oBAAoB,CACzD,SAAQ,eAAe,CAAC,KAAK,CAAC;IAC9B,4EAA4E;IAC5E,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC,CAAC;IAC7D;;;;OAIG;IACH,UAAU,CACR,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,mBAAmB,CAAA;KAAE,CAAC,CAAC;CAClE"}
|
|
@@ -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
|
|
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:
|
|
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:
|
|
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:
|
|
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:
|
|
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":"AAIA,OAAO,KAAK,EACV,oBAAoB,EACpB,eAAe,EACf,qBAAqB,EACrB,eAAe,EACf,aAAa,EACd,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,
|
|
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;
|
|
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 {
|
|
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
|
|
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;
|
|
1
|
+
{"version":3,"file":"docker-sandbox.d.ts","sources":["../../../src/lib/sandbox/docker-sandbox.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@deepagents/context",
|
|
3
|
-
"version": "7.
|
|
3
|
+
"version": "7.13.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.
|
|
73
|
+
"@deepagents/agent": "7.13.0",
|
|
74
74
|
"@zukhruf/async": "^0.8.41",
|
|
75
75
|
"@zukhruf/docker": "^0.8.41",
|
|
76
76
|
"@zukhruf/fs": "^0.8.41",
|