@mandible-ai/mandible 0.2.0 → 0.3.0

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

@@ -1,23 +0,0 @@
-import type { AgentProviderConfig, ActionHandler, BedrockConfig } from './types.js';
-/**
- * Creates an action handler powered by the Claude Agent SDK.
- *
- * The SDK must be installed separately:
- *   npm install @anthropic-ai/claude-agent-sdk
- *
- * The handler:
- * 1. Builds a prompt from the signal
- * 2. Spawns a Claude agent session via the SDK's query() AsyncGenerator
- * 3. Consumes all messages, calling onMessage for observability
- * 4. Extracts the final result (text, cost, duration, usage)
- * 5. Maps the agent's output to signal deposits
- * 6. Optionally withdraws the triggering signal
- */
-export declare function withAgent<T = Record<string, unknown>>(config: AgentProviderConfig<T>): ActionHandler<T>;
-/**
- * Builds env vars for routing the Claude Agent SDK through AWS Bedrock.
- * Exported for testing.
- */
-export declare function buildBedrockEnv(config: BedrockConfig): Record<string, string>;
-export declare function buildDefaultSystemPrompt(colonyName: string): string;
-//# sourceMappingURL=agent.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/providers/agent.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,mBAAmB,EAAe,aAAa,EAAiB,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACnD,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAC7B,aAAa,CAAC,CAAC,CAAC,CA6FlB;AAuDD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAuB7E;AAED,wBAAgB,wBAAwB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAOnE"}

package/dist/src/providers/agent.js

@@ -1,184 +0,0 @@
-// PURPOSE: withAgent — Claude Agent SDK provider for full agentic colony actions.
-// Wraps the Claude Agent SDK AsyncGenerator to give colonies coding capabilities.
-/**
- * Creates an action handler powered by the Claude Agent SDK.
- *
- * The SDK must be installed separately:
- *   npm install @anthropic-ai/claude-agent-sdk
- *
- * The handler:
- * 1. Builds a prompt from the signal
- * 2. Spawns a Claude agent session via the SDK's query() AsyncGenerator
- * 3. Consumes all messages, calling onMessage for observability
- * 4. Extracts the final result (text, cost, duration, usage)
- * 5. Maps the agent's output to signal deposits
- * 6. Optionally withdraws the triggering signal
- */
-export function withAgent(config) {
-    const { model = 'claude-sonnet-4-5-20250929', prompt, systemPrompt, allowedTools, tools, disallowedTools, workingDirectory, maxTurns, maxBudgetUsd = 1.0, permissionMode = 'bypassPermissions', onMessage, env, bedrock, output, autoWithdraw = true, } = config;
-    // Resolve allowedTools with backward compat for deprecated `tools`
-    const resolvedAllowedTools = allowedTools ?? tools;
-    return async (signal, ctx) => {
-        // 1. Resolve the prompt
-        const resolvedPrompt = typeof prompt === 'function'
-            ? await prompt(signal)
-            : prompt;
-        // 2. Resolve working directory
-        const cwd = typeof workingDirectory === 'function'
-            ? workingDirectory(signal)
-            : workingDirectory;
-        // 3. Call Claude Agent SDK
-        let agentResult;
-        try {
-            // Dynamic import — SDK is an optional peer dependency
-            const sdk = await import('@anthropic-ai/claude-agent-sdk');
-            const queryOptions = {
-                model,
-                systemPrompt: systemPrompt ?? buildDefaultSystemPrompt(ctx.colony),
-                cwd: cwd ?? process.cwd(),
-                permissionMode,
-                allowDangerouslySkipPermissions: permissionMode === 'bypassPermissions',
-                maxBudgetUsd,
-            };
-            if (resolvedAllowedTools)
-                queryOptions.allowedTools = resolvedAllowedTools;
-            if (disallowedTools)
-                queryOptions.disallowedTools = disallowedTools;
-            if (maxTurns !== undefined)
-                queryOptions.maxTurns = maxTurns;
-            // Merge Bedrock env vars with user-provided env (user takes precedence)
-            const bedrockEnv = bedrock ? buildBedrockEnv(bedrock) : undefined;
-            const mergedEnv = bedrockEnv || env
-                ? { ...bedrockEnv, ...env }
-                : undefined;
-            if (mergedEnv)
-                queryOptions.env = mergedEnv;
-            const generator = sdk.query({
-                prompt: resolvedPrompt,
-                options: queryOptions,
-            });
-            agentResult = await consumeGenerator(generator, onMessage);
-        }
-        catch (err) {
-            if (err.code === 'ERR_MODULE_NOT_FOUND' || err.code === 'MODULE_NOT_FOUND') {
-                throw new Error('withAgent requires @anthropic-ai/claude-agent-sdk. Install it:\n' +
-                    '  npm install @anthropic-ai/claude-agent-sdk');
-            }
-            throw err;
-        }
-        // 4. Deposit output signals
-        const deposits = resolveOutput(output, agentResult, signal);
-        for (const deposit of deposits) {
-            await ctx.deposit(deposit.type, deposit.payload ?? { ...agentResult }, {
-                causedBy: [signal.id],
-                tags: deposit.tags,
-                ttl: deposit.ttl,
-            });
-        }
-        // 5. Withdraw the triggering signal
-        if (autoWithdraw) {
-            await ctx.withdraw(signal.id);
-        }
-        ctx.log(`Agent completed (${agentResult.subtype}). Cost: $${agentResult.costUsd.toFixed(4)}, Duration: ${agentResult.durationMs}ms. Deposited ${deposits.length} signal(s).`);
-    };
-}
-// ----------------------------------------------------------
-// Helpers
-// ----------------------------------------------------------
-/**
- * Consumes the SDK's AsyncGenerator, collecting all messages and
- * extracting the final result from the SDKResultMessage.
- */
-async function consumeGenerator(generator, onMessage) {
-    const messages = [];
-    let resultMessage = null;
-    for await (const message of generator) {
-        messages.push(message);
-        // Call observability callback (errors must not crash the agent)
-        if (onMessage) {
-            try {
-                onMessage(message);
-            }
-            catch { /* swallow */ }
-        }
-        // Capture the result message when it arrives
-        if (message.type === 'result') {
-            resultMessage = message;
-        }
-    }
-    if (!resultMessage) {
-        return {
-            text: '',
-            costUsd: 0,
-            durationMs: 0,
-            usage: { input_tokens: 0, output_tokens: 0 },
-            subtype: 'error_during_execution',
-            messages,
-        };
-    }
-    return {
-        text: resultMessage.result ?? resultMessage.errors?.join('\n') ?? '',
-        costUsd: resultMessage.total_cost_usd ?? 0,
-        durationMs: resultMessage.duration_ms ?? 0,
-        usage: {
-            input_tokens: resultMessage.usage?.input_tokens ?? 0,
-            output_tokens: resultMessage.usage?.output_tokens ?? 0,
-        },
-        subtype: resultMessage.subtype ?? 'success',
-        messages,
-    };
-}
-/**
- * Builds env vars for routing the Claude Agent SDK through AWS Bedrock.
- * Exported for testing.
- */
-export function buildBedrockEnv(config) {
-    const env = {
-        CLAUDE_CODE_USE_BEDROCK: '1',
-        AWS_REGION: config.region,
-    };
-    if (config.model)
-        env.ANTHROPIC_MODEL = config.model;
-    if (config.accessKeyId)
-        env.AWS_ACCESS_KEY_ID = config.accessKeyId;
-    if (config.secretAccessKey)
-        env.AWS_SECRET_ACCESS_KEY = config.secretAccessKey;
-    if (config.sessionToken)
-        env.AWS_SESSION_TOKEN = config.sessionToken;
-    if (config.profile)
-        env.AWS_PROFILE = config.profile;
-    if (config.guardrailId) {
-        const headers = {
-            'x-amzn-bedrock-guardrail-identifier': config.guardrailId,
-        };
-        if (config.guardrailVersion) {
-            headers['x-amzn-bedrock-guardrail-version'] = config.guardrailVersion;
-        }
-        env.ANTHROPIC_CUSTOM_HEADERS = JSON.stringify(headers);
-    }
-    return env;
-}
-export function buildDefaultSystemPrompt(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');
-}
-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=agent.js.map

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

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