nduka 1.0.0

package/dist/agent-tools/tool-plan-validator.js

@@ -0,0 +1,119 @@
+import { logAgentToolEvent } from './logging.js';
+function actorCanUseTool(tool, actorRole) {
+    if (!tool.enabled || !tool.providerConfig.enabled)
+        return false;
+    if (actorRole === 'owner')
+        return true;
+    return tool.public && !tool.ownerOnly && tool.customerCallable !== false;
+}
+function schemaTypeMatches(value, field) {
+    if (field.type === 'string')
+        return typeof value === 'string';
+    if (field.type === 'number')
+        return typeof value === 'number' && Number.isFinite(value);
+    if (field.type === 'boolean')
+        return typeof value === 'boolean';
+    return false;
+}
+function validateArgs(tool, args) {
+    const rejections = [];
+    const allowed = new Set(Object.keys(tool.inputSchema));
+    for (const key of Object.keys(args)) {
+        if (!allowed.has(key)) {
+            rejections.push({ toolName: tool.name, code: 'TOOL_EXTRA_ARGUMENT', reason: `Unexpected field: ${key}` });
+        }
+    }
+    for (const [fieldName, field] of Object.entries(tool.inputSchema)) {
+        const value = args[fieldName];
+        const missing = !(fieldName in args) || value === null || value === undefined || value === '';
+        if (field.required && missing) {
+            rejections.push({ toolName: tool.name, code: 'TOOL_SCHEMA_INVALID', reason: `Missing required field: ${fieldName}` });
+            continue;
+        }
+        if (!missing && !schemaTypeMatches(value, field)) {
+            rejections.push({ toolName: tool.name, code: 'TOOL_SCHEMA_INVALID', reason: `Type mismatch for ${fieldName}: expected ${field.type}` });
+        }
+    }
+    return rejections;
+}
+export class ToolPlanValidator {
+    validate(input) {
+        const candidateSet = new Set(input.candidateToolNames);
+        const toolsByName = new Map(input.tools.map((tool) => [tool.name, tool]));
+        const acceptedCalls = [];
+        const rejectedCalls = [];
+        if (input.decision.decision !== 'tool_use') {
+            return { ok: true, acceptedCalls, rejectedCalls, requiresOwnerApproval: false, requiresAsync: false };
+        }
+        if (input.decision.toolCalls.length === 0) {
+            rejectedCalls.push({ code: 'TOOL_PLAN_EMPTY', reason: 'Planner returned tool_use without toolCalls.' });
+        }
+        for (const call of input.decision.toolCalls) {
+            const tool = toolsByName.get(call.toolName);
+            if (!tool) {
+                rejectedCalls.push({ toolName: call.toolName, code: 'TOOL_UNKNOWN', reason: `Unknown tool: ${call.toolName}` });
+                continue;
+            }
+            if (!candidateSet.has(tool.name)) {
+                rejectedCalls.push({ toolName: tool.name, code: 'TOOL_NOT_CANDIDATE', reason: `Tool was not in the candidate set: ${tool.name}` });
+                continue;
+            }
+            if (!tool.enabled || !tool.providerConfig.enabled) {
+                rejectedCalls.push({ toolName: tool.name, code: 'TOOL_DISABLED', reason: `Tool or provider is disabled: ${tool.name}` });
+                continue;
+            }
+            if (!actorCanUseTool(tool, input.actorRole)) {
+                rejectedCalls.push({ toolName: tool.name, code: 'TOOL_NOT_ALLOWED_FOR_ACTOR', reason: `Tool is not allowed for actor role: ${input.actorRole}` });
+                continue;
+            }
+            const argErrors = validateArgs(tool, call.arguments);
+            if (argErrors.length > 0) {
+                rejectedCalls.push(...argErrors);
+                continue;
+            }
+            const requiresOwnerApproval = tool.requiresApproval === true || (tool.ownerOnly && input.actorRole !== 'owner') || input.decision.requiresOwnerApproval;
+            if (requiresOwnerApproval && input.actorRole !== 'owner') {
+                rejectedCalls.push({ toolName: tool.name, code: 'TOOL_REQUIRES_APPROVAL', reason: `Tool requires owner approval: ${tool.name}` });
+                continue;
+            }
+            acceptedCalls.push({
+                tool,
+                toolName: tool.name,
+                arguments: call.arguments,
+                requiresAsync: input.decision.requiresAsync || tool.asyncEligible,
+                requiresOwnerApproval,
+                reason: call.reason,
+            });
+        }
+        const requiresOwnerApproval = acceptedCalls.some((call) => call.requiresOwnerApproval);
+        const requiresAsync = acceptedCalls.some((call) => call.requiresAsync);
+        const ok = acceptedCalls.length > 0 && rejectedCalls.length === 0;
+        for (const rejection of rejectedCalls) {
+            logAgentToolEvent({
+                event: 'AgentToolPlanRejected',
+                correlationId: input.correlationId,
+                actorRole: input.actorRole,
+                toolName: rejection.toolName,
+                code: rejection.code,
+                reason: rejection.reason,
+            });
+        }
+        if (acceptedCalls.length > 0) {
+            logAgentToolEvent({
+                event: 'AgentToolPlanAccepted',
+                correlationId: input.correlationId,
+                actorRole: input.actorRole,
+                candidateCount: acceptedCalls.length,
+                reason: input.decision.reason,
+            });
+        }
+        return {
+            ok,
+            acceptedCalls,
+            rejectedCalls,
+            requiresOwnerApproval,
+            requiresAsync,
+        };
+    }
+}
+//# sourceMappingURL=tool-plan-validator.js.map

package/dist/agent-tools/tool-plan-validator.js.map

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

package/dist/agent-tools/tool-result-summarizer.d.ts

@@ -0,0 +1,17 @@
+export interface ToolResultSummaryInput {
+    toolName: string;
+    data?: unknown;
+    error?: string;
+    sources?: string[];
+    maxLength?: number;
+}
+export interface ToolResultSummary {
+    ok: boolean;
+    summary: string;
+    resultPreview: string;
+    sourceUrls: string[];
+}
+export declare class ToolResultSummarizer {
+    summarize(input: ToolResultSummaryInput): ToolResultSummary;
+}
+//# sourceMappingURL=tool-result-summarizer.d.ts.map

package/dist/agent-tools/tool-result-summarizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-summarizer.d.ts","sourceRoot":"","sources":["../../src/agent-tools/tool-result-summarizer.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAmBD,qBAAa,oBAAoB;IAC/B,SAAS,CAAC,KAAK,EAAE,sBAAsB,GAAG,iBAAiB;CAqB5D"}

package/dist/agent-tools/tool-result-summarizer.js

@@ -0,0 +1,41 @@
+function safeString(value) {
+    if (typeof value === 'string')
+        return value;
+    if (value === undefined || value === null)
+        return '';
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return String(value);
+    }
+}
+function extractUrls(value) {
+    const text = safeString(value);
+    const urls = text.match(/https?:\/\/[^\s"'<>]+/g) || [];
+    return Array.from(new Set(urls)).slice(0, 10);
+}
+function compactWhitespace(value) {
+    return value.replace(/\s+/g, ' ').trim();
+}
+export class ToolResultSummarizer {
+    summarize(input) {
+        const maxLength = Math.max(120, Math.min(input.maxLength ?? 1200, 4000));
+        const sourceUrls = Array.from(new Set([...(input.sources || []), ...extractUrls(input.data)])).slice(0, 10);
+        if (input.error) {
+            const summary = compactWhitespace(`The configured tool ${input.toolName} failed: ${input.error}`).slice(0, maxLength);
+            return { ok: false, summary, resultPreview: summary, sourceUrls };
+        }
+        const raw = compactWhitespace(safeString(input.data));
+        const resultPreview = raw.slice(0, maxLength);
+        const sourceLine = sourceUrls.length ? ` Sources: ${sourceUrls.slice(0, 3).join(' ')}` : '';
+        const summary = compactWhitespace(`${resultPreview}${sourceLine}`).slice(0, maxLength);
+        return {
+            ok: true,
+            summary: summary || `The configured tool ${input.toolName} completed without a text result.`,
+            resultPreview: resultPreview || '',
+            sourceUrls,
+        };
+    }
+}
+//# sourceMappingURL=tool-result-summarizer.js.map

package/dist/agent-tools/tool-result-summarizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-result-summarizer.js","sourceRoot":"","sources":["../../src/agent-tools/tool-result-summarizer.ts"],"names":[],"mappings":"AAeA,SAAS,UAAU,CAAC,KAAc;IAChC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACrD,IAAI,CAAC;QAAC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAAC,CAAC;IACrC,MAAM,CAAC;QAAC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IAAC,CAAC;AACjC,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,IAAI,EAAE,CAAC;IACxD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAa;IACtC,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,OAAO,oBAAoB;IAC/B,SAAS,CAAC,KAA6B;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,IAAI,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACzE,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAE5G,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,MAAM,OAAO,GAAG,iBAAiB,CAAC,uBAAuB,KAAK,CAAC,QAAQ,YAAY,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;YACtH,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;QACpE,CAAC;QAED,MAAM,GAAG,GAAG,iBAAiB,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACtD,MAAM,aAAa,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAC9C,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5F,MAAM,OAAO,GAAG,iBAAiB,CAAC,GAAG,aAAa,GAAG,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QAEvF,OAAO;YACL,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,OAAO,IAAI,uBAAuB,KAAK,CAAC,QAAQ,mCAAmC;YAC5F,aAAa,EAAE,aAAa,IAAI,EAAE;YAClC,UAAU;SACX,CAAC;IACJ,CAAC;CACF"}

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

@@ -0,0 +1,49 @@
+export type ToolSessionStatus = 'active' | 'succeeded' | 'failed' | 'cancelled';
+export type ToolSessionStepStatus = 'planned' | 'queued' | 'running' | 'succeeded' | 'failed' | 'skipped';
+export interface CreateToolSessionInput {
+    chatJid: string;
+    originalMessageId: string;
+    correlationId: string;
+    createdAt?: number;
+}
+export interface AddToolSessionStepInput {
+    sessionId: string;
+    stepIndex: number;
+    toolName: string;
+    status: ToolSessionStepStatus;
+    contextId?: string | null;
+    dependsOnStepIndex?: number | null;
+    createdAt?: number;
+}
+export interface ToolSessionRecord {
+    sessionId: string;
+    chatJid: string;
+    originalMessageId: string;
+    correlationId: string;
+    status: ToolSessionStatus;
+    stepCount: number;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface ToolSessionStepRecord {
+    sessionId: string;
+    stepIndex: number;
+    toolName: string;
+    status: ToolSessionStepStatus;
+    contextId: string | null;
+    dependsOnStepIndex: number | null;
+    createdAt: number;
+    updatedAt: number;
+}
+export declare class ToolSessionStore {
+    private db;
+    private initialized;
+    constructor();
+    private init;
+    create(input: CreateToolSessionInput): ToolSessionRecord;
+    get(sessionId: string): ToolSessionRecord | null;
+    addStep(input: AddToolSessionStepInput): ToolSessionStepRecord;
+    listSteps(sessionId: string): ToolSessionStepRecord[];
+    markStatus(sessionId: string, status: ToolSessionStatus): boolean;
+}
+//# sourceMappingURL=tool-session-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tool-session-store.d.ts","sourceRoot":"","sources":["../../src/agent-tools/tool-session-store.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAChF,MAAM,MAAM,qBAAqB,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE1G,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AA4DD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,EAAE,CAAiC;IAC3C,OAAO,CAAC,WAAW,CAAS;;IAM5B,OAAO,CAAC,IAAI;IA+BZ,MAAM,CAAC,KAAK,EAAE,sBAAsB,GAAG,iBAAiB;IAiBxD,GAAG,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB,GAAG,IAAI;IAKhD,OAAO,CAAC,KAAK,EAAE,uBAAuB,GAAG,qBAAqB;IAmB9D,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,qBAAqB,EAAE;IAKrD,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,GAAG,OAAO;CAIlE"}

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

@@ -0,0 +1,104 @@
+import { randomUUID } from 'node:crypto';
+import { DatabaseManager } from '../database/index.js';
+function id() {
+    return `tool_session_${randomUUID().replace(/-/g, '').slice(0, 12)}`;
+}
+function clean(value, label, maxLength) {
+    const cleaned = value.replace(/\s+/g, ' ').trim();
+    if (!cleaned)
+        throw new Error(`Tool session requires ${label}.`);
+    return cleaned.slice(0, maxLength);
+}
+function mapSession(row) {
+    return {
+        sessionId: row.session_id,
+        chatJid: row.chat_jid,
+        originalMessageId: row.original_message_id,
+        correlationId: row.correlation_id,
+        status: row.status,
+        stepCount: row.step_count,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+function mapStep(row) {
+    return {
+        sessionId: row.session_id,
+        stepIndex: row.step_index,
+        toolName: row.tool_name,
+        status: row.status,
+        contextId: row.context_id,
+        dependsOnStepIndex: row.depends_on_step_index,
+        createdAt: row.created_at,
+        updatedAt: row.updated_at,
+    };
+}
+export class ToolSessionStore {
+    db = DatabaseManager.getInstance();
+    initialized = false;
+    constructor() {
+        this.init();
+    }
+    init() {
+        if (this.initialized)
+            return;
+        this.db.getDb().exec(`
+      CREATE TABLE IF NOT EXISTS tool_sessions (
+        session_id TEXT PRIMARY KEY NOT NULL,
+        chat_jid TEXT NOT NULL,
+        original_message_id TEXT NOT NULL,
+        correlation_id TEXT NOT NULL,
+        status TEXT NOT NULL,
+        step_count INTEGER NOT NULL DEFAULT 0,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL
+      );
+
+      CREATE TABLE IF NOT EXISTS tool_session_steps (
+        session_id TEXT NOT NULL,
+        step_index INTEGER NOT NULL,
+        tool_name TEXT NOT NULL,
+        status TEXT NOT NULL,
+        context_id TEXT,
+        depends_on_step_index INTEGER,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL,
+        PRIMARY KEY (session_id, step_index)
+      );
+
+      CREATE INDEX IF NOT EXISTS idx_tool_sessions_chat ON tool_sessions(chat_jid, created_at);
+    `);
+        this.initialized = true;
+    }
+    create(input) {
+        const now = input.createdAt || Date.now();
+        const sessionId = id();
+        this.db.getDb().prepare(`
+      INSERT INTO tool_sessions (session_id, chat_jid, original_message_id, correlation_id, status, step_count, created_at, updated_at)
+      VALUES (?, ?, ?, ?, 'active', 0, ?, ?)
+    `).run(sessionId, clean(input.chatJid, 'chat JID', 300), clean(input.originalMessageId, 'original message id', 300), clean(input.correlationId, 'correlation id', 120), now, now);
+        return this.get(sessionId);
+    }
+    get(sessionId) {
+        const row = this.db.getDb().prepare(`SELECT * FROM tool_sessions WHERE session_id = ?`).get(clean(sessionId, 'session id', 120));
+        return row ? mapSession(row) : null;
+    }
+    addStep(input) {
+        const now = input.createdAt || Date.now();
+        this.db.getDb().prepare(`
+      INSERT INTO tool_session_steps (session_id, step_index, tool_name, status, context_id, depends_on_step_index, created_at, updated_at)
+      VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(clean(input.sessionId, 'session id', 120), Math.max(1, Math.round(input.stepIndex)), clean(input.toolName, 'tool name', 120), input.status, input.contextId || null, input.dependsOnStepIndex || null, now, now);
+        this.db.getDb().prepare(`UPDATE tool_sessions SET step_count = step_count + 1, updated_at = ? WHERE session_id = ?`).run(now, input.sessionId);
+        return this.listSteps(input.sessionId).find((step) => step.stepIndex === input.stepIndex);
+    }
+    listSteps(sessionId) {
+        const rows = this.db.getDb().prepare(`SELECT * FROM tool_session_steps WHERE session_id = ? ORDER BY step_index ASC`).all(clean(sessionId, 'session id', 120));
+        return rows.map(mapStep);
+    }
+    markStatus(sessionId, status) {
+        const result = this.db.getDb().prepare(`UPDATE tool_sessions SET status = ?, updated_at = ? WHERE session_id = ?`).run(status, Date.now(), clean(sessionId, 'session id', 120));
+        return result.changes > 0;
+    }
+}
+//# sourceMappingURL=tool-session-store.js.map

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

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

package/dist/agent-tools/types.d.ts

@@ -0,0 +1,97 @@
+import type { ResolvedCatalogTool } from '../tools/tool-catalog-config.js';
+export type AgentToolActorRole = 'customer' | 'owner' | 'group';
+export interface AgentToolRuntimeContext {
+    actorRole: AgentToolActorRole;
+    chatJid: string;
+    senderJid?: string;
+    isGroup?: boolean;
+    isOwnerSelfChat?: boolean;
+    correlationId?: string;
+}
+export interface ToolContextSummary {
+    contextId: string;
+    toolName: string;
+    summary: string;
+    resultPreview?: string;
+    toolArgs?: Record<string, unknown>;
+    status?: 'active' | 'failed' | 'expired';
+    entities?: string[];
+    sourceUrls?: string[];
+    createdAt: number;
+    expiresAt?: number;
+}
+export type ToolFollowupKind = 'answer_from_context' | 'call_same_tool' | 'call_new_tool' | 'clarify';
+export interface ToolFollowupHint {
+    possibleToolFollowup: boolean;
+    contextId?: string;
+    contextIds?: string[];
+    kind?: ToolFollowupKind;
+    reason?: string;
+}
+export interface ToolCandidateDetection {
+    shouldPlanWithClaude: boolean;
+    candidateToolNames: string[];
+    reason: string;
+    confidence: number;
+    followupHint?: ToolFollowupHint;
+}
+export type ClaudePlannerDecisionType = 'no_tool' | 'ask_clarifying_question' | 'deny' | 'tool_use';
+export interface ClaudePlannerToolCall {
+    toolName: string;
+    arguments: Record<string, unknown>;
+    reason: string;
+}
+export type ClaudeToolPlannerDecision = {
+    decision: 'no_tool';
+    reason: string;
+    confidence: number;
+} | {
+    decision: 'ask_clarifying_question';
+    reply: string;
+    reason: string;
+    confidence: number;
+} | {
+    decision: 'deny';
+    reply: string;
+    reason: string;
+    confidence: number;
+} | {
+    decision: 'tool_use';
+    toolCalls: ClaudePlannerToolCall[];
+    reason: string;
+    confidence: number;
+    requiresAsync: boolean;
+    requiresOwnerApproval: boolean;
+};
+export interface ValidatedToolCallPlan {
+    tool: ResolvedCatalogTool;
+    toolName: string;
+    arguments: Record<string, unknown>;
+    requiresAsync: boolean;
+    requiresOwnerApproval: boolean;
+    reason: string;
+}
+export interface ToolPlanRejection {
+    toolName?: string;
+    reason: string;
+    code: 'TOOL_UNKNOWN' | 'TOOL_NOT_CANDIDATE' | 'TOOL_NOT_ALLOWED_FOR_ACTOR' | 'TOOL_SCHEMA_INVALID' | 'TOOL_EXTRA_ARGUMENT' | 'TOOL_DISABLED' | 'TOOL_REQUIRES_APPROVAL' | 'TOOL_PLAN_EMPTY' | 'TOOL_PLAN_UNSUPPORTED';
+}
+export interface ToolPlanValidationResult {
+    ok: boolean;
+    acceptedCalls: ValidatedToolCallPlan[];
+    rejectedCalls: ToolPlanRejection[];
+    requiresOwnerApproval: boolean;
+    requiresAsync: boolean;
+    safeReplyIfRejected?: string;
+}
+export interface AgentToolLogPayload {
+    event: string;
+    correlationId?: string;
+    actorRole?: AgentToolActorRole;
+    toolName?: string;
+    candidateCount?: number;
+    reason?: string;
+    code?: string;
+    latencyMs?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/agent-tools/types.d.ts.map

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

package/dist/agent-tools/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/agent-tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/agent-tools/types.ts"],"names":[],"mappings":""}

package/dist/ai/execution-controller.d.ts

@@ -0,0 +1,62 @@
+/**
+ * AI Execution Controller
+ *
+ * Manages AI generation lifecycle with AbortController per chat.
+ * Cancels in-flight generation when owner intervenes.
+ * Prevents double responses and race conditions.
+ *
+ * Based on research: AbortController is the standard pattern for
+ * canceling LLM streams. Must be double-checked inside stream loops
+ * as some SDKs may not propagate abort correctly.
+ */
+import { ChatMode, ChatStateStore } from '../chat-state/store.js';
+export interface ActiveGeneration {
+    chatId: string;
+    controller: AbortController;
+    startedAt: number;
+    mode: ChatMode;
+}
+export declare class AIExecutionController {
+    private activeGenerations;
+    private stateStore;
+    constructor(stateStore: ChatStateStore);
+    /**
+     * Start tracking an AI generation for a chat.
+     * Creates an AbortController that can cancel in-flight requests.
+     */
+    startGeneration(chatId: string): AbortController;
+    /**
+     * Cancel an active generation for a chat.
+     * Returns true if a generation was cancelled.
+     */
+    cancelGeneration(chatId: string): boolean;
+    /**
+     * Check if a generation is active for a chat.
+     */
+    isGenerating(chatId: string): boolean;
+    /**
+     * Get the AbortSignal for a chat's active generation.
+     * Returns undefined if no generation is active.
+     */
+    getSignal(chatId: string): AbortSignal | undefined;
+    /**
+     * Handle owner intervention — cancel generation and transition mode.
+     */
+    handleOwnerIntervention(chatId: string): {
+        cancelled: boolean;
+        newMode: ChatMode;
+    };
+    /**
+     * End a generation normally (completion, not cancellation).
+     */
+    endGeneration(chatId: string): void;
+    /**
+     * Get count of active generations.
+     */
+    getActiveCount(): number;
+    /**
+     * Cancel ALL active generations (e.g., on shutdown).
+     */
+    cancelAll(): number;
+}
+//# sourceMappingURL=execution-controller.d.ts.map

package/dist/ai/execution-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-controller.d.ts","sourceRoot":"","sources":["../../src/ai/execution-controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAIlE,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,eAAe,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;CAChB;AAID,qBAAa,qBAAqB;IAChC,OAAO,CAAC,iBAAiB,CAA4C;IACrE,OAAO,CAAC,UAAU,CAAiB;gBAEvB,UAAU,EAAE,cAAc;IAItC;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;IAiBhD;;;OAGG;IACH,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IASzC;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAWrC;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IASlD;;OAEG;IACH,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG;QACvC,SAAS,EAAE,OAAO,CAAC;QACnB,OAAO,EAAE,QAAQ,CAAC;KACnB;IAWD;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAInC;;OAEG;IACH,cAAc,IAAI,MAAM;IAUxB;;OAEG;IACH,SAAS,IAAI,MAAM;CAOpB"}

package/dist/ai/execution-controller.js

@@ -0,0 +1,117 @@
+/**
+ * AI Execution Controller
+ *
+ * Manages AI generation lifecycle with AbortController per chat.
+ * Cancels in-flight generation when owner intervenes.
+ * Prevents double responses and race conditions.
+ *
+ * Based on research: AbortController is the standard pattern for
+ * canceling LLM streams. Must be double-checked inside stream loops
+ * as some SDKs may not propagate abort correctly.
+ */
+import { ChatMode } from '../chat-state/store.js';
+// ─── AI Execution Controller ─────────────────────────────────────────────────
+export class AIExecutionController {
+    activeGenerations = new Map();
+    stateStore;
+    constructor(stateStore) {
+        this.stateStore = stateStore;
+    }
+    /**
+     * Start tracking an AI generation for a chat.
+     * Creates an AbortController that can cancel in-flight requests.
+     */
+    startGeneration(chatId) {
+        // Cancel any existing generation for this chat
+        this.cancelGeneration(chatId);
+        const controller = new AbortController();
+        const state = this.stateStore.get(chatId);
+        this.activeGenerations.set(chatId, {
+            chatId,
+            controller,
+            startedAt: Date.now(),
+            mode: state.mode,
+        });
+        return controller;
+    }
+    /**
+     * Cancel an active generation for a chat.
+     * Returns true if a generation was cancelled.
+     */
+    cancelGeneration(chatId) {
+        const gen = this.activeGenerations.get(chatId);
+        if (!gen)
+            return false;
+        gen.controller.abort();
+        this.activeGenerations.delete(chatId);
+        return true;
+    }
+    /**
+     * Check if a generation is active for a chat.
+     */
+    isGenerating(chatId) {
+        const gen = this.activeGenerations.get(chatId);
+        if (!gen)
+            return false;
+        // Check if controller was aborted externally
+        if (gen.controller.signal.aborted) {
+            this.activeGenerations.delete(chatId);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Get the AbortSignal for a chat's active generation.
+     * Returns undefined if no generation is active.
+     */
+    getSignal(chatId) {
+        const gen = this.activeGenerations.get(chatId);
+        if (!gen || gen.controller.signal.aborted) {
+            this.activeGenerations.delete(chatId);
+            return undefined;
+        }
+        return gen.controller.signal;
+    }
+    /**
+     * Handle owner intervention — cancel generation and transition mode.
+     */
+    handleOwnerIntervention(chatId) {
+        const cancelled = this.cancelGeneration(chatId);
+        // Auto-takeover: transition to HUMAN_ACTIVE
+        const result = this.stateStore.setMode(chatId, ChatMode.HUMAN_ACTIVE);
+        return {
+            cancelled,
+            newMode: result.state.mode,
+        };
+    }
+    /**
+     * End a generation normally (completion, not cancellation).
+     */
+    endGeneration(chatId) {
+        this.activeGenerations.delete(chatId);
+    }
+    /**
+     * Get count of active generations.
+     */
+    getActiveCount() {
+        // Clean up any aborted controllers
+        for (const [chatId, gen] of this.activeGenerations) {
+            if (gen.controller.signal.aborted) {
+                this.activeGenerations.delete(chatId);
+            }
+        }
+        return this.activeGenerations.size;
+    }
+    /**
+     * Cancel ALL active generations (e.g., on shutdown).
+     */
+    cancelAll() {
+        let count = 0;
+        for (const [chatId] of this.activeGenerations) {
+            if (this.cancelGeneration(chatId))
+                count++;
+        }
+        return count;
+    }
+}
+//# sourceMappingURL=execution-controller.js.map