funolio-agent 1.0.53 → 1.1.65

package/dist/orchestration/dispatch-executor.js

@@ -0,0 +1,266 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeReplyDirectly = executeReplyDirectly;
+exports.executeDelegateSingle = executeDelegateSingle;
+exports.executeCreateWorkflow = executeCreateWorkflow;
+/**
+ * Orchestration dispatch executor (Phase A — dead code).
+ *
+ * Takes validated dispatch tool-call arguments (see dispatch-tools.ts) and
+ * performs the side effects: creating TODOs in the local DB, or returning
+ * the reply_directly text to the caller.
+ *
+ * Not yet wired to the live orchestrator turn loop — that's the Step-5
+ * wire-up work gated behind the feature flag from Decision 6.
+ *
+ * KEY BEHAVIORS (per orchestration-plan.txt):
+ *   - reply_directly: no side effects, just returns the text.
+ *   - delegate_single: creates exactly one TODO owned by the target bot.
+ *       * bot_name wins over role when both provided.
+ *       * role is stored on the TODO as informational metadata.
+ *       * When only role is given, resolveBotForRole() picks the bot.
+ *   - create_workflow: creates N TODOs in order, linking each to the next
+ *       via next_worker_bot_id / next_worker_name / next_worker_role so
+ *       the existing workflow-engine plumbing picks up the chain.
+ *       * handoff_to_next is appended to the NEXT step's task prompt as
+ *         the "[PREVIOUS WORKER HANDOFF]" section the worker-operating-
+ *         prompt already supports.
+ *
+ * All executor functions return a structured result describing what was
+ * created. Callers (the orchestrator turn loop, once wired) use the result
+ * to surface TODO IDs back to the user and to start workflow execution.
+ */
+const data = __importStar(require("../local-data"));
+const dispatch_tools_1 = require("./dispatch-tools");
+const capabilities_1 = require("./capabilities");
+/**
+ * Compose a worker task prompt from the orchestrator's task_instructions
+ * and the original user prompt, following the same position-aware rule
+ * enforced by the legacy path's shouldIncludeOriginalPromptForWorker:
+ *   - If the worker is first in the chain: always include.
+ *   - Otherwise: include only if the worker's
+ *     orchestration_include_user_prompt flag is set.
+ * The appended block uses the same "Original user request (reference
+ * only):" header the legacy path uses, so worker prompts look the
+ * same regardless of which dispatch path created them.
+ */
+function composeTaskPrompt(instructions, userPrompt, worker, isFirstInChain, recentContext, nextWorker) {
+    const shouldAppend = isFirstInChain || Number(worker.orchestration_include_user_prompt) === 1;
+    const parts = [['YOUR TASK', instructions.trim()].filter(Boolean).join('\n')];
+    if (nextWorker?.name) {
+        const roleLabel = nextWorker.role ? ` (${nextWorker.role})` : '';
+        parts.push([
+            'NEXT WORKER',
+            `After you complete this task, ${nextWorker.name}${roleLabel} receives your handoff.`,
+        ].join('\n'));
+        parts.push([
+            'HANDOFF REQUIREMENTS',
+            'When calling complete_worker_task, write handoff_prompt as the next worker prompt. Include the goal, artifact/path, current issue or result, exact scope, constraints, and acceptance checks. Do not create a new TODO unless the orchestrator explicitly asked you to.',
+        ].join('\n'));
+    }
+    if (isFirstInChain && recentContext?.trim()) {
+        parts.push(`Recent conversation context:\n${recentContext.trim()}`);
+    }
+    if (shouldAppend && userPrompt.trim()) {
+        parts.push(`Original user request:\n${userPrompt}`);
+    }
+    return parts.filter(Boolean).join('\n\n');
+}
+// -----------------------------------------------------------------------------
+// Bot lookup helpers
+// -----------------------------------------------------------------------------
+function findBotByName(name, bots) {
+    const needle = name.trim().toLowerCase();
+    if (!needle)
+        return null;
+    for (const bot of bots) {
+        if (bot.name.trim().toLowerCase() === needle)
+            return bot;
+    }
+    return null;
+}
+function resolveStepBot(args, ctx) {
+    const hasBot = typeof args.bot_name === 'string' && args.bot_name.trim().length > 0;
+    const hasRole = typeof args.role === 'string' && args.role.trim().length > 0;
+    if (hasBot) {
+        const bot = findBotByName(args.bot_name, ctx.resolution.activeBots);
+        if (!bot)
+            return { ok: false, error: `bot_name "${args.bot_name}" not found in conversation roster.` };
+        return { ok: true, bot };
+    }
+    if (hasRole) {
+        const bot = (0, dispatch_tools_1.resolveBotForRole)(args.role, ctx.resolution);
+        if (!bot)
+            return { ok: false, error: `no active bot has role "${args.role}" in its priority list.` };
+        return { ok: true, bot };
+    }
+    return { ok: false, error: 'neither bot_name nor role provided (this should have been caught by validation).' };
+}
+// -----------------------------------------------------------------------------
+// Executors
+// -----------------------------------------------------------------------------
+function executeReplyDirectly(args) {
+    return { kind: 'reply_directly', text: args.text };
+}
+function executeDelegateSingle(args, ctx) {
+    const resolved = resolveStepBot(args, ctx);
+    if (!resolved.ok)
+        return { kind: 'error', error: resolved.error };
+    const bot = resolved.bot;
+    // A single delegate has no predecessor, so the worker is first in
+    // chain and always receives the original user prompt per the policy.
+    const composedPrompt = composeTaskPrompt(args.task_instructions, ctx.userPrompt, bot, true, ctx.recentContext);
+    const task = data.addTodoTask({
+        projectId: ctx.projectId,
+        conversationId: ctx.conversationId,
+        title: buildTaskTitle(bot.name, args.role, args.task_instructions, args.title),
+        details: `Task dispatched by orchestrator ${ctx.orchestratorActor.name}.`,
+        participants: [bot.name],
+        successCriteria: args.success_criteria || deriveDefaultSuccessCriteria(args.task_instructions),
+        ownerBotId: bot.id,
+        ownerName: bot.name,
+        taskType: inferTaskType(args.role, bot),
+        profileName: bot.name,
+        taskPrompt: composedPrompt,
+        actor: { actorType: 'orchestrator', actorId: ctx.orchestratorActor.actorId },
+    });
+    return { kind: 'delegate_single', task, assignedBot: bot };
+}
+function executeCreateWorkflow(args, ctx) {
+    // Resolve every step's bot up front. If any fail to resolve, reject the whole
+    // workflow before creating any TODOs. Avoids partial state.
+    const resolvedBots = [];
+    for (let i = 0; i < args.steps.length; i += 1) {
+        const step = args.steps[i];
+        const r = resolveStepBot(step, ctx);
+        if (!r.ok)
+            return { kind: 'error', error: `Step ${i + 1}: ${r.error}` };
+        resolvedBots.push(r.bot);
+    }
+    const tasks = [];
+    for (let i = 0; i < args.steps.length; i += 1) {
+        const step = args.steps[i];
+        const owner = resolvedBots[i];
+        const next = resolvedBots[i + 1] || null;
+        const nextStep = args.steps[i + 1] || null;
+        let taskPrompt = step.task_instructions;
+        // Weave prior step's handoff_to_next into THIS step's task prompt so the
+        // worker sees it. Uses the "[PREVIOUS WORKER HANDOFF]" header that
+        // worker-operating-prompt.ts already recognizes.
+        const priorStep = args.steps[i - 1];
+        if (priorStep?.handoff_to_next && priorStep.handoff_to_next.trim()) {
+            taskPrompt = `[PREVIOUS WORKER HANDOFF]\n${priorStep.handoff_to_next.trim()}\n\n${taskPrompt}`;
+        }
+        // Position-aware include_user_prompt policy, same as the legacy
+        // workflow-template path: step 0 is first in chain → always gets
+        // the user prompt; steps 1..N-1 honor the per-bot flag.
+        const isFirstInChain = i === 0;
+        taskPrompt = composeTaskPrompt(taskPrompt, ctx.userPrompt, owner, isFirstInChain, ctx.recentContext, next ? { name: next.name, role: nextStep?.role || data.getAgentOrchestrationRoleLabel(next) } : null);
+        const task = data.addTodoTask({
+            projectId: ctx.projectId,
+            conversationId: ctx.conversationId,
+            title: buildTaskTitle(owner.name, step.role, step.task_instructions, step.title),
+            details: ctx.workflowSourceLabel
+                ? `${ctx.workflowSourceLabel} step ${i + 1} of ${args.steps.length} prepared by ${ctx.orchestratorActor.name}.`
+                : `Workflow step ${i + 1} of ${args.steps.length} dispatched by orchestrator ${ctx.orchestratorActor.name}.`,
+            participants: [owner.name],
+            successCriteria: step.success_criteria || deriveDefaultSuccessCriteria(step.task_instructions),
+            ownerBotId: owner.id,
+            ownerName: owner.name,
+            taskType: inferTaskType(step.role, owner),
+            profileName: owner.name,
+            nextWorkerBotId: next?.id || null,
+            nextWorkerName: next?.name || null,
+            nextWorkerRole: next ? (nextStep?.role || data.getAgentOrchestrationRoleLabel(next)) : null,
+            taskPrompt,
+            actor: { actorType: 'orchestrator', actorId: ctx.orchestratorActor.actorId },
+        });
+        tasks.push(task);
+    }
+    return { kind: 'create_workflow', tasks, assignedBots: resolvedBots };
+}
+// -----------------------------------------------------------------------------
+// Small helpers
+// -----------------------------------------------------------------------------
+function buildTaskTitle(botName, role, taskInstructions, explicitTitle) {
+    const rawTitle = String(explicitTitle || '').trim();
+    const summary = (rawTitle || taskInstructions).trim().replace(/\s+/g, ' ').slice(0, 96);
+    const title = summary || 'Assigned task';
+    if (title.toLowerCase().startsWith(`${botName.toLowerCase()}:`))
+        return title;
+    const roleLabel = !rawTitle && role && role.trim() ? ` (${role.trim()})` : '';
+    return `${botName}${roleLabel}: ${title}`;
+}
+/**
+ * Derive a default success criteria when the LLM doesn't provide one.
+ * The DB's orchestrator path requires a non-empty successCriteria, so we
+ * synthesize a short version from the task instructions rather than
+ * forcing the orchestrator LLM to articulate criteria for trivial tasks.
+ */
+function deriveDefaultSuccessCriteria(taskInstructions) {
+    const trimmed = taskInstructions.trim().replace(/\s+/g, ' ');
+    const brief = trimmed.length > 200 ? `${trimmed.slice(0, 197)}...` : trimmed;
+    return `Task completed as specified: ${brief}`;
+}
+function inferTaskType(role, bot) {
+    const inferred = (0, capabilities_1.inferTaskTypeFromCapabilities)(role, data.getAgentRolePriorities(bot), 'coding');
+    if (inferred !== 'coding' || !role)
+        return inferred;
+    const fromRole = (role || '').trim().toLowerCase();
+    if (fromRole === 'qa' || fromRole === 'review')
+        return 'qa';
+    if (fromRole === 'research' || fromRole === 'brainstorm' || fromRole === 'planning')
+        return 'research';
+    if (fromRole === 'verify' || fromRole === 'verification')
+        return 'verify';
+    if (fromRole === 'deploy' || fromRole === 'deployment')
+        return 'deploy';
+    if (fromRole === 'coding' || fromRole === 'code')
+        return 'coding';
+    // Fall back to the bot's first priority role (normalized), else 'coding' as neutral default.
+    const primaries = data.getAgentRolePriorities(bot);
+    const primary = (primaries[0] || '').trim().toLowerCase();
+    if (primary === 'qa' || primary === 'review' || primary === 'quality assurance')
+        return 'qa';
+    if (primary === 'research' || primary === 'brainstorm' || primary === 'planning')
+        return 'research';
+    if (primary === 'verify' || primary === 'verification')
+        return 'verify';
+    if (primary === 'deploy' || primary === 'deployment')
+        return 'deploy';
+    return 'coding';
+}
+//# sourceMappingURL=dispatch-executor.js.map

package/dist/orchestration/dispatch-executor.js.map

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

package/dist/orchestration/dispatch-hint.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Orchestration dispatch hint builder (Phase A — dead code).
+ *
+ * Per orchestration-plan.txt Decision 5, the orchestrator LLM receives a
+ * structured JSON context block every turn. This module is a PURE function
+ * that produces that block from conversation + bot + project state.
+ *
+ * Two tiers:
+ *   - Tier 1 (essential facts):  user_prompt, conversation, available_bots,
+ *                                existing_todos, effective_policy
+ *   - Tier 2 (advisory hints):   candidate_roles_detected, candidate_bots,
+ *                                suggested_mode, reasoning
+ *
+ * Tier 2 replaces what the regex dispatchers used to do AUTHORITATIVELY.
+ * Now it is ADVISORY — the LLM can accept, override, or ignore it.
+ *
+ * Implementation guardrails (Codex 2026-04-18 review):
+ *   - Hint size is bounded (Guardrail #5). TODO count caps, per-field char
+ *     caps, recent_summary + effective_policy length caps.
+ *   - Advisory helpers are PURE — they accept inputs and return data; no
+ *     side effects, no class dependencies. Easy to unit-test in isolation.
+ *   - `project_folder` is INCLUDED by design (Decision 5); callers running
+ *     through an API provider should treat this as documented behavior.
+ */
+import * as data from '../local-data';
+export declare const HINT_BUDGETS: {
+    readonly MAX_TODOS: 30;
+    readonly MAX_TODO_TITLE_CHARS: 200;
+    readonly MAX_TODO_DETAILS_CHARS: 200;
+    readonly MAX_RECENT_SUMMARY_CHARS: 2000;
+    readonly MAX_RECENT_TURNS_CHARS: 6000;
+    readonly MAX_EFFECTIVE_POLICY_CHARS: 1000;
+};
+export interface HintBotEntry {
+    name: string;
+    provider: string;
+    model: string | null;
+    role_priorities: string[];
+    is_active: boolean;
+}
+export interface HintTodoEntry {
+    id: string;
+    owner: string | null;
+    title: string;
+    status: string | null;
+}
+export interface HintSelectedWorkflowTemplate {
+    id: string;
+    name: string;
+    description: string | null;
+    steps: Array<{
+        index: number;
+        bot_name: string;
+        role_priorities: string[];
+        saved_instruction: string | null;
+        is_checkpoint: boolean;
+    }>;
+}
+export interface HintCandidateWorkflowPlan {
+    source: 'selected_workflow_template' | 'named_workflow_template' | 'explicit_bot_sequence';
+    reason: string;
+    steps: Array<{
+        index: number;
+        bot_name: string;
+        role_priorities: string[];
+        suggested_role: string | null;
+        confidence?: 'low' | 'medium' | 'high';
+        reason?: string;
+    }>;
+}
+export interface HintConversation {
+    id: string;
+    title: string | null;
+    topic_id: string | null;
+    project_name: string | null;
+    project_folder: string | null;
+    turn_count: number;
+    recent_summary: string | null;
+    recent_turns: string | null;
+    bootstrap_history_file: string | null;
+}
+export interface AdvisoryBlock {
+    candidate_roles_detected: string[];
+    candidate_bots_mentioned_by_name: string[];
+    suggested_mode: 'reply_directly' | 'delegate_single' | 'create_workflow';
+    reasoning: string;
+}
+export interface PlanExecutionIntent {
+    mode: 'none' | 'per_step_todos' | 'per_step_workflow';
+    requires_file_read_before_dispatch: boolean;
+    mentioned_bots: string[];
+    candidate_roles: string[];
+    reasoning: string;
+}
+export interface DispatchHint {
+    user_prompt: string;
+    conversation: HintConversation;
+    available_bots: HintBotEntry[];
+    selected_workflow_template: HintSelectedWorkflowTemplate | null;
+    candidate_workflow_plan: HintCandidateWorkflowPlan | null;
+    plan_execution_intent: PlanExecutionIntent;
+    existing_todos: HintTodoEntry[];
+    todos_truncated: boolean;
+    effective_policy: string | null;
+    advisory: AdvisoryBlock;
+}
+export interface BuildHintInput {
+    userPrompt: string;
+    conversation: {
+        id: string;
+        title: string | null;
+        topic_id?: string | null;
+        project_name: string | null;
+        project_folder: string | null;
+        turn_count: number;
+        recent_summary: string | null;
+        recent_turns?: string | null;
+        bootstrap_history_file?: string | null;
+    };
+    activeBots: data.AgentProfileRow[];
+    selectedWorkflowTemplate?: HintSelectedWorkflowTemplate | null;
+    candidateWorkflowPlan?: HintCandidateWorkflowPlan | null;
+    existingTodos: Array<{
+        id: string | number;
+        owner_name: string | null;
+        title: string;
+        status: string | null;
+    }>;
+    effectivePolicyText: string | null;
+}
+export declare function buildDispatchHint(input: BuildHintInput): DispatchHint;
+export declare function computePlanExecutionIntent(userPrompt: string, bots: HintBotEntry[]): PlanExecutionIntent;
+export declare function computeAdvisory(userPrompt: string, bots: HintBotEntry[], precomputedPlanIntent?: PlanExecutionIntent): AdvisoryBlock;
+//# sourceMappingURL=dispatch-hint.d.ts.map

package/dist/orchestration/dispatch-hint.d.ts.map

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

package/dist/orchestration/dispatch-hint.js

@@ -0,0 +1,247 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HINT_BUDGETS = void 0;
+exports.buildDispatchHint = buildDispatchHint;
+exports.computePlanExecutionIntent = computePlanExecutionIntent;
+exports.computeAdvisory = computeAdvisory;
+const local_data_1 = require("../local-data");
+// -----------------------------------------------------------------------------
+// Budgets (per Guardrail #5)
+// -----------------------------------------------------------------------------
+exports.HINT_BUDGETS = {
+    MAX_TODOS: 30,
+    MAX_TODO_TITLE_CHARS: 200,
+    MAX_TODO_DETAILS_CHARS: 200,
+    MAX_RECENT_SUMMARY_CHARS: 2000,
+    MAX_RECENT_TURNS_CHARS: 6000,
+    MAX_EFFECTIVE_POLICY_CHARS: 1000,
+};
+function truncate(text, max) {
+    if (text == null)
+        return null;
+    const s = String(text);
+    if (s.length <= max)
+        return s;
+    return s.slice(0, Math.max(0, max - 1)).trimEnd() + '…';
+}
+function toHintBot(bot) {
+    return {
+        name: bot.name,
+        provider: bot.provider,
+        model: bot.model || null,
+        role_priorities: (0, local_data_1.getAgentRolePriorities)(bot),
+        is_active: bot.is_active === 1,
+    };
+}
+function toHintTodo(t) {
+    return {
+        id: String(t.id),
+        owner: t.owner_name || null,
+        title: truncate(t.title, exports.HINT_BUDGETS.MAX_TODO_TITLE_CHARS) || '',
+        status: t.status || null,
+    };
+}
+function buildDispatchHint(input) {
+    const todosCapped = input.existingTodos.slice(0, exports.HINT_BUDGETS.MAX_TODOS);
+    const todosTruncated = input.existingTodos.length > exports.HINT_BUDGETS.MAX_TODOS;
+    const availableBots = input.activeBots.filter((b) => b.is_active === 1).map(toHintBot);
+    const planExecutionIntent = computePlanExecutionIntent(input.userPrompt, availableBots);
+    const advisory = computeAdvisory(input.userPrompt, availableBots, planExecutionIntent);
+    return {
+        user_prompt: input.userPrompt,
+        conversation: {
+            id: input.conversation.id,
+            title: input.conversation.title,
+            topic_id: input.conversation.topic_id ?? null,
+            project_name: input.conversation.project_name,
+            project_folder: input.conversation.project_folder,
+            turn_count: input.conversation.turn_count,
+            recent_summary: truncate(input.conversation.recent_summary, exports.HINT_BUDGETS.MAX_RECENT_SUMMARY_CHARS),
+            recent_turns: truncate(input.conversation.recent_turns, exports.HINT_BUDGETS.MAX_RECENT_TURNS_CHARS),
+            bootstrap_history_file: input.conversation.bootstrap_history_file || null,
+        },
+        available_bots: availableBots,
+        selected_workflow_template: input.selectedWorkflowTemplate || null,
+        candidate_workflow_plan: input.candidateWorkflowPlan || null,
+        plan_execution_intent: planExecutionIntent,
+        existing_todos: todosCapped.map(toHintTodo),
+        todos_truncated: todosTruncated,
+        effective_policy: truncate(input.effectivePolicyText, exports.HINT_BUDGETS.MAX_EFFECTIVE_POLICY_CHARS),
+        advisory,
+    };
+}
+// -----------------------------------------------------------------------------
+// Advisory computation (replaces the OLD dispatchers as a hint, not a decision)
+// -----------------------------------------------------------------------------
+/**
+ * Detects likely roles in a user prompt using simple keyword patterns.
+ * The set of candidates is derived from the actual roles configured on the
+ * current bot roster — so this adapts to any domain (software, legal,
+ * medical, etc.) without a hardcoded list.
+ */
+function detectCandidateRoles(userPrompt, bots) {
+    const normalizedPrompt = userPrompt.toLowerCase();
+    const seen = new Set();
+    const result = [];
+    for (const bot of bots) {
+        for (const role of bot.role_priorities) {
+            const key = role.trim().toLowerCase();
+            if (!key || seen.has(key))
+                continue;
+            // Match if the role word (or its first meaningful token) appears in the prompt.
+            // Uses word-boundary regex with case-insensitive match to avoid sub-word hits.
+            const rolePattern = new RegExp(`\\b${key.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\$&')}\\b`, 'i');
+            if (rolePattern.test(userPrompt) || rolePattern.test(normalizedPrompt)) {
+                seen.add(key);
+                result.push(role);
+            }
+        }
+    }
+    // Also detect common role keywords the user might mention even if no bot has
+    // them listed — the LLM can still use these as hints.
+    // verify/validate kept DISTINCT from qa (Codex QA 2026-04-18, finding #5).
+    // Collapsing them was the original bug the refactor was supposed to fix.
+    const commonKeywords = [
+        { word: /\b(prompt builder|prompt building|user prompt|rewrite prompt|better prompt)\b/i, label: 'Prompt Building' },
+        { word: /\b(code|coding|build|implement|create|write|develop)\b/i, label: 'coding' },
+        { word: /\b(qa|review|test|testing|audit)\b/i, label: 'qa' },
+        { word: /\b(verify|verification|validate|validation)\b/i, label: 'verify' },
+        { word: /\b(research|investigate|analy[sz]e|analysis|brainstorm)\b/i, label: 'research' },
+        { word: /\b(design|ui\/?ux|layout|visual)\b/i, label: 'Design' },
+        { word: /\b(debug|debugging|troubleshoot|root cause)\b/i, label: 'Debugging' },
+        { word: /\b(database|db|sqlite|schema|migration)\b/i, label: 'Data' },
+        { word: /\b(documentation|docs|readme|release notes)\b/i, label: 'Documentation' },
+        { word: /\b(deploy|deployment|release|ship)\b/i, label: 'deploy' },
+    ];
+    for (const { word, label } of commonKeywords) {
+        if (!seen.has(label) && word.test(userPrompt)) {
+            seen.add(label);
+            result.push(label);
+        }
+    }
+    return result;
+}
+/**
+ * Finds bot names mentioned verbatim (case-insensitive) in the user prompt.
+ * Returns only bot names that exist in the roster — prevents false positives
+ * on common words that happen to match a bot name elsewhere.
+ */
+function detectMentionedBotNames(userPrompt, bots) {
+    const result = [];
+    for (const bot of bots) {
+        const nameEscaped = bot.name.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\$&');
+        const pattern = new RegExp(`\\b${nameEscaped}\\b`, 'i');
+        if (pattern.test(userPrompt)) {
+            result.push(bot.name);
+        }
+    }
+    return result;
+}
+function computePlanExecutionIntent(userPrompt, bots) {
+    const candidateRoles = detectCandidateRoles(userPrompt, bots);
+    const mentionedBots = detectMentionedBotNames(userPrompt, bots);
+    const text = String(userPrompt || '').trim();
+    if (!text) {
+        return {
+            mode: 'none',
+            requires_file_read_before_dispatch: false,
+            mentioned_bots: [],
+            candidate_roles: [],
+            reasoning: 'No user prompt text.',
+        };
+    }
+    const referencesFileOrPlan = /\b(read|open|inspect|use|apply|take)\b[\s\S]{0,80}\b(file|plan|document|txt|text file|markdown|md)\b/i.test(text)
+        || /\bsteps?\s+(?:presented|listed|defined)\s+in\s+(?:this|the)\s+file\b/i.test(text)
+        || /\bfrom\s+(?:this|the)\s+file\b/i.test(text);
+    const perStepSignal = /\b(each|every|individual)\s+step\b/i.test(text)
+        || /\bone\s+(?:todo|task|workflow\s+step)\s+per\s+step\b/i.test(text);
+    const todoSignal = /\b(todo|to-do|task)\b/i.test(text);
+    const normalWorkflowSignal = /\b(?:use|run|apply)\b[\s\S]{0,40}\b(?:my|our|the|selected|normal|default|project team)\s+workflow\b/i.test(text)
+        || /\buse\b[\s\S]{0,20}\bworkflow\b[\s\S]{0,40}\b(?:each|every|individual)\s+step\b/i.test(text);
+    if (referencesFileOrPlan && perStepSignal && normalWorkflowSignal) {
+        return {
+            mode: 'per_step_workflow',
+            requires_file_read_before_dispatch: true,
+            mentioned_bots: mentionedBots,
+            candidate_roles: candidateRoles,
+            reasoning: 'User explicitly asked to apply a saved/normal workflow to each structured step in a file or plan.',
+        };
+    }
+    if (referencesFileOrPlan && perStepSignal && todoSignal && (mentionedBots.length > 0 || candidateRoles.length > 0)) {
+        return {
+            mode: 'per_step_todos',
+            requires_file_read_before_dispatch: true,
+            mentioned_bots: mentionedBots,
+            candidate_roles: candidateRoles,
+            reasoning: 'User explicitly asked to turn each structured step in a file or plan into sequential worker TODOs.',
+        };
+    }
+    return {
+        mode: 'none',
+        requires_file_read_before_dispatch: false,
+        mentioned_bots: mentionedBots,
+        candidate_roles: candidateRoles,
+        reasoning: referencesFileOrPlan
+            ? 'Prompt references a file or plan, but does not explicitly request per-step TODO/workflow expansion.'
+            : 'No explicit plan-file execution request detected.',
+    };
+}
+/**
+ * Suggests a dispatch mode based on the prompt shape.
+ * Purely advisory — the orchestrator LLM is free to override.
+ */
+function suggestMode(userPrompt, candidateRoles, mentionedBots, planIntent) {
+    const text = userPrompt.trim();
+    if (!text)
+        return 'reply_directly';
+    if (planIntent.mode !== 'none')
+        return 'create_workflow';
+    const hasQuestionMark = text.includes('?');
+    const workflowSignals = /\b(first\b.*\bthen\b|after\s+(that|you|qa|coding)|handoff|multi[- ]step)\b/i.test(text)
+        || candidateRoles.length >= 2
+        || mentionedBots.length >= 2;
+    if (workflowSignals)
+        return 'create_workflow';
+    if (candidateRoles.length === 1 || mentionedBots.length === 1)
+        return 'delegate_single';
+    // Pure question with no role or bot hint — probably a direct reply.
+    if (hasQuestionMark && candidateRoles.length === 0 && mentionedBots.length === 0) {
+        return 'reply_directly';
+    }
+    // Default conservative: delegate_single when the prompt looks task-shaped.
+    if (/\b(do|make|build|write|fix|finish|create|implement)\b/i.test(text)) {
+        return 'delegate_single';
+    }
+    return 'reply_directly';
+}
+function buildAdvisoryReasoning(mode, candidateRoles, mentionedBots) {
+    const parts = [];
+    if (mentionedBots.length > 0) {
+        parts.push(`prompt mentions bot${mentionedBots.length > 1 ? 's' : ''} by name (${mentionedBots.join(', ')})`);
+    }
+    if (candidateRoles.length > 0) {
+        parts.push(`detected role keyword${candidateRoles.length > 1 ? 's' : ''}: ${candidateRoles.join(', ')}`);
+    }
+    if (parts.length === 0) {
+        parts.push('no role or bot-name signals detected');
+    }
+    const modeLabel = mode === 'reply_directly'
+        ? 'direct reply'
+        : mode === 'delegate_single'
+            ? 'single delegation'
+            : 'multi-step workflow';
+    return `Suggesting ${modeLabel}: ${parts.join('; ')}.`;
+}
+function computeAdvisory(userPrompt, bots, precomputedPlanIntent) {
+    const candidateRoles = detectCandidateRoles(userPrompt, bots);
+    const mentionedBots = detectMentionedBotNames(userPrompt, bots);
+    const planIntent = precomputedPlanIntent || computePlanExecutionIntent(userPrompt, bots);
+    const suggested_mode = suggestMode(userPrompt, candidateRoles, mentionedBots, planIntent);
+    return {
+        candidate_roles_detected: candidateRoles,
+        candidate_bots_mentioned_by_name: mentionedBots,
+        suggested_mode,
+        reasoning: buildAdvisoryReasoning(suggested_mode, candidateRoles, mentionedBots),
+    };
+}
+//# sourceMappingURL=dispatch-hint.js.map