@deepagents/context 7.5.2 → 7.7.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/README.md +12 -10
- package/dist/index.js +1409 -1807
- package/dist/index.js.map +4 -4
- package/dist/lib/agent.d.ts +21 -21
- package/dist/lib/agent.d.ts.map +1 -1
- package/dist/lib/fragments/plan-shared.d.ts.map +1 -1
- package/dist/lib/sandbox/apple-container-sandbox.d.ts +2 -2
- package/dist/lib/sandbox/apple-container-sandbox.d.ts.map +1 -1
- package/dist/lib/sandbox/bash-tool.d.ts +2 -4
- package/dist/lib/sandbox/bash-tool.d.ts.map +1 -1
- package/dist/lib/sandbox/container-engine.d.ts +53 -27
- package/dist/lib/sandbox/container-engine.d.ts.map +1 -1
- package/dist/lib/sandbox/container-sandbox.d.ts +6 -3
- package/dist/lib/sandbox/container-sandbox.d.ts.map +1 -1
- package/dist/lib/sandbox/container-session.d.ts +19 -0
- package/dist/lib/sandbox/container-session.d.ts.map +1 -0
- package/dist/lib/sandbox/daytona-sandbox.d.ts +39 -48
- package/dist/lib/sandbox/daytona-sandbox.d.ts.map +1 -1
- package/dist/lib/sandbox/docker-sandbox.d.ts +31 -131
- package/dist/lib/sandbox/docker-sandbox.d.ts.map +1 -1
- package/dist/lib/sandbox/index.d.ts +0 -1
- package/dist/lib/sandbox/index.d.ts.map +1 -1
- package/dist/lib/sandbox/microsandbox-sandbox.d.ts +6 -13
- package/dist/lib/sandbox/microsandbox-sandbox.d.ts.map +1 -1
- package/dist/lib/sandbox/read-file-tool/index.d.ts +2 -2
- package/dist/lib/sandbox/read-file-tool/index.d.ts.map +1 -1
- package/dist/lib/sandbox/read-file-tool/text.d.ts.map +1 -1
- package/dist/lib/sandbox/session.d.ts +40 -0
- package/dist/lib/sandbox/session.d.ts.map +1 -0
- package/dist/lib/sandbox/strace/file-changes.d.ts +20 -14
- package/dist/lib/sandbox/strace/file-changes.d.ts.map +1 -1
- package/dist/lib/sandbox/strace/index.d.ts +1 -1
- package/dist/lib/sandbox/strace/index.d.ts.map +1 -1
- package/dist/lib/sandbox/strace/index.js +7 -6
- package/dist/lib/sandbox/strace/index.js.map +2 -2
- package/dist/lib/sandbox/types.d.ts +38 -78
- package/dist/lib/sandbox/types.d.ts.map +1 -1
- package/dist/lib/sandbox/virtual-sandbox.d.ts +3 -3
- package/dist/lib/sandbox/virtual-sandbox.d.ts.map +1 -1
- package/dist/lib/telemetry/console-telemetry.d.ts +7 -1
- package/dist/lib/telemetry/console-telemetry.d.ts.map +1 -1
- package/dist/lib/telemetry/file/file-telemetry.d.ts +6 -0
- package/dist/lib/telemetry/file/file-telemetry.d.ts.map +1 -1
- package/dist/lib/telemetry/file/index.js +18 -12
- package/dist/lib/telemetry/file/index.js.map +2 -2
- package/dist/lib/telemetry/index.js +10 -6
- package/dist/lib/telemetry/index.js.map +2 -2
- package/dist/lib/telemetry/safe-serialize.d.ts +1 -1
- package/dist/lib/telemetry/safe-serialize.d.ts.map +1 -1
- package/dist/lib/tracing/batch-processor.d.ts +7 -1
- package/dist/lib/tracing/batch-processor.d.ts.map +1 -1
- package/dist/lib/tracing/index.js +24 -16
- package/dist/lib/tracing/index.js.map +2 -2
- package/dist/lib/tracing/openai-traces-integration.d.ts +9 -3
- package/dist/lib/tracing/openai-traces-integration.d.ts.map +1 -1
- package/package.json +23 -19
- package/dist/lib/sandbox/cli-process.d.ts +0 -35
- package/dist/lib/sandbox/cli-process.d.ts.map +0 -1
- package/dist/lib/sandbox/read-file.d.ts +0 -9
- package/dist/lib/sandbox/read-file.d.ts.map +0 -1
package/dist/lib/agent.d.ts
CHANGED
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
import type { JSONObject } from '@ai-sdk/provider';
|
|
2
2
|
import type { HasRequiredKey, InferToolSetContext, ToolExecutionOptions } from '@ai-sdk/provider-utils';
|
|
3
|
-
import { type FlexibleSchema, type GenerateTextResult, type InferSchema, Output, type PrepareStepFunction, type StreamTextResult, type StreamTextTransform, type Tool, type ToolLoopAgentSettings, type ToolSet, type UIMessage, type UIMessageChunk, type UIMessageStreamOptions, generateText, streamText } from 'ai';
|
|
3
|
+
import { type FlexibleSchema, type GenerateTextResult, type InferSchema, Output, type PrepareStepFunction, type StreamTextResult, type StreamTextTransform, type Tool, type ToolChoice, type ToolLoopAgentSettings, type ToolSet, type UIMessage, type UIMessageChunk, type UIMessageStreamOptions, generateText, streamText } from 'ai';
|
|
4
4
|
import { type AgentControls, withHostOnlyToolMetadata } from '@deepagents/agent';
|
|
5
5
|
import { type ContextEngine, type PrepareStepInputProvider } from '../index.ts';
|
|
6
6
|
import { type AdvisorResult, type AgentModel, type AsAdvisorOptions } from './advisor.ts';
|
|
7
7
|
import { type Guardrail } from './guardrail.ts';
|
|
8
|
-
import type { AgentSandbox } from './sandbox/types.ts';
|
|
8
|
+
import type { AgentSandbox, SandboxTools } from './sandbox/types.ts';
|
|
9
9
|
export type { AgentControls } from '@deepagents/agent';
|
|
10
10
|
/** Input schema shape accepted by the tool `asTool()` produces. */
|
|
11
11
|
export interface SubagentToolInput {
|
|
@@ -28,7 +28,7 @@ export interface SubagentTool<OUTPUT, CONTEXT> {
|
|
|
28
28
|
execute: (input: SubagentToolInput, options: ToolExecutionOptions<CONTEXT>) => Promise<OUTPUT>;
|
|
29
29
|
}
|
|
30
30
|
type PreparedTools<TOOLS extends ToolSet> = ReturnType<typeof withHostOnlyToolMetadata<TOOLS>>;
|
|
31
|
-
type AgentModelTools<TOOLS extends ToolSet> = PreparedTools<
|
|
31
|
+
type AgentModelTools<TOOLS extends ToolSet, SANDBOX_TOOLS extends SandboxTools> = PreparedTools<SANDBOX_TOOLS & TOOLS>;
|
|
32
32
|
type ToolCallOptions<TOOLS extends ToolSet, OPTIONS> = Pick<ToolLoopAgentSettings<never, TOOLS>, 'toolsContext'> & OPTIONS;
|
|
33
33
|
export type ToolCallArguments<TOOLS extends ToolSet, OPTIONS> = HasRequiredKey<InferToolSetContext<TOOLS>> extends true ? [options: ToolCallOptions<TOOLS, OPTIONS>] : [options?: ToolCallOptions<TOOLS, OPTIONS>];
|
|
34
34
|
type GenerateOptions = {
|
|
@@ -48,17 +48,17 @@ export interface AgentStream<TOOLS extends ToolSet> {
|
|
|
48
48
|
readonly result: ReturnType<typeof streamText<TOOLS>>;
|
|
49
49
|
toUIMessageStream(options?: UIMessageStreamOptions<UIMessage>): ReadableStream<UIMessageChunk>;
|
|
50
50
|
}
|
|
51
|
-
export interface CreateAgent<TOOLS extends ToolSet = {}> extends AgentControls<AgentModelTools<TOOLS>> {
|
|
51
|
+
export interface CreateAgent<TOOLS extends ToolSet = {}, SANDBOX_TOOLS extends SandboxTools = SandboxTools> extends AgentControls<AgentModelTools<TOOLS, SANDBOX_TOOLS>> {
|
|
52
52
|
name: string;
|
|
53
|
-
sandbox: AgentSandbox
|
|
53
|
+
sandbox: AgentSandbox<SANDBOX_TOOLS>;
|
|
54
54
|
context?: ContextEngine;
|
|
55
55
|
tools?: TOOLS;
|
|
56
56
|
model?: AgentModel;
|
|
57
|
-
toolChoice?:
|
|
58
|
-
providerOptions?: Parameters<typeof generateText<AgentModelTools<TOOLS>>>[0]['providerOptions'];
|
|
59
|
-
telemetry?: Parameters<typeof generateText<AgentModelTools<TOOLS>>>[0]['telemetry'];
|
|
60
|
-
runtimeContext?: Parameters<typeof generateText<AgentModelTools<TOOLS>>>[0]['runtimeContext'];
|
|
61
|
-
experimental_toolCallers?: Parameters<typeof generateText<AgentModelTools<TOOLS>>>[0]['experimental_toolCallers'];
|
|
57
|
+
toolChoice?: ToolChoice<AgentModelTools<NoInfer<TOOLS>, SANDBOX_TOOLS>>;
|
|
58
|
+
providerOptions?: Parameters<typeof generateText<AgentModelTools<TOOLS, SANDBOX_TOOLS>>>[0]['providerOptions'];
|
|
59
|
+
telemetry?: Parameters<typeof generateText<AgentModelTools<TOOLS, SANDBOX_TOOLS>>>[0]['telemetry'];
|
|
60
|
+
runtimeContext?: Parameters<typeof generateText<AgentModelTools<TOOLS, SANDBOX_TOOLS>>>[0]['runtimeContext'];
|
|
61
|
+
experimental_toolCallers?: Parameters<typeof generateText<AgentModelTools<TOOLS, SANDBOX_TOOLS>>>[0]['experimental_toolCallers'];
|
|
62
62
|
/**
|
|
63
63
|
* Ends the agent loop. Defaults to {@link DEFAULT_STOP_WHEN}. Raise it for a
|
|
64
64
|
* long agentic run that would otherwise stop mid-task; lower it to bound cost
|
|
@@ -77,21 +77,21 @@ export interface CreateAgent<TOOLS extends ToolSet = {}> extends AgentControls<A
|
|
|
77
77
|
/** Supplies durable user input before sampling and at safe step boundaries. */
|
|
78
78
|
prepareStepInput?: PrepareStepInputProvider;
|
|
79
79
|
/** Native AI SDK step overrides, applied after context reminders and host input. */
|
|
80
|
-
prepareStep?: PrepareStepFunction<AgentModelTools<TOOLS>>;
|
|
80
|
+
prepareStep?: PrepareStepFunction<AgentModelTools<TOOLS, SANDBOX_TOOLS>>;
|
|
81
81
|
}
|
|
82
82
|
/**
|
|
83
83
|
* Default ceiling for the agent loop. Kept in one place so the entry points
|
|
84
84
|
* cannot drift; callers override it with `stopWhen` on `agent()`.
|
|
85
85
|
*/
|
|
86
86
|
export declare const DEFAULT_STOP_WHEN: import("ai").StopCondition<any, any>;
|
|
87
|
-
declare class Agent<TOOLS extends ToolSet> {
|
|
87
|
+
declare class Agent<TOOLS extends ToolSet, SANDBOX_TOOLS extends SandboxTools> {
|
|
88
88
|
#private;
|
|
89
|
-
readonly tools: AgentModelTools<TOOLS>;
|
|
89
|
+
readonly tools: AgentModelTools<TOOLS, SANDBOX_TOOLS>;
|
|
90
90
|
readonly context?: ContextEngine;
|
|
91
91
|
readonly model?: AgentModel;
|
|
92
|
-
readonly sandbox: AgentSandbox
|
|
93
|
-
constructor(options: CreateAgent<TOOLS>);
|
|
94
|
-
generate(...[options]: ToolCallArguments<AgentModelTools<TOOLS>, GenerateOptions>): Promise<GenerateTextResult<AgentModelTools<TOOLS>, any, Output.Output<string, string, unknown>>>;
|
|
92
|
+
readonly sandbox: AgentSandbox<SANDBOX_TOOLS>;
|
|
93
|
+
constructor(options: CreateAgent<TOOLS, SANDBOX_TOOLS>);
|
|
94
|
+
generate(...[options]: ToolCallArguments<AgentModelTools<TOOLS, SANDBOX_TOOLS>, GenerateOptions>): Promise<GenerateTextResult<AgentModelTools<TOOLS, SANDBOX_TOOLS>, any, Output.Output<string, string, unknown>>>;
|
|
95
95
|
/**
|
|
96
96
|
* Stream a response from the agent.
|
|
97
97
|
*
|
|
@@ -106,18 +106,18 @@ declare class Agent<TOOLS extends ToolSet> {
|
|
|
106
106
|
* await printer.readableStream(stream.toUIMessageStream());
|
|
107
107
|
* ```
|
|
108
108
|
*/
|
|
109
|
-
stream(...[options]: ToolCallArguments<AgentModelTools<TOOLS>, StreamOptions<AgentModelTools<TOOLS>>>): Promise<AgentStream<AgentModelTools<TOOLS>>>;
|
|
109
|
+
stream(...[options]: ToolCallArguments<AgentModelTools<TOOLS, SANDBOX_TOOLS>, StreamOptions<AgentModelTools<TOOLS, SANDBOX_TOOLS>>>): Promise<AgentStream<AgentModelTools<TOOLS, SANDBOX_TOOLS>>>;
|
|
110
110
|
asTool<T = string>(props?: {
|
|
111
111
|
toolDescription?: string;
|
|
112
|
-
outputExtractor?: (output: Awaited<ReturnType<Agent<TOOLS>['generate']>>) => T | Promise<T>;
|
|
112
|
+
outputExtractor?: (output: Awaited<ReturnType<Agent<TOOLS, SANDBOX_TOOLS>['generate']>>) => T | Promise<T>;
|
|
113
113
|
/** Not sent to the model; surfaces on tool call/result and UI message parts */
|
|
114
114
|
metadata?: JSONObject;
|
|
115
115
|
toModelOutput?: Tool<SubagentToolInput, T | string>['toModelOutput'];
|
|
116
|
-
}): SubagentTool<T | string, InferToolSetContext<AgentModelTools<TOOLS>>>;
|
|
116
|
+
}): SubagentTool<T | string, InferToolSetContext<AgentModelTools<TOOLS, SANDBOX_TOOLS>>>;
|
|
117
117
|
asAdvisor(options?: AsAdvisorOptions): AdvisorResult;
|
|
118
|
-
clone(overrides?: Partial<CreateAgent<TOOLS>>): Agent<TOOLS>;
|
|
118
|
+
clone(overrides?: Partial<CreateAgent<TOOLS, SANDBOX_TOOLS>>): Agent<TOOLS, SANDBOX_TOOLS>;
|
|
119
119
|
}
|
|
120
|
-
export declare function agent<const TOOLS extends ToolSet = {}>(options: CreateAgent<TOOLS>): Agent<TOOLS>;
|
|
120
|
+
export declare function agent<const TOOLS extends ToolSet = {}, SANDBOX_TOOLS extends SandboxTools = SandboxTools>(options: CreateAgent<TOOLS, SANDBOX_TOOLS>): Agent<TOOLS, SANDBOX_TOOLS>;
|
|
121
121
|
/**
|
|
122
122
|
* Options for creating a structured output handler.
|
|
123
123
|
*/
|
package/dist/lib/agent.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/lib/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EACV,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,MAAM,EACN,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,IAAI,EACT,KAAK,qBAAqB,EAC1B,KAAK,OAAO,EACZ,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,sBAAsB,EAK3B,YAAY,EAGZ,UAAU,EAGX,MAAM,IAAI,CAAC;AAIZ,OAAO,EACL,KAAK,aAAa,EAElB,wBAAwB,EACzB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAE9B,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,UAAU,EACf,KAAK,gBAAgB,EAMtB,MAAM,cAAc,CAAC;AAGtB,OAAO,EACL,KAAK,SAAS,EAGf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;
|
|
1
|
+
{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/lib/agent.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"plan-shared.d.ts","sourceRoot":"","sources":["../../../src/lib/fragments/plan-shared.ts"],"names":[],"mappings":"AACA,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,eAAO,MAAM,cAAc,qCAAqC,CAAC;AAEjE,eAAO,MAAM,4BAA4B,QAyBxC,CAAC;AAEF,eAAO,MAAM,wBAAwB,QAEpC,CAAC;AAEF,eAAO,MAAM,cAAc,aAA2B,CAAC;AACvD,eAAO,MAAM,cAAc;;;;;EAKzB,CAAC;AACH,eAAO,MAAM,QAAQ;;;kBAGnB,CAAC;AACH,eAAO,MAAM,UAAU;;;;;;;;;;kBAIrB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAW1E;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAChD,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,GACZ,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAShB;AAED,wBAAgB,oBAAoB,CAClC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,EAE7C,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,GACZ;IAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAAE,CA6CzD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAEnD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAGxD;AAgBD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,EAChC,gBAAgB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,EAC5C,cAAc,EAAE,MAAM,GACrB,eAAe,
|
|
1
|
+
{"version":3,"file":"plan-shared.d.ts","sourceRoot":"","sources":["../../../src/lib/fragments/plan-shared.ts"],"names":[],"mappings":"AACA,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,eAAO,MAAM,cAAc,qCAAqC,CAAC;AAEjE,eAAO,MAAM,4BAA4B,QAyBxC,CAAC;AAEF,eAAO,MAAM,wBAAwB,QAEpC,CAAC;AAEF,eAAO,MAAM,cAAc,aAA2B,CAAC;AACvD,eAAO,MAAM,cAAc;;;;;EAKzB,CAAC;AACH,eAAO,MAAM,QAAQ;;;kBAGnB,CAAC;AACH,eAAO,MAAM,UAAU;;;;;;;;;;kBAIrB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAW1E;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAChD,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,GACZ,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAShB;AAED,wBAAgB,oBAAoB,CAClC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,EAE7C,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,GACZ;IAAE,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAAE,CA6CzD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAEnD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,CAGxD;AAgBD,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE;IAAE,IAAI,EAAE,aAAa,CAAA;CAAE,EAChC,gBAAgB,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,EAC5C,cAAc,EAAE,MAAM,GACrB,eAAe,CAgCjB"}
|
|
@@ -57,7 +57,7 @@ export interface AppleContainerCommonOptions {
|
|
|
57
57
|
/**
|
|
58
58
|
* Args appended after the image at `container run` time.
|
|
59
59
|
* - `undefined` (default): `['tail', '-f', '/dev/null']` keep-alive so a bare
|
|
60
|
-
* image stays up for installers and
|
|
60
|
+
* image stays up for installers and commands.
|
|
61
61
|
* - `[]` or `null`: nothing appended; the image's own `CMD`/`ENTRYPOINT` runs.
|
|
62
62
|
* - A non-empty array: appended verbatim, overriding the image command.
|
|
63
63
|
*/
|
|
@@ -113,7 +113,7 @@ export declare const appleEngine: ContainerEngine<AppleContainerCommonOptions> &
|
|
|
113
113
|
* image: 'docker.io/library/bash:5.3-alpine3.24',
|
|
114
114
|
* installers: [pkg(['curl', 'jq'])],
|
|
115
115
|
* });
|
|
116
|
-
* const { stdout } = await sandbox.
|
|
116
|
+
* const { stdout } = await sandbox.run({ command: 'echo hello' });
|
|
117
117
|
* ```
|
|
118
118
|
*
|
|
119
119
|
* @example Dockerfile
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"apple-container-sandbox.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/apple-container-sandbox.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"apple-container-sandbox.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/apple-container-sandbox.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,10 +1,8 @@
|
|
|
1
|
-
import { type
|
|
2
|
-
declare const DEFAULT_MAX_OUTPUT_LENGTH = 30000;
|
|
1
|
+
import { type BashToolkit, type CreateBashToolOptions } from './types.ts';
|
|
3
2
|
/**
|
|
4
3
|
* Build the DeepAgents-owned bash/readFile/writeFile toolkit around a sandbox.
|
|
5
4
|
* The sandbox provides isolation and execution; these tools only translate AI
|
|
6
5
|
* SDK tool calls into that backend contract.
|
|
7
6
|
*/
|
|
8
|
-
export declare function createBashTool(options: CreateBashToolOptions): Promise<
|
|
9
|
-
export { DEFAULT_MAX_OUTPUT_LENGTH };
|
|
7
|
+
export declare function createBashTool(options: CreateBashToolOptions): Promise<BashToolkit>;
|
|
10
8
|
//# sourceMappingURL=bash-tool.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"bash-tool.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/bash-tool.ts"],"names":[],"mappings":"AAYA,OAAO,
|
|
1
|
+
{"version":3,"file":"bash-tool.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/bash-tool.ts"],"names":[],"mappings":"AAYA,OAAO,EAEL,KAAK,WAAW,EAEhB,KAAK,qBAAqB,EAI3B,MAAM,YAAY,CAAC;AAgIpB;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,WAAW,CAAC,CAiItB"}
|
|
@@ -1,6 +1,7 @@
|
|
|
1
|
+
import type { Experimental_SandboxFileStat } from '@ai-sdk/provider-utils';
|
|
1
2
|
import type { ContainerSandboxError } from './container-sandbox-errors.ts';
|
|
2
3
|
import type { InstallerContext } from './installers/installer.ts';
|
|
3
|
-
import type { CommandResult,
|
|
4
|
+
import type { CommandResult, SandboxReadinessOptions } from './types.ts';
|
|
4
5
|
/** The errors the shared skeleton raises itself; each engine gives its own classes. */
|
|
5
6
|
export interface ContainerErrorFactory {
|
|
6
7
|
generic(message: string, containerId?: string): ContainerSandboxError;
|
|
@@ -54,22 +55,14 @@ export interface SandboxNamedVolume {
|
|
|
54
55
|
removeOnDispose?: boolean;
|
|
55
56
|
}
|
|
56
57
|
export type SandboxVolume = SandboxBindVolume | SandboxNamedVolume;
|
|
57
|
-
/** Resource limits common to every engine. Engines extend with their own knobs. */
|
|
58
|
-
export interface SandboxResources {
|
|
59
|
-
/** `--memory` — e.g. `'1g'`, `'1024M'`. */
|
|
60
|
-
memory?: string;
|
|
61
|
-
/** `--cpus` — number of CPUs. */
|
|
62
|
-
cpus?: number;
|
|
63
|
-
}
|
|
64
58
|
/**
|
|
65
59
|
* The options the shared skeleton is allowed to read. Each engine extends this
|
|
66
|
-
* with its own dialect knobs (Docker's
|
|
60
|
+
* with its own dialect knobs (Docker's `container` create body; Apple's `arch`),
|
|
67
61
|
* which only its own engine methods see — the skeleton is typed to this common
|
|
68
62
|
* subset and physically cannot read them.
|
|
69
63
|
*/
|
|
70
64
|
export interface CommonSandboxOptions extends SandboxReadinessOptions {
|
|
71
65
|
volumes?: SandboxVolume[];
|
|
72
|
-
resources?: SandboxResources;
|
|
73
66
|
env?: Record<string, string>;
|
|
74
67
|
/**
|
|
75
68
|
* Stable identity suffix. When provided, the container is named
|
|
@@ -78,16 +71,18 @@ export interface CommonSandboxOptions extends SandboxReadinessOptions {
|
|
|
78
71
|
* volume preparation, and env are skipped); if it exists but is stopped, it is
|
|
79
72
|
* started first; otherwise it is created fresh. Must match `/^[A-Za-z0-9_.-]+$/`.
|
|
80
73
|
*
|
|
81
|
-
*
|
|
82
|
-
*
|
|
83
|
-
*
|
|
84
|
-
*
|
|
74
|
+
* Who owns the container follows who created it. A sandbox that created the
|
|
75
|
+
* container owns it: `dispose()` stops it, and `--rm` removes it. A sandbox
|
|
76
|
+
* that attached to an existing container borrows it: `dispose()` closes the
|
|
77
|
+
* connection to the engine and leaves the container running, also when the
|
|
78
|
+
* sandbox started a stopped one. When two sandboxes share a name, the
|
|
79
|
+
* container ends when the one that created it is disposed.
|
|
85
80
|
*/
|
|
86
81
|
name?: string;
|
|
87
82
|
/**
|
|
88
83
|
* Args appended after the image at run time.
|
|
89
84
|
* - `undefined` (default): `['tail', '-f', '/dev/null']` keep-alive so a bare
|
|
90
|
-
* image stays up for installers and
|
|
85
|
+
* image stays up for installers and commands.
|
|
91
86
|
* - `[]` or `null`: nothing is appended; the image's own `CMD`/`ENTRYPOINT`
|
|
92
87
|
* runs as declared.
|
|
93
88
|
* - A non-empty array: appended verbatim, overriding the image `CMD`.
|
|
@@ -96,28 +91,59 @@ export interface CommonSandboxOptions extends SandboxReadinessOptions {
|
|
|
96
91
|
/** Working directory inside the container (default `'/workspace'`). */
|
|
97
92
|
workdir?: string;
|
|
98
93
|
}
|
|
94
|
+
/** Where and with what environment a process runs in the container. */
|
|
95
|
+
export interface EngineProcessOptions {
|
|
96
|
+
/** An absolute path. Default: the {@link EngineContainer.workdir}. */
|
|
97
|
+
workingDirectory?: string;
|
|
98
|
+
env?: Record<string, string>;
|
|
99
|
+
}
|
|
100
|
+
export interface EngineExecOptions extends EngineProcessOptions {
|
|
101
|
+
signal?: AbortSignal;
|
|
102
|
+
/** Bytes for standard input, which then ends. */
|
|
103
|
+
stdin?: Uint8Array;
|
|
104
|
+
}
|
|
105
|
+
export interface EngineSpawnOptions extends EngineProcessOptions {
|
|
106
|
+
stdin?: boolean;
|
|
107
|
+
}
|
|
108
|
+
/** A process in a container, while it runs. */
|
|
109
|
+
export interface EngineProcess {
|
|
110
|
+
readonly stdout: ReadableStream<Uint8Array>;
|
|
111
|
+
readonly stderr: ReadableStream<Uint8Array>;
|
|
112
|
+
/** Present when the process was spawned with `stdin`. */
|
|
113
|
+
readonly stdin?: WritableStream<Uint8Array>;
|
|
114
|
+
/** Resolves when the output has ended. */
|
|
115
|
+
readonly exitCode: Promise<number>;
|
|
116
|
+
}
|
|
99
117
|
/**
|
|
100
|
-
* One running container of an engine. The sandbox
|
|
101
|
-
* each engine owns how commands and files reach its containers.
|
|
118
|
+
* One running container of an engine. The session of the sandbox is built on
|
|
119
|
+
* this, so each engine owns how commands and files reach its containers.
|
|
102
120
|
*/
|
|
103
121
|
export interface EngineContainer {
|
|
104
122
|
/** The container name: `sandbox-<name>` or `sandbox-<8hex>`. */
|
|
105
123
|
readonly name: string;
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
/**
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
124
|
+
/** Where commands start and what a relative path of a file call resolves against. */
|
|
125
|
+
readonly workdir: string;
|
|
126
|
+
/** Milliseconds that bound each command of the session. */
|
|
127
|
+
readonly commandTimeout?: number;
|
|
128
|
+
/**
|
|
129
|
+
* Runs `argv` to its end. A command the engine cannot run is a failed command
|
|
130
|
+
* in the result, as it is for the engine's own CLI, not a rejection.
|
|
131
|
+
*/
|
|
132
|
+
exec(argv: string[], options?: EngineExecOptions): Promise<CommandResult>;
|
|
133
|
+
/** Starts `argv` and streams its output. */
|
|
134
|
+
spawn(argv: string[], options: EngineSpawnOptions): Promise<EngineProcess>;
|
|
135
|
+
/** The bytes of the file at `path`, or `null` when nothing is there. */
|
|
136
|
+
readFile(path: string, signal: AbortSignal | undefined): Promise<Uint8Array | null>;
|
|
137
|
+
/** Creates the parent directories. Rejects when `path` is a directory. */
|
|
138
|
+
writeFile(path: string, content: Uint8Array, signal: AbortSignal | undefined): Promise<void>;
|
|
139
|
+
/** Follows symbolic links, and gives `null` when nothing is at `path`. */
|
|
140
|
+
stat(path: string, signal: AbortSignal | undefined): Promise<Experimental_SandboxFileStat | null>;
|
|
115
141
|
/**
|
|
116
142
|
* The installer context that drives the post-start installer phase
|
|
117
143
|
* (`pkg`/`npm`/`pip`/…) in this container.
|
|
118
144
|
*/
|
|
119
145
|
installerContext(image: string): InstallerContext;
|
|
120
|
-
/** Stops the container
|
|
146
|
+
/** Stops the container, and resolves when the engine removed it or it is already gone. */
|
|
121
147
|
stop(): Promise<void>;
|
|
122
148
|
}
|
|
123
149
|
/** The result of {@link ContainerEngine.run}: `created: false` when another caller has the name. */
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"container-engine.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/container-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,
|
|
1
|
+
{"version":3,"file":"container-engine.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/container-engine.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,7 +1,10 @@
|
|
|
1
1
|
import type { CommonSandboxOptions, ContainerEngine, ContainerErrorFactory, EngineContainer, SandboxVolume } from './container-engine.ts';
|
|
2
2
|
import { type Installer } from './installers/installer.ts';
|
|
3
3
|
import type { DisposableSandbox } from './types.ts';
|
|
4
|
-
/**
|
|
4
|
+
/**
|
|
5
|
+
* A container the strategy runs in, and whether an earlier caller created it.
|
|
6
|
+
* An attached container is borrowed: the sandbox never stops it.
|
|
7
|
+
*/
|
|
5
8
|
export interface AcquiredContainer {
|
|
6
9
|
container: EngineContainer;
|
|
7
10
|
attached: boolean;
|
|
@@ -40,10 +43,10 @@ export declare abstract class ContainerSandboxStrategy<TOpts extends CommonSandb
|
|
|
40
43
|
protected validateVolumes(): void;
|
|
41
44
|
private validateMountValue;
|
|
42
45
|
private cleanupCreatedVolumes;
|
|
43
|
-
/** Ends
|
|
46
|
+
/** Ends a container that this sandbox created: stops it, by default. */
|
|
44
47
|
protected release(container: EngineContainer): Promise<void>;
|
|
45
48
|
private assertBashAvailable;
|
|
46
|
-
protected createSandboxMethods(container:
|
|
49
|
+
protected createSandboxMethods({ container, attached, }: AcquiredContainer): DisposableSandbox;
|
|
47
50
|
protected abstract getImage(): Promise<string>;
|
|
48
51
|
protected abstract configure(container: EngineContainer, image: string): Promise<void>;
|
|
49
52
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"container-sandbox.d.ts","sourceRoot":"","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;
|
|
1
|
+
{"version":3,"file":"container-sandbox.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/container-sandbox.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,19 @@
|
|
|
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';
|
|
4
|
+
export declare const FILE_STAT_TYPES: readonly ["file", "directory", "other"];
|
|
5
|
+
/** The stat of `path` through a command, for what no engine request reaches. */
|
|
6
|
+
export declare function statOverExec(container: Pick<EngineContainer, 'exec'>, path: string, signal: AbortSignal | undefined): Promise<Experimental_SandboxFileStat | null>;
|
|
7
|
+
/** The bytes of `path` through a command, for what no engine request reaches. */
|
|
8
|
+
export declare function readFileOverExec(container: Pick<EngineContainer, 'exec'>, path: string, signal: AbortSignal | undefined): Promise<Uint8Array | null>;
|
|
9
|
+
/** Writes `path` through a command, for what no engine request reaches. */
|
|
10
|
+
export declare function writeFileOverExec(container: Pick<EngineContainer, 'exec'>, path: string, content: Uint8Array, signal: AbortSignal | undefined): Promise<void>;
|
|
11
|
+
/** Reads a process to its end. */
|
|
12
|
+
export declare function collectOutput(process: EngineProcess): Promise<CommandResult>;
|
|
13
|
+
export declare function validateEnv(env: Record<string, string> | undefined, errors: ContainerErrorFactory): void;
|
|
14
|
+
/**
|
|
15
|
+
* The AI SDK sandbox session of a running container, over what the engine
|
|
16
|
+
* gives. Disposal is added by the strategy that owns the container.
|
|
17
|
+
*/
|
|
18
|
+
export declare function containerSession(container: EngineContainer, errors: ContainerErrorFactory): Omit<DisposableSandbox, 'dispose' | typeof Symbol.asyncDispose>;
|
|
19
|
+
//# sourceMappingURL=container-session.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"container-session.d.ts","sourceRoot":"","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,60 +1,51 @@
|
|
|
1
|
-
import type {
|
|
1
|
+
import type { DaytonaV2Client } from '@daytona/sdk';
|
|
2
|
+
import type { CreateSandboxOptions } from '@daytona/sdk/v2';
|
|
2
3
|
import type { DisposableSandbox, SandboxReadinessOptions } from './types.ts';
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
4
|
+
/**
|
|
5
|
+
* Creates a sandbox. With a `name`, a second create with the same name and
|
|
6
|
+
* options returns the sandbox the first one made, so the name is a
|
|
7
|
+
* get-or-create key; the same name with other options is a conflict.
|
|
8
|
+
*/
|
|
9
|
+
type DaytonaCreateOptions = Omit<CreateSandboxOptions, 'autoDelete' | 'idempotencyKey'> & {
|
|
10
|
+
sandboxId?: never;
|
|
11
|
+
/** A registered image name or `img_…` id. Default: the organization's default Linux image. */
|
|
12
|
+
image?: string;
|
|
13
|
+
};
|
|
14
|
+
/** Attaches to a sandbox that exists. */
|
|
15
|
+
interface DaytonaAttachOptions {
|
|
16
|
+
sandboxId: string;
|
|
14
17
|
}
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
* Existing Daytona sandbox id or name to attach to.
|
|
18
|
-
*/
|
|
19
|
-
sandboxId?: string;
|
|
18
|
+
type DaytonaTarget = DaytonaCreateOptions | DaytonaAttachOptions;
|
|
19
|
+
export type DaytonaSandboxOptions = SandboxReadinessOptions & {
|
|
20
20
|
/**
|
|
21
|
-
*
|
|
22
|
-
*
|
|
23
|
-
*
|
|
24
|
-
* supplied image/snapshot, env vars, volumes, and lifecycle intervals.
|
|
25
|
-
* Incompatible with `sandboxId`. `dispose()` never deletes the sandbox — the
|
|
26
|
-
* caller owns its lifecycle through the supplied client.
|
|
21
|
+
* Per-command timeout in milliseconds for `run` and `spawn`; the command
|
|
22
|
+
* then exits 124. Daytona's deadline counts whole seconds, so it is rounded
|
|
23
|
+
* up to the next second.
|
|
27
24
|
*/
|
|
28
|
-
name?: string;
|
|
29
|
-
user?: string;
|
|
30
|
-
snapshot?: string;
|
|
31
|
-
image?: string;
|
|
32
|
-
language?: string;
|
|
33
|
-
envVars?: Record<string, string>;
|
|
34
|
-
labels?: Record<string, string>;
|
|
35
|
-
public?: boolean;
|
|
36
|
-
resources?: DaytonaResources;
|
|
37
|
-
volumes?: DaytonaVolumeMount[];
|
|
38
|
-
networkAllowList?: string;
|
|
39
|
-
networkBlockAll?: boolean;
|
|
40
|
-
autoStopInterval?: number;
|
|
41
|
-
autoArchiveInterval?: number;
|
|
42
|
-
autoDeleteInterval?: number;
|
|
43
|
-
ephemeral?: boolean;
|
|
44
|
-
createTimeout?: number;
|
|
45
|
-
startTimeout?: number;
|
|
46
|
-
deleteTimeout?: number;
|
|
47
25
|
commandTimeout?: number;
|
|
48
|
-
|
|
49
|
-
}
|
|
26
|
+
} & DaytonaTarget;
|
|
50
27
|
export declare class DaytonaSandboxError extends Error {
|
|
51
28
|
constructor(message: string, cause?: Error);
|
|
52
29
|
}
|
|
53
30
|
export declare class DaytonaCreationError extends DaytonaSandboxError {
|
|
54
31
|
constructor(message: string, cause?: Error);
|
|
55
32
|
}
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
33
|
+
/**
|
|
34
|
+
* Creates a sandbox backed by a Daytona v2 sandbox.
|
|
35
|
+
*
|
|
36
|
+
* `dispose()` deletes a sandbox this call created and leaves one it attached
|
|
37
|
+
* to, by `sandboxId` or by a `name` that already had a sandbox. A Linux
|
|
38
|
+
* Daytona sandbox has no stopped state, so delete is its only release.
|
|
39
|
+
*
|
|
40
|
+
* Requires the optional peer dependency `@daytona/sdk`.
|
|
41
|
+
*
|
|
42
|
+
* @example
|
|
43
|
+
* ```typescript
|
|
44
|
+
* const daytona = new Daytona();
|
|
45
|
+
* await using sandbox = await createDaytonaSandbox(daytona.v2, { name: chatId });
|
|
46
|
+
* const result = await sandbox.run({ command: 'echo hello' });
|
|
47
|
+
* ```
|
|
48
|
+
*/
|
|
49
|
+
export declare function createDaytonaSandbox(client: DaytonaV2Client, options?: DaytonaSandboxOptions): Promise<DisposableSandbox>;
|
|
50
|
+
export {};
|
|
60
51
|
//# sourceMappingURL=daytona-sandbox.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"daytona-sandbox.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/daytona-sandbox.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"daytona-sandbox.d.ts","sourceRoot":"","sources":["../../../src/lib/sandbox/daytona-sandbox.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EACV,oBAAoB,EAIrB,MAAM,iBAAiB,CAAC;AAYzB,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAkB7E;;;;GAIG;AACH,KAAK,oBAAoB,GAAG,IAAI,CAC9B,oBAAoB,EACpB,YAAY,GAAG,gBAAgB,CAChC,GAAG;IACF,SAAS,CAAC,EAAE,KAAK,CAAC;IAClB,8FAA8F;IAC9F,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,yCAAyC;AACzC,UAAU,oBAAoB;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,KAAK,aAAa,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;AAEjE,MAAM,MAAM,qBAAqB,GAAG,uBAAuB,GAAG;IAC5D;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,aAAa,CAAC;AAQlB,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAK3C;AAED,qBAAa,oBAAqB,SAAQ,mBAAmB;gBAC/C,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAI3C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,eAAe,EACvB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,iBAAiB,CAAC,CA4B5B"}
|