nduka 1.0.0

package/dist/agent-tools/agent-tool-router.js

@@ -0,0 +1,196 @@
+import { listEnabledCatalogTools, loadToolCatalogConfig } from '../tools/tool-catalog-config.js';
+import { AsyncToolBridge } from './async-tool-bridge.js';
+import { ClaudeToolPlanner } from './claude-tool-planner.js';
+import { ToolCandidateDetector } from './tool-candidate-detector.js';
+import { ToolPlanValidator } from './tool-plan-validator.js';
+import { logAgentToolEvent } from './logging.js';
+import { loadAgentToolSettings } from './settings.js';
+import { shouldAnswerFromRecentToolContext } from './context-routing-policy.js';
+function configuredResponse(responses, key) {
+    const selected = responses?.[key]?.find((item) => item.trim().length > 0);
+    if (!selected)
+        throw new Error(`Missing configured agent-tool router response: ${key}`);
+    return selected;
+}
+function actorCanSeeTool(tool, actorRole) {
+    if (!tool.enabled || !tool.providerConfig.enabled)
+        return false;
+    if (actorRole === 'owner')
+        return true;
+    return tool.public && !tool.ownerOnly && tool.customerCallable !== false;
+}
+function visibleToolsForActor(tools, actorRole) {
+    return tools.filter((tool) => actorCanSeeTool(tool, actorRole));
+}
+function orderedCandidateTools(visibleTools, detectedNames, maxCandidates) {
+    const byName = new Map(visibleTools.map((tool) => [tool.name, tool]));
+    const ordered = [];
+    const used = new Set();
+    for (const name of detectedNames) {
+        const tool = byName.get(name);
+        if (!tool || used.has(tool.name))
+            continue;
+        ordered.push(tool);
+        used.add(tool.name);
+    }
+    for (const tool of visibleTools) {
+        if (used.has(tool.name))
+            continue;
+        ordered.push(tool);
+        used.add(tool.name);
+    }
+    return ordered.slice(0, Math.max(1, Math.min(maxCandidates, 20)));
+}
+function activeContexts(contexts) {
+    const now = Date.now();
+    return contexts.filter((context) => !context.expiresAt || context.expiresAt > now);
+}
+function compact(value, max = 500) {
+    const normalized = value.replace(/\s+/g, ' ').trim();
+    return normalized.length <= max ? normalized : `${normalized.slice(0, max - 1)}…`;
+}
+function textUrl(text) {
+    const match = /https?:\/\/[^\s)\]]+/i.exec(text);
+    return match?.[0] || null;
+}
+function fieldText(name, field) {
+    return `${name} ${field.description || ''}`.toLowerCase();
+}
+function schemaLooksLikeUrlField(name, field) {
+    return /\b(url|uri|link|href|website|webpage|web page)\b/i.test(fieldText(name, field));
+}
+function fallbackLookupText(text, detection, contexts) {
+    const relatedIds = new Set(detection.followupHint?.contextIds || []);
+    const related = activeContexts(contexts).filter((context) => relatedIds.size === 0 || relatedIds.has(context.contextId));
+    const parts = [text];
+    for (const context of related.slice(0, 2)) {
+        const priorQuery = typeof context.toolArgs?.query === 'string' ? context.toolArgs.query : '';
+        if (priorQuery)
+            parts.push(`Previous lookup: ${priorQuery}`);
+        if (context.summary)
+            parts.push(`Context: ${context.summary}`);
+    }
+    return compact(parts.filter(Boolean).join('\n'), 700);
+}
+function fallbackArgumentsForTool(tool, text, detection, contexts) {
+    const args = {};
+    for (const [name, field] of Object.entries(tool.inputSchema)) {
+        if (!field.required)
+            continue;
+        if (field.type !== 'string')
+            return null;
+        if (schemaLooksLikeUrlField(name, field)) {
+            const url = textUrl(text);
+            if (!url)
+                return null;
+            args[name] = url;
+            continue;
+        }
+        args[name] = fallbackLookupText(text, detection, contexts);
+    }
+    return Object.keys(args).length > 0 ? args : null;
+}
+function deterministicPlannerFallback(text, candidates, detection, contexts) {
+    if (!detection.shouldPlanWithClaude || candidates.length === 0)
+        return null;
+    for (const tool of candidates) {
+        const args = fallbackArgumentsForTool(tool, text, detection, contexts);
+        if (!args)
+            continue;
+        return {
+            decision: 'tool_use',
+            toolCalls: [{ toolName: tool.name, arguments: args, reason: 'deterministic fallback after planner failure' }],
+            reason: 'planner_failed_after_configured_tool_detected',
+            confidence: Math.max(0.6, detection.confidence),
+            requiresAsync: tool.asyncEligible,
+            requiresOwnerApproval: tool.requiresApproval === true,
+        };
+    }
+    return null;
+}
+export class AgentToolRouter {
+    detector = new ToolCandidateDetector();
+    planner = new ClaudeToolPlanner();
+    validator = new ToolPlanValidator();
+    bridge = new AsyncToolBridge();
+    async tryRoute(input) {
+        const text = input.text.trim();
+        if (!text)
+            return { handled: false, reason: 'empty_message' };
+        const catalog = input.catalog || loadToolCatalogConfig();
+        const tools = listEnabledCatalogTools(catalog);
+        const visibleTools = visibleToolsForActor(tools, input.context.actorRole);
+        if (visibleTools.length === 0)
+            return { handled: false, reason: 'no_visible_tools_for_actor' };
+        const settings = loadAgentToolSettings();
+        const detection = this.detector.detect({
+            text,
+            actorRole: input.context.actorRole,
+            tools,
+            recentToolContexts: input.recentToolContexts || [],
+            settings: settings.candidateDetector,
+        });
+        if (shouldAnswerFromRecentToolContext(text, input.recentToolContexts || [], settings.candidateDetector)) {
+            logAgentToolEvent({ event: 'AgentToolRouteSkipped', correlationId: input.context.correlationId, actorRole: input.context.actorRole, reason: 'recent_tool_context_sufficient' });
+            return { handled: false, reason: 'recent_tool_context_sufficient', detection };
+        }
+        const candidates = orderedCandidateTools(visibleTools, detection.candidateToolNames, settings.candidateDetector.maxCandidates);
+        if (candidates.length === 0)
+            return { handled: false, reason: 'no_candidate_tools_after_actor_filter', detection };
+        const candidateNames = candidates.map((tool) => tool.name);
+        let plannerDecision;
+        try {
+            plannerDecision = await this.planner.plan({
+                text,
+                context: input.context,
+                candidateTools: candidates,
+                recentToolContexts: input.recentToolContexts || [],
+                recentMessages: input.recentMessages || [],
+                model: input.model,
+            });
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            const fallback = deterministicPlannerFallback(text, candidates, detection, input.recentToolContexts || []);
+            if (!fallback)
+                throw err;
+            logAgentToolEvent({ event: 'AgentToolPlannerFallback', correlationId: input.context.correlationId, actorRole: input.context.actorRole, reason: err.message, code: 'DETECTED_TOOL_LOOKUP_FALLBACK' });
+            plannerDecision = fallback;
+        }
+        if (plannerDecision.decision === 'no_tool')
+            return { handled: false, reason: plannerDecision.reason, detection };
+        if (plannerDecision.decision === 'ask_clarifying_question')
+            return { handled: true, mode: 'clarify', reply: plannerDecision.reply, plannerDecision };
+        if (plannerDecision.decision === 'deny')
+            return { handled: true, mode: 'deny', reply: plannerDecision.reply, plannerDecision };
+        const validation = this.validator.validate({
+            decision: plannerDecision,
+            candidateToolNames: candidateNames,
+            tools,
+            actorRole: input.context.actorRole,
+            correlationId: input.context.correlationId,
+        });
+        if (!validation.ok) {
+            const reply = configuredResponse(catalog.responses, 'blocked');
+            return { handled: true, mode: 'validation_failed', reply, validation };
+        }
+        const bridge = this.bridge.enqueue({
+            plans: validation.acceptedCalls,
+            context: input.context,
+            originalMessageId: input.originalMessageId,
+            originalText: text,
+            store: input.store,
+            responses: catalog.responses || {},
+        });
+        if (bridge.handled && bridge.mode === 'queued') {
+            logAgentToolEvent({ event: 'AgentToolRouterQueued', correlationId: input.context.correlationId, actorRole: input.context.actorRole, candidateCount: bridge.jobIds.length, reason: 'async_job_persisted' });
+            return { handled: true, mode: 'queued', reply: bridge.reply, bridge };
+        }
+        if (bridge.handled && bridge.mode === 'failed_to_enqueue') {
+            const reply = configuredResponse(catalog.responses, 'blocked');
+            return { handled: true, mode: 'validation_failed', reply, validation };
+        }
+        return { handled: false, reason: 'bridge_not_handled', detection };
+    }
+}
+//# sourceMappingURL=agent-tool-router.js.map

package/dist/agent-tools/agent-tool-router.js.map

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

package/dist/agent-tools/async-tool-bridge.d.ts

@@ -0,0 +1,31 @@
+import { AsyncJobStore } from '../async-jobs/job-store.js';
+import type { CatalogResponsePolicy } from '../tools/tool-catalog-config.js';
+import type { AgentToolRuntimeContext, ValidatedToolCallPlan } from './types.js';
+export interface AsyncToolBridgeInput {
+    plans: ValidatedToolCallPlan[];
+    context: AgentToolRuntimeContext;
+    originalMessageId: string;
+    originalText: string;
+    store?: AsyncJobStore;
+    responses: CatalogResponsePolicy;
+    now?: () => number;
+}
+export type AsyncToolBridgeResult = {
+    handled: true;
+    mode: 'queued';
+    reply: string;
+    jobIds: string[];
+    created: boolean;
+} | {
+    handled: true;
+    mode: 'failed_to_enqueue';
+    reply: string;
+    errors: string[];
+} | {
+    handled: false;
+    reason: string;
+};
+export declare class AsyncToolBridge {
+    enqueue(input: AsyncToolBridgeInput): AsyncToolBridgeResult;
+}
+//# sourceMappingURL=async-tool-bridge.d.ts.map

package/dist/agent-tools/async-tool-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-tool-bridge.d.ts","sourceRoot":"","sources":["../../src/agent-tools/async-tool-bridge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,KAAK,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGjF,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAC/B,OAAO,EAAE,uBAAuB,CAAC;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,qBAAqB,CAAC;IACjC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,qBAAqB,GAC7B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACpF;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,mBAAmB,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,GAC7E;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAgBvC,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB;CAkD5D"}

package/dist/agent-tools/async-tool-bridge.js

@@ -0,0 +1,65 @@
+import { AsyncJobStore } from '../async-jobs/job-store.js';
+import { logAgentToolEvent } from './logging.js';
+function chooseConfiguredResponse(values, key) {
+    const selected = values?.find((value) => value.trim().length > 0);
+    if (!selected)
+        throw new Error(`Missing configured agent-tool response: ${key}`);
+    return selected;
+}
+function pendingReply(responses) {
+    return chooseConfiguredResponse(responses.checking, 'checking');
+}
+function failureReply(responses) {
+    return chooseConfiguredResponse(responses.blocked, 'blocked');
+}
+export class AsyncToolBridge {
+    enqueue(input) {
+        if (input.plans.length === 0)
+            return { handled: false, reason: 'no_validated_tool_plans' };
+        const store = input.store || new AsyncJobStore();
+        const jobIds = [];
+        const errors = [];
+        let createdAny = false;
+        for (const plan of input.plans) {
+            try {
+                const result = store.enqueue({
+                    chatJid: input.context.chatJid,
+                    senderJid: input.context.senderJid || input.context.chatJid,
+                    originalMessageId: input.originalMessageId,
+                    originalText: input.originalText,
+                    toolName: plan.toolName,
+                    toolArgs: plan.arguments,
+                    maxAttempts: plan.tool.timeouts?.maxRetries ? plan.tool.timeouts.maxRetries + 1 : undefined,
+                    scheduledFor: input.now?.() || Date.now(),
+                    correlationId: input.context.correlationId,
+                });
+                jobIds.push(result.item.jobId);
+                createdAny = createdAny || result.created;
+                logAgentToolEvent({
+                    event: result.created ? 'AgentToolJobEnqueued' : 'AgentToolJobDedupe',
+                    correlationId: result.item.correlationId,
+                    actorRole: input.context.actorRole,
+                    toolName: plan.toolName,
+                    reason: result.created ? 'queued' : 'existing_dedupe_key',
+                });
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : 'Unknown async enqueue error.';
+                errors.push(`${plan.toolName}: ${message}`);
+                logAgentToolEvent({
+                    event: 'AgentToolJobEnqueueFailed',
+                    correlationId: input.context.correlationId,
+                    actorRole: input.context.actorRole,
+                    toolName: plan.toolName,
+                    code: 'ASYNC_ENQUEUE_FAILED',
+                    reason: message,
+                });
+            }
+        }
+        if (jobIds.length === 0) {
+            return { handled: true, mode: 'failed_to_enqueue', reply: failureReply(input.responses), errors };
+        }
+        return { handled: true, mode: 'queued', reply: pendingReply(input.responses), jobIds, created: createdAny };
+    }
+}
+//# sourceMappingURL=async-tool-bridge.js.map

package/dist/agent-tools/async-tool-bridge.js.map

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

package/dist/agent-tools/async-tool-processor.d.ts

@@ -0,0 +1,19 @@
+import type { AsyncJobProcessorResult } from '../async-jobs/job-runner.js';
+import type { AsyncJobRecord } from '../async-jobs/job-types.js';
+import { ToolExecutionRuntime } from '../tool-runtime/engine.js';
+import type { ToolActorRole } from '../tool-runtime/policy.js';
+export interface AsyncToolProcessorOptions {
+    runtime?: ToolExecutionRuntime;
+    tenantId?: string;
+    actorRole?: ToolActorRole;
+    approved?: boolean;
+}
+export declare class AsyncToolProcessor {
+    private runtime;
+    private tenantId;
+    private actorRole;
+    private approved;
+    constructor(options?: AsyncToolProcessorOptions);
+    process(job: AsyncJobRecord): Promise<AsyncJobProcessorResult>;
+}
+//# sourceMappingURL=async-tool-processor.d.ts.map

package/dist/agent-tools/async-tool-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-tool-processor.d.ts","sourceRoot":"","sources":["../../src/agent-tools/async-tool-processor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAiB,MAAM,2BAA2B,CAAC;AAChF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG/D,MAAM,WAAW,yBAAyB;IACxC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAYD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAgB;IACjC,OAAO,CAAC,QAAQ,CAAU;gBAEd,OAAO,GAAE,yBAA8B;IAO7C,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,uBAAuB,CAAC;CAwDrE"}

package/dist/agent-tools/async-tool-processor.js

@@ -0,0 +1,81 @@
+import { randomUUID } from 'node:crypto';
+import { ToolExecutionRuntime } from '../tool-runtime/engine.js';
+import { logAgentToolEvent } from './logging.js';
+function errorResult(errorCode, errorMessage, retryable = false) {
+    return { ok: false, errorCode, errorMessage, retryable };
+}
+function previewFromData(data) {
+    if (typeof data === 'string')
+        return data.slice(0, 1000);
+    if (data && typeof data === 'object')
+        return JSON.stringify(data).slice(0, 1000);
+    return String(data ?? '').slice(0, 1000);
+}
+export class AsyncToolProcessor {
+    runtime;
+    tenantId;
+    actorRole;
+    approved;
+    constructor(options = {}) {
+        this.runtime = options.runtime || new ToolExecutionRuntime(false);
+        this.tenantId = options.tenantId || 'default';
+        this.actorRole = options.actorRole || 'customer';
+        this.approved = options.approved === true;
+    }
+    async process(job) {
+        const executionId = `exec_${randomUUID().replace(/-/g, '').slice(0, 12)}`;
+        try {
+            if (!job.toolName)
+                return errorResult('TOOL_UNKNOWN', 'Async job has no tool name.', false);
+            if (!job.toolArgs || typeof job.toolArgs !== 'object' || Array.isArray(job.toolArgs)) {
+                return errorResult('TOOL_SCHEMA_INVALID', 'Async job tool arguments are invalid.', false);
+            }
+            const call = {
+                id: job.jobId,
+                toolName: job.toolName,
+                arguments: job.toolArgs,
+                tenantId: this.tenantId,
+                userId: job.senderJid,
+                chatId: job.chatJid,
+                executionId,
+                timestamp: Date.now(),
+                actorRole: this.actorRole,
+                approved: this.approved,
+            };
+            const result = await this.runtime.execute(call);
+            if (!result.success) {
+                const policyDenied = result.policyDecision === 'denied' || result.policyDecision === 'confirmation_required';
+                const retryable = !policyDenied && /timeout|temporar|rate|network|fetch/i.test(result.error || '');
+                logAgentToolEvent({
+                    event: 'AgentToolExecutionFailed',
+                    correlationId: job.correlationId,
+                    toolName: job.toolName,
+                    code: policyDenied ? 'TOOL_POLICY_DENIED' : 'TOOL_PROVIDER_ERROR',
+                    reason: result.error || 'Tool execution failed.',
+                    latencyMs: result.latencyMs,
+                });
+                return errorResult(policyDenied ? 'TOOL_POLICY_DENIED' : 'TOOL_PROVIDER_ERROR', result.error || 'Tool execution failed.', retryable);
+            }
+            const preview = previewFromData(result.data);
+            logAgentToolEvent({
+                event: 'AgentToolExecutionSucceeded',
+                correlationId: job.correlationId,
+                toolName: job.toolName,
+                latencyMs: result.latencyMs,
+            });
+            return { ok: true, resultPreview: preview };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unexpected tool processor error.';
+            logAgentToolEvent({
+                event: 'AgentToolExecutionFailed',
+                correlationId: job.correlationId,
+                toolName: job.toolName,
+                code: 'PROCESSOR_ERROR',
+                reason: message,
+            });
+            return errorResult('PROCESSOR_ERROR', message, true);
+        }
+    }
+}
+//# sourceMappingURL=async-tool-processor.js.map

package/dist/agent-tools/async-tool-processor.js.map

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

package/dist/agent-tools/claude-tool-adapter.d.ts

@@ -0,0 +1,20 @@
+import type { ResolvedCatalogTool } from '../tools/tool-catalog-config.js';
+import type { AgentToolActorRole } from './types.js';
+export interface ClaudeJsonSchemaProperty {
+    type: 'string' | 'number' | 'boolean';
+    description?: string;
+}
+export interface ClaudeToolDefinition {
+    name: string;
+    description: string;
+    input_schema: {
+        type: 'object';
+        properties: Record<string, ClaudeJsonSchemaProperty>;
+        required: string[];
+        additionalProperties: false;
+    };
+    strict: true;
+}
+export declare function toClaudeToolDefinition(tool: ResolvedCatalogTool, actorRole: AgentToolActorRole): ClaudeToolDefinition | null;
+export declare function toClaudeToolDefinitions(tools: ResolvedCatalogTool[], actorRole: AgentToolActorRole): ClaudeToolDefinition[];
+//# sourceMappingURL=claude-tool-adapter.d.ts.map

package/dist/agent-tools/claude-tool-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-tool-adapter.d.ts","sourceRoot":"","sources":["../../src/agent-tools/claude-tool-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAqB,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAC9F,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE;QACZ,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAC;QACrD,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,oBAAoB,EAAE,KAAK,CAAC;KAC7B,CAAC;IACF,MAAM,EAAE,IAAI,CAAC;CACd;AA2BD,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,mBAAmB,EAAE,SAAS,EAAE,kBAAkB,GAAG,oBAAoB,GAAG,IAAI,CA6B5H;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,mBAAmB,EAAE,EAAE,SAAS,EAAE,kBAAkB,GAAG,oBAAoB,EAAE,CAK3H"}

package/dist/agent-tools/claude-tool-adapter.js

@@ -0,0 +1,64 @@
+function actorCanSeeTool(tool, actorRole) {
+    if (!tool.enabled || !tool.providerConfig.enabled)
+        return false;
+    if (actorRole === 'owner')
+        return true;
+    return tool.public && !tool.ownerOnly && tool.customerCallable !== false;
+}
+function fieldToProperty(field) {
+    return {
+        type: field.type,
+        ...(field.description ? { description: field.description } : {}),
+    };
+}
+function operationalCaveats(tool, actorRole) {
+    const caveats = [];
+    caveats.push(`Provider operation: ${tool.provider}/${tool.operation}.`);
+    caveats.push(`Result mode: ${tool.operationConfig.resultMode}.`);
+    if (tool.asyncEligible)
+        caveats.push('This tool may be executed asynchronously by the application; do not promise completion unless the application confirms the job was persisted.');
+    if (tool.requiresApproval || tool.ownerOnly)
+        caveats.push('This tool may require owner approval; the model must not override approval or permission checks.');
+    if (actorRole !== 'owner')
+        caveats.push('This request is not from the owner; never expose owner-only capabilities or private implementation details.');
+    if (tool.failurePolicy?.onEmptyResult)
+        caveats.push(`Empty-result policy: ${tool.failurePolicy.onEmptyResult}.`);
+    if (tool.groundingPolicy?.requiresToolResult)
+        caveats.push('Answers using this tool must be grounded in the tool result, not model estimates.');
+    return caveats;
+}
+export function toClaudeToolDefinition(tool, actorRole) {
+    if (!actorCanSeeTool(tool, actorRole))
+        return null;
+    const properties = {};
+    const required = [];
+    for (const [name, field] of Object.entries(tool.inputSchema)) {
+        properties[name] = fieldToProperty(field);
+        if (field.required)
+            required.push(name);
+    }
+    const descriptionParts = [
+        tool.description.trim(),
+        `Use this tool only when the user's request matches the configured capability for ${tool.name}.`,
+        `Do not use this tool for ordinary memory, writing, translation, casual conversation, or questions already answerable from the current chat context.`,
+        ...operationalCaveats(tool, actorRole),
+    ];
+    return {
+        name: tool.name,
+        description: descriptionParts.join(' '),
+        input_schema: {
+            type: 'object',
+            properties,
+            required,
+            additionalProperties: false,
+        },
+        strict: true,
+    };
+}
+export function toClaudeToolDefinitions(tools, actorRole) {
+    return tools
+        .map((tool) => toClaudeToolDefinition(tool, actorRole))
+        .filter((tool) => tool !== null)
+        .sort((a, b) => a.name.localeCompare(b.name));
+}
+//# sourceMappingURL=claude-tool-adapter.js.map

package/dist/agent-tools/claude-tool-adapter.js.map

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

package/dist/agent-tools/claude-tool-planner.d.ts

@@ -0,0 +1,35 @@
+import type { LLMResponseFormat, Message } from '../llm/types.js';
+import { PromptRegistry } from '../prompts/registry.js';
+import type { AgentToolRuntimeContext, ClaudeToolPlannerDecision, ToolContextSummary } from './types.js';
+import type { ResolvedCatalogTool } from '../tools/tool-catalog-config.js';
+export interface PlannerModelResponse {
+    text: string;
+}
+export interface PlannerModelOptions {
+    suppressThinking?: boolean;
+    task?: string;
+    systemPromptName?: string | null;
+    sanitizeResponse?: boolean;
+    weakRetry?: boolean;
+    maxTokens?: number;
+    temperature?: number;
+    timeoutMs?: number;
+    responseFormat?: LLMResponseFormat;
+}
+export interface PlannerModel {
+    generateResponse(prompt: string, conversationHistory?: Message[], options?: PlannerModelOptions): Promise<PlannerModelResponse>;
+}
+export interface ClaudeToolPlannerInput {
+    text: string;
+    context: AgentToolRuntimeContext;
+    candidateTools: ResolvedCatalogTool[];
+    recentToolContexts?: ToolContextSummary[];
+    recentMessages?: Message[];
+    model: PlannerModel;
+    promptRegistry?: PromptRegistry;
+}
+export declare function parseClaudeToolPlannerDecision(text: string): ClaudeToolPlannerDecision;
+export declare class ClaudeToolPlanner {
+    plan(input: ClaudeToolPlannerInput): Promise<ClaudeToolPlannerDecision>;
+}
+//# sourceMappingURL=claude-tool-planner.d.ts.map

package/dist/agent-tools/claude-tool-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-tool-planner.d.ts","sourceRoot":"","sources":["../../src/agent-tools/claude-tool-planner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,OAAO,KAAK,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACzG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAG3E,MAAM,WAAW,oBAAoB;IAAG,IAAI,EAAE,MAAM,CAAA;CAAE;AACtD,MAAM,WAAW,mBAAmB;IAAG,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,iBAAiB,CAAA;CAAE;AACvQ,MAAM,WAAW,YAAY;IAAG,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,mBAAmB,CAAC,EAAE,OAAO,EAAE,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAA;CAAE;AACjK,MAAM,WAAW,sBAAsB;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,uBAAuB,CAAC;IAAC,cAAc,EAAE,mBAAmB,EAAE,CAAC;IAAC,kBAAkB,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAAC,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;IAAC,KAAK,EAAE,YAAY,CAAC;IAAC,cAAc,CAAC,EAAE,cAAc,CAAA;CAAE;AAS9P,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,yBAAyB,CAetF;AASD,qBAAa,iBAAiB;IACtB,IAAI,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,yBAAyB,CAAC;CA0B9E"}