@n-dx/core 0.1.0

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

@@ -0,0 +1,40 @@
+/**
+ * hench-core — Run loop, context assembly, and orchestration.
+ *
+ * This module owns the agent execution lifecycle:
+ * - API agent loop (Anthropic SDK direct)
+ * - CLI agent loop (claude subprocess)
+ * - Task brief assembly and formatting
+ * - System prompt generation
+ * - Completion validation and review gate
+ * - Token budget management
+ * - Run summary generation
+ * - Stuck task detection
+ *
+ * Organized into subdirectories:
+ * - lifecycle/  — Agent execution loops and token tracking
+ * - planning/   — Task brief assembly and system prompt generation
+ * - analysis/   — Post-run review, summary, and stuck detection
+ *
+ * Tool definitions and implementations live in `../tools/`.
+ */
+// ── Lifecycle ──
+// Agent loops
+export { agentLoop } from "./lifecycle/loop.js";
+export { cliLoop } from "./lifecycle/cli-loop.js";
+// Token budget
+export { checkTokenBudget } from "./lifecycle/token-budget.js";
+// Token usage parsing & accumulation
+export { parseTokenUsage, parseStreamTokenUsage, emptyAggregateTokenUsage, accumulateTokenUsage, formatTokenUsage, } from "./lifecycle/token-usage.js";
+// ── Planning ──
+// Task brief assembly
+export { assembleTaskBrief, formatTaskBrief, getActionableTasks, collectEpicTaskIds, TaskNotActionableError, } from "./planning/brief.js";
+// System prompt
+export { buildSystemPrompt } from "./planning/prompt.js";
+// ── Analysis ──
+// Re-exported from analysis barrel (review, summary, stuck, spin, adaptive, workflow)
+export { collectReviewDiff, promptReview, revertChanges, buildRunSummary, countRecentFailures, isStuckTask, getStuckTaskIds, } from "./analysis/index.js";
+// ── Validation (canonical source: ../validation/) ──
+// Completion validation
+export { validateCompletion, formatValidationResult } from "../validation/completion.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,kBAAkB;AAElB,cAAc;AACd,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEhD,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAGlD,eAAe;AACf,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG/D,qCAAqC;AACrC,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,wBAAwB,EACxB,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,4BAA4B,CAAC;AAGpC,iBAAiB;AAEjB,sBAAsB;AACtB,OAAO,EACL,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAG7B,gBAAgB;AAChB,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,iBAAiB;AACjB,sFAAsF;AAEtF,OAAO,EACL,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAC9C,eAAe,EACf,mBAAmB,EAAE,WAAW,EAAE,eAAe,GAClD,MAAM,qBAAqB,CAAC;AAM7B,sDAAsD;AAEtD,wBAAwB;AACxB,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC"}

package/packages/hench/dist/agent/lifecycle/cli-loop.d.ts

@@ -0,0 +1,65 @@
+import type { RunRecord, ToolCallRecord, TurnTokenUsage } from "../../schema/index.js";
+import { type LLMVendor } from "../../store/project-config.js";
+import type { SharedLoopOptions } from "./shared.js";
+export interface CliLoopOptions extends SharedLoopOptions {
+}
+export interface CliLoopResult {
+    run: RunRecord;
+}
+export declare function isTransientError(errorText: string): boolean;
+export declare function computeDelay(attempt: number, baseMs: number, maxMs: number): number;
+export declare function buildRetryNotice(attempt: number, maxRetries: number, priorTurns: number): string;
+/**
+ * Build the `--allowed-tools` list for the Claude CLI.
+ *
+ * Maps the guard's `allowedCommands` (e.g. `["npm", "git"]`) to Claude CLI's
+ * tool pattern format (e.g. `["Bash(npm:*)", "Bash(git:*)"]`), and includes
+ * file tools that are inherently scoped to `cwd` by Claude CLI.
+ *
+ * This replaces `--dangerously-skip-permissions` so that:
+ * - Listed tools are auto-approved (no interactive prompts → autonomous execution)
+ * - Claude CLI's directory scoping stays active (file access restricted to cwd)
+ * - Bash is restricted to the same commands the API provider's guard allows
+ */
+export declare function buildAllowedTools(allowedCommands: string[]): string[];
+/** @internal Exported for testing. */
+export interface CliRunResult {
+    turns: number;
+    toolCalls: ToolCallRecord[];
+    tokenUsage: {
+        input: number;
+        output: number;
+        cacheCreationInput?: number;
+        cacheReadInput?: number;
+    };
+    turnTokenUsage: TurnTokenUsage[];
+    summary?: string;
+    error?: string;
+    costUsd?: number;
+}
+interface TokenEventMetadata {
+    vendor: LLMVendor;
+    model: string;
+}
+export interface NormalizedCodexToolEvent {
+    tool: string;
+    input: Record<string, unknown>;
+    output?: string;
+    status?: string;
+    eventType: string;
+}
+export interface NormalizedCodexResponse {
+    status: "completed" | "error" | "in_progress" | "unknown";
+    assistantText: string;
+    toolEvents: NormalizedCodexToolEvent[];
+    warnings: string[];
+    error?: string;
+}
+/** @internal Exported for testing. */
+export declare function normalizeCodexResponse(raw: unknown): NormalizedCodexResponse;
+/** @internal Exported for testing. */
+export declare function processStreamLine(line: string, result: CliRunResult, turnCounter: {
+    value: number;
+}, tokenMetadata?: TokenEventMetadata): void;
+export declare function cliLoop(opts: CliLoopOptions): Promise<CliLoopResult>;
+export {};