nduka 1.0.0

package/dist/agent-tools/tool-candidate-detector.js

@@ -0,0 +1,165 @@
+import { compileConfiguredPattern, compileConfiguredPatterns, loadAgentToolSettings } from './settings.js';
+function compileSettings(settings) {
+    return {
+        maxCandidates: Math.max(1, Math.min(settings.maxCandidates, 10)),
+        minScore: Math.max(1, settings.minScore),
+        normalChatPatterns: compileConfiguredPatterns(settings.normalChatPatterns, 'candidateDetector.normalChatPatterns'),
+        toolNeedPatterns: compileConfiguredPatterns(settings.toolNeedPatterns, 'candidateDetector.toolNeedPatterns'),
+        followupPatterns: compileConfiguredPatterns(settings.followupPatterns, 'candidateDetector.followupPatterns'),
+        openOrFetchPattern: compileConfiguredPattern(settings.openOrFetchPattern, 'candidateDetector.openOrFetchPattern'),
+        sameToolFollowupPattern: compileConfiguredPattern(settings.sameToolFollowupPattern, 'candidateDetector.sameToolFollowupPattern'),
+    };
+}
+function detectorSettings(input) {
+    return compileSettings(input.settings || loadAgentToolSettings().candidateDetector);
+}
+function words(value) {
+    return new Set(value.toLowerCase().replace(/[^a-z0-9_:/.-]+/g, ' ').split(/\s+/).filter((part) => part.length >= 3));
+}
+function hasUrl(text) {
+    const lower = text.toLowerCase();
+    return lower.includes('http://') || lower.includes('https://');
+}
+function textIncludesAny(text, values) {
+    const lower = text.toLowerCase();
+    return values.some((value) => value.trim() && lower.includes(value.trim().toLowerCase()));
+}
+function schemaText(tool) {
+    return Object.entries(tool.inputSchema)
+        .map(([name, field]) => `${name} ${field.description || ''}`)
+        .join(' ');
+}
+function toolAcceptsUrl(tool) {
+    return /\b(url|uri|link|href|website|webpage|web page)\b/i.test(schemaText(tool));
+}
+function actorCanSeeTool(tool, actorRole) {
+    if (!tool.enabled || !tool.providerConfig.enabled)
+        return false;
+    if (actorRole === 'owner')
+        return true;
+    if (actorRole === 'group')
+        return tool.public && !tool.ownerOnly && tool.customerCallable !== false;
+    return tool.public && !tool.ownerOnly && tool.customerCallable !== false;
+}
+function toolText(tool) {
+    return [
+        tool.name,
+        tool.description,
+        tool.provider,
+        tool.operation,
+        tool.operationConfig.kind,
+        ...tool.aliases,
+        ...(tool.capabilityTags || []),
+        ...Object.keys(tool.inputSchema),
+        ...Object.values(tool.inputSchema).map((field) => field.description || ''),
+    ].filter(Boolean).join(' ');
+}
+function scoreTool(text, tool, patterns) {
+    const messageWords = words(text);
+    const toolWords = words(toolText(tool));
+    let score = 0;
+    for (const word of messageWords) {
+        if (toolWords.has(word))
+            score += 1;
+    }
+    if (textIncludesAny(text, tool.aliases))
+        score += 4;
+    if (text.toLowerCase().includes(tool.name.toLowerCase()))
+        score += 5;
+    if (patterns.toolNeedPatterns.some((pattern) => pattern.test(text)))
+        score += 2;
+    if (hasUrl(text) && toolAcceptsUrl(tool))
+        score += 5;
+    return score;
+}
+function isLikelyNormalMemoryOrWriting(text, patterns) {
+    return patterns.normalChatPatterns.some((pattern) => pattern.test(text));
+}
+function followupHint(text, recentToolContexts = [], patterns) {
+    if (recentToolContexts.length === 0)
+        return undefined;
+    if (!patterns.followupPatterns.some((pattern) => pattern.test(text)))
+        return undefined;
+    const now = Date.now();
+    const active = recentToolContexts.filter((context) => !context.expiresAt || context.expiresAt > now);
+    if (active.length === 0) {
+        return { possibleToolFollowup: false, reason: 'recent_tool_context_expired' };
+    }
+    if (active.length === 1) {
+        return {
+            possibleToolFollowup: true,
+            contextId: active[0].contextId,
+            contextIds: [active[0].contextId],
+            kind: patterns.openOrFetchPattern.test(text)
+                ? 'call_new_tool'
+                : patterns.sameToolFollowupPattern.test(text)
+                    ? 'call_same_tool'
+                    : 'answer_from_context',
+            reason: 'single_recent_tool_context',
+        };
+    }
+    const ordinal = /\b(first|1st)\b/i.test(text) ? 0 : /\b(second|2nd)\b/i.test(text) ? 1 : /\b(third|3rd)\b/i.test(text) ? 2 : -1;
+    if (ordinal >= 0 && active[ordinal]) {
+        return {
+            possibleToolFollowup: true,
+            contextId: active[ordinal].contextId,
+            contextIds: [active[ordinal].contextId],
+            kind: patterns.openOrFetchPattern.test(text) ? 'call_new_tool' : 'answer_from_context',
+            reason: 'ordinal_tool_context_reference',
+        };
+    }
+    return {
+        possibleToolFollowup: true,
+        contextIds: active.map((context) => context.contextId),
+        kind: 'clarify',
+        reason: 'ambiguous_recent_tool_context_reference',
+    };
+}
+export class ToolCandidateDetector {
+    detect(input) {
+        const text = input.text.trim();
+        const patterns = detectorSettings(input);
+        const maxCandidates = Math.max(1, Math.min(input.maxCandidates ?? patterns.maxCandidates, 10));
+        const minScore = Math.max(1, input.minScore ?? patterns.minScore);
+        const followup = followupHint(text, input.recentToolContexts || [], patterns);
+        if (!text) {
+            return { shouldPlanWithClaude: false, candidateToolNames: [], reason: 'empty_message', confidence: 0 };
+        }
+        if (followup?.possibleToolFollowup) {
+            const relatedToolNames = (input.recentToolContexts || [])
+                .filter((context) => !followup.contextIds || followup.contextIds.includes(context.contextId))
+                .map((context) => context.toolName);
+            const candidates = Array.from(new Set(relatedToolNames)).filter((name) => input.tools.some((tool) => tool.name === name && actorCanSeeTool(tool, input.actorRole)));
+            if (candidates.length > 0) {
+                return {
+                    shouldPlanWithClaude: true,
+                    candidateToolNames: candidates.slice(0, maxCandidates),
+                    reason: followup.reason || 'tool_followup_candidate',
+                    confidence: followup.kind === 'clarify' ? 0.55 : 0.85,
+                    followupHint: followup,
+                };
+            }
+        }
+        if (isLikelyNormalMemoryOrWriting(text, patterns) && !patterns.toolNeedPatterns.some((pattern) => pattern.test(text))) {
+            return { shouldPlanWithClaude: false, candidateToolNames: [], reason: 'normal_chat_or_memory_request', confidence: 0.2, followupHint: followup };
+        }
+        const scored = input.tools
+            .filter((tool) => actorCanSeeTool(tool, input.actorRole))
+            .map((tool) => ({ tool, score: scoreTool(text, tool, patterns) }))
+            .filter((item) => item.score >= minScore)
+            .sort((a, b) => b.score - a.score || a.tool.name.localeCompare(b.tool.name))
+            .slice(0, maxCandidates);
+        if (scored.length === 0) {
+            return { shouldPlanWithClaude: false, candidateToolNames: [], reason: 'no_configured_tool_candidate', confidence: 0.2, followupHint: followup };
+        }
+        const topScore = scored[0].score;
+        return {
+            shouldPlanWithClaude: true,
+            candidateToolNames: scored.map((item) => item.tool.name),
+            reason: 'configured_tool_candidate_detected',
+            confidence: Math.min(0.95, 0.45 + topScore / 20),
+            followupHint: followup,
+        };
+    }
+}
+//# sourceMappingURL=tool-candidate-detector.js.map

package/dist/agent-tools/tool-candidate-detector.js.map

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

package/dist/agent-tools/tool-chain-runner.d.ts

@@ -0,0 +1,24 @@
+import type { ValidatedToolCallPlan } from './types.js';
+import { ToolSessionStore } from './tool-session-store.js';
+export interface ToolChainRunnerInput {
+    plans: ValidatedToolCallPlan[];
+    chatJid: string;
+    originalMessageId: string;
+    correlationId: string;
+    store?: ToolSessionStore;
+    maxSteps?: number;
+}
+export interface ToolChainRunnerResult {
+    ok: boolean;
+    sessionId?: string;
+    acceptedPlans: ValidatedToolCallPlan[];
+    rejectedPlans: Array<{
+        toolName: string;
+        reason: string;
+        code: string;
+    }>;
+}
+export declare class ToolChainRunner {
+    createSession(input: ToolChainRunnerInput): ToolChainRunnerResult;
+}
+//# sourceMappingURL=tool-chain-runner.d.ts.map

package/dist/agent-tools/tool-chain-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-chain-runner.d.ts","sourceRoot":"","sources":["../../src/agent-tools/tool-chain-runner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,qBAAqB,EAAE,CAAC;IACvC,aAAa,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC1E;AAMD,qBAAa,eAAe;IAC1B,aAAa,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB;CAmClE"}

package/dist/agent-tools/tool-chain-runner.js

@@ -0,0 +1,39 @@
+import { loadAgentToolSettings } from './settings.js';
+import { ToolSessionStore } from './tool-session-store.js';
+function isReadOnly(plan) {
+    return plan.tool.public && !plan.tool.ownerOnly && !plan.tool.requiresApproval;
+}
+export class ToolChainRunner {
+    createSession(input) {
+        const settings = loadAgentToolSettings();
+        const maxSteps = Math.max(1, Math.min(input.maxSteps || settings.chain.maxSteps, 5));
+        const acceptedPlans = [];
+        const rejectedPlans = [];
+        for (const plan of input.plans) {
+            if (acceptedPlans.length >= maxSteps) {
+                rejectedPlans.push({ toolName: plan.toolName, reason: `Tool chain step limit exceeded: ${maxSteps}`, code: 'TOOL_CHAIN_STEP_LIMIT' });
+                continue;
+            }
+            if (settings.chain.readOnlyOnly && !isReadOnly(plan)) {
+                rejectedPlans.push({ toolName: plan.toolName, reason: 'Tool chains only allow read-only tools while chain.readOnlyOnly is enabled.', code: 'TOOL_CHAIN_REQUIRES_READ_ONLY' });
+                continue;
+            }
+            acceptedPlans.push(plan);
+        }
+        if (acceptedPlans.length === 0)
+            return { ok: false, acceptedPlans, rejectedPlans };
+        const store = input.store || new ToolSessionStore();
+        const session = store.create({ chatJid: input.chatJid, originalMessageId: input.originalMessageId, correlationId: input.correlationId });
+        acceptedPlans.forEach((plan, index) => {
+            store.addStep({
+                sessionId: session.sessionId,
+                stepIndex: index + 1,
+                toolName: plan.toolName,
+                status: 'planned',
+                dependsOnStepIndex: index === 0 ? null : index,
+            });
+        });
+        return { ok: rejectedPlans.length === 0, sessionId: session.sessionId, acceptedPlans, rejectedPlans };
+    }
+}
+//# sourceMappingURL=tool-chain-runner.js.map

package/dist/agent-tools/tool-chain-runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-chain-runner.js","sourceRoot":"","sources":["../../src/agent-tools/tool-chain-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAkB3D,SAAS,UAAU,CAAC,IAA2B;IAC7C,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC;AACjF,CAAC;AAED,MAAM,OAAO,eAAe;IAC1B,aAAa,CAAC,KAA2B;QACvC,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;QACrF,MAAM,aAAa,GAA4B,EAAE,CAAC;QAClD,MAAM,aAAa,GAA8D,EAAE,CAAC;QAEpF,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC/B,IAAI,aAAa,CAAC,MAAM,IAAI,QAAQ,EAAE,CAAC;gBACrC,aAAa,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,mCAAmC,QAAQ,EAAE,EAAE,IAAI,EAAE,uBAAuB,EAAE,CAAC,CAAC;gBACtI,SAAS;YACX,CAAC;YACD,IAAI,QAAQ,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrD,aAAa,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,6EAA6E,EAAE,IAAI,EAAE,+BAA+B,EAAE,CAAC,CAAC;gBAC9K,SAAS;YACX,CAAC;YACD,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC;QAEnF,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,IAAI,gBAAgB,EAAE,CAAC;QACpD,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC;QAEzI,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YACpC,KAAK,CAAC,OAAO,CAAC;gBACZ,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,SAAS,EAAE,KAAK,GAAG,CAAC;gBACpB,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,MAAM,EAAE,SAAS;gBACjB,kBAAkB,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK;aAC/C,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,EAAE,EAAE,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,CAAC;IACxG,CAAC;CACF"}

package/dist/agent-tools/tool-context-store.d.ts

@@ -0,0 +1,28 @@
+import type { ToolContextSummary } from './types.js';
+export interface StoreToolContextInput {
+    chatJid: string;
+    sourceMessageId: string;
+    correlationId: string;
+    jobId?: string | null;
+    toolName: string;
+    toolArgs?: Record<string, unknown>;
+    resultSummary: string;
+    resultPreview?: string;
+    resultJson?: unknown;
+    sourceUrls?: string[];
+    citations?: string[];
+    entities?: string[];
+    createdAt?: number;
+    expiresAt?: number | null;
+    status?: 'active' | 'failed' | 'expired';
+}
+export declare class ToolContextStore {
+    private db;
+    private initialized;
+    constructor();
+    private init;
+    store(input: StoreToolContextInput): ToolContextSummary;
+    listRecent(chatJid: string, limit?: number): ToolContextSummary[];
+    expire(contextIdValue: string): boolean;
+}
+//# sourceMappingURL=tool-context-store.d.ts.map

package/dist/agent-tools/tool-context-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-context-store.d.ts","sourceRoot":"","sources":["../../src/agent-tools/tool-context-store.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;CAC1C;AAwED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,EAAE,CAAiC;IAC3C,OAAO,CAAC,WAAW,CAAS;;IAM5B,OAAO,CAAC,IAAI;IA6BZ,KAAK,CAAC,KAAK,EAAE,qBAAqB,GAAG,kBAAkB;IA4CvD,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,kBAAkB,EAAE;IAU7D,MAAM,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO;CAMxC"}

package/dist/agent-tools/tool-context-store.js

@@ -0,0 +1,127 @@
+import { randomUUID } from 'node:crypto';
+import { DatabaseManager } from '../database/index.js';
+import { logAgentToolEvent } from './logging.js';
+function json(value) {
+    return JSON.stringify(value ?? null);
+}
+function parseArray(value) {
+    try {
+        const parsed = JSON.parse(value);
+        return Array.isArray(parsed) ? parsed.filter((item) => typeof item === 'string') : [];
+    }
+    catch {
+        return [];
+    }
+}
+function parseRecord(value) {
+    try {
+        const parsed = JSON.parse(value);
+        return typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed) ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+function cleanText(value, maxLength) {
+    const cleaned = value.replace(/\s+/g, ' ').trim();
+    if (!cleaned)
+        throw new Error('Tool context requires non-empty text.');
+    return cleaned.slice(0, maxLength);
+}
+function contextId() {
+    return `ctx_${randomUUID().replace(/-/g, '').slice(0, 12)}`;
+}
+function contextStatus(value) {
+    return value === 'failed' || value === 'expired' ? value : 'active';
+}
+function mapRow(row) {
+    return {
+        contextId: row.context_id,
+        toolName: row.tool_name,
+        summary: row.result_summary,
+        resultPreview: row.result_preview || undefined,
+        toolArgs: parseRecord(row.tool_args_json),
+        status: contextStatus(row.status),
+        entities: parseArray(row.entities_json),
+        sourceUrls: parseArray(row.source_urls_json),
+        createdAt: row.created_at,
+        expiresAt: row.expires_at || undefined,
+    };
+}
+export class ToolContextStore {
+    db = DatabaseManager.getInstance();
+    initialized = false;
+    constructor() {
+        this.init();
+    }
+    init() {
+        if (this.initialized)
+            return;
+        this.db.getDb().exec(`
+      CREATE TABLE IF NOT EXISTS tool_contexts (
+        context_id TEXT PRIMARY KEY NOT NULL,
+        chat_jid TEXT NOT NULL,
+        source_message_id TEXT NOT NULL,
+        correlation_id TEXT NOT NULL,
+        job_id TEXT,
+        tool_name TEXT NOT NULL,
+        tool_args_json TEXT NOT NULL DEFAULT '{}',
+        result_summary TEXT NOT NULL,
+        result_preview TEXT,
+        result_json TEXT,
+        source_urls_json TEXT NOT NULL DEFAULT '[]',
+        citations_json TEXT NOT NULL DEFAULT '[]',
+        entities_json TEXT NOT NULL DEFAULT '[]',
+        created_at INTEGER NOT NULL,
+        expires_at INTEGER,
+        status TEXT NOT NULL DEFAULT 'active'
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_tool_contexts_chat ON tool_contexts(chat_jid, created_at);
+      CREATE INDEX IF NOT EXISTS idx_tool_contexts_job ON tool_contexts(job_id);
+      CREATE INDEX IF NOT EXISTS idx_tool_contexts_correlation ON tool_contexts(correlation_id);
+    `);
+        this.initialized = true;
+    }
+    store(input) {
+        const id = contextId();
+        const now = input.createdAt || Date.now();
+        const summary = cleanText(input.resultSummary, 4000);
+        this.db.getDb().prepare(`
+      INSERT INTO tool_contexts (
+        context_id, chat_jid, source_message_id, correlation_id, job_id, tool_name,
+        tool_args_json, result_summary, result_preview, result_json, source_urls_json,
+        citations_json, entities_json, created_at, expires_at, status
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(id, cleanText(input.chatJid, 300), cleanText(input.sourceMessageId, 300), cleanText(input.correlationId, 120), input.jobId || null, cleanText(input.toolName, 120), json(input.toolArgs || {}), summary, input.resultPreview ? cleanText(input.resultPreview, 4000) : null, input.resultJson === undefined ? null : json(input.resultJson), json(input.sourceUrls || []), json(input.citations || []), json(input.entities || []), now, input.expiresAt || null, input.status || 'active');
+        logAgentToolEvent({ event: 'AgentToolContextStored', correlationId: input.correlationId, toolName: input.toolName });
+        return {
+            contextId: id,
+            toolName: input.toolName,
+            summary,
+            resultPreview: input.resultPreview,
+            toolArgs: input.toolArgs || {},
+            status: input.status || 'active',
+            entities: input.entities || [],
+            sourceUrls: input.sourceUrls || [],
+            createdAt: now,
+            expiresAt: input.expiresAt || undefined,
+        };
+    }
+    listRecent(chatJid, limit = 10) {
+        const rows = this.db.getDb().prepare(`
+      SELECT * FROM tool_contexts
+      WHERE chat_jid = ? AND status IN ('active', 'failed') AND (expires_at IS NULL OR expires_at > ?)
+      ORDER BY created_at DESC
+      LIMIT ?
+    `).all(cleanText(chatJid, 300), Date.now(), Math.max(1, Math.min(limit, 50)));
+        return rows.map(mapRow);
+    }
+    expire(contextIdValue) {
+        const result = this.db.getDb().prepare(`
+      UPDATE tool_contexts SET status = 'expired' WHERE context_id = ? AND status = 'active'
+    `).run(cleanText(contextIdValue, 120));
+        return result.changes > 0;
+    }
+}
+//# sourceMappingURL=tool-context-store.js.map

package/dist/agent-tools/tool-context-store.js.map

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

package/dist/agent-tools/tool-followup-resolver.d.ts

@@ -0,0 +1,18 @@
+import type { ResolvedCatalogTool } from '../tools/tool-catalog-config.js';
+import type { AgentToolActorRole, ToolContextSummary, ToolFollowupHint } from './types.js';
+export interface ToolFollowupResolverInput {
+    text: string;
+    actorRole: AgentToolActorRole;
+    recentToolContexts: ToolContextSummary[];
+    tools: ResolvedCatalogTool[];
+}
+export interface ToolFollowupResolution extends ToolFollowupHint {
+    candidateToolNames: string[];
+    confidence: number;
+    contextSummary?: string;
+    clarificationReply?: string;
+}
+export declare class ToolFollowupResolver {
+    resolve(input: ToolFollowupResolverInput): ToolFollowupResolution;
+}
+//# sourceMappingURL=tool-followup-resolver.d.ts.map

package/dist/agent-tools/tool-followup-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-followup-resolver.d.ts","sourceRoot":"","sources":["../../src/agent-tools/tool-followup-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC3E,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAoB,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE7G,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,kBAAkB,CAAC;IAC9B,kBAAkB,EAAE,kBAAkB,EAAE,CAAC;IACzC,KAAK,EAAE,mBAAmB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AA2CD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,KAAK,EAAE,yBAAyB,GAAG,sBAAsB;CA8DlE"}

package/dist/agent-tools/tool-followup-resolver.js

@@ -0,0 +1,98 @@
+const FOLLOWUP_REFERENCES = /\b(it|that|this|those|them|the first|first one|1st|the second|second one|2nd|the third|third one|3rd|the other one|what about|how about|open it|open that|fetch it|fetch that|summarize it|summarize that|compare them|is that still true)\b/i;
+const OPEN_OR_FETCH = /\b(open|fetch|visit|read the link|go to)\b/i;
+const SUMMARIZE_OR_COMPARE = /\b(summarize|compare|explain|simpler|shorter|what does it mean)\b/i;
+function activeContexts(contexts) {
+    const now = Date.now();
+    return contexts.filter((context) => !context.expiresAt || context.expiresAt > now).sort((a, b) => b.createdAt - a.createdAt);
+}
+function ordinalIndex(text) {
+    if (/\b(first|1st)\b/i.test(text))
+        return 0;
+    if (/\b(second|2nd)\b/i.test(text))
+        return 1;
+    if (/\b(third|3rd)\b/i.test(text))
+        return 2;
+    return null;
+}
+function tokenCount(text) {
+    return text.match(/[\p{L}\p{N}]+/gu)?.length || 0;
+}
+function isConciseReference(text) {
+    if (ordinalIndex(text) !== null)
+        return true;
+    return tokenCount(text) <= 8;
+}
+function toolNamesVisibleToActor(contexts, tools, actorRole) {
+    const visible = new Set(tools
+        .filter((tool) => actorRole === 'owner' || (tool.public && !tool.ownerOnly && tool.customerCallable !== false))
+        .map((tool) => tool.name));
+    return Array.from(new Set(contexts.map((context) => context.toolName).filter((name) => visible.has(name))));
+}
+function inferKind(text) {
+    if (OPEN_OR_FETCH.test(text))
+        return 'call_new_tool';
+    if (SUMMARIZE_OR_COMPARE.test(text))
+        return 'answer_from_context';
+    if (/\b(what about|how about|still|latest|current|today|tomorrow|saturday|sunday|monday|tuesday|wednesday|thursday|friday)\b/i.test(text))
+        return 'call_same_tool';
+    return 'answer_from_context';
+}
+export class ToolFollowupResolver {
+    resolve(input) {
+        const text = input.text.trim();
+        const active = activeContexts(input.recentToolContexts);
+        if (!text || active.length === 0 || !FOLLOWUP_REFERENCES.test(text)) {
+            return { possibleToolFollowup: false, candidateToolNames: [], confidence: 0, reason: active.length === 0 ? 'no_recent_tool_context' : 'no_followup_reference' };
+        }
+        if (!isConciseReference(text)) {
+            return { possibleToolFollowup: false, candidateToolNames: [], confidence: 0, reason: 'non_concise_followup_reference' };
+        }
+        const ordinal = ordinalIndex(text);
+        if (ordinal !== null) {
+            const context = active[ordinal];
+            if (!context) {
+                return {
+                    possibleToolFollowup: true,
+                    candidateToolNames: [],
+                    confidence: 0.45,
+                    kind: 'clarify',
+                    reason: 'ordinal_reference_out_of_range',
+                    clarificationReply: 'Which result do you mean?',
+                };
+            }
+            return {
+                possibleToolFollowup: true,
+                contextId: context.contextId,
+                contextIds: [context.contextId],
+                candidateToolNames: toolNamesVisibleToActor([context], input.tools, input.actorRole),
+                kind: inferKind(text),
+                confidence: 0.86,
+                reason: 'ordinal_tool_followup',
+                contextSummary: context.summary,
+            };
+        }
+        if (active.length === 1) {
+            const context = active[0];
+            return {
+                possibleToolFollowup: true,
+                contextId: context.contextId,
+                contextIds: [context.contextId],
+                candidateToolNames: toolNamesVisibleToActor([context], input.tools, input.actorRole),
+                kind: inferKind(text),
+                confidence: 0.82,
+                reason: 'single_recent_tool_followup',
+                contextSummary: context.summary,
+            };
+        }
+        return {
+            possibleToolFollowup: true,
+            contextIds: active.map((context) => context.contextId),
+            candidateToolNames: toolNamesVisibleToActor(active, input.tools, input.actorRole),
+            kind: 'clarify',
+            confidence: 0.55,
+            reason: 'ambiguous_tool_followup',
+            clarificationReply: 'Which result do you mean?',
+        };
+    }
+}
+//# sourceMappingURL=tool-followup-resolver.js.map

package/dist/agent-tools/tool-followup-resolver.js.map

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

package/dist/agent-tools/tool-plan-validator.d.ts

@@ -0,0 +1,13 @@
+import type { ResolvedCatalogTool } from '../tools/tool-catalog-config.js';
+import type { AgentToolActorRole, ClaudeToolPlannerDecision, ToolPlanValidationResult } from './types.js';
+export interface ToolPlanValidatorInput {
+    decision: ClaudeToolPlannerDecision;
+    candidateToolNames: string[];
+    tools: ResolvedCatalogTool[];
+    actorRole: AgentToolActorRole;
+    correlationId?: string;
+}
+export declare class ToolPlanValidator {
+    validate(input: ToolPlanValidatorInput): ToolPlanValidationResult;
+}
+//# sourceMappingURL=tool-plan-validator.d.ts.map

package/dist/agent-tools/tool-plan-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-plan-validator.d.ts","sourceRoot":"","sources":["../../src/agent-tools/tool-plan-validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC9F,OAAO,KAAK,EAAE,kBAAkB,EAAE,yBAAyB,EAAqB,wBAAwB,EAAyB,MAAM,YAAY,CAAC;AAGpJ,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,yBAAyB,CAAC;IACpC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,SAAS,EAAE,kBAAkB,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAwCD,qBAAa,iBAAiB;IAC5B,QAAQ,CAAC,KAAK,EAAE,sBAAsB,GAAG,wBAAwB;CA2FlE"}