nduka 1.0.0

package/dist/async-jobs/tool-intent-planner.js

@@ -0,0 +1,241 @@
+import { ProviderRouter } from '../llm/router.js';
+import { getFreeTierRouterConfig } from '../llm/config.js';
+import { TaskModelRouter } from '../llm/task-router.js';
+import { listEnabledCatalogTools, loadToolCatalogConfig } from '../tools/tool-catalog-config.js';
+const DEFAULT_CONFIDENCE_THRESHOLD = 0.7;
+const VALID_ROUTES = new Set(['async_tool', 'normal_chat', 'clarify', 'blocked']);
+export class ToolIntentPlanner {
+    catalog;
+    completion;
+    confidenceThreshold;
+    router = new ProviderRouter(getFreeTierRouterConfig());
+    taskRouter = new TaskModelRouter();
+    constructor(options = {}) {
+        this.catalog = options.catalog || loadToolCatalogConfig();
+        this.completion = options.completion;
+        this.confidenceThreshold = options.confidenceThreshold ?? DEFAULT_CONFIDENCE_THRESHOLD;
+    }
+    async plan(input) {
+        const eligibleTools = eligibleAsyncTools(this.catalog);
+        if (eligibleTools.length === 0 || input.isGroup || input.text.trim().startsWith('/')) {
+            return { ok: false, error: 'async_tool_not_allowed_for_context' };
+        }
+        let raw = '';
+        try {
+            raw = await this.complete(buildPlannerMessages(input, eligibleTools));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'planner_failed';
+            return { ok: false, error: `planner_failed: ${message}` };
+        }
+        let parsed = parseToolIntentPlan(raw);
+        if (!parsed) {
+            const repaired = await this.repairInvalidJson(raw, input, eligibleTools);
+            parsed = parseToolIntentPlan(repaired);
+        }
+        if (!parsed)
+            return { ok: false, error: 'planner_returned_invalid_json' };
+        return validateToolIntentPlan(parsed, this.catalog, this.confidenceThreshold);
+    }
+    async complete(messages) {
+        const target = this.taskRouter.getTarget('classification');
+        if (this.completion)
+            return this.completion(messages, { provider: target.provider, model: target.model });
+        const response = await this.router.completeForProvider(target.provider, {
+            messages,
+            provider: target.provider,
+            model: target.model,
+            maxTokens: 500,
+            temperature: 0,
+            timeoutMs: 60_000,
+            toolChoice: 'none',
+            suppressThinking: true,
+        });
+        return response.content || '';
+    }
+    async repairInvalidJson(raw, input, tools) {
+        const messages = [
+            {
+                role: 'system',
+                content: [
+                    'You repair tool-routing planner output.',
+                    'Return exactly one valid JSON object and no prose.',
+                    'Valid route values: async_tool, normal_chat, clarify, blocked.',
+                    'Only choose toolName from the provided availableTools.',
+                    'Use conversationContext to resolve follow-up references, pronouns, quoted replies, and short questions.',
+                    'If the user asks a follow-up about previous public search/news results and a matching available tool exists, choose async_tool and build a self-contained query.',
+                    'If no tool is needed, choose normal_chat.',
+                ].join('\n'),
+            },
+            {
+                role: 'user',
+                content: JSON.stringify({
+                    invalidOutput: raw.slice(0, 2000),
+                    originalMessage: input.text,
+                    conversationContext: input.conversationContext,
+                    availableTools: tools.map((tool) => ({
+                        name: tool.name,
+                        description: tool.description,
+                        capabilityTags: tool.capabilityTags || [],
+                        operationKind: tool.operationConfig.kind,
+                        inputSchema: tool.inputSchema,
+                        groundingPolicy: tool.groundingPolicy,
+                        failurePolicy: tool.failurePolicy,
+                    })),
+                    requiredShape: {
+                        route: 'async_tool|normal_chat|clarify|blocked',
+                        toolName: 'string optional',
+                        args: 'object optional',
+                        confidence: 'number 0..1',
+                        reason: 'string',
+                        clarification: 'string optional',
+                    },
+                }),
+            },
+        ];
+        try {
+            return await this.complete(messages);
+        }
+        catch {
+            return '';
+        }
+    }
+}
+export function eligibleAsyncTools(catalog = loadToolCatalogConfig()) {
+    return listEnabledCatalogTools(catalog).filter((tool) => tool.public && !tool.ownerOnly && tool.asyncEligible === true);
+}
+export function validateToolIntentPlan(plan, catalog, confidenceThreshold = DEFAULT_CONFIDENCE_THRESHOLD) {
+    if (!VALID_ROUTES.has(plan.route))
+        return { ok: false, error: 'invalid_route' };
+    if (!Number.isFinite(plan.confidence))
+        return { ok: false, error: 'invalid_confidence' };
+    if (typeof plan.reason !== 'string' || plan.reason.trim().length === 0)
+        return { ok: false, error: 'missing_reason' };
+    if (plan.route !== 'async_tool')
+        return { ok: true, plan };
+    if (plan.confidence < confidenceThreshold)
+        return { ok: false, error: 'low_confidence' };
+    if (typeof plan.toolName !== 'string' || !plan.toolName.trim())
+        return { ok: false, error: 'missing_tool_name' };
+    if (!isRecord(plan.args))
+        return { ok: false, error: 'missing_args' };
+    const tool = eligibleAsyncTools(catalog).find((candidate) => candidate.name === plan.toolName);
+    if (!tool)
+        return { ok: false, error: 'tool_not_async_eligible' };
+    const schemaError = validateArgsAgainstSchema(plan.args, tool.inputSchema);
+    if (schemaError)
+        return { ok: false, error: schemaError };
+    return { ok: true, plan: { ...plan, toolName: tool.name, args: normalizeArgs(plan.args, tool.inputSchema) } };
+}
+export function parseToolIntentPlan(raw) {
+    const json = extractJsonObject(raw);
+    if (!json)
+        return null;
+    try {
+        const parsed = JSON.parse(json);
+        if (!isRecord(parsed))
+            return null;
+        const route = parsed.route;
+        if (route !== 'async_tool' && route !== 'normal_chat' && route !== 'clarify' && route !== 'blocked')
+            return null;
+        return {
+            route,
+            toolName: typeof parsed.toolName === 'string' ? parsed.toolName : undefined,
+            args: isRecord(parsed.args) ? parsed.args : undefined,
+            confidence: typeof parsed.confidence === 'number' ? parsed.confidence : Number(parsed.confidence || 0),
+            reason: typeof parsed.reason === 'string' ? parsed.reason : '',
+            clarification: typeof parsed.clarification === 'string' ? parsed.clarification : undefined,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function buildPlannerMessages(input, tools) {
+    const payload = {
+        message: input.text,
+        conversationContext: input.conversationContext,
+        chatType: input.isGroup ? 'group' : input.isOwnerSelfChat ? 'owner_self_chat' : 'customer_private_chat',
+        today: formatDate(input.now || new Date(), input.timezone || process.env.CHATBOT_TIMEZONE || process.env.TZ || 'UTC'),
+        timezone: input.timezone || process.env.CHATBOT_TIMEZONE || process.env.TZ || 'UTC',
+        availableTools: tools.map((tool) => ({
+            name: tool.name,
+            description: tool.description,
+            capabilityTags: tool.capabilityTags || [],
+            provider: tool.provider,
+            operation: tool.operation,
+            operationKind: tool.operationConfig.kind,
+            inputSchema: tool.inputSchema,
+            outputSchema: tool.outputSchema,
+            groundingPolicy: tool.groundingPolicy,
+            failurePolicy: tool.failurePolicy,
+            asyncEligible: tool.asyncEligible,
+            public: tool.public,
+            ownerOnly: tool.ownerOnly,
+            customerCallable: tool.customerCallable,
+            requiresApproval: tool.requiresApproval,
+            requiresIdentity: tool.requiresIdentity,
+        })),
+    };
+    return [
+        {
+            role: 'system',
+            content: [
+                'You are a strict tool-routing planner for a WhatsApp bot.',
+                'Choose only from availableTools. Do not invent tool names or arguments.',
+                'Return exactly one JSON object and no prose.',
+                'Use conversationContext to resolve follow-up references, pronouns, quoted replies, and short questions.',
+                'For follow-up tool calls, make the query self-contained by combining the current message with relevant conversationContext.',
+                'Use async_tool only when a configured tool is needed to answer current, live, external, factual, search, news, schedule, price, weather, or other time-sensitive public information.',
+                'Use normal_chat when no tool is needed.',
+                'Use clarify only when a required tool argument is missing and cannot be inferred from the message or conversationContext.',
+                'Use blocked only for unsafe or disallowed requests.',
+                'For async_tool, include toolName, args, confidence between 0 and 1, and a short reason.',
+            ].join('\n'),
+        },
+        { role: 'user', content: JSON.stringify(payload) },
+    ];
+}
+function validateArgsAgainstSchema(args, schema) {
+    for (const [key, field] of Object.entries(schema)) {
+        const value = args[key];
+        if (field.required && (value === undefined || value === null || value === ''))
+            return `missing_required_arg:${key}`;
+        if (value === undefined || value === null)
+            continue;
+        if (field.type === 'string' && typeof value !== 'string')
+            return `invalid_arg_type:${key}`;
+        if (field.type === 'number' && typeof value !== 'number')
+            return `invalid_arg_type:${key}`;
+        if (field.type === 'boolean' && typeof value !== 'boolean')
+            return `invalid_arg_type:${key}`;
+    }
+    return null;
+}
+function normalizeArgs(args, schema) {
+    const out = {};
+    for (const key of Object.keys(schema))
+        if (args[key] !== undefined)
+            out[key] = args[key];
+    return out;
+}
+function extractJsonObject(raw) {
+    const cleaned = raw.replace(/```(?:json)?/gi, '').replace(/```/g, '').trim();
+    const start = cleaned.indexOf('{');
+    const end = cleaned.lastIndexOf('}');
+    if (start === -1 || end === -1 || end <= start)
+        return null;
+    return cleaned.slice(start, end + 1);
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function formatDate(date, timezone) {
+    try {
+        return new Intl.DateTimeFormat('en-CA', { timeZone: timezone, year: 'numeric', month: '2-digit', day: '2-digit' }).format(date);
+    }
+    catch {
+        return new Intl.DateTimeFormat('en-CA', { timeZone: 'UTC', year: 'numeric', month: '2-digit', day: '2-digit' }).format(date);
+    }
+}
+//# sourceMappingURL=tool-intent-planner.js.map

package/dist/async-jobs/tool-intent-planner.js.map

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

package/dist/async-jobs/tool-processor.d.ts

@@ -0,0 +1,31 @@
+import type { ToolRegistry } from '../tools/registry.js';
+import type { ToolCapability } from '../tools/registry.js';
+import type { AsyncJobRecord } from './job-store.js';
+import type { AsyncJobProcessorResult } from './job-runner.js';
+export interface AsyncToolRegistryLike {
+    getTools(): Map<string, Pick<ToolCapability, 'execute'>>;
+}
+export interface AsyncToolSynthesisInput {
+    toolName: string;
+    toolQuery: string;
+    toolResult: string;
+    userQuestion: string;
+}
+export type AsyncToolAnswerSynthesizer = (input: AsyncToolSynthesisInput) => Promise<string>;
+export interface AsyncToolProcessorOptions {
+    registry: AsyncToolRegistryLike | ToolRegistry;
+    maxPreviewLength?: number;
+    answerSynthesizer?: AsyncToolAnswerSynthesizer;
+}
+export declare class AsyncToolProcessor {
+    private registry;
+    private maxPreviewLength;
+    private answerSynthesizer?;
+    constructor(options: AsyncToolProcessorOptions);
+    process(job: AsyncJobRecord): Promise<AsyncJobProcessorResult>;
+}
+export declare function previewOutput(output: unknown, maxLength?: number): string;
+export declare function customerSafeAnswer(answer: string, rawOutput: unknown, toolResult: string, maxLength?: number): string;
+export declare function classifyToolError(message: string): string;
+export declare function isRetryableToolError(message: string): boolean;
+//# sourceMappingURL=tool-processor.d.ts.map

package/dist/async-jobs/tool-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-processor.d.ts","sourceRoot":"","sources":["../../src/async-jobs/tool-processor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAE/D,MAAM,WAAW,qBAAqB;IACpC,QAAQ,IAAI,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC,CAAC;CAC1D;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,0BAA0B,GAAG,CAAC,KAAK,EAAE,uBAAuB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAE7F,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,qBAAqB,GAAG,YAAY,CAAC;IAC/C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,0BAA0B,CAAC;CAChD;AAID,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,iBAAiB,CAAC,CAA6B;gBAE3C,OAAO,EAAE,yBAAyB;IAMxC,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,uBAAuB,CAAC;CA2BrE;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,SAAyB,GAAG,MAAM,CAGzF;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,SAAyB,GAAG,MAAM,CAKrI;AAqND,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQzD;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAG7D"}

package/dist/async-jobs/tool-processor.js

@@ -0,0 +1,263 @@
+import { areAsyncToolJobsEnabled } from '../config/runtime-feature-flags.js';
+const DEFAULT_PREVIEW_LENGTH = 4000;
+export class AsyncToolProcessor {
+    registry;
+    maxPreviewLength;
+    answerSynthesizer;
+    constructor(options) {
+        this.registry = options.registry;
+        this.maxPreviewLength = Math.max(200, Math.min(options.maxPreviewLength || DEFAULT_PREVIEW_LENGTH, 8000));
+        this.answerSynthesizer = options.answerSynthesizer;
+    }
+    async process(job) {
+        if (!areAsyncToolJobsEnabled()) {
+            return {
+                ok: false,
+                errorCode: 'TOOLS_DISABLED',
+                errorMessage: 'Async tool execution is turned off in the chatbot settings.',
+                retryable: false,
+            };
+        }
+        const tool = this.registry.getTools().get(job.toolName);
+        if (!tool)
+            return { ok: false, errorCode: 'TOOL_NOT_AVAILABLE', errorMessage: `Tool is not available: ${job.toolName}`, retryable: false };
+        try {
+            const output = await tool.execute(job.toolArgs);
+            const toolQuery = String(job.toolArgs.query || job.toolArgs.q || job.originalText || '');
+            const filteredOutput = filterToolOutputForQuestion(output, `${toolQuery}\n${job.originalText || ''}`);
+            const toolResult = previewOutput(filteredOutput, this.maxPreviewLength);
+            const synthesized = this.answerSynthesizer
+                ? await this.answerSynthesizer({ toolName: job.toolName, toolQuery, toolResult, userQuestion: job.originalText })
+                : '';
+            return { ok: true, resultPreview: customerSafeAnswer(synthesized, filteredOutput, toolResult, this.maxPreviewLength) };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Tool execution failed.';
+            return { ok: false, errorCode: classifyToolError(message), errorMessage: message, retryable: isRetryableToolError(message) };
+        }
+    }
+}
+export function previewOutput(output, maxLength = DEFAULT_PREVIEW_LENGTH) {
+    const text = typeof output === 'string' ? output : safeJson(output);
+    return cleanCustomerText(text).slice(0, maxLength);
+}
+export function customerSafeAnswer(answer, rawOutput, toolResult, maxLength = DEFAULT_PREVIEW_LENGTH) {
+    const cleaned = cleanCustomerText(stripUnsafeWrappers(answer));
+    if (cleaned && !looksLikeJson(cleaned) && !hasUngroundedUrls(cleaned, rawOutput) && !hasUnsafeSourcePlaceholder(cleaned))
+        return clipForCustomer(cleaned, maxLength);
+    const fallback = humanizeToolOutput(rawOutput) || humanizeToolResultText(toolResult);
+    return clipForCustomer(fallback, maxLength);
+}
+function safeJson(value) {
+    try {
+        return JSON.stringify(value, null, 2);
+    }
+    catch {
+        return String(value);
+    }
+}
+function stripUnsafeWrappers(text) {
+    return String(text || '')
+        .replace(/```(?:json)?/gi, '')
+        .replace(/```/g, '')
+        .replace(/<think>[\s\S]*?<\/think>/gi, '')
+        .replace(/<thinking>[\s\S]*?<\/thinking>/gi, '')
+        .replace(/<reasoning>[\s\S]*?<\/reasoning>/gi, '')
+        .replace(/<analysis>[\s\S]*?<\/analysis>/gi, '')
+        .replace(/<scratchpad>[\s\S]*?<\/scratchpad>/gi, '')
+        .trim();
+}
+function removeBinaryPayloads(text) {
+    return String(text || '')
+        .replace(/%PDF-[\s\S]*?(?=(https?:\/\/|$))/gi, '')
+        .replace(/stream[\s\S]*?endstream/gi, '')
+        .replace(/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F-\u009F\uFFFD]/g, '')
+        .replace(/[\u200B-\u200F\u202A-\u202E\u2060-\u206F]/g, '');
+}
+function removeWebsiteBoilerplate(text) {
+    const withoutTags = String(text || '')
+        .replace(/<script[\s\S]*?<\/script>/gi, '')
+        .replace(/<style[\s\S]*?<\/style>/gi, '')
+        .replace(/<[^>]+>/g, ' ');
+    const boilerplate = [
+        /^(skip to content|menu|navigation|advertisement|sponsored|share this|follow us)$/i,
+        /cookie|privacy policy|terms of use|subscribe|newsletter|all rights reserved/i,
+        /^(home|news|sports|business|entertainment|lifestyle|opinion)$/i,
+        /^tags?:\s*/i,
+        /^related articles?$/i,
+    ];
+    return withoutTags
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => line && !boilerplate.some((pattern) => pattern.test(line)))
+        .join('\n');
+}
+function cleanCustomerText(text) {
+    return removeWebsiteBoilerplate(removeBinaryPayloads(text))
+        .replace(/\r\n/g, '\n')
+        .replace(/\r/g, '\n')
+        .split('\n').map((line) => line.trim().split(' ').filter(Boolean).join(' ')).join('\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .trim();
+}
+function clipForCustomer(text, maxLength) {
+    const cleaned = cleanCustomerText(text);
+    if (cleaned.length <= maxLength)
+        return cleaned;
+    const clipped = cleaned.slice(0, Math.max(0, maxLength - 1));
+    const sentenceEnd = Math.max(clipped.lastIndexOf('. '), clipped.lastIndexOf('? '), clipped.lastIndexOf('! '), clipped.lastIndexOf('\n'));
+    if (sentenceEnd > Math.max(80, maxLength * 0.6))
+        return `${clipped.slice(0, sentenceEnd + 1).trim()}…`;
+    const wordEnd = clipped.lastIndexOf(' ');
+    return `${clipped.slice(0, Math.max(80, wordEnd)).trim()}…`;
+}
+function looksLikeJson(text) {
+    const trimmed = text.trim();
+    return trimmed.startsWith('{') || trimmed.startsWith('[') || trimmed.startsWith('"title"') || trimmed.startsWith('"results"');
+}
+function urlsInText(text) {
+    const urls = new Set();
+    for (const part of String(text || '').split(/\s+/)) {
+        if (!part.startsWith('http://') && !part.startsWith('https://'))
+            continue;
+        urls.add(part.replace(/[.,;:!?]+$/, ''));
+    }
+    return urls;
+}
+function hasUngroundedUrls(answer, rawOutput) {
+    const answerUrls = urlsInText(answer);
+    if (answerUrls.size === 0)
+        return false;
+    const raw = typeof rawOutput === 'string' ? rawOutput : safeJson(rawOutput);
+    const groundedUrls = urlsInText(raw);
+    for (const url of answerUrls)
+        if (!groundedUrls.has(url))
+            return true;
+    return false;
+}
+function hasUnsafeSourcePlaceholder(answer) {
+    const lowered = answer.toLowerCase();
+    return lowered.includes('[source]') || lowered.includes('[sources]') || lowered.includes('[links]') || lowered.includes('[citations]') || lowered.includes('source: unknown') || lowered.includes('source: not provided');
+}
+function cleanFieldText(text) {
+    return cleanCustomerText(stripUnsafeWrappers(text)).split('\n').join(' ').trim();
+}
+function recordsFromOutput(output) {
+    const records = Array.isArray(output)
+        ? output
+        : typeof output === 'object' && output !== null && Array.isArray(output.results)
+            ? output.results
+            : [];
+    return records.filter((item) => typeof item === 'object' && item !== null && !Array.isArray(item));
+}
+function relevanceTokens(text) {
+    const stop = new Set([
+        'the', 'and', 'for', 'that', 'this', 'with', 'what', 'when', 'where', 'why', 'how',
+        'about', 'from', 'into', 'onto', 'have', 'has', 'had', 'did', 'does', 'are', 'was',
+        'were', 'you', 'your', 'please', 'help', 'news', 'latest', 'current', 'today',
+    ]);
+    return cleanCustomerText(text)
+        .toLowerCase()
+        .replace(/[^a-z0-9\s-]/g, ' ')
+        .split(/\s+/)
+        .map((token) => token.trim())
+        .filter((token) => token.length >= 3 && !stop.has(token));
+}
+function recordSearchText(item) {
+    return [
+        firstString(item, ['title', 'headline', 'name']),
+        firstString(item, ['snippet', 'description', 'content', 'summary', 'text']),
+        firstString(item, ['source', 'publisher', 'url', 'link']),
+    ].join(' ');
+}
+function relevanceScore(item, tokens) {
+    const haystack = recordSearchText(item).toLowerCase();
+    let score = 0;
+    for (const token of tokens) {
+        if (haystack.includes(token))
+            score += 1;
+    }
+    return score;
+}
+function filterToolOutputForQuestion(output, question) {
+    const tokens = new Set(relevanceTokens(question));
+    if (tokens.size === 0)
+        return output;
+    const cloneWithResults = (original, results) => ({
+        ...original,
+        results,
+    });
+    if (Array.isArray(output)) {
+        const records = output.filter((item) => typeof item === 'object' && item !== null && !Array.isArray(item));
+        const ranked = records
+            .map((item) => ({ item, score: relevanceScore(item, tokens) }))
+            .sort((a, b) => b.score - a.score);
+        const relevant = ranked.filter((entry) => entry.score > 0).slice(0, 8).map((entry) => entry.item);
+        return relevant.length > 0 ? relevant : output;
+    }
+    if (typeof output === 'object' && output !== null && Array.isArray(output.results)) {
+        const original = output;
+        const records = original.results
+            .filter((item) => typeof item === 'object' && item !== null && !Array.isArray(item));
+        const ranked = records
+            .map((item) => ({ item, score: relevanceScore(item, tokens) }))
+            .sort((a, b) => b.score - a.score);
+        const relevant = ranked.filter((entry) => entry.score > 0).slice(0, 8).map((entry) => entry.item);
+        return relevant.length > 0 ? cloneWithResults(original, relevant) : output;
+    }
+    return output;
+}
+function humanizeToolOutput(output) {
+    const records = recordsFromOutput(output);
+    const summaryLines = records.slice(0, 4)
+        .map((item) => cleanFieldText(firstString(item, ['snippet', 'description', 'content', 'summary', 'text']) || firstString(item, ['title', 'headline', 'name']) || ''))
+        .filter(Boolean)
+        .slice(0, 3)
+        .map((detail) => `- ${clipForCustomer(detail, 240).replace(/[.!?…]*$/, '.')}`);
+    const sourceLines = records.slice(0, 5).map((item) => {
+        const title = cleanFieldText(firstString(item, ['title', 'headline', 'name']) || 'Result');
+        const source = cleanFieldText(firstString(item, ['url', 'link', 'source']) || '');
+        if (!title && !source)
+            return '';
+        return source ? `- ${title} — ${source}` : `- ${title}`;
+    }).filter((line) => line.replace(/[-—\s]/g, '').length > 0);
+    if (summaryLines.length === 0 && sourceLines.length === 0)
+        return '';
+    const summary = summaryLines.length > 0
+        ? ['Based on the tool results, the short answer is:', ...summaryLines].join('\n')
+        : 'I found relevant results, but the tool did not provide enough snippet text for a direct summary.';
+    return sourceLines.length > 0 ? `${summary}\n\nSources:\n${sourceLines.join('\n')}` : summary;
+}
+function humanizeToolResultText(text) {
+    const cleaned = cleanCustomerText(stripUnsafeWrappers(text));
+    if (!cleaned || looksLikeJson(cleaned))
+        return 'I found results, but I could not turn them into a clear answer. Please try asking again.';
+    return cleaned;
+}
+function firstString(item, keys) {
+    for (const key of keys) {
+        const value = item[key];
+        if (typeof value === 'string' && value.trim())
+            return value;
+    }
+    return '';
+}
+export function classifyToolError(message) {
+    const lowered = message.toLowerCase();
+    if (lowered.includes('timeout') || lowered.includes('timed out'))
+        return 'TOOL_TIMEOUT';
+    if (lowered.includes('503') || lowered.includes('temporarily unavailable') || lowered.includes('unavailable'))
+        return 'TOOL_RETRYABLE_NETWORK';
+    if (lowered.includes('econnreset') || lowered.includes('fetch failed'))
+        return 'TOOL_RETRYABLE_NETWORK';
+    if (lowered.includes('429') || lowered.includes('rate limit'))
+        return 'TOOL_RATE_LIMIT';
+    if (lowered.includes('401') || lowered.includes('403') || lowered.includes('api key') || lowered.includes('not configured'))
+        return 'TOOL_AUTH_OR_CONFIG';
+    return 'TOOL_ERROR';
+}
+export function isRetryableToolError(message) {
+    const code = classifyToolError(message);
+    return code === 'TOOL_TIMEOUT' || code === 'TOOL_RETRYABLE_NETWORK' || code === 'TOOL_RATE_LIMIT';
+}
+//# sourceMappingURL=tool-processor.js.map

package/dist/async-jobs/tool-processor.js.map

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

package/dist/auth/session-admin.d.ts

@@ -0,0 +1,19 @@
+export interface AuthStatus {
+    path: string;
+    exists: boolean;
+    sizeBytes: number;
+    modifiedAt: string | null;
+}
+export interface AuthBackupResult {
+    authPath: string;
+    backupPath: string | null;
+}
+export declare function getAuthStatus(path?: string): AuthStatus;
+export declare function backupAuthState(path?: string, now?: Date): AuthBackupResult;
+export declare function resetAuthState(options?: {
+    yes?: boolean;
+    path?: string;
+}): AuthBackupResult;
+export declare function loginCommand(path?: string): string;
+export declare function formatAuthStatus(status?: AuthStatus): string;
+//# sourceMappingURL=session-admin.d.ts.map

package/dist/auth/session-admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-admin.d.ts","sourceRoot":"","sources":["../../src/auth/session-admin.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAcD,wBAAgB,aAAa,CAAC,IAAI,SAAa,GAAG,UAAU,CAK3D;AAED,wBAAgB,eAAe,CAAC,IAAI,SAAa,EAAE,GAAG,OAAa,GAAG,gBAAgB,CAQrF;AAED,wBAAgB,cAAc,CAAC,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,gBAAgB,CAM/F;AAED,wBAAgB,YAAY,CAAC,IAAI,SAAa,GAAG,MAAM,CAGtD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,aAAkB,GAAG,MAAM,CASjE"}