agent-world 0.11.1 → 0.12.0

package/dist/core/create-agent-tool.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Create Agent Tool Module - Built-in tool for approval-gated agent creation.
+ *
+ * Purpose:
+ * - Provide a deterministic `create_agent` built-in tool that creates agents after explicit user approval.
+ *
+ * Key Features:
+ * - Requires `name` and supports optional `autoReply`, `role`, and `nextAgent` arguments.
+ * - Enforces a mandatory HITL approval check before creating any agent.
+ * - Inherits provider/model from world-level `chatLLMProvider` / `chatLLMModel` when configured.
+ * - Generates a stable system prompt template for new agents.
+ * - Returns structured JSON payloads for success, denial, and error outcomes.
+ *
+ * Notes on Implementation:
+ * - Uses `requestWorldOption` for approval (no custom approval protocol).
+ * - Uses core `createAgent` manager API to preserve existing persistence and CRUD event behavior.
+ * - Applies deterministic defaults when world-level provider/model are not configured.
+ *
+ * Recent Changes:
+ * - 2026-02-19: Initial implementation of approval-gated `create_agent` built-in tool.
+ */
+type CreateAgentToolContext = {
+    world?: {
+        id?: string;
+        currentChatId?: string | null;
+        chatLLMProvider?: string | null;
+        chatLLMModel?: string | null;
+        eventEmitter?: unknown;
+    } | null;
+    chatId?: string | null;
+};
+type CreateAgentToolArgs = {
+    name: string;
+    autoReply?: boolean;
+    role?: string;
+    nextAgent?: string;
+};
+export declare function createCreateAgentToolDefinition(): {
+    description: string;
+    parameters: {
+        type: string;
+        properties: {
+            name: {
+                type: string;
+                description: string;
+            };
+            autoReply: {
+                type: string;
+                description: string;
+            };
+            role: {
+                type: string;
+                description: string;
+            };
+            nextAgent: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+        additionalProperties: boolean;
+    };
+    execute: (args: CreateAgentToolArgs, _sequenceId?: string, _parentToolCall?: string, context?: CreateAgentToolContext) => Promise<string>;
+};
+export {};
+//# sourceMappingURL=create-agent-tool.d.ts.map

package/dist/core/create-agent-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-agent-tool.d.ts","sourceRoot":"","sources":["../../core/create-agent-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAcH,KAAK,sBAAsB,GAAG;IAC5B,KAAK,CAAC,EAAE;QACN,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,GAAG,IAAI,CAAC;IACT,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAwEF,wBAAgB,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;oBA2BrB,mBAAmB,gBAAgB,MAAM,oBAAoB,MAAM,YAAY,sBAAsB;EAmG9H"}

package/dist/core/create-agent-tool.js

@@ -0,0 +1,212 @@
+/**
+ * Create Agent Tool Module - Built-in tool for approval-gated agent creation.
+ *
+ * Purpose:
+ * - Provide a deterministic `create_agent` built-in tool that creates agents after explicit user approval.
+ *
+ * Key Features:
+ * - Requires `name` and supports optional `autoReply`, `role`, and `nextAgent` arguments.
+ * - Enforces a mandatory HITL approval check before creating any agent.
+ * - Inherits provider/model from world-level `chatLLMProvider` / `chatLLMModel` when configured.
+ * - Generates a stable system prompt template for new agents.
+ * - Returns structured JSON payloads for success, denial, and error outcomes.
+ *
+ * Notes on Implementation:
+ * - Uses `requestWorldOption` for approval (no custom approval protocol).
+ * - Uses core `createAgent` manager API to preserve existing persistence and CRUD event behavior.
+ * - Applies deterministic defaults when world-level provider/model are not configured.
+ *
+ * Recent Changes:
+ * - 2026-02-19: Initial implementation of approval-gated `create_agent` built-in tool.
+ */
+import { requestWorldOption } from './hitl.js';
+import { createAgent } from './managers.js';
+import { LLMProvider } from './types.js';
+import { toKebabCase } from './utils.js';
+const APPROVAL_OPTION_YES = 'yes';
+const APPROVAL_OPTION_NO = 'no';
+const DEFAULT_PROVIDER = LLMProvider.OPENAI;
+const DEFAULT_MODEL = 'gpt-4';
+const DEFAULT_NEXT_AGENT = 'human';
+const MAX_ROLE_LENGTH = 240;
+function normalizeSingleLineText(value) {
+    if (typeof value !== 'string')
+        return '';
+    return value.replace(/\s+/g, ' ').trim();
+}
+function resolveRole(role) {
+    const normalized = normalizeSingleLineText(role);
+    if (!normalized)
+        return '';
+    return normalized.slice(0, MAX_ROLE_LENGTH);
+}
+function resolveNextAgent(nextAgent) {
+    const normalized = normalizeSingleLineText(nextAgent);
+    if (!normalized)
+        return DEFAULT_NEXT_AGENT;
+    const stripped = normalized.startsWith('@') ? normalized.slice(1) : normalized;
+    const token = toKebabCase(stripped);
+    return token || DEFAULT_NEXT_AGENT;
+}
+function resolveProvider(world) {
+    const configured = normalizeSingleLineText(world?.chatLLMProvider).toLowerCase();
+    const allProviders = new Set(Object.values(LLMProvider));
+    if (configured && allProviders.has(configured)) {
+        return configured;
+    }
+    return DEFAULT_PROVIDER;
+}
+function resolveModel(world) {
+    const configured = normalizeSingleLineText(world?.chatLLMModel);
+    return configured || DEFAULT_MODEL;
+}
+function buildSystemPrompt(name, role, nextAgent) {
+    const roleSentence = role ? `Your role is ${role}.` : 'Your role is not specified.';
+    return [
+        `You are agent ${name}. ${roleSentence}`,
+        '',
+        'Always respond in exactly this structure:',
+        `@${nextAgent}`,
+        '{Your response}',
+    ].join('\n');
+}
+function formatResult(payload) {
+    return JSON.stringify(payload, null, 2);
+}
+function formatErrorResult(message) {
+    return formatResult({
+        success: false,
+        created: false,
+        error: message,
+    });
+}
+function formatDeniedResult(optionId, source, message) {
+    return formatResult({
+        success: false,
+        created: false,
+        approval: {
+            optionId,
+            source,
+            approved: false,
+        },
+        message,
+    });
+}
+export function createCreateAgentToolDefinition() {
+    return {
+        description: 'Create a new agent after explicit user approval. Requires `name`; supports optional `autoReply`, `role`, and `nextAgent`.',
+        parameters: {
+            type: 'object',
+            properties: {
+                name: {
+                    type: 'string',
+                    description: 'Name for the new agent.',
+                },
+                autoReply: {
+                    type: 'boolean',
+                    description: 'Optional auto-reply flag. Defaults to true.',
+                },
+                role: {
+                    type: 'string',
+                    description: 'Optional role sentence used in the generated system prompt.',
+                },
+                nextAgent: {
+                    type: 'string',
+                    description: 'Optional mention target used in the generated response template.',
+                },
+            },
+            required: ['name'],
+            additionalProperties: false,
+        },
+        execute: async (args, _sequenceId, _parentToolCall, context) => {
+            try {
+                const name = normalizeSingleLineText(args?.name);
+                if (!name) {
+                    return formatErrorResult('Missing required parameter: name');
+                }
+                const world = context?.world;
+                const worldId = normalizeSingleLineText(world?.id);
+                if (!world || !worldId || !world.eventEmitter) {
+                    return formatErrorResult('Approval context unavailable: world runtime is required for create_agent.');
+                }
+                const autoReply = args?.autoReply !== undefined ? !!args.autoReply : true;
+                const role = resolveRole(args?.role);
+                const nextAgent = resolveNextAgent(args?.nextAgent);
+                const provider = resolveProvider(world);
+                const model = resolveModel(world);
+                const systemPrompt = buildSystemPrompt(name, role, nextAgent);
+                const chatId = context?.chatId ?? world.currentChatId ?? null;
+                const approval = await requestWorldOption(world, {
+                    title: `Create agent ${name}?`,
+                    message: [
+                        `Create a new agent with name "${name}"?`,
+                        `autoReply: ${String(autoReply)}`,
+                        `role: ${role || '(not specified)'}`,
+                        `nextAgent: ${nextAgent}`,
+                        `provider: ${provider}`,
+                        `model: ${model}`,
+                    ].join('\n'),
+                    chatId,
+                    defaultOptionId: APPROVAL_OPTION_NO,
+                    options: [
+                        {
+                            id: APPROVAL_OPTION_YES,
+                            label: 'Yes',
+                            description: 'Create this agent now.',
+                        },
+                        {
+                            id: APPROVAL_OPTION_NO,
+                            label: 'No',
+                            description: 'Do not create this agent.',
+                        },
+                    ],
+                    metadata: {
+                        tool: 'create_agent',
+                        name,
+                        autoReply,
+                        role,
+                        nextAgent,
+                        provider,
+                        model,
+                    },
+                });
+                if (approval.optionId !== APPROVAL_OPTION_YES) {
+                    const denialMessage = approval.source === 'timeout'
+                        ? `Agent creation timed out and defaulted to ${approval.optionId}.`
+                        : 'User denied agent creation.';
+                    return formatDeniedResult(approval.optionId, approval.source, denialMessage);
+                }
+                const createdAgent = await createAgent(worldId, {
+                    name,
+                    type: 'default',
+                    autoReply,
+                    provider,
+                    model,
+                    systemPrompt,
+                }, { allowWhileProcessing: true });
+                return formatResult({
+                    success: true,
+                    created: true,
+                    agent: {
+                        id: createdAgent.id,
+                        name: createdAgent.name,
+                        autoReply: createdAgent.autoReply !== false,
+                        provider: createdAgent.provider,
+                        model: createdAgent.model,
+                        role: role || null,
+                        nextAgent,
+                        systemPrompt: createdAgent.systemPrompt || systemPrompt,
+                    },
+                });
+            }
+            catch (error) {
+                if (error instanceof Error && error.name === 'AbortError') {
+                    throw error;
+                }
+                const message = error instanceof Error ? error.message : String(error);
+                return formatErrorResult(message);
+            }
+        },
+    };
+}
+//# sourceMappingURL=create-agent-tool.js.map

package/dist/core/create-agent-tool.js.map

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

package/dist/core/events/approval-checker.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Approval Checker - Tool Approval Validation Functions
+ *
+ * Purpose: Validate tool execution approvals
+ * Features:
+ * - Check for session-wide approvals
+ * - Check for one-time approvals (not consumed)
+ * - Match by tool name, directory, and parameters
+ * - Enhanced protocol support with __type='tool_result'
+ *
+ * These functions are pure logic with no side effects
+ */
+import { AgentMessage, World } from '../types.js';
+/**
+ * Check if tool needs approval and if it can execute
+ * Returns approval status and optional approval request data
+ */
+export declare function checkToolApproval(world: World, toolName: string, toolArgs: any, message: string, messages: AgentMessage[], context: {
+    workingDirectory?: string;
+    [key: string]: any;
+}): Promise<{
+    needsApproval: boolean;
+    canExecute: boolean;
+    approvalRequest?: any;
+}>;
+/**
+ * Find one-time approval that hasn't been consumed yet
+ *
+ * One-time approval is valid if:
+ * - scope: 'once'
+ * - Matches tool name, directory, and parameters
+ * - NOT followed by a tool execution result (not consumed)
+ *
+ * Once found and used, it should be "consumed" by checking for subsequent tool results
+ */
+export declare function findOnceApproval(messages: AgentMessage[], toolName: string, toolArgs?: any, workingDirectory?: string): {
+    decision: 'approve';
+    scope: 'once';
+    toolName: string;
+} | undefined;
+/**
+ * Find session-wide approval for a tool in message history
+ * Supports enhanced string protocol (JSON)
+ *
+ * Session approval matches on:
+ * - Tool name (required)
+ * - Working directory (if provided)
+ * - Parameters (exact match)
+ *
+ * Enhanced protocol format:
+ * {
+ *   role: 'tool',
+ *   tool_call_id: 'approval_...',
+ *   content: '{"__type":"tool_result","content":"{\"decision\":\"approve\",\"scope\":\"session\",\"toolName\":\"...\",\"toolArgs\":{...},\"workingDirectory\":\"...\"}"}'
+ * }
+ */
+export declare function findSessionApproval(messages: AgentMessage[], toolName: string, toolArgs?: any, workingDirectory?: string): {
+    decision: 'approve';
+    scope: 'session';
+    toolName: string;
+} | undefined;

package/dist/core/events/approval-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-checker.d.ts","sourceRoot":"","sources":["../../../core/events/approval-checker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAMlD;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,KAAK,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,GAAG,EACb,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,YAAY,EAAE,EACxB,OAAO,EAAE;IAAE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAAA,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,GACxD,OAAO,CAAC;IACT,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,GAAG,CAAC;CACvB,CAAC,CAqDD;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,YAAY,EAAE,EACxB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,GAAG,EACd,gBAAgB,CAAC,EAAE,MAAM,GACxB;IAAE,QAAQ,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CA6EtE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,YAAY,EAAE,EACxB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,GAAG,EACd,gBAAgB,CAAC,EAAE,MAAM,GACxB;IAAE,QAAQ,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CA4DzE"}

package/dist/core/events/approval-checker.js

@@ -0,0 +1,226 @@
+/**
+ * Approval Checker - Tool Approval Validation Functions
+ *
+ * Purpose: Validate tool execution approvals
+ * Features:
+ * - Check for session-wide approvals
+ * - Check for one-time approvals (not consumed)
+ * - Match by tool name, directory, and parameters
+ * - Enhanced protocol support with __type='tool_result'
+ *
+ * These functions are pure logic with no side effects
+ */
+import { createCategoryLogger } from '../logger.js';
+const loggerAgent = createCategoryLogger('events.agent');
+const loggerMemory = createCategoryLogger('events.memory');
+/**
+ * Check if tool needs approval and if it can execute
+ * Returns approval status and optional approval request data
+ */
+export async function checkToolApproval(world, toolName, toolArgs, message, messages, context) {
+    try {
+        // Check for session-wide approval ONLY (matches name + directory + params)
+        const workingDirectory = context?.workingDirectory || process.cwd();
+        const sessionApproval = findSessionApproval(messages, toolName, toolArgs, workingDirectory);
+        if (sessionApproval) {
+            return {
+                needsApproval: false,
+                canExecute: true
+            };
+        }
+        // Check for one-time approval (not yet consumed)
+        const onceApproval = findOnceApproval(messages, toolName, toolArgs, workingDirectory);
+        if (onceApproval) {
+            return {
+                needsApproval: false,
+                canExecute: true
+            };
+        }
+        // No approval found - need to request approval
+        return {
+            needsApproval: true,
+            canExecute: false,
+            approvalRequest: {
+                toolName,
+                toolArgs,
+                message,
+                workingDirectory, // Include for session approval matching
+                requestId: `approval-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+                options: ['deny', 'approve_once', 'approve_session']
+            }
+        };
+    }
+    catch (error) {
+        loggerAgent.error('Error checking tool approval', {
+            toolName,
+            error: error instanceof Error ? error.message : error
+        });
+        return {
+            needsApproval: true,
+            canExecute: false,
+            approvalRequest: {
+                toolName,
+                toolArgs,
+                message,
+                workingDirectory: context?.workingDirectory || process.cwd(), // Include even in error case
+                requestId: `approval-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`,
+                options: ['deny', 'approve_once', 'approve_session']
+            }
+        };
+    }
+}
+/**
+ * Find one-time approval that hasn't been consumed yet
+ *
+ * One-time approval is valid if:
+ * - scope: 'once'
+ * - Matches tool name, directory, and parameters
+ * - NOT followed by a tool execution result (not consumed)
+ *
+ * Once found and used, it should be "consumed" by checking for subsequent tool results
+ */
+export function findOnceApproval(messages, toolName, toolArgs, workingDirectory) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        // Look for tool result with scope: 'once'
+        if (msg.role === 'tool' && msg.tool_call_id && msg.content) {
+            try {
+                const outerParsed = JSON.parse(msg.content);
+                if (outerParsed.__type === 'tool_result' && outerParsed.content) {
+                    try {
+                        const result = JSON.parse(outerParsed.content);
+                        if (result.decision === 'approve' &&
+                            result.scope === 'once' &&
+                            result.toolName?.toLowerCase() === toolName.toLowerCase()) {
+                            // Match working directory if provided
+                            if (result.workingDirectory && workingDirectory) {
+                                if (result.workingDirectory !== workingDirectory) {
+                                    continue;
+                                }
+                            }
+                            // Match parameters
+                            if (result.toolArgs && toolArgs) {
+                                const argsMatch = JSON.stringify(result.toolArgs) === JSON.stringify(toolArgs);
+                                if (!argsMatch) {
+                                    continue;
+                                }
+                            }
+                            // Found a matching one-time approval
+                            // Check if it's been consumed by looking for a subsequent tool execution
+                            const toolCallId = msg.tool_call_id;
+                            // Look for messages AFTER this approval to see if tool was executed
+                            for (let j = i + 1; j < messages.length; j++) {
+                                const laterMsg = messages[j];
+                                // Check if there's a tool result that consumed this approval
+                                // Tool results have role='tool' but are NOT approval responses
+                                if (laterMsg.role === 'tool' && laterMsg.tool_call_id === toolCallId) {
+                                    // Check if this is NOT another approval response (check for __type)
+                                    try {
+                                        const laterParsed = JSON.parse(laterMsg.content || '{}');
+                                        if (laterParsed.__type !== 'tool_result') {
+                                            // This is an actual tool execution result, approval was consumed
+                                            loggerMemory.debug('One-time approval already consumed', {
+                                                toolName,
+                                                toolCallId
+                                            });
+                                            return undefined; // Approval consumed, don't reuse
+                                        }
+                                    }
+                                    catch {
+                                        // If parse fails, assume it's a tool execution result
+                                        return undefined; // Approval consumed
+                                    }
+                                }
+                            }
+                            // Approval found and not consumed
+                            loggerMemory.debug('Found valid one-time approval', {
+                                toolName,
+                                toolCallId: msg.tool_call_id
+                            });
+                            return { decision: 'approve', scope: 'once', toolName };
+                        }
+                    }
+                    catch (innerError) {
+                        continue;
+                    }
+                }
+            }
+            catch (outerError) {
+                continue;
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Find session-wide approval for a tool in message history
+ * Supports enhanced string protocol (JSON)
+ *
+ * Session approval matches on:
+ * - Tool name (required)
+ * - Working directory (if provided)
+ * - Parameters (exact match)
+ *
+ * Enhanced protocol format:
+ * {
+ *   role: 'tool',
+ *   tool_call_id: 'approval_...',
+ *   content: '{"__type":"tool_result","content":"{\"decision\":\"approve\",\"scope\":\"session\",\"toolName\":\"...\",\"toolArgs\":{...},\"workingDirectory\":\"...\"}"}'
+ * }
+ */
+export function findSessionApproval(messages, toolName, toolArgs, workingDirectory) {
+    for (let i = messages.length - 1; i >= 0; i--) {
+        const msg = messages[i];
+        // Primary: Enhanced string protocol (JSON tool result)
+        if (msg.role === 'tool' && msg.tool_call_id && msg.content) {
+            try {
+                const outerParsed = JSON.parse(msg.content);
+                // Enhanced protocol: Outer layer MUST have __type
+                if (outerParsed.__type === 'tool_result') {
+                    if (!outerParsed.content) {
+                        loggerMemory.warn('Enhanced protocol missing content field', {
+                            toolCallId: msg.tool_call_id
+                        });
+                        continue; // Skip malformed enhanced protocol
+                    }
+                    try {
+                        const result = JSON.parse(outerParsed.content);
+                        if (result.decision === 'approve' &&
+                            result.scope === 'session' &&
+                            result.toolName?.toLowerCase() === toolName.toLowerCase()) {
+                            // Match working directory if provided in approval
+                            if (result.workingDirectory && workingDirectory) {
+                                if (result.workingDirectory !== workingDirectory) {
+                                    continue; // Directory mismatch, keep searching
+                                }
+                            }
+                            // Match parameters (exact deep equality)
+                            if (result.toolArgs && toolArgs) {
+                                const argsMatch = JSON.stringify(result.toolArgs) === JSON.stringify(toolArgs);
+                                if (!argsMatch) {
+                                    continue; // Parameters mismatch, keep searching
+                                }
+                            }
+                            return { decision: 'approve', scope: 'session', toolName };
+                        }
+                    }
+                    catch (innerError) {
+                        loggerMemory.error('Malformed enhanced protocol content', {
+                            toolCallId: msg.tool_call_id,
+                            content: outerParsed.content,
+                            error: innerError
+                        });
+                        continue; // Skip malformed inner JSON
+                    }
+                }
+                // If outer JSON parsed but no __type, might be legacy JSON approval
+                // (not currently used, but future-proof)
+            }
+            catch (outerError) {
+                // Outer JSON.parse failed - not JSON at all, try legacy text
+            }
+        }
+        // No legacy fallback - enhanced protocol required
+    }
+    return undefined;
+}

package/dist/core/events/approval-checker.js.map

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

package/dist/core/events/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Events Module - Public API
+ *
+ * This module provides event publishing, subscription, and agent orchestration functions.
+ * All functions are now extracted into modular structure for better maintainability.
+ *
+ * Modular structure:
+ * - publishers.ts: Event emission functions (Layer 3)
+ * - mention-logic.ts: Auto-mention processing (Layer 2)
+ * - persistence.ts: Event persistence (Layer 4)
+ * - memory-manager.ts: Memory & LLM resumption (Layer 4)
+ * - orchestrator.ts: Agent message processing (Layer 5)
+ * - subscribers.ts: Event subscriptions (Layer 6)
+ *
+ * Changes:
+ * - 2026-02-08: Removed outdated manual tool-intervention checker module reference
+ * - 2025-11-09: Completed extraction of all layers (2-6) from monolithic events.ts
+ */
+export * from './mention-logic.js';
+export * from './publishers.js';
+export * from './persistence.js';
+export * from './memory-manager.js';
+export * from './orchestrator.js';
+export * from './subscribers.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../core/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,cAAc,oBAAoB,CAAC;AAGnC,cAAc,iBAAiB,CAAC;AAGhC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,kBAAkB,CAAC"}

package/dist/core/events/index.js

@@ -0,0 +1,30 @@
+/**
+ * Events Module - Public API
+ *
+ * This module provides event publishing, subscription, and agent orchestration functions.
+ * All functions are now extracted into modular structure for better maintainability.
+ *
+ * Modular structure:
+ * - publishers.ts: Event emission functions (Layer 3)
+ * - mention-logic.ts: Auto-mention processing (Layer 2)
+ * - persistence.ts: Event persistence (Layer 4)
+ * - memory-manager.ts: Memory & LLM resumption (Layer 4)
+ * - orchestrator.ts: Agent message processing (Layer 5)
+ * - subscribers.ts: Event subscriptions (Layer 6)
+ *
+ * Changes:
+ * - 2026-02-08: Removed outdated manual tool-intervention checker module reference
+ * - 2025-11-09: Completed extraction of all layers (2-6) from monolithic events.ts
+ */
+// Layer 2: Pure utilities (no dependencies)
+export * from './mention-logic.js';
+// Layer 3: Event publishers
+export * from './publishers.js';
+// Layer 4: Persistence & Memory
+export * from './persistence.js';
+export * from './memory-manager.js';
+// Layer 5: Orchestration
+export * from './orchestrator.js';
+// Layer 6: Subscriptions
+export * from './subscribers.js';
+//# sourceMappingURL=index.js.map

package/dist/core/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../core/events/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,4CAA4C;AAC5C,cAAc,oBAAoB,CAAC;AAEnC,4BAA4B;AAC5B,cAAc,iBAAiB,CAAC;AAEhC,gCAAgC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AAEpC,yBAAyB;AACzB,cAAc,mBAAmB,CAAC;AAElC,yBAAyB;AACzB,cAAc,kBAAkB,CAAC"}