@n8n/agents 0.10.0 → 0.11.0

package/dist/types/sdk/agent.d.ts

@@ -1,13 +1,13 @@
 import type { ProviderOptions } from '@ai-sdk/provider-utils';
-import type { LanguageModel } from 'ai';
+import type { LanguageModel, smoothStream } from 'ai';
 import type { JsonSchema7Type } from 'zod-to-json-schema';
 import type { AgentMessage, ContentMetadata } from './message';
-import type { BuiltTool } from './tool';
 import type { ProviderId, ProviderCredentials } from '../../runtime/provider-credentials';
-import type { AgentEvent, AgentEventHandler } from '../runtime/event';
+import type { AgentEvent, AgentEventHandler, SubAgentCompletedPayload, SubAgentStartedPayload } from '../runtime/event';
 import type { SerializedMessageList } from '../runtime/message-list';
 import type { BuiltTelemetry } from '../telemetry';
 import type { JSONValue } from '../utils/json';
+export type SmoothStreamOptions = NonNullable<Parameters<typeof smoothStream>[0]>;
 export type FinishReason = 'stop' | 'max-iterations' | 'length' | 'content-filter' | 'tool-calls' | 'error' | 'other';
 export type TokenUsage<T extends Record<string, unknown> = Record<string, unknown>> = {
     promptTokens: number;
@@ -82,12 +82,20 @@ export type StreamChunk = ContentMetadata & ({
     type: 'tool-execution-start';
     toolCallId: string;
     toolName: string;
+    startTime: number;
+} | {
+    type: 'tool-execution-end';
+    toolCallId: string;
+    toolName: string;
+    isError: boolean;
+    endTime: number;
 } | {
     type: 'tool-result';
     toolCallId: string;
     toolName: string;
     output: unknown;
     isError?: boolean;
+    canceled?: boolean;
 } | {
     type: 'tool-call-suspended';
     runId: string;
@@ -99,14 +107,16 @@ export type StreamChunk = ContentMetadata & ({
 } | {
     type: 'message';
     message: AgentMessage;
-} | {
+} | ({
+    type: 'subagent-started';
+} & SubAgentStartedPayload) | ({
+    type: 'subagent-completed';
+} & SubAgentCompletedPayload) | {
     type: 'finish';
     finishReason: FinishReason;
     usage?: TokenUsage;
     model?: string;
     structuredOutput?: unknown;
-    subAgentUsage?: SubAgentUsage[];
-    totalCost?: number;
 } | {
     type: 'error';
     error: unknown;
@@ -123,6 +133,7 @@ export interface ExecutionOptions {
     maxIterations?: number;
     abortSignal?: AbortSignal;
     providerOptions?: ProviderOptions;
+    smoothStream?: SmoothStreamOptions | false;
     telemetry?: BuiltTelemetry;
     executionCounter?: AgentExecutionCounter;
 }
@@ -134,11 +145,7 @@ export interface ToolResultEntry {
     input: unknown;
     output: unknown;
     transformed?: boolean;
-}
-export interface SubAgentUsage {
-    agent: string;
-    model?: string;
-    usage: TokenUsage;
+    canceled?: boolean;
 }
 export interface GenerateResult {
     runId: string;
@@ -149,8 +156,6 @@ export interface GenerateResult {
     finishReason?: FinishReason;
     providerMetadata?: Record<string, unknown>;
     toolCalls?: ToolResultEntry[];
-    subAgentUsage?: SubAgentUsage[];
-    totalCost?: number;
     pendingSuspend?: Array<{
         runId: string;
         toolCallId: string;
@@ -160,10 +165,12 @@ export interface GenerateResult {
         resumeSchema?: JsonSchema7Type;
     }>;
     error?: unknown;
+    getState(): SerializableAgentState;
 }
 export interface StreamResult {
     runId: string;
     stream: ReadableStream<StreamChunk>;
+    getState(): SerializableAgentState;
 }
 export interface ResumeOptions {
     runId: string;
@@ -174,8 +181,6 @@ export interface BuiltAgent {
     generate(input: AgentMessage[] | string, options?: RunOptions & ExecutionOptions): Promise<GenerateResult>;
     stream(input: AgentMessage[] | string, options?: RunOptions & ExecutionOptions): Promise<StreamResult>;
     on(event: AgentEvent, handler: AgentEventHandler): void;
-    asTool(description: string): BuiltTool;
-    getState(): SerializableAgentState;
     abort(): void;
     close(): Promise<void>;
     resume(method: 'generate', data: unknown, options: ResumeOptions & ExecutionOptions): Promise<GenerateResult>;

package/dist/types/sdk/memory.d.ts

@@ -31,51 +31,10 @@ export interface BuiltMemory {
         messages: AgentDbMessage[];
     }): Promise<void>;
     deleteMessages(messageIds: string[]): Promise<void>;
-    search?(query: string, opts?: {
-        scope?: 'thread' | 'resource';
-        threadId?: string;
-        resourceId?: string;
-        topK?: number;
-        messageRange?: {
-            before: number;
-            after: number;
-        };
-    }): Promise<AgentDbMessage[]>;
-    saveEmbeddings?(opts: {
-        scope?: 'thread' | 'resource';
-        threadId?: string;
-        resourceId?: string;
-        entries: Array<{
-            id: string;
-            vector: number[];
-            text: string;
-            model: string;
-        }>;
-    }): Promise<void>;
-    queryEmbeddings?(opts: {
-        scope?: 'thread' | 'resource';
-        threadId?: string;
-        resourceId?: string;
-        vector: number[];
-        topK: number;
-    }): Promise<Array<{
-        id: string;
-        score: number;
-    }>>;
     episodic?: EpisodicMemoryMethods;
     close?(): Promise<void>;
     describe(): MemoryDescriptor;
 }
-export interface SemanticRecallConfig {
-    scope?: 'thread' | 'resource';
-    topK: number;
-    messageRange?: {
-        before: number;
-        after: number;
-    };
-    embedder?: string;
-    apiKey?: string;
-}
 export type EpisodicMemoryStatus = 'active' | 'superseded' | 'dropped';
 export interface EpisodicMemoryScope {
     resourceId: string;
@@ -244,7 +203,6 @@ export interface ObservationalMemoryConfig {
 }
 interface MemoryConfigBase {
     observationLog?: ObservationLogMemoryConfig;
-    semanticRecall?: SemanticRecallConfig;
     episodicMemory?: EpisodicMemoryConfig;
     titleGeneration?: TitleGenerationConfig;
 }

package/dist/types/sdk/message.d.ts

@@ -39,6 +39,7 @@ export type ContentToolCall = ContentMetadata & {
 } | {
     state: 'resolved';
     output: JSONValue;
+    canceled?: boolean;
 } | {
     state: 'rejected';
     error: string;

package/dist/types/sdk/tool.d.ts

@@ -1,6 +1,8 @@
 import type { JSONSchema7 } from 'json-schema';
 import type { ZodType } from 'zod';
+import type { AgentExecutionCounter } from './agent';
 import type { AgentMessage } from './message';
+import type { AgentEventData } from '../runtime/event';
 import type { BuiltTelemetry } from '../telemetry';
 import type { JSONObject } from '../utils/json';
 export interface ToolExecutionContext {
@@ -9,20 +11,32 @@ export interface ToolExecutionContext {
         threadId: string;
         resourceId: string;
     };
+    emitEvent?: (event: AgentEventData) => void;
+    abortSignal?: AbortSignal;
+    executionCounter?: AgentExecutionCounter;
 }
 export interface ToolContext {
     toolCallId?: string;
     runId?: string;
     persistence?: ToolExecutionContext['persistence'];
     parentTelemetry?: BuiltTelemetry;
+    emitEvent?: ToolExecutionContext['emitEvent'];
+    abortSignal?: ToolExecutionContext['abortSignal'];
+    executionCounter?: ToolExecutionContext['executionCounter'];
 }
 export interface InterruptibleToolContext<S = unknown, R = unknown> {
     suspend: (payload: S) => Promise<never>;
     resumeData: R | undefined;
+    cancellation?: {
+        message: string;
+    };
     toolCallId?: string;
     runId?: string;
     persistence?: ToolExecutionContext['persistence'];
     parentTelemetry?: BuiltTelemetry;
+    emitEvent?: ToolExecutionContext['emitEvent'];
+    abortSignal?: ToolExecutionContext['abortSignal'];
+    executionCounter?: ToolExecutionContext['executionCounter'];
 }
 export interface BuiltTool {
     readonly name: string;
@@ -30,7 +44,11 @@ export interface BuiltTool {
     readonly systemInstruction?: string;
     readonly suspendSchema?: ZodType | JSONSchema7;
     readonly resumeSchema?: ZodType | JSONSchema7;
-    readonly withDefaultApproval?: boolean;
+    readonly approval?: {
+        readonly required: boolean;
+        readonly conditional?: boolean;
+    };
+    readonly handleCancellation?: boolean;
     readonly toMessage?: (output: unknown) => AgentMessage | undefined;
     readonly toModelOutput?: (output: unknown) => unknown;
     readonly handler?: (input: unknown, ctx: ToolContext | InterruptibleToolContext) => Promise<unknown>;

package/dist/utils/json-schema.d.ts

@@ -0,0 +1,3 @@
+import type { JSONSchema7 } from 'json-schema';
+export declare const fixSchema: (schema: JSONSchema7) => JSONSchema7;
+export declare function lockAdditionalProperties(schema: JSONSchema7): JSONSchema7;

package/dist/utils/json-schema.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fixSchema = void 0;
+exports.lockAdditionalProperties = lockAdditionalProperties;
+const fixSchema = (schema) => {
+    if (typeof schema === 'object' &&
+        schema !== null &&
+        'properties' in schema &&
+        !('type' in schema)) {
+        return { ...schema, type: 'object' };
+    }
+    return schema;
+};
+exports.fixSchema = fixSchema;
+function lockAdditionalProperties(schema) {
+    const result = lockDefinition(schema);
+    return typeof result === 'object' ? result : schema;
+}
+function lockDefinition(schema) {
+    if (typeof schema !== 'object' || schema === null)
+        return schema;
+    const result = { ...schema };
+    if (result.properties !== undefined && result.type === undefined) {
+        result.type = 'object';
+    }
+    const isObjectSchema = result.type === 'object' ||
+        (Array.isArray(result.type) && result.type.includes('object')) ||
+        result.properties !== undefined;
+    if (isObjectSchema && result.additionalProperties === undefined) {
+        result.additionalProperties = false;
+    }
+    if (result.properties) {
+        result.properties = mapDefinitions(result.properties);
+    }
+    if (result.$defs) {
+        result.$defs = mapDefinitions(result.$defs);
+    }
+    if (result.definitions) {
+        result.definitions = mapDefinitions(result.definitions);
+    }
+    if (result.items !== undefined) {
+        result.items = Array.isArray(result.items)
+            ? result.items.map(lockDefinition)
+            : lockDefinition(result.items);
+    }
+    if (typeof result.additionalProperties === 'object' && result.additionalProperties !== null) {
+        result.additionalProperties = lockDefinition(result.additionalProperties);
+    }
+    for (const key of ['allOf', 'anyOf', 'oneOf']) {
+        const branch = result[key];
+        if (Array.isArray(branch)) {
+            result[key] = branch.map(lockDefinition);
+        }
+    }
+    if (result.not !== undefined) {
+        result.not = lockDefinition(result.not);
+    }
+    return result;
+}
+function mapDefinitions(record) {
+    const out = {};
+    for (const [key, value] of Object.entries(record)) {
+        Object.defineProperty(out, key, {
+            value: lockDefinition(value),
+            enumerable: true,
+            writable: true,
+            configurable: true,
+        });
+    }
+    return out;
+}
+//# sourceMappingURL=json-schema.js.map

package/dist/utils/json-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-schema.js","sourceRoot":"","sources":["../../src/utils/json-schema.ts"],"names":[],"mappings":"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"}

package/dist/workspace/filesystem/daytona-filesystem.d.ts

@@ -0,0 +1,25 @@
+import type { CopyOptions, FileContent, FileEntry, FileStat, ListOptions, ProviderStatus, ReadOptions, RemoveOptions, WriteOptions } from '../types';
+import { BaseFilesystem } from './base-filesystem';
+import type { DaytonaSandbox } from '../sandbox/daytona-sandbox';
+export declare class DaytonaFilesystem extends BaseFilesystem {
+    private readonly sandbox;
+    readonly id: string;
+    readonly name = "DaytonaFilesystem";
+    readonly provider = "daytona";
+    status: ProviderStatus;
+    constructor(sandbox: DaytonaSandbox);
+    private withFs;
+    readFile(path: string, options?: ReadOptions): Promise<string | Buffer>;
+    writeFile(path: string, content: FileContent, options?: WriteOptions): Promise<void>;
+    appendFile(path: string, content: FileContent): Promise<void>;
+    deleteFile(path: string, options?: RemoveOptions): Promise<void>;
+    copyFile(src: string, dest: string, _options?: CopyOptions): Promise<void>;
+    moveFile(src: string, dest: string, _options?: CopyOptions): Promise<void>;
+    mkdir(path: string, _options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    rmdir(path: string, options?: RemoveOptions): Promise<void>;
+    readdir(path: string, _options?: ListOptions): Promise<FileEntry[]>;
+    exists(path: string): Promise<boolean>;
+    stat(path: string): Promise<FileStat>;
+}

package/dist/workspace/filesystem/daytona-filesystem.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DaytonaFilesystem = void 0;
+const base_filesystem_1 = require("./base-filesystem");
+class DaytonaFilesystem extends base_filesystem_1.BaseFilesystem {
+    constructor(sandbox) {
+        super();
+        this.sandbox = sandbox;
+        this.name = 'DaytonaFilesystem';
+        this.provider = 'daytona';
+        this.status = 'pending';
+        this.id = `daytona-fs-${sandbox.id}`;
+    }
+    async withFs(op) {
+        await this.ensureReady();
+        return await this.sandbox.withFilesystem(op);
+    }
+    async readFile(path, options) {
+        return await this.withFs(async (fs) => {
+            const buffer = await fs.downloadFile(path);
+            if (options?.encoding) {
+                return buffer.toString(options.encoding);
+            }
+            return buffer;
+        });
+    }
+    async writeFile(path, content, options) {
+        await this.withFs(async (fs) => {
+            if (options?.recursive) {
+                const dir = path.substring(0, path.lastIndexOf('/'));
+                if (dir) {
+                    await fs.createFolder(dir, '755');
+                }
+            }
+            const buffer = typeof content === 'string' ? Buffer.from(content, 'utf-8') : Buffer.from(content);
+            await fs.uploadFile(buffer, path);
+        });
+    }
+    async appendFile(path, content) {
+        await this.withFs(async (fs) => {
+            let existing;
+            try {
+                existing = await fs.downloadFile(path);
+            }
+            catch (error) {
+                if (!isDaytona404(error))
+                    throw error;
+                existing = Buffer.alloc(0);
+            }
+            const append = typeof content === 'string' ? Buffer.from(content, 'utf-8') : Buffer.from(content);
+            await fs.uploadFile(Buffer.concat([existing, append]), path);
+        });
+    }
+    async deleteFile(path, options) {
+        await this.withFs(async (fs) => await fs.deleteFile(path, options?.recursive));
+    }
+    async copyFile(src, dest, _options) {
+        await this.withFs(async (fs) => {
+            const content = await fs.downloadFile(src);
+            await fs.uploadFile(content, dest);
+        });
+    }
+    async moveFile(src, dest, _options) {
+        await this.withFs(async (fs) => await fs.moveFiles(src, dest));
+    }
+    async mkdir(path, _options) {
+        await this.withFs(async (fs) => await fs.createFolder(path, '755'));
+    }
+    async rmdir(path, options) {
+        await this.withFs(async (fs) => await fs.deleteFile(path, options?.recursive ?? false));
+    }
+    async readdir(path, _options) {
+        return await this.withFs(async (fs) => {
+            const files = await fs.listFiles(path);
+            return files.map((f) => ({
+                name: f.name ?? '',
+                type: f.isDir ? 'directory' : 'file',
+                size: f.size,
+            }));
+        });
+    }
+    async exists(path) {
+        return await this.withFs(async (fs) => {
+            try {
+                await fs.getFileDetails(path);
+                return true;
+            }
+            catch (error) {
+                if (isDaytona404(error))
+                    return false;
+                throw error;
+            }
+        });
+    }
+    async stat(path) {
+        return await this.withFs(async (fs) => {
+            let info;
+            try {
+                info = await fs.getFileDetails(path);
+            }
+            catch (error) {
+                if (isDaytona404(error)) {
+                    throw new DaytonaFileNotFoundError(path);
+                }
+                throw error;
+            }
+            return {
+                name: info.name ?? path.split('/').pop() ?? '',
+                path,
+                type: info.isDir ? 'directory' : 'file',
+                size: info.size ?? 0,
+                createdAt: new Date(info.modTime ?? 0),
+                modifiedAt: new Date(info.modTime ?? 0),
+            };
+        });
+    }
+}
+exports.DaytonaFilesystem = DaytonaFilesystem;
+class DaytonaFileNotFoundError extends Error {
+    constructor(path) {
+        super(`File not found: ${path}`);
+        this.name = 'DaytonaFileNotFoundError';
+    }
+}
+function isDaytona404(error) {
+    return (error instanceof Error &&
+        'statusCode' in error &&
+        error.statusCode === 404);
+}
+//# sourceMappingURL=daytona-filesystem.js.map

package/dist/workspace/filesystem/daytona-filesystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daytona-filesystem.js","sourceRoot":"","sources":["../../../src/workspace/filesystem/daytona-filesystem.ts"],"names":[],"mappings":"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"}

package/dist/workspace/filesystem/n8n-sandbox-filesystem.d.ts

@@ -0,0 +1,25 @@
+import type { CopyOptions, FileContent, FileEntry, FileStat, ListOptions, ProviderStatus, ReadOptions, RemoveOptions, WriteOptions } from '../types';
+import { BaseFilesystem } from './base-filesystem';
+import type { N8nSandboxServiceSandbox } from '../sandbox/n8n-sandbox-sandbox';
+export declare class N8nSandboxFilesystem extends BaseFilesystem {
+    private readonly sandbox;
+    readonly id: string;
+    readonly name = "N8nSandboxFilesystem";
+    readonly provider = "n8n-sandbox";
+    status: ProviderStatus;
+    constructor(sandbox: N8nSandboxServiceSandbox);
+    private getClientAndSandboxId;
+    readFile(path: string, options?: ReadOptions): Promise<string | Buffer>;
+    writeFile(path: string, content: FileContent, options?: WriteOptions): Promise<void>;
+    appendFile(path: string, content: FileContent): Promise<void>;
+    deleteFile(path: string, options?: RemoveOptions): Promise<void>;
+    copyFile(src: string, dest: string, options?: CopyOptions): Promise<void>;
+    moveFile(src: string, dest: string, options?: CopyOptions): Promise<void>;
+    mkdir(path: string, options?: {
+        recursive?: boolean;
+    }): Promise<void>;
+    rmdir(path: string, options?: RemoveOptions): Promise<void>;
+    readdir(path: string, _options?: ListOptions): Promise<FileEntry[]>;
+    exists(path: string): Promise<boolean>;
+    stat(path: string): Promise<FileStat>;
+}

package/dist/workspace/filesystem/n8n-sandbox-filesystem.js

@@ -0,0 +1,126 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.N8nSandboxFilesystem = void 0;
+const sandbox_client_1 = require("@n8n/sandbox-client");
+const posix_1 = require("node:path/posix");
+const base_filesystem_1 = require("./base-filesystem");
+function getParentDirectory(path) {
+    const parent = (0, posix_1.dirname)(path);
+    return parent === '.' || parent === '/' ? null : parent;
+}
+class N8nSandboxFilesystem extends base_filesystem_1.BaseFilesystem {
+    constructor(sandbox) {
+        super();
+        this.sandbox = sandbox;
+        this.name = 'N8nSandboxFilesystem';
+        this.provider = 'n8n-sandbox';
+        this.status = 'pending';
+        this.id = `n8n-sandbox-fs-${sandbox.id}`;
+    }
+    async getClientAndSandboxId() {
+        await this.sandbox.ensureRunning();
+        return {
+            client: this.sandbox.getClient(),
+            sandboxId: this.sandbox.id,
+        };
+    }
+    async readFile(path, options) {
+        await this.ensureReady();
+        const { client, sandboxId } = await this.getClientAndSandboxId();
+        const content = await client.readFile(sandboxId, path);
+        if (options?.encoding) {
+            return content.toString(options.encoding);
+        }
+        return content;
+    }
+    async writeFile(path, content, options) {
+        await this.ensureReady();
+        const { client, sandboxId } = await this.getClientAndSandboxId();
+        if (options?.recursive) {
+            const parent = getParentDirectory(path);
+            if (parent) {
+                await client.mkdir(sandboxId, parent, true);
+            }
+        }
+        await client.writeFile(sandboxId, path, content, options?.overwrite ?? true);
+    }
+    async appendFile(path, content) {
+        await this.ensureReady();
+        const { client, sandboxId } = await this.getClientAndSandboxId();
+        await client.appendFile(sandboxId, path, content);
+    }
+    async deleteFile(path, options) {
+        await this.ensureReady();
+        const { client, sandboxId } = await this.getClientAndSandboxId();
+        await client.deleteFile(sandboxId, path, {
+            recursive: options?.recursive,
+            force: options?.force,
+        });
+    }
+    async copyFile(src, dest, options) {
+        await this.ensureReady();
+        const { client, sandboxId } = await this.getClientAndSandboxId();
+        await client.copyFile(sandboxId, {
+            src,
+            dest,
+            recursive: options?.recursive,
+            overwrite: options?.overwrite,
+        });
+    }
+    async moveFile(src, dest, options) {
+        await this.ensureReady();
+        const { client, sandboxId } = await this.getClientAndSandboxId();
+        await client.moveFile(sandboxId, {
+            src,
+            dest,
+            overwrite: options?.overwrite,
+        });
+    }
+    async mkdir(path, options) {
+        await this.ensureReady();
+        const { client, sandboxId } = await this.getClientAndSandboxId();
+        await client.mkdir(sandboxId, path, options?.recursive ?? false);
+    }
+    async rmdir(path, options) {
+        await this.deleteFile(path, options);
+    }
+    async readdir(path, _options) {
+        await this.ensureReady();
+        const { client, sandboxId } = await this.getClientAndSandboxId();
+        const files = await client.listFiles(sandboxId, { path });
+        return files.map((entry) => ({
+            name: entry.name,
+            type: entry.isDir ? 'directory' : 'file',
+            size: entry.size,
+        }));
+    }
+    async exists(path) {
+        await this.ensureReady();
+        try {
+            const { client, sandboxId } = await this.getClientAndSandboxId();
+            await client.stat(sandboxId, path);
+            return true;
+        }
+        catch (error) {
+            if (error instanceof sandbox_client_1.SandboxServiceError && error.status === 404) {
+                return false;
+            }
+            throw error;
+        }
+    }
+    async stat(path) {
+        await this.ensureReady();
+        const { client, sandboxId } = await this.getClientAndSandboxId();
+        const stat = await client.stat(sandboxId, path);
+        return {
+            name: stat.name,
+            path: stat.path,
+            type: stat.type,
+            size: stat.size,
+            createdAt: new Date(stat.createdAt),
+            modifiedAt: new Date(stat.modifiedAt),
+        };
+    }
+}
+exports.N8nSandboxFilesystem = N8nSandboxFilesystem;
+//# sourceMappingURL=n8n-sandbox-filesystem.js.map

package/dist/workspace/filesystem/n8n-sandbox-filesystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"n8n-sandbox-filesystem.js","sourceRoot":"","sources":["../../../src/workspace/filesystem/n8n-sandbox-filesystem.ts"],"names":[],"mappings":";;;AAAA,wDAA0D;AAC1D,2CAA0C;AAa1C,uDAAmD;AAGnD,SAAS,kBAAkB,CAAC,IAAY;IACvC,MAAM,MAAM,GAAG,IAAA,eAAO,EAAC,IAAI,CAAC,CAAC;IAC7B,OAAO,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;AACzD,CAAC;AAGD,MAAa,oBAAqB,SAAQ,gCAAc;IASvD,YAA6B,OAAiC;QAC7D,KAAK,EAAE,CAAC;QADoB,YAAO,GAAP,OAAO,CAA0B;QANrD,SAAI,GAAG,sBAAsB,CAAC;QAE9B,aAAQ,GAAG,aAAa,CAAC;QAElC,WAAM,GAAmB,SAAS,CAAC;QAIlC,IAAI,CAAC,EAAE,GAAG,kBAAkB,OAAO,CAAC,EAAE,EAAE,CAAC;IAC1C,CAAC;IAEO,KAAK,CAAC,qBAAqB;QAClC,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC;QACnC,OAAO;YACN,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE;YAChC,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE;SAC1B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,OAAqB;QACjD,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACjE,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QACvD,IAAI,OAAO,EAAE,QAAQ,EAAE,CAAC;YACvB,OAAO,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,OAAO,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAY,EAAE,OAAoB,EAAE,OAAsB;QACzE,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACjE,IAAI,OAAO,EAAE,SAAS,EAAE,CAAC;YACxB,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,MAAM,EAAE,CAAC;gBACZ,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;YAC7C,CAAC;QACF,CAAC;QACD,MAAM,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,IAAI,IAAI,CAAC,CAAC;IAC9E,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,OAAoB;QAClD,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACjE,MAAM,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,OAAuB;QACrD,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACjE,MAAM,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,IAAI,EAAE;YACxC,SAAS,EAAE,OAAO,EAAE,SAAS;YAC7B,KAAK,EAAE,OAAO,EAAE,KAAK;SACrB,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAW,EAAE,IAAY,EAAE,OAAqB;QAC9D,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACjE,MAAM,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE;YAChC,GAAG;YACH,IAAI;YACJ,SAAS,EAAE,OAAO,EAAE,SAAS;YAC7B,SAAS,EAAE,OAAO,EAAE,SAAS;SAC7B,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,GAAW,EAAE,IAAY,EAAE,OAAqB;QAC9D,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACjE,MAAM,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE;YAChC,GAAG;YACH,IAAI;YACJ,SAAS,EAAE,OAAO,EAAE,SAAS;SAC7B,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,OAAiC;QAC1D,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACjE,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,IAAI,KAAK,CAAC,CAAC;IAClE,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,IAAY,EAAE,OAAuB;QAChD,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,QAAsB;QACjD,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACjE,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YAC5B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM;YACxC,IAAI,EAAE,KAAK,CAAC,IAAI;SAChB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACxB,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,IAAI,CAAC;YACJ,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;YACjE,MAAM,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACnC,OAAO,IAAI,CAAC;QACb,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,IAAI,KAAK,YAAY,oCAAmB,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAClE,OAAO,KAAK,CAAC;YACd,CAAC;YACD,MAAM,KAAK,CAAC;QACb,CAAC;IACF,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAY;QACtB,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE,CAAC;QACjE,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAChD,OAAO;YACN,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC;YACnC,UAAU,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC;SACrC,CAAC;IACH,CAAC;CACD;AAhID,oDAgIC"}

package/dist/workspace/sandbox/base-sandbox.d.ts

@@ -19,6 +19,7 @@ export declare abstract class BaseSandbox implements WorkspaceSandbox {
     _start(): Promise<void>;
     _stop(): Promise<void>;
     _destroy(): Promise<void>;
+    protected markNeedsStart(): void;
     ensureRunning(): Promise<void>;
     executeCommand(command: string, args?: string[], options?: ExecuteCommandOptions): Promise<CommandResult>;
     getInstructions(): string;

package/dist/workspace/sandbox/base-sandbox.js

@@ -75,6 +75,11 @@ class BaseSandbox {
             this.destroyPromise = undefined;
         }
     }
+    markNeedsStart() {
+        if (this.status === 'destroyed' || this.status === 'destroying')
+            return;
+        this.status = 'pending';
+    }
     async ensureRunning() {
         if (this.status === 'destroyed') {
             throw new Error(`Sandbox "${this.name}" has been destroyed`);