poly-weaver 0.8.1 → 0.8.2

package/README.md

@@ -42,28 +42,7 @@ The default flow uses a **two-layered loop** structure:
                                        Done
 ```
 
-In **auto mode** (`--auto`), user review steps are skipped — the reviewer loop alone decides approval. The startup TUI renders a live ASCII flow diagram reflecting the configured mode.
-
-### "Why So Serious" workflow
-
-The **why-so-serious** workflow (selectable via Shift+Tab in the TUI) extends the default flow with two additions:
-
-1. **Conditional re-planning** — if the implementation reviewer finds more than 2 issues, a planner step runs before the next implementation attempt to draft a targeted fix plan. When issues are within threshold, the implementor revises normally.
-2. **Simplification pass** — after the implementation loop is approved, a simplifier agent reviews the codebase and produces a simplification plan, which the implementor then applies.
-
-```
-  Default impl loop               Why-so-serious impl loop
-  ────────────────                 ────────────────────────
-  Implement → Review              issues > 2 ? → Planner (fix plan)
-    ↑ rejected  │                 Implement → Review
-    └────────────┘                   ↑ rejected  │
-         │ approved                  └────────────┘
-         ▼                                │ approved
-       Done                               ▼
-                                    Simplifier → Implement
-                                          ▼
-                                        Done
-```
+The startup TUI renders a live ASCII flow diagram reflecting the selected workflow and parameters.
 
 ### Custom flows
 
@@ -142,48 +121,21 @@ poly-weaver
 
 This opens an interactive TUI to configure the task, select providers for each role, and set options before starting the orchestration loop.
 
-You can also pass arguments directly:
+You can seed TUI defaults from a JSON config file:
 
 ```bash
-# Pass a task directly
-poly-weaver "Refactor the auth module to use JWT"
-
-# Read task from a file
-poly-weaver task.md
-
-# Choose providers for each role
-poly-weaver "Add unit tests" --planner claude --reviewer copilot --implementor claude
-
-# Plan only (skip implementation)
-poly-weaver "Design a caching layer" --plan-only
-
-# Fully automated (no user checkpoints)
-poly-weaver "Fix the login bug" --auto
-
-# Opinionless mode — minimal prompts, agent decides the approach
-poly-weaver "Refactor the auth module" --opinionless
+poly-weaver --config ./poly-weaver.config.json
 ```
 
 ### CLI options
 
 | Option | Description | Default |
 |---|---|---|
-| `[task]` | Task description or path to a `.md`/`.txt` file | _(interactive)_ |
-| `--planner <cli>` | Provider for planning (`claude` \| `codex` \| `copilot`) | `claude` |
-| `--reviewer <cli>` | Provider for reviewing (`claude` \| `codex` \| `copilot`) | `codex` |
-| `--implementor <cli>` | Provider for implementation (`claude` \| `codex` \| `copilot`) | `claude` |
-| `--simplifier <cli>` | Provider for simplification (`claude` \| `codex` \| `copilot`) | `claude` |
-| `--max-iterations <n>` | Max plan-review cycles | `5` (range: 1–50) |
-| `--max-impl-iterations <n>` | Max implementation-review cycles | `5` (range: 1–50) |
-| `--auto` | Skip user review phases | `false` |
-| `--plan-only` | Stop after plan approval, skip implementation | `false` |
-| `--workdir <path>` | Working directory for agent CLIs | current directory |
-| `--opinionless` | Use minimal prompts; let agents decide how to plan/review/implement | `false` |
-| `--no-yolo` | Run agents without auto-approving permissions | `false` (agents run with permission-skipping) |
-| `--workflow <name>` | Workflow template to use | `default` |
 | `--config <path>` | Path to a JSON config file | _(none)_ |
+| `-h, --help` | Show help | |
+| `-V, --version` | Show version | |
 
-Workflow is selected via `--workflow <name>` or **Shift+Tab** in the TUI. Built-in workflows: `default`, `why-so-serious`. Custom flows are also available (see below).
+Workflow is selected with **Shift+Tab** in the TUI. Built-in workflows: `default`. Custom flows are also available (see below).
 
 ### Subcommands
 
@@ -243,8 +195,7 @@ src/
 │   ├── inspect.ts         # Flow definition introspection utilities
 │   ├── index.ts           # Re-exports
 │   ├── built-in/
-│   │   ├── default.ts     # Default two-layered flow template
-│   │   └── why-so-serious.ts # Why-so-serious flow template (conditional replan + simplify)
+│   │   └── default.ts     # Default two-layered flow template
 │   └── custom/
 │       ├── load.ts        # Custom flow loader (discovers ~/.poly-weaver/flows/*.mjs)
 │       ├── index.ts       # Re-exports
@@ -307,14 +258,6 @@ src/
     └── types.ts           # PTY-related types
 ```
 
-### Opinionless mode
-
-By default, poly-weaver prompts include prescriptive criteria for each role — evaluation rubrics for reviewers, structural requirements for planners, step-by-step instructions for implementors.
-
-With `--opinionless`, prompts are stripped to the structural minimum: file path references and the verdict output schema. The agent decides how to approach its role. The verdict schema is also simplified — each issue only requires a `description`, with `category` and `severity` left to the agent's discretion.
-
-This is useful when the AI agent has its own strong conventions, or when you want to compare agent behavior with and without prescriptive guidance.
-
 ### Troubleshooting dump
 
 Press **Ctrl+]** at any time during an interactive session to capture a full snapshot of the current session state. The dump is written to:

package/dist/agents/errors.d.ts

@@ -0,0 +1,20 @@
+export type AgentExitFailureMode = "failed-to-launch" | "exited-at-startup" | "crashed-mid-conversation";
+export declare class AgentExitError extends Error {
+    readonly code: "AGENT_EXIT";
+    readonly failureMode: AgentExitFailureMode;
+    readonly exitCode: number | null;
+    readonly signal?: string;
+    readonly smokingGunLine?: string;
+    constructor(opts: {
+        failureMode: AgentExitFailureMode;
+        exitCode: number | null;
+        signal?: string;
+        smokingGunLine?: string;
+        message?: string;
+    });
+}
+export declare function classifyAgentFailure(state: {
+    spawnFailed: boolean;
+    activationObserved: boolean;
+}): AgentExitFailureMode;
+//# sourceMappingURL=errors.d.ts.map

package/dist/agents/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/agents/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,oBAAoB,GAC5B,kBAAkB,GAClB,mBAAmB,GACnB,0BAA0B,CAAC;AAE/B,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAG,YAAY,CAAU;IACtC,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;gBAErB,IAAI,EAAE;QAChB,WAAW,EAAE,oBAAoB,CAAC;QAClC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CAaF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,WAAW,EAAE,OAAO,CAAC;IACrB,kBAAkB,EAAE,OAAO,CAAC;CAC7B,GAAG,oBAAoB,CAIvB"}

package/dist/agents/errors.js

@@ -0,0 +1,26 @@
+export class AgentExitError extends Error {
+    code = "AGENT_EXIT";
+    failureMode;
+    exitCode;
+    signal;
+    smokingGunLine;
+    constructor(opts) {
+        const exitPart = opts.exitCode == null ? "exit=null" : `exit=${opts.exitCode}`;
+        const signalPart = opts.signal ? `, signal=${opts.signal}` : "";
+        super(opts.message ??
+            `Agent process failed [${opts.failureMode}, ${exitPart}${signalPart}]`);
+        this.name = "AgentExitError";
+        this.failureMode = opts.failureMode;
+        this.exitCode = opts.exitCode;
+        this.signal = opts.signal;
+        this.smokingGunLine = opts.smokingGunLine;
+    }
+}
+export function classifyAgentFailure(state) {
+    if (state.spawnFailed)
+        return "failed-to-launch";
+    if (state.activationObserved)
+        return "crashed-mid-conversation";
+    return "exited-at-startup";
+}
+//# sourceMappingURL=errors.js.map

package/dist/agents/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/agents/errors.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,GAAG,YAAqB,CAAC;IAC7B,WAAW,CAAuB;IAClC,QAAQ,CAAgB;IACxB,MAAM,CAAU;IAChB,cAAc,CAAU;IAEjC,YAAY,IAMX;QACC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC/E,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,YAAY,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,KAAK,CACH,IAAI,CAAC,OAAO;YACV,yBAAyB,IAAI,CAAC,WAAW,KAAK,QAAQ,GAAG,UAAU,GAAG,CACzE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,cAAc,CAAC;IAC5C,CAAC;CACF;AAED,MAAM,UAAU,oBAAoB,CAAC,KAGpC;IACC,IAAI,KAAK,CAAC,WAAW;QAAE,OAAO,kBAAkB,CAAC;IACjD,IAAI,KAAK,CAAC,kBAAkB;QAAE,OAAO,0BAA0B,CAAC;IAChE,OAAO,mBAAmB,CAAC;AAC7B,CAAC"}

package/dist/agents/implementors/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/agents/implementors/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAG7B,qBAAa,sBAAuB,YAAW,WAAW;IAI5C,OAAO,CAAC,MAAM;IAH1B,2EAA2E;IAC3E,OAAO,CAAC,cAAc,CAA+C;gBAEjD,MAAM,EAAE,iBAAiB;IAEvC,OAAO,CACX,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,UAAU,CAAC;CAiEvB"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/agents/implementors/handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACpD,OAAO,EAEL,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAG7B,qBAAa,sBAAuB,YAAW,WAAW;IAI5C,OAAO,CAAC,MAAM;IAH1B,2EAA2E;IAC3E,OAAO,CAAC,cAAc,CAA+C;gBAEjD,MAAM,EAAE,iBAAiB;IAEvC,OAAO,CACX,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,UAAU,CAAC;CAkEvB"}

package/dist/agents/implementors/handler.js

@@ -1,4 +1,4 @@
-import { bindSessionReporter, bindDriverRuntime, bindPtyBufferReporter } from "../runner.js";
+import { bindSessionReporter, bindDriverRuntime, bindPtyBufferReporter, bindAttemptFailureReporter } from "../runner.js";
 export class ImplementorRoleHandler {
     driver;
     /** Tracks the last execution mode per step ID for session invalidation. */
@@ -43,6 +43,7 @@ export class ImplementorRoleHandler {
         }
         bindSessionReporter(this.driver, ctx.lastStepSessionFilePaths);
         bindPtyBufferReporter(this.driver, ctx);
+        bindAttemptFailureReporter(this.driver, ctx);
         bindDriverRuntime(this.driver, { output: ctx.output, terminalHost: ctx.terminalHost });
         const implResult = await retry("implementor", async (attempt) => {
             return this.driver.run(planFile, {

package/dist/agents/implementors/handler.js.map

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

package/dist/agents/implementors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/implementors/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAMtD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,KAAK,iBAAiB,CAAC;AAexG,eAAO,MAAM,gBAAgB,EAA2B,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAC/G,eAAO,MAAQ,eAAe,uDAAE,gBAAgB,gBAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/agents/implementors/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAMtD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,YAAY,EAAE,iBAAiB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,KAAK,iBAAiB,CAAC;AAUxG,eAAO,MAAM,gBAAgB,EAA2B,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAC/G,eAAO,MAAQ,eAAe,uDAAE,gBAAgB,gBAAQ,CAAC"}

package/dist/agents/implementors/index.js

@@ -1,19 +1,13 @@
 import { ImplementorAdapter } from "./adapter.js";
 import { ImplementorRoleHandler } from "./handler.js";
 import { createRoleModule } from "../registry.js";
-import { minimalImplementorPrompts } from "./prompts.js";
+import { defaultImplementorPrompts } from "./prompts.js";
 export { implement } from "./dsl.js";
 export { ImplementorRoleHandler } from "./handler.js";
 const mod = createRoleModule({
     roleName: "implementor",
-    fromFactory: (factory, workdir, opts) => {
-        const prompts = opts?.opinionless ? minimalImplementorPrompts : undefined;
-        return factory(workdir, prompts);
-    },
-    fromProvider: (strategy, workdir, opts) => {
-        const prompts = opts?.opinionless ? minimalImplementorPrompts : undefined;
-        return new ImplementorAdapter(strategy, workdir, prompts, opts?.yolo);
-    },
+    fromFactory: (factory, workdir) => factory(workdir, defaultImplementorPrompts),
+    fromProvider: (strategy, workdir, opts) => new ImplementorAdapter(strategy, workdir, defaultImplementorPrompts, opts?.yolo),
     toHandler: (driver) => new ImplementorRoleHandler(driver),
 });
 export const registerProvider = mod.registerProvider;

package/dist/agents/implementors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/implementors/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAoB,MAAM,gBAAgB,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAKtD,MAAM,GAAG,GAAG,gBAAgB,CAAwC;IAClE,QAAQ,EAAE,aAAa;IACvB,WAAW,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QACtC,MAAM,OAAO,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1E,OAAO,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACnC,CAAC;IACD,YAAY,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QACxC,MAAM,OAAO,GAAG,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1E,OAAO,IAAI,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACxE,CAAC;IACD,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,sBAAsB,CAAC,MAAM,CAAC;CAC1D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC,gBAA0E,CAAC;AAC/G,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,gBAAgB,EAAE,GAAG,GAAG,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/agents/implementors/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAEzD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAKtD,MAAM,GAAG,GAAG,gBAAgB,CAAwC;IAClE,QAAQ,EAAE,aAAa;IACvB,WAAW,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,yBAAyB,CAAC;IAC9E,YAAY,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CACxC,IAAI,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,yBAAyB,EAAE,IAAI,EAAE,IAAI,CAAC;IAClF,SAAS,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,sBAAsB,CAAC,MAAM,CAAC;CAC1D,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,CAAC,gBAA0E,CAAC;AAC/G,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,gBAAgB,EAAE,GAAG,GAAG,CAAC"}

package/dist/agents/implementors/prompts.d.ts

@@ -1,12 +1,7 @@
 import type { ImplementorPromptSet } from "./types.js";
-export declare function buildMinimalImplementorPrompt(planFile: string): string;
-export declare function buildMinimalImplementorRevisionPrompt(planFile: string, feedbackFile: string): string;
-export declare function buildMinimalImplementorResumeRevisionPrompt(feedbackFile: string): string;
-export declare function buildMinimalImplementorChangePlanPrompt(planFile: string): string;
-export declare const buildImplementorPrompt: typeof buildMinimalImplementorPrompt;
-export declare const buildImplementorRevisionPrompt: typeof buildMinimalImplementorRevisionPrompt;
-export declare const buildImplementorResumeRevisionPrompt: typeof buildMinimalImplementorResumeRevisionPrompt;
-export declare const buildImplementorChangePlanPrompt: typeof buildMinimalImplementorChangePlanPrompt;
-export declare const minimalImplementorPrompts: ImplementorPromptSet;
+export declare function buildImplementorPrompt(planFile: string): string;
+export declare function buildImplementorRevisionPrompt(planFile: string, feedbackFile: string): string;
+export declare function buildImplementorResumeRevisionPrompt(feedbackFile: string): string;
+export declare function buildImplementorChangePlanPrompt(planFile: string): string;
 export declare const defaultImplementorPrompts: ImplementorPromptSet;
 //# sourceMappingURL=prompts.d.ts.map

package/dist/agents/implementors/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/agents/implementors/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIvD,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMtE;AAED,wBAAgB,qCAAqC,CACnD,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,MAAM,CAOR;AAED,wBAAgB,2CAA2C,CACzD,YAAY,EAAE,MAAM,GACnB,MAAM,CAMR;AAED,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,MAAM,GACf,MAAM,CAMR;AAID,eAAO,MAAM,sBAAsB,sCAAgC,CAAC;AACpE,eAAO,MAAM,8BAA8B,8CAAwC,CAAC;AACpF,eAAO,MAAM,oCAAoC,oDAA8C,CAAC;AAChG,eAAO,MAAM,gCAAgC,gDAA0C,CAAC;AAIxF,eAAO,MAAM,yBAAyB,EAAE,oBAKvC,CAAC;AAEF,eAAO,MAAM,yBAAyB,EAAE,oBAAgD,CAAC"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../../src/agents/implementors/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIvD,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAM/D;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,MAAM,CAOR;AAED,wBAAgB,oCAAoC,CAClD,YAAY,EAAE,MAAM,GACnB,MAAM,CAMR;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,MAAM,GACf,MAAM,CAMR;AAID,eAAO,MAAM,yBAAyB,EAAE,oBAKvC,CAAC"}

package/dist/agents/implementors/prompts.js

@@ -1,12 +1,12 @@
-// ── Minimal implementor prompts ──
-export function buildMinimalImplementorPrompt(planFile) {
+// ── Implementor prompts ──
+export function buildImplementorPrompt(planFile) {
     return [
         `Read the approved implementation plan: ${planFile}`,
         "",
         "Implement the plan by making code changes in the working directory.",
     ].join("\n");
 }
-export function buildMinimalImplementorRevisionPrompt(planFile, feedbackFile) {
+export function buildImplementorRevisionPrompt(planFile, feedbackFile) {
     return [
         `Read the approved implementation plan: ${planFile}`,
         `Read the review feedback: ${feedbackFile}`,
@@ -14,31 +14,25 @@ export function buildMinimalImplementorRevisionPrompt(planFile, feedbackFile) {
         "Revise your implementation to address the feedback.",
     ].join("\n");
 }
-export function buildMinimalImplementorResumeRevisionPrompt(feedbackFile) {
+export function buildImplementorResumeRevisionPrompt(feedbackFile) {
     return [
         `Read the new review feedback: ${feedbackFile}`,
         "",
         "Revise your implementation accordingly.",
     ].join("\n");
 }
-export function buildMinimalImplementorChangePlanPrompt(planFile) {
+export function buildImplementorChangePlanPrompt(planFile) {
     return [
         `Read the change plan: ${planFile}`,
         "",
         "Apply the changes to the working directory.",
     ].join("\n");
 }
-// ─── Opinion-mode implementor prompts (aliased to minimal for now) ──────
-export const buildImplementorPrompt = buildMinimalImplementorPrompt;
-export const buildImplementorRevisionPrompt = buildMinimalImplementorRevisionPrompt;
-export const buildImplementorResumeRevisionPrompt = buildMinimalImplementorResumeRevisionPrompt;
-export const buildImplementorChangePlanPrompt = buildMinimalImplementorChangePlanPrompt;
 // ─── Prompt set exports ──────────────────────────────────────────────────
-export const minimalImplementorPrompts = {
-    initial: buildMinimalImplementorPrompt,
-    revision: buildMinimalImplementorRevisionPrompt,
-    resumeRevision: buildMinimalImplementorResumeRevisionPrompt,
-    changePlan: buildMinimalImplementorChangePlanPrompt,
+export const defaultImplementorPrompts = {
+    initial: buildImplementorPrompt,
+    revision: buildImplementorRevisionPrompt,
+    resumeRevision: buildImplementorResumeRevisionPrompt,
+    changePlan: buildImplementorChangePlanPrompt,
 };
-export const defaultImplementorPrompts = minimalImplementorPrompts;
 //# sourceMappingURL=prompts.js.map

package/dist/agents/implementors/prompts.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/agents/implementors/prompts.ts"],"names":[],"mappings":"AAEA,oCAAoC;AAEpC,MAAM,UAAU,6BAA6B,CAAC,QAAgB;IAC5D,OAAO;QACL,0CAA0C,QAAQ,EAAE;QACpD,EAAE;QACF,qEAAqE;KACtE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,qCAAqC,CACnD,QAAgB,EAChB,YAAoB;IAEpB,OAAO;QACL,0CAA0C,QAAQ,EAAE;QACpD,6BAA6B,YAAY,EAAE;QAC3C,EAAE;QACF,qDAAqD;KACtD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,2CAA2C,CACzD,YAAoB;IAEpB,OAAO;QACL,iCAAiC,YAAY,EAAE;QAC/C,EAAE;QACF,yCAAyC;KAC1C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,uCAAuC,CACrD,QAAgB;IAEhB,OAAO;QACL,yBAAyB,QAAQ,EAAE;QACnC,EAAE;QACF,6CAA6C;KAC9C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,2EAA2E;AAE3E,MAAM,CAAC,MAAM,sBAAsB,GAAG,6BAA6B,CAAC;AACpE,MAAM,CAAC,MAAM,8BAA8B,GAAG,qCAAqC,CAAC;AACpF,MAAM,CAAC,MAAM,oCAAoC,GAAG,2CAA2C,CAAC;AAChG,MAAM,CAAC,MAAM,gCAAgC,GAAG,uCAAuC,CAAC;AAExF,4EAA4E;AAE5E,MAAM,CAAC,MAAM,yBAAyB,GAAyB;IAC7D,OAAO,EAAE,6BAA6B;IACtC,QAAQ,EAAE,qCAAqC;IAC/C,cAAc,EAAE,2CAA2C;IAC3D,UAAU,EAAE,uCAAuC;CACpD,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAyB,yBAAyB,CAAC"}
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../../../src/agents/implementors/prompts.ts"],"names":[],"mappings":"AAEA,4BAA4B;AAE5B,MAAM,UAAU,sBAAsB,CAAC,QAAgB;IACrD,OAAO;QACL,0CAA0C,QAAQ,EAAE;QACpD,EAAE;QACF,qEAAqE;KACtE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,QAAgB,EAChB,YAAoB;IAEpB,OAAO;QACL,0CAA0C,QAAQ,EAAE;QACpD,6BAA6B,YAAY,EAAE;QAC3C,EAAE;QACF,qDAAqD;KACtD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,YAAoB;IAEpB,OAAO;QACL,iCAAiC,YAAY,EAAE;QAC/C,EAAE;QACF,yCAAyC;KAC1C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,QAAgB;IAEhB,OAAO;QACL,yBAAyB,QAAQ,EAAE;QACnC,EAAE;QACF,6CAA6C;KAC9C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,4EAA4E;AAE5E,MAAM,CAAC,MAAM,yBAAyB,GAAyB;IAC7D,OAAO,EAAE,sBAAsB;IAC/B,QAAQ,EAAE,8BAA8B;IACxC,cAAc,EAAE,oCAAoC;IACpD,UAAU,EAAE,gCAAgC;CAC7C,CAAC"}

package/dist/agents/index.d.ts

@@ -2,10 +2,12 @@ import "./planners/index.js";
 import "./reviewers/index.js";
 import "./implementors/index.js";
 import "./simplifiers/index.js";
+import "./interviewers/index.js";
 export { plan } from "./planners/index.js";
 export { review } from "./reviewers/index.js";
 export { implement } from "./implementors/index.js";
 export { simplify } from "./simplifiers/index.js";
+export { interviewer } from "./interviewers/index.js";
 export { createHandler, availableDriversForRole } from "./registry.js";
 export type { HandlerOpts } from "./registry.js";
 export declare function registerBuiltinProviders(): void;

package/dist/agents/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AACA,OAAO,qBAAqB,CAAC;AAC7B,OAAO,sBAAsB,CAAC;AAC9B,OAAO,yBAAyB,CAAC;AACjC,OAAO,wBAAwB,CAAC;AAShC,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACvE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,wBAAgB,wBAAwB,IAAI,IAAI,CAO/C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AACA,OAAO,qBAAqB,CAAC;AAC7B,OAAO,sBAAsB,CAAC;AAC9B,OAAO,yBAAyB,CAAC;AACjC,OAAO,wBAAwB,CAAC;AAChC,OAAO,yBAAyB,CAAC;AAUjC,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACvE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAEjD,wBAAgB,wBAAwB,IAAI,IAAI,CAQ/C"}

package/dist/agents/index.js

@@ -3,16 +3,19 @@ import "./planners/index.js";
 import "./reviewers/index.js";
 import "./implementors/index.js";
 import "./simplifiers/index.js";
+import "./interviewers/index.js";
 import { builtinStrategies } from "../providers/registry.js";
 import * as planners from "./planners/index.js";
 import * as reviewers from "./reviewers/index.js";
 import * as implementors from "./implementors/index.js";
 import * as simplifiers from "./simplifiers/index.js";
+import * as interviewers from "./interviewers/index.js";
 // Re-export DSL helpers and registry
 export { plan } from "./planners/index.js";
 export { review } from "./reviewers/index.js";
 export { implement } from "./implementors/index.js";
 export { simplify } from "./simplifiers/index.js";
+export { interviewer } from "./interviewers/index.js";
 export { createHandler, availableDriversForRole } from "./registry.js";
 export function registerBuiltinProviders() {
     for (const [name, strategy] of builtinStrategies()) {
@@ -20,6 +23,7 @@ export function registerBuiltinProviders() {
         reviewers.registerProvider(name, strategy);
         implementors.registerProvider(name, strategy);
         simplifiers.registerProvider(name, strategy);
+        interviewers.registerProvider(name, strategy);
     }
 }
 //# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,OAAO,qBAAqB,CAAC;AAC7B,OAAO,sBAAsB,CAAC;AAC9B,OAAO,yBAAyB,CAAC;AACjC,OAAO,wBAAwB,CAAC;AAEhC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,YAAY,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,WAAW,MAAM,wBAAwB,CAAC;AAEtD,qCAAqC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAGvE,MAAM,UAAU,wBAAwB;IACtC,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,iBAAiB,EAAE,EAAE,CAAC;QACnD,QAAQ,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC1C,SAAS,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC3C,YAAY,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC9C,WAAW,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,OAAO,qBAAqB,CAAC;AAC7B,OAAO,sBAAsB,CAAC;AAC9B,OAAO,yBAAyB,CAAC;AACjC,OAAO,wBAAwB,CAAC;AAChC,OAAO,yBAAyB,CAAC;AAEjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,QAAQ,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,SAAS,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,YAAY,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,WAAW,MAAM,wBAAwB,CAAC;AACtD,OAAO,KAAK,YAAY,MAAM,yBAAyB,CAAC;AAExD,qCAAqC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAClD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAGvE,MAAM,UAAU,wBAAwB;IACtC,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,iBAAiB,EAAE,EAAE,CAAC;QACnD,QAAQ,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC1C,SAAS,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC3C,YAAY,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC9C,WAAW,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC7C,YAAY,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC;AACH,CAAC"}

package/dist/agents/interviewers/adapter.d.ts

@@ -0,0 +1,17 @@
+import type { ProviderStrategy } from "../../providers/types.js";
+import { BaseAdapter } from "../runner.js";
+import type { InterviewerDriver, InterviewerLiveSidecarMeta, InterviewerPromptSet, InterviewerRunOpts, InterviewResult } from "./types.js";
+export declare class InterviewerAdapter extends BaseAdapter implements InterviewerDriver {
+    private readonly prompts;
+    private pendingSidecarWrite;
+    constructor(strategy: ProviderStrategy, workdir: string, prompts?: InterviewerPromptSet, yolo?: boolean);
+    run(opts: InterviewerRunOpts): Promise<InterviewResult>;
+    resolveCurrentSessionId(): Promise<string | undefined>;
+    predictSessionFile(sessionId: string): string | undefined;
+    setLiveSidecar(sidecarPath: string, meta: InterviewerLiveSidecarMeta): void;
+    flushPendingSidecar(): Promise<void>;
+    private writeSidecar;
+    private buildPrompt;
+    private buildFreshFallbackPrompt;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/agents/interviewers/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/agents/interviewers/adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EACV,iBAAiB,EACjB,0BAA0B,EAE1B,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,qBAAa,kBAAmB,SAAQ,WAAY,YAAW,iBAAiB;IAM5E,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,OAAO,CAAC,mBAAmB,CAA4B;gBAGrD,QAAQ,EAAE,gBAAgB,EAC1B,OAAO,EAAE,MAAM,EACE,OAAO,GAAE,oBAAgD,EAC1E,IAAI,CAAC,EAAE,OAAO;IAKV,GAAG,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC;IA0BvD,uBAAuB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAU5D,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIzD,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,0BAA0B,GAAG,IAAI;IAYrE,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;YAS5B,YAAY;IAsB1B,OAAO,CAAC,WAAW;IA4BnB,OAAO,CAAC,wBAAwB;CAWjC"}

package/dist/agents/interviewers/adapter.js

@@ -0,0 +1,111 @@
+import { writeFile } from "node:fs/promises";
+import { BaseAdapter } from "../runner.js";
+import { defaultInterviewerPrompts } from "./prompts.js";
+export class InterviewerAdapter extends BaseAdapter {
+    prompts;
+    pendingSidecarWrite;
+    constructor(strategy, workdir, prompts = defaultInterviewerPrompts, yolo) {
+        super(strategy, workdir, yolo);
+        this.prompts = prompts;
+    }
+    async run(opts) {
+        const prompt = this.buildPrompt(opts.mode, opts);
+        const freshFallbackPrompt = opts.resumeSessionId
+            ? this.buildFreshFallbackPrompt(opts)
+            : undefined;
+        const result = await this.runAgent({
+            prompt,
+            workdir: this.workdir,
+            resumeSessionId: opts.resumeSessionId,
+            // Prefer the handler-supplied path (set when the handler resolved
+            // resumeSessionId from a sidecar/snapshot in a fresh process — at
+            // that point this.sessionFilePath is undefined).
+            sessionFilePath: opts.resumeSessionFilePath ?? this.sessionFilePath,
+            freshFallbackPrompt,
+            completionMarkerFile: opts.markerFile,
+        });
+        return {
+            sessionId: result.sessionId,
+            sessionFilePath: this.sessionFilePath,
+            rawText: result.responseText,
+            agentUsed: this.name,
+        };
+    }
+    async resolveCurrentSessionId() {
+        if (this.sessionId)
+            return this.sessionId;
+        if (!this.sessionFilePath)
+            return undefined;
+        try {
+            return await this.strategy.session.extractSessionId(this.sessionFilePath);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    predictSessionFile(sessionId) {
+        return this.strategy.session.predictSessionFile?.(this.workdir, sessionId);
+    }
+    setLiveSidecar(sidecarPath, meta) {
+        const previous = this.sessionFileCallback;
+        this.sessionFileCallback = (path) => {
+            previous?.(path);
+            const prior = this.pendingSidecarWrite ?? Promise.resolve();
+            this.pendingSidecarWrite = prior.then(() => this.writeSidecar(sidecarPath, meta, path));
+            void this.pendingSidecarWrite.catch(() => { });
+        };
+    }
+    async flushPendingSidecar() {
+        if (!this.pendingSidecarWrite)
+            return;
+        try {
+            await this.pendingSidecarWrite;
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+    async writeSidecar(sidecarPath, meta, sessionFilePath) {
+        try {
+            const sessionId = await this.strategy.session.extractSessionId(sessionFilePath);
+            await writeFile(sidecarPath, JSON.stringify({
+                sessionId,
+                driver: meta.driver,
+                sessionKey: meta.sessionKey,
+                lastUpdated: new Date().toISOString(),
+            }), "utf8");
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+    buildPrompt(mode, opts) {
+        switch (mode) {
+            case "initial":
+                return this.prompts.initial(opts.taskFile, opts.specFile, opts.markerFile);
+            case "continue":
+                return this.prompts.continueInterview(opts.specFile, opts.markerFile);
+            case "retry-missing-spec":
+                return this.prompts.retryMissingSpec(opts.specFile, opts.markerFile);
+            case "revise":
+                if (!opts.feedbackFile) {
+                    throw new Error("InterviewerAdapter: revise mode requires feedbackFile");
+                }
+                return this.prompts.revise(opts.feedbackFile, opts.specFile, opts.markerFile);
+            case "rehydrate":
+                return this.prompts.rehydrate(opts.taskFile, opts.specFile, opts.markerFile, opts.feedbackFile);
+        }
+    }
+    // Fresh-fallback is intentionally mode-agnostic: it branches on
+    // `feedbackFile` only. The runner replays this prompt when the resumed
+    // session cannot be reattached — the new fresh provider conversation has
+    // no history of the original briefing, so it must receive a self-contained
+    // `initial` or `rehydrate` regardless of which mode the handler chose.
+    buildFreshFallbackPrompt(opts) {
+        if (opts.feedbackFile) {
+            return this.prompts.rehydrate(opts.taskFile, opts.specFile, opts.markerFile, opts.feedbackFile);
+        }
+        return this.prompts.initial(opts.taskFile, opts.specFile, opts.markerFile);
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/agents/interviewers/adapter.js.map

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

package/dist/agents/interviewers/dsl.d.ts

@@ -0,0 +1,13 @@
+import { type WhenCondition, type PhaseLabelSpec } from "../../flow/dsl.js";
+import type { AgentStep } from "../../flow/types.js";
+export declare function interviewer(opts: {
+    driver: string;
+    reads: Record<string, string>;
+    writes: Record<string, string>;
+    id?: string;
+    sessionShareKey?: string;
+    when?: WhenCondition;
+    whenLabel?: string;
+    phaseLabel?: PhaseLabelSpec;
+}): AgentStep;
+//# sourceMappingURL=dsl.d.ts.map

package/dist/agents/interviewers/dsl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl.d.ts","sourceRoot":"","sources":["../../../src/agents/interviewers/dsl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,KAAK,aAAa,EAAE,KAAK,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,IAAI,CAAC,EAAE,aAAa,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B,GAAG,SAAS,CAeZ"}

package/dist/agents/interviewers/dsl.js

@@ -0,0 +1,14 @@
+import { agentStep } from "../../flow/dsl.js";
+export function interviewer(opts) {
+    return agentStep("interviewer", {
+        feedbackToTask: false,
+        idPrefix: "interview",
+        phaseLabel: "🎤 Interviewing...",
+    }, {
+        ...opts,
+        sessionShareKey: opts.sessionShareKey ?? "interviewer",
+        reuseSessionOnRetry: true,
+        restoreSessionIdsOnResume: true,
+    });
+}
+//# sourceMappingURL=dsl.js.map

package/dist/agents/interviewers/dsl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dsl.js","sourceRoot":"","sources":["../../../src/agents/interviewers/dsl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAA2C,MAAM,mBAAmB,CAAC;AAGvF,MAAM,UAAU,WAAW,CAAC,IAS3B;IACC,OAAO,SAAS,CACd,aAAa,EACb;QACE,cAAc,EAAE,KAAK;QACrB,QAAQ,EAAE,WAAW;QACrB,UAAU,EAAE,oBAAoB;KACjC,EACD;QACE,GAAG,IAAI;QACP,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,aAAa;QACtD,mBAAmB,EAAE,IAAI;QACzB,yBAAyB,EAAE,IAAI;KAChC,CACF,CAAC;AACJ,CAAC"}

package/dist/agents/interviewers/handler.d.ts

@@ -0,0 +1,21 @@
+import type { BaseStep, RetryFn, RoleHandler, StepContext, StepSignal } from "../../flow/types.js";
+import type { InterviewerDriver } from "./types.js";
+/** Thrown by the validation step inside the retry closure — retryable. */
+export declare class InterviewerValidationError extends Error {
+    constructor(message: string);
+}
+export declare class InterviewerRoleHandler implements RoleHandler {
+    private driver;
+    constructor(driver: InterviewerDriver);
+    execute(step: BaseStep, ctx: StepContext, retry: RetryFn): Promise<StepSignal>;
+    /**
+     * If a prior interviewer session exists (sidecar > snapshot) and its
+     * on-disk file is still present, set `ctx.sessionIds[sessionKey]` and
+     * return the validated session file path. Returning the path lets the
+     * caller hand it to driver.run() so the runner's resume fast path
+     * skips session-file discovery.
+     */
+    private maybeRestoreSessionId;
+    private findRestorableSessionIdFromSnapshots;
+}
+//# sourceMappingURL=handler.d.ts.map

package/dist/agents/interviewers/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/agents/interviewers/handler.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,QAAQ,EACR,OAAO,EACP,WAAW,EACX,WAAW,EACX,UAAU,EACX,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EACV,iBAAiB,EAGlB,MAAM,YAAY,CAAC;AAEpB,0EAA0E;AAC1E,qBAAa,0BAA2B,SAAQ,KAAK;gBACvC,OAAO,EAAE,MAAM;CAI5B;AAoCD,qBAAa,sBAAuB,YAAW,WAAW;IAC5C,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,iBAAiB;IAEvC,OAAO,CACX,IAAI,EAAE,QAAQ,EACd,GAAG,EAAE,WAAW,EAChB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,UAAU,CAAC;IAwHtB;;;;;;OAMG;YACW,qBAAqB;IAuDnC,OAAO,CAAC,oCAAoC;CAsB7C"}