agent-nuvira 3.1.1 → 3.2.0

package/dist/learning/deferred-task.js

@@ -0,0 +1,451 @@
+/**
+ * Deferred retry queue — the MECHANISM behind "Reply *yes* and I will keep
+ * trying until it is done."
+ *
+ * THE BUG THIS CLOSES. `renderModelBreadthReport` ends every failed turn with
+ * that offer, and it went out live to WhatsApp
+ * ("A model frees up in about 44s … Reply *yes* …"). Nothing parsed the "yes",
+ * stored the task, or re-ran it when a model came back — so a sender who
+ * followed the instruction got silence, which is worse than never being asked.
+ * A promise the agent cannot keep is a defect, not a courtesy.
+ *
+ * WHY A STORE INSTEAD OF A TIMER IN THE FAILURE PATH: the model that frees up
+ * is often minutes away (a quota window), and a messaging transport's turn is
+ * long over by then — there is no in-process stack to sit on. The task is
+ * therefore persisted (surviving a gateway restart, which is the normal case
+ * for a quota wait), and a periodic drain claims whatever is due.
+ *
+ * Deliberately a LEAF module (node builtins + path resolution only): the
+ * gateway, the CLI and the dashboard all need it, and a shared queue that
+ * dragged the routing graph in would be unusable from the dashboard.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { resolveNuviraDataPath } from '../config/paths.js';
+/** Bounded: a queue is a convenience, not a backlog. */
+const MAX_TASKS = 50;
+/** Confirmed horizon — "yes, keep trying until it is done". */
+export const DEFERRED_TASK_TTL_MS = 6 * 3_600_000;
+/** Optimistic horizon — queued because the ask was real, but never confirmed. */
+export const UNCONFIRMED_TASK_TTL_MS = 30 * 60_000;
+/** Attempt cap, so a permanently broken ask cannot loop for six hours. */
+const MAX_ATTEMPTS = 40;
+/** Attempt cap while the sender has NOT confirmed the retry. */
+const MAX_ATTEMPTS_UNCONFIRMED = 4;
+/** How many attempts this task is allowed. */
+export function attemptCap(task) {
+    return task.confirmed ? MAX_ATTEMPTS : MAX_ATTEMPTS_UNCONFIRMED;
+}
+/**
+ * Floor between attempts. A "free in 5s" hint is not a licence to hammer the
+ * pool — the failover walk already failed everything once, and a tight loop
+ * spends quota re-proving that.
+ */
+const MIN_WAIT_MS = 20_000;
+/** Ceiling: a known 10-hour reset is not worth holding a queue slot for. */
+const MAX_WAIT_MS = 60 * 60_000;
+/** Default wait when the report could not name a free-up time. */
+const DEFAULT_WAIT_MS = 5 * 60_000;
+const FILE_NAME = 'deferred-tasks.json';
+/**
+ * How long a task may sit in `running` before it is treated as abandoned.
+ *
+ * A retry is claimed by setting `status: 'running'` BEFORE the turn. If the
+ * process dies mid-attempt — a dashboard/gateway restart, a reboot, a crash,
+ * all normal during a quota wait — nothing ever resets it, and a `running` task
+ * is invisible to both `dueTasks` and `expiredTasks`. The promise would be
+ * stranded silently, which is the exact failure this whole store exists to
+ * prevent. The ceiling is generous (a retry is a full turn, capped at 5 minutes
+ * by the chat HTTP ceiling), so a live attempt is never stolen.
+ */
+const STALE_RUNNING_MS = 15 * 60_000;
+function storePath() {
+    return resolveNuviraDataPath(FILE_NAME);
+}
+/** Read the queue. Best-effort: a corrupt file is an empty queue, never a throw. */
+export function loadDeferredTasks() {
+    try {
+        const path = storePath();
+        if (!existsSync(path))
+            return [];
+        const parsed = JSON.parse(readFileSync(path, 'utf-8'));
+        if (!parsed || !Array.isArray(parsed.tasks))
+            return [];
+        return recoverStaleRunning(parsed.tasks.filter(isTaskShape));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Self-heal tasks abandoned mid-attempt (see STALE_RUNNING_MS).
+ *
+ * Applied on READ, so no process has to remember to run a recovery pass on
+ * startup, and the repair is written back so the next reader sees it too.
+ */
+function recoverStaleRunning(tasks, now = Date.now()) {
+    let repaired = false;
+    for (const task of tasks) {
+        if (task.status !== 'running')
+            continue;
+        const startedAt = task.lastAttemptAt || task.createdAt;
+        if (now - startedAt <= STALE_RUNNING_MS)
+            continue;
+        task.status = 'pending';
+        // Its wait elapsed long ago (it was due when the attempt was claimed), so
+        // being due again immediately is correct — nothing to wait for.
+        task.notBefore = Math.min(task.notBefore, now);
+        repaired = true;
+    }
+    if (repaired)
+        writeDeferredTasks(tasks);
+    return tasks;
+}
+function writeDeferredTasks(tasks) {
+    try {
+        const path = storePath();
+        const dir = dirname(path);
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        const payload = { version: 1, tasks: tasks.slice(0, MAX_TASKS) };
+        writeFileSync(path, JSON.stringify(payload, null, 2), 'utf-8');
+    }
+    catch {
+        // Best-effort — a store write must never break the turn that deferred it.
+    }
+}
+function isTaskShape(t) {
+    if (!t || typeof t !== 'object')
+        return false;
+    const o = t;
+    return (typeof o.id === 'string' &&
+        typeof o.platform === 'string' &&
+        typeof o.channelId === 'string' &&
+        typeof o.text === 'string' &&
+        (o.kind === 'chat' || o.kind === 'pipeline') &&
+        typeof o.createdAt === 'number' &&
+        typeof o.notBefore === 'number' &&
+        typeof o.deadline === 'number');
+}
+/** The conversation a task belongs to — one live retry per conversation. */
+function conversationKey(platform, channelId) {
+    return `${platform}:${channelId}`;
+}
+function newId() {
+    try {
+        if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
+            return `retry-${crypto.randomUUID().slice(0, 8)}`;
+        }
+    }
+    catch {
+        /* fall through */
+    }
+    return `retry-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+}
+/** Clamp a free-up hint into a sane retry wait. */
+export function retryWaitMs(nextFreeInMs) {
+    if (typeof nextFreeInMs !== 'number' || !Number.isFinite(nextFreeInMs) || nextFreeInMs <= 0) {
+        return DEFAULT_WAIT_MS;
+    }
+    return Math.min(MAX_WAIT_MS, Math.max(MIN_WAIT_MS, Math.round(nextFreeInMs)));
+}
+/**
+ * Record a failed ask for retry, or refresh the pending task for that
+ * conversation.
+ *
+ * The UPDATE path deliberately preserves `attempts` and `createdAt`: the retry
+ * that just failed re-enters this function (it goes through the same failure
+ * branch), and resetting the counters there would make the attempt cap and TTL
+ * meaningless — the task would retry forever.
+ *
+ * @returns the stored task and whether it was created (vs refreshed).
+ */
+export function deferTask(input) {
+    const tasks = loadDeferredTasks();
+    const key = conversationKey(input.platform, input.channelId);
+    const now = Date.now();
+    const existing = tasks.find((t) => conversationKey(t.platform, t.channelId) === key && t.text === input.text);
+    const notBefore = now + retryWaitMs(input.nextFreeInMs);
+    if (existing) {
+        existing.notBefore = Math.max(existing.notBefore, notBefore);
+        existing.status = 'pending';
+        if (input.lastError)
+            existing.lastError = input.lastError;
+        if (input.kind)
+            existing.kind = input.kind;
+        writeDeferredTasks(tasks);
+        return { task: existing, created: false };
+    }
+    const task = {
+        id: newId(),
+        platform: input.platform,
+        channelId: input.channelId,
+        ...(input.from ? { from: input.from } : {}),
+        ...(input.senderId ? { senderId: input.senderId } : {}),
+        ...(input.isGroup !== undefined ? { isGroup: input.isGroup } : {}),
+        text: input.text,
+        kind: input.kind,
+        createdAt: now,
+        lastAttemptAt: 0,
+        attempts: 0,
+        status: 'pending',
+        notBefore,
+        deadline: now + UNCONFIRMED_TASK_TTL_MS,
+        ...(input.lastError ? { lastError: input.lastError } : {}),
+    };
+    // Newest first, bounded: the oldest pending task is the one a user is most
+    // likely to have forgotten, and dropping it silently is better than growing
+    // an unbounded file.
+    writeDeferredTasks([task, ...tasks]);
+    return { task, created: true };
+}
+/** The live task for a conversation (newest first), if any. */
+export function getPendingTask(platform, channelId) {
+    const key = conversationKey(platform, channelId);
+    return loadDeferredTasks().find((t) => conversationKey(t.platform, t.channelId) === key);
+}
+/** Every task currently waiting (for status surfaces, newest first). */
+export function listPendingTasks() {
+    return loadDeferredTasks();
+}
+/** Tasks whose next attempt is due and whose TTL has not elapsed. */
+export function dueTasks(now = Date.now(), owns = () => true) {
+    return loadDeferredTasks().filter((t) => t.status === 'pending' &&
+        t.notBefore <= now &&
+        t.deadline > now &&
+        t.attempts < attemptCap(t) &&
+        owns(t));
+}
+/** Tasks that ran out of attempts or TTL — the sender must be told, not ghosted. */
+export function expiredTasks(now = Date.now(), owns = () => true) {
+    return loadDeferredTasks().filter((t) => t.status === 'pending' && (t.deadline <= now || t.attempts >= attemptCap(t)) && owns(t));
+}
+/**
+ * The sender said yes: extend this task to the full horizon and keep going.
+ * Returns the confirmed task (or undefined when it had already expired).
+ */
+export function confirmTask(id, now = Date.now()) {
+    const tasks = loadDeferredTasks();
+    const task = tasks.find((t) => t.id === id);
+    if (!task)
+        return undefined;
+    task.confirmed = true;
+    task.status = 'pending';
+    task.deadline = Math.max(task.deadline, now + DEFERRED_TASK_TTL_MS);
+    writeDeferredTasks(tasks);
+    return task;
+}
+/** Apply a partial patch to one task by id. Returns the patched task. */
+export function updateDeferredTask(id, patch) {
+    const tasks = loadDeferredTasks();
+    const task = tasks.find((t) => t.id === id);
+    if (!task)
+        return undefined;
+    Object.assign(task, patch);
+    writeDeferredTasks(tasks);
+    return task;
+}
+/** Drop a task (on success, on a cancel reply, or when it expires). */
+export function removeDeferredTask(id) {
+    writeDeferredTasks(loadDeferredTasks().filter((t) => t.id !== id));
+}
+/** Drop every task for a conversation (`stop`, `no`, `cancel`). */
+export function cancelTasksFor(platform, channelId) {
+    const key = conversationKey(platform, channelId);
+    const tasks = loadDeferredTasks();
+    const kept = tasks.filter((t) => conversationKey(t.platform, t.channelId) !== key);
+    if (kept.length !== tasks.length)
+        writeDeferredTasks(kept);
+    return tasks.length - kept.length;
+}
+// ─── "yes" / "no" recognition ───────────────────────────────────────────────
+/**
+ * Phrases that ACCEPT the retry offer. Whole-message matches only — the gates
+ * below make the matcher conservative because a wrong verdict here swallows a
+ * real request, which is exactly the class of bug this queue exists to fix.
+ */
+const ACCEPT_PHRASES = new Set([
+    'yes',
+    'y',
+    'yep',
+    'yeah',
+    'yup',
+    'ya',
+    'yaa',
+    'ok',
+    'okay',
+    'k',
+    'sure',
+    'definitely',
+    'please do',
+    'do it',
+    'go ahead',
+    'go on',
+    'go for it',
+    'keep trying',
+    'keep going',
+    'keep trying please',
+    'try again',
+    'retry',
+    'please retry',
+    'haan',
+    'ha',
+    'han',
+    'theek hai',
+    'chalega',
+    'yes please',
+    'yes please do',
+    'please keep trying',
+    'sure please',
+    'ok please',
+    'continue',
+    'continue please',
+]);
+/** Phrases that DECLINE / cancel the offer. */
+const DECLINE_PHRASES = new Set([
+    'no',
+    'n',
+    'nope',
+    'nah',
+    'nahi',
+    'stop',
+    'stop it',
+    'cancel',
+    'cancel it',
+    'forget it',
+    'never mind',
+    'nevermind',
+    'leave it',
+    'no thanks',
+    'no thank you',
+    'dont',
+    "don't",
+    'do not',
+    'nahi chahiye',
+]);
+/** An acceptance token embedded in a short reply ("yes, please keep trying"). */
+const ACCEPT_TOKEN_RE = /\b(?:yes|yep|yeah|yup|sure|ok|okay|haan|please do|go ahead|go on|keep trying|keep going|try again|retry|continue|theek hai)\b/;
+/**
+ * Words allowed to accompany an accept token. This is what separates
+ * "yes, please keep trying" (an acceptance) from "yes I also want a website"
+ * (a NEW request that merely starts with yes) — the second contains words that
+ * are not filler, so it is handled normally instead of being swallowed.
+ * Losing a user's real request to a thumbs-up heuristic is exactly the class of
+ * bug this queue exists to fix, so the check is word-by-word strict.
+ */
+const ACCEPT_FILLER = new Set([
+    'yes', 'yep', 'yeah', 'yup', 'ya', 'sure', 'ok', 'okay', 'k', 'please', 'pls',
+    'thanks', 'thank', 'you', 'keep', 'trying', 'going', 'go', 'ahead', 'on',
+    'do', 'it', 'now', 'try', 'again', 'retry', 'continue', 'haan', 'han', 'yaa',
+    'theek', 'hai', 'chalega', 'much', 'so', 'and', 'that', 'this', 'for', 'to',
+]);
+const DECLINE_TOKEN_RE = /\b(?:no|nope|nah|nahi|stop|cancel|forget it|never ?mind|leave it|don'?t)\b/;
+/** True when the message is ONLY punctuation/whitespace/emoji. */
+const NON_WORD_ONLY_RE = /^[^\p{L}\p{N}]+$/u;
+/**
+ * Emoji-only replies that unambiguously accept: 👍 🙌 👌 ✅ 🆗.
+ * A bare thumbs-up is how most messaging users say "yes", so it must not fall
+ * through to normal handling as punctuation — while an unrelated emoji (❤️, 😂)
+ * still does, since those are not answers.
+ */
+const ACCEPT_EMOJI_RE = /[\u{1F44D}\u{1F44C}\u{1F64C}\u{2705}\u{1F197}]/u;
+/**
+ * Normalize a reply for phrase matching: lowercase, emoji/punctuation stripped,
+ * whitespace collapsed. `"Yes, please! 🙏"` → `"yes please"`.
+ */
+export function normalizeRetryAnswer(text) {
+    return String(text ?? '')
+        .toLowerCase()
+        .replace(/[^\p{L}\p{N}\s]/gu, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/**
+ * Is this message the sender ACCEPTING the retry offer?
+ *
+ * Two gates, both required:
+ *  1. the whole message must be short (≤ 6 words) — anything longer is a new
+ *     request that merely happens to start with "yes", and swallowing it would
+ *     lose the user's actual ask;
+ *  2. it must be an exact accept phrase, or a short message carrying an accept
+ *     token and NO decline token ("yes, keep trying" accepts; "no, do the
+ *     other thing" does not).
+ *
+ * A message that fails either gate falls through to normal handling — the
+ * pending task simply stays queued, so the sender can accept later.
+ */
+export function isRetryAcceptance(text) {
+    const raw = String(text ?? '').trim();
+    if (!raw)
+        return false;
+    if (NON_WORD_ONLY_RE.test(raw))
+        return ACCEPT_EMOJI_RE.test(raw);
+    const n = normalizeRetryAnswer(raw);
+    if (!n)
+        return false;
+    if (DECLINE_TOKEN_RE.test(n))
+        return false;
+    if (ACCEPT_PHRASES.has(n))
+        return true;
+    const words = n.split(' ').filter(Boolean);
+    if (words.length > 6)
+        return false;
+    if (!ACCEPT_TOKEN_RE.test(n))
+        return false;
+    // Every other word must be filler: see ACCEPT_FILLER.
+    return words.every((w) => ACCEPT_FILLER.has(w) || ACCEPT_TOKEN_RE.test(w));
+}
+/** Is this message the sender cancelling the retry offer? */
+export function isRetryDecline(text) {
+    const raw = String(text ?? '').trim();
+    if (!raw || NON_WORD_ONLY_RE.test(raw))
+        return false;
+    const n = normalizeRetryAnswer(raw);
+    if (!n)
+        return false;
+    if (DECLINE_PHRASES.has(n))
+        return true;
+    const words = n.split(' ').filter(Boolean);
+    // TWO words, max. "no, don't send it to her" is a different request that
+    // happens to contain a decline token — treating it as "cancel" would drop the
+    // user's actual instruction as well as their task.
+    if (words.length > 2)
+        return false;
+    // A decline must not carry an accept token: "no, keep trying" is ambiguous,
+    // and guessing wrong CANCELS work the user asked to continue.
+    if (ACCEPT_TOKEN_RE.test(n))
+        return false;
+    return DECLINE_TOKEN_RE.test(n);
+}
+// ─── Sender-facing lines ────────────────────────────────────────────────────
+/** Confirmation sent the moment an offer is accepted. */
+export function acceptedLine(task, now = Date.now()) {
+    const wait = Math.max(0, task.notBefore - now);
+    const when = wait > 60_000 ? `in about ${Math.round(wait / 60_000)}m` : 'shortly';
+    return (`👍 Understood — I'll keep trying and message you here the moment it's done.\n` +
+        `Next attempt ${when}. Reply *stop* to cancel.`);
+}
+/** The line sent when a retry gives up (TTL or attempt cap reached). */
+export function abandonedLine(task, now = Date.now()) {
+    const mins = Math.max(1, Math.round((now - task.createdAt) / 60_000));
+    const span = mins >= 90 ? `about ${Math.round(mins / 60)}h` : `about ${mins}m`;
+    const tries = `${task.attempts} attempt${task.attempts === 1 ? '' : 's'}`;
+    if (!task.confirmed) {
+        // Honest about WHY it stopped: the sender never confirmed, so this is a
+        // courtesy report, not a broken promise.
+        return (`😔 "${task.text.slice(0, 90)}" still couldn't run — I tried again ${tries} over ${span} and no model came back. ` +
+            `I've stopped. Reply *yes* if you want me to keep checking and run it the moment one is free.`);
+    }
+    return (`😔 I kept retrying "${task.text.slice(0, 90)}" for ${span} (${tries}) and no model became available. ` +
+        `I've stopped rather than hold your request forever. Say *retry* any time and I'll start again.`);
+}
+/** The line sent when a retry attempt starts, so an unexpected reply is explained. */
+export function retryingLine(task) {
+    const cap = attemptCap(task);
+    return `🔁 Trying again now (attempt ${task.attempts} of at most ${cap}) — you asked for: "${task.text.slice(0, 80)}"`;
+}
+/** Count of live tasks (status surfaces / dashboard). */
+export function pendingTaskCount() {
+    return loadDeferredTasks().length;
+}
+//# sourceMappingURL=deferred-task.js.map

package/dist/learning/deferred-task.js.map

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

package/dist/learning/deliverable-class.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Deliverable classification — what KIND of thing did the user actually ask
+ * for? (enterprise-grade hardening, G7.)
+ *
+ * WHY THIS EXISTS (the WhatsApp story audit):
+ * A user asked, over WhatsApp, for a 100-page Harry-Potter-style story as a
+ * PDF. Six orchestrator runs over 32 minutes ALL failed, and the reason was
+ * not model availability (507 models were eligible). The reasoner — the
+ * technical-decision layer that runs BEFORE the planner — read "write a story"
+ * and emitted:
+ *
+ *   {"language":"python","framework":"none","deliverable":"markdown_file",
+ *    "reasoning":"…a Python script is the most efficient way to read existing
+ *                 chapters, process the outline, and update the target file…"}
+ *
+ * The planner then produced ZERO prose steps: step-02 was "Create a Python
+ * script to append the story continuation", step-03 "Run the Python script".
+ * The agent built a TOOL to write the story instead of writing the story, and
+ * because the tool-creation step itself failed, nothing was written at all —
+ * the target directory did not exist afterwards.
+ *
+ * The decision layer had no vocabulary for authored work: every branch of its
+ * taxonomy (language/framework/buildCommand/architecture/deliverable) assumes
+ * the deliverable is a PROGRAM. So a creative ask could only ever be expressed
+ * as a program that emits the creative artifact.
+ *
+ * This module is the missing vocabulary. It is deliberately DETERMINISTIC and
+ * LLM-free — the classifier is a safety net that the LLM's own decision is
+ * checked against, so a weak model cannot reintroduce the category error. It
+ * runs on the raw goal before planning, and for `document`/`creative` the
+ * orchestrator plans SECTIONS instead of a program.
+ */
+/**
+ * The five kinds of work the planner knows how to plan.
+ *
+ * `code` is the historical default and keeps every software ask on its
+ * existing path — this module must never change how a code task is planned.
+ */
+export type DeliverableClass = 'code' | 'document' | 'creative' | 'data' | 'research';
+/**
+ * What a deliverable is physically MADE OF.
+ *
+ * Added for the hybrid asks: "develop a web based book which might require
+ * Python for voice assistance or interactiveness" is not one thing — it is
+ * prose + a web experience + (optionally) a Python narration service. A single
+ * `class` cannot express that, and forcing a choice is how the original audit
+ * produced a Python script instead of a story: the taxonomy only had room for
+ * one answer, and it picked the program.
+ */
+export type Substrate = 'prose' | 'web' | 'python' | 'asset' | 'data';
+/** The result of classifying a goal. */
+export interface DeliverableVerdict {
+    /** The winning class. */
+    class: DeliverableClass;
+    /** 0–1. Below `AUTHORED_CONFIDENCE_FLOOR` the caller should not override the LLM. */
+    confidence: number;
+    /** Which words drove the decision (auditable, shown in logs/traces). */
+    signals: string[];
+    /**
+     * True when the deliverable IS authored content (prose), as opposed to a
+     * program/library that manipulates it. This is the flag that switches the
+     * pipeline from "plan code steps" to "plan sections".
+     */
+    authored: boolean;
+    /**
+     * Ordered materials, primary first. A plain story is `['prose']`; an
+     * interactive web book is `['web', 'prose']` (+ `'python'` when a narration
+     * service was asked for). Always at least one entry.
+     */
+    substrates: Substrate[];
+    /**
+     * True when the deliverable is MORE THAN ONE thing joined — a book AND the
+     * site that presents it. Composite asks need a PHASED plan (scaffold first,
+     * then the content, then the experience layer), not a single-mode plan.
+     */
+    composite: boolean;
+    /**
+     * True when the deliverable must be experienced, not just read: a site to
+     * navigate, narration to play, chapters to flip through. Drives the
+     * interactivity phase and the end-to-end verification step.
+     */
+    interactive: boolean;
+}
+/**
+ * Below this the verdict is a hint, not a ruling: the caller keeps the LLM's
+ * own decision. Set high enough that a passing mention ("write a report about
+ * the API I built") cannot hijack a genuine engineering task.
+ */
+export declare const AUTHORED_CONFIDENCE_FLOOR = 0.55;
+/**
+ * Classify a goal into a deliverable class.
+ *
+ * Scoring is additive with per-signal weights rather than first-match, so a
+ * goal that mixes signals ("write a story AND package it as a CLI") resolves
+ * on the balance of evidence. Confidence is derived from the winning margin,
+ * so a clear call scores high and a coin-flip stays low — which is exactly
+ * what the caller needs to decide whether to override the LLM.
+ *
+ * Defaults to `code` when nothing matches: that preserves today's behaviour
+ * for every goal this module does not understand.
+ */
+export declare function classifyDeliverable(goal: string): DeliverableVerdict;
+/**
+ * Convenience: is this goal asking for authored content (prose) rather than a
+ * program? The orchestrator uses this one predicate to switch planning modes.
+ */
+export declare function isAuthoredGoal(goal: string): boolean;
+/**
+ * Is this a HYBRID deliverable — content plus a way to experience it?
+ *
+ * The orchestrator uses this one predicate to switch from "plan the content" to
+ * "plan the phases" (scaffold → content → experience → assets → verify). Kept
+ * here rather than in the planner so the intent vocabulary lives in one place.
+ */
+export declare function isCompositeGoal(goal: string): boolean;
+/** Human-readable substrate list, for logs, traces and prompts. */
+export declare function describeSubstrates(verdict: DeliverableVerdict): string;
+/** Human-readable label for logs, traces and prompts. */
+export declare function deliverableClassLabel(cls: DeliverableClass): string;
+/**
+ * The instruction handed to the reasoner so its technical-decision document
+ * stops pretending an authored ask is a program.
+ *
+ * This is the fix for the exact reasoning string the audit captured
+ * ("a Python script is the most efficient way to…"): the reasoner is told, in
+ * its own JSON vocabulary, that `language` must NOT be a programming language
+ * for these classes, and that building a generator is the wrong deliverable.
+ */
+export declare function authoredDeliverableGuidance(cls: DeliverableClass, substrates?: Substrate[]): string;
+//# sourceMappingURL=deliverable-class.d.ts.map

package/dist/learning/deliverable-class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliverable-class.d.ts","sourceRoot":"","sources":["../../src/learning/deliverable-class.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAIH;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,CAAC;AAEtF;;;;;;;;;GASG;AACH,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAEtE,wCAAwC;AACxC,MAAM,WAAW,kBAAkB;IACjC,yBAAyB;IACzB,KAAK,EAAE,gBAAgB,CAAC;IACxB,qFAAqF;IACrF,UAAU,EAAE,MAAM,CAAC;IACnB,wEAAwE;IACxE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;OAIG;IACH,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB;;;;OAIG;IACH,SAAS,EAAE,OAAO,CAAC;IACnB;;;;OAIG;IACH,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,OAAO,CAAC;AAiI9C;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAqFpE;AA0FD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,mEAAmE;AACnE,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM,CAEtE;AAED,yDAAyD;AACzD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,CAanE;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,gBAAgB,EAAE,UAAU,CAAC,EAAE,SAAS,EAAE,GAAG,MAAM,CA0BnG"}