@xrkseek/harness 0.4.0-rc.4 → 0.4.1

package/node_modules/@xrkseek/server-face/dist/propose-skill.js

@@ -0,0 +1,65 @@
+/**
+ * Face binding for `propose_skill` — always gate writes through user questions
+ * (Hermes skills.write_approval stage path; XRK confirms inline via ask UI).
+ */
+import { clearLearningLoopNudge, createProposeSkillTool, PROPOSE_SKILL_TOOL, } from "@xrkseek/workspace";
+import { FaceQuestionError } from "./questions.js";
+export const PROPOSE_SKILL_APPROVE_LABEL = "Write skill";
+export const PROPOSE_SKILL_REJECT_LABEL = "Reject";
+export const PROPOSE_SKILL_QUESTION_ID = "propose-skill";
+export function proposeSkillQuestions(draft) {
+    return [
+        {
+            id: PROPOSE_SKILL_QUESTION_ID,
+            header: "Learning loop",
+            question: `Write skill "${draft.name}" to ${draft.targetRel}?`,
+            detail: draft.markdown,
+            options: [
+                {
+                    label: PROPOSE_SKILL_APPROVE_LABEL,
+                    description: "Validate frontmatter and create the skill directory (user consent).",
+                },
+                {
+                    label: PROPOSE_SKILL_REJECT_LABEL,
+                    description: "Discard the draft; nothing is written.",
+                },
+            ],
+        },
+    ];
+}
+/** Register / replace `propose_skill` with Face confirm → write. */
+export function bindProposeSkillTool(tools, options) {
+    const bound = createProposeSkillTool({
+        resolveWorkspaceRoot: () => options.workspaceRoot,
+        ...(options.skillsRoot !== undefined
+            ? { resolveSkillsRoot: () => options.skillsRoot }
+            : {}),
+        async askConfirm(draft, signal) {
+            try {
+                const answer = await options.ask(proposeSkillQuestions(draft), signal);
+                const item = answer.answers.find((row) => row.id === PROPOSE_SKILL_QUESTION_ID);
+                if (item?.selected.length === 1 &&
+                    item.selected[0] === PROPOSE_SKILL_APPROVE_LABEL &&
+                    item.custom === undefined) {
+                    clearLearningLoopNudge(options.sessionId);
+                    return { approved: true };
+                }
+                return {
+                    approved: false,
+                    ...(item?.custom !== undefined ? { feedback: item.custom } : {}),
+                };
+            }
+            catch (err) {
+                if (err instanceof FaceQuestionError && err.code === "ASK_CANCELLED") {
+                    return { approved: false, feedback: "cancelled" };
+                }
+                throw err;
+            }
+        },
+    });
+    if (tools.get(PROPOSE_SKILL_TOOL))
+        tools.replace(bound);
+    else
+        tools.register(bound);
+}
+//# sourceMappingURL=propose-skill.js.map

package/node_modules/@xrkseek/server-face/dist/propose-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"propose-skill.js","sourceRoot":"","sources":["../src/propose-skill.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,GAEnB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnD,MAAM,CAAC,MAAM,2BAA2B,GAAG,aAAa,CAAC;AACzD,MAAM,CAAC,MAAM,0BAA0B,GAAG,QAAQ,CAAC;AACnD,MAAM,CAAC,MAAM,yBAAyB,GAAG,eAAe,CAAC;AAEzD,MAAM,UAAU,qBAAqB,CACnC,KAAwB;IAExB,OAAO;QACL;YACE,EAAE,EAAE,yBAAyB;YAC7B,MAAM,EAAE,eAAe;YACvB,QAAQ,EAAE,gBAAgB,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,SAAS,GAAG;YAC9D,MAAM,EAAE,KAAK,CAAC,QAAQ;YACtB,OAAO,EAAE;gBACP;oBACE,KAAK,EAAE,2BAA2B;oBAClC,WAAW,EACT,qEAAqE;iBACxE;gBACD;oBACE,KAAK,EAAE,0BAA0B;oBACjC,WAAW,EAAE,wCAAwC;iBACtD;aACF;SACF;KACF,CAAC;AACJ,CAAC;AAYD,oEAAoE;AACpE,MAAM,UAAU,oBAAoB,CAClC,KAAmB,EACnB,OAAoC;IAEpC,MAAM,KAAK,GAAG,sBAAsB,CAAC;QACnC,oBAAoB,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,aAAa;QACjD,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS;YAClC,CAAC,CAAC,EAAE,iBAAiB,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE;YACjD,CAAC,CAAC,EAAE,CAAC;QACP,KAAK,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM;YAC5B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,CAC9B,qBAAqB,CAAC,KAAK,CAAC,EAC5B,MAAM,CACP,CAAC;gBACF,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,CAC9B,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,yBAAyB,CAC9C,CAAC;gBACF,IACE,IAAI,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC;oBAC3B,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,2BAA2B;oBAChD,IAAI,CAAC,MAAM,KAAK,SAAS,EACzB,CAAC;oBACD,sBAAsB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;oBAC1C,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;gBAC5B,CAAC;gBACD,OAAO;oBACL,QAAQ,EAAE,KAAK;oBACf,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACjE,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,iBAAiB,IAAI,GAAG,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;oBACrE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC;gBACpD,CAAC;gBACD,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;;QACnD,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7B,CAAC"}

package/node_modules/@xrkseek/server-face/dist/ralph-tool.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Face-native Ralph loop (DSH tool-ralph semantics without Cordis WorkflowEngine).
+ * Foreground: one fresh one-shot child per round; only a bounded structured
+ * handoff crosses rounds. Workspace is the durable memory.
+ */
+import type { ToolDefinition, ToolRegistry } from "@xrkseek/core-tools";
+import type { FaceRuntime } from "./context.js";
+/** Product default / call ceiling (DSH default 256 is too large for Face). */
+export declare const RALPH_DEFAULT_MAX_ROUNDS = 8;
+export declare const RALPH_HARD_MAX_ROUNDS = 32;
+export declare const RALPH_MAX_HANDOFF_CHARS = 16384;
+export type RalphRoundStatus = "continue" | "complete" | "blocked";
+export interface RalphRoundReport {
+    readonly status: RalphRoundStatus;
+    readonly summary: string;
+    readonly evidence: readonly string[];
+    readonly nextSteps: readonly string[];
+    readonly blocker: string;
+}
+export type RalphTerminalStatus = "complete" | "blocked" | "budget-limited" | "round-failed";
+/** Validate a worker report (DSH status-specific rules + size ceiling). */
+export declare function validateRalphReport(raw: unknown, maxHandoffChars?: number): RalphRoundReport;
+export interface BindRalphToolOptions {
+    readonly runtime: FaceRuntime;
+    readonly parentSessionId: string;
+    readonly maxDepth?: number;
+    readonly maxActiveChildren?: number;
+    /** Override default/ceiling for tests. */
+    readonly maxRoundsCeiling?: number;
+}
+export declare function createRalphTool(options: BindRalphToolOptions): ToolDefinition;
+export declare function bindRalphTool(tools: ToolRegistry, options: BindRalphToolOptions): void;
+//# sourceMappingURL=ralph-tool.d.ts.map

package/node_modules/@xrkseek/server-face/dist/ralph-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralph-tool.d.ts","sourceRoot":"","sources":["../src/ralph-tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAchD,8EAA8E;AAC9E,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,qBAAqB,KAAK,CAAC;AACxC,eAAO,MAAM,uBAAuB,QAAS,CAAC;AA2B9C,MAAM,MAAM,gBAAgB,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAEnE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,MAAM,mBAAmB,GAC3B,UAAU,GACV,SAAS,GACT,gBAAgB,GAChB,cAAc,CAAC;AAiCnB,2EAA2E;AAC3E,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,OAAO,EACZ,eAAe,SAA0B,GACxC,gBAAgB,CAwDlB;AAuDD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,0CAA0C;IAC1C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC;AAaD,wBAAgB,eAAe,CAAC,OAAO,EAAE,oBAAoB,GAAG,cAAc,CA2O7E;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,YAAY,EACnB,OAAO,EAAE,oBAAoB,GAC5B,IAAI,CAIN"}

package/node_modules/@xrkseek/server-face/dist/ralph-tool.js

@@ -0,0 +1,366 @@
+import { readSessionEvents } from "@xrkseek/core-session";
+import { dispatchFaceMethod } from "./dispatch.js";
+import { lastAssistantBodyText } from "./adapt/subagent-notice.js";
+import { appendOutputContract, extractJsonCandidate, } from "./agent-team-output.js";
+import { DEFAULT_MAX_ACTIVE_CHILDREN, DEFAULT_MAX_DEPTH, } from "./presets-catalog.js";
+const FOREGROUND_WAIT_MS = 10 * 60 * 1000;
+const POLL_MS = 50;
+/** Product default / call ceiling (DSH default 256 is too large for Face). */
+export const RALPH_DEFAULT_MAX_ROUNDS = 8;
+export const RALPH_HARD_MAX_ROUNDS = 32;
+export const RALPH_MAX_HANDOFF_CHARS = 16_384;
+function subagentDepth(runtime, sessionId) {
+    let depth = 0;
+    let cur = sessionId;
+    for (;;) {
+        const link = runtime.subagents.getByChild(cur);
+        if (!link)
+            break;
+        if (link.mode !== "fork")
+            depth += 1;
+        cur = link.parentSessionId;
+    }
+    return depth;
+}
+const REPORT_SCHEMA = {
+    type: "object",
+    properties: {
+        status: { type: "string", enum: ["continue", "complete", "blocked"] },
+        summary: { type: "string" },
+        evidence: { type: "array", items: { type: "string" } },
+        nextSteps: { type: "array", items: { type: "string" } },
+        blocker: { type: "string" },
+    },
+    required: ["status", "summary", "evidence", "nextSteps", "blocker"],
+    additionalProperties: false,
+};
+async function waitDrainIdle(runtime, sessionId, signal, timeoutMs = FOREGROUND_WAIT_MS) {
+    const run = runtime.drain.run?.bind(runtime.drain);
+    if (run) {
+        await run(sessionId);
+        return;
+    }
+    const deadline = Date.now() + timeoutMs;
+    while (runtime.drain.isActive(sessionId)) {
+        if (signal?.aborted) {
+            throw new DOMException("aborted", "AbortError");
+        }
+        if (Date.now() > deadline) {
+            throw new Error(`ralph round timed out waiting for session ${sessionId}`);
+        }
+        await new Promise((r) => setTimeout(r, POLL_MS));
+    }
+}
+function normalizedText(value) {
+    return typeof value === "string" && value.length > 0 && value === value.trim();
+}
+function normalizedList(value) {
+    return Array.isArray(value) && value.every(normalizedText);
+}
+/** Validate a worker report (DSH status-specific rules + size ceiling). */
+export function validateRalphReport(raw, maxHandoffChars = RALPH_MAX_HANDOFF_CHARS) {
+    if (raw === null || typeof raw !== "object" || Array.isArray(raw)) {
+        throw new Error("Ralph child returned no structured round report");
+    }
+    const report = raw;
+    if (!normalizedText(report.summary)) {
+        throw new Error("Ralph round report summary must be non-empty and normalized");
+    }
+    if (!normalizedList(report.evidence) || !normalizedList(report.nextSteps)) {
+        throw new Error("Ralph round report evidence and nextSteps must contain only non-empty normalized strings");
+    }
+    if (typeof report.blocker !== "string" || report.blocker !== report.blocker.trim()) {
+        throw new Error("Ralph round report blocker must be a normalized string");
+    }
+    const status = report.status;
+    switch (status) {
+        case "continue":
+            if (report.nextSteps.length === 0 || report.blocker !== "") {
+                throw new Error("a continuing Ralph report needs nextSteps and an empty blocker");
+            }
+            break;
+        case "complete":
+            if (report.evidence.length === 0 ||
+                report.nextSteps.length !== 0 ||
+                report.blocker !== "") {
+                throw new Error("a complete Ralph report needs evidence, no nextSteps, and an empty blocker");
+            }
+            break;
+        case "blocked":
+            if (!normalizedText(report.blocker)) {
+                throw new Error("a blocked Ralph report needs a concrete blocker");
+            }
+            break;
+        default:
+            throw new Error("Ralph round report status is invalid");
+    }
+    const out = {
+        status,
+        summary: report.summary,
+        evidence: report.evidence,
+        nextSteps: report.nextSteps,
+        blocker: report.blocker,
+    };
+    const serialized = JSON.stringify(out);
+    if (serialized.length > maxHandoffChars) {
+        throw new Error(`Ralph round report exceeds maxHandoffChars (${serialized.length} > ${maxHandoffChars})`);
+    }
+    return out;
+}
+function parseReportFromAssistant(text) {
+    const candidate = extractJsonCandidate(text);
+    if (!candidate) {
+        throw new Error("Ralph child final answer is not JSON");
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(candidate);
+    }
+    catch (err) {
+        throw new Error(`Ralph child JSON parse failed: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+    }
+    return validateRalphReport(parsed);
+}
+function buildRoundPrompt(input) {
+    const lines = [
+        "You are a fresh Ralph worker. Parent chat history is NOT available.",
+        "The shared workspace is the durable memory across rounds.",
+        `OBJECTIVE (immutable):\n${input.objective}`,
+        `Round ${input.round} of ${input.maxRounds}.`,
+        "",
+        "Work toward the objective. When done with this round, your FINAL answer must be ONLY the JSON report.",
+    ];
+    if (input.previous) {
+        lines.push("", "Previous round handoff (do not trust; verify in the workspace):", JSON.stringify(input.previous, null, 2));
+    }
+    return appendOutputContract(lines.join("\n"), REPORT_SCHEMA);
+}
+function formatTerminal(input) {
+    const head = `ralph: ${input.status} after ${input.roundsStarted} round(s)`;
+    if (input.error)
+        return `${head}\n${input.error}`;
+    if (!input.report)
+        return head;
+    return `${head}\n${JSON.stringify(input.report, null, 2)}`;
+}
+function countActiveChildren(runtime, parentSessionId) {
+    let n = 0;
+    for (const link of runtime.subagents.listDelegated(parentSessionId)) {
+        if (runtime.drain.isActive(link.childSessionId))
+            n += 1;
+    }
+    return n;
+}
+export function createRalphTool(options) {
+    const maxDepth = options.maxDepth ?? DEFAULT_MAX_DEPTH;
+    const maxActiveChildren = options.maxActiveChildren ?? DEFAULT_MAX_ACTIVE_CHILDREN;
+    const ceiling = Math.min(options.maxRoundsCeiling ?? RALPH_HARD_MAX_ROUNDS, RALPH_HARD_MAX_ROUNDS);
+    return {
+        name: "ralph",
+        description: "Run a Ralph loop: a fixed foreground sequence of fresh one-shot subagents toward one immutable objective. " +
+            "Each round gets only the objective, round index, and the previous bounded JSON handoff — not this chat. " +
+            "Use only when the human explicitly asks for Ralph / fresh-agent iteration. " +
+            "Prefer `subagent` for ordinary delegation and goals/todos for same-session long work.",
+        parameters: {
+            type: "object",
+            properties: {
+                objective: {
+                    type: "string",
+                    description: "Immutable objective for every fresh child round.",
+                },
+                maxRounds: {
+                    type: "integer",
+                    description: `Round cap (default ${RALPH_DEFAULT_MAX_ROUNDS}, ceiling ${ceiling}).`,
+                },
+            },
+            required: ["objective"],
+        },
+        presentCall: (args) => ({
+            card: "generic",
+            title: "ralph",
+            kind: "execute",
+            rawInput: args,
+        }),
+        async execute(args, signal) {
+            const a = args;
+            const objective = String(a.objective ?? "").trim();
+            if (!objective) {
+                return { content: "ralph: empty objective", isError: true };
+            }
+            const requested = typeof a.maxRounds === "number" && Number.isFinite(a.maxRounds)
+                ? Math.floor(a.maxRounds)
+                : RALPH_DEFAULT_MAX_ROUNDS;
+            if (requested < 1) {
+                return { content: "ralph: maxRounds must be >= 1", isError: true };
+            }
+            const maxRounds = Math.min(requested, ceiling);
+            const depth = subagentDepth(options.runtime, options.parentSessionId);
+            if (depth >= maxDepth) {
+                return {
+                    content: `ralph: max depth ${maxDepth} reached (current depth ${depth})`,
+                    isError: true,
+                };
+            }
+            let previous;
+            let roundsStarted = 0;
+            for (let round = 1; round <= maxRounds; round += 1) {
+                if (signal?.aborted) {
+                    return {
+                        content: formatTerminal({
+                            status: "round-failed",
+                            roundsStarted,
+                            ...(previous ? { report: previous } : {}),
+                            error: "aborted",
+                        }),
+                        isError: true,
+                    };
+                }
+                const active = countActiveChildren(options.runtime, options.parentSessionId);
+                if (active >= maxActiveChildren) {
+                    return {
+                        content: formatTerminal({
+                            status: "round-failed",
+                            roundsStarted,
+                            ...(previous ? { report: previous } : {}),
+                            error: `max active children ${maxActiveChildren} reached`,
+                        }),
+                        isError: true,
+                    };
+                }
+                const created = await dispatchFaceMethod(options.runtime, "session.create", `tool-ralph-${Date.now()}-${round}`, {
+                    parentSessionId: options.parentSessionId,
+                    label: `ralph-r${round}`,
+                    mode: "one-shot",
+                });
+                if (!created.result.ok) {
+                    return {
+                        content: formatTerminal({
+                            status: "round-failed",
+                            roundsStarted,
+                            ...(previous ? { report: previous } : {}),
+                            error: created.result.error.message,
+                        }),
+                        isError: true,
+                    };
+                }
+                const childId = String(created.result.value.sessionId);
+                roundsStarted += 1;
+                options.runtime.agentTeamTasks.open({
+                    parentSessionId: options.parentSessionId,
+                    title: `ralph r${round}`,
+                    childSessionId: childId,
+                    role: "worker",
+                    taskId: `ralph_${options.parentSessionId}_${round}`,
+                });
+                const prompt = buildRoundPrompt({
+                    objective,
+                    round,
+                    maxRounds,
+                    ...(previous ? { previous } : {}),
+                });
+                const prompted = await dispatchFaceMethod(options.runtime, "session.prompt", `tool-ralph-p-${childId}`, {
+                    sessionId: childId,
+                    mode: "queue",
+                    content: [{ type: "text", text: prompt }],
+                });
+                if (!prompted.result.ok) {
+                    options.runtime.agentTeamTasks.completeByChild(childId, {
+                        ok: false,
+                        preview: prompted.result.error.message,
+                    });
+                    return {
+                        content: formatTerminal({
+                            status: "round-failed",
+                            roundsStarted,
+                            ...(previous ? { report: previous } : {}),
+                            error: prompted.result.error.message,
+                        }),
+                        isError: true,
+                    };
+                }
+                try {
+                    await waitDrainIdle(options.runtime, childId, signal);
+                }
+                catch (err) {
+                    const message = err instanceof Error ? err.message : String(err);
+                    await dispatchFaceMethod(options.runtime, "session.cancel", `tool-ralph-c-${childId}`, { sessionId: childId }).catch(() => undefined);
+                    options.runtime.agentTeamTasks.completeByChild(childId, {
+                        ok: false,
+                        preview: message,
+                    });
+                    return {
+                        content: formatTerminal({
+                            status: "round-failed",
+                            roundsStarted,
+                            ...(previous ? { report: previous } : {}),
+                            error: message,
+                        }),
+                        isError: true,
+                    };
+                }
+                const text = lastAssistantBodyText(readSessionEvents(options.runtime.store, childId));
+                let report;
+                try {
+                    report = parseReportFromAssistant(text);
+                }
+                catch (err) {
+                    const message = err instanceof Error ? err.message : String(err);
+                    options.runtime.agentTeamTasks.completeByChild(childId, {
+                        ok: false,
+                        preview: message,
+                        schemaValid: false,
+                        schemaErrors: [message],
+                    });
+                    return {
+                        content: formatTerminal({
+                            status: "round-failed",
+                            roundsStarted,
+                            ...(previous ? { report: previous } : {}),
+                            error: `round ${round}: ${message}`,
+                        }),
+                        isError: true,
+                    };
+                }
+                options.runtime.agentTeamTasks.completeByChild(childId, {
+                    ok: true,
+                    preview: JSON.stringify(report),
+                    schemaValid: true,
+                });
+                previous = report;
+                if (report.status === "complete") {
+                    return {
+                        content: formatTerminal({
+                            status: "complete",
+                            roundsStarted,
+                            report,
+                        }),
+                    };
+                }
+                if (report.status === "blocked") {
+                    return {
+                        content: formatTerminal({
+                            status: "blocked",
+                            roundsStarted,
+                            report,
+                        }),
+                    };
+                }
+            }
+            return {
+                content: formatTerminal({
+                    status: "budget-limited",
+                    roundsStarted,
+                    ...(previous ? { report: previous } : {}),
+                }),
+            };
+        },
+    };
+}
+export function bindRalphTool(tools, options) {
+    const tool = createRalphTool(options);
+    if (tools.get(tool.name))
+        tools.replace(tool);
+    else
+        tools.register(tool);
+}
+//# sourceMappingURL=ralph-tool.js.map

package/node_modules/@xrkseek/server-face/dist/ralph-tool.js.map

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

package/node_modules/@xrkseek/server-face/dist/reference-discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reference-discovery.d.ts","sourceRoot":"","sources":["../src/reference-discovery.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAWhF,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,sCAAsC,CAAC;AAC7F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AA4BhD,0DAA0D;AAC1D,wBAAsB,2BAA2B,CAC/C,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAGnC;AAqBD,uEAAuE;AACvE,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,gCAAgC,EAAE,CAQpC"}
+{"version":3,"file":"reference-discovery.d.ts","sourceRoot":"","sources":["../src/reference-discovery.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAWhF,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,sCAAsC,CAAC;AAC7F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AA6BhD,0DAA0D;AAC1D,wBAAsB,2BAA2B,CAC/C,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAGnC;AAqBD,uEAAuE;AACvE,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACb,gCAAgC,EAAE,CAQpC"}

package/node_modules/@xrkseek/server-face/dist/reference-discovery.js

@@ -12,6 +12,7 @@ function fileSearchFor(sessionId, cwd) {
         maxResults: DEFAULT_FILE_SEARCH_MAX_RESULTS,
         maxEntries: DEFAULT_FILE_SEARCH_MAX_ENTRIES,
         excludedDirectories: [...DEFAULT_FILE_SEARCH_EXCLUDED_DIRECTORIES],
+        respectGitignore: true,
     });
     fileSearches.set(sessionId, { cwd, search });
     return search;

package/node_modules/@xrkseek/server-face/dist/reference-discovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"reference-discovery.js","sourceRoot":"","sources":["../src/reference-discovery.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,wCAAwC,EACxC,+BAA+B,EAC/B,+BAA+B,EAC/B,mBAAmB,GACpB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,kCAAkC,GAEnC,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAOrD,MAAM,YAAY,GAAG,IAAI,GAAG,EAA2B,CAAC;AAExD,SAAS,aAAa,CACpB,SAAiB,EACjB,GAAW;IAEX,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7C,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;QACnD,OAAO,QAAQ,CAAC,MAAM,CAAC;IACzB,CAAC;IACD,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,IAAI,mBAAmB,CAAC,GAAG,EAAE;QAC1C,UAAU,EAAE,+BAA+B;QAC3C,UAAU,EAAE,+BAA+B;QAC3C,mBAAmB,EAAE,CAAC,GAAG,wCAAwC,CAAC;KACnE,CAAC,CAAC;IACH,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,SAAiB,EACjB,GAAW,EACX,KAAa,EACb,MAAmB;IAEnB,MAAM,CAAC,cAAc,EAAE,CAAC;IACxB,OAAO,aAAa,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,eAAe,CAAC,OAAoB;IAC3C,OAAO;QACL,OAAO,CAAC,SAAS;YACf,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAG/C,CAAC;YACd,OAAO,KAAK,CAAC;QACf,CAAC;QACD,cAAc,CAAC,SAAS;YACtB,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CACtC,SAAS,EACT,qBAAqB,CACmC,CAAC;YAC3D,OAAO,IAAI,EAAE,YAAY,IAAI,IAAI,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,8BAA8B,CAC5C,OAAoB,EACpB,OAAe,EACf,KAAa,EACb,KAAc;IAEd,OAAO,kCAAkC,CAAC,OAAO,CAAC,KAAK,EAAE;QACvD,OAAO;QACP,KAAK;QACL,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,UAAU,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,SAAS,CAAC;QAChE,WAAW,EAAE,eAAe,CAAC,OAAO,CAAC;KACtC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"reference-discovery.js","sourceRoot":"","sources":["../src/reference-discovery.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,wCAAwC,EACxC,+BAA+B,EAC/B,+BAA+B,EAC/B,mBAAmB,GACpB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EACL,kCAAkC,GAEnC,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAOrD,MAAM,YAAY,GAAG,IAAI,GAAG,EAA2B,CAAC;AAExD,SAAS,aAAa,CACpB,SAAiB,EACjB,GAAW;IAEX,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAC7C,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,CAAC,GAAG,KAAK,GAAG,EAAE,CAAC;QACnD,OAAO,QAAQ,CAAC,MAAM,CAAC;IACzB,CAAC;IACD,QAAQ,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IAC3B,MAAM,MAAM,GAAG,IAAI,mBAAmB,CAAC,GAAG,EAAE;QAC1C,UAAU,EAAE,+BAA+B;QAC3C,UAAU,EAAE,+BAA+B;QAC3C,mBAAmB,EAAE,CAAC,GAAG,wCAAwC,CAAC;QAClE,gBAAgB,EAAE,IAAI;KACvB,CAAC,CAAC;IACH,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,0DAA0D;AAC1D,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,SAAiB,EACjB,GAAW,EACX,KAAa,EACb,MAAmB;IAEnB,MAAM,CAAC,cAAc,EAAE,CAAC;IACxB,OAAO,aAAa,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,eAAe,CAAC,OAAoB;IAC3C,OAAO;QACL,OAAO,CAAC,SAAS;YACf,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAG/C,CAAC;YACd,OAAO,KAAK,CAAC;QACf,CAAC;QACD,cAAc,CAAC,SAAS;YACtB,MAAM,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,CACtC,SAAS,EACT,qBAAqB,CACmC,CAAC;YAC3D,OAAO,IAAI,EAAE,YAAY,IAAI,IAAI,CAAC;QACpC,CAAC;KACF,CAAC;AACJ,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,8BAA8B,CAC5C,OAAoB,EACpB,OAAe,EACf,KAAa,EACb,KAAc;IAEd,OAAO,kCAAkC,CAAC,OAAO,CAAC,KAAK,EAAE;QACvD,OAAO;QACP,KAAK;QACL,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,UAAU,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,SAAS,CAAC;QAChE,WAAW,EAAE,eAAe,CAAC,OAAO,CAAC;KACtC,CAAC,CAAC;AACL,CAAC"}

package/node_modules/@xrkseek/server-face/dist/rollout-trace.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Local offline rollout-trace reducer (Codex-style evidence graph).
+ * Session events + subagent links → nodes/edges for debug replay.
+ * Not OTLP, not upload — debug-only sidecar next to session export.
+ */
+import type { SessionEvent } from "@xrkseek/protocol";
+export type RolloutTraceEdgeKind = "spawn" | "message" | "tool";
+export type RolloutTraceNodeKind = "session" | "turn" | "tool_call" | "message";
+export interface RolloutTraceNode {
+    readonly id: string;
+    readonly kind: RolloutTraceNodeKind;
+    readonly sessionId: string;
+    readonly label?: string;
+    readonly turnId?: string;
+    readonly toolName?: string;
+}
+export interface RolloutTraceEdge {
+    readonly id: string;
+    readonly kind: RolloutTraceEdgeKind;
+    readonly from: string;
+    readonly to: string;
+    readonly label?: string;
+}
+export interface RolloutTraceLink {
+    readonly parentSessionId: string;
+    readonly childSessionId: string;
+    readonly mode?: string;
+    readonly label?: string;
+}
+export interface RolloutTraceState {
+    readonly version: 1;
+    /** Local debug only — never treat as telemetry upload payload. */
+    readonly purpose: "local-debug";
+    readonly rootSessionId: string;
+    readonly sessions: readonly string[];
+    readonly nodes: readonly RolloutTraceNode[];
+    readonly edges: readonly RolloutTraceEdge[];
+    readonly counts: {
+        readonly nodes: number;
+        readonly edges: number;
+        readonly spawn: number;
+        readonly message: number;
+        readonly tool: number;
+    };
+}
+export interface BuildRolloutTraceInput {
+    readonly rootSessionId: string;
+    /** Session id → append-only events (order preserved). */
+    readonly eventsBySession: Readonly<Record<string, readonly SessionEvent[]>>;
+    /** Parent→child registry (Face subagents); drives spawn edges. */
+    readonly links?: readonly RolloutTraceLink[];
+}
+/**
+ * Reduce session events + subagent links into a local debug graph.
+ * Edges: spawn (registry), message (user/assistant turns), tool (call→result).
+ */
+export declare function buildRolloutTraceState(input: BuildRolloutTraceInput): RolloutTraceState;
+//# sourceMappingURL=rollout-trace.d.ts.map

package/node_modules/@xrkseek/server-face/dist/rollout-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rollout-trace.d.ts","sourceRoot":"","sources":["../src/rollout-trace.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,MAAM,oBAAoB,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEhE,MAAM,MAAM,oBAAoB,GAC5B,SAAS,GACT,MAAM,GACN,WAAW,GACX,SAAS,CAAC;AAEd,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,kEAAkE;IAClE,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC5C,QAAQ,CAAC,KAAK,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,yDAAyD;IACzD,QAAQ,CAAC,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC,CAAC,CAAC;IAC5E,kEAAkE;IAClE,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,gBAAgB,EAAE,CAAC;CAC9C;AAMD;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,sBAAsB,GAC5B,iBAAiB,CAqOnB"}