@pythonluvr/openwar 0.4.0

package/dist/orchestration/handoff.js

@@ -0,0 +1,322 @@
+// Typed cross-role communication. Every handoff between roles uses one of
+// these shapes. Roles emit a handoff inside a fenced ```json block at the
+// end of their final assistant turn; the coordinator parses, validates,
+// and rejects malformed handoffs with a clear error the role can react to.
+//
+// The validator is hand-written (zero deps) and adversarial-resistant:
+//   - Unknown extra fields are stripped (no prototype pollution surface).
+//   - String fields are length-capped and stripped of control characters.
+//   - Arrays are length-capped.
+//   - Discriminator `kind` is exact-match required.
+//
+// Roles must NOT be able to inject behavior into the coordinator by
+// crafting handoff fields. Anything passed through to operator prompts or
+// other roles is sanitized via `sanitizeText`.
+// ---------- Limits ----------
+const MAX_STRING_LEN = 16_000;
+const MAX_SHORT_STRING_LEN = 1_024;
+const MAX_LIST_LEN = 64;
+const MAX_TOOLCALLS_LEN = 256;
+// ---------- Errors ----------
+export class HandoffParseError extends Error {
+    cause_text;
+    code = "HANDOFF_PARSE";
+    constructor(message, cause_text) {
+        super(message);
+        this.cause_text = cause_text;
+        this.name = "HandoffParseError";
+    }
+}
+export class HandoffValidationError extends Error {
+    path;
+    code = "HANDOFF_VALIDATION";
+    constructor(message, path) {
+        super(`handoff invalid at ${path}: ${message}`);
+        this.path = path;
+        this.name = "HandoffValidationError";
+    }
+}
+// ---------- Fenced-block extractor ----------
+// Pulls the LAST fenced ```json block out of a role's output. The "last"
+// rule means roles may write narrative + thinking before the formal
+// handoff and we always pick the canonical one.
+export function extractHandoffJson(text) {
+    const re = /```(?:json|JSON)\s*\n([\s\S]*?)```/g;
+    let match;
+    let last = null;
+    while ((match = re.exec(text)) !== null) {
+        last = match[1] ?? null;
+    }
+    return last === null ? null : last.trim();
+}
+// ---------- Sanitizers ----------
+// Strip C0 control characters except 0x09 (tab), 0x0A (LF), 0x0D (CR),
+// plus DEL (0x7F). Built from hex escapes so the source stays grep-clean.
+const CONTROL_CHARS = new RegExp(String.fromCharCode(0x5b) +
+    "\\x00-\\x08" +
+    "\\x0B\\x0C" +
+    "\\x0E-\\x1F" +
+    "\\x7F" +
+    String.fromCharCode(0x5d), "g");
+function sanitizeText(value, max = MAX_STRING_LEN) {
+    if (typeof value !== "string")
+        return "";
+    // Strip C0 control chars except tab, LF, CR; plus DEL. Then cap length.
+    const cleaned = value.replace(CONTROL_CHARS, "");
+    return cleaned.length > max ? cleaned.slice(0, max) : cleaned;
+}
+function sanitizeShort(value) {
+    return sanitizeText(value, MAX_SHORT_STRING_LEN);
+}
+function sanitizeStringArray(value, max = MAX_LIST_LEN) {
+    if (!Array.isArray(value))
+        return [];
+    const out = [];
+    for (const v of value) {
+        if (typeof v === "string") {
+            const s = sanitizeShort(v).trim();
+            if (s.length > 0)
+                out.push(s);
+        }
+        if (out.length >= max)
+            break;
+    }
+    return out;
+}
+// ---------- Validators ----------
+function requireString(obj, key, path) {
+    const v = obj[key];
+    if (typeof v !== "string" || v.length === 0) {
+        throw new HandoffValidationError(`expected non-empty string at "${key}"`, path);
+    }
+    return v;
+}
+function isPlainObject(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+export function validatePlanHandoff(raw) {
+    if (!isPlainObject(raw)) {
+        throw new HandoffValidationError("expected object", "$");
+    }
+    const kind = requireString(raw, "kind", "$.kind");
+    if (kind !== "plan") {
+        throw new HandoffValidationError(`expected kind="plan", got ${JSON.stringify(kind)}`, "$.kind");
+    }
+    if (!Array.isArray(raw.subtasks)) {
+        throw new HandoffValidationError("expected array", "$.subtasks");
+    }
+    if (raw.subtasks.length === 0) {
+        throw new HandoffValidationError("plan must contain at least one sub-task", "$.subtasks");
+    }
+    if (raw.subtasks.length > MAX_LIST_LEN) {
+        throw new HandoffValidationError(`too many sub-tasks (max ${MAX_LIST_LEN})`, "$.subtasks");
+    }
+    const subtasks = [];
+    const seenIds = new Set();
+    for (let i = 0; i < raw.subtasks.length; i++) {
+        const st = raw.subtasks[i];
+        const stPath = `$.subtasks[${i}]`;
+        if (!isPlainObject(st)) {
+            throw new HandoffValidationError("expected object", stPath);
+        }
+        const id = sanitizeShort(st.id).trim();
+        if (!id)
+            throw new HandoffValidationError("subtask id required", `${stPath}.id`);
+        if (seenIds.has(id)) {
+            throw new HandoffValidationError(`duplicate subtask id ${JSON.stringify(id)}`, `${stPath}.id`);
+        }
+        seenIds.add(id);
+        const title = sanitizeShort(st.title).trim();
+        if (!title)
+            throw new HandoffValidationError("subtask title required", `${stPath}.title`);
+        const instruction = sanitizeText(st.instruction).trim();
+        if (!instruction) {
+            throw new HandoffValidationError("subtask instruction required", `${stPath}.instruction`);
+        }
+        const acceptance_criteria = sanitizeStringArray(st.acceptance_criteria);
+        if (acceptance_criteria.length === 0) {
+            throw new HandoffValidationError("subtask acceptance_criteria must list at least one item", `${stPath}.acceptance_criteria`);
+        }
+        const order = typeof st.order === "number" && Number.isFinite(st.order) ? st.order : i;
+        const depends_on = sanitizeStringArray(st.depends_on, 4);
+        // v0.4: linear plans only. Sub-task N may depend only on sub-task N-1
+        // (or no dependency). Anything else fails validation.
+        if (depends_on.length > 0) {
+            if (depends_on.length > 1) {
+                throw new HandoffValidationError("v0.4 supports linear plans only (max one dependency per sub-task)", `${stPath}.depends_on`);
+            }
+            const prior = subtasks[subtasks.length - 1];
+            if (!prior || depends_on[0] !== prior.id) {
+                throw new HandoffValidationError("v0.4 supports linear plans only (dependency must be the immediately preceding sub-task)", `${stPath}.depends_on`);
+            }
+        }
+        subtasks.push({
+            id,
+            title,
+            instruction,
+            acceptance_criteria,
+            order,
+            ...(depends_on.length > 0 ? { depends_on } : {}),
+        });
+    }
+    // Stable ordering: ensure `order` is monotonic. Reassign if planner skipped.
+    subtasks.sort((a, b) => a.order - b.order);
+    for (let i = 0; i < subtasks.length; i++)
+        subtasks[i].order = i;
+    const rationale = sanitizeText(raw.rationale).trim();
+    return { kind: "plan", subtasks, rationale };
+}
+export function validateExecutionHandoff(raw) {
+    if (!isPlainObject(raw))
+        throw new HandoffValidationError("expected object", "$");
+    const kind = requireString(raw, "kind", "$.kind");
+    if (kind !== "execution") {
+        throw new HandoffValidationError(`expected kind="execution"`, "$.kind");
+    }
+    const subtask_id = sanitizeShort(raw.subtask_id).trim();
+    if (!subtask_id)
+        throw new HandoffValidationError("subtask_id required", "$.subtask_id");
+    const output = sanitizeText(raw.output);
+    const notes = sanitizeText(raw.notes);
+    const tool_calls = sanitizeToolCalls(raw.tool_calls);
+    return { kind: "execution", subtask_id, output, tool_calls, notes };
+}
+function sanitizeToolCalls(value) {
+    if (!Array.isArray(value))
+        return [];
+    const out = [];
+    for (const v of value) {
+        if (!isPlainObject(v))
+            continue;
+        const call_id = sanitizeShort(v.call_id).trim();
+        const name = sanitizeShort(v.name).trim();
+        if (!call_id || !name)
+            continue;
+        const at = sanitizeShort(v.at).trim() || new Date().toISOString();
+        const authorized = v.authorized === true;
+        const auth_note = typeof v.auth_note === "string" ? sanitizeShort(v.auth_note) : undefined;
+        let result;
+        if (isPlainObject(v.result)) {
+            result = {
+                success: v.result.success === true,
+                content: sanitizeText(v.result.content),
+            };
+        }
+        out.push({
+            call_id,
+            name,
+            arguments: v.arguments,
+            at,
+            authorized,
+            ...(auth_note ? { auth_note } : {}),
+            ...(result ? { result } : {}),
+        });
+        if (out.length >= MAX_TOOLCALLS_LEN)
+            break;
+    }
+    return out;
+}
+export function validateReviewHandoff(raw) {
+    if (!isPlainObject(raw))
+        throw new HandoffValidationError("expected object", "$");
+    const kind = requireString(raw, "kind", "$.kind");
+    if (kind !== "review") {
+        throw new HandoffValidationError(`expected kind="review"`, "$.kind");
+    }
+    const subtask_id = sanitizeShort(raw.subtask_id).trim();
+    if (!subtask_id)
+        throw new HandoffValidationError("subtask_id required", "$.subtask_id");
+    const verdict = raw.verdict;
+    if (verdict !== "pass" && verdict !== "fail" && verdict !== "needs_retry") {
+        throw new HandoffValidationError(`verdict must be "pass" | "fail" | "needs_retry"`, "$.verdict");
+    }
+    const rationale = sanitizeText(raw.rationale).trim();
+    if (!rationale) {
+        throw new HandoffValidationError("rationale required", "$.rationale");
+    }
+    const suggested_revision = typeof raw.suggested_revision === "string"
+        ? sanitizeText(raw.suggested_revision)
+        : undefined;
+    return {
+        kind: "review",
+        subtask_id,
+        verdict,
+        rationale,
+        ...(suggested_revision ? { suggested_revision } : {}),
+    };
+}
+export function validateEscalationHandoff(raw) {
+    if (!isPlainObject(raw))
+        throw new HandoffValidationError("expected object", "$");
+    const kind = requireString(raw, "kind", "$.kind");
+    if (kind !== "escalation") {
+        throw new HandoffValidationError(`expected kind="escalation"`, "$.kind");
+    }
+    const severity = raw.severity;
+    if (severity !== "info" && severity !== "warn" && severity !== "error") {
+        throw new HandoffValidationError(`severity must be info|warn|error`, "$.severity");
+    }
+    const role = sanitizeShort(raw.role).trim();
+    if (!role)
+        throw new HandoffValidationError("role required", "$.role");
+    const reason = sanitizeText(raw.reason).trim();
+    if (!reason)
+        throw new HandoffValidationError("reason required", "$.reason");
+    const context = sanitizeText(raw.context);
+    const budget_metric = raw.budget_metric === "tokens" ||
+        raw.budget_metric === "wall_clock_ms" ||
+        raw.budget_metric === "tool_calls"
+        ? raw.budget_metric
+        : undefined;
+    return {
+        kind: "escalation",
+        severity,
+        role,
+        reason,
+        context,
+        ...(budget_metric ? { budget_metric } : {}),
+    };
+}
+export function parseHandoffFromText(text) {
+    const fenced = extractHandoffJson(text);
+    if (fenced === null) {
+        return { ok: false, reason: "no_fence", message: "no fenced ```json block found" };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(fenced);
+    }
+    catch (err) {
+        return {
+            ok: false,
+            reason: "bad_json",
+            message: err.message.slice(0, 240),
+        };
+    }
+    if (!isPlainObject(parsed)) {
+        return { ok: false, reason: "validation", message: "handoff must be a JSON object" };
+    }
+    const kind = parsed.kind;
+    try {
+        if (kind === "plan")
+            return { ok: true, handoff: validatePlanHandoff(parsed) };
+        if (kind === "execution")
+            return { ok: true, handoff: validateExecutionHandoff(parsed) };
+        if (kind === "review")
+            return { ok: true, handoff: validateReviewHandoff(parsed) };
+        if (kind === "escalation")
+            return { ok: true, handoff: validateEscalationHandoff(parsed) };
+        return {
+            ok: false,
+            reason: "validation",
+            message: `unknown handoff kind ${JSON.stringify(kind)}`,
+        };
+    }
+    catch (err) {
+        if (err instanceof HandoffValidationError) {
+            return { ok: false, reason: "validation", message: err.message };
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=handoff.js.map

package/dist/orchestration/handoff.js.map

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

package/dist/phases/blocker.d.ts

@@ -0,0 +1,8 @@
+import type { Message, RunnerIO } from "../types.js";
+export interface BlockerOpts {
+    io: RunnerIO;
+    reason: string;
+    lastAssistant?: Message;
+}
+export declare function reportBlocker(opts: BlockerOpts): void;
+//# sourceMappingURL=blocker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"blocker.d.ts","sourceRoot":"","sources":["../../src/phases/blocker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAKrD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,QAAQ,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CASrD"}

package/dist/phases/blocker.js

@@ -0,0 +1,11 @@
+export function reportBlocker(opts) {
+    const { io, reason, lastAssistant } = opts;
+    io.banner("Phase 2: Blocker");
+    io.write(`Reason: ${reason}\n`);
+    if (lastAssistant) {
+        io.write("\nLast assistant message:\n");
+        io.write(lastAssistant.content.trim() + "\n");
+    }
+    io.write("\nRuntime has stopped. Resume with `openwar resume <brief_id>` after resolving.\n");
+}
+//# sourceMappingURL=blocker.js.map

package/dist/phases/blocker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocker.js","sourceRoot":"","sources":["../../src/phases/blocker.ts"],"names":[],"mappings":"AAWA,MAAM,UAAU,aAAa,CAAC,IAAiB;IAC7C,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IAC3C,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAC9B,EAAE,CAAC,KAAK,CAAC,WAAW,MAAM,IAAI,CAAC,CAAC;IAChC,IAAI,aAAa,EAAE,CAAC;QAClB,EAAE,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACxC,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC;IAChD,CAAC;IACD,EAAE,CAAC,KAAK,CAAC,mFAAmF,CAAC,CAAC;AAChG,CAAC"}

package/dist/phases/completion.d.ts

@@ -0,0 +1,10 @@
+import type { AgentAdapter, Message, RunnerIO } from "../types.js";
+export interface CompletionOpts {
+    adapter: AgentAdapter;
+    system: string;
+    io: RunnerIO;
+    history: Message[];
+    signal?: AbortSignal;
+}
+export declare function runCompletion(opts: CompletionOpts): Promise<Message>;
+//# sourceMappingURL=completion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../src/phases/completion.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAe,MAAM,aAAa,CAAC;AAEhF,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,QAAQ,CAAC;IACb,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAYD,wBAAsB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAqC1E"}

package/dist/phases/completion.js

@@ -0,0 +1,47 @@
+const FINAL_REPORT_PROMPT = `
+Produce the Phase 4 completion report now. Be concise:
+
+- What was delivered
+- Anything unresolved
+- Anything left open / handed back to the operator
+
+Do not restate the diff or anything visible in the work itself. Surface what the operator cannot see by reading the result.
+`.trim();
+export async function runCompletion(opts) {
+    const { adapter, system, io, history, signal } = opts;
+    io.banner("Phase 4: Completion");
+    const request = {
+        role: "user",
+        content: FINAL_REPORT_PROMPT,
+        at: new Date().toISOString(),
+        meta: { phase: "completion", step_index: 0 },
+    };
+    let assembled = "";
+    for await (const ev of adapter.sendMessage({
+        system,
+        messages: [...history, request],
+        ...(signal ? { signal } : {}),
+    })) {
+        if (ev.type === "text_delta") {
+            io.write(ev.delta);
+            assembled += ev.delta;
+        }
+        else if (ev.type === "done") {
+            io.write("\n");
+            if (ev.message && ev.message.length >= assembled.length) {
+                assembled = ev.message;
+            }
+            break;
+        }
+        else if (ev.type === "error") {
+            throw ev.error;
+        }
+    }
+    return {
+        role: "assistant",
+        content: assembled,
+        at: new Date().toISOString(),
+        meta: { phase: "completion", step_index: 1 },
+    };
+}
+//# sourceMappingURL=completion.js.map

package/dist/phases/completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.js","sourceRoot":"","sources":["../../src/phases/completion.ts"],"names":[],"mappings":"AAUA,MAAM,mBAAmB,GAAG;;;;;;;;CAQ3B,CAAC,IAAI,EAAE,CAAC;AAET,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAoB;IACtD,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACtD,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAEjC,MAAM,OAAO,GAAY;QACvB,IAAI,EAAE,MAAM;QACZ,OAAO,EAAE,mBAAmB;QAC5B,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,IAAI,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,EAAE;KAC7C,CAAC;IAEF,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,IAAI,KAAK,EAAE,MAAM,EAAE,IAAI,OAAO,CAAC,WAAW,CAAC;QACzC,MAAM;QACN,QAAQ,EAAE,CAAC,GAAG,OAAO,EAAE,OAAO,CAAC;QAC/B,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9B,CAA+B,EAAE,CAAC;QACjC,IAAI,EAAE,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC7B,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;YACnB,SAAS,IAAI,EAAE,CAAC,KAAK,CAAC;QACxB,CAAC;aAAM,IAAI,EAAE,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC9B,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACf,IAAI,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;gBACxD,SAAS,GAAG,EAAE,CAAC,OAAO,CAAC;YACzB,CAAC;YACD,MAAM;QACR,CAAC;aAAM,IAAI,EAAE,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC/B,MAAM,EAAE,CAAC,KAAK,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,SAAS;QAClB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,IAAI,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC,EAAE;KAC7C,CAAC;AACJ,CAAC"}

package/dist/phases/destructive.d.ts

@@ -0,0 +1,10 @@
+import type { DestructiveDetection, Message, RunnerIO } from "../types.js";
+export interface DestructiveOpts {
+    io: RunnerIO;
+    detection: DestructiveDetection;
+    lastAssistant?: Message;
+}
+export declare function awaitOperatorYes(opts: DestructiveOpts): Promise<boolean>;
+export declare function denialMessage(detection: DestructiveDetection): Message;
+export declare function approvalMessage(detection: DestructiveDetection): Message;
+//# sourceMappingURL=destructive.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"destructive.d.ts","sourceRoot":"","sources":["../../src/phases/destructive.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAI3E,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,QAAQ,CAAC;IACb,SAAS,EAAE,oBAAoB,CAAC;IAChC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAa9E;AAED,wBAAgB,aAAa,CAAC,SAAS,EAAE,oBAAoB,GAAG,OAAO,CAStE;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,oBAAoB,GAAG,OAAO,CASxE"}

package/dist/phases/destructive.js

@@ -0,0 +1,31 @@
+export async function awaitOperatorYes(opts) {
+    const { io, detection, lastAssistant } = opts;
+    io.banner("Phase 3: Destructive flag");
+    io.write(`Action category: ${detection.action ?? "unspecified"}\n`);
+    if (lastAssistant) {
+        io.write("\nProposed action (from the agent):\n");
+        io.write(lastAssistant.content.trim() + "\n\n");
+    }
+    io.write("This action falls outside the brief's authorized_costs and requires explicit approval.\n");
+    const approved = await io.confirm("Approve this action for the current session?");
+    return approved;
+}
+export function denialMessage(detection) {
+    return {
+        role: "user",
+        content: `The operator has DENIED the destructive action ("${detection.action ?? "unspecified"}"). ` +
+            "Do not perform it. Propose a non-destructive alternative or stop and ask for a scope clarification.",
+        at: new Date().toISOString(),
+        meta: { phase: "destructive", step_index: 0 },
+    };
+}
+export function approvalMessage(detection) {
+    return {
+        role: "user",
+        content: `The operator has APPROVED the destructive action ("${detection.action ?? "unspecified"}") ` +
+            "for the current session. Proceed, then report what was done.",
+        at: new Date().toISOString(),
+        meta: { phase: "destructive", step_index: 0 },
+    };
+}
+//# sourceMappingURL=destructive.js.map

package/dist/phases/destructive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"destructive.js","sourceRoot":"","sources":["../../src/phases/destructive.ts"],"names":[],"mappings":"AAUA,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAqB;IAC1D,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,IAAI,CAAC;IAC9C,EAAE,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAC;IACvC,EAAE,CAAC,KAAK,CAAC,oBAAoB,SAAS,CAAC,MAAM,IAAI,aAAa,IAAI,CAAC,CAAC;IACpE,IAAI,aAAa,EAAE,CAAC;QAClB,EAAE,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAClD,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,MAAM,CAAC,CAAC;IAClD,CAAC;IACD,EAAE,CAAC,KAAK,CACN,0FAA0F,CAC3F,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,8CAA8C,CAAC,CAAC;IAClF,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,SAA+B;IAC3D,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,OAAO,EACL,oDAAoD,SAAS,CAAC,MAAM,IAAI,aAAa,MAAM;YAC3F,qGAAqG;QACvG,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,IAAI,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,EAAE;KAC9C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,SAA+B;IAC7D,OAAO;QACL,IAAI,EAAE,MAAM;QACZ,OAAO,EACL,sDAAsD,SAAS,CAAC,MAAM,IAAI,aAAa,KAAK;YAC5F,8DAA8D;QAChE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QAC5B,IAAI,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,CAAC,EAAE;KAC9C,CAAC;AACJ,CAAC"}

package/dist/phases/execute.d.ts

@@ -0,0 +1,30 @@
+import type { AgentAdapter, Brief, Message, RunnerIO, ExecutionMode, DetectorSnapshot, ToolDefinition, ToolCall, ToolResultForRound } from "../types.js";
+import type { SandboxContext } from "../sandbox/types.js";
+import type { ToolExecutor } from "../tools/types.js";
+export interface ExecuteOpts {
+    brief: Brief;
+    adapter: AgentAdapter;
+    system: string;
+    io: RunnerIO;
+    mode: ExecutionMode;
+    history: Message[];
+    maxSteps?: number;
+    maxToolRoundsPerStep?: number;
+    signal?: AbortSignal;
+    onMessage?: (m: Message) => void;
+    onToolCall?: (call: ToolCall, result: ToolResultForRound) => void;
+    toolDefinitions?: ToolDefinition[];
+    toolExecutors?: Map<string, ToolExecutor>;
+    sandbox?: SandboxContext;
+    sessionApproved?: string[];
+}
+export interface ExecuteResult {
+    history: Message[];
+    outcome: "completion" | "blocker" | "destructive_denied" | "max_steps" | "operator_done";
+    reason?: string;
+    blocking_detectors?: DetectorSnapshot;
+    destructive_tool_call?: ToolCall;
+    destructive_missing_categories?: readonly string[];
+}
+export declare function runExecute(opts: ExecuteOpts): Promise<ExecuteResult>;
+//# sourceMappingURL=execute.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../src/phases/execute.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,KAAK,EACL,OAAO,EACP,QAAQ,EACR,aAAa,EAEb,gBAAgB,EAChB,cAAc,EACd,QAAQ,EACR,kBAAkB,EACnB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAItD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,QAAQ,CAAC;IACb,IAAI,EAAE,aAAa,CAAC;IACpB,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAGlE,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,aAAa,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC1C,OAAO,CAAC,EAAE,cAAc,CAAC;IAEzB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,OAAO,EAAE,YAAY,GAAG,SAAS,GAAG,oBAAoB,GAAG,WAAW,GAAG,eAAe,CAAC;IACzF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kBAAkB,CAAC,EAAE,gBAAgB,CAAC;IAGtC,qBAAqB,CAAC,EAAE,QAAQ,CAAC;IACjC,8BAA8B,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpD;AAkBD,wBAAsB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAwM1E"}