@promptbook/cli 0.113.0-8 → 0.114.0-0

package/umd/scripts/run-codex-prompts/isolation/mergeCoderIsolationWorktree.d.ts

@@ -0,0 +1,24 @@
+import type { CoderIsolationWorktree } from './CoderIsolationWorktree';
+/**
+ * Outcome of merging one isolated task back into the branch the coder runs on.
+ */
+export type CoderIsolationMergeResult = {
+    readonly isMerged: true;
+} | {
+    readonly isMerged: false;
+    /**
+     * Raw git output explaining why the merge could not be completed.
+     */
+    readonly failureDetails: string;
+};
+/**
+ * Merges the isolated task back into the branch the coder runs on.
+ *
+ * The merge is squashed so that the isolated task produces exactly one commit on the original branch,
+ * exactly like a task processed without `--isolate`. The changes are only staged here; the caller
+ * creates the commit so that the prompt status update becomes part of the very same commit.
+ *
+ * A failed merge never leaves the original working tree in a conflicted state and is reported back
+ * instead of thrown, because a merge failure must not stop the coder from processing the next task.
+ */
+export declare function mergeCoderIsolationWorktree(worktree: CoderIsolationWorktree): Promise<CoderIsolationMergeResult>;

package/umd/scripts/run-codex-prompts/isolation/removeCoderIsolationWorktree.d.ts

@@ -0,0 +1,8 @@
+import type { CoderIsolationWorktree } from './CoderIsolationWorktree';
+/**
+ * Removes one isolation worktree together with its temporary branch.
+ *
+ * Returns `true` when the worktree directory or the temporary branch still existed and was removed,
+ * which lets callers report that leftovers of an earlier run were cleaned up.
+ */
+export declare function removeCoderIsolationWorktree(worktree: CoderIsolationWorktree): Promise<boolean>;

package/umd/scripts/run-codex-prompts/isolation/runIsolatedPromptRound.d.ts

@@ -0,0 +1,14 @@
+import type { RunPromptRoundOptions } from '../main/runPromptRound';
+/**
+ * Runs one prompt round inside a temporary git worktree and merges the result back afterwards.
+ *
+ * This is the `--isolate` counterpart of `runPromptRound`, so it accepts exactly the same input:
+ * - The coding agent, its verification command and the round commit all happen inside the worktree.
+ * - A verified task is squash-merged back into the branch the coder runs on and the worktree is deleted.
+ * - A task which cannot be merged is recorded as failed in the original project and its worktree is kept,
+ *   without stopping the coder from processing the next task.
+ * - A task whose round fails keeps its worktree too, so the work of the failed round can still be inspected.
+ *
+ * @private function of runCodexPrompts
+ */
+export declare function runIsolatedPromptRound(options: RunPromptRoundOptions): Promise<void>;

package/umd/scripts/run-codex-prompts/main/runPromptRound.d.ts

@@ -7,7 +7,7 @@ import type { CoderRunUiHandle } from '../ui/renderCoderRunUi';
 /**
  * Input required to execute one prompt-processing round.
  */
-type RunPromptRoundOptions = {
+export type RunPromptRoundOptions = {
     options: RunOptions;
     runner: PromptRunner;
     runnerMetadata: {
@@ -22,11 +22,17 @@ type RunPromptRoundOptions = {
     progressDisplay?: CliProgressDisplay;
     uiHandle?: CoderRunUiHandle;
     waitForRequestedPause: WaitForCoderRunPauseCheckpoint;
+    /**
+     * Working directory the coding agent, the verification command and the round commit run in.
+     *
+     * Defaults to the project the coder was started from and is the temporary worktree
+     * when the round is isolated through `--isolate`.
+     */
+    projectPath?: string;
 };
 /**
  * Runs one prompt round from prompt construction through commit or failure logging.
  *
  * @private function of runCodexPrompts
  */
-export declare function runPromptRound({ options, runner, runnerMetadata, nextPrompt, promptLabel, resolvedCoderContext, resolvedAgentSystemMessage, isRichUiEnabled, progressDisplay, uiHandle, waitForRequestedPause, }: RunPromptRoundOptions): Promise<void>;
-export {};
+export declare function runPromptRound({ options, runner, runnerMetadata, nextPrompt, promptLabel, resolvedCoderContext, resolvedAgentSystemMessage, isRichUiEnabled, progressDisplay, uiHandle, waitForRequestedPause, projectPath, }: RunPromptRoundOptions): Promise<void>;

package/umd/scripts/run-codex-prompts/prompts/buildPromptSectionSuffix.d.ts

@@ -0,0 +1,9 @@
+import type { PromptFile } from './types/PromptFile';
+import type { PromptSection } from './types/PromptSection';
+/**
+ * Builds the suffix which disambiguates one prompt section inside its prompt file.
+ *
+ * Prompt files holding exactly one section produce an empty suffix so that generated artifact
+ * names (temporary scripts, isolation worktrees, ...) stay identical to the prompt file name.
+ */
+export declare function buildPromptSectionSuffix(file: PromptFile, section: PromptSection): string;

package/umd/scripts/run-codex-prompts/prompts/findNextTodoPrompt.d.ts

@@ -1,6 +1,7 @@
 import type { PromptFile } from './types/PromptFile';
 import type { PromptSelection } from './types/PromptSelection';
+import type { PriorityFilter } from './priorityFilter';
 /**
  * Selects the next runnable prompt based on priority.
  */
-export declare function findNextTodoPrompt(files: PromptFile[], minimumPriority?: number): PromptSelection | undefined;
+export declare function findNextTodoPrompt(files: PromptFile[], priorityFilter?: PriorityFilter): PromptSelection | undefined;

package/umd/scripts/run-codex-prompts/prompts/formatCoderRunSteps.d.ts

@@ -0,0 +1,9 @@
+import type { CoderRunStep } from '../common/CoderRunStep';
+/**
+ * Formats the per-step usage breakdown recorded for one finished prompt.
+ *
+ * Produces a `; `-separated summary such as
+ * `Implementation $8.01 6 hours; Testing 1 hour; Fixing $3.14 2 hours` where each coding step carries its
+ * price and duration and each verification step carries only its duration.
+ */
+export declare function formatCoderRunSteps(steps: ReadonlyArray<CoderRunStep>): string;

package/umd/scripts/run-codex-prompts/prompts/formatRunnerSignature.d.ts

@@ -1,4 +1,5 @@
+import type { ThinkingLevel } from '../../../src/cli/cli-commands/coder/ThinkingLevel';
 /**
  * Formats runner details for prompt status lines.
  */
-export declare function formatRunnerSignature(runnerName: string | undefined, modelName: string | undefined): string;
+export declare function formatRunnerSignature(runnerName: string | undefined, modelName: string | undefined, thinkingLevel?: ThinkingLevel): string;

package/umd/scripts/run-codex-prompts/prompts/isPromptInPriorityFilter.d.ts

@@ -0,0 +1,6 @@
+import { type PriorityFilter } from './priorityFilter';
+import type { PromptSection } from './types/PromptSection';
+/**
+ * Checks whether a prompt section matches the configured priority filter.
+ */
+export declare function isPromptInPriorityFilter(section: PromptSection, priorityFilter?: PriorityFilter): boolean;

package/umd/scripts/run-codex-prompts/prompts/listPromptsToBeWritten.d.ts

@@ -1,6 +1,7 @@
 import type { PromptFile } from './types/PromptFile';
 import type { PromptSelection } from './types/PromptSelection';
+import type { PriorityFilter } from './priorityFilter';
 /**
  * Lists todo prompts that still contain authoring placeholders.
  */
-export declare function listPromptsToBeWritten(files: PromptFile[], minimumPriority?: number): PromptSelection[];
+export declare function listPromptsToBeWritten(files: PromptFile[], priorityFilter?: PriorityFilter): PromptSelection[];

package/umd/scripts/run-codex-prompts/prompts/listRunnablePrompts.d.ts

@@ -1,6 +1,7 @@
 import type { PromptFile } from './types/PromptFile';
 import type { PromptSelection } from './types/PromptSelection';
+import type { PriorityFilter } from './priorityFilter';
 /**
  * Lists todo prompts that are ready to run (no authoring placeholders).
  */
-export declare function listRunnablePrompts(files: PromptFile[], minimumPriority?: number): PromptSelection[];
+export declare function listRunnablePrompts(files: PromptFile[], priorityFilter?: PriorityFilter): PromptSelection[];

package/umd/scripts/run-codex-prompts/prompts/listUpcomingTasks.d.ts

@@ -1,6 +1,7 @@
 import type { PromptFile } from './types/PromptFile';
 import type { UpcomingTask } from './types/UpcomingTask';
+import type { PriorityFilter } from './priorityFilter';
 /**
  * Lists upcoming tasks that are ready to run (no authoring placeholders).
  */
-export declare function listUpcomingTasks(files: PromptFile[], minimumPriority?: number): UpcomingTask[];
+export declare function listUpcomingTasks(files: PromptFile[], priorityFilter?: PriorityFilter): UpcomingTask[];

package/umd/scripts/run-codex-prompts/prompts/markPromptDone.d.ts

@@ -1,8 +1,9 @@
-import moment from 'moment';
-import type { Usage } from '../../../src/execution/Usage';
+import { type CodexLoginMethod } from '../../../src/book-3.0/codexLoginMethod';
+import type { ThinkingLevel } from '../../../src/cli/cli-commands/coder/ThinkingLevel';
+import type { CoderRunStep } from '../common/CoderRunStep';
 import type { PromptFile } from './types/PromptFile';
 import type { PromptSection } from './types/PromptSection';
 /**
- * Marks a prompt section as done and records usage pricing and runner details.
+ * Marks a prompt section as done and records the per-step usage pricing and runner details.
  */
-export declare function markPromptDone(file: PromptFile, section: PromptSection, usage: Usage, runnerName: string | undefined, modelName: string | undefined, promptExecutionStartedDate: moment.Moment, attemptCount?: number): void;
+export declare function markPromptDone(file: PromptFile, section: PromptSection, steps: ReadonlyArray<CoderRunStep>, runnerName: string | undefined, modelName: string | undefined, attemptCount?: number, loginMethod?: CodexLoginMethod, thinkingLevel?: ThinkingLevel): void;

package/umd/scripts/run-codex-prompts/prompts/printPromptsToBeWritten.d.ts

@@ -1,5 +1,6 @@
+import type { PriorityFilter } from './priorityFilter';
 import type { PromptFile } from './types/PromptFile';
 /**
  * Prints the list of prompts that still need to be written.
  */
-export declare function printPromptsToBeWritten(files: PromptFile[], minimumPriority?: number): void;
+export declare function printPromptsToBeWritten(files: PromptFile[], priorityFilter?: PriorityFilter): void;

package/umd/scripts/run-codex-prompts/prompts/printStats.d.ts

@@ -1,5 +1,6 @@
+import { type PriorityFilter } from './priorityFilter';
 import type { PromptStats } from './types/PromptStats';
 /**
  * Prints the summary stats line.
  */
-export declare function printStats(stats: PromptStats, minimumPriority?: number): void;
+export declare function printStats(stats: PromptStats, priorityFilter?: PriorityFilter): void;

package/umd/scripts/run-codex-prompts/prompts/priorityFilter.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Priority range used when selecting prompt sections for `ptbk coder`.
+ */
+export type PriorityFilter = {
+    /**
+     * Optional inclusive lower priority bound.
+     */
+    readonly minimumPriority?: number;
+    /**
+     * Optional inclusive upper priority bound.
+     */
+    readonly maximumPriority?: number;
+};
+/**
+ * Priority range input accepted from current and legacy option shapes.
+ */
+export type PriorityFilterInput = PriorityFilter & {
+    /**
+     * Legacy alias for `minimumPriority`.
+     */
+    readonly priority?: number;
+};
+/**
+ * Normalizes the current `minimumPriority` / `maximumPriority` options and the legacy
+ * `priority` alias into one validated priority filter.
+ */
+export declare function normalizePriorityFilter(priorityFilterInput?: PriorityFilterInput): PriorityFilter;
+/**
+ * Checks whether the provided priority is inside the inclusive priority filter.
+ */
+export declare function isPriorityInFilter(priority: number, priorityFilter?: PriorityFilter): boolean;
+/**
+ * Formats the priority filter as the scope shown in runner status output.
+ */
+export declare function formatPriorityFilter(priorityFilter: PriorityFilter): string;
+/**
+ * Formats the excluded priority range label used in summary counts.
+ */
+export declare function formatExcludedPriorityFilter(priorityFilter: PriorityFilter): string | undefined;

package/umd/scripts/run-codex-prompts/prompts/summarizePrompts.d.ts

@@ -1,6 +1,7 @@
 import type { PromptFile } from './types/PromptFile';
 import type { PromptStats } from './types/PromptStats';
+import type { PriorityFilter } from './priorityFilter';
 /**
  * Summarizes prompt stats for the runner output.
  */
-export declare function summarizePrompts(files: PromptFile[], minimumPriority?: number): PromptStats;
+export declare function summarizePrompts(files: PromptFile[], priorityFilter?: PriorityFilter): PromptStats;

package/umd/scripts/run-codex-prompts/prompts/writePromptErrorLog.d.ts

@@ -12,6 +12,8 @@ type WritePromptErrorLogOptions = {
 };
 /**
  * Writes the failure details for a single prompt run next to the prompt markdown file.
+ *
+ * Returns the path of the written log so callers can include it in a commit.
  */
-export declare function writePromptErrorLog(options: WritePromptErrorLogOptions): Promise<void>;
+export declare function writePromptErrorLog(options: WritePromptErrorLogOptions): Promise<string>;
 export {};

package/umd/scripts/run-codex-prompts/runners/claude-code/ClaudeCodeRunner.d.ts

@@ -16,4 +16,8 @@ export declare class ClaudeCodeRunner implements PromptRunner {
      * Runs the prompt using Claude Code and parses usage output.
      */
     runPrompt(options: PromptRunOptions): Promise<PromptRunResult>;
+    /**
+     * Runs one Claude Code CLI process and returns its raw output.
+     */
+    private runClaudeCodeOnce;
 }

package/umd/scripts/run-codex-prompts/runners/claude-code/ClaudeCodeSessionResurrection.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Number of milliseconds added after Claude's reported reset timestamp before retrying.
+ */
+export declare const CLAUDE_CODE_SESSION_LIMIT_RESET_BUFFER_MS: number;
+/**
+ * Fallback delay used when Claude reports a session limit without a machine-readable reset timestamp.
+ */
+export declare const DEFAULT_CLAUDE_CODE_SESSION_LIMIT_RETRY_DELAY_MS: number;
+/**
+ * Session-limit detection details needed to resume a Claude Code run.
+ */
+export type ClaudeCodeSessionLimit = {
+    readonly sessionId: string;
+    readonly resetDate?: Date;
+    readonly rateLimitType?: string;
+    readonly summary: string;
+};
+/**
+ * Extracts a Claude Code session-limit failure from a thrown runner error.
+ */
+export declare function extractClaudeCodeSessionLimitFromError(error: unknown): ClaudeCodeSessionLimit | undefined;
+/**
+ * Extracts a Claude Code session-limit failure from raw stream-json output.
+ */
+export declare function extractClaudeCodeSessionLimitFromOutput(output: string): ClaudeCodeSessionLimit | undefined;
+/**
+ * Computes how long to wait before trying to resume the Claude Code session.
+ */
+export declare function getClaudeCodeSessionLimitDelayMs(sessionLimit: ClaudeCodeSessionLimit, nowMs?: number): number;
+/**
+ * Builds the follow-up prompt sent into a resumed Claude Code session after its limit resets.
+ */
+export declare function buildClaudeCodeSessionResurrectionPrompt(originalPrompt: string, sessionId: string): string;
+/**
+ * Builds a compact one-line label for logs and terminal UI messages.
+ */
+export declare function formatClaudeCodeSessionLimitForDisplay(sessionLimit: ClaudeCodeSessionLimit): string;

package/umd/scripts/run-codex-prompts/runners/claude-code/parseClaudeCodeOutputEvents.d.ts

@@ -0,0 +1,47 @@
+/**
+ * One parsed JSON event emitted by the Claude Code `--output-format stream-json` mode.
+ */
+export type ClaudeCodeOutputEvent = {
+    readonly type?: string;
+    readonly subtype?: string;
+    readonly is_error?: boolean;
+    readonly api_error_status?: number;
+    readonly result?: string;
+    readonly session_id?: string;
+    readonly error?: string;
+    readonly rate_limit_info?: {
+        readonly status?: string;
+        readonly resetsAt?: number;
+        readonly rateLimitType?: string;
+    };
+    readonly usage?: {
+        readonly input_tokens?: number;
+        readonly cache_creation_input_tokens?: number;
+        readonly cache_read_input_tokens?: number;
+        readonly output_tokens?: number;
+        readonly server_tool_use?: {
+            readonly web_search_requests?: number;
+            readonly web_fetch_requests?: number;
+        };
+        readonly service_tier?: string;
+        readonly cache_creation?: {
+            readonly ephemeral_1h_input_tokens?: number;
+            readonly ephemeral_5m_input_tokens?: number;
+        };
+    };
+    readonly total_cost_usd?: number;
+    readonly message?: {
+        readonly content?: ReadonlyArray<{
+            readonly type?: string;
+            readonly text?: string;
+        }>;
+    };
+};
+/**
+ * Parses all JSON lines from Claude Code output while ignoring shell prefixes and stack traces.
+ */
+export declare function parseClaudeCodeOutputEvents(output: string): readonly ClaudeCodeOutputEvent[];
+/**
+ * Finds the final Claude Code result event in a stream-json output blob.
+ */
+export declare function findClaudeCodeResultEvent(output: string): ClaudeCodeOutputEvent | undefined;

package/umd/scripts/run-codex-prompts/runners/openai-codex/parseCodexLoginMethodFromOutput.d.ts

@@ -0,0 +1,10 @@
+import { type CodexLoginMethod } from '../../../../src/book-3.0/codexLoginMethod';
+/**
+ * Detects which login method Codex used from the captured CLI output.
+ *
+ * The generated Codex runner script prints one `CODEX_LOGIN_METHOD_MARKER` line before invoking Codex.
+ * The most recent marker wins so retries within one captured output resolve to the final decision.
+ *
+ * @returns The resolved login method, or `unknown` when no marker is present.
+ */
+export declare function parseCodexLoginMethodFromOutput(output: string): CodexLoginMethod;

package/umd/scripts/run-codex-prompts/server/buildCoderServerPromptResponse.d.ts

@@ -1,3 +1,4 @@
+import type { PriorityFilter } from '../prompts/priorityFilter';
 import type { PromptFile } from '../prompts/types/PromptFile';
 import type { PromptStatus } from '../prompts/types/PromptStatus';
 import type { CoderRunUiState } from '../ui/CoderRunUiState';
@@ -41,7 +42,7 @@ export type CoderServerPromptFileResponse = {
 export type BuildCoderServerPromptFileResponsesOptions = {
     readonly promptFiles: readonly PromptFile[];
     readonly finishedPromptFiles: readonly PromptFile[];
-    readonly minimumPriority: number;
+    readonly priorityFilter: PriorityFilter;
     readonly uiState?: CoderRunUiState;
 };
 /**

package/umd/scripts/run-codex-prompts/server/coderServerHtml.d.ts

@@ -6,4 +6,4 @@
  *
  * @private internal constant of `ptbk coder server`
  */
-export declare const CODER_SERVER_HTML = "<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n  <meta charset=\"UTF-8\">\n  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n  <title>Ptbk Coder Server</title>\n  <style>\n    * { box-sizing: border-box; margin: 0; padding: 0; }\n    body {\n      font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif;\n      background: #f6f7f9;\n      color: #1f2933;\n      min-height: 100vh;\n    }\n\n    header {\n      background: #22313f;\n      color: white;\n      padding: 12px 18px;\n      display: flex;\n      align-items: center;\n      gap: 12px;\n      position: sticky;\n      top: 0;\n      z-index: 10;\n      box-shadow: 0 2px 10px rgba(15,23,42,0.22);\n    }\n    header h1 { font-size: 17px; font-weight: 700; flex-shrink: 0; letter-spacing: 0; }\n\n    .status-badge {\n      padding: 3px 10px;\n      border-radius: 999px;\n      font-size: 11px;\n      font-weight: 700;\n      text-transform: uppercase;\n      flex-shrink: 0;\n    }\n    .status-RUNNING { background: #0b875b; color: white; }\n    .status-PAUSING { background: #d97904; color: white; }\n    .status-PAUSED { background: #b42318; color: white; }\n\n    #pause-label {\n      font-size: 12px;\n      color: rgba(255,255,255,0.75);\n      flex: 1;\n      min-width: 0;\n      overflow: hidden;\n      text-overflow: ellipsis;\n      white-space: nowrap;\n    }\n\n    .btn {\n      padding: 6px 12px;\n      border: 0;\n      border-radius: 4px;\n      cursor: pointer;\n      font-size: 13px;\n      font-weight: 700;\n      transition: background 0.15s, opacity 0.15s;\n      flex-shrink: 0;\n    }\n    .btn:disabled { opacity: 0.55; cursor: default; }\n    .btn-pause { background: #ffd166; color: #1f2933; }\n    .btn-resume { background: #0b875b; color: white; }\n    .btn-save { background: #2563eb; color: white; }\n    .btn-cancel { background: #edf0f4; color: #1f2933; }\n\n    .run-strip {\n      background: white;\n      border-bottom: 1px solid #d8dee8;\n      padding: 12px 18px;\n      display: grid;\n      grid-template-columns: minmax(220px, 1.2fr) minmax(240px, 1fr) minmax(260px, 1.4fr);\n      gap: 14px;\n      align-items: center;\n    }\n    .run-title {\n      font-size: 14px;\n      font-weight: 700;\n      overflow: hidden;\n      text-overflow: ellipsis;\n      white-space: nowrap;\n    }\n    .run-subtitle,\n    .run-current,\n    .run-output {\n      color: #64748b;\n      font-size: 12px;\n      line-height: 1.45;\n      overflow: hidden;\n    }\n    .run-current,\n    .run-output {\n      display: -webkit-box;\n      -webkit-box-orient: vertical;\n      -webkit-line-clamp: 2;\n    }\n    .progress-shell {\n      display: grid;\n      grid-template-columns: 1fr auto;\n      gap: 8px;\n      align-items: center;\n    }\n    .progress-track {\n      height: 10px;\n      background: #e4e9f0;\n      border-radius: 999px;\n      overflow: hidden;\n    }\n    .progress-fill {\n      display: block;\n      height: 100%;\n      width: 0;\n      background: linear-gradient(90deg, #0b875b, #2563eb);\n      transition: width 0.2s;\n    }\n    .progress-label {\n      color: #475569;\n      font-size: 12px;\n      font-weight: 700;\n      min-width: 72px;\n      text-align: right;\n    }\n\n    .board {\n      display: flex;\n      gap: 14px;\n      padding: 16px;\n      overflow-x: auto;\n      min-height: calc(100vh - 119px);\n      align-items: flex-start;\n    }\n\n    .column {\n      background: #e9edf3;\n      border-top: 4px solid #94a3b8;\n      border-radius: 6px;\n      padding: 10px;\n      min-width: 250px;\n      width: 270px;\n      flex-shrink: 0;\n    }\n    .column-backlog { border-top-color: #64748b; }\n    .column-low-priority { border-top-color: #d97904; }\n    .column-todo { border-top-color: #2563eb; }\n    .column-in-progress { border-top-color: #7c3aed; }\n    .column-done { border-top-color: #0b875b; }\n    .column-errors { border-top-color: #b42318; }\n    .column-finished { border-top-color: #0891b2; }\n\n    .column-header {\n      font-size: 12px;\n      font-weight: 800;\n      text-transform: uppercase;\n      color: #475569;\n      margin-bottom: 10px;\n      display: flex;\n      align-items: center;\n      justify-content: space-between;\n      gap: 8px;\n    }\n    .column-count {\n      background: rgba(255,255,255,0.72);\n      border-radius: 999px;\n      padding: 2px 8px;\n      font-size: 11px;\n      color: #475569;\n    }\n    .column-cards { min-height: 40px; }\n\n    .card {\n      background: white;\n      border-radius: 6px;\n      padding: 10px 12px;\n      margin-bottom: 8px;\n      box-shadow: 0 1px 3px rgba(15,23,42,0.12);\n      cursor: pointer;\n      border-left: 3px solid #94a3b8;\n    }\n    .card:hover { box-shadow: 0 4px 12px rgba(15,23,42,0.16); }\n    .card-backlog { border-left-color: #64748b; }\n    .card-low-priority { border-left-color: #d97904; }\n    .card-todo { border-left-color: #2563eb; }\n    .card-in-progress { border-left-color: #7c3aed; }\n    .card-done { border-left-color: #0b875b; }\n    .card-errors { border-left-color: #b42318; }\n    .card-finished { border-left-color: #0891b2; }\n\n    .card-file {\n      font-size: 10px;\n      color: #7b8794;\n      margin-bottom: 6px;\n      font-weight: 600;\n      overflow: hidden;\n      text-overflow: ellipsis;\n      white-space: nowrap;\n    }\n    .card-summary {\n      font-size: 13px;\n      line-height: 1.45;\n      color: #1f2933;\n      word-break: break-word;\n      white-space: pre-wrap;\n      max-height: 76px;\n      overflow: hidden;\n      display: -webkit-box;\n      -webkit-line-clamp: 4;\n      -webkit-box-orient: vertical;\n    }\n    .card-tags {\n      display: flex;\n      flex-wrap: wrap;\n      gap: 5px;\n      margin-top: 8px;\n    }\n    .card-tag {\n      border-radius: 999px;\n      padding: 2px 7px;\n      font-size: 10px;\n      font-weight: 800;\n      line-height: 1.35;\n    }\n    .tag-not-ready { background: #e2e8f0; color: #475569; }\n    .tag-unwritten { background: #fff4cc; color: #8a5a00; }\n    .tag-implementing { background: #ede9fe; color: #5b21b6; }\n    .tag-verifying { background: #fae8ff; color: #86198f; }\n    .tag-priority { background: #ffedd5; color: #9a3412; }\n\n    .empty-column {\n      color: #94a3b8;\n      font-size: 12px;\n      padding: 10px 4px;\n      text-align: center;\n    }\n\n    .modal-overlay {\n      position: fixed;\n      inset: 0;\n      background: rgba(15,23,42,0.58);\n      display: flex;\n      align-items: flex-start;\n      justify-content: center;\n      padding: 56px 16px 16px;\n      z-index: 100;\n    }\n    .modal-overlay.hidden { display: none; }\n\n    .modal {\n      background: white;\n      border-radius: 8px;\n      width: 100%;\n      max-width: 720px;\n      padding: 18px;\n      box-shadow: 0 14px 40px rgba(15,23,42,0.28);\n    }\n    .modal-header {\n      display: flex;\n      align-items: flex-start;\n      justify-content: space-between;\n      margin-bottom: 14px;\n      gap: 12px;\n    }\n    .modal-meta { flex: 1; min-width: 0; }\n    .modal-file {\n      font-size: 11px;\n      color: #7b8794;\n      margin-bottom: 4px;\n      overflow: hidden;\n      text-overflow: ellipsis;\n      white-space: nowrap;\n    }\n    .modal-section-label { font-size: 14px; font-weight: 700; color: #1f2933; }\n    .modal-status {\n      font-size: 11px;\n      font-weight: 800;\n      padding: 3px 8px;\n      border-radius: 999px;\n      text-transform: uppercase;\n      flex-shrink: 0;\n    }\n    .status-backlog { background: #e2e8f0; color: #475569; }\n    .status-low-priority { background: #ffedd5; color: #9a3412; }\n    .status-todo { background: #dbeafe; color: #1d4ed8; }\n    .status-in-progress { background: #ede9fe; color: #5b21b6; }\n    .status-done { background: #dcfce7; color: #166534; }\n    .status-errors { background: #fee2e2; color: #991b1b; }\n    .status-finished { background: #cffafe; color: #155e75; }\n    .modal-close {\n      background: transparent;\n      border: 0;\n      color: #64748b;\n      cursor: pointer;\n      font-size: 20px;\n      padding: 0 4px;\n      line-height: 1;\n    }\n    .modal-close:hover { color: #1f2933; }\n\n    textarea {\n      width: 100%;\n      min-height: 300px;\n      font-family: \"SFMono-Regular\", Consolas, \"Courier New\", monospace;\n      font-size: 13px;\n      border: 2px solid #d8dee8;\n      border-radius: 4px;\n      padding: 10px 12px;\n      resize: vertical;\n      line-height: 1.6;\n      color: #1f2933;\n    }\n    textarea:focus {\n      outline: none;\n      border-color: #2563eb;\n      box-shadow: 0 0 0 3px rgba(37,99,235,0.12);\n    }\n    .modal-actions {\n      display: flex;\n      gap: 8px;\n      margin-top: 14px;\n      justify-content: flex-end;\n    }\n\n    .error-banner {\n      background: #fee2e2;\n      border-bottom: 2px solid #b42318;\n      color: #991b1b;\n      padding: 8px 18px;\n      font-size: 13px;\n      font-weight: 700;\n    }\n    .error-banner.hidden { display: none; }\n\n    @media (max-width: 860px) {\n      header { flex-wrap: wrap; }\n      #pause-label { order: 4; flex-basis: 100%; }\n      .run-strip { grid-template-columns: 1fr; }\n      .board { min-height: calc(100vh - 212px); }\n    }\n  </style>\n</head>\n<body>\n  <div id=\"error-banner\" class=\"error-banner hidden\"></div>\n\n  <header>\n    <h1>Ptbk Coder Server</h1>\n    <span id=\"status-badge\" class=\"status-badge status-RUNNING\">RUNNING</span>\n    <span id=\"pause-label\"></span>\n    <button id=\"toggle-btn\" class=\"btn btn-pause\">Pause</button>\n  </header>\n\n  <section class=\"run-strip\">\n    <div>\n      <div class=\"run-title\" id=\"run-title\">Initializing...</div>\n      <div class=\"run-subtitle\" id=\"run-subtitle\">Loading runner state</div>\n    </div>\n    <div class=\"progress-shell\">\n      <div class=\"progress-track\"><span class=\"progress-fill\" id=\"progress-fill\"></span></div>\n      <div class=\"progress-label\" id=\"progress-label\">0%</div>\n    </div>\n    <div>\n      <div class=\"run-current\" id=\"run-current\">No active prompt</div>\n      <div class=\"run-output\" id=\"run-output\"></div>\n    </div>\n  </section>\n\n  <div class=\"board\" id=\"board\"></div>\n\n  <div class=\"modal-overlay hidden\" id=\"modal-overlay\">\n    <div class=\"modal\">\n      <div class=\"modal-header\">\n        <div class=\"modal-meta\">\n          <div class=\"modal-file\" id=\"modal-file\"></div>\n          <div class=\"modal-section-label\" id=\"modal-section-label\"></div>\n        </div>\n        <span class=\"modal-status\" id=\"modal-status-badge\"></span>\n        <button class=\"modal-close\" id=\"modal-close\" title=\"Close\">&times;</button>\n      </div>\n\n      <textarea id=\"modal-content\" placeholder=\"Prompt content\"></textarea>\n\n      <div class=\"modal-actions\">\n        <button class=\"btn btn-cancel\" id=\"cancel-button\">Cancel</button>\n        <button class=\"btn btn-save\" id=\"save-button\">Save</button>\n      </div>\n    </div>\n  </div>\n\n  <script>\n    \"use strict\";\n\n    const BOARD_COLUMNS = [\n      { id: \"backlog\", title: \"Backlog\" },\n      { id: \"low-priority\", title: \"Low priority\" },\n      { id: \"todo\", title: \"To do\" },\n      { id: \"in-progress\", title: \"In progress\" },\n      { id: \"done\", title: \"Done\" },\n      { id: \"errors\", title: \"Errors\" },\n      { id: \"finished\", title: \"Finished\" },\n    ];\n\n    let modalState = null;\n    let lastPauseState = \"RUNNING\";\n\n    function getColumnTitle(columnId) {\n      const column = BOARD_COLUMNS.find((columnCandidate) => columnCandidate.id === columnId);\n      return column ? column.title : columnId;\n    }\n\n    function showError(message) {\n      const banner = document.getElementById(\"error-banner\");\n      banner.textContent = message;\n      banner.classList.remove(\"hidden\");\n      clearTimeout(banner.timer);\n      banner.timer = setTimeout(() => banner.classList.add(\"hidden\"), 6000);\n    }\n\n    function escapeHtml(value) {\n      const element = document.createElement(\"div\");\n      element.textContent = String(value);\n      return element.innerHTML;\n    }\n\n    function renderBoardSkeleton() {\n      const board = document.getElementById(\"board\");\n      board.innerHTML = \"\";\n\n      for (const column of BOARD_COLUMNS) {\n        const columnElement = document.createElement(\"section\");\n        columnElement.className = \"column column-\" + column.id;\n        columnElement.innerHTML =\n          '<div class=\"column-header\">' +\n            '<span>' + escapeHtml(column.title) + '</span>' +\n            '<span class=\"column-count\" id=\"count-' + column.id + '\">0</span>' +\n          '</div>' +\n          '<div class=\"column-cards\" id=\"cards-' + column.id + '\">' +\n            '<div class=\"empty-column\">Loading</div>' +\n          '</div>';\n        board.appendChild(columnElement);\n      }\n    }\n\n    async function fetchStatus() {\n      try {\n        const response = await fetch(\"/api/status\");\n        if (!response.ok) {\n          showError(\"Status API error: \" + response.status);\n          return;\n        }\n\n        const status = await response.json();\n        renderPauseState(status);\n        renderRunState(status.runState);\n      } catch (error) {\n        showError(\"Could not reach coder server: \" + error.message);\n      }\n    }\n\n    function renderPauseState(status) {\n      lastPauseState = status.pauseState;\n\n      const badge = document.getElementById(\"status-badge\");\n      badge.textContent = status.pauseState;\n      badge.className = \"status-badge status-\" + status.pauseState;\n\n      const toggleButton = document.getElementById(\"toggle-btn\");\n      const pauseLabel = document.getElementById(\"pause-label\");\n\n      if (status.pauseState === \"RUNNING\") {\n        toggleButton.textContent = \"Pause\";\n        toggleButton.className = \"btn btn-pause\";\n        pauseLabel.textContent = \"\";\n        return;\n      }\n\n      toggleButton.textContent = \"Resume\";\n      toggleButton.className = \"btn btn-resume\";\n      pauseLabel.textContent =\n        (status.pauseState === \"PAUSING\" ? \"Pausing before: \" : \"Paused before: \") +\n        (status.pauseTargetLabel || \"next checkpoint\");\n    }\n\n    function renderRunState(runState) {\n      if (!runState) {\n        document.getElementById(\"run-title\").textContent = \"Waiting for runner state\";\n        document.getElementById(\"run-subtitle\").textContent = \"\";\n        return;\n      }\n\n      const progress = runState.progress || {};\n      const percentage = Number(progress.percentage || 0);\n      const runnerParts = [runState.config.agentName, runState.config.modelName, runState.config.thinkingLevel]\n        .filter(Boolean);\n\n      document.getElementById(\"run-title\").textContent = runState.statusMessage || runState.phase;\n      document.getElementById(\"run-subtitle\").textContent = runnerParts.join(\" / \");\n      document.getElementById(\"progress-fill\").style.width = Math.max(0, Math.min(100, percentage)) + \"%\";\n      document.getElementById(\"progress-label\").textContent =\n        percentage + \"% \" + (progress.sessionDone || 0) + \"/\" + (progress.sessionTotal || 0);\n      document.getElementById(\"run-current\").textContent = runState.currentPromptLabel\n        ? runState.currentPromptLabel + \" - attempt \" + runState.currentAttempt + \"/\" + runState.maxAttempts\n        : \"No active prompt\";\n\n      renderRunOutput(runState);\n    }\n\n    function renderRunOutput(runState) {\n      const statusLines = (runState.agentStatusTableRows || []).map((row) =>\n        row.status + \" - \" + row.agentName + (row.url ? \" - \" + row.url : \"\")\n      );\n      const outputLines = [\n        ...(runState.agentStatusLines || []),\n        ...statusLines,\n        ...(runState.agentOutputLines || []),\n        ...(runState.errors || []).map((errorLine) => \"Error: \" + errorLine),\n      ].slice(-3);\n\n      document.getElementById(\"run-output\").textContent = outputLines.join(\"\\n\");\n    }\n\n    async function fetchPrompts() {\n      try {\n        const response = await fetch(\"/api/prompts\");\n        if (!response.ok) {\n          showError(\"Prompts API error: \" + response.status);\n          return;\n        }\n\n        renderBoard(await response.json());\n      } catch (error) {\n        showError(\"Could not load prompts: \" + error.message);\n      }\n    }\n\n    function renderBoard(promptFiles) {\n      const columns = Object.fromEntries(BOARD_COLUMNS.map((column) => [column.id, []]));\n\n      for (const file of promptFiles) {\n        for (const section of file.sections) {\n          if (columns[section.column]) {\n            columns[section.column].push({ file, section });\n          }\n        }\n      }\n\n      for (const column of BOARD_COLUMNS) {\n        renderColumn(column.id, columns[column.id]);\n      }\n    }\n\n    function renderColumn(columnId, cards) {\n      const container = document.getElementById(\"cards-\" + columnId);\n      const countElement = document.getElementById(\"count-\" + columnId);\n\n      countElement.textContent = cards.length;\n      container.innerHTML = \"\";\n\n      if (cards.length === 0) {\n        container.innerHTML = '<div class=\"empty-column\">Empty</div>';\n        return;\n      }\n\n      for (const cardData of cards) {\n        container.appendChild(createPromptCard(cardData.file, cardData.section));\n      }\n    }\n\n    function createPromptCard(file, section) {\n      const card = document.createElement(\"article\");\n      card.className = \"card card-\" + section.column;\n      card.innerHTML =\n        '<div class=\"card-file\">' + escapeHtml(file.relativeFilePath || file.fileName) + \" #\" + (section.index + 1) + '</div>' +\n        '<div class=\"card-summary\">' + escapeHtml(section.summary) + '</div>' +\n        renderTags(section);\n      card.onclick = () => openModal(file, section);\n      return card;\n    }\n\n    function renderTags(section) {\n      const tags = [...(section.tags || [])];\n      if (section.priority > 0) {\n        tags.push({ id: \"priority\", label: \"P\" + section.priority });\n      }\n\n      if (tags.length === 0) {\n        return \"\";\n      }\n\n      return '<div class=\"card-tags\">' + tags.map((tag) =>\n        '<span class=\"card-tag tag-' + escapeHtml(tag.id) + '\">' + escapeHtml(tag.label) + '</span>'\n      ).join(\"\") + '</div>';\n    }\n\n    function openModal(file, section) {\n      modalState = { filePath: file.filePath, sectionIndex: section.index };\n\n      document.getElementById(\"modal-file\").textContent = file.relativeFilePath || file.fileName;\n      document.getElementById(\"modal-section-label\").textContent = \"Section \" + (section.index + 1);\n\n      const statusBadge = document.getElementById(\"modal-status-badge\");\n      statusBadge.textContent = getColumnTitle(section.column);\n      statusBadge.className = \"modal-status status-\" + section.column;\n\n      document.getElementById(\"modal-content\").value = section.content;\n      document.getElementById(\"modal-overlay\").classList.remove(\"hidden\");\n      setTimeout(() => document.getElementById(\"modal-content\").focus(), 50);\n    }\n\n    function closeModal() {\n      document.getElementById(\"modal-overlay\").classList.add(\"hidden\");\n      modalState = null;\n    }\n\n    async function saveModal() {\n      if (!modalState) {\n        return;\n      }\n\n      const content = document.getElementById(\"modal-content\").value;\n      const saveButton = document.getElementById(\"save-button\");\n      saveButton.disabled = true;\n      saveButton.textContent = \"Saving...\";\n\n      try {\n        const response = await fetch(\"/api/prompts/update\", {\n          method: \"PUT\",\n          headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify({\n            filePath: modalState.filePath,\n            sectionIndex: modalState.sectionIndex,\n            content,\n          }),\n        });\n\n        if (!response.ok) {\n          throw new Error(\"HTTP \" + response.status);\n        }\n\n        closeModal();\n        await fetchPrompts();\n      } catch (error) {\n        showError(\"Save failed: \" + error.message);\n      } finally {\n        saveButton.disabled = false;\n        saveButton.textContent = \"Save\";\n      }\n    }\n\n    document.getElementById(\"toggle-btn\").onclick = async () => {\n      try {\n        const endpoint = lastPauseState === \"RUNNING\" ? \"/api/pause\" : \"/api/resume\";\n        await fetch(endpoint, { method: \"POST\" });\n        await fetchStatus();\n      } catch (error) {\n        showError(\"Toggle failed: \" + error.message);\n      }\n    };\n\n    document.getElementById(\"modal-close\").onclick = closeModal;\n    document.getElementById(\"cancel-button\").onclick = closeModal;\n    document.getElementById(\"save-button\").onclick = saveModal;\n\n    document.addEventListener(\"keydown\", (event) => {\n      if (event.key === \"Escape\") {\n        closeModal();\n        return;\n      }\n      if ((event.ctrlKey || event.metaKey) && event.key === \"Enter\") {\n        saveModal();\n      }\n    });\n\n    document.getElementById(\"modal-overlay\").addEventListener(\"click\", (event) => {\n      if (event.target === document.getElementById(\"modal-overlay\")) {\n        closeModal();\n      }\n    });\n\n    renderBoardSkeleton();\n    fetchStatus();\n    fetchPrompts();\n    setInterval(fetchStatus, 2000);\n    setInterval(fetchPrompts, 5000);\n  </script>\n</body>\n</html>\n";
+export declare const CODER_SERVER_HTML = "<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n  <meta charset=\"UTF-8\">\n  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n  <title>Ptbk Coder Server</title>\n  <style>\n    * { box-sizing: border-box; margin: 0; padding: 0; }\n    body {\n      font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif;\n      background: #f6f7f9;\n      color: #1f2933;\n      min-height: 100vh;\n    }\n\n    header {\n      background: #22313f;\n      color: white;\n      padding: 12px 18px;\n      display: flex;\n      align-items: center;\n      gap: 12px;\n      position: sticky;\n      top: 0;\n      z-index: 10;\n      box-shadow: 0 2px 10px rgba(15,23,42,0.22);\n    }\n    header h1 { font-size: 17px; font-weight: 700; flex-shrink: 0; letter-spacing: 0; }\n\n    .status-badge {\n      padding: 3px 10px;\n      border-radius: 999px;\n      font-size: 11px;\n      font-weight: 700;\n      text-transform: uppercase;\n      flex-shrink: 0;\n    }\n    .status-RUNNING { background: #0b875b; color: white; }\n    .status-PAUSING { background: #d97904; color: white; }\n    .status-PAUSED { background: #b42318; color: white; }\n\n    #pause-label {\n      font-size: 12px;\n      color: rgba(255,255,255,0.75);\n      flex: 1;\n      min-width: 0;\n      overflow: hidden;\n      text-overflow: ellipsis;\n      white-space: nowrap;\n    }\n\n    .btn {\n      padding: 6px 12px;\n      border: 0;\n      border-radius: 4px;\n      cursor: pointer;\n      font-size: 13px;\n      font-weight: 700;\n      transition: background 0.15s, opacity 0.15s;\n      flex-shrink: 0;\n    }\n    .btn:disabled { opacity: 0.55; cursor: default; }\n    .btn-pause { background: #ffd166; color: #1f2933; }\n    .btn-resume { background: #0b875b; color: white; }\n    .btn-save { background: #2563eb; color: white; }\n    .btn-cancel { background: #edf0f4; color: #1f2933; }\n\n    .run-strip {\n      background: white;\n      border-bottom: 1px solid #d8dee8;\n      padding: 12px 18px;\n      display: grid;\n      grid-template-columns: minmax(220px, 1.2fr) minmax(240px, 1fr) minmax(260px, 1.4fr);\n      gap: 14px;\n      align-items: center;\n    }\n    .run-title {\n      font-size: 14px;\n      font-weight: 700;\n      overflow: hidden;\n      text-overflow: ellipsis;\n      white-space: nowrap;\n    }\n    .run-subtitle,\n    .run-current,\n    .run-output {\n      color: #64748b;\n      font-size: 12px;\n      line-height: 1.45;\n      overflow: hidden;\n    }\n    .run-current,\n    .run-output {\n      display: -webkit-box;\n      -webkit-box-orient: vertical;\n      -webkit-line-clamp: 2;\n    }\n    .progress-shell {\n      display: grid;\n      grid-template-columns: 1fr auto;\n      gap: 8px;\n      align-items: center;\n    }\n    .progress-track {\n      height: 10px;\n      background: #e4e9f0;\n      border-radius: 999px;\n      overflow: hidden;\n    }\n    .progress-fill {\n      display: block;\n      height: 100%;\n      width: 0;\n      background: linear-gradient(90deg, #0b875b, #2563eb);\n      transition: width 0.2s;\n    }\n    .progress-label {\n      color: #475569;\n      font-size: 12px;\n      font-weight: 700;\n      min-width: 72px;\n      text-align: right;\n    }\n\n    .board {\n      display: flex;\n      gap: 14px;\n      padding: 16px;\n      overflow-x: auto;\n      min-height: calc(100vh - 119px);\n      align-items: flex-start;\n    }\n\n    .column {\n      background: #e9edf3;\n      border-top: 4px solid #94a3b8;\n      border-radius: 6px;\n      padding: 10px;\n      min-width: 250px;\n      width: 270px;\n      flex-shrink: 0;\n    }\n    .column-backlog { border-top-color: #64748b; }\n    .column-low-priority { border-top-color: #d97904; }\n    .column-todo { border-top-color: #2563eb; }\n    .column-in-progress { border-top-color: #7c3aed; }\n    .column-done { border-top-color: #0b875b; }\n    .column-errors { border-top-color: #b42318; }\n    .column-finished { border-top-color: #0891b2; }\n\n    .column-header {\n      font-size: 12px;\n      font-weight: 800;\n      text-transform: uppercase;\n      color: #475569;\n      margin-bottom: 10px;\n      display: flex;\n      align-items: center;\n      justify-content: space-between;\n      gap: 8px;\n    }\n    .column-count {\n      background: rgba(255,255,255,0.72);\n      border-radius: 999px;\n      padding: 2px 8px;\n      font-size: 11px;\n      color: #475569;\n    }\n    .column-cards { min-height: 40px; }\n\n    .card {\n      background: white;\n      border-radius: 6px;\n      padding: 10px 12px;\n      margin-bottom: 8px;\n      box-shadow: 0 1px 3px rgba(15,23,42,0.12);\n      cursor: pointer;\n      border-left: 3px solid #94a3b8;\n    }\n    .card:hover { box-shadow: 0 4px 12px rgba(15,23,42,0.16); }\n    .card-backlog { border-left-color: #64748b; }\n    .card-low-priority { border-left-color: #d97904; }\n    .card-todo { border-left-color: #2563eb; }\n    .card-in-progress { border-left-color: #7c3aed; }\n    .card-done { border-left-color: #0b875b; }\n    .card-errors { border-left-color: #b42318; }\n    .card-finished { border-left-color: #0891b2; }\n\n    .card-file {\n      font-size: 10px;\n      color: #7b8794;\n      margin-bottom: 6px;\n      font-weight: 600;\n      overflow: hidden;\n      text-overflow: ellipsis;\n      white-space: nowrap;\n    }\n    .card-summary {\n      font-size: 13px;\n      line-height: 1.45;\n      color: #1f2933;\n      word-break: break-word;\n      white-space: pre-wrap;\n      max-height: 76px;\n      overflow: hidden;\n      display: -webkit-box;\n      -webkit-line-clamp: 4;\n      -webkit-box-orient: vertical;\n    }\n    .card-tags {\n      display: flex;\n      flex-wrap: wrap;\n      gap: 5px;\n      margin-top: 8px;\n    }\n    .card-tag {\n      border-radius: 999px;\n      padding: 2px 7px;\n      font-size: 10px;\n      font-weight: 800;\n      line-height: 1.35;\n    }\n    .tag-not-ready { background: #e2e8f0; color: #475569; }\n    .tag-unwritten { background: #fff4cc; color: #8a5a00; }\n    .tag-implementing { background: #ede9fe; color: #5b21b6; }\n    .tag-verifying { background: #fae8ff; color: #86198f; }\n    .tag-priority { background: #ffedd5; color: #9a3412; }\n\n    .empty-column {\n      color: #94a3b8;\n      font-size: 12px;\n      padding: 10px 4px;\n      text-align: center;\n    }\n\n    .modal-overlay {\n      position: fixed;\n      inset: 0;\n      background: rgba(15,23,42,0.58);\n      display: flex;\n      align-items: flex-start;\n      justify-content: center;\n      padding: 56px 16px 16px;\n      z-index: 100;\n    }\n    .modal-overlay.hidden { display: none; }\n\n    .modal {\n      background: white;\n      border-radius: 8px;\n      width: 100%;\n      max-width: 720px;\n      padding: 18px;\n      box-shadow: 0 14px 40px rgba(15,23,42,0.28);\n    }\n    .modal-header {\n      display: flex;\n      align-items: flex-start;\n      justify-content: space-between;\n      margin-bottom: 14px;\n      gap: 12px;\n    }\n    .modal-meta { flex: 1; min-width: 0; }\n    .modal-file {\n      font-size: 11px;\n      color: #7b8794;\n      margin-bottom: 4px;\n      overflow: hidden;\n      text-overflow: ellipsis;\n      white-space: nowrap;\n    }\n    .modal-section-label { font-size: 14px; font-weight: 700; color: #1f2933; }\n    .modal-status {\n      font-size: 11px;\n      font-weight: 800;\n      padding: 3px 8px;\n      border-radius: 999px;\n      text-transform: uppercase;\n      flex-shrink: 0;\n    }\n    .status-backlog { background: #e2e8f0; color: #475569; }\n    .status-low-priority { background: #ffedd5; color: #9a3412; }\n    .status-todo { background: #dbeafe; color: #1d4ed8; }\n    .status-in-progress { background: #ede9fe; color: #5b21b6; }\n    .status-done { background: #dcfce7; color: #166534; }\n    .status-errors { background: #fee2e2; color: #991b1b; }\n    .status-finished { background: #cffafe; color: #155e75; }\n    .modal-close {\n      background: transparent;\n      border: 0;\n      color: #64748b;\n      cursor: pointer;\n      font-size: 20px;\n      padding: 0 4px;\n      line-height: 1;\n    }\n    .modal-close:hover { color: #1f2933; }\n\n    textarea {\n      width: 100%;\n      min-height: 300px;\n      font-family: \"SFMono-Regular\", Consolas, \"Courier New\", monospace;\n      font-size: 13px;\n      border: 2px solid #d8dee8;\n      border-radius: 4px;\n      padding: 10px 12px;\n      resize: vertical;\n      line-height: 1.6;\n      color: #1f2933;\n    }\n    textarea:focus {\n      outline: none;\n      border-color: #2563eb;\n      box-shadow: 0 0 0 3px rgba(37,99,235,0.12);\n    }\n    .modal-actions {\n      display: flex;\n      gap: 8px;\n      margin-top: 14px;\n      justify-content: flex-end;\n    }\n\n    .error-banner {\n      background: #fee2e2;\n      border-bottom: 2px solid #b42318;\n      color: #991b1b;\n      padding: 8px 18px;\n      font-size: 13px;\n      font-weight: 700;\n    }\n    .error-banner.hidden { display: none; }\n\n    @media (max-width: 860px) {\n      header { flex-wrap: wrap; }\n      #pause-label { order: 4; flex-basis: 100%; }\n      .run-strip { grid-template-columns: 1fr; }\n      .board { min-height: calc(100vh - 212px); }\n    }\n  </style>\n</head>\n<body>\n  <div id=\"error-banner\" class=\"error-banner hidden\"></div>\n\n  <header>\n    <h1>Ptbk Coder Server</h1>\n    <span id=\"status-badge\" class=\"status-badge status-RUNNING\">RUNNING</span>\n    <span id=\"pause-label\"></span>\n    <button id=\"toggle-btn\" class=\"btn btn-pause\">Pause</button>\n  </header>\n\n  <section class=\"run-strip\">\n    <div>\n      <div class=\"run-title\" id=\"run-title\">Initializing...</div>\n      <div class=\"run-subtitle\" id=\"run-subtitle\">Loading runner state</div>\n    </div>\n    <div class=\"progress-shell\">\n      <div class=\"progress-track\"><span class=\"progress-fill\" id=\"progress-fill\"></span></div>\n      <div class=\"progress-label\" id=\"progress-label\">0%</div>\n    </div>\n    <div>\n      <div class=\"run-current\" id=\"run-current\">No active prompt</div>\n      <div class=\"run-output\" id=\"run-output\"></div>\n    </div>\n  </section>\n\n  <div class=\"board\" id=\"board\"></div>\n\n  <div class=\"modal-overlay hidden\" id=\"modal-overlay\">\n    <div class=\"modal\">\n      <div class=\"modal-header\">\n        <div class=\"modal-meta\">\n          <div class=\"modal-file\" id=\"modal-file\"></div>\n          <div class=\"modal-section-label\" id=\"modal-section-label\"></div>\n        </div>\n        <span class=\"modal-status\" id=\"modal-status-badge\"></span>\n        <button class=\"modal-close\" id=\"modal-close\" title=\"Close\">&times;</button>\n      </div>\n\n      <textarea id=\"modal-content\" placeholder=\"Prompt content\"></textarea>\n\n      <div class=\"modal-actions\">\n        <button class=\"btn btn-cancel\" id=\"cancel-button\">Cancel</button>\n        <button class=\"btn btn-save\" id=\"save-button\">Save</button>\n      </div>\n    </div>\n  </div>\n\n  <script>\n    \"use strict\";\n\n    const BOARD_COLUMNS = [\n      { id: \"backlog\", title: \"Backlog\" },\n      { id: \"low-priority\", title: \"Outside priority\" },\n      { id: \"todo\", title: \"To do\" },\n      { id: \"in-progress\", title: \"In progress\" },\n      { id: \"done\", title: \"Done\" },\n      { id: \"errors\", title: \"Errors\" },\n      { id: \"finished\", title: \"Finished\" },\n    ];\n\n    let modalState = null;\n    let lastPauseState = \"RUNNING\";\n\n    function getColumnTitle(columnId) {\n      const column = BOARD_COLUMNS.find((columnCandidate) => columnCandidate.id === columnId);\n      return column ? column.title : columnId;\n    }\n\n    function showError(message) {\n      const banner = document.getElementById(\"error-banner\");\n      banner.textContent = message;\n      banner.classList.remove(\"hidden\");\n      clearTimeout(banner.timer);\n      banner.timer = setTimeout(() => banner.classList.add(\"hidden\"), 6000);\n    }\n\n    function escapeHtml(value) {\n      const element = document.createElement(\"div\");\n      element.textContent = String(value);\n      return element.innerHTML;\n    }\n\n    function renderBoardSkeleton() {\n      const board = document.getElementById(\"board\");\n      board.innerHTML = \"\";\n\n      for (const column of BOARD_COLUMNS) {\n        const columnElement = document.createElement(\"section\");\n        columnElement.className = \"column column-\" + column.id;\n        columnElement.innerHTML =\n          '<div class=\"column-header\">' +\n            '<span>' + escapeHtml(column.title) + '</span>' +\n            '<span class=\"column-count\" id=\"count-' + column.id + '\">0</span>' +\n          '</div>' +\n          '<div class=\"column-cards\" id=\"cards-' + column.id + '\">' +\n            '<div class=\"empty-column\">Loading</div>' +\n          '</div>';\n        board.appendChild(columnElement);\n      }\n    }\n\n    async function fetchStatus() {\n      try {\n        const response = await fetch(\"/api/status\");\n        if (!response.ok) {\n          showError(\"Status API error: \" + response.status);\n          return;\n        }\n\n        const status = await response.json();\n        renderPauseState(status);\n        renderRunState(status.runState);\n      } catch (error) {\n        showError(\"Could not reach coder server: \" + error.message);\n      }\n    }\n\n    function renderPauseState(status) {\n      lastPauseState = status.pauseState;\n\n      const badge = document.getElementById(\"status-badge\");\n      badge.textContent = status.pauseState;\n      badge.className = \"status-badge status-\" + status.pauseState;\n\n      const toggleButton = document.getElementById(\"toggle-btn\");\n      const pauseLabel = document.getElementById(\"pause-label\");\n\n      if (status.pauseState === \"RUNNING\") {\n        toggleButton.textContent = \"Pause\";\n        toggleButton.className = \"btn btn-pause\";\n        pauseLabel.textContent = \"\";\n        return;\n      }\n\n      toggleButton.textContent = \"Resume\";\n      toggleButton.className = \"btn btn-resume\";\n      pauseLabel.textContent =\n        (status.pauseState === \"PAUSING\" ? \"Pausing before: \" : \"Paused before: \") +\n        (status.pauseTargetLabel || \"next checkpoint\");\n    }\n\n    function renderRunState(runState) {\n      if (!runState) {\n        document.getElementById(\"run-title\").textContent = \"Waiting for runner state\";\n        document.getElementById(\"run-subtitle\").textContent = \"\";\n        return;\n      }\n\n      const progress = runState.progress || {};\n      const percentage = Number(progress.percentage || 0);\n      const runnerParts = [runState.config.agentName, runState.config.modelName, runState.config.thinkingLevel]\n        .filter(Boolean);\n\n      document.getElementById(\"run-title\").textContent = runState.statusMessage || runState.phase;\n      document.getElementById(\"run-subtitle\").textContent = runnerParts.join(\" / \");\n      document.getElementById(\"progress-fill\").style.width = Math.max(0, Math.min(100, percentage)) + \"%\";\n      document.getElementById(\"progress-label\").textContent =\n        percentage + \"% \" + (progress.sessionDone || 0) + \"/\" + (progress.sessionTotal || 0);\n      document.getElementById(\"run-current\").textContent = runState.currentPromptLabel\n        ? runState.currentPromptLabel + \" - attempt \" + runState.currentAttempt + \"/\" + runState.maxAttempts\n        : \"No active prompt\";\n\n      renderRunOutput(runState);\n    }\n\n    function renderRunOutput(runState) {\n      const statusLines = (runState.agentStatusTableRows || []).map((row) =>\n        row.status + \" - \" + row.agentName + (row.url ? \" - \" + row.url : \"\")\n      );\n      const outputLines = [\n        ...(runState.agentStatusLines || []),\n        ...statusLines,\n        ...(runState.agentOutputLines || []),\n        ...(runState.errors || []).map((errorLine) => \"Error: \" + errorLine),\n      ].slice(-3);\n\n      document.getElementById(\"run-output\").textContent = outputLines.join(\"\\n\");\n    }\n\n    async function fetchPrompts() {\n      try {\n        const response = await fetch(\"/api/prompts\");\n        if (!response.ok) {\n          showError(\"Prompts API error: \" + response.status);\n          return;\n        }\n\n        renderBoard(await response.json());\n      } catch (error) {\n        showError(\"Could not load prompts: \" + error.message);\n      }\n    }\n\n    function renderBoard(promptFiles) {\n      const columns = Object.fromEntries(BOARD_COLUMNS.map((column) => [column.id, []]));\n\n      for (const file of promptFiles) {\n        for (const section of file.sections) {\n          if (columns[section.column]) {\n            columns[section.column].push({ file, section });\n          }\n        }\n      }\n\n      for (const column of BOARD_COLUMNS) {\n        renderColumn(column.id, columns[column.id]);\n      }\n    }\n\n    function renderColumn(columnId, cards) {\n      const container = document.getElementById(\"cards-\" + columnId);\n      const countElement = document.getElementById(\"count-\" + columnId);\n\n      countElement.textContent = cards.length;\n      container.innerHTML = \"\";\n\n      if (cards.length === 0) {\n        container.innerHTML = '<div class=\"empty-column\">Empty</div>';\n        return;\n      }\n\n      for (const cardData of cards) {\n        container.appendChild(createPromptCard(cardData.file, cardData.section));\n      }\n    }\n\n    function createPromptCard(file, section) {\n      const card = document.createElement(\"article\");\n      card.className = \"card card-\" + section.column;\n      card.innerHTML =\n        '<div class=\"card-file\">' + escapeHtml(file.relativeFilePath || file.fileName) + \" #\" + (section.index + 1) + '</div>' +\n        '<div class=\"card-summary\">' + escapeHtml(section.summary) + '</div>' +\n        renderTags(section);\n      card.onclick = () => openModal(file, section);\n      return card;\n    }\n\n    function renderTags(section) {\n      const tags = [...(section.tags || [])];\n      if (section.priority > 0) {\n        tags.push({ id: \"priority\", label: \"P\" + section.priority });\n      }\n\n      if (tags.length === 0) {\n        return \"\";\n      }\n\n      return '<div class=\"card-tags\">' + tags.map((tag) =>\n        '<span class=\"card-tag tag-' + escapeHtml(tag.id) + '\">' + escapeHtml(tag.label) + '</span>'\n      ).join(\"\") + '</div>';\n    }\n\n    function openModal(file, section) {\n      modalState = { filePath: file.filePath, sectionIndex: section.index };\n\n      document.getElementById(\"modal-file\").textContent = file.relativeFilePath || file.fileName;\n      document.getElementById(\"modal-section-label\").textContent = \"Section \" + (section.index + 1);\n\n      const statusBadge = document.getElementById(\"modal-status-badge\");\n      statusBadge.textContent = getColumnTitle(section.column);\n      statusBadge.className = \"modal-status status-\" + section.column;\n\n      document.getElementById(\"modal-content\").value = section.content;\n      document.getElementById(\"modal-overlay\").classList.remove(\"hidden\");\n      setTimeout(() => document.getElementById(\"modal-content\").focus(), 50);\n    }\n\n    function closeModal() {\n      document.getElementById(\"modal-overlay\").classList.add(\"hidden\");\n      modalState = null;\n    }\n\n    async function saveModal() {\n      if (!modalState) {\n        return;\n      }\n\n      const content = document.getElementById(\"modal-content\").value;\n      const saveButton = document.getElementById(\"save-button\");\n      saveButton.disabled = true;\n      saveButton.textContent = \"Saving...\";\n\n      try {\n        const response = await fetch(\"/api/prompts/update\", {\n          method: \"PUT\",\n          headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify({\n            filePath: modalState.filePath,\n            sectionIndex: modalState.sectionIndex,\n            content,\n          }),\n        });\n\n        if (!response.ok) {\n          throw new Error(\"HTTP \" + response.status);\n        }\n\n        closeModal();\n        await fetchPrompts();\n      } catch (error) {\n        showError(\"Save failed: \" + error.message);\n      } finally {\n        saveButton.disabled = false;\n        saveButton.textContent = \"Save\";\n      }\n    }\n\n    document.getElementById(\"toggle-btn\").onclick = async () => {\n      try {\n        const endpoint = lastPauseState === \"RUNNING\" ? \"/api/pause\" : \"/api/resume\";\n        await fetch(endpoint, { method: \"POST\" });\n        await fetchStatus();\n      } catch (error) {\n        showError(\"Toggle failed: \" + error.message);\n      }\n    };\n\n    document.getElementById(\"modal-close\").onclick = closeModal;\n    document.getElementById(\"cancel-button\").onclick = closeModal;\n    document.getElementById(\"save-button\").onclick = saveModal;\n\n    document.addEventListener(\"keydown\", (event) => {\n      if (event.key === \"Escape\") {\n        closeModal();\n        return;\n      }\n      if ((event.ctrlKey || event.metaKey) && event.key === \"Enter\") {\n        saveModal();\n      }\n    });\n\n    document.getElementById(\"modal-overlay\").addEventListener(\"click\", (event) => {\n      if (event.target === document.getElementById(\"modal-overlay\")) {\n        closeModal();\n      }\n    });\n\n    renderBoardSkeleton();\n    fetchStatus();\n    fetchPrompts();\n    setInterval(fetchStatus, 2000);\n    setInterval(fetchPrompts, 5000);\n  </script>\n</body>\n</html>\n";

package/umd/scripts/run-codex-prompts/server/runCoderHttpServer.d.ts

@@ -1,4 +1,5 @@
 import type { number_port } from '../../../src/types/number_positive';
+import type { PriorityFilter } from '../prompts/priorityFilter';
 import type { CoderRunUiState } from '../ui/CoderRunUiState';
 /**
  * Handle returned by the running coder HTTP server.
@@ -15,7 +16,7 @@ export type CoderHttpServerHandle = {
  */
 export type StartCoderHttpServerOptions = {
     readonly port: number_port;
-    readonly minimumPriority: number;
+    readonly priorityFilter: PriorityFilter;
     readonly serverUrl: string;
     readonly uiState?: CoderRunUiState;
 };

package/umd/scripts/run-codex-prompts/testing/runPromptWithTestFeedback.d.ts

@@ -1,3 +1,4 @@
+import type { CoderRunStep } from '../common/CoderRunStep';
 import type { PromptRunOptions } from '../runners/types/PromptRunOptions';
 import type { PromptRunResult } from '../runners/types/PromptRunResult';
 import type { PromptRunner } from '../runners/types/PromptRunner';
@@ -13,10 +14,15 @@ type RunPromptWithTestFeedbackOptions = PromptRunOptions & {
     runPromptTestCommandExecutor?: typeof runPromptTestCommand;
 };
 /**
- * Successful prompt execution result enriched with the number of attempts it took.
+ * Successful prompt execution result enriched with the number of attempts it took and its per-step usage breakdown.
  */
 export type RunPromptWithTestFeedbackResult = PromptRunResult & {
     attemptCount: number;
+    /**
+     * Ordered steps performed while producing this result (implementation, testing and fixing), each carrying
+     * its own price and duration so the finished prompt can report usage step by step.
+     */
+    steps: ReadonlyArray<CoderRunStep>;
 };
 /**
  * Runs one coding prompt and, when configured, verifies it with a shell command that can feed failures back.

package/umd/scripts/run-codex-prompts/ui/CoderRunUiState.d.ts

@@ -2,8 +2,10 @@
 import { EventEmitter } from 'events';
 import moment from 'moment';
 import { type CoderRunProgressSnapshot } from '../common/buildCoderRunProgressSnapshot';
-import type { AgentRunMessagePreviewSection, AgentRunStatusTableRow } from './buildCoderRunUiFrame';
+import type { PriorityFilter } from '../prompts/priorityFilter';
 import type { PromptStats } from '../prompts/types/PromptStats';
+import type { CoderRunAgentVisual } from './buildCoderRunAgentVisual';
+import type { AgentRunMessagePreviewSection, AgentRunStatusTableRow } from './buildCoderRunUiFrame';
 /**
  * Execution phase of the coder run process.
  *
@@ -22,7 +24,8 @@ export type CoderRunConfig = {
     readonly thinkingLevel?: string;
     readonly context?: string;
     readonly serverUrl?: string;
-    readonly priority: number;
+    readonly priorityFilter?: PriorityFilter;
+    readonly limit?: number;
     readonly testCommand?: string;
 };
 /**
@@ -41,7 +44,7 @@ export type { CoderRunProgressSnapshot };
  */
 export declare class CoderRunUiState extends EventEmitter {
     config: CoderRunConfig;
-    agentVisualLines: string[] | undefined;
+    agentVisual: CoderRunAgentVisual | undefined;
     currentPromptLabel: string;
     currentScriptPaths: string[];
     currentAttempt: number;
@@ -74,9 +77,9 @@ export declare class CoderRunUiState extends EventEmitter {
      */
     setConfig(config: CoderRunConfig): void;
     /**
-     * Replaces the ASCII-art agent visual shown instead of the default brand banner.
+     * Replaces the ASCII-art agent visual renderer shown instead of the default brand banner.
      */
-    setAgentVisualLines(agentVisualLines: ReadonlyArray<string> | undefined): void;
+    setAgentVisual(agentVisual: CoderRunAgentVisual | undefined): void;
     /**
      * Feeds new prompt statistics from the main loop so the progress bar updates.
      */

package/umd/scripts/run-codex-prompts/ui/buildCoderRunAgentVisual.d.ts

@@ -1,29 +1,41 @@
 import type { string_book } from '../../../src/book-2.0/agent-source/string_book';
+import { type TerminalAgentAvatarVisual, type TerminalAgentAvatarVisualFrameOptions } from '../../../src/utils/agents/terminalAgentAvatarVisual';
 /**
  * Output width of the coder-run agent visual in terminal character cells.
  *
  * @private internal constant of coder run UI
  */
-export declare const CODER_RUN_AGENT_VISUAL_COLUMNS = 24;
+export declare const CODER_RUN_AGENT_VISUAL_COLUMNS = 48;
 /**
  * Output height of the coder-run agent visual in terminal character cells.
  *
- * Half of the columns keeps the square avatar visually square in a common terminal font.
- *
  * @private internal constant of coder run UI
  */
 export declare const CODER_RUN_AGENT_VISUAL_ROWS = 12;
+/**
+ * Options passed by the terminal UI when rendering one animated agent visual frame.
+ *
+ * @private internal type of coder run UI
+ */
+export type CoderRunAgentVisualFrameOptions = TerminalAgentAvatarVisualFrameOptions;
+/**
+ * Runtime renderer for the `--agent` avatar visual shown in the coder-run terminal UI.
+ *
+ * @private internal type of coder run UI
+ */
+export type CoderRunAgentVisual = TerminalAgentAvatarVisual;
 /**
  * Builds the ANSI ASCII-art visual of the `--agent` book shown above the coder-run dashboard.
  *
  * The agent's avatar visual is resolved the same way as on the website - the `META AVATAR`
  * commitment wins, then the `META VISUAL` commitment, then the shared default visual - and is
  * rendered dynamically through the shared canvas avatar pipeline into terminal ASCII art.
+ * The terminal variant uses a transparent horizontal canvas instead of the website's framed 1:1 surface.
  *
  * The visual is decorative, so any failure (for example when the optional `@napi-rs/canvas`
  * module is not installed) returns `null` and the caller keeps the default brand banner.
  *
  * @param agentSource Source of the `--agent` book file.
- * @returns ANSI-colored ASCII-art lines or `null` when the visual cannot be rendered.
+ * @returns ANSI-colored ASCII-art renderer or `null` when the visual cannot be rendered.
  */
-export declare function buildCoderRunAgentVisual(agentSource: string_book): Promise<ReadonlyArray<string> | null>;
+export declare function buildCoderRunAgentVisual(agentSource: string_book): Promise<CoderRunAgentVisual | null>;