@n-dx/core 0.1.0

package/packages/hench/dist/agent/loop.js

@@ -0,0 +1,312 @@
+import Anthropic from "@anthropic-ai/sdk";
+import { execFile } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { GuardRails } from "../guard/index.js";
+import { TOOL_DEFINITIONS, dispatchTool } from "../tools/dispatch.js";
+import { assembleTaskBrief, formatTaskBrief } from "./brief.js";
+import { buildSystemPrompt } from "./prompt.js";
+import { saveRun } from "../store/index.js";
+import { buildRunSummary } from "./summary.js";
+import { collectReviewDiff, promptReview, revertChanges } from "./review.js";
+import { checkTokenBudget } from "./token-budget.js";
+import { parseTokenUsage } from "./token-usage.js";
+import { toolRexUpdateStatus, toolRexAppendLog, runPostTaskTests } from "../tools/index.js";
+import { section, subsection, stream, detail, info } from "../types/output.js";
+import { loadClaudeConfig, resolveApiKey } from "../store/project-config.js";
+import { resolveModel } from "@n-dx/claude-client";
+const RETRY_STATUS_CODES = new Set([429, 500, 502, 503, 529]);
+const MAX_RETRIES = 3;
+const BASE_DELAY_MS = 1000;
+const MAX_CONTEXT_PAIRS = 20;
+const MAX_SUMMARY_LENGTH = 500;
+const MAX_TOOL_OUTPUT_STORED = 2000;
+async function callWithRetry(client, params) {
+    let lastError;
+    for (let attempt = 0; attempt <= MAX_RETRIES; attempt++) {
+        try {
+            return await client.messages.create(params);
+        }
+        catch (err) {
+            lastError = err;
+            const status = err.status;
+            if (status && RETRY_STATUS_CODES.has(status) && attempt < MAX_RETRIES) {
+                const delay = BASE_DELAY_MS * Math.pow(2, attempt);
+                stream("Retry", `API returned ${status}, retrying in ${delay}ms...`);
+                await new Promise((r) => setTimeout(r, delay));
+                continue;
+            }
+            throw err;
+        }
+    }
+    throw lastError;
+}
+function pruneMessages(messages) {
+    // Keep first message (the task brief) and last MAX_CONTEXT_PAIRS turn-pairs.
+    // Turn-pairs are (assistant, user) so each pair = 2 messages.
+    const maxKeep = 1 + MAX_CONTEXT_PAIRS * 2;
+    if (messages.length <= maxKeep)
+        return;
+    const removed = messages.length - maxKeep;
+    messages.splice(1, removed);
+    detail(`Pruned ${removed} messages to stay within token budget`);
+}
+export async function agentLoop(opts) {
+    const { config, store, projectDir, henchDir, dryRun } = opts;
+    const maxTurns = opts.maxTurns ?? config.maxTurns;
+    const tokenBudget = opts.tokenBudget ?? config.tokenBudget;
+    const model = resolveModel(opts.model ?? config.model);
+    // Assemble brief
+    const { brief, taskId } = await assembleTaskBrief(store, opts.taskId, {
+        excludeTaskIds: opts.excludeTaskIds,
+        epicId: opts.epicId,
+    });
+    const briefText = formatTaskBrief(brief);
+    if (dryRun) {
+        section("Dry Run");
+        subsection("System Prompt");
+        info(buildSystemPrompt(brief.project, config));
+        subsection("Task Brief");
+        info(briefText);
+        subsection("Tools");
+        info(TOOL_DEFINITIONS.map((t) => t.name).join(", "));
+        const run = {
+            id: randomUUID(),
+            taskId,
+            taskTitle: brief.task.title,
+            startedAt: new Date().toISOString(),
+            finishedAt: new Date().toISOString(),
+            status: "completed",
+            turns: 0,
+            summary: "Dry run — no API calls made",
+            tokenUsage: { input: 0, output: 0 },
+            toolCalls: [],
+            model,
+        };
+        return { run };
+    }
+    // Atomically transition task to in_progress before any work begins.
+    // Idempotent: skip if already in_progress (e.g. resumed task).
+    if (brief.task.status !== "in_progress") {
+        await toolRexUpdateStatus(store, taskId, { status: "in_progress" });
+    }
+    // Get API key: unified config (.n-dx.json) > environment variable
+    const claudeConfig = await loadClaudeConfig(henchDir);
+    const apiKey = resolveApiKey(claudeConfig, config.apiKeyEnv);
+    if (!apiKey) {
+        throw new Error(`API key not found. Set it via 'n-dx config claude.api_key <key>' or the ${config.apiKeyEnv} environment variable.`);
+    }
+    // Capture the starting HEAD so completion validation can diff against it
+    // even if the agent commits changes during the run.
+    const startingHead = await new Promise((resolve) => {
+        execFile("git", ["rev-parse", "HEAD"], { cwd: projectDir }, (err, stdout) => {
+            resolve(err ? undefined : stdout.toString().trim());
+        });
+    });
+    // Build Anthropic client options — use custom endpoint from .n-dx.json if configured
+    const anthropicOpts = { apiKey };
+    if (claudeConfig.api_endpoint) {
+        anthropicOpts.baseURL = claudeConfig.api_endpoint;
+    }
+    const client = new Anthropic(anthropicOpts);
+    const guard = new GuardRails(projectDir, config.guard);
+    const toolCtx = {
+        guard,
+        projectDir,
+        store,
+        taskId,
+        testCommand: brief.project.testCommand,
+        startingHead,
+    };
+    const run = {
+        id: randomUUID(),
+        taskId,
+        taskTitle: brief.task.title,
+        startedAt: new Date().toISOString(),
+        status: "running",
+        turns: 0,
+        tokenUsage: { input: 0, output: 0 },
+        turnTokenUsage: [],
+        toolCalls: [],
+        model,
+    };
+    await saveRun(henchDir, run);
+    const systemPrompt = buildSystemPrompt(brief.project, config);
+    const messages = [
+        { role: "user", content: briefText },
+    ];
+    section(`Agent Run (${model})`);
+    try {
+        for (let turn = 0; turn < maxTurns; turn++) {
+            run.turns = turn + 1;
+            subsection(`Turn ${turn + 1}/${maxTurns}`);
+            pruneMessages(messages);
+            const response = await callWithRetry(client, {
+                model,
+                max_tokens: config.maxTokens,
+                system: systemPrompt,
+                tools: TOOL_DEFINITIONS,
+                messages,
+            });
+            // Track token usage
+            const parsed = parseTokenUsage(response.usage);
+            run.tokenUsage.input += parsed.input;
+            run.tokenUsage.output += parsed.output;
+            if (parsed.cacheCreationInput) {
+                run.tokenUsage.cacheCreationInput = (run.tokenUsage.cacheCreationInput ?? 0) + parsed.cacheCreationInput;
+            }
+            if (parsed.cacheReadInput) {
+                run.tokenUsage.cacheReadInput = (run.tokenUsage.cacheReadInput ?? 0) + parsed.cacheReadInput;
+            }
+            // Per-turn breakdown
+            const turnUsage = {
+                turn: turn + 1,
+                input: parsed.input,
+                output: parsed.output,
+            };
+            if (parsed.cacheCreationInput)
+                turnUsage.cacheCreationInput = parsed.cacheCreationInput;
+            if (parsed.cacheReadInput)
+                turnUsage.cacheReadInput = parsed.cacheReadInput;
+            run.turnTokenUsage.push(turnUsage);
+            // Check token budget
+            const budgetCheck = checkTokenBudget(run.tokenUsage, tokenBudget);
+            if (budgetCheck.exceeded) {
+                run.status = "budget_exceeded";
+                run.error = `Token budget exceeded: ${budgetCheck.totalUsed} used of ${budgetCheck.budget} budget`;
+                stream("Budget", run.error);
+                await toolRexUpdateStatus(store, taskId, { status: "pending" });
+                await toolRexAppendLog(store, taskId, {
+                    event: "budget_exceeded",
+                    detail: run.error,
+                });
+                break;
+            }
+            // Process response content
+            const assistantContent = response.content;
+            messages.push({ role: "assistant", content: assistantContent });
+            // Print text output
+            for (const block of assistantContent) {
+                if (block.type === "text" && block.text) {
+                    stream("Agent", block.text);
+                }
+            }
+            // Handle stop reasons
+            if (response.stop_reason === "end_turn") {
+                run.status = "completed";
+                for (const block of [...assistantContent].reverse()) {
+                    if (block.type === "text") {
+                        run.summary = block.text.slice(0, MAX_SUMMARY_LENGTH);
+                        break;
+                    }
+                }
+                break;
+            }
+            if (response.stop_reason === "max_tokens") {
+                stream("Warning", "Response truncated (max_tokens). Continuing...");
+                // Send a continuation prompt so the agent can finish its thought
+                messages.push({
+                    role: "user",
+                    content: "Your response was truncated due to length. Please continue where you left off. If you were in the middle of a tool call, please retry it.",
+                });
+                continue;
+            }
+            if (response.stop_reason !== "tool_use") {
+                run.status = "completed";
+                break;
+            }
+            // Process tool calls
+            const toolResults = [];
+            for (const block of assistantContent) {
+                if (block.type !== "tool_use")
+                    continue;
+                const startMs = Date.now();
+                stream("Tool", `${block.name}(${JSON.stringify(block.input).slice(0, 100)})`);
+                const output = await dispatchTool(toolCtx, block.name, block.input);
+                const durationMs = Date.now() - startMs;
+                run.toolCalls.push({
+                    turn: turn + 1,
+                    tool: block.name,
+                    input: block.input,
+                    output: output.slice(0, MAX_TOOL_OUTPUT_STORED),
+                    durationMs,
+                });
+                toolResults.push({
+                    type: "tool_result",
+                    tool_use_id: block.id,
+                    content: output,
+                });
+                stream("Result", `${output.slice(0, 200)}${output.length > 200 ? "..." : ""}`);
+                detail(`${durationMs}ms`);
+            }
+            messages.push({ role: "user", content: toolResults });
+            // Save progress periodically
+            await saveRun(henchDir, run);
+        }
+        if (run.status === "running") {
+            run.status = "timeout";
+            run.error = `Exceeded max turns (${maxTurns})`;
+            await toolRexUpdateStatus(store, taskId, { status: "deferred" });
+            await toolRexAppendLog(store, taskId, {
+                event: "task_failed",
+                detail: run.error,
+            });
+        }
+    }
+    catch (err) {
+        run.status = "failed";
+        run.error = err.message;
+        console.error(`[Error] ${run.error}`);
+        await toolRexUpdateStatus(store, taskId, { status: "deferred" });
+        await toolRexAppendLog(store, taskId, {
+            event: "task_failed",
+            detail: run.error,
+        });
+    }
+    // Review gate — prompt user before finalizing a completed run
+    if (opts.review && run.status === "completed") {
+        const reviewDiff = await collectReviewDiff(projectDir);
+        const reviewResult = await promptReview(reviewDiff);
+        if (!reviewResult.approved) {
+            run.status = "failed";
+            run.error = reviewResult.reason;
+            info(`\nChanges rejected — reverting...`);
+            await revertChanges(projectDir);
+            await toolRexUpdateStatus(store, taskId, { status: "pending" });
+            await toolRexAppendLog(store, taskId, {
+                event: "review_rejected",
+                detail: reviewResult.reason ?? "Changes rejected by reviewer",
+            });
+        }
+    }
+    run.structuredSummary = buildRunSummary(run.toolCalls);
+    // Automatic post-task test run — only for completed runs
+    if (run.status === "completed" && brief.project.testCommand) {
+        subsection("Post-Task Tests");
+        const testResult = await runPostTaskTests({
+            projectDir,
+            filesChanged: run.structuredSummary.filesChanged,
+            testCommand: brief.project.testCommand,
+        });
+        run.structuredSummary.postRunTests = testResult;
+        if (testResult.ran) {
+            const scope = testResult.targetedFiles.length > 0
+                ? ` (${testResult.targetedFiles.length} targeted file(s))`
+                : " (full suite)";
+            const status = testResult.passed ? "passed" : "FAILED";
+            stream("Tests", `${status}${scope}`);
+            if (testResult.durationMs != null) {
+                detail(`${testResult.durationMs}ms`);
+            }
+            if (!testResult.passed && testResult.output) {
+                info(testResult.output.slice(-500));
+            }
+        }
+        else if (testResult.error) {
+            detail(testResult.error);
+        }
+    }
+    run.finishedAt = new Date().toISOString();
+    await saveRun(henchDir, run);
+    return { run };
+}
+//# sourceMappingURL=loop.js.map

package/packages/hench/dist/agent/loop.js.map

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

package/packages/hench/dist/agent/planning/brief.d.ts

@@ -0,0 +1,40 @@
+import type { PRDStore, PRDItem } from "../../prd/rex-gateway.js";
+import type { TaskBrief } from "../../schema/index.js";
+import { CLIError } from "../../prd/llm-gateway.js";
+export interface AssembleBriefOptions {
+    /** Task IDs to skip during autoselection (e.g. stuck tasks). */
+    excludeTaskIds?: Set<string>;
+    /** Restrict task selection to this epic (ID). */
+    epicId?: string;
+}
+/**
+ * Collect all task/subtask IDs that belong to a specific epic.
+ * Includes all descendants of the epic at task or subtask level.
+ */
+export declare function collectEpicTaskIds(items: PRDItem[], epicId: string): Set<string>;
+/**
+ * Thrown when an explicitly-selected task cannot be worked on.
+ *
+ * Extends the foundation {@link CLIError} (which extends ClaudeClientError),
+ * bringing it into the unified error hierarchy. The `suggestion` field from
+ * CLIError is used directly, and additional task-specific metadata (`taskId`,
+ * `status`) is available for programmatic handling.
+ */
+export declare class TaskNotActionableError extends CLIError {
+    readonly taskId: string;
+    readonly status: string;
+    constructor(taskId: string, status: string, suggestion: string, title?: string);
+}
+export declare function assembleTaskBrief(store: PRDStore, taskId?: string, options?: AssembleBriefOptions): Promise<{
+    brief: TaskBrief;
+    taskId: string;
+}>;
+export interface ActionableTask {
+    id: string;
+    title: string;
+    level: string;
+    priority: string;
+    parentChain: string;
+}
+export declare function getActionableTasks(store: PRDStore, limit?: number): Promise<ActionableTask[]>;
+export declare function formatTaskBrief(brief: TaskBrief): string;

package/packages/hench/dist/agent/planning/brief.js

@@ -0,0 +1,267 @@
+import { findNextTask, findActionableTasks, collectCompletedIds, findItem, walkTree, collectRequirements, isWorkItem, } from "../../prd/rex-gateway.js";
+import { CLIError } from "../../prd/llm-gateway.js";
+// ---------------------------------------------------------------------------
+// Epic task collection
+// ---------------------------------------------------------------------------
+/**
+ * Collect all task/subtask IDs that belong to a specific epic.
+ * Includes all descendants of the epic at task or subtask level.
+ */
+export function collectEpicTaskIds(items, epicId) {
+    const ids = new Set();
+    for (const { item, parents } of walkTree(items)) {
+        // Check if this item is inside the target epic
+        const isInEpic = item.id === epicId ||
+            parents.some((p) => p.id === epicId);
+        if (isInEpic && isWorkItem(item.level)) {
+            ids.add(item.id);
+        }
+    }
+    return ids;
+}
+// ---------------------------------------------------------------------------
+// Task status validation
+// ---------------------------------------------------------------------------
+/** Statuses that cannot be worked on. */
+const NON_ACTIONABLE_STATUSES = new Set(["completed", "deferred", "blocked"]);
+/**
+ * Thrown when an explicitly-selected task cannot be worked on.
+ *
+ * Extends the foundation {@link CLIError} (which extends ClaudeClientError),
+ * bringing it into the unified error hierarchy. The `suggestion` field from
+ * CLIError is used directly, and additional task-specific metadata (`taskId`,
+ * `status`) is available for programmatic handling.
+ */
+export class TaskNotActionableError extends CLIError {
+    taskId;
+    status;
+    constructor(taskId, status, suggestion, title) {
+        const label = title ? `"${title}" (${taskId})` : taskId;
+        super(`Task ${label} is ${status} and cannot be worked on.`, suggestion);
+        this.name = "TaskNotActionableError";
+        this.taskId = taskId;
+        this.status = status;
+    }
+}
+function buildSuggestion(status, taskId) {
+    if (status === "completed") {
+        return ("This task is already complete. Run 'n-dx status' to see remaining work,\n" +
+            "or pick a different task with 'n-dx work --task=<ID>'.");
+    }
+    if (status === "blocked") {
+        return (`This task is blocked and cannot proceed until its dependencies are resolved.\n` +
+            `To unblock it, run:\n` +
+            `  rex update ${taskId} --status=pending\n` +
+            "Then run 'n-dx work' again.");
+    }
+    // deferred
+    return (`This task has been deferred. To reactivate it, run:\n` +
+        `  rex update ${taskId} --status=pending\n` +
+        "Then run 'n-dx work' again.");
+}
+function itemToTaskBrief(item) {
+    return {
+        id: item.id,
+        title: item.title,
+        level: item.level,
+        status: item.status,
+        description: item.description,
+        acceptanceCriteria: item.acceptanceCriteria,
+        priority: item.priority,
+        tags: item.tags,
+        blockedBy: item.blockedBy,
+        failureReason: item.failureReason,
+    };
+}
+function itemToParent(item) {
+    return {
+        id: item.id,
+        title: item.title,
+        level: item.level,
+        description: item.description,
+    };
+}
+function getSiblings(entry, doc) {
+    // Get the parent's children (or root items if no parent)
+    const parent = entry.parents[entry.parents.length - 1];
+    const siblingList = parent?.children ?? doc.items;
+    return siblingList
+        .filter((s) => s.id !== entry.item.id)
+        .map((s) => ({
+        id: s.id,
+        title: s.title,
+        status: s.status,
+    }));
+}
+export async function assembleTaskBrief(store, taskId, options) {
+    const doc = await store.loadDocument();
+    const config = await store.loadConfig();
+    const excludeIds = options?.excludeTaskIds;
+    let entry;
+    if (taskId) {
+        entry = findItem(doc.items, taskId);
+        if (!entry) {
+            throw new Error(`Task not found: ${taskId}`);
+        }
+        if (NON_ACTIONABLE_STATUSES.has(entry.item.status)) {
+            throw new TaskNotActionableError(taskId, entry.item.status, buildSuggestion(entry.item.status, taskId), entry.item.title);
+        }
+    }
+    else {
+        const completedIds = collectCompletedIds(doc.items);
+        // When excluding stuck tasks, treat them as completed so findNextTask skips them
+        const skipIds = excludeIds
+            ? new Set([...completedIds, ...excludeIds])
+            : completedIds;
+        const epicId = options?.epicId;
+        if (epicId) {
+            // Epic filter active: get all actionable tasks and filter to epic
+            const epicTaskIds = collectEpicTaskIds(doc.items, epicId);
+            const allActionable = findActionableTasks(doc.items, skipIds, Infinity);
+            // Filter to tasks within the epic and not in excludeIds
+            const epicActionable = allActionable.filter((e) => epicTaskIds.has(e.item.id) && !excludeIds?.has(e.item.id));
+            if (epicActionable.length === 0) {
+                throw new Error("No actionable tasks found in epic");
+            }
+            // findActionableTasks already sorts by priority, so first is best
+            entry = epicActionable[0];
+        }
+        else {
+            // No epic filter: use standard findNextTask
+            entry = findNextTask(doc.items, skipIds);
+            if (!entry) {
+                throw new Error("No actionable tasks found in PRD");
+            }
+        }
+    }
+    let workflow = "";
+    try {
+        workflow = await store.loadWorkflow();
+    }
+    catch {
+        // No workflow file
+    }
+    const recentLog = await store.readLog(20);
+    const project = {
+        name: config.project,
+        validateCommand: config.validate,
+        testCommand: config.test,
+    };
+    // Collect requirements (own + inherited from parent chain)
+    const tracedReqs = collectRequirements(doc.items, entry.item.id);
+    const requirements = tracedReqs.map((tr) => ({
+        id: tr.requirement.id,
+        title: tr.requirement.title,
+        category: tr.requirement.category,
+        validationType: tr.requirement.validationType,
+        acceptanceCriteria: tr.requirement.acceptanceCriteria,
+        source: tr.sourceItemTitle,
+    }));
+    const brief = {
+        task: itemToTaskBrief(entry.item),
+        parentChain: entry.parents.map(itemToParent),
+        siblings: getSiblings(entry, doc),
+        requirements,
+        project,
+        workflow,
+        recentLog: recentLog.map((e) => ({
+            timestamp: e.timestamp,
+            event: e.event,
+            detail: e.detail,
+        })),
+    };
+    return { brief, taskId: entry.item.id };
+}
+export async function getActionableTasks(store, limit = 20) {
+    const doc = await store.loadDocument();
+    const completedIds = collectCompletedIds(doc.items);
+    const entries = findActionableTasks(doc.items, completedIds, limit);
+    return entries.map((e) => ({
+        id: e.item.id,
+        title: e.item.title,
+        level: e.item.level,
+        priority: e.item.priority ?? "medium",
+        parentChain: e.parents.map((p) => p.title).join(" > "),
+    }));
+}
+export function formatTaskBrief(brief) {
+    const sections = [];
+    // Task
+    sections.push("## Current Task");
+    sections.push(`**${brief.task.title}** (${brief.task.level})`);
+    sections.push(`ID: ${brief.task.id}`);
+    sections.push(`Status: ${brief.task.status}`);
+    if (brief.task.priority)
+        sections.push(`Priority: ${brief.task.priority}`);
+    if (brief.task.blockedBy?.length) {
+        sections.push(`Blocked by: ${brief.task.blockedBy.join(", ")}`);
+    }
+    if (brief.task.description)
+        sections.push(`\nDescription:\n${brief.task.description}`);
+    if (brief.task.acceptanceCriteria?.length) {
+        sections.push("\nAcceptance Criteria:");
+        for (const c of brief.task.acceptanceCriteria) {
+            sections.push(`- ${c}`);
+        }
+    }
+    if (brief.task.tags?.length) {
+        sections.push(`Tags: ${brief.task.tags.join(", ")}`);
+    }
+    if (brief.task.failureReason) {
+        sections.push("\n## PREVIOUS FAILURE");
+        sections.push(brief.task.failureReason);
+    }
+    // Parent chain
+    if (brief.parentChain.length > 0) {
+        sections.push("\n## Context (Parent Chain)");
+        for (const p of brief.parentChain) {
+            sections.push(`- **${p.title}** (${p.level})`);
+            if (p.description)
+                sections.push(`  ${p.description}`);
+        }
+    }
+    // Requirements
+    if (brief.requirements.length > 0) {
+        sections.push("\n## Requirements");
+        for (const req of brief.requirements) {
+            sections.push(`- **${req.title}** [${req.category}/${req.validationType}] (from: ${req.source})`);
+            for (const ac of req.acceptanceCriteria) {
+                sections.push(`  - ${ac}`);
+            }
+        }
+    }
+    // Siblings
+    if (brief.siblings.length > 0) {
+        sections.push("\n## Sibling Tasks");
+        for (const s of brief.siblings) {
+            const marker = s.status === "completed" ? "[x]" : "[ ]";
+            sections.push(`- ${marker} ${s.title} (${s.status})`);
+        }
+    }
+    // Project
+    sections.push("\n## Project");
+    sections.push(`Name: ${brief.project.name}`);
+    if (brief.project.validateCommand) {
+        sections.push(`Validate: \`${brief.project.validateCommand}\``);
+    }
+    if (brief.project.testCommand) {
+        sections.push(`Test: \`${brief.project.testCommand}\``);
+    }
+    // Workflow
+    if (brief.workflow) {
+        sections.push("\n## Workflow");
+        sections.push(brief.workflow);
+    }
+    // Recent log
+    if (brief.recentLog.length > 0) {
+        sections.push("\n## Recent Activity");
+        for (const entry of brief.recentLog.slice(-10)) {
+            const line = entry.detail
+                ? `- [${entry.timestamp}] ${entry.event}: ${entry.detail}`
+                : `- [${entry.timestamp}] ${entry.event}`;
+            sections.push(line);
+        }
+    }
+    return sections.join("\n");
+}
+//# sourceMappingURL=brief.js.map

package/packages/hench/dist/agent/planning/brief.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brief.js","sourceRoot":"","sources":["../../../src/agent/planning/brief.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,QAAQ,EACR,QAAQ,EACR,mBAAmB,EACnB,UAAU,GACX,MAAM,0BAA0B,CAAC;AAWlC,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AASpD,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAgB,EAAE,MAAc;IACjE,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAE9B,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAChD,+CAA+C;QAC/C,MAAM,QAAQ,GACZ,IAAI,CAAC,EAAE,KAAK,MAAM;YAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;QAEvC,IAAI,QAAQ,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACvC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E,yCAAyC;AACzC,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC,CAAC;AAE9E;;;;;;;GAOG;AACH,MAAM,OAAO,sBAAuB,SAAQ,QAAQ;IACzC,MAAM,CAAS;IACf,MAAM,CAAS;IAExB,YAAY,MAAc,EAAE,MAAc,EAAE,UAAkB,EAAE,KAAc;QAC5E,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;QACxD,KAAK,CAAC,QAAQ,KAAK,OAAO,MAAM,2BAA2B,EAAE,UAAU,CAAC,CAAC;QACzE,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,SAAS,eAAe,CAAC,MAAc,EAAE,MAAc;IACrD,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QAC3B,OAAO,CACL,2EAA2E;YAC3E,wDAAwD,CACzD,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,OAAO,CACL,gFAAgF;YAChF,uBAAuB;YACvB,gBAAgB,MAAM,qBAAqB;YAC3C,6BAA6B,CAC9B,CAAC;IACJ,CAAC;IACD,WAAW;IACX,OAAO,CACL,uDAAuD;QACvD,gBAAgB,MAAM,qBAAqB;QAC3C,6BAA6B,CAC9B,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,IAAa;IACpC,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;QAC3C,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,aAAa,EAAE,IAAI,CAAC,aAAa;KAClC,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,IAAa;IACjC,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,KAAgB,EAAE,GAAyB;IAC9D,yDAAyD;IACzD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACvD,MAAM,WAAW,GAAG,MAAM,EAAE,QAAQ,IAAI,GAAG,CAAC,KAAK,CAAC;IAElD,OAAO,WAAW;SACf,MAAM,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;SAC9C,GAAG,CAAC,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC;QACpB,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,KAAK,EAAE,CAAC,CAAC,KAAK;QACd,MAAM,EAAE,CAAC,CAAC,MAAM;KACjB,CAAC,CAAC,CAAC;AACR,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,KAAe,EACf,MAAe,EACf,OAA8B;IAE9B,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC;IACvC,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE,CAAC;IACxC,MAAM,UAAU,GAAG,OAAO,EAAE,cAAc,CAAC;IAE3C,IAAI,KAAuB,CAAC;IAE5B,IAAI,MAAM,EAAE,CAAC;QACX,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,EAAE,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,uBAAuB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,sBAAsB,CAC9B,MAAM,EACN,KAAK,CAAC,IAAI,CAAC,MAAM,EACjB,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1C,KAAK,CAAC,IAAI,CAAC,KAAK,CACjB,CAAC;QACJ,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,YAAY,GAAG,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACpD,iFAAiF;QACjF,MAAM,OAAO,GAAG,UAAU;YACxB,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,YAAY,EAAE,GAAG,UAAU,CAAC,CAAC;YAC3C,CAAC,CAAC,YAAY,CAAC;QAEjB,MAAM,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC;QAE/B,IAAI,MAAM,EAAE,CAAC;YACX,kEAAkE;YAClE,MAAM,WAAW,GAAG,kBAAkB,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YAC1D,MAAM,aAAa,GAAG,mBAAmB,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;YAExE,wDAAwD;YACxD,MAAM,cAAc,GAAG,aAAa,CAAC,MAAM,CACzC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CACjE,CAAC;YAEF,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAChC,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;YACvD,CAAC;YAED,kEAAkE;YAClE,KAAK,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;aAAM,CAAC;YACN,4CAA4C;YAC5C,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YACzC,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;YACtD,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,mBAAmB;IACrB,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAE1C,MAAM,OAAO,GAAqB;QAChC,IAAI,EAAE,MAAM,CAAC,OAAO;QACpB,eAAe,EAAE,MAAM,CAAC,QAAQ;QAChC,WAAW,EAAE,MAAM,CAAC,IAAI;KACzB,CAAC;IAEF,2DAA2D;IAC3D,MAAM,UAAU,GAAG,mBAAmB,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjE,MAAM,YAAY,GAA2B,UAAU,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACnE,EAAE,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE;QACrB,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,KAAK;QAC3B,QAAQ,EAAE,EAAE,CAAC,WAAW,CAAC,QAAQ;QACjC,cAAc,EAAE,EAAE,CAAC,WAAW,CAAC,cAAc;QAC7C,kBAAkB,EAAE,EAAE,CAAC,WAAW,CAAC,kBAAkB;QACrD,MAAM,EAAE,EAAE,CAAC,eAAe;KAC3B,CAAC,CAAC,CAAC;IAEJ,MAAM,KAAK,GAAc;QACvB,IAAI,EAAE,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC;QACjC,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QAC5C,QAAQ,EAAE,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC;QACjC,YAAY;QACZ,OAAO;QACP,QAAQ;QACR,SAAS,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC/B,SAAS,EAAE,CAAC,CAAC,SAAS;YACtB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,MAAM,EAAE,CAAC,CAAC,MAAM;SACjB,CAAC,CAAC;KACJ,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;AAC1C,CAAC;AAUD,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAe,EACf,KAAK,GAAG,EAAE;IAEV,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC;IACvC,MAAM,YAAY,GAAG,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpD,MAAM,OAAO,GAAG,mBAAmB,CAAC,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,CAAC,CAAC;IAEpE,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACzB,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE;QACb,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK;QACnB,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK;QACnB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,QAAQ;QACrC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC;KACvD,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAgB;IAC9C,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,OAAO;IACP,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACjC,QAAQ,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,KAAK,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IAC/D,QAAQ,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IACtC,QAAQ,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9C,IAAI,KAAK,CAAC,IAAI,CAAC,QAAQ;QAAE,QAAQ,CAAC,IAAI,CAAC,aAAa,KAAK,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC3E,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW;QAAE,QAAQ,CAAC,IAAI,CAAC,mBAAmB,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACvF,IAAI,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,MAAM,EAAE,CAAC;QAC1C,QAAQ,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC;QACxC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,kBAAkB,EAAE,CAAC;YAC9C,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;QAC7B,QAAQ,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACvC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1C,CAAC;IAED,eAAe;IACf,IAAI,KAAK,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAC7C,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;YAClC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC;YAC/C,IAAI,CAAC,CAAC,WAAW;gBAAE,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,eAAe;IACf,IAAI,KAAK,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;QACnC,KAAK,MAAM,GAAG,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;YACrC,QAAQ,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,KAAK,OAAO,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,cAAc,YAAY,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;YAClG,KAAK,MAAM,EAAE,IAAI,GAAG,CAAC,kBAAkB,EAAE,CAAC;gBACxC,QAAQ,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED,WAAW;IACX,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACpC,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;YACxD,QAAQ,CAAC,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,UAAU;IACV,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC9B,QAAQ,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,eAAe,EAAE,CAAC;QAClC,QAAQ,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,OAAO,CAAC,eAAe,IAAI,CAAC,CAAC;IAClE,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;IAC1D,CAAC;IAED,WAAW;IACX,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC/B,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAED,aAAa;IACb,IAAI,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,QAAQ,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QACtC,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM;gBACvB,CAAC,CAAC,MAAM,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,MAAM,EAAE;gBAC1D,CAAC,CAAC,MAAM,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,KAAK,EAAE,CAAC;YAC5C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/packages/hench/dist/agent/planning/prompt.d.ts

@@ -0,0 +1,2 @@
+import type { HenchConfig, TaskBriefProject } from "../../schema/index.js";
+export declare function buildSystemPrompt(project: TaskBriefProject, config: HenchConfig): string;