nduka 1.0.0

package/dist/ai-router/router.js.map

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

package/dist/async-jobs/context-resolver-planner.d.ts

@@ -0,0 +1,35 @@
+import type { Message, ProviderName } from '../llm/types.js';
+import { type AsyncRoutingConversationContext } from './routing-context.js';
+export type ContextResolutionMode = 'standalone' | 'quoted_context' | 'previous_tool_context' | 'combined_context' | 'clarify';
+export interface ContextResolutionInput {
+    text: string;
+    chatJid: string;
+    senderJid?: string;
+    isGroup: boolean;
+    isOwnerSelfChat: boolean;
+    candidateContext?: AsyncRoutingConversationContext;
+}
+export interface ResolvedRoutingContext {
+    mode: ContextResolutionMode;
+    resolvedText: string;
+    confidence: number;
+    reason: string;
+    conversationContext?: AsyncRoutingConversationContext;
+}
+export type ContextResolverCompletion = (messages: Message[], target: {
+    provider: ProviderName;
+    model: string;
+}) => Promise<string>;
+export interface ContextResolverPlannerOptions {
+    completion?: ContextResolverCompletion;
+}
+export declare class ContextResolverPlanner {
+    private completion?;
+    private router;
+    private taskRouter;
+    constructor(options?: ContextResolverPlannerOptions);
+    resolve(input: ContextResolutionInput): Promise<ResolvedRoutingContext>;
+    private complete;
+    private repairInvalidJson;
+}
+//# sourceMappingURL=context-resolver-planner.d.ts.map

package/dist/async-jobs/context-resolver-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-resolver-planner.d.ts","sourceRoot":"","sources":["../../src/async-jobs/context-resolver-planner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAGL,KAAK,+BAA+B,EACrC,MAAM,sBAAsB,CAAC;AAE9B,MAAM,MAAM,qBAAqB,GAC7B,YAAY,GACZ,gBAAgB,GAChB,uBAAuB,GACvB,kBAAkB,GAClB,SAAS,CAAC;AAEd,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,gBAAgB,CAAC,EAAE,+BAA+B,CAAC;CACpD;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB,CAAC,EAAE,+BAA+B,CAAC;CACvD;AAED,MAAM,MAAM,yBAAyB,GAAG,CACtC,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,EAAE;IAAE,QAAQ,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,KAC9C,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB,MAAM,WAAW,6BAA6B;IAC5C,UAAU,CAAC,EAAE,yBAAyB,CAAC;CACxC;AAUD,qBAAa,sBAAsB;IACjC,OAAO,CAAC,UAAU,CAAC,CAA4B;IAC/C,OAAO,CAAC,MAAM,CAAiD;IAC/D,OAAO,CAAC,UAAU,CAAyB;gBAE/B,OAAO,GAAE,6BAAkC;IAIjD,OAAO,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC;YAwB/D,QAAQ;YAkBR,iBAAiB;CAiChC"}

package/dist/async-jobs/context-resolver-planner.js

@@ -0,0 +1,324 @@
+import { ProviderRouter } from '../llm/router.js';
+import { getFreeTierRouterConfig } from '../llm/config.js';
+import { TaskModelRouter } from '../llm/task-router.js';
+import { compactRoutingContextText, hasRoutingContext, } from './routing-context.js';
+const VALID_MODES = new Set([
+    'standalone',
+    'quoted_context',
+    'previous_tool_context',
+    'combined_context',
+    'clarify',
+]);
+export class ContextResolverPlanner {
+    completion;
+    router = new ProviderRouter(getFreeTierRouterConfig());
+    taskRouter = new TaskModelRouter();
+    constructor(options = {}) {
+        this.completion = options.completion;
+    }
+    async resolve(input) {
+        const fallback = fallbackResolution(input);
+        if (!hasRoutingContext(input.candidateContext)) {
+            return fallback;
+        }
+        let raw = '';
+        try {
+            raw = await this.complete(buildContextResolverMessages(input));
+        }
+        catch {
+            return fallback;
+        }
+        let parsed = parseContextResolution(raw);
+        if (!parsed) {
+            const repaired = await this.repairInvalidJson(raw, input);
+            parsed = parseContextResolution(repaired);
+        }
+        if (!parsed)
+            return fallback;
+        return validateContextResolution(parsed, input);
+    }
+    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) {
+        const messages = [
+            {
+                role: 'system',
+                content: [
+                    'You repair context-resolution planner output.',
+                    'Return exactly one valid JSON object and no prose.',
+                    'Valid mode values: standalone, quoted_context, previous_tool_context, combined_context, clarify.',
+                    'Never answer the user.',
+                ].join('\n'),
+            },
+            {
+                role: 'user',
+                content: JSON.stringify({
+                    invalidOutput: raw.slice(0, 2000),
+                    currentMessage: input.text,
+                    candidateContext: input.candidateContext,
+                    requiredShape: {
+                        mode: 'standalone|quoted_context|previous_tool_context|combined_context|clarify',
+                        resolvedText: 'self-contained user request string',
+                        confidence: 'number 0..1',
+                        reason: 'string',
+                    },
+                }),
+            },
+        ];
+        try {
+            return await this.complete(messages);
+        }
+        catch {
+            return '';
+        }
+    }
+}
+function buildContextResolverMessages(input) {
+    return [
+        {
+            role: 'system',
+            content: [
+                'You are a strict context-resolution planner for a WhatsApp assistant.',
+                'Your job is not to answer the user.',
+                'Return exactly one JSON object and no prose.',
+                'Decide whether the current message should stand alone or use provided conversation context.',
+                'Prefer standalone when the current message is self-contained.',
+                'Use quoted_context only when the quoted WhatsApp message is needed to understand the current message.',
+                'Use previous_tool_context only when the current message is clearly a follow-up that cannot be understood without the previous tool result.',
+                'Use combined_context only when both quoted text and previous tool result are needed.',
+                'Use clarify only when the message and available context are still insufficient.',
+                'If the user corrects the assistant, changes topic, says the previous topic was wrong, or asks a new standalone question, use standalone.',
+                'When using context, rewrite resolvedText as a self-contained request using only the current message and selected context.',
+                'Required JSON keys: mode, resolvedText, confidence, reason.',
+            ].join('\n'),
+        },
+        {
+            role: 'user',
+            content: JSON.stringify({
+                currentMessage: input.text,
+                candidateContext: input.candidateContext,
+            }),
+        },
+    ];
+}
+function fallbackResolution(input) {
+    const quotedOnly = input.candidateContext?.quotedText
+        ? {
+            quotedText: compactRoutingContextText(input.candidateContext.quotedText, 1000),
+            quotedMessageId: input.candidateContext.quotedMessageId,
+        }
+        : undefined;
+    if (quotedOnly?.quotedText) {
+        return {
+            mode: 'quoted_context',
+            resolvedText: input.text,
+            confidence: 0.6,
+            reason: 'Quoted WhatsApp text was explicitly attached to the current message.',
+            conversationContext: quotedOnly,
+        };
+    }
+    if (isReferentialFollowup(input.text) && hasPreviousToolContext(input.candidateContext)) {
+        const previous = previousOnly(input.candidateContext);
+        return {
+            mode: 'previous_tool_context',
+            resolvedText: buildPreviousFollowupRequest(input.text, previous),
+            confidence: 0.65,
+            reason: 'The current message is a referential follow-up and previous tool context is available.',
+            conversationContext: previous,
+        };
+    }
+    return {
+        mode: 'standalone',
+        resolvedText: input.text,
+        confidence: 1,
+        reason: 'No reliable context resolution was available, so the message is handled as standalone.',
+    };
+}
+function parseContextResolution(raw) {
+    const json = extractJsonObject(raw);
+    if (!json)
+        return null;
+    try {
+        const parsed = JSON.parse(json);
+        if (!isRecord(parsed))
+            return null;
+        const mode = parsed.mode;
+        if (mode !== 'standalone' &&
+            mode !== 'quoted_context' &&
+            mode !== 'previous_tool_context' &&
+            mode !== 'combined_context' &&
+            mode !== 'clarify') {
+            return null;
+        }
+        return {
+            mode,
+            resolvedText: typeof parsed.resolvedText === 'string' && parsed.resolvedText.trim()
+                ? parsed.resolvedText.trim()
+                : '',
+            confidence: typeof parsed.confidence === 'number' ? parsed.confidence : Number(parsed.confidence || 0),
+            reason: typeof parsed.reason === 'string' ? parsed.reason : '',
+        };
+    }
+    catch {
+        return null;
+    }
+}
+function validateContextResolution(plan, input) {
+    const fallback = fallbackResolution(input);
+    if (!VALID_MODES.has(plan.mode))
+        return fallback;
+    if (!plan.resolvedText.trim())
+        return fallback;
+    if (!Number.isFinite(plan.confidence) || plan.confidence < 0.5)
+        return fallback;
+    if (!plan.reason.trim())
+        return fallback;
+    const candidate = input.candidateContext;
+    const hasQuoted = Boolean(candidate?.quotedText);
+    const hasPrevious = Boolean(candidate?.previousToolName || candidate?.previousUserQuestion || candidate?.previousAnswer);
+    if (plan.mode === 'standalone') {
+        return {
+            mode: 'standalone',
+            resolvedText: plan.resolvedText,
+            confidence: clamp01(plan.confidence),
+            reason: plan.reason,
+        };
+    }
+    if (plan.mode === 'quoted_context') {
+        if (!hasQuoted)
+            return fallback;
+        return {
+            ...plan,
+            confidence: clamp01(plan.confidence),
+            conversationContext: {
+                quotedText: compactRoutingContextText(candidate?.quotedText, 1000),
+                quotedMessageId: candidate?.quotedMessageId,
+            },
+        };
+    }
+    if (plan.mode === 'previous_tool_context') {
+        if (!hasPrevious)
+            return fallback;
+        return {
+            ...plan,
+            confidence: clamp01(plan.confidence),
+            conversationContext: previousOnly(candidate),
+        };
+    }
+    if (plan.mode === 'combined_context') {
+        if (!hasQuoted || !hasPrevious)
+            return fallback;
+        return {
+            ...plan,
+            confidence: clamp01(plan.confidence),
+            conversationContext: {
+                quotedText: compactRoutingContextText(candidate?.quotedText, 1000),
+                quotedMessageId: candidate?.quotedMessageId,
+                ...previousOnly(candidate),
+            },
+        };
+    }
+    return {
+        mode: 'clarify',
+        resolvedText: plan.resolvedText,
+        confidence: clamp01(plan.confidence),
+        reason: plan.reason,
+    };
+}
+function previousOnly(context) {
+    return {
+        previousUserQuestion: compactRoutingContextText(context?.previousUserQuestion, 1000),
+        previousToolName: context?.previousToolName,
+        previousToolArgs: context?.previousToolArgs,
+        previousAnswer: compactRoutingContextText(context?.previousAnswer, 2000),
+        ageMs: context?.ageMs,
+    };
+}
+function hasPreviousToolContext(context) {
+    return Boolean(context?.previousToolName);
+}
+function isReferentialFollowup(text) {
+    const normalized = text.replace(/\s+/g, ' ').trim().toLowerCase();
+    if (!normalized)
+        return false;
+    if (isStandaloneConversationTurn(normalized))
+        return false;
+    if (normalized.length <= 32 && /^(and\s+)?(tomorrow|today|yesterday|next|again|same|also|daily|weekly|monthly)\b/.test(normalized))
+        return true;
+    if (/^(what|how|when|where|who|which)\s+about\b/.test(normalized))
+        return true;
+    if (/^(and|also)\b/.test(normalized))
+        return true;
+    if (/\b(it|that|this|they|them|those|there|same one|the above|previous|earlier|again)\b/.test(normalized) && normalized.length <= 120)
+        return true;
+    if (isLowInformationFollowup(normalized))
+        return true;
+    return false;
+}
+function isStandaloneConversationTurn(normalized) {
+    return /^(hi|hello|hey|good\s+(morning|afternoon|evening)|thanks|thank you)\b/.test(normalized) ||
+        /^how\s+(are|r)\s+(you|u)\b/.test(normalized) ||
+        /^what'?s\s+up\b/.test(normalized);
+}
+const FOLLOWUP_STOP_WORDS = new Set([
+    'a', 'an', 'and', 'any', 'are', 'about', 'between', 'can', 'could', 'did', 'do', 'does', 'for', 'from',
+    'had', 'has', 'have', 'how', 'i', 'in', 'is', 'it', 'me', 'more', 'of', 'on', 'or', 'please', 'the',
+    'their', 'there', 'this', 'that', 'to', 'was', 'were', 'what', 'when', 'where', 'which', 'who', 'why',
+    'you', 'your',
+]);
+const GENERIC_FOLLOWUP_TERMS = new Set([
+    'again', 'check', 'detail', 'details', 'elaborate', 'explain', 'happen', 'happened', 'information',
+    'info', 'latest', 'more', 'name', 'names', 'player', 'players', 'position', 'positions', 'rating',
+    'ratings', 'result', 'results', 'score', 'scores', 'status', 'update', 'updates',
+]);
+function isLowInformationFollowup(normalized) {
+    if (normalized.length > 140)
+        return false;
+    const tokens = normalized.match(/[a-z0-9]+/g) || [];
+    if (tokens.length === 0 || tokens.length > 14)
+        return false;
+    const questionLike = normalized.includes('?') || /^(what|why|how|when|where|who|which|was|were|is|did|do|does|can|could)\b/.test(normalized);
+    if (!questionLike)
+        return false;
+    const specificTerms = tokens.filter((token) => !FOLLOWUP_STOP_WORDS.has(token) && !GENERIC_FOLLOWUP_TERMS.has(token));
+    return specificTerms.length <= 1;
+}
+function buildPreviousFollowupRequest(text, context) {
+    const parts = [
+        context.previousUserQuestion ? `Previous question: ${context.previousUserQuestion}` : '',
+        context.previousAnswer ? `Previous answer summary: ${context.previousAnswer}` : '',
+        `Current follow-up: ${text}`,
+    ].filter(Boolean);
+    return parts.join('\n');
+}
+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 clamp01(value) {
+    if (!Number.isFinite(value))
+        return 0;
+    return Math.max(0, Math.min(1, value));
+}
+//# sourceMappingURL=context-resolver-planner.js.map

package/dist/async-jobs/context-resolver-planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-resolver-planner.js","sourceRoot":"","sources":["../../src/async-jobs/context-resolver-planner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,OAAO,EACL,yBAAyB,EACzB,iBAAiB,GAElB,MAAM,sBAAsB,CAAC;AAmC9B,MAAM,WAAW,GAAG,IAAI,GAAG,CAAwB;IACjD,YAAY;IACZ,gBAAgB;IAChB,uBAAuB;IACvB,kBAAkB;IAClB,SAAS;CACV,CAAC,CAAC;AAEH,MAAM,OAAO,sBAAsB;IACzB,UAAU,CAA6B;IACvC,MAAM,GAAG,IAAI,cAAc,CAAC,uBAAuB,EAAE,CAAC,CAAC;IACvD,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IAE3C,YAAY,UAAyC,EAAE;QACrD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAA6B;QACzC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;QAE3C,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC;YAC/C,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,IAAI,GAAG,GAAG,EAAE,CAAC;QACb,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,4BAA4B,CAAC,KAAK,CAAC,CAAC,CAAC;QACjE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,IAAI,MAAM,GAAG,sBAAsB,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC1D,MAAM,GAAG,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC;QAED,IAAI,CAAC,MAAM;YAAE,OAAO,QAAQ,CAAC;QAC7B,OAAO,yBAAyB,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,QAAmB;QACxC,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC;QAC3D,IAAI,IAAI,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAE1G,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,QAAQ,EAAE;YACtE,QAAQ;YACR,QAAQ,EAAE,MAAM,CAAC,QAAQ;YACzB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,SAAS,EAAE,GAAG;YACd,WAAW,EAAE,CAAC;YACd,SAAS,EAAE,MAAM;YACjB,UAAU,EAAE,MAAM;YAClB,gBAAgB,EAAE,IAAI;SACvB,CAAC,CAAC;QAEH,OAAO,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;IAChC,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAAC,GAAW,EAAE,KAA6B;QACxE,MAAM,QAAQ,GAAc;YAC1B;gBACE,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE;oBACP,+CAA+C;oBAC/C,oDAAoD;oBACpD,kGAAkG;oBAClG,wBAAwB;iBACzB,CAAC,IAAI,CAAC,IAAI,CAAC;aACb;YACD;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;oBACtB,aAAa,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;oBACjC,cAAc,EAAE,KAAK,CAAC,IAAI;oBAC1B,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;oBACxC,aAAa,EAAE;wBACb,IAAI,EAAE,0EAA0E;wBAChF,YAAY,EAAE,oCAAoC;wBAClD,UAAU,EAAE,aAAa;wBACzB,MAAM,EAAE,QAAQ;qBACjB;iBACF,CAAC;aACH;SACF,CAAC;QAEF,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;CACF;AAED,SAAS,4BAA4B,CAAC,KAA6B;IACjE,OAAO;QACL;YACE,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE;gBACP,uEAAuE;gBACvE,qCAAqC;gBACrC,8CAA8C;gBAC9C,6FAA6F;gBAC7F,+DAA+D;gBAC/D,uGAAuG;gBACvG,4IAA4I;gBAC5I,sFAAsF;gBACtF,iFAAiF;gBACjF,0IAA0I;gBAC1I,2HAA2H;gBAC3H,6DAA6D;aAC9D,CAAC,IAAI,CAAC,IAAI,CAAC;SACb;QACD;YACE,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;gBACtB,cAAc,EAAE,KAAK,CAAC,IAAI;gBAC1B,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;aACzC,CAAC;SACH;KACF,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,KAA6B;IACvD,MAAM,UAAU,GAAG,KAAK,CAAC,gBAAgB,EAAE,UAAU;QACnD,CAAC,CAAC;YACE,UAAU,EAAE,yBAAyB,CAAC,KAAK,CAAC,gBAAgB,CAAC,UAAU,EAAE,IAAI,CAAC;YAC9E,eAAe,EAAE,KAAK,CAAC,gBAAgB,CAAC,eAAe;SACxD;QACH,CAAC,CAAC,SAAS,CAAC;IAEd,IAAI,UAAU,EAAE,UAAU,EAAE,CAAC;QAC3B,OAAO;YACL,IAAI,EAAE,gBAAgB;YACtB,YAAY,EAAE,KAAK,CAAC,IAAI;YACxB,UAAU,EAAE,GAAG;YACf,MAAM,EAAE,sEAAsE;YAC9E,mBAAmB,EAAE,UAAU;SAChC,CAAC;IACJ,CAAC;IAED,IAAI,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,sBAAsB,CAAC,KAAK,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACxF,MAAM,QAAQ,GAAG,YAAY,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;QACtD,OAAO;YACL,IAAI,EAAE,uBAAuB;YAC7B,YAAY,EAAE,4BAA4B,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC;YAChE,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,wFAAwF;YAChG,mBAAmB,EAAE,QAAQ;SAC9B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,YAAY,EAAE,KAAK,CAAC,IAAI;QACxB,UAAU,EAAE,CAAC;QACb,MAAM,EAAE,wFAAwF;KACjG,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,GAAW;IACzC,MAAM,IAAI,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAEvB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;QAC3C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,IAAI,CAAC;QAEnC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QACzB,IACE,IAAI,KAAK,YAAY;YACrB,IAAI,KAAK,gBAAgB;YACzB,IAAI,KAAK,uBAAuB;YAChC,IAAI,KAAK,kBAAkB;YAC3B,IAAI,KAAK,SAAS,EAClB,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO;YACL,IAAI;YACJ,YAAY,EAAE,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,IAAI,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE;gBACjF,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE;gBAC5B,CAAC,CAAC,EAAE;YACN,UAAU,EAAE,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,IAAI,CAAC,CAAC;YACtG,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;SAC/D,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,yBAAyB,CAAC,IAA4B,EAAE,KAA6B;IAC5F,MAAM,QAAQ,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IACjD,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE;QAAE,OAAO,QAAQ,CAAC;IAC/C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,UAAU,GAAG,GAAG;QAAE,OAAO,QAAQ,CAAC;IAChF,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,QAAQ,CAAC;IAEzC,MAAM,SAAS,GAAG,KAAK,CAAC,gBAAgB,CAAC;IACzC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,gBAAgB,IAAI,SAAS,EAAE,oBAAoB,IAAI,SAAS,EAAE,cAAc,CAAC,CAAC;IAEzH,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;QAC/B,OAAO;YACL,IAAI,EAAE,YAAY;YAClB,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;YACpC,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;QACnC,IAAI,CAAC,SAAS;YAAE,OAAO,QAAQ,CAAC;QAChC,OAAO;YACL,GAAG,IAAI;YACP,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;YACpC,mBAAmB,EAAE;gBACnB,UAAU,EAAE,yBAAyB,CAAC,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC;gBAClE,eAAe,EAAE,SAAS,EAAE,eAAe;aAC5C;SACF,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,uBAAuB,EAAE,CAAC;QAC1C,IAAI,CAAC,WAAW;YAAE,OAAO,QAAQ,CAAC;QAClC,OAAO;YACL,GAAG,IAAI;YACP,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;YACpC,mBAAmB,EAAE,YAAY,CAAC,SAAS,CAAC;SAC7C,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,kBAAkB,EAAE,CAAC;QACrC,IAAI,CAAC,SAAS,IAAI,CAAC,WAAW;YAAE,OAAO,QAAQ,CAAC;QAChD,OAAO;YACL,GAAG,IAAI;YACP,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;YACpC,mBAAmB,EAAE;gBACnB,UAAU,EAAE,yBAAyB,CAAC,SAAS,EAAE,UAAU,EAAE,IAAI,CAAC;gBAClE,eAAe,EAAE,SAAS,EAAE,eAAe;gBAC3C,GAAG,YAAY,CAAC,SAAS,CAAC;aAC3B;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,SAAS;QACf,YAAY,EAAE,IAAI,CAAC,YAAY;QAC/B,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;QACpC,MAAM,EAAE,IAAI,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,OAAoD;IACxE,OAAO;QACL,oBAAoB,EAAE,yBAAyB,CAAC,OAAO,EAAE,oBAAoB,EAAE,IAAI,CAAC;QACpF,gBAAgB,EAAE,OAAO,EAAE,gBAAgB;QAC3C,gBAAgB,EAAE,OAAO,EAAE,gBAAgB;QAC3C,cAAc,EAAE,yBAAyB,CAAC,OAAO,EAAE,cAAc,EAAE,IAAI,CAAC;QACxE,KAAK,EAAE,OAAO,EAAE,KAAK;KACtB,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,OAAoD;IAClF,OAAO,OAAO,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,qBAAqB,CAAC,IAAY;IACzC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClE,IAAI,CAAC,UAAU;QAAE,OAAO,KAAK,CAAC;IAC9B,IAAI,4BAA4B,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAC3D,IAAI,UAAU,CAAC,MAAM,IAAI,EAAE,IAAI,kFAAkF,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAChJ,IAAI,4CAA4C,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/E,IAAI,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,IAAI,oFAAoF,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,CAAC;IACnJ,IAAI,wBAAwB,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,4BAA4B,CAAC,UAAkB;IACtD,OAAO,uEAAuE,CAAC,IAAI,CAAC,UAAU,CAAC;QAC7F,4BAA4B,CAAC,IAAI,CAAC,UAAU,CAAC;QAC7C,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IACtG,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK;IACnG,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK;IACrG,KAAK,EAAE,MAAM;CACd,CAAC,CAAC;AAEH,MAAM,sBAAsB,GAAG,IAAI,GAAG,CAAC;IACrC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa;IAClG,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ;IACjG,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS;CACjF,CAAC,CAAC;AAEH,SAAS,wBAAwB,CAAC,UAAkB;IAClD,IAAI,UAAU,CAAC,MAAM,GAAG,GAAG;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;IACpD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC;IAC5D,MAAM,YAAY,GAAG,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,0EAA0E,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7I,IAAI,CAAC,YAAY;QAAE,OAAO,KAAK,CAAC;IAChC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACtH,OAAO,aAAa,CAAC,MAAM,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,4BAA4B,CAAC,IAAY,EAAE,OAAwC;IAC1F,MAAM,KAAK,GAAG;QACZ,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,sBAAsB,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC,CAAC,EAAE;QACxF,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,4BAA4B,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC,EAAE;QAClF,sBAAsB,IAAI,EAAE;KAC7B,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAW;IACpC,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7E,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,OAAO,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACrC,IAAI,KAAK,KAAK,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,GAAG,IAAI,KAAK;QAAE,OAAO,IAAI,CAAC;IAC5D,OAAO,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,SAAS,OAAO,CAAC,KAAa;IAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/async-jobs/gateway-worker.d.ts

@@ -0,0 +1,22 @@
+import { ToolContextStore } from '../agent-tools/tool-context-store.js';
+import type { CatalogResponsePolicy } from '../tools/tool-catalog-config.js';
+import type { AsyncJobRunResult } from './job-runner.js';
+import { AsyncJobWorker } from './job-worker.js';
+import { type AsyncJobSendText } from './job-delivery.js';
+import type { AsyncJobRecord } from './job-store.js';
+import { type AsyncToolAnswerSynthesizer, type AsyncToolRegistryLike } from './tool-processor.js';
+export interface GatewayAsyncJobWorkerOptions {
+    registry: AsyncToolRegistryLike;
+    sendText: AsyncJobSendText;
+    responses?: CatalogResponsePolicy;
+    contextStore?: ToolContextStore;
+    enabled?: boolean;
+    intervalMs?: number;
+    limit?: number;
+    onResult?: (result: AsyncJobRunResult) => void;
+    onError?: (error: Error) => void;
+    onDelivered?: (job: AsyncJobRecord, reply: string, status: 'succeeded' | 'failed') => void | Promise<void>;
+    answerSynthesizer?: AsyncToolAnswerSynthesizer;
+}
+export declare function createGatewayAsyncJobWorker(options: GatewayAsyncJobWorkerOptions): AsyncJobWorker;
+//# sourceMappingURL=gateway-worker.d.ts.map

package/dist/async-jobs/gateway-worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-worker.d.ts","sourceRoot":"","sources":["../../src/async-jobs/gateway-worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAE7E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAoB,KAAK,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAsB,KAAK,0BAA0B,EAAE,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEtH,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,qBAAqB,CAAC;IAChC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAChC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;IAC/C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3G,iBAAiB,CAAC,EAAE,0BAA0B,CAAC;CAChD;AAgBD,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,4BAA4B,GAAG,cAAc,CAgCjG"}

package/dist/async-jobs/gateway-worker.js

@@ -0,0 +1,53 @@
+import { ToolContextStore } from '../agent-tools/tool-context-store.js';
+import { loadToolCatalogConfig } from '../tools/tool-catalog-config.js';
+import { AsyncJobRunner } from './job-runner.js';
+import { AsyncJobWorker } from './job-worker.js';
+import { AsyncJobDelivery } from './job-delivery.js';
+import { AsyncToolProcessor } from './tool-processor.js';
+function storeDeliveredContext(store, job, reply, status) {
+    store.store({
+        chatJid: job.chatJid,
+        sourceMessageId: job.originalMessageId,
+        correlationId: job.correlationId,
+        jobId: job.jobId,
+        toolName: job.toolName,
+        toolArgs: job.toolArgs,
+        resultSummary: reply,
+        resultPreview: reply,
+        status: status === 'succeeded' ? 'active' : 'failed',
+    });
+}
+export function createGatewayAsyncJobWorker(options) {
+    const responses = options.responses || loadToolCatalogConfig().responses;
+    if (!responses)
+        throw new Error('Gateway async job worker requires configured tool catalog responses.');
+    const contextStore = options.contextStore || new ToolContextStore();
+    const delivery = new AsyncJobDelivery({ sendText: options.sendText, responses });
+    const processor = new AsyncToolProcessor({
+        registry: options.registry,
+        answerSynthesizer: options.answerSynthesizer,
+    });
+    const runner = new AsyncJobRunner({
+        processor: (job) => processor.process(job),
+        onSucceeded: async (job, resultPreview) => {
+            const reply = await delivery.sendSuccess(job, resultPreview);
+            storeDeliveredContext(contextStore, job, reply, 'succeeded');
+            await options.onDelivered?.(job, reply, 'succeeded');
+        },
+        onFailed: async (job, errorMessage) => {
+            console.warn(`[AsyncJobs] job failed: ${JSON.stringify({ jobId: job.jobId, toolName: job.toolName, correlationId: job.correlationId, errorMessage })}`);
+            const reply = await delivery.sendFailure(job, errorMessage);
+            storeDeliveredContext(contextStore, job, reply, 'failed');
+            await options.onDelivered?.(job, reply, 'failed');
+        },
+    });
+    return new AsyncJobWorker({
+        runner,
+        enabled: options.enabled,
+        intervalMs: options.intervalMs,
+        limit: options.limit,
+        onResult: options.onResult,
+        onError: options.onError,
+    });
+}
+//# sourceMappingURL=gateway-worker.js.map

package/dist/async-jobs/gateway-worker.js.map

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

package/dist/async-jobs/job-delivery.d.ts

@@ -0,0 +1,16 @@
+import type { CatalogResponsePolicy } from '../tools/tool-catalog-config.js';
+import type { AsyncJobRecord } from './job-store.js';
+export type AsyncJobSendText = (chatJid: string, text: string) => Promise<void>;
+export interface AsyncJobDeliveryOptions {
+    sendText: AsyncJobSendText;
+    responses: CatalogResponsePolicy;
+}
+export declare class AsyncJobDelivery {
+    private options;
+    constructor(options: AsyncJobDeliveryOptions);
+    sendSuccess(job: AsyncJobRecord, resultPreview: string): Promise<string>;
+    sendFailure(job: AsyncJobRecord, errorMessage: string): Promise<string>;
+}
+export declare function formatAsyncJobSuccess(_job: AsyncJobRecord, resultPreview: string, responses: CatalogResponsePolicy): string;
+export declare function formatAsyncJobFailure(_job: AsyncJobRecord, _errorMessage: string, responses: CatalogResponsePolicy): string;
+//# sourceMappingURL=job-delivery.d.ts.map

package/dist/async-jobs/job-delivery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-delivery.d.ts","sourceRoot":"","sources":["../../src/async-jobs/job-delivery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iCAAiC,CAAC;AAC7E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAEhF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,SAAS,EAAE,qBAAqB,CAAC;CAClC;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,uBAAuB;IAE9C,WAAW,CAAC,GAAG,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMxE,WAAW,CAAC,GAAG,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAK9E;AAQD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,GAAG,MAAM,CAG3H;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,qBAAqB,GAAG,MAAM,CAE3H"}

package/dist/async-jobs/job-delivery.js

@@ -0,0 +1,30 @@
+export class AsyncJobDelivery {
+    options;
+    constructor(options) {
+        this.options = options;
+    }
+    async sendSuccess(job, resultPreview) {
+        const reply = formatAsyncJobSuccess(job, resultPreview, this.options.responses);
+        await this.options.sendText(job.chatJid, reply);
+        return reply;
+    }
+    async sendFailure(job, errorMessage) {
+        const reply = formatAsyncJobFailure(job, errorMessage, this.options.responses);
+        await this.options.sendText(job.chatJid, reply);
+        return reply;
+    }
+}
+function configuredResponse(responses, key) {
+    const selected = responses[key]?.find((value) => value.trim().length > 0);
+    if (!selected)
+        throw new Error(`Missing configured async job delivery response: ${key}`);
+    return selected;
+}
+export function formatAsyncJobSuccess(_job, resultPreview, responses) {
+    const cleaned = resultPreview.trim();
+    return cleaned || configuredResponse(responses, 'manualReview');
+}
+export function formatAsyncJobFailure(_job, _errorMessage, responses) {
+    return configuredResponse(responses, 'manualReview');
+}
+//# sourceMappingURL=job-delivery.js.map

package/dist/async-jobs/job-delivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-delivery.js","sourceRoot":"","sources":["../../src/async-jobs/job-delivery.ts"],"names":[],"mappings":"AAUA,MAAM,OAAO,gBAAgB;IACP;IAApB,YAAoB,OAAgC;QAAhC,YAAO,GAAP,OAAO,CAAyB;IAAG,CAAC;IAExD,KAAK,CAAC,WAAW,CAAC,GAAmB,EAAE,aAAqB;QAC1D,MAAM,KAAK,GAAG,qBAAqB,CAAC,GAAG,EAAE,aAAa,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAChF,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,GAAmB,EAAE,YAAoB;QACzD,MAAM,KAAK,GAAG,qBAAqB,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC/E,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,SAAS,kBAAkB,CAAC,SAAgC,EAAE,GAAgC;IAC5F,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC1E,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,mDAAmD,GAAG,EAAE,CAAC,CAAC;IACzF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAoB,EAAE,aAAqB,EAAE,SAAgC;IACjH,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;IACrC,OAAO,OAAO,IAAI,kBAAkB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,IAAoB,EAAE,aAAqB,EAAE,SAAgC;IACjH,OAAO,kBAAkB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AACvD,CAAC"}

package/dist/async-jobs/job-runner.d.ts

@@ -0,0 +1,39 @@
+import { AsyncJobStore, type AsyncJobRecord } from './job-store.js';
+export interface AsyncJobRunResult {
+    due: number;
+    succeeded: number;
+    retried: number;
+    failed: number;
+}
+export interface AsyncJobProcessorResult {
+    ok: boolean;
+    resultPreview?: string;
+    errorCode?: string;
+    errorMessage?: string;
+    retryable?: boolean;
+}
+export type AsyncJobProcessor = (job: AsyncJobRecord) => Promise<AsyncJobProcessorResult>;
+export type AsyncJobSuccessHook = (job: AsyncJobRecord, resultPreview: string) => Promise<void>;
+export type AsyncJobFailureHook = (job: AsyncJobRecord, errorMessage: string) => Promise<void>;
+export interface AsyncJobRunnerOptions {
+    store?: AsyncJobStore;
+    processor: AsyncJobProcessor;
+    onSucceeded?: AsyncJobSuccessHook;
+    onFailed?: AsyncJobFailureHook;
+    now?: () => number;
+    baseRetryDelayMs?: number;
+    maxRetryDelayMs?: number;
+}
+export declare class AsyncJobRunner {
+    private store;
+    private processor;
+    private onSucceeded?;
+    private onFailed?;
+    private now;
+    private baseRetryDelayMs;
+    private maxRetryDelayMs;
+    constructor(options: AsyncJobRunnerOptions);
+    tick(limit?: number): Promise<AsyncJobRunResult>;
+    private retryDelay;
+}
+//# sourceMappingURL=job-runner.d.ts.map

package/dist/async-jobs/job-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-runner.d.ts","sourceRoot":"","sources":["../../src/async-jobs/job-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEpE,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,OAAO,CAAC;IACZ,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,MAAM,iBAAiB,GAAG,CAAC,GAAG,EAAE,cAAc,KAAK,OAAO,CAAC,uBAAuB,CAAC,CAAC;AAC1F,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAChG,MAAM,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE/F,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,WAAW,CAAC,EAAE,mBAAmB,CAAC;IAClC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAKD,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,SAAS,CAAoB;IACrC,OAAO,CAAC,WAAW,CAAC,CAAsB;IAC1C,OAAO,CAAC,QAAQ,CAAC,CAAsB;IACvC,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,gBAAgB,CAAS;IACjC,OAAO,CAAC,eAAe,CAAS;gBAEpB,OAAO,EAAE,qBAAqB;IAUpC,IAAI,CAAC,KAAK,SAAI,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAuCjD,OAAO,CAAC,UAAU;CAInB"}