deepclause-sdk 0.0.59 → 0.0.60

package/dist/system/runtime/dml-executor.d.ts

@@ -0,0 +1,41 @@
+import type { Config } from '../../cli/config.js';
+import type { DMLEvent, DeepClauseSDK } from '../../types.js';
+import type { ResolvedModelConfig } from '../config/model-slots.js';
+import { type ShellManager } from './shell-manager.js';
+export interface DmlExecutionContext {
+    config: Config;
+    workspacePath: string;
+    selection: ResolvedModelConfig;
+    shell: ShellManager;
+}
+export interface ExecuteDmlOptions {
+    dmlCode: string;
+    config: Config;
+    workspacePath: string;
+    selection: ResolvedModelConfig;
+    args?: string[];
+    params?: Record<string, unknown>;
+    gasLimit?: number;
+    stream?: boolean;
+    trace?: boolean;
+    verbose?: boolean;
+    headless?: boolean;
+    sandbox?: boolean;
+    signal?: AbortSignal;
+    onUserInput?: (prompt: string) => Promise<string>;
+    initialMessages?: Array<{
+        role: 'user' | 'assistant';
+        content: string;
+    }>;
+    onEvent?: (event: DMLEvent) => void;
+    registerAdditionalTools?: (sdk: DeepClauseSDK, context: DmlExecutionContext) => Promise<void> | void;
+}
+export interface ExecuteDmlResult {
+    output: string[];
+    answer?: string;
+    error?: string;
+    trace?: object;
+    events: DMLEvent[];
+}
+export declare function executeDml(options: ExecuteDmlOptions): Promise<ExecuteDmlResult>;
+//# sourceMappingURL=dml-executor.d.ts.map

package/dist/system/runtime/dml-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dml-executor.d.ts","sourceRoot":"","sources":["../../../src/system/runtime/dml-executor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGpE,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE3E,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,mBAAmB,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;IACpC,uBAAuB,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACtG;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,QAAQ,EAAE,CAAC;CACpB;AAED,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAYtF"}

package/dist/system/runtime/dml-executor.js

@@ -0,0 +1,137 @@
+import { createDeepClause } from '../../sdk.js';
+import { applyResolvedModelConfig } from '../../cli/config.js';
+import { withCapturedConsole } from './console-capture.js';
+import { registerLocalRuntimeTools } from './runtime-tools.js';
+import { createShellManager } from './shell-manager.js';
+export async function executeDml(options) {
+    if (options.headless && options.onEvent) {
+        return withCapturedConsole((entry) => options.onEvent?.({
+            type: 'log',
+            content: `[${entry.level}] ${entry.text}`,
+        }), () => executeDmlInternal(options));
+    }
+    return executeDmlInternal(options);
+}
+async function executeDmlInternal(options) {
+    applyResolvedModelConfig(options.selection);
+    const shell = createShellManager({
+        workspacePath: options.workspacePath,
+        sandbox: options.sandbox,
+        network: options.config.agentvm?.network ?? false,
+    });
+    const sdk = await createDeepClause({
+        model: options.selection.model,
+        provider: options.selection.provider,
+        apiKey: options.selection.apiKey,
+        baseUrl: options.selection.baseUrl,
+        temperature: options.selection.temperature,
+        trace: !!options.trace,
+        streaming: options.stream,
+        debug: options.verbose,
+        maxTokens: 65536,
+    });
+    const result = {
+        output: [],
+        events: [],
+    };
+    try {
+        registerLocalRuntimeTools(sdk, {
+            workspacePath: options.workspacePath,
+            shell,
+            signal: options.signal,
+        });
+        await options.registerAdditionalTools?.(sdk, {
+            config: options.config,
+            workspacePath: options.workspacePath,
+            selection: options.selection,
+            shell,
+        });
+        let finished = false;
+        for await (const event of sdk.runDML(options.dmlCode, {
+            args: options.args,
+            params: options.params,
+            workspacePath: options.workspacePath,
+            gasLimit: options.gasLimit,
+            signal: options.signal,
+            onUserInput: options.onUserInput,
+            initialMessages: options.initialMessages,
+        })) {
+            if (finished) {
+                break;
+            }
+            result.events.push(event);
+            options.onEvent?.(event);
+            switch (event.type) {
+                case 'output':
+                    if (event.content) {
+                        result.output.push(event.content);
+                        if (!options.headless) {
+                            console.log(event.content);
+                        }
+                    }
+                    break;
+                case 'stream':
+                    if (options.stream && !options.headless && event.content) {
+                        process.stdout.write(event.content);
+                    }
+                    if (options.stream && !options.headless && event.done) {
+                        process.stdout.write('\n');
+                    }
+                    break;
+                case 'log':
+                    if (options.verbose && event.content && !options.headless) {
+                        console.log(`[log] ${event.content}`);
+                    }
+                    break;
+                case 'tool_call':
+                    if (!options.headless && options.verbose && event.toolName) {
+                        console.log(`  🔧 ${event.toolName}(${formatToolArgs(event.toolArgs)})`);
+                    }
+                    break;
+                case 'answer':
+                    result.answer = event.content;
+                    break;
+                case 'error':
+                    result.error = event.content;
+                    if (event.trace) {
+                        result.trace = event.trace;
+                    }
+                    finished = true;
+                    break;
+                case 'finished':
+                    if (event.trace) {
+                        result.trace = event.trace;
+                    }
+                    finished = true;
+                    break;
+                case 'input_required':
+                    if (options.verbose && event.prompt && !options.headless) {
+                        console.log(`[input_required] ${event.prompt}`);
+                    }
+                    break;
+                case 'usage':
+                    break;
+            }
+        }
+        return result;
+    }
+    finally {
+        await sdk.dispose();
+        await shell.dispose();
+    }
+}
+function formatToolArgs(args) {
+    if (!args) {
+        return '';
+    }
+    const parts = [];
+    for (const [key, value] of Object.entries(args)) {
+        let rendered = typeof value === 'string' ? value : JSON.stringify(value);
+        if (rendered.length > 50) {
+            rendered = rendered.slice(0, 47) + '...';
+        }
+        parts.push(`${key}=${rendered}`);
+    }
+    return parts.join(', ');
+}
+//# sourceMappingURL=dml-executor.js.map

package/dist/system/runtime/dml-executor.js.map

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

package/dist/system/runtime/runtime-tools.d.ts

@@ -0,0 +1,16 @@
+import type { Config } from '../../cli/config.js';
+import type { DeepClauseSDK } from '../../types.js';
+import type { ShellManager } from './shell-manager.js';
+export declare function getBuiltInRuntimeToolNames(): string[];
+export declare function verifyRuntimeToolsAvailable(config: Config, toolNames: string[]): {
+    available: boolean;
+    missing: string[];
+};
+export declare function registerLocalRuntimeTools(sdk: DeepClauseSDK, options: {
+    workspacePath: string;
+    shell: ShellManager;
+    signal?: AbortSignal;
+}): void;
+export declare function urlFetch(workspacePath: string, args: Record<string, unknown>, signal?: AbortSignal): Promise<Record<string, unknown>>;
+export declare function resolveWorkspacePath(workspacePath: string, filePath: string): string;
+//# sourceMappingURL=runtime-tools.d.ts.map

package/dist/system/runtime/runtime-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-tools.d.ts","sourceRoot":"","sources":["../../../src/system/runtime/runtime-tools.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAYvD,wBAAgB,0BAA0B,IAAI,MAAM,EAAE,CAErD;AAED,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EAAE,GAClB;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAiB3C;AAED,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE;IACP,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GACA,IAAI,CA4EN;AAED,wBAAsB,QAAQ,CAC5B,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CA4BlC;AAED,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWpF"}

package/dist/system/runtime/runtime-tools.js

@@ -0,0 +1,146 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { newsSearch, webSearch } from '../../cli/search.js';
+const BUILT_IN_RUNTIME_TOOLS = new Set([
+    'vm_exec',
+    'bash',
+    'web_search',
+    'news_search',
+    'url_fetch',
+]);
+const INTERNAL_TOOLS = new Set(['ask_user', 'finish', 'set_result', 'store']);
+export function getBuiltInRuntimeToolNames() {
+    return [...BUILT_IN_RUNTIME_TOOLS].sort();
+}
+export function verifyRuntimeToolsAvailable(config, toolNames) {
+    const missing = toolNames.filter((name) => {
+        if (INTERNAL_TOOLS.has(name)) {
+            return false;
+        }
+        return !BUILT_IN_RUNTIME_TOOLS.has(name);
+    });
+    if (missing.length === 0) {
+        return { available: true, missing: [] };
+    }
+    if (config.mcp?.servers && Object.keys(config.mcp.servers).length > 0) {
+        return { available: true, missing: [] };
+    }
+    return { available: false, missing };
+}
+export function registerLocalRuntimeTools(sdk, options) {
+    sdk.registerTool('web_search', {
+        description: 'Search the web for information.',
+        parameters: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Search query.' },
+                count: { type: 'number', description: 'Maximum result count.' },
+                freshness: { type: 'string', description: 'Optional freshness filter.' },
+            },
+            required: ['query'],
+        },
+        execute: async (args) => webSearch({
+            query: String(args.query ?? args.arg1 ?? ''),
+            count: typeof args.count === 'number' ? args.count : 10,
+            freshness: typeof args.freshness === 'string' ? args.freshness : undefined,
+            signal: options.signal,
+        }),
+    });
+    sdk.registerTool('news_search', {
+        description: 'Search recent news.',
+        parameters: {
+            type: 'object',
+            properties: {
+                query: { type: 'string', description: 'Search query.' },
+                count: { type: 'number', description: 'Maximum result count.' },
+                freshness: { type: 'string', description: 'Optional freshness filter.' },
+            },
+            required: ['query'],
+        },
+        execute: async (args) => newsSearch({
+            query: String(args.query ?? args.arg1 ?? ''),
+            count: typeof args.count === 'number' ? args.count : 10,
+            freshness: typeof args.freshness === 'string' ? args.freshness : undefined,
+            signal: options.signal,
+        }),
+    });
+    sdk.registerTool('url_fetch', {
+        description: 'Fetch a URL or save it into the workspace.',
+        parameters: {
+            type: 'object',
+            properties: {
+                url: { type: 'string', description: 'Absolute URL to fetch.' },
+                headers: { type: 'object', description: 'Optional request headers.' },
+                save_to: { type: 'string', description: 'Optional workspace-relative output file.' },
+            },
+            required: ['url'],
+        },
+        execute: async (args) => urlFetch(options.workspacePath, args, options.signal),
+    });
+    sdk.registerTool('bash', {
+        description: 'Run a shell command in the active workspace shell.',
+        parameters: {
+            type: 'object',
+            properties: {
+                command: { type: 'string', description: 'Shell command to execute.' },
+            },
+            required: ['command'],
+        },
+        execute: async (args) => options.shell.exec(String(args.command ?? args.arg1 ?? ''), options.signal),
+    });
+    sdk.registerTool('vm_exec', {
+        description: 'Execute a shell command using the active workspace shell backend.',
+        parameters: {
+            type: 'object',
+            properties: {
+                command: { type: 'string', description: 'Shell command to execute.' },
+            },
+            required: ['command'],
+        },
+        execute: async (args) => options.shell.exec(String(args.command ?? args.arg1 ?? ''), options.signal),
+    });
+}
+export async function urlFetch(workspacePath, args, signal) {
+    const url = String(args.url ?? '');
+    if (!url) {
+        throw new Error('url is required');
+    }
+    const headers = isStringRecord(args.headers) ? args.headers : undefined;
+    const response = await fetch(url, { headers, signal });
+    const responseHeaders = Object.fromEntries(response.headers.entries());
+    if (typeof args.save_to === 'string' && args.save_to.trim()) {
+        const targetPath = resolveWorkspacePath(workspacePath, args.save_to);
+        await fs.mkdir(path.dirname(targetPath), { recursive: true });
+        const buffer = Buffer.from(await response.arrayBuffer());
+        await fs.writeFile(targetPath, buffer);
+        return {
+            file_path: targetPath,
+            size: buffer.byteLength,
+            status: response.status,
+            headers: responseHeaders,
+        };
+    }
+    return {
+        body: await response.text(),
+        status: response.status,
+        headers: responseHeaders,
+    };
+}
+export function resolveWorkspacePath(workspacePath, filePath) {
+    if (!filePath) {
+        throw new Error('Path is required');
+    }
+    const root = path.resolve(workspacePath);
+    const resolved = path.resolve(root, filePath);
+    if (resolved !== root && !resolved.startsWith(root + path.sep)) {
+        throw new Error(`Path must stay inside workspace: ${filePath}`);
+    }
+    return resolved;
+}
+function isStringRecord(value) {
+    if (!value || typeof value !== 'object' || Array.isArray(value)) {
+        return false;
+    }
+    return Object.values(value).every((entry) => typeof entry === 'string');
+}
+//# sourceMappingURL=runtime-tools.js.map

package/dist/system/runtime/runtime-tools.js.map

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

package/dist/system/runtime/shell-manager.d.ts

@@ -0,0 +1,20 @@
+import { type ShellExecResult } from './agentvm-manager.js';
+export interface ShellManager {
+    readonly kind: 'host' | 'sandbox';
+    exec(command: string, signal?: AbortSignal): Promise<ShellExecResult>;
+    dispose(): Promise<void>;
+}
+export interface CreateShellManagerOptions {
+    workspacePath: string;
+    sandbox?: boolean;
+    network?: boolean;
+}
+export declare class HostShellManager implements ShellManager {
+    private readonly workspacePath;
+    readonly kind: "host";
+    constructor(workspacePath: string);
+    exec(command: string, signal?: AbortSignal): Promise<ShellExecResult>;
+    dispose(): Promise<void>;
+}
+export declare function createShellManager(options: CreateShellManagerOptions): ShellManager;
+//# sourceMappingURL=shell-manager.d.ts.map

package/dist/system/runtime/shell-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-manager.d.ts","sourceRoot":"","sources":["../../../src/system/runtime/shell-manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAI5E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IACtE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,gBAAiB,YAAW,YAAY;IAGvC,OAAO,CAAC,QAAQ,CAAC,aAAa;IAF1C,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAU;gBAEH,aAAa,EAAE,MAAM;IAE5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,eAAe,CAAC;IAgGrE,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,YAAY,CAMnF"}

package/dist/system/runtime/shell-manager.js

@@ -0,0 +1,133 @@
+import { spawn } from 'child_process';
+import { AgentVMManager } from './agentvm-manager.js';
+const ABORT_FORCE_KILL_MS = 500;
+export class HostShellManager {
+    workspacePath;
+    kind = 'host';
+    constructor(workspacePath) {
+        this.workspacePath = workspacePath;
+    }
+    async exec(command, signal) {
+        if (signal?.aborted) {
+            throw abortError(signal.reason);
+        }
+        return new Promise((resolve, reject) => {
+            const child = spawn('bash', ['-lc', command], {
+                cwd: this.workspacePath,
+                env: process.env,
+                detached: process.platform !== 'win32',
+            });
+            let stdout = '';
+            let stderr = '';
+            child.stdout.setEncoding('utf8');
+            child.stderr.setEncoding('utf8');
+            child.stdout.on('data', (chunk) => {
+                stdout += chunk;
+            });
+            child.stderr.on('data', (chunk) => {
+                stderr += chunk;
+            });
+            let forceKillTimer = null;
+            let settled = false;
+            const finalizeReject = (error) => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                cleanup();
+                reject(error);
+            };
+            const finalizeResolve = (result) => {
+                if (settled) {
+                    return;
+                }
+                settled = true;
+                cleanup();
+                resolve(result);
+            };
+            const onAbort = () => {
+                terminateChildProcessTree(child, 'SIGTERM');
+                if (!forceKillTimer) {
+                    forceKillTimer = setTimeout(() => {
+                        if (child.exitCode === null && child.signalCode === null) {
+                            terminateChildProcessTree(child, 'SIGKILL');
+                        }
+                    }, ABORT_FORCE_KILL_MS);
+                    forceKillTimer.unref?.();
+                }
+                finalizeReject(abortError(signal?.reason));
+            };
+            const cleanup = () => {
+                signal?.removeEventListener('abort', onAbort);
+            };
+            signal?.addEventListener('abort', onAbort, { once: true });
+            child.once('error', (error) => {
+                if (forceKillTimer) {
+                    clearTimeout(forceKillTimer);
+                    forceKillTimer = null;
+                }
+                if (signal?.aborted) {
+                    finalizeReject(abortError(signal.reason));
+                    return;
+                }
+                finalizeReject(error);
+            });
+            child.once('close', (code, closeSignal) => {
+                if (forceKillTimer) {
+                    clearTimeout(forceKillTimer);
+                    forceKillTimer = null;
+                }
+                if (signal?.aborted) {
+                    finalizeReject(abortError(signal.reason));
+                    return;
+                }
+                const exitCode = typeof code === 'number' ? code : 1;
+                const signalSuffix = closeSignal ? ` (signal ${closeSignal})` : '';
+                finalizeResolve({
+                    success: exitCode === 0,
+                    stdout,
+                    stderr,
+                    exitCode,
+                    summary: exitCode === 0
+                        ? 'Command completed successfully'
+                        : (stderr || `Command failed with exit code ${exitCode}${signalSuffix}`),
+                });
+            });
+        });
+    }
+    async dispose() {
+        // No persistent process to clean up for host-shell execution.
+    }
+}
+export function createShellManager(options) {
+    if (options.sandbox) {
+        return new AgentVMManager(options.workspacePath, options.network ?? false);
+    }
+    return new HostShellManager(options.workspacePath);
+}
+function abortError(reason) {
+    return reason instanceof Error
+        ? reason
+        : Object.assign(new Error('This operation was aborted'), { name: 'AbortError' });
+}
+function terminateChildProcessTree(child, signal) {
+    if (typeof child.pid !== 'number' || child.pid <= 0) {
+        return;
+    }
+    if (process.platform !== 'win32') {
+        try {
+            process.kill(-child.pid, signal);
+            return;
+        }
+        catch {
+            // Fall back to the direct child when process groups are unavailable.
+        }
+    }
+    try {
+        child.kill(signal);
+    }
+    catch {
+        // Ignore termination races during cancellation.
+    }
+}
+//# sourceMappingURL=shell-manager.js.map

package/dist/system/runtime/shell-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-manager.js","sourceRoot":"","sources":["../../../src/system/runtime/shell-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,cAAc,EAAwB,MAAM,sBAAsB,CAAC;AAE5E,MAAM,mBAAmB,GAAG,GAAG,CAAC;AAchC,MAAM,OAAO,gBAAgB;IAGE;IAFpB,IAAI,GAAG,MAAe,CAAC;IAEhC,YAA6B,aAAqB;QAArB,kBAAa,GAAb,aAAa,CAAQ;IAAG,CAAC;IAEtD,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,MAAoB;QAC9C,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;YACpB,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAClC,CAAC;QAED,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,EAAE;gBAC5C,GAAG,EAAE,IAAI,CAAC,aAAa;gBACvB,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,QAAQ,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;aACvC,CAAC,CAAC;YAEH,IAAI,MAAM,GAAG,EAAE,CAAC;YAChB,IAAI,MAAM,GAAG,EAAE,CAAC;YAEhB,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACjC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;YACjC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;gBAChC,MAAM,IAAI,KAAK,CAAC;YAClB,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;gBAChC,MAAM,IAAI,KAAK,CAAC;YAClB,CAAC,CAAC,CAAC;YAEH,IAAI,cAAc,GAAyC,IAAI,CAAC;YAChE,IAAI,OAAO,GAAG,KAAK,CAAC;YACpB,MAAM,cAAc,GAAG,CAAC,KAAc,EAAE,EAAE;gBACxC,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO;gBACT,CAAC;gBACD,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,EAAE,CAAC;gBACV,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC,CAAC;YACF,MAAM,eAAe,GAAG,CAAC,MAAuB,EAAE,EAAE;gBAClD,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO;gBACT,CAAC;gBACD,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,EAAE,CAAC;gBACV,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC,CAAC;YAEF,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,yBAAyB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;gBAC5C,IAAI,CAAC,cAAc,EAAE,CAAC;oBACpB,cAAc,GAAG,UAAU,CAAC,GAAG,EAAE;wBAC/B,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;4BACzD,yBAAyB,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;wBAC9C,CAAC;oBACH,CAAC,EAAE,mBAAmB,CAAC,CAAC;oBACxB,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC;gBAC3B,CAAC;gBAED,cAAc,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;YAC7C,CAAC,CAAC;YACF,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAChD,CAAC,CAAC;YACF,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAE3D,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBAC5B,IAAI,cAAc,EAAE,CAAC;oBACnB,YAAY,CAAC,cAAc,CAAC,CAAC;oBAC7B,cAAc,GAAG,IAAI,CAAC;gBACxB,CAAC;gBACD,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;oBACpB,cAAc,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;oBAC1C,OAAO;gBACT,CAAC;gBACD,cAAc,CAAC,KAAK,CAAC,CAAC;YACxB,CAAC,CAAC,CAAC;YACH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,WAAW,EAAE,EAAE;gBACxC,IAAI,cAAc,EAAE,CAAC;oBACnB,YAAY,CAAC,cAAc,CAAC,CAAC;oBAC7B,cAAc,GAAG,IAAI,CAAC;gBACxB,CAAC;gBACD,IAAI,MAAM,EAAE,OAAO,EAAE,CAAC;oBACpB,cAAc,CAAC,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;oBAC1C,OAAO;gBACT,CAAC;gBACD,MAAM,QAAQ,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;gBACrD,MAAM,YAAY,GAAG,WAAW,CAAC,CAAC,CAAC,YAAY,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;gBACnE,eAAe,CAAC;oBACd,OAAO,EAAE,QAAQ,KAAK,CAAC;oBACvB,MAAM;oBACN,MAAM;oBACN,QAAQ;oBACR,OAAO,EAAE,QAAQ,KAAK,CAAC;wBACrB,CAAC,CAAC,gCAAgC;wBAClC,CAAC,CAAC,CAAC,MAAM,IAAI,iCAAiC,QAAQ,GAAG,YAAY,EAAE,CAAC;iBAC3E,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAO;QACX,8DAA8D;IAChE,CAAC;CACF;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAkC;IACnE,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO,IAAI,cAAc,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,IAAI,gBAAgB,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,UAAU,CAAC,MAAe;IACjC,OAAO,MAAM,YAAY,KAAK;QAC5B,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,4BAA4B,CAAC,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;AACrF,CAAC;AAED,SAAS,yBAAyB,CAAC,KAAmB,EAAE,MAAsB;IAC5E,IAAI,OAAO,KAAK,CAAC,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;QACpD,OAAO;IACT,CAAC;IAED,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACjC,OAAO;QACT,CAAC;QAAC,MAAM,CAAC;YACP,qEAAqE;QACvE,CAAC;IACH,CAAC;IAED,IAAI,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IAAC,MAAM,CAAC;QACP,gDAAgD;IAClD,CAAC;AACH,CAAC"}

package/dist/system/runtime/skill-creator.d.ts

@@ -0,0 +1,33 @@
+import type { AnalysisResult, DMLEvent } from '../../types.js';
+import type { Config } from '../../cli/config.js';
+import type { MetaFile } from '../../cli/compile.js';
+import type { ResolvedModelConfig } from '../config/model-slots.js';
+import { type TokenUsageByModel } from './token-usage.js';
+export interface SkillCreatorCompileOptions {
+    sourcePath: string;
+    outputDir: string;
+    baseName: string;
+    workspaceRoot?: string;
+    workspacePath: string;
+    config: Config;
+    compileSelection: ResolvedModelConfig;
+    runSelection: ResolvedModelConfig;
+    sandbox?: boolean;
+    validateOnly?: boolean;
+    maxAttempts?: number;
+    verbose?: boolean;
+    onUserInput?: (prompt: string) => Promise<string>;
+    signal?: AbortSignal;
+    onEvent?: (event: DMLEvent) => void;
+}
+export interface SkillCreatorCompileResult {
+    dml: string;
+    meta: MetaFile;
+    tools: string[];
+    outputPath: string;
+    explanation: string;
+    analysis: AnalysisResult;
+    usageByModel: TokenUsageByModel;
+}
+export declare function compileWithSkillCreator(markdown: string, options: SkillCreatorCompileOptions): Promise<SkillCreatorCompileResult>;
+//# sourceMappingURL=skill-creator.d.ts.map

package/dist/system/runtime/skill-creator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-creator.d.ts","sourceRoot":"","sources":["../../../src/system/runtime/skill-creator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAiB,MAAM,gBAAgB,CAAC;AAG9E,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAIpE,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAQ5E,MAAM,WAAW,0BAA0B;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,mBAAmB,CAAC;IACtC,YAAY,EAAE,mBAAmB,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClD,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,yBAAyB;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,QAAQ,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,cAAc,CAAC;IACzB,YAAY,EAAE,iBAAiB,CAAC;CACjC;AAcD,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,yBAAyB,CAAC,CAYpC"}