@pythonluvr/openwar 0.4.0

package/dist/phases/execute.js

@@ -0,0 +1,222 @@
+import { snapshot } from "../detectors/index.js";
+import { checkAuthorization } from "../auth/check.js";
+const DEFAULT_MAX_STEPS = 30;
+const DEFAULT_MAX_TOOL_ROUNDS_PER_STEP = 3;
+const PHASE_1_KICKOFF = `
+The Confirmation Summary has been accepted. Begin Phase 1: Execution.
+
+Execute the brief one step at a time. After each step, briefly state what you did and what's next.
+Surface decision points and meaningful checkpoints. Flag blockers (Phase 2) and any
+destructive or out-of-directive actions (Phase 3) before performing them.
+`.trim();
+export async function runExecute(opts) {
+    const { brief, adapter, system, io, mode, signal, onMessage } = opts;
+    const maxSteps = opts.maxSteps ?? DEFAULT_MAX_STEPS;
+    const maxToolRounds = opts.maxToolRoundsPerStep ?? DEFAULT_MAX_TOOL_ROUNDS_PER_STEP;
+    const history = [...opts.history];
+    const hasTools = (opts.toolDefinitions?.length ?? 0) > 0 && !!opts.toolExecutors && !!opts.sandbox;
+    io.banner(`Phase 1: Execution (${mode})${hasTools ? ` [tools: ${opts.toolDefinitions.length}]` : ""}`);
+    const kickoff = {
+        role: "user",
+        content: mode === "auto"
+            ? `${PHASE_1_KICKOFF}\n\nMode: auto-pilot. Execute clean steps without asking; only stop for blockers (Phase 2) or destructive / out-of-directive actions (Phase 3).`
+            : `${PHASE_1_KICKOFF}\n\nMode: per-step gating. After each step, wait for the operator's "ok" before continuing.`,
+        at: new Date().toISOString(),
+        meta: { phase: "execute", step_index: 0 },
+    };
+    history.push(kickoff);
+    onMessage?.(kickoff);
+    for (let step = 0; step < maxSteps; step++) {
+        // ---- Inner tool-call loop. Multiple LLM turns may happen per step if
+        //      the model calls tools, we run them, and the model continues. ----
+        let priorToolCalls = [];
+        let priorToolResults = [];
+        let stepText = "";
+        let roundsThisStep = 0;
+        while (true) {
+            const collected = await streamAndCollect(adapter, system, history, io, opts.toolDefinitions, priorToolCalls, priorToolResults, signal);
+            stepText = collected.text;
+            if (collected.toolCalls.length === 0)
+                break;
+            // Authorization check across all calls. Any unauthorized call halts.
+            for (const call of collected.toolCalls) {
+                const toolDef = opts.toolDefinitions.find(t => t.name === call.name);
+                if (!toolDef) {
+                    // Unknown tool. Surface as a denial-style tool result for the LLM
+                    // to react to (not a Phase 3, just an error).
+                    priorToolCalls = [...collected.toolCalls];
+                    priorToolResults = collected.toolCalls.map(c => ({
+                        call_id: c.id,
+                        content: `Tool "${c.name}" is not registered.`,
+                        is_error: true,
+                    }));
+                    break;
+                }
+                const decision = checkAuthorization({
+                    tool: toolDef,
+                    authorizedCosts: brief.frontmatter.authorized_costs,
+                    sessionApproved: opts.sessionApproved ?? [],
+                });
+                if (!decision.allowed) {
+                    return {
+                        history,
+                        outcome: "destructive_denied",
+                        reason: `tool "${call.name}" requires unauthorized categories: ${decision.missing_categories.join(", ")}`,
+                        destructive_tool_call: call,
+                        destructive_missing_categories: decision.missing_categories,
+                    };
+                }
+            }
+            // Execute each call sequentially via its executor.
+            priorToolCalls = collected.toolCalls;
+            priorToolResults = [];
+            for (const call of collected.toolCalls) {
+                const executor = opts.toolExecutors.get(call.name);
+                if (!executor) {
+                    priorToolResults.push({
+                        call_id: call.id,
+                        content: `Tool "${call.name}" has no executor registered.`,
+                        is_error: true,
+                    });
+                    continue;
+                }
+                io.write(`\n→ ${call.name}(${JSON.stringify(call.arguments).slice(0, 120)})\n`);
+                const result = await executor(call, opts.sandbox);
+                const round = {
+                    call_id: call.id,
+                    content: result.content,
+                    ...(result.success ? {} : { is_error: true }),
+                };
+                priorToolResults.push(round);
+                opts.onToolCall?.(call, round);
+                io.write(`  ↳ ${result.success ? "ok" : "error"} (${result.meta?.duration_ms ?? 0}ms)\n`);
+            }
+            // Persist the round in transcript history as assistant + tool messages.
+            const assistantToolUseMsg = {
+                role: "assistant",
+                content: stepText + (stepText && priorToolCalls.length ? "\n" : "") +
+                    priorToolCalls.map(c => `[tool: ${c.name}(${JSON.stringify(c.arguments)})]`).join("\n"),
+                at: new Date().toISOString(),
+                meta: { phase: "execute", step_index: step + 1 },
+            };
+            history.push(assistantToolUseMsg);
+            onMessage?.(assistantToolUseMsg);
+            for (const r of priorToolResults) {
+                const m = {
+                    role: "user",
+                    content: `[tool_result ${r.call_id}${r.is_error ? " (error)" : ""}]\n${r.content}`,
+                    at: new Date().toISOString(),
+                    meta: { phase: "execute", step_index: step + 1 },
+                };
+                history.push(m);
+                onMessage?.(m);
+            }
+            roundsThisStep++;
+            if (roundsThisStep >= maxToolRounds) {
+                io.warn(`Tool-call round cap reached for step ${step + 1}.`);
+                break;
+            }
+            // Next inner-loop iteration: send the LLM the tool results.
+        }
+        // ---- Detector pass on the final assistant text of this step. ----
+        const detectors = snapshot(stepText, {
+            authorized_costs: brief.frontmatter.authorized_costs,
+        });
+        const assistant = {
+            role: "assistant",
+            content: stepText,
+            at: new Date().toISOString(),
+            meta: { phase: "execute", step_index: step + 1, detectors },
+        };
+        history.push(assistant);
+        onMessage?.(assistant);
+        if (detectors.banned_phrases && detectors.banned_phrases.count > 0) {
+            io.warn(`Voice rules: ${detectors.banned_phrases.count} banned phrase(s) detected: ${detectors.banned_phrases.phrases.join(", ")}`);
+        }
+        if (detectors.blocker?.blocked) {
+            return {
+                history,
+                outcome: "blocker",
+                reason: detectors.blocker.reason ?? "unspecified blocker",
+                blocking_detectors: detectors,
+            };
+        }
+        if (detectors.destructive?.destructive && !detectors.destructive.authorized) {
+            return {
+                history,
+                outcome: "destructive_denied",
+                reason: detectors.destructive.action ?? "destructive intent",
+                blocking_detectors: detectors,
+            };
+        }
+        if (detectors.completion?.complete) {
+            return { history, outcome: "completion" };
+        }
+        if (mode === "gated") {
+            const reply = await io.prompt('Continue? Type "ok"/"go" to proceed, "done" to finish, or send a redirect:');
+            const lower = reply.trim().toLowerCase();
+            if (lower === "done" || lower === "stop" || lower === "halt") {
+                return { history, outcome: "operator_done", reason: reply };
+            }
+            const next = {
+                role: "user",
+                content: lower === "" || /^(ok|go|continue|next|proceed|y|yes)$/.test(lower)
+                    ? "Continue with the next step."
+                    : reply,
+                at: new Date().toISOString(),
+                meta: { phase: "execute", step_index: step + 1 },
+            };
+            history.push(next);
+            onMessage?.(next);
+        }
+        else {
+            const next = {
+                role: "user",
+                content: "Continue with the next step. If the brief is complete, declare Phase 4 and stop.",
+                at: new Date().toISOString(),
+                meta: { phase: "execute", step_index: step + 1 },
+            };
+            history.push(next);
+            onMessage?.(next);
+        }
+    }
+    return { history, outcome: "max_steps", reason: `reached max_steps=${maxSteps}` };
+}
+async function streamAndCollect(adapter, system, messages, io, tools, priorToolCalls, priorToolResults, signal) {
+    let assembled = "";
+    const toolCalls = [];
+    for await (const ev of adapter.sendMessage({
+        system,
+        messages,
+        ...(tools && tools.length > 0 && { tools }),
+        ...(priorToolCalls.length > 0 && { prior_tool_calls: priorToolCalls }),
+        ...(priorToolResults.length > 0 && { prior_tool_results: priorToolResults }),
+        ...(signal ? { signal } : {}),
+    })) {
+        if (ev.type === "text_delta") {
+            io.write(ev.delta);
+            assembled += ev.delta;
+        }
+        else if (ev.type === "tool_call_complete") {
+            toolCalls.push(ev.call);
+        }
+        else if (ev.type === "done") {
+            io.write("\n");
+            if (ev.message && ev.message.length >= assembled.length) {
+                assembled = ev.message;
+            }
+            if (ev.tool_calls) {
+                for (const c of ev.tool_calls) {
+                    if (!toolCalls.some(existing => existing.id === c.id))
+                        toolCalls.push(c);
+                }
+            }
+            return { text: assembled, toolCalls };
+        }
+        else if (ev.type === "error") {
+            throw ev.error;
+        }
+    }
+    return { text: assembled, toolCalls };
+}
+//# sourceMappingURL=execute.js.map

package/dist/phases/execute.js.map

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

package/dist/phases/intake.d.ts

@@ -0,0 +1,16 @@
+import type { AgentAdapter, Brief, Message, RunnerIO } from "../types.js";
+export interface IntakeResult {
+    accepted: boolean;
+    operator_reply: string;
+    assistant_message: Message;
+    brief_prompt: Message;
+}
+export interface IntakeOpts {
+    brief: Brief;
+    adapter: AgentAdapter;
+    system: string;
+    io: RunnerIO;
+    signal?: AbortSignal;
+}
+export declare function runIntake(opts: IntakeOpts): Promise<IntakeResult>;
+//# sourceMappingURL=intake.d.ts.map

package/dist/phases/intake.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intake.d.ts","sourceRoot":"","sources":["../../src/phases/intake.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,KAAK,EACL,OAAO,EACP,QAAQ,EAET,MAAM,aAAa,CAAC;AAKrB,MAAM,WAAW,YAAY;IAE3B,QAAQ,EAAE,OAAO,CAAC;IAGlB,cAAc,EAAE,MAAM,CAAC;IAEvB,iBAAiB,EAAE,OAAO,CAAC;IAE3B,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAiBD,wBAAsB,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAwEvE"}

package/dist/phases/intake.js

@@ -0,0 +1,105 @@
+import { renderBriefForAgent } from "../brief.js";
+import { detectConfirmationSummary, snapshot } from "../detectors/index.js";
+const INTAKE_INSTRUCTION = `
+You have just received a brief under the OpenWar framework. Execute Phase 0 (Brief Intake) now.
+
+1. Read the entire brief.
+2. Produce a Confirmation Summary with these sections, in this order:
+   - Objective
+   - Deliverables
+   - Constraints
+   - Tools required
+   - Unknowns
+3. End by asking which execution mode the operator wants (per-step gating or auto-pilot), unless the brief's frontmatter already specifies mode.
+
+Do not begin execution. Stop after the Confirmation Summary and wait for the operator.
+`.trim();
+export async function runIntake(opts) {
+    const { brief, adapter, system, io, signal } = opts;
+    const briefBody = renderBriefForAgent(brief);
+    const briefPrompt = {
+        role: "user",
+        content: `${briefBody}\n\n---\n\n${INTAKE_INSTRUCTION}\n`,
+        at: new Date().toISOString(),
+        meta: { phase: "intake", step_index: 0 },
+    };
+    io.banner("Phase 0: Brief intake");
+    const assistantText = await streamAndCollect(adapter, system, [briefPrompt], io, signal);
+    let assistantMessage = {
+        role: "assistant",
+        content: assistantText,
+        at: new Date().toISOString(),
+        meta: {
+            phase: "intake",
+            step_index: 0,
+            detectors: snapshot(assistantText, { authorized_costs: brief.frontmatter.authorized_costs }),
+        },
+    };
+    // If the model skipped the Confirmation Summary shape, nudge it once.
+    const conf = detectConfirmationSummary(assistantText);
+    if (!conf.found) {
+        io.warn("Confirmation Summary not detected in agent reply. Asking the model to restate in OpenWar shape.");
+        const nudge = {
+            role: "user",
+            content: "That reply did not contain a Confirmation Summary in OpenWar's required shape. " +
+                "Restate as: Objective / Deliverables / Constraints / Tools required / Unknowns, " +
+                "then ask which execution mode the operator wants. Do not begin execution.",
+            at: new Date().toISOString(),
+            meta: { phase: "intake", step_index: 1 },
+        };
+        const retry = await streamAndCollect(adapter, system, [briefPrompt, assistantMessage, nudge], io, signal);
+        assistantMessage = {
+            role: "assistant",
+            content: retry,
+            at: new Date().toISOString(),
+            meta: {
+                phase: "intake",
+                step_index: 1,
+                detectors: snapshot(retry, { authorized_costs: brief.frontmatter.authorized_costs }),
+            },
+        };
+    }
+    // Hand control to operator.
+    io.write("\n");
+    const reply = await io.prompt('Acknowledge Confirmation Summary. Type "go" to accept, or describe a correction:');
+    const accepted = isAcceptance(reply);
+    return {
+        accepted,
+        operator_reply: reply,
+        assistant_message: assistantMessage,
+        brief_prompt: briefPrompt,
+    };
+}
+function isAcceptance(reply) {
+    const trimmed = reply.trim().toLowerCase();
+    if (!trimmed)
+        return false;
+    return /^(go|ok|okay|yes|y|approved|approve|confirmed|confirm|ship it|run it|do it|sounds good|looks good)$/.test(trimmed);
+}
+async function streamAndCollect(adapter, system, messages, io, signal) {
+    let assembled = "";
+    for await (const ev of adapter.sendMessage({
+        system,
+        messages,
+        ...(signal ? { signal } : {}),
+    })) {
+        if (ev.type === "text_delta") {
+            io.write(ev.delta);
+            assembled += ev.delta;
+        }
+        else if (ev.type === "done") {
+            io.write("\n");
+            // Some adapters won't have streamed every chunk into `assembled`;
+            // prefer the canonical message.
+            if (ev.message && ev.message.length >= assembled.length) {
+                assembled = ev.message;
+            }
+            return assembled;
+        }
+        else if (ev.type === "error") {
+            throw ev.error;
+        }
+    }
+    return assembled;
+}
+//# sourceMappingURL=intake.js.map

package/dist/phases/intake.js.map

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

package/dist/roles/critic.d.ts

@@ -0,0 +1,3 @@
+import type { RoleDefinition } from "../types.js";
+export declare const criticDefinition: RoleDefinition;
+//# sourceMappingURL=critic.d.ts.map

package/dist/roles/critic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"critic.d.ts","sourceRoot":"","sources":["../../src/roles/critic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,eAAO,MAAM,gBAAgB,EAAE,cAkC9B,CAAC"}

package/dist/roles/critic.js

@@ -0,0 +1,35 @@
+export const criticDefinition = {
+    id: "critic",
+    description: "Optional second-opinion reviewer. Runs in parallel with the reviewer; " +
+        "disagreement halts the coordinator into Phase 2 for operator decision.",
+    // Same scope as reviewer: read-only file access.
+    tool_categories: ["filesystem_read"],
+    allow_read_file: true,
+    prompt_overlay: `
+You are the **critic** role under the OpenWar multi-agent coordinator.
+
+You run in parallel with the **reviewer**. Your job is to give an
+independent verdict on the executor's output against the sub-task's
+acceptance criteria. You do not know the reviewer's verdict; you must form
+your own.
+
+When you disagree with the reviewer, the coordinator halts the run into
+Phase 2 and asks the operator which verdict to accept. Therefore: be
+honest. Do not soften your reading to align with what you imagine the
+reviewer said. Independent verdicts are the whole point.
+
+Output rules are identical to the reviewer's:
+
+End your reply with a single fenced \`\`\`json block:
+{
+  "kind": "review",
+  "subtask_id": "<the sub-task id>",
+  "verdict": "pass" | "fail" | "needs_retry",
+  "rationale": "<terse explanation, point-by-point against criteria>",
+  "suggested_revision": "<only when verdict is needs_retry>"
+}
+
+You have read-only file access (filesystem_read). No write or shell.
+`.trim(),
+};
+//# sourceMappingURL=critic.js.map

package/dist/roles/critic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"critic.js","sourceRoot":"","sources":["../../src/roles/critic.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAmB;IAC9C,EAAE,EAAE,QAAQ;IACZ,WAAW,EACT,wEAAwE;QACxE,wEAAwE;IAC1E,iDAAiD;IACjD,eAAe,EAAE,CAAC,iBAAiB,CAAC;IACpC,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;CAyBjB,CAAC,IAAI,EAAE;CACP,CAAC"}

package/dist/roles/executor.d.ts

@@ -0,0 +1,3 @@
+import type { RoleDefinition } from "../types.js";
+export declare const executorDefinition: RoleDefinition;
+//# sourceMappingURL=executor.d.ts.map

package/dist/roles/executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.d.ts","sourceRoot":"","sources":["../../src/roles/executor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,eAAO,MAAM,kBAAkB,EAAE,cA6ChC,CAAC"}

package/dist/roles/executor.js

@@ -0,0 +1,46 @@
+export const executorDefinition = {
+    id: "executor",
+    description: "Executes one sub-task at a time using the v0.3 tool layer. Standard " +
+        "authorization gates apply. Produces an ExecutionHandoff for the reviewer.",
+    // Executor inherits the brief's full authorized_costs. The wildcard here
+    // means "anything the brief itself authorizes." The runtime composes
+    // role-scope with the brief check; the planner/reviewer's narrower
+    // scopes still block them from broader tool use.
+    tool_categories: ["*"],
+    allow_read_file: true,
+    prompt_overlay: `
+You are the **executor** role under the OpenWar multi-agent coordinator.
+
+You receive one sub-task at a time. Each sub-task has:
+- a title and instruction (what to do)
+- acceptance criteria (what the reviewer will check)
+
+Your responsibilities:
+
+1. Execute the instruction using whatever tools you have access to. Tool
+   calls go through the normal v0.3 authorization gates; if a tool requires
+   a category not pre-approved in the brief's authorized_costs, the
+   coordinator will halt for a Phase 3 operator prompt before running it.
+2. Stay within the sub-task's scope. If you find yourself needing to do
+   something the sub-task does not authorize, stop and declare a blocker
+   (Phase 2). Do not silently expand scope.
+3. Produce one ExecutionHandoff per sub-task. End your reply with a single
+   fenced \`\`\`json block in this shape:
+   {
+     "kind": "execution",
+     "subtask_id": "<the sub-task id you executed>",
+     "output": "<the substantive result the reviewer will evaluate>",
+     "tool_calls": [<summarized tool-call records>],
+     "notes": "<your own narrative about decisions, surprises, caveats>"
+   }
+4. If the sub-task is impossible without operator help, emit an
+   EscalationHandoff instead. Same fenced JSON, kind: "escalation".
+5. Voice rules from the framework apply. Phase 3 destructive flag applies.
+   No banned phrases, no apologies as openers.
+
+The reviewer will run after you and check your output against the
+acceptance criteria. If the reviewer says "needs_retry", you will be
+re-invoked with their suggested revision as additional context.
+`.trim(),
+};
+//# sourceMappingURL=executor.js.map

package/dist/roles/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/roles/executor.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,kBAAkB,GAAmB;IAChD,EAAE,EAAE,UAAU;IACd,WAAW,EACT,sEAAsE;QACtE,2EAA2E;IAC7E,yEAAyE;IACzE,qEAAqE;IACrE,mEAAmE;IACnE,iDAAiD;IACjD,eAAe,EAAE,CAAC,GAAG,CAAC;IACtB,eAAe,EAAE,IAAI;IACrB,cAAc,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCjB,CAAC,IAAI,EAAE;CACP,CAAC"}

package/dist/roles/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./types.js";
+export { registerRole, getRole, listRoles, listRoleIds, setRole, _resetRegistryToBuiltIns } from "./registry.js";
+export { buildSystemPrompt } from "./prompt-overlay.js";
+export { plannerDefinition } from "./planner.js";
+export { executorDefinition } from "./executor.js";
+export { reviewerDefinition } from "./reviewer.js";
+export { criticDefinition } from "./critic.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/roles/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACjH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/roles/index.js

@@ -0,0 +1,8 @@
+export * from "./types.js";
+export { registerRole, getRole, listRoles, listRoleIds, setRole, _resetRegistryToBuiltIns } from "./registry.js";
+export { buildSystemPrompt } from "./prompt-overlay.js";
+export { plannerDefinition } from "./planner.js";
+export { executorDefinition } from "./executor.js";
+export { reviewerDefinition } from "./reviewer.js";
+export { criticDefinition } from "./critic.js";
+//# sourceMappingURL=index.js.map

package/dist/roles/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/roles/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AACjH,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/roles/planner.d.ts

@@ -0,0 +1,3 @@
+import type { RoleDefinition } from "../types.js";
+export declare const plannerDefinition: RoleDefinition;
+//# sourceMappingURL=planner.d.ts.map

package/dist/roles/planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/roles/planner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,eAAO,MAAM,iBAAiB,EAAE,cAiD/B,CAAC"}

package/dist/roles/planner.js

@@ -0,0 +1,50 @@
+export const plannerDefinition = {
+    id: "planner",
+    description: "Decomposes the brief into ordered sub-tasks with acceptance criteria. " +
+        "No tool access. Output is a structured plan handoff.",
+    // Planner cannot call any tool. Coordinator enforces this structurally:
+    // role-scope check denies every tool category.
+    tool_categories: [],
+    allow_read_file: false,
+    prompt_overlay: `
+You are the **planner** role under the OpenWar multi-agent coordinator.
+
+Your only job is to decompose the brief into a linear, ordered list of
+sub-tasks the executor can act on, each with concrete acceptance criteria
+the reviewer can evaluate.
+
+Output rules:
+
+1. Begin with a short rationale (one paragraph) describing how you split the
+   work and why this ordering.
+2. End your reply with a single fenced \`\`\`json block containing the plan
+   handoff. The runtime parses only this block as the plan; any prose
+   before it is logged but not executed.
+3. The plan handoff schema:
+   {
+     "kind": "plan",
+     "subtasks": [
+       {
+         "id": "<short-stable-id>",
+         "title": "<one-line title>",
+         "instruction": "<concrete instruction for the executor>",
+         "acceptance_criteria": ["<criterion>", "..."],
+         "order": <integer, 0-based>,
+         "depends_on": []
+       }
+     ],
+     "rationale": "<the same rationale you wrote above>"
+   }
+4. v0.4 supports **linear plans only**. Sub-task N may declare
+   \`depends_on: ["<id of N-1>"]\` or omit the field. Anything else is
+   rejected.
+5. Do not call tools. You have no tool access. If the brief seems to require
+   reading files to plan, surface that as an Unknown and let the operator
+   decide before you produce a plan.
+6. Do not include sub-tasks that violate the brief's scope or
+   authorized_costs.
+7. If the brief is fully ambiguous, produce one sub-task whose instruction
+   is "ask the operator for clarification on: X" and stop. Do not invent.
+`.trim(),
+};
+//# sourceMappingURL=planner.js.map

package/dist/roles/planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"planner.js","sourceRoot":"","sources":["../../src/roles/planner.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,iBAAiB,GAAmB;IAC/C,EAAE,EAAE,SAAS;IACb,WAAW,EACT,wEAAwE;QACxE,sDAAsD;IACxD,wEAAwE;IACxE,+CAA+C;IAC/C,eAAe,EAAE,EAAE;IACnB,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCjB,CAAC,IAAI,EAAE;CACP,CAAC"}

package/dist/roles/prompt-overlay.d.ts

@@ -0,0 +1,9 @@
+import type { Brief, RoleDefinition } from "../types.js";
+export interface OverlayInput {
+    framework: string;
+    brief: Brief;
+    role: RoleDefinition;
+    extra?: string;
+}
+export declare function buildSystemPrompt(input: OverlayInput): string;
+//# sourceMappingURL=prompt-overlay.d.ts.map

package/dist/roles/prompt-overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-overlay.d.ts","sourceRoot":"","sources":["../../src/roles/prompt-overlay.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGzD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;IACb,IAAI,EAAE,cAAc,CAAC;IAGrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAc7D"}

package/dist/roles/prompt-overlay.js

@@ -0,0 +1,25 @@
+// Assembles the system prompt for a role invocation. Layered as:
+//
+//   framework_doc + brief_rendering + role_overlay
+//
+// The role overlay never overrides the framework's hard rules; it scopes
+// what the role does on top of them. Hard-rule words ("Phase 0", "Phase 3
+// destructive flag", "blocker", banned phrases) are not redefined; the
+// overlay only adds role-specific instructions.
+import { renderBriefForAgent } from "../brief.js";
+export function buildSystemPrompt(input) {
+    const parts = [];
+    parts.push(input.framework.trim());
+    parts.push("\n---\n");
+    parts.push("# Brief (verbatim from the operator)\n");
+    parts.push(renderBriefForAgent(input.brief).trim());
+    parts.push("\n---\n");
+    parts.push(`# Role: ${input.role.id}\n`);
+    parts.push(input.role.prompt_overlay.trim());
+    if (input.extra && input.extra.trim()) {
+        parts.push("\n---\n");
+        parts.push(input.extra.trim());
+    }
+    return parts.join("\n");
+}
+//# sourceMappingURL=prompt-overlay.js.map

package/dist/roles/prompt-overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-overlay.js","sourceRoot":"","sources":["../../src/roles/prompt-overlay.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,EAAE;AACF,mDAAmD;AACnD,EAAE;AACF,yEAAyE;AACzE,0EAA0E;AAC1E,uEAAuE;AACvE,gDAAgD;AAGhD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAWlD,MAAM,UAAU,iBAAiB,CAAC,KAAmB;IACnD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;IACnC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACpD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACtB,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;IAC7C,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/roles/registry.d.ts

@@ -0,0 +1,8 @@
+import type { RoleDefinition, RoleId } from "../types.js";
+export declare function registerRole(def: RoleDefinition): void;
+export declare function getRole(id: RoleId): RoleDefinition | undefined;
+export declare function listRoles(): RoleDefinition[];
+export declare function listRoleIds(): RoleId[];
+export declare function setRole(def: RoleDefinition): void;
+export declare function _resetRegistryToBuiltIns(): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/roles/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/roles/registry.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAQ1D,wBAAgB,YAAY,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAKtD;AAED,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAE9D;AAED,wBAAgB,SAAS,IAAI,cAAc,EAAE,CAE5C;AAED,wBAAgB,WAAW,IAAI,MAAM,EAAE,CAEtC;AAID,wBAAgB,OAAO,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI,CAEjD;AAKD,wBAAgB,wBAAwB,IAAI,IAAI,CAG/C"}