@charming_groot/agent 0.1.0

package/dist/session-manager.js

@@ -0,0 +1,101 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join, dirname } from 'node:path';
+import { createChildLogger } from '@charming_groot/core';
+/**
+ * Persists and restores agent conversations to/from disk.
+ *
+ * Usage:
+ *   const sm = new SessionManager('/path/to/sessions');
+ *   await sm.save(sessionId, messageManager);
+ *   await sm.load(sessionId, messageManager);
+ */
+export class SessionManager {
+    sessionsDir;
+    logger;
+    constructor(sessionsDir) {
+        this.sessionsDir = sessionsDir;
+        this.logger = createChildLogger('session-manager');
+    }
+    /** Save the current conversation to disk. */
+    async save(sessionId, manager) {
+        const filePath = this.sessionPath(sessionId);
+        await mkdir(dirname(filePath), { recursive: true });
+        let meta;
+        try {
+            const existing = await this.readSessionFile(filePath);
+            meta = {
+                sessionId,
+                createdAt: existing.meta.createdAt,
+                updatedAt: new Date().toISOString(),
+            };
+        }
+        catch {
+            meta = {
+                sessionId,
+                createdAt: new Date().toISOString(),
+                updatedAt: new Date().toISOString(),
+            };
+        }
+        const data = {
+            meta,
+            messages: manager.serialize(),
+        };
+        await writeFile(filePath, JSON.stringify(data, null, 2), 'utf-8');
+        this.logger.info({ sessionId, messages: manager.messageCount }, 'Session saved');
+    }
+    /** Restore a conversation from disk into the given MessageManager. */
+    async load(sessionId, manager) {
+        const filePath = this.sessionPath(sessionId);
+        const data = await this.readSessionFile(filePath);
+        manager.restore(data.messages);
+        this.logger.info({ sessionId, messages: manager.messageCount }, 'Session loaded');
+        return data.meta;
+    }
+    /** Check if a session file exists. */
+    async exists(sessionId) {
+        try {
+            await this.readSessionFile(this.sessionPath(sessionId));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /** List all session IDs in the sessions directory. */
+    async list() {
+        const { readdir } = await import('node:fs/promises');
+        try {
+            const entries = await readdir(this.sessionsDir);
+            const metas = [];
+            for (const entry of entries) {
+                if (!entry.endsWith('.session.json'))
+                    continue;
+                try {
+                    const data = await this.readSessionFile(join(this.sessionsDir, entry));
+                    metas.push(data.meta);
+                }
+                catch {
+                    // skip corrupt files
+                }
+            }
+            return metas.sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+        }
+        catch {
+            return [];
+        }
+    }
+    sessionPath(sessionId) {
+        // Sanitize sessionId to prevent path traversal
+        const safe = sessionId.replace(/[^a-zA-Z0-9_-]/g, '_');
+        return join(this.sessionsDir, `${safe}.session.json`);
+    }
+    async readSessionFile(filePath) {
+        const content = await readFile(filePath, 'utf-8');
+        const parsed = JSON.parse(content);
+        if (!parsed.meta || !parsed.messages) {
+            throw new Error('Invalid session file format');
+        }
+        return parsed;
+    }
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/session-manager.js.map

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

package/dist/skill-tool.d.ts

@@ -0,0 +1,38 @@
+import type { ITool, ToolDescription, ToolResult, JsonObject } from '@charming_groot/core';
+import type { RunContext } from '@charming_groot/core';
+/** Minimal skill shape — avoids hard dependency on @core/types */
+export interface SkillEntry {
+    readonly name: string;
+    readonly description: string;
+    readonly tools: readonly string[];
+    readonly prompt: string;
+    readonly rules: readonly string[];
+}
+/** Minimal registry interface — compatible with @core/skill SkillRegistry */
+export interface SkillProvider {
+    get(name: string): SkillEntry | undefined;
+    getAll(): readonly SkillEntry[];
+}
+/**
+ * An ITool that exposes the skill registry to the agent.
+ *
+ * Actions:
+ *   - "list"  → returns all available skill names and descriptions
+ *   - "invoke" → returns the skill's prompt, tools, and rules so the
+ *                 agent can adopt that behavior for the current task
+ *
+ * This enables CLI-style `/skill` invocation: the agent discovers
+ * available skills and activates one by reading its prompt guidance.
+ */
+export declare class SkillTool implements ITool {
+    readonly name = "skill";
+    readonly requiresPermission = false;
+    private readonly registry;
+    private readonly logger;
+    constructor(registry: SkillProvider);
+    describe(): ToolDescription;
+    execute(params: JsonObject, _context: RunContext): Promise<ToolResult>;
+    private listSkills;
+    private invokeSkill;
+}
+//# sourceMappingURL=skill-tool.d.ts.map

package/dist/skill-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-tool.d.ts","sourceRoot":"","sources":["../src/skill-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,eAAe,EACf,UAAU,EACV,UAAU,EAEX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGvD,kEAAkE;AAClE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAAC;IAC1C,MAAM,IAAI,SAAS,UAAU,EAAE,CAAC;CACjC;AAED;;;;;;;;;;GAUG;AACH,qBAAa,SAAU,YAAW,KAAK;IACrC,QAAQ,CAAC,IAAI,WAAW;IACxB,QAAQ,CAAC,kBAAkB,SAAS;IAEpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,QAAQ,EAAE,aAAa;IAKnC,QAAQ,IAAI,eAAe;IA8BrB,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAuB5E,OAAO,CAAC,UAAU;IAclB,OAAO,CAAC,WAAW;CAuCpB"}

package/dist/skill-tool.js

@@ -0,0 +1,112 @@
+import { createChildLogger } from '@charming_groot/core';
+/**
+ * An ITool that exposes the skill registry to the agent.
+ *
+ * Actions:
+ *   - "list"  → returns all available skill names and descriptions
+ *   - "invoke" → returns the skill's prompt, tools, and rules so the
+ *                 agent can adopt that behavior for the current task
+ *
+ * This enables CLI-style `/skill` invocation: the agent discovers
+ * available skills and activates one by reading its prompt guidance.
+ */
+export class SkillTool {
+    name = 'skill';
+    requiresPermission = false;
+    registry;
+    logger;
+    constructor(registry) {
+        this.registry = registry;
+        this.logger = createChildLogger('skill-tool');
+    }
+    describe() {
+        return {
+            name: this.name,
+            description: 'List or invoke predefined skills. ' +
+                'Use action="list" to see available skills, ' +
+                'or action="invoke" with name="<skill>" to activate a skill.',
+            parameters: [
+                {
+                    name: 'action',
+                    type: 'string',
+                    description: 'Action to perform: "list" or "invoke"',
+                    required: true,
+                },
+                {
+                    name: 'name',
+                    type: 'string',
+                    description: 'Skill name (required for "invoke")',
+                    required: false,
+                },
+                {
+                    name: 'input',
+                    type: 'string',
+                    description: 'Optional context/input to pass to the skill',
+                    required: false,
+                },
+            ],
+        };
+    }
+    async execute(params, _context) {
+        const action = params['action'];
+        if (action === 'list') {
+            return this.listSkills();
+        }
+        if (action === 'invoke') {
+            const name = params['name'];
+            if (typeof name !== 'string' || name.trim().length === 0) {
+                return { success: false, output: '', error: 'Missing "name" parameter for invoke action' };
+            }
+            const input = typeof params['input'] === 'string' ? params['input'] : undefined;
+            return this.invokeSkill(name, input);
+        }
+        return {
+            success: false,
+            output: '',
+            error: `Unknown action: "${String(action)}". Use "list" or "invoke".`,
+        };
+    }
+    listSkills() {
+        const skills = this.registry.getAll();
+        if (skills.length === 0) {
+            return { success: true, output: 'No skills available.' };
+        }
+        const lines = skills.map((s) => `- ${s.name}: ${s.description} [tools: ${s.tools.join(', ')}]`);
+        this.logger.debug({ count: skills.length }, 'Listed skills');
+        return { success: true, output: `Available skills:\n${lines.join('\n')}` };
+    }
+    invokeSkill(name, input) {
+        const skill = this.registry.get(name);
+        if (!skill) {
+            return { success: false, output: '', error: `Skill "${name}" not found` };
+        }
+        this.logger.info({ skill: name }, 'Skill invoked');
+        const sections = [
+            `## Skill: ${skill.name}`,
+            '',
+            skill.description,
+            '',
+            '### Prompt',
+            skill.prompt,
+        ];
+        if (skill.tools.length > 0) {
+            sections.push('', `### Available tools: ${skill.tools.join(', ')}`);
+        }
+        if (skill.rules.length > 0) {
+            sections.push('', `### Rules: ${skill.rules.join(', ')}`);
+        }
+        if (input) {
+            sections.push('', `### User input`, input);
+        }
+        return {
+            success: true,
+            output: sections.join('\n'),
+            metadata: {
+                skillName: skill.name,
+                tools: [...skill.tools],
+                rules: [...skill.rules],
+            },
+        };
+    }
+}
+//# sourceMappingURL=skill-tool.js.map

package/dist/skill-tool.js.map

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

package/dist/sub-agent-tool.d.ts

@@ -0,0 +1,39 @@
+import type { ITool, ILlmProvider, ToolDescription, ToolResult, JsonObject } from '@charming_groot/core';
+import { Registry, RunContext } from '@charming_groot/core';
+import type { SystemPromptBuilder } from './agent-loop.js';
+import type { PermissionHandler } from './permission.js';
+/** Configuration for creating a sub-agent tool. */
+export interface SubAgentToolConfig {
+    /** Display name for this sub-agent tool */
+    readonly name: string;
+    /** Description shown to the parent agent */
+    readonly description: string;
+    /** LLM provider the sub-agent will use */
+    readonly provider: ILlmProvider;
+    /** Tools available to the sub-agent */
+    readonly toolRegistry: Registry<ITool>;
+    /** System prompt or dynamic builder for the sub-agent */
+    readonly systemPrompt?: string;
+    readonly systemPromptBuilder?: SystemPromptBuilder;
+    /** Max iterations for the sub-agent (default: 25) */
+    readonly maxIterations?: number;
+    /** Permission handler for the sub-agent's tools */
+    readonly permissionHandler?: PermissionHandler;
+}
+/**
+ * Wraps an AgentLoop as an ITool so a parent agent can delegate
+ * sub-tasks to a child agent via tool calls.
+ *
+ * The parent sends a "task" parameter; the sub-agent runs autonomously
+ * and returns the final result as tool output.
+ */
+export declare class SubAgentTool implements ITool {
+    readonly name: string;
+    readonly requiresPermission = false;
+    private readonly config;
+    private readonly logger;
+    constructor(config: SubAgentToolConfig);
+    describe(): ToolDescription;
+    execute(params: JsonObject, context: RunContext): Promise<ToolResult>;
+}
+//# sourceMappingURL=sub-agent-tool.d.ts.map

package/dist/sub-agent-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sub-agent-tool.d.ts","sourceRoot":"","sources":["../src/sub-agent-tool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,YAAY,EACZ,eAAe,EACf,UAAU,EACV,UAAU,EAEX,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAqB,MAAM,sBAAsB,CAAC;AAE/E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,mDAAmD;AACnD,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,0CAA0C;IAC1C,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,uCAAuC;IACvC,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IACvC,yDAAyD;IACzD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;IACnD,qDAAqD;IACrD,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,mDAAmD;IACnD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;CAChD;AAID;;;;;;GAMG;AACH,qBAAa,YAAa,YAAW,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,kBAAkB,SAAS;IAEpC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,MAAM,EAAE,kBAAkB;IAMtC,QAAQ,IAAI,eAAe;IAerB,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;CAoD5E"}

package/dist/sub-agent-tool.js

@@ -0,0 +1,80 @@
+import { createChildLogger } from '@charming_groot/core';
+import { AgentLoop } from './agent-loop.js';
+const DEFAULT_MAX_ITERATIONS = 25;
+/**
+ * Wraps an AgentLoop as an ITool so a parent agent can delegate
+ * sub-tasks to a child agent via tool calls.
+ *
+ * The parent sends a "task" parameter; the sub-agent runs autonomously
+ * and returns the final result as tool output.
+ */
+export class SubAgentTool {
+    name;
+    requiresPermission = false;
+    config;
+    logger;
+    constructor(config) {
+        this.name = config.name;
+        this.config = config;
+        this.logger = createChildLogger(`sub-agent:${config.name}`);
+    }
+    describe() {
+        return {
+            name: this.name,
+            description: this.config.description,
+            parameters: [
+                {
+                    name: 'task',
+                    type: 'string',
+                    description: 'The task to delegate to the sub-agent',
+                    required: true,
+                },
+            ],
+        };
+    }
+    async execute(params, context) {
+        const task = params['task'];
+        if (typeof task !== 'string' || task.trim().length === 0) {
+            return { success: false, output: '', error: 'Missing or empty "task" parameter' };
+        }
+        this.logger.info({ task: task.slice(0, 200) }, 'Sub-agent starting');
+        const childLoop = new AgentLoop({
+            provider: this.config.provider,
+            toolRegistry: this.config.toolRegistry,
+            config: {
+                provider: {
+                    providerId: this.config.provider.providerId,
+                    model: 'sub-agent',
+                    auth: { type: 'api-key', apiKey: '' },
+                    maxTokens: 4096,
+                    temperature: 0.7,
+                },
+                maxIterations: this.config.maxIterations ?? DEFAULT_MAX_ITERATIONS,
+                workingDirectory: context.workingDirectory,
+                systemPrompt: this.config.systemPrompt,
+            },
+            permissionHandler: this.config.permissionHandler,
+            systemPromptBuilder: this.config.systemPromptBuilder,
+        });
+        // Propagate abort from parent context to child via AbortSignal
+        const onAbort = () => childLoop.abort('Parent aborted');
+        context.signal.addEventListener('abort', onAbort, { once: true });
+        try {
+            const result = await childLoop.run(task);
+            this.logger.info({ iterations: result.iterations, aborted: result.aborted }, 'Sub-agent completed');
+            if (result.aborted) {
+                return { success: false, output: result.content, error: 'Sub-agent was aborted' };
+            }
+            return { success: true, output: result.content };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            this.logger.warn({ error: message }, 'Sub-agent failed');
+            return { success: false, output: '', error: `Sub-agent error: ${message}` };
+        }
+        finally {
+            context.signal.removeEventListener('abort', onAbort);
+        }
+    }
+}
+//# sourceMappingURL=sub-agent-tool.js.map

package/dist/sub-agent-tool.js.map

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

package/dist/token-counter.d.ts

@@ -0,0 +1,16 @@
+import type { Message } from '@charming_groot/core';
+export declare function resolveEncoding(modelId: string): string;
+/**
+ * Count tokens in a plain text string.
+ */
+export declare function countTextTokens(text: string): number;
+/**
+ * Count tokens for a single Message (content + tool calls + tool results).
+ * Mirrors OpenAI's message token counting spec closely enough for Claude too.
+ */
+export declare function countMessageTokens(msg: Message): number;
+/**
+ * Count total tokens across a message history.
+ */
+export declare function countHistoryTokens(messages: readonly Message[]): number;
+//# sourceMappingURL=token-counter.d.ts.map

package/dist/token-counter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.d.ts","sourceRoot":"","sources":["../src/token-counter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AA2BpD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQpD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAqBvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAEvE"}

package/dist/token-counter.js

@@ -0,0 +1,69 @@
+import { getEncoding } from 'js-tiktoken';
+// cl100k_base: Claude, GPT-4, GPT-3.5-turbo
+// o200k_base:  GPT-4o, o1, o3
+const MODEL_ENCODING = {
+    'claude': 'cl100k_base',
+    'gpt-4': 'cl100k_base',
+    'gpt-3.5': 'cl100k_base',
+    'gpt-4o': 'o200k_base',
+    'o1': 'o200k_base',
+    'o3': 'o200k_base',
+};
+const MESSAGE_OVERHEAD = 4; // role + formatting tokens per message
+const REPLY_OVERHEAD = 3; // assistant reply priming tokens
+let enc = null;
+function getEncoder() {
+    if (!enc) {
+        // cl100k_base works well enough for Claude and most OpenAI models.
+        // For o200k_base models the count differs by ~3% — acceptable for budget tracking.
+        enc = getEncoding('cl100k_base');
+    }
+    return enc;
+}
+export function resolveEncoding(modelId) {
+    const key = Object.keys(MODEL_ENCODING).find(k => modelId.toLowerCase().includes(k));
+    return key ? MODEL_ENCODING[key] : 'cl100k_base';
+}
+/**
+ * Count tokens in a plain text string.
+ */
+export function countTextTokens(text) {
+    if (!text)
+        return 0;
+    try {
+        return getEncoder().encode(text).length;
+    }
+    catch {
+        // Fallback: character estimate
+        return Math.ceil(text.length / 4);
+    }
+}
+/**
+ * Count tokens for a single Message (content + tool calls + tool results).
+ * Mirrors OpenAI's message token counting spec closely enough for Claude too.
+ */
+export function countMessageTokens(msg) {
+    let tokens = MESSAGE_OVERHEAD;
+    tokens += countTextTokens(msg.content);
+    if (msg.toolCalls) {
+        for (const tc of msg.toolCalls) {
+            tokens += countTextTokens(tc.name);
+            tokens += countTextTokens(tc.arguments);
+            tokens += 3; // function_call framing
+        }
+    }
+    if (msg.toolResults) {
+        for (const tr of msg.toolResults) {
+            tokens += countTextTokens(tr.content);
+            tokens += 3; // tool result framing
+        }
+    }
+    return tokens;
+}
+/**
+ * Count total tokens across a message history.
+ */
+export function countHistoryTokens(messages) {
+    return messages.reduce((sum, m) => sum + countMessageTokens(m), REPLY_OVERHEAD);
+}
+//# sourceMappingURL=token-counter.js.map

package/dist/token-counter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token-counter.js","sourceRoot":"","sources":["../src/token-counter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAiB,MAAM,aAAa,CAAC;AAGzD,4CAA4C;AAC5C,8BAA8B;AAC9B,MAAM,cAAc,GAA2B;IAC7C,QAAQ,EAAE,aAAa;IACvB,OAAO,EAAE,aAAa;IACtB,SAAS,EAAE,aAAa;IACxB,QAAQ,EAAE,YAAY;IACtB,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,YAAY;CACnB,CAAC;AAEF,MAAM,gBAAgB,GAAG,CAAC,CAAC,CAAG,uCAAuC;AACrE,MAAM,cAAc,GAAI,CAAC,CAAC,CAAG,iCAAiC;AAE9D,IAAI,GAAG,GAAoB,IAAI,CAAC;AAEhC,SAAS,UAAU;IACjB,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,mEAAmE;QACnE,mFAAmF;QACnF,GAAG,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,OAAe;IAC7C,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IACrF,OAAO,GAAG,CAAC,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC;AACnD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,UAAU,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,+BAA+B;QAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAY;IAC7C,IAAI,MAAM,GAAG,gBAAgB,CAAC;IAE9B,MAAM,IAAI,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAEvC,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;QAClB,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,SAAS,EAAE,CAAC;YAC/B,MAAM,IAAI,eAAe,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;YACnC,MAAM,IAAI,eAAe,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;YACxC,MAAM,IAAI,CAAC,CAAC,CAAC,wBAAwB;QACvC,CAAC;IACH,CAAC;IAED,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;QACpB,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,WAAW,EAAE,CAAC;YACjC,MAAM,IAAI,eAAe,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;YACtC,MAAM,IAAI,CAAC,CAAC,CAAC,sBAAsB;QACrC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAA4B;IAC7D,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,kBAAkB,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;AAClF,CAAC"}

package/dist/tool-dispatcher.d.ts

@@ -0,0 +1,15 @@
+import type { ITool, ToolCall, ToolResult, ToolDescription } from '@charming_groot/core';
+import { Registry } from '@charming_groot/core';
+import type { RunContext } from '@charming_groot/core';
+import { PermissionManager } from './permission.js';
+export declare class ToolDispatcher {
+    private readonly toolRegistry;
+    private readonly permissionManager;
+    private readonly logger;
+    constructor(toolRegistry: Registry<ITool>, permissionManager: PermissionManager);
+    dispatch(toolCall: ToolCall, context: RunContext): Promise<ToolResult>;
+    dispatchAll(toolCalls: readonly ToolCall[], context: RunContext): Promise<ReadonlyMap<string, ToolResult>>;
+    private truncateResult;
+    getToolDescriptions(): ToolDescription[];
+}
+//# sourceMappingURL=tool-dispatcher.d.ts.map

package/dist/tool-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-dispatcher.d.ts","sourceRoot":"","sources":["../src/tool-dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,eAAe,EAAc,MAAM,sBAAsB,CAAC;AACrG,OAAO,EACL,QAAQ,EAGT,MAAM,sBAAsB,CAAC;AAC9B,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,sBAAsB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAMpD,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkB;IAC/C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IACtD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,iBAAiB,EAAE,iBAAiB;IAMzE,QAAQ,CACZ,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,UAAU,CAAC;IAsDhB,WAAW,CACf,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAoB3C,OAAO,CAAC,cAAc;IAYtB,mBAAmB,IAAI,eAAe,EAAE;CAOzC"}

package/dist/tool-dispatcher.js

@@ -0,0 +1,94 @@
+import { PermissionDeniedError, createChildLogger, } from '@charming_groot/core';
+/** Maximum characters in a single tool result output */
+const MAX_OUTPUT_CHARS = 80_000;
+const TRUNCATION_NOTICE = '\n\n... [output truncated — exceeded 80,000 characters]';
+export class ToolDispatcher {
+    toolRegistry;
+    permissionManager;
+    logger;
+    constructor(toolRegistry, permissionManager) {
+        this.toolRegistry = toolRegistry;
+        this.permissionManager = permissionManager;
+        this.logger = createChildLogger('tool-dispatcher');
+    }
+    async dispatch(toolCall, context) {
+        const tool = this.toolRegistry.tryGet(toolCall.name);
+        if (!tool) {
+            this.logger.warn({ toolName: toolCall.name }, 'Unknown tool');
+            return {
+                success: false,
+                output: '',
+                error: `Unknown tool: ${toolCall.name}`,
+            };
+        }
+        let params;
+        try {
+            params = JSON.parse(toolCall.arguments);
+        }
+        catch {
+            this.logger.warn({ toolName: toolCall.name, arguments: toolCall.arguments.slice(0, 200) }, 'Invalid JSON in tool arguments');
+            return {
+                success: false,
+                output: '',
+                error: `Invalid tool arguments for "${toolCall.name}": ${toolCall.arguments.slice(0, 100)}`,
+            };
+        }
+        const permitted = await this.permissionManager.checkPermission(tool, params);
+        if (!permitted) {
+            this.logger.info({ toolName: toolCall.name }, 'Permission denied');
+            throw new PermissionDeniedError(toolCall.name);
+        }
+        const toolStartedAt = Date.now();
+        context.eventBus.emit('tool:start', { runId: context.runId, toolCall, startedAt: toolStartedAt });
+        let result;
+        try {
+            result = await tool.execute(params, context);
+        }
+        catch (error) {
+            if (error instanceof PermissionDeniedError)
+                throw error;
+            const message = error instanceof Error ? error.message : String(error);
+            result = { success: false, output: '', error: message };
+        }
+        const truncated = this.truncateResult(result);
+        context.eventBus.emit('tool:end', {
+            runId: context.runId,
+            toolCall,
+            result: truncated,
+            durationMs: Date.now() - toolStartedAt,
+        });
+        return truncated;
+    }
+    async dispatchAll(toolCalls, context) {
+        const abortedResult = {
+            success: false,
+            output: '',
+            error: 'Operation aborted',
+        };
+        const entries = await Promise.all(toolCalls.map(async (toolCall) => {
+            if (context.isAborted) {
+                return [toolCall.id, abortedResult];
+            }
+            const result = await this.dispatch(toolCall, context);
+            return [toolCall.id, result];
+        }));
+        return new Map(entries);
+    }
+    truncateResult(result) {
+        if (result.output.length <= MAX_OUTPUT_CHARS)
+            return result;
+        this.logger.info({ originalLength: result.output.length, limit: MAX_OUTPUT_CHARS }, 'Tool output truncated');
+        return {
+            ...result,
+            output: result.output.slice(0, MAX_OUTPUT_CHARS) + TRUNCATION_NOTICE,
+        };
+    }
+    getToolDescriptions() {
+        const descriptions = [];
+        for (const [, tool] of this.toolRegistry.getAll()) {
+            descriptions.push(tool.describe());
+        }
+        return descriptions;
+    }
+}
+//# sourceMappingURL=tool-dispatcher.js.map

package/dist/tool-dispatcher.js.map

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