@mandible-ai/mandible 0.3.13 → 0.4.0

package/dist/src/providers/opencode.js

@@ -0,0 +1,170 @@
+// PURPOSE: withOpenCode — Provider-agnostic agentic coding via OpenCode SDK.
+// PURPOSE: Wraps the OpenCode Go server's TypeScript SDK for multi-provider LLM access.
+// ----------------------------------------------------------
+// Provider factory
+// ----------------------------------------------------------
+/**
+ * Creates an action handler powered by the OpenCode SDK.
+ *
+ * The SDK must be installed separately:
+ *   npm install @opencode-ai/sdk
+ *
+ * The OpenCode server must be running:
+ *   opencode serve
+ *
+ * The handler:
+ * 1. Connects to the OpenCode server via the SDK
+ * 2. Creates a session with the specified agent and model
+ * 3. Optionally injects a system prompt as a noReply message
+ * 4. Sends the main prompt (with optional structured output schema)
+ * 5. Extracts text and structured output from the response
+ * 6. Maps the output to signal deposits
+ * 7. Cleans up the session
+ */
+export function withOpenCode(config) {
+    const { serverUrl = 'http://localhost:4096', model, agent = 'build', prompt, systemPrompt, workingDirectory, timeout = 600_000, schema, onEvent, output, autoWithdraw = true, } = config;
+    return async (signal, ctx) => {
+        const startTime = Date.now();
+        // 1. Resolve prompt
+        const resolvedPrompt = typeof prompt === 'function'
+            ? await prompt(signal)
+            : prompt;
+        // 2. Resolve working directory
+        const cwd = typeof workingDirectory === 'function'
+            ? workingDirectory(signal)
+            : workingDirectory;
+        // 3. Dynamic import + full SDK interaction in try/catch
+        //    Catches MODULE_NOT_FOUND from both the import() and the SDK usage.
+        let client;
+        let sessionId;
+        try {
+            const sdk = await import('@opencode-ai/sdk');
+            const createOpencodeClient = sdk.createOpencodeClient;
+            // 4. Create client
+            client = createOpencodeClient({ baseUrl: serverUrl });
+            // 5. Create session
+            const sessionBody = {};
+            if (model)
+                sessionBody.model = model;
+            if (agent)
+                sessionBody.agent = agent;
+            if (cwd)
+                sessionBody.path = cwd;
+            const session = await client.session.create({ body: sessionBody });
+            sessionId = session.data.id;
+        }
+        catch (err) {
+            if (err.code === 'ERR_MODULE_NOT_FOUND' || err.code === 'MODULE_NOT_FOUND') {
+                throw new Error('withOpenCode requires @opencode-ai/sdk. Install it:\n' +
+                    '  npm install @opencode-ai/sdk');
+            }
+            throw err;
+        }
+        ctx.log(`OpenCode session ${sessionId} created (agent=${agent}${model ? `, model=${model}` : ''})`);
+        try {
+            // 6. Subscribe to events (fire-and-forget, errors swallowed)
+            if (onEvent) {
+                consumeEvents(client, onEvent).catch(() => { });
+            }
+            // 7. Inject system prompt as noReply message
+            if (systemPrompt) {
+                await client.session.prompt({
+                    path: { id: sessionId },
+                    body: {
+                        parts: [{ type: 'text', text: systemPrompt }],
+                        noReply: true,
+                    },
+                });
+            }
+            // 8. Send main prompt
+            const promptBody = {
+                parts: [{ type: 'text', text: resolvedPrompt }],
+            };
+            if (schema) {
+                promptBody.format = {
+                    type: 'json_schema',
+                    schema: schema.schema,
+                };
+            }
+            const response = await client.session.prompt({
+                path: { id: sessionId },
+                body: promptBody,
+                signal: AbortSignal.timeout(timeout),
+            });
+            // 9. Extract result
+            const durationMs = Date.now() - startTime;
+            const parts = response.data?.parts ?? [];
+            const textParts = parts.filter((p) => p.type === 'text');
+            const text = textParts.map((p) => p.text).join('\n');
+            const structuredOutput = response.data?.info?.structured_output;
+            const result = {
+                text,
+                structuredOutput,
+                durationMs,
+                sessionId: sessionId,
+            };
+            ctx.log(`OpenCode completed in ${durationMs}ms (session=${sessionId})`);
+            // 10. Deposit output signals
+            const deposits = resolveOutput(output, result, signal);
+            for (const deposit of deposits) {
+                await ctx.deposit(deposit.type, deposit.payload ?? { ...result }, {
+                    causedBy: [signal.id],
+                    tags: deposit.tags,
+                    ttl: deposit.ttl,
+                });
+            }
+            // 11. Auto-withdraw
+            if (autoWithdraw) {
+                await ctx.withdraw(signal.id);
+            }
+        }
+        finally {
+            // 12. Clean up session
+            if (sessionId) {
+                await client.session.delete({ path: { id: sessionId } }).catch(() => { });
+            }
+        }
+    };
+}
+// ----------------------------------------------------------
+// Default system prompt
+// ----------------------------------------------------------
+export function buildOpenCodeSystemPrompt(colonyName) {
+    return [
+        `You are an agent in the "${colonyName}" colony.`,
+        'Complete the task described in the prompt.',
+        'Be thorough but concise. Focus on the specific task at hand.',
+        'If you create or modify files, ensure they compile/pass tests.',
+    ].join('\n');
+}
+// ----------------------------------------------------------
+// Event consumer (background, non-blocking)
+// ----------------------------------------------------------
+async function consumeEvents(client, onEvent) {
+    const events = await client.event.subscribe();
+    for await (const event of events.stream) {
+        try {
+            onEvent(event);
+        }
+        catch { /* swallow callback errors */ }
+    }
+}
+// ----------------------------------------------------------
+// Output mapping (same 3-pattern as withClaudeCode/withQwenCode)
+// ----------------------------------------------------------
+function resolveOutput(output, result, signal) {
+    if (!output) {
+        return [{ type: `${signal.type}:completed`, payload: result }];
+    }
+    if (typeof output === 'function') {
+        const mapped = output(result, signal);
+        return Array.isArray(mapped) ? mapped : [mapped];
+    }
+    return [{
+            type: output.type,
+            payload: result,
+            tags: output.tags,
+            ttl: output.ttl,
+        }];
+}
+//# sourceMappingURL=opencode.js.map

package/dist/src/providers/opencode.js.map

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

package/dist/src/providers/openhands.d.ts

@@ -0,0 +1,102 @@
+import type { Signal } from '../core/types.js';
+import type { ActionHandler, OutputMapping } from './types.js';
+export interface OpenHandsConfig<T = Record<string, unknown>> {
+    /**
+     * OpenHands agent server URL.
+     * Default: 'http://localhost:3000'.
+     */
+    serverUrl?: string;
+    /**
+     * Bearer token for V1 API authentication.
+     * Sent as `Authorization: Bearer {apiKey}` when provided.
+     */
+    apiKey?: string;
+    /**
+     * Model in "provider/model" format for the OpenHands agent.
+     * e.g. 'openai/qwen3-coder', 'anthropic/claude-sonnet-4-5-20250929'
+     */
+    model?: string;
+    /**
+     * Git repository URL for the sandbox.
+     * Can be a static string or derived from the signal.
+     */
+    repository?: string | ((signal: Signal<T>) => string);
+    /**
+     * Build the prompt from the incoming signal.
+     * Can be a static string, or a function that receives the signal.
+     *
+     * For context assembly, capture the environment in a closure:
+     *   prompt: async (signal) => {
+     *     const ctx = await assembleContext(signal, env, { includeLineage: true });
+     *     return `${ctx}\n\nInvestigate this CI failure:\n${signal.payload.logs}`;
+     *   }
+     */
+    prompt: string | ((signal: Signal<T>) => string | Promise<string>);
+    /**
+     * Working directory for the OpenHands sandbox.
+     * Can be static or derived from the signal.
+     */
+    workingDirectory?: string | ((signal: Signal<T>) => string);
+    /**
+     * Timeout in ms for the entire conversation. Default: 900_000 (15 min).
+     * CI investigation can take a while — reproducing failures, installing deps, running tests.
+     */
+    timeout?: number;
+    /**
+     * Event callback for observability.
+     * Called with synthetic events derived from poll status changes.
+     * Errors in this callback are caught and do not crash the agent.
+     */
+    onEvent?: (event: OpenHandsEvent) => void;
+    /** Map output to signal deposits. */
+    output?: OutputMapping<T>;
+    /** Auto-withdraw the triggering signal. Default: true. */
+    autoWithdraw?: boolean;
+}
+/** Synthetic event emitted from poll status changes. */
+export interface OpenHandsEvent {
+    id: number;
+    source: 'agent' | 'user' | 'environment';
+    action?: string;
+    observation?: string;
+    message?: string;
+    args?: Record<string, unknown>;
+    content?: string;
+    extras?: Record<string, unknown>;
+    timestamp?: string;
+}
+/** Result of an OpenHands agent conversation. */
+export interface OpenHandsResult {
+    /** Final status of the conversation. */
+    status: 'finished' | 'error' | 'timeout' | 'stopped' | 'stuck';
+    /** Summary text from the agent's final message. */
+    text: string;
+    /** Conversation ID for debugging/tracing. */
+    conversationId: string;
+    /** Wall-clock duration in ms. */
+    durationMs: number;
+    /** Events received during the conversation. */
+    events: OpenHandsEvent[];
+}
+/**
+ * Creates an action handler powered by the OpenHands agent server (V1 API).
+ *
+ * OpenHands provides sandboxed terminal access inside Docker containers,
+ * which is ideal for CI investigation tasks that need to:
+ * - Fetch and parse CI logs
+ * - Reproduce build failures in isolation
+ * - Install dependencies and run tests
+ * - Propose fixes without affecting the host
+ *
+ * V1 Lifecycle:
+ * 1. POST /api/v1/app-conversations — create with initial message
+ * 2. GET /api/v1/app-conversations/start-tasks — poll until READY
+ * 3. GET /api/v1/app-conversations — poll until terminal state
+ */
+export declare function withOpenHands<T = Record<string, unknown>>(config: OpenHandsConfig<T>): ActionHandler<T>;
+export type OpenHandsErrorCode = 'CONVERSATION_CREATE_FAILED' | 'STARTUP_FAILED' | 'STARTUP_TIMEOUT';
+export declare class OpenHandsError extends Error {
+    readonly code: OpenHandsErrorCode;
+    constructor(code: OpenHandsErrorCode, message: string);
+}
+//# sourceMappingURL=openhands.d.ts.map

package/dist/src/providers/openhands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openhands.d.ts","sourceRoot":"","sources":["../../../src/providers/openhands.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAiB,MAAM,YAAY,CAAC;AAM9E,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC1D;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC;IAEtD;;;;;;;;;OASG;IACH,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAEnE;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC;IAE5D;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,CAAC;IAE1C,qCAAqC;IACrC,MAAM,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAE1B,0DAA0D;IAC1D,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAMD,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,aAAa,CAAC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,iDAAiD;AACjD,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,MAAM,EAAE,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IAC/D,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,MAAM,EAAE,cAAc,EAAE,CAAC;CAC1B;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvD,MAAM,EAAE,eAAe,CAAC,CAAC,CAAC,GACzB,aAAa,CAAC,CAAC,CAAC,CA6HlB;AAiMD,MAAM,MAAM,kBAAkB,GAC1B,4BAA4B,GAC5B,gBAAgB,GAChB,iBAAiB,CAAC;AAEtB,qBAAa,cAAe,SAAQ,KAAK;aAErB,IAAI,EAAE,kBAAkB;gBAAxB,IAAI,EAAE,kBAAkB,EACxC,OAAO,EAAE,MAAM;CAKlB"}

package/dist/src/providers/openhands.js

@@ -0,0 +1,234 @@
+// PURPOSE: withOpenHands — Sandboxed agentic coding via OpenHands agent server (V1 API).
+// PURPOSE: REST client for CI investigation and DevOps tasks in isolated containers.
+// ----------------------------------------------------------
+// Provider factory
+// ----------------------------------------------------------
+/**
+ * Creates an action handler powered by the OpenHands agent server (V1 API).
+ *
+ * OpenHands provides sandboxed terminal access inside Docker containers,
+ * which is ideal for CI investigation tasks that need to:
+ * - Fetch and parse CI logs
+ * - Reproduce build failures in isolation
+ * - Install dependencies and run tests
+ * - Propose fixes without affecting the host
+ *
+ * V1 Lifecycle:
+ * 1. POST /api/v1/app-conversations — create with initial message
+ * 2. GET /api/v1/app-conversations/start-tasks — poll until READY
+ * 3. GET /api/v1/app-conversations — poll until terminal state
+ */
+export function withOpenHands(config) {
+    const { serverUrl = 'http://localhost:3000', apiKey, model, repository, prompt, workingDirectory, timeout = 900_000, onEvent, output, autoWithdraw = true, } = config;
+    return async (signal, ctx) => {
+        const startTime = Date.now();
+        const baseUrl = serverUrl.replace(/\/$/, '');
+        // Build shared headers
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        if (apiKey) {
+            headers['Authorization'] = `Bearer ${apiKey}`;
+        }
+        // 1. Resolve prompt
+        const resolvedPrompt = typeof prompt === 'function'
+            ? await prompt(signal)
+            : prompt;
+        // 2. Resolve working directory
+        const cwd = typeof workingDirectory === 'function'
+            ? workingDirectory(signal)
+            : workingDirectory;
+        // 3. Resolve repository
+        const repo = typeof repository === 'function'
+            ? repository(signal)
+            : repository;
+        // 4. Create conversation with initial message
+        const events = [];
+        const createBody = {
+            initial_message: resolvedPrompt,
+        };
+        if (repo !== undefined)
+            createBody.repository = repo;
+        if (model !== undefined)
+            createBody.selected_model = model;
+        if (cwd !== undefined)
+            createBody.initial_cwd = cwd;
+        const createRes = await fetchWithTimeout(`${baseUrl}/api/v1/app-conversations`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(createBody),
+        }, 30_000);
+        if (!createRes.ok) {
+            const errorText = await createRes.text().catch(() => 'unknown error');
+            throw new OpenHandsError('CONVERSATION_CREATE_FAILED', `Failed to create OpenHands conversation: ${createRes.status} ${errorText}`);
+        }
+        const createData = await createRes.json();
+        const conversationId = createData.conversation_id;
+        if (!conversationId) {
+            throw new OpenHandsError('CONVERSATION_CREATE_FAILED', 'OpenHands returned no conversation ID');
+        }
+        ctx.log(`OpenHands conversation ${conversationId} created`);
+        // 5. Wait for startup
+        await waitForStartup(baseUrl, conversationId, headers, 60_000, ctx);
+        // 6. Wait for completion
+        const result = await waitForCompletion(baseUrl, conversationId, headers, timeout, events, onEvent, ctx);
+        const durationMs = Date.now() - startTime;
+        const openHandsResult = {
+            status: result.status,
+            text: result.text,
+            conversationId,
+            durationMs,
+            events,
+        };
+        ctx.log(`OpenHands ${result.status} in ${durationMs}ms ` +
+            `(conversation=${conversationId}, events=${events.length})`);
+        // 7. Deposit output signals
+        const deposits = resolveOutput(output, openHandsResult, signal);
+        for (const deposit of deposits) {
+            await ctx.deposit(deposit.type, deposit.payload ?? { ...openHandsResult }, {
+                causedBy: [signal.id],
+                tags: deposit.tags,
+                ttl: deposit.ttl,
+            });
+        }
+        // 8. Auto-withdraw
+        if (autoWithdraw) {
+            await ctx.withdraw(signal.id);
+        }
+    };
+}
+// ----------------------------------------------------------
+// Startup polling
+// ----------------------------------------------------------
+/**
+ * Wait for the OpenHands conversation sandbox to be ready.
+ * Polls the start-tasks endpoint until READY or ERROR.
+ */
+async function waitForStartup(baseUrl, conversationId, headers, startupTimeout, ctx) {
+    const deadline = Date.now() + startupTimeout;
+    const pollInterval = 2_000;
+    while (Date.now() < deadline) {
+        const res = await fetchWithTimeout(`${baseUrl}/api/v1/app-conversations/start-tasks?ids=${encodeURIComponent(conversationId)}`, { method: 'GET', headers }, 10_000).catch(() => null);
+        if (res?.ok) {
+            const data = await res.json().catch(() => ({}));
+            const tasks = data.tasks;
+            if (tasks && tasks.length > 0) {
+                const task = tasks[0];
+                const status = task.status;
+                if (status === 'READY') {
+                    return;
+                }
+                if (status === 'ERROR') {
+                    throw new OpenHandsError('STARTUP_FAILED', `OpenHands startup failed for conversation ${conversationId}`);
+                }
+            }
+        }
+        await sleep(pollInterval);
+    }
+    throw new OpenHandsError('STARTUP_TIMEOUT', `OpenHands startup timed out after ${startupTimeout}ms for conversation ${conversationId}`);
+}
+// ----------------------------------------------------------
+// Completion polling
+// ----------------------------------------------------------
+/**
+ * Wait for the OpenHands conversation to reach a terminal state.
+ * Polls the conversations endpoint and emits synthetic events on status changes.
+ */
+async function waitForCompletion(baseUrl, conversationId, headers, timeout, events, onEvent, ctx) {
+    const deadline = Date.now() + timeout;
+    const pollInterval = 5_000;
+    let lastStatus = '';
+    while (Date.now() < deadline) {
+        const statusRes = await fetchWithTimeout(`${baseUrl}/api/v1/app-conversations?ids=${encodeURIComponent(conversationId)}`, { method: 'GET', headers }, 10_000).catch(() => null);
+        if (statusRes?.ok) {
+            const statusData = await statusRes.json().catch((err) => {
+                ctx.log(`Warning: failed to parse poll response: ${err.message}`, 'warn');
+                return {};
+            });
+            const conversations = statusData.conversations;
+            if (conversations && conversations.length > 0) {
+                const conv = conversations[0];
+                const executionStatus = conv.execution_status;
+                const sandboxStatus = conv.sandbox_status;
+                const lastMessage = conv.last_message;
+                // Emit synthetic event on status change
+                const currentStatus = `${executionStatus}:${sandboxStatus}`;
+                if (currentStatus !== lastStatus) {
+                    lastStatus = currentStatus;
+                    const event = {
+                        id: events.length + 1,
+                        source: 'environment',
+                        observation: 'status_change',
+                        message: `execution=${executionStatus} sandbox=${sandboxStatus}`,
+                        timestamp: new Date().toISOString(),
+                    };
+                    events.push(event);
+                    if (onEvent) {
+                        try {
+                            onEvent(event);
+                        }
+                        catch { /* swallow callback errors */ }
+                    }
+                }
+                // Check terminal states
+                if (executionStatus === 'FINISHED') {
+                    return { status: 'finished', text: lastMessage ?? '' };
+                }
+                if (executionStatus === 'ERROR') {
+                    return { status: 'error', text: lastMessage ?? 'Agent encountered an error' };
+                }
+                if (executionStatus === 'STUCK') {
+                    return { status: 'stuck', text: lastMessage ?? 'Agent is stuck' };
+                }
+                if (sandboxStatus === 'ERROR') {
+                    return { status: 'error', text: lastMessage ?? 'Sandbox error' };
+                }
+                if (executionStatus === 'PAUSED' && sandboxStatus === 'STOPPED') {
+                    return { status: 'stopped', text: lastMessage ?? 'Agent was stopped' };
+                }
+            }
+        }
+        await sleep(pollInterval);
+    }
+    return { status: 'timeout', text: 'Agent timed out' };
+}
+// ----------------------------------------------------------
+// Helpers
+// ----------------------------------------------------------
+/** fetch() with AbortSignal.timeout. */
+async function fetchWithTimeout(url, init, timeoutMs) {
+    return fetch(url, {
+        ...init,
+        signal: AbortSignal.timeout(timeoutMs),
+    });
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+// ----------------------------------------------------------
+// Output mapping (same 3-pattern as withOpenCode/withClaudeCode)
+// ----------------------------------------------------------
+function resolveOutput(output, result, signal) {
+    if (!output) {
+        return [{ type: `${signal.type}:completed`, payload: result }];
+    }
+    if (typeof output === 'function') {
+        const mapped = output(result, signal);
+        return Array.isArray(mapped) ? mapped : [mapped];
+    }
+    return [{
+            type: output.type,
+            payload: result,
+            tags: output.tags,
+            ttl: output.ttl,
+        }];
+}
+export class OpenHandsError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = 'OpenHandsError';
+    }
+}
+//# sourceMappingURL=openhands.js.map

package/dist/src/providers/openhands.js.map

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

package/dist/src/providers/qwen-code.d.ts

@@ -0,0 +1,69 @@
+import type { Signal } from '../core/types.js';
+import type { ActionHandler, OutputMapping } from './types.js';
+export interface QwenCodeConfig<T = Record<string, unknown>> {
+    /** vLLM endpoint — sets OPENAI_BASE_URL for qwen-code. */
+    endpoint: string;
+    /** Model name. Default: 'Qwen3-Coder-Next'. */
+    model?: string;
+    /** Optional API key — sets OPENAI_API_KEY for qwen-code. */
+    apiKey?: string;
+    /** Build the prompt from the incoming signal. */
+    prompt: string | ((signal: Signal<T>) => string | Promise<string>);
+    /**
+     * Working directory for the qwen-code session.
+     * Can be static or derived from the signal.
+     */
+    workingDirectory?: string | ((signal: Signal<T>) => string);
+    /**
+     * Maximum conversation turns for qwen-code. Default: 20.
+     * Maps to qwen-code's --max-turns flag.
+     */
+    maxTurns?: number;
+    /** Timeout in ms for the entire session. Default: 600_000 (10 min). */
+    timeout?: number;
+    /**
+     * Shell commands the agent is allowed to run.
+     * If not set, qwen-code uses its default allowed commands.
+     */
+    allowedCommands?: string[];
+    /**
+     * Additional environment variables to pass to the subprocess.
+     */
+    env?: Record<string, string>;
+    /**
+     * Path to the qwen-code binary. Default: 'qwen-code' (from PATH).
+     */
+    binary?: string;
+    /**
+     * Map the output to signal deposits.
+     * If not provided, deposits the raw result.
+     */
+    output?: OutputMapping<T>;
+    /** Whether to auto-withdraw the triggering signal. Default: true. */
+    autoWithdraw?: boolean;
+    /**
+     * Observability hook — called with chunks of stdout as they arrive.
+     * Use for real-time logging or progress tracking.
+     */
+    onOutput?: (chunk: string) => void;
+}
+export interface QwenCodeResult {
+    /** Combined stdout from the qwen-code session. */
+    text: string;
+    /** stderr output (usually progress/debug info). */
+    stderr: string;
+    /** Process exit code. 0 = success. */
+    exitCode: number;
+    /** Wall-clock duration in ms. */
+    durationMs: number;
+    /** Whether the session completed successfully (exit code 0). */
+    success: boolean;
+    /** Whether the session was killed by timeout. */
+    timedOut: boolean;
+}
+/**
+ * Creates an action handler that spawns a qwen-code subprocess.
+ * The subprocess runs against local vLLM and executes agentic coding tasks.
+ */
+export declare function withQwenCode<T = Record<string, unknown>>(config: QwenCodeConfig<T>): ActionHandler<T>;
+//# sourceMappingURL=qwen-code.d.ts.map

package/dist/src/providers/qwen-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qwen-code.d.ts","sourceRoot":"","sources":["../../../src/providers/qwen-code.ts"],"names":[],"mappings":"AAuCA,OAAO,KAAK,EAAE,MAAM,EAAiB,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAiB,MAAM,YAAY,CAAC;AAM9E,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACzD,0DAA0D;IAC1D,QAAQ,EAAE,MAAM,CAAC;IAEjB,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,iDAAiD;IACjD,MAAM,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAEnE;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC;IAE5D;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,uEAAuE;IACvE,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE7B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IAE1B,qEAAqE;IACrE,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAMD,MAAM,WAAW,cAAc;IAC7B,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IAEb,mDAAmD;IACnD,MAAM,EAAE,MAAM,CAAC;IAEf,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IAEjB,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;IAEnB,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;IAEjB,iDAAiD;IACjD,QAAQ,EAAE,OAAO,CAAC;CACnB;AAMD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACtD,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,aAAa,CAAC,CAAC,CAAC,CAuElB"}