nduka 1.0.0

package/dist/async-jobs/message-triage-planner.js

@@ -0,0 +1,262 @@
+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 VALID_ROUTES = new Set([
+    'answer_direct',
+    'needs_tool',
+    'clarify',
+    'human_review',
+    'blocked',
+]);
+const VALID_RISKS = new Set(['low', 'medium', 'high']);
+export class MessageTriagePlanner {
+    catalog;
+    completion;
+    router = new ProviderRouter(getFreeTierRouterConfig());
+    taskRouter = new TaskModelRouter();
+    constructor(options = {}) {
+        this.catalog = options.catalog || loadToolCatalogConfig();
+        this.completion = options.completion;
+    }
+    async plan(input) {
+        if (!input.text.trim())
+            return { ok: false, error: 'empty_text' };
+        if (input.isGroup || input.text.trim().startsWith('/'))
+            return { ok: false, error: 'triage_not_allowed_for_context' };
+        const tools = listEnabledCatalogTools(this.catalog).filter((tool) => tool.public && !tool.ownerOnly);
+        let raw = '';
+        try {
+            raw = await this.complete(buildTriageMessages(input, tools));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'triage_failed';
+            return { ok: false, error: `triage_failed: ${message}` };
+        }
+        let parsed = parseMessageTriagePlan(raw);
+        if (!parsed) {
+            const repaired = await this.repairInvalidJson(raw, input, tools);
+            parsed = parseMessageTriagePlan(repaired);
+        }
+        if (!parsed)
+            return { ok: false, error: 'triage_returned_invalid_json' };
+        return validateMessageTriagePlan(parsed);
+    }
+    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 message triage planner output.',
+                    'Return exactly one valid JSON object and no prose.',
+                    'Valid route values: answer_direct, needs_tool, clarify, human_review, blocked.',
+                    'Use needs_tool when a configured public tool may be required.',
+                    'Use conversationContext to resolve follow-up references, pronouns, quoted replies, and short questions.',
+                    'Use clarify when the message and conversationContext still lack enough detail.',
+                    'Use human_review when the assistant cannot safely continue after repeated uncertainty.',
+                ].join('\n'),
+            },
+            {
+                role: 'user',
+                content: JSON.stringify({
+                    invalidOutput: raw.slice(0, 2000),
+                    originalMessage: input.text,
+                    conversationContext: input.conversationContext,
+                    availableTools: summarizeTools(tools),
+                    requiredShape: {
+                        route: 'answer_direct|needs_tool|clarify|human_review|blocked',
+                        answerConfidence: 'number 0..1',
+                        toolNeedConfidence: 'number 0..1',
+                        privateDataRisk: 'boolean',
+                        hallucinationRisk: 'low|medium|high',
+                        reason: 'string',
+                        clarification: 'string optional',
+                        labels: 'string[] optional',
+                        priority: 'low|normal|high|urgent optional',
+                    },
+                }),
+            },
+        ];
+        try {
+            return await this.complete(messages);
+        }
+        catch {
+            return '';
+        }
+    }
+}
+export function validateMessageTriagePlan(plan) {
+    if (!VALID_ROUTES.has(plan.route))
+        return { ok: false, error: 'invalid_route' };
+    if (!Number.isFinite(plan.answerConfidence))
+        return { ok: false, error: 'invalid_answer_confidence' };
+    if (!Number.isFinite(plan.toolNeedConfidence))
+        return { ok: false, error: 'invalid_tool_need_confidence' };
+    if (typeof plan.privateDataRisk !== 'boolean')
+        return { ok: false, error: 'invalid_private_data_risk' };
+    if (!VALID_RISKS.has(plan.hallucinationRisk))
+        return { ok: false, error: 'invalid_hallucination_risk' };
+    if (typeof plan.reason !== 'string' || plan.reason.trim().length === 0)
+        return { ok: false, error: 'missing_reason' };
+    const normalized = {
+        ...plan,
+        answerConfidence: clamp01(plan.answerConfidence),
+        toolNeedConfidence: clamp01(plan.toolNeedConfidence),
+        labels: Array.isArray(plan.labels) ? plan.labels.filter((item) => typeof item === 'string').slice(0, 5) : undefined,
+    };
+    if (normalized.route === 'answer_direct') {
+        if (normalized.privateDataRisk) {
+            return {
+                ok: true,
+                plan: {
+                    ...normalized,
+                    route: 'needs_tool',
+                    toolNeedConfidence: Math.max(normalized.toolNeedConfidence, 0.75),
+                    hallucinationRisk: normalized.hallucinationRisk === 'low' ? 'medium' : normalized.hallucinationRisk,
+                    reason: `${normalized.reason} Private/account data risk requires a verified lookup or clarification.`,
+                },
+            };
+        }
+        if (normalized.answerConfidence < 0.5 || normalized.hallucinationRisk === 'high') {
+            return {
+                ok: true,
+                plan: {
+                    ...normalized,
+                    route: 'clarify',
+                    clarification: normalized.clarification || 'I want to make sure I answer the right thing. Could you give me a little more detail?',
+                },
+            };
+        }
+    }
+    if (normalized.route === 'needs_tool' && normalized.toolNeedConfidence < 0.5) {
+        return {
+            ok: true,
+            plan: {
+                ...normalized,
+                route: 'clarify',
+                clarification: normalized.clarification || 'I may need to check that, but I need a little more detail first.',
+            },
+        };
+    }
+    return { ok: true, plan: normalized };
+}
+export function parseMessageTriagePlan(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 !== 'answer_direct' && route !== 'needs_tool' && route !== 'clarify' && route !== 'human_review' && route !== 'blocked')
+            return null;
+        const hallucinationRisk = parsed.hallucinationRisk;
+        const risk = hallucinationRisk === 'low' || hallucinationRisk === 'medium' || hallucinationRisk === 'high'
+            ? hallucinationRisk
+            : 'medium';
+        return {
+            route,
+            answerConfidence: typeof parsed.answerConfidence === 'number' ? parsed.answerConfidence : Number(parsed.answerConfidence || 0),
+            toolNeedConfidence: typeof parsed.toolNeedConfidence === 'number' ? parsed.toolNeedConfidence : Number(parsed.toolNeedConfidence || 0),
+            privateDataRisk: parsed.privateDataRisk === true,
+            hallucinationRisk: risk,
+            reason: typeof parsed.reason === 'string' ? parsed.reason : '',
+            clarification: typeof parsed.clarification === 'string' ? parsed.clarification : undefined,
+            labels: Array.isArray(parsed.labels) ? parsed.labels.filter((item) => typeof item === 'string') : undefined,
+            priority: parsed.priority === 'low' || parsed.priority === 'normal' || parsed.priority === 'high' || parsed.priority === 'urgent'
+                ? parsed.priority
+                : undefined,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function buildTriageMessages(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: summarizeTools(tools),
+    };
+    return [
+        {
+            role: 'system',
+            content: [
+                'You are a strict WhatsApp message triage planner.',
+                'Return exactly one JSON object and no prose.',
+                'Your job is not to answer the user.',
+                'Decide whether the runtime should answer directly, use a configured tool, ask for clarification, block, or escalate for human review.',
+                'Use conversationContext to resolve follow-up references, pronouns, quoted replies, and short questions.',
+                'Never route private balances, fees, due dates, account details, or verified business facts to answer_direct.',
+                'Use needs_tool only when the provided availableTools could help.',
+                'Use clarify when the user is vague, missing required details, or the conversationContext is insufficient.',
+                'Use answer_direct only for normal conversation or stable general knowledge that does not require current/private/verified data.',
+                'Required JSON keys: route, answerConfidence, toolNeedConfidence, privateDataRisk, hallucinationRisk, reason.',
+            ].join('\n'),
+        },
+        { role: 'user', content: JSON.stringify(payload) },
+    ];
+}
+function summarizeTools(tools) {
+    return tools.map((tool) => ({
+        name: tool.name,
+        description: tool.description,
+        capabilityTags: tool.capabilityTags || [],
+        provider: tool.provider,
+        operation: tool.operation,
+        operationKind: tool.operationConfig.kind,
+        public: tool.public,
+        ownerOnly: tool.ownerOnly,
+        customerCallable: tool.customerCallable,
+        requiresApproval: tool.requiresApproval,
+        requiresIdentity: tool.requiresIdentity,
+        inputSchema: tool.inputSchema,
+        groundingPolicy: tool.groundingPolicy,
+        failurePolicy: tool.failurePolicy,
+    }));
+}
+function clamp01(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    return Math.max(0, Math.min(1, value));
+}
+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=message-triage-planner.js.map

package/dist/async-jobs/message-triage-planner.js.map

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

package/dist/async-jobs/request-controller.d.ts

@@ -0,0 +1,65 @@
+import { type ToolCatalogConfig } from '../tools/tool-catalog-config.js';
+import { AsyncJobStore } from './job-store.js';
+import { ToolIntentPlanner } from './tool-intent-planner.js';
+import { MessageTriagePlanner } from './message-triage-planner.js';
+import { ContextResolverPlanner } from './context-resolver-planner.js';
+export interface AsyncJobRequestInput {
+    text: string;
+    chatJid: string;
+    senderJid?: string;
+    originalMessageId: string;
+    isGroup: boolean;
+    isOwnerSelfChat: boolean;
+    quotedText?: string;
+    quotedMessageId?: string;
+}
+export interface AsyncJobRequestResult {
+    reply: string;
+    jobId: string;
+    created: boolean;
+    toolName: string;
+    manualReview?: boolean;
+    labels?: string[];
+}
+export interface AsyncJobRequestControllerOptions {
+    store?: AsyncJobStore;
+    catalog?: ToolCatalogConfig;
+    triagePlanner?: MessageTriagePlanner;
+    planner?: ToolIntentPlanner;
+    contextResolver?: ContextResolverPlanner;
+    enabled?: boolean;
+    now?: () => number;
+    contextTtlMs?: number;
+    contextLimit?: number;
+}
+export declare class AsyncJobRequestController {
+    private store;
+    private catalog;
+    private triagePlanner;
+    private planner;
+    private contextResolver;
+    private enabled;
+    private now;
+    private contextTtlMs;
+    private contextLimit;
+    private clarificationFailures;
+    private lastClarificationByChat;
+    constructor(options?: AsyncJobRequestControllerOptions);
+    handle(input: AsyncJobRequestInput): Promise<AsyncJobRequestResult | null>;
+    private buildRoutingInput;
+    private tryToolMatcher;
+    private handleToolPlan;
+    private clarifyOrManualReview;
+    private shouldEscalateRoutingUncertainty;
+    private manualReview;
+    private buildRequestResult;
+    private responseFor;
+    private answerClarificationFollowup;
+    private answerLookupAuditQuestion;
+    private retryLatestFailedLookup;
+    private buildCandidateContext;
+    private latestSuccessfulJobForChat;
+    private latestJobForChat;
+    private clearClarificationFailures;
+}
+//# sourceMappingURL=request-controller.d.ts.map

package/dist/async-jobs/request-controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-controller.d.ts","sourceRoot":"","sources":["../../src/async-jobs/request-controller.ts"],"names":[],"mappings":"AAAA,OAAO,EAA+C,KAAK,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACtH,OAAO,EAAE,aAAa,EAAmD,MAAM,gBAAgB,CAAC;AAChG,OAAO,EAAE,iBAAiB,EAA2C,MAAM,0BAA0B,CAAC;AACtG,OAAO,EAAE,oBAAoB,EAA0B,MAAM,6BAA6B,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAA+B,MAAM,+BAA+B,CAAC;AAOpG,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,gCAAgC;IAC/C,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,aAAa,CAAC,EAAE,oBAAoB,CAAC;IACrC,OAAO,CAAC,EAAE,iBAAiB,CAAC;IAC5B,eAAe,CAAC,EAAE,sBAAsB,CAAC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAuJD,qBAAa,yBAAyB;IACpC,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,aAAa,CAAuB;IAC5C,OAAO,CAAC,OAAO,CAAoB;IACnC,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,qBAAqB,CAA6B;IAC1D,OAAO,CAAC,uBAAuB,CAA6B;gBAEhD,OAAO,GAAE,gCAAqC;IAYpD,MAAM,CAAC,KAAK,EAAE,oBAAoB,GAAG,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC;YAmFlE,iBAAiB;YAoBjB,cAAc;IA8D5B,OAAO,CAAC,cAAc;IA+CtB,OAAO,CAAC,qBAAqB;IA2B7B,OAAO,CAAC,gCAAgC;IAOxC,OAAO,CAAC,YAAY;IAapB,OAAO,CAAC,kBAAkB;IAS1B,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,2BAA2B;IAcnC,OAAO,CAAC,yBAAyB;IAoBjC,OAAO,CAAC,uBAAuB;IA6B/B,OAAO,CAAC,qBAAqB;IAkB7B,OAAO,CAAC,0BAA0B;IASlC,OAAO,CAAC,gBAAgB;IAIxB,OAAO,CAAC,0BAA0B;CAGnC"}