@charming_groot/agent 0.1.0

package/dist/agent-loop.d.ts

@@ -0,0 +1,46 @@
+import type { ILlmProvider, ITool, AgentConfig } from '@charming_groot/core';
+import { Registry, RunContext, EventBus } from '@charming_groot/core';
+import { type PermissionHandler } from './permission.js';
+/**
+ * Callback that builds/rebuilds the system prompt dynamically.
+ * Called before each LLM iteration so the prompt can reflect
+ * current state (open files, cwd, etc.) without a hard dependency
+ * on @core/context-engine.
+ */
+export type SystemPromptBuilder = (context: RunContext) => string | Promise<string>;
+export interface AgentLoopOptions {
+    provider: ILlmProvider;
+    toolRegistry: Registry<ITool>;
+    config: AgentConfig;
+    permissionHandler?: PermissionHandler;
+    eventBus?: EventBus;
+    streaming?: boolean;
+    /** Dynamic system prompt builder — takes precedence over config.systemPrompt */
+    systemPromptBuilder?: SystemPromptBuilder;
+}
+export interface AgentResult {
+    readonly content: string;
+    readonly runId: string;
+    readonly iterations: number;
+    readonly aborted: boolean;
+}
+export declare class AgentLoop {
+    private readonly provider;
+    private readonly toolDispatcher;
+    private readonly messageManager;
+    private readonly context;
+    private readonly maxIterations;
+    private readonly logger;
+    private readonly streaming;
+    private readonly systemPromptBuilder?;
+    private iterations;
+    constructor(options: AgentLoopOptions);
+    get runId(): string;
+    get eventBus(): EventBus;
+    run(userMessage: string): Promise<AgentResult>;
+    abort(reason?: string): void;
+    getContext(): RunContext;
+    private streamResponse;
+    private getToolDescriptions;
+}
+//# sourceMappingURL=agent-loop.d.ts.map

package/dist/agent-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-loop.d.ts","sourceRoot":"","sources":["../src/agent-loop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,KAAK,EACL,WAAW,EAKZ,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,QAAQ,EACR,UAAU,EACV,QAAQ,EAGT,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAE5E;;;;;GAKG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,EAAE,UAAU,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;AAEpF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,YAAY,CAAC;IACvB,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC;IAC9B,MAAM,EAAE,WAAW,CAAC;IACpB,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,gFAAgF;IAChF,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAiB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAa;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAU;IACpC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAsB;IAC3D,OAAO,CAAC,UAAU,CAAK;gBAEX,OAAO,EAAE,gBAAgB;IAmBrC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,IAAI,QAAQ,IAAI,QAAQ,CAEvB;IAEK,GAAG,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IA2FpD,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAI5B,UAAU,IAAI,UAAU;YAIV,cAAc;IAuB5B,OAAO,CAAC,mBAAmB;CAG5B"}

package/dist/agent-loop.js

@@ -0,0 +1,139 @@
+import { RunContext, EventBus, AbortError, createChildLogger, } from '@charming_groot/core';
+import { MessageManager } from './message-manager.js';
+import { ToolDispatcher } from './tool-dispatcher.js';
+import { PermissionManager } from './permission.js';
+export class AgentLoop {
+    provider;
+    toolDispatcher;
+    messageManager;
+    context;
+    maxIterations;
+    logger;
+    streaming;
+    systemPromptBuilder;
+    iterations = 0;
+    constructor(options) {
+        const eventBus = options.eventBus ?? new EventBus();
+        this.context = new RunContext(options.config, eventBus);
+        this.provider = options.provider;
+        this.messageManager = new MessageManager();
+        this.maxIterations = options.config.maxIterations;
+        this.logger = createChildLogger('agent-loop');
+        this.streaming = options.streaming ?? false;
+        this.systemPromptBuilder = options.systemPromptBuilder;
+        const permissionManager = new PermissionManager(options.permissionHandler);
+        this.toolDispatcher = new ToolDispatcher(options.toolRegistry, permissionManager);
+        // Static system prompt used only when no dynamic builder is provided
+        if (!this.systemPromptBuilder && options.config.systemPrompt) {
+            this.messageManager.addSystemMessage(options.config.systemPrompt);
+        }
+    }
+    get runId() {
+        return this.context.runId;
+    }
+    get eventBus() {
+        return this.context.eventBus;
+    }
+    async run(userMessage) {
+        this.messageManager.addUserMessage(userMessage);
+        const agentStartedAt = Date.now();
+        this.context.eventBus.emit('agent:start', {
+            runId: this.context.runId,
+            model: this.context.config.provider.model,
+            startedAt: agentStartedAt,
+        });
+        this.iterations = 0;
+        try {
+            let lastContent = '';
+            while (this.iterations < this.maxIterations) {
+                if (this.context.isAborted) {
+                    throw new AbortError('Agent loop aborted');
+                }
+                this.iterations++;
+                this.logger.debug({ iteration: this.iterations }, 'Starting iteration');
+                // Rebuild system prompt dynamically if builder is provided
+                if (this.systemPromptBuilder) {
+                    const prompt = await this.systemPromptBuilder(this.context);
+                    this.messageManager.setSystemMessage(prompt);
+                }
+                const compressed = this.messageManager.compressIfNeeded();
+                if (compressed > 0) {
+                    this.logger.info({ compressed }, 'History compressed');
+                }
+                const toolDescriptions = this.getToolDescriptions();
+                const messages = this.messageManager.getMessages();
+                this.context.eventBus.emit('llm:request', {
+                    runId: this.context.runId,
+                    messages,
+                });
+                const llmStartedAt = Date.now();
+                const response = this.streaming
+                    ? await this.streamResponse(messages, toolDescriptions)
+                    : await this.provider.chat(messages, toolDescriptions);
+                this.context.eventBus.emit('llm:response', {
+                    runId: this.context.runId,
+                    response,
+                    durationMs: Date.now() - llmStartedAt,
+                    model: this.context.config.provider.model,
+                });
+                lastContent = response.content;
+                if (response.stopReason === 'end_turn' || response.toolCalls.length === 0) {
+                    this.messageManager.addAssistantMessage(response.content);
+                    break;
+                }
+                // Tool use flow
+                this.messageManager.addAssistantMessage(response.content, response.toolCalls);
+                const results = await this.toolDispatcher.dispatchAll(response.toolCalls, this.context);
+                this.messageManager.addToolResults(results);
+            }
+            const aborted = this.context.isAborted;
+            this.context.eventBus.emit('agent:end', {
+                runId: this.context.runId,
+                reason: aborted ? 'aborted' : 'complete',
+                durationMs: Date.now() - agentStartedAt,
+                iterations: this.iterations,
+            });
+            return {
+                content: lastContent,
+                runId: this.context.runId,
+                iterations: this.iterations,
+                aborted,
+            };
+        }
+        catch (error) {
+            this.context.eventBus.emit('agent:error', {
+                runId: this.context.runId,
+                error: error instanceof Error ? error : new Error(String(error)),
+            });
+            throw error;
+        }
+    }
+    abort(reason) {
+        this.context.abort(reason);
+    }
+    getContext() {
+        return this.context;
+    }
+    async streamResponse(messages, tools) {
+        let finalResponse;
+        for await (const event of this.provider.stream(messages, tools)) {
+            if (event.type === 'text_delta' && event.content) {
+                this.context.eventBus.emit('llm:stream', {
+                    runId: this.context.runId,
+                    chunk: event.content,
+                });
+            }
+            else if (event.type === 'done' && event.response) {
+                finalResponse = event.response;
+            }
+        }
+        if (!finalResponse) {
+            throw new Error('Stream ended without a final response');
+        }
+        return finalResponse;
+    }
+    getToolDescriptions() {
+        return this.toolDispatcher.getToolDescriptions();
+    }
+}
+//# sourceMappingURL=agent-loop.js.map

package/dist/agent-loop.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+export { AgentLoop } from './agent-loop.js';
+export type { AgentLoopOptions, AgentResult, SystemPromptBuilder } from './agent-loop.js';
+export { MessageManager } from './message-manager.js';
+export type { CompressionConfig } from './message-manager.js';
+export { countTextTokens, countMessageTokens, countHistoryTokens } from './token-counter.js';
+export { ToolDispatcher } from './tool-dispatcher.js';
+export { PermissionManager } from './permission.js';
+export type { PermissionHandler, PermissionDecision, ApprovalLevel, PersistApprovalCallback, } from './permission.js';
+export { SubAgentTool } from './sub-agent-tool.js';
+export type { SubAgentToolConfig } from './sub-agent-tool.js';
+export { SkillTool } from './skill-tool.js';
+export type { SkillEntry, SkillProvider } from './skill-tool.js';
+export { SessionManager } from './session-manager.js';
+export type { SessionMeta } from './session-manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC1F,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,uBAAuB,GACxB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,YAAY,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,YAAY,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { AgentLoop } from './agent-loop.js';
+export { MessageManager } from './message-manager.js';
+export { countTextTokens, countMessageTokens, countHistoryTokens } from './token-counter.js';
+export { ToolDispatcher } from './tool-dispatcher.js';
+export { PermissionManager } from './permission.js';
+export { SubAgentTool } from './sub-agent-tool.js';
+export { SkillTool } from './skill-tool.js';
+export { SessionManager } from './session-manager.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAOpD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/message-manager.d.ts

@@ -0,0 +1,46 @@
+import type { Message, ToolCall, ToolResult } from '@charming_groot/core';
+export interface CompressionConfig {
+    /** Maximum tokens in history before compression triggers (default: 100_000) */
+    maxHistoryTokens?: number;
+    /** Number of recent non-system messages to keep intact (default: 10) */
+    keepRecentMessages?: number;
+    /** Truncate individual message content to this length in summary (default: 300) */
+    summaryContentLength?: number;
+}
+export declare class MessageManager {
+    private readonly messages;
+    private readonly maxHistoryTokens;
+    private readonly keepRecentMessages;
+    private readonly summaryContentLength;
+    constructor(config?: CompressionConfig);
+    addSystemMessage(content: string): void;
+    setSystemMessage(content: string): void;
+    addUserMessage(content: string): void;
+    addAssistantMessage(content: string, toolCalls?: readonly ToolCall[]): void;
+    addToolResults(results: ReadonlyMap<string, ToolResult>): void;
+    getMessages(): readonly Message[];
+    getLastMessage(): Message | undefined;
+    get messageCount(): number;
+    /** Exact token count using js-tiktoken. */
+    get totalTokens(): number;
+    clear(): void;
+    serialize(): string;
+    restore(json: string): void;
+    /**
+     * Compress history if it exceeds the token budget.
+     *
+     * Strategy:
+     * 1. Always keep all system messages.
+     * 2. Keep the last `keepRecentMessages` non-system messages intact.
+     * 3. Summarize older messages into a structured digest that preserves:
+     *    - what the user asked
+     *    - what tools were called and whether they succeeded
+     *    - key assistant conclusions
+     *
+     * Returns the number of messages compressed (0 = no compression needed).
+     */
+    compressIfNeeded(): number;
+    private buildDigest;
+}
+export { countMessageTokens, countHistoryTokens } from './token-counter.js';
+//# sourceMappingURL=message-manager.d.ts.map

package/dist/message-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-manager.d.ts","sourceRoot":"","sources":["../src/message-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAG1E,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mFAAmF;IACnF,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiB;IAC1C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;gBAElC,MAAM,GAAE,iBAAsB;IAM1C,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIvC,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IASvC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAIrC,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,GAAG,IAAI;IAQ3E,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,IAAI;IAU9D,WAAW,IAAI,SAAS,OAAO,EAAE;IAIjC,cAAc,IAAI,OAAO,GAAG,SAAS;IAIrC,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,2CAA2C;IAC3C,IAAI,WAAW,IAAI,MAAM,CAExB;IAED,KAAK,IAAI,IAAI;IAIb,SAAS,IAAI,MAAM;IAInB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAkB3B;;;;;;;;;;;;OAYG;IACH,gBAAgB,IAAI,MAAM;IA2B1B,OAAO,CAAC,WAAW;CAkCpB;AAOD,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/message-manager.js

@@ -0,0 +1,152 @@
+import { countHistoryTokens } from './token-counter.js';
+export class MessageManager {
+    messages = [];
+    maxHistoryTokens;
+    keepRecentMessages;
+    summaryContentLength;
+    constructor(config = {}) {
+        this.maxHistoryTokens = config.maxHistoryTokens ?? 100_000;
+        this.keepRecentMessages = config.keepRecentMessages ?? 10;
+        this.summaryContentLength = config.summaryContentLength ?? 300;
+    }
+    addSystemMessage(content) {
+        this.messages.push({ role: 'system', content });
+    }
+    setSystemMessage(content) {
+        const idx = this.messages.findIndex(m => m.role === 'system');
+        if (idx >= 0) {
+            this.messages[idx] = { role: 'system', content };
+        }
+        else {
+            this.messages.unshift({ role: 'system', content });
+        }
+    }
+    addUserMessage(content) {
+        this.messages.push({ role: 'user', content });
+    }
+    addAssistantMessage(content, toolCalls) {
+        this.messages.push({
+            role: 'assistant',
+            content,
+            toolCalls: toolCalls ? [...toolCalls] : undefined,
+        });
+    }
+    addToolResults(results) {
+        const toolResults = [...results.entries()].map(([toolCallId, result]) => ({
+            toolCallId,
+            content: result.success
+                ? result.output
+                : `Error: ${result.error ?? 'Unknown error'}`,
+        }));
+        this.messages.push({ role: 'user', content: '', toolResults });
+    }
+    getMessages() {
+        return [...this.messages];
+    }
+    getLastMessage() {
+        return this.messages[this.messages.length - 1];
+    }
+    get messageCount() {
+        return this.messages.length;
+    }
+    /** Exact token count using js-tiktoken. */
+    get totalTokens() {
+        return countHistoryTokens(this.messages);
+    }
+    clear() {
+        this.messages.length = 0;
+    }
+    serialize() {
+        return JSON.stringify(this.messages);
+    }
+    restore(json) {
+        const parsed = JSON.parse(json);
+        if (!Array.isArray(parsed)) {
+            throw new Error('Invalid serialized messages: expected an array');
+        }
+        this.messages.length = 0;
+        for (const item of parsed) {
+            if (typeof item === 'object' && item !== null &&
+                'role' in item && 'content' in item &&
+                typeof item.role === 'string' &&
+                typeof item.content === 'string') {
+                this.messages.push(item);
+            }
+        }
+    }
+    /**
+     * Compress history if it exceeds the token budget.
+     *
+     * Strategy:
+     * 1. Always keep all system messages.
+     * 2. Keep the last `keepRecentMessages` non-system messages intact.
+     * 3. Summarize older messages into a structured digest that preserves:
+     *    - what the user asked
+     *    - what tools were called and whether they succeeded
+     *    - key assistant conclusions
+     *
+     * Returns the number of messages compressed (0 = no compression needed).
+     */
+    compressIfNeeded() {
+        if (this.totalTokens <= this.maxHistoryTokens)
+            return 0;
+        const system = [];
+        const rest = [];
+        for (const msg of this.messages) {
+            if (msg.role === 'system')
+                system.push(msg);
+            else
+                rest.push(msg);
+        }
+        const keepCount = Math.min(this.keepRecentMessages, rest.length);
+        const toSummarize = rest.slice(0, rest.length - keepCount);
+        const toKeep = rest.slice(rest.length - keepCount);
+        if (toSummarize.length === 0)
+            return 0;
+        const summaryMessage = {
+            role: 'user',
+            content: this.buildDigest(toSummarize),
+        };
+        this.messages.length = 0;
+        this.messages.push(...system, summaryMessage, ...toKeep);
+        return toSummarize.length;
+    }
+    buildDigest(messages) {
+        const maxLen = this.summaryContentLength;
+        const lines = [
+            `[Context summary — ${messages.length} earlier messages compressed]`,
+            '',
+        ];
+        for (const msg of messages) {
+            if (msg.role === 'user' && !msg.toolResults) {
+                const text = truncate(msg.content, maxLen);
+                if (text)
+                    lines.push(`User: ${text}`);
+            }
+            if (msg.role === 'assistant') {
+                if (msg.content) {
+                    lines.push(`Assistant: ${truncate(msg.content, maxLen)}`);
+                }
+                if (msg.toolCalls?.length) {
+                    for (const tc of msg.toolCalls) {
+                        lines.push(`  → ${tc.name}(${truncate(tc.arguments, 120)})`);
+                    }
+                }
+            }
+            if (msg.toolResults?.length) {
+                for (const tr of msg.toolResults) {
+                    lines.push(`  ← result: ${truncate(tr.content, 120)}`);
+                }
+            }
+        }
+        lines.push('', '[End of summary — conversation continues below]');
+        return lines.join('\n');
+    }
+}
+function truncate(text, maxLen) {
+    if (!text)
+        return '';
+    return text.length <= maxLen ? text : text.slice(0, maxLen) + '…';
+}
+export { countMessageTokens, countHistoryTokens } from './token-counter.js';
+//# sourceMappingURL=message-manager.js.map

package/dist/message-manager.js.map

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

package/dist/permission.d.ts

@@ -0,0 +1,37 @@
+import type { ITool, JsonObject } from '@charming_groot/core';
+/**
+ * Approval level returned by PermissionHandler.
+ *
+ * - 'once'    — allow this single invocation only
+ * - 'session' — allow for the rest of this session (cached in allowedTools)
+ * - 'always'  — allow permanently (caller is responsible for persistence)
+ * - 'deny'    — block this invocation
+ */
+export type ApprovalLevel = 'once' | 'session' | 'always' | 'deny';
+/**
+ * Decision returned by PermissionHandler.
+ * Can be a simple boolean (backward-compatible) or an ApprovalLevel.
+ */
+export type PermissionDecision = boolean | ApprovalLevel;
+/**
+ * Callback that decides whether a tool invocation is allowed.
+ * Receives the tool name and the parsed parameters so the handler
+ * can make context-aware decisions (e.g., block `rm -rf /`).
+ */
+export type PermissionHandler = (toolName: string, params: JsonObject) => Promise<PermissionDecision>;
+/** Callback invoked when a tool is approved with 'always' level */
+export type PersistApprovalCallback = (toolName: string) => void;
+export declare class PermissionManager {
+    private readonly handler;
+    private readonly sessionAllowed;
+    private readonly alwaysAllowed;
+    private readonly onPersist;
+    constructor(handler?: PermissionHandler, onPersist?: PersistApprovalCallback);
+    checkPermission(tool: ITool, params?: JsonObject): Promise<boolean>;
+    allowTool(toolName: string, level?: 'session' | 'always'): void;
+    revokeTool(toolName: string): void;
+    isAllowed(toolName: string): boolean;
+    clearSession(): void;
+    clearAll(): void;
+}
+//# sourceMappingURL=permission.d.ts.map

package/dist/permission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.d.ts","sourceRoot":"","sources":["../src/permission.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAE9D;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEnE;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,aAAa,CAAC;AAEzD;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,UAAU,KACf,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAEjC,mEAAmE;AACnE,MAAM,MAAM,uBAAuB,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;AAUjE,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;IAC5C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAqB;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsC;gBAG9D,OAAO,CAAC,EAAE,iBAAiB,EAC3B,SAAS,CAAC,EAAE,uBAAuB;IAM/B,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,GAAE,UAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAyB7E,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,SAAS,GAAG,QAAoB,GAAG,IAAI;IAQ1E,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKlC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIpC,YAAY,IAAI,IAAI;IAIpB,QAAQ,IAAI,IAAI;CAIjB"}

package/dist/permission.js

@@ -0,0 +1,62 @@
+const AUTO_APPROVE = async () => true;
+function normalizeDecision(decision) {
+    if (decision === true)
+        return 'session';
+    if (decision === false)
+        return 'deny';
+    return decision;
+}
+export class PermissionManager {
+    handler;
+    sessionAllowed = new Set();
+    alwaysAllowed = new Set();
+    onPersist;
+    constructor(handler, onPersist) {
+        this.handler = handler ?? AUTO_APPROVE;
+        this.onPersist = onPersist;
+    }
+    async checkPermission(tool, params = {}) {
+        if (!tool.requiresPermission) {
+            return true;
+        }
+        if (this.alwaysAllowed.has(tool.name) || this.sessionAllowed.has(tool.name)) {
+            return true;
+        }
+        const raw = await this.handler(tool.name, params);
+        const level = normalizeDecision(raw);
+        if (level === 'deny')
+            return false;
+        if (level === 'session') {
+            this.sessionAllowed.add(tool.name);
+        }
+        else if (level === 'always') {
+            this.alwaysAllowed.add(tool.name);
+            this.onPersist?.(tool.name);
+        }
+        // 'once' — no caching, just allow this time
+        return true;
+    }
+    allowTool(toolName, level = 'session') {
+        if (level === 'always') {
+            this.alwaysAllowed.add(toolName);
+        }
+        else {
+            this.sessionAllowed.add(toolName);
+        }
+    }
+    revokeTool(toolName) {
+        this.sessionAllowed.delete(toolName);
+        this.alwaysAllowed.delete(toolName);
+    }
+    isAllowed(toolName) {
+        return this.sessionAllowed.has(toolName) || this.alwaysAllowed.has(toolName);
+    }
+    clearSession() {
+        this.sessionAllowed.clear();
+    }
+    clearAll() {
+        this.sessionAllowed.clear();
+        this.alwaysAllowed.clear();
+    }
+}
+//# sourceMappingURL=permission.js.map

package/dist/permission.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission.js","sourceRoot":"","sources":["../src/permission.ts"],"names":[],"mappings":"AA+BA,MAAM,YAAY,GAAsB,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC;AAEzD,SAAS,iBAAiB,CAAC,QAA4B;IACrD,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACxC,IAAI,QAAQ,KAAK,KAAK;QAAE,OAAO,MAAM,CAAC;IACtC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,OAAO,iBAAiB;IACX,OAAO,CAAoB;IAC3B,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,SAAS,CAAsC;IAEhE,YACE,OAA2B,EAC3B,SAAmC;QAEnC,IAAI,CAAC,OAAO,GAAG,OAAO,IAAI,YAAY,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,IAAW,EAAE,SAAqB,EAAE;QACxD,IAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC7B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5E,OAAO,IAAI,CAAC;QACd,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;QAErC,IAAI,KAAK,KAAK,MAAM;YAAE,OAAO,KAAK,CAAC;QAEnC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;aAAM,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;QACD,4CAA4C;QAE5C,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,CAAC,QAAgB,EAAE,QAA8B,SAAS;QACjE,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvB,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,UAAU,CAAC,QAAgB;QACzB,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACtC,CAAC;IAED,SAAS,CAAC,QAAgB;QACxB,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC/E,CAAC;IAED,YAAY;QACV,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;CACF"}

package/dist/session-manager.d.ts

@@ -0,0 +1,31 @@
+import { MessageManager } from './message-manager.js';
+/** Metadata stored alongside the conversation messages */
+export interface SessionMeta {
+    readonly sessionId: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+/**
+ * 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 declare class SessionManager {
+    private readonly sessionsDir;
+    private readonly logger;
+    constructor(sessionsDir: string);
+    /** Save the current conversation to disk. */
+    save(sessionId: string, manager: MessageManager): Promise<void>;
+    /** Restore a conversation from disk into the given MessageManager. */
+    load(sessionId: string, manager: MessageManager): Promise<SessionMeta>;
+    /** Check if a session file exists. */
+    exists(sessionId: string): Promise<boolean>;
+    /** List all session IDs in the sessions directory. */
+    list(): Promise<SessionMeta[]>;
+    private sessionPath;
+    private readSessionFile;
+}
+//# sourceMappingURL=session-manager.d.ts.map

package/dist/session-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-manager.d.ts","sourceRoot":"","sources":["../src/session-manager.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAQD;;;;;;;GAOG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAc;gBAEzB,WAAW,EAAE,MAAM;IAK/B,6CAA6C;IACvC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA6BrE,sEAAsE;IAChE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAQ5E,sCAAsC;IAChC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASjD,sDAAsD;IAChD,IAAI,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;IAoBpC,OAAO,CAAC,WAAW;YAML,eAAe;CAQ9B"}