@lore-co/cli 0.1.28 → 0.1.29

package/dist/recovery-desktop.js

@@ -0,0 +1,179 @@
+import { spawn } from "node:child_process";
+import { constants } from "node:fs";
+import { createHash } from "node:crypto";
+import { mkdir, open, realpath, unlink } from "node:fs/promises";
+import { resolve } from "node:path";
+import { createInterface } from "node:readline/promises";
+import { z } from "zod";
+import { AGENTS, findAgentExecutable } from "./agents.js";
+import { captureRecoveryHook, createRecoveryRun, recoveryRunKey, RecoveryRunSchema, recoveryStore, recordRecoveryMetric } from "./recovery-state.js";
+import { cliInvocation, launchRecoveredRun, recoveryRoute } from "./recovery.js";
+import { shellQuote } from "./recovery-transfer.js";
+import { observeCodexRecovery } from "./recovery-codex.js";
+import { observePolytokenRecovery } from "./recovery-polytoken.js";
+import { observeCopilotRecovery } from "./recovery-copilot.js";
+function detached(home, args) {
+    const invocation = cliInvocation();
+    const child = spawn(invocation[0], [...invocation.slice(1), "recovery", ...args], { detached: true, stdio: "ignore", env: { ...process.env, LORE_HOME: home, BUN_OPTIONS: undefined, BUN_BE_BUN: undefined } });
+    child.once("error", () => { });
+    child.unref();
+}
+/** An IDE hook has no parent PTY. Start a terminal that owns the confirmation. */
+export async function openRecoveryTerminal(home, id) {
+    z.uuid().parse(id);
+    if (process.platform !== "darwin" && !process.env.DISPLAY && !process.env.WAYLAND_DISPLAY)
+        throw new Error("Desktop recovery needs a graphical session; use the connected shell wrapper on a headless worker");
+    const folder = resolve(home, ".lore/recovery/offers");
+    await mkdir(folder, { recursive: true, mode: 0o700 });
+    const path = resolve(folder, `${id}.command`);
+    const file = await open(path, constants.O_WRONLY | constants.O_CREAT | constants.O_TRUNC | constants.O_NOFOLLOW, 0o700);
+    try {
+        await file.writeFile(`#!/bin/sh\nexec env -u BUN_OPTIONS -u BUN_BE_BUN PATH=${shellQuote(process.env.PATH || "/usr/bin:/bin")} LORE_HOME=${shellQuote(home)} ${[...cliInvocation(), "recovery", "offer", id].map(shellQuote).join(" ")}\n`);
+    }
+    finally {
+        await file.close();
+    }
+    const command = process.platform === "darwin" ? "open" : "x-terminal-emulator";
+    const args = process.platform === "darwin" ? ["-a", "Terminal", path] : ["-e", "/bin/sh", path];
+    await new Promise((done, reject) => {
+        const child = spawn(command, args, { detached: true, stdio: "ignore" });
+        child.once("error", reject);
+        if (process.platform === "darwin")
+            child.once("exit", code => code === 0 ? done() : reject(new Error("Could not open the recovery terminal")));
+        else {
+            const timer = setTimeout(() => { child.unref(); done(); }, 500);
+            child.once("exit", code => { clearTimeout(timer); if (code === 0)
+                done();
+            else
+                reject(new Error("Could not open the recovery terminal")); });
+            child.once("error", () => clearTimeout(timer));
+        }
+    });
+}
+export async function offerDesktopRecovery(home, id, notify = openRecoveryTerminal) {
+    const store = recoveryStore(home);
+    const run = RecoveryRunSchema.parse(await store.readState(recoveryRunKey(id)));
+    if (await store.readState("disabled"))
+        throw new Error("Recovery is disabled");
+    if (!run.failure)
+        return;
+    let claim = false;
+    await store.updateState(`desktop-offer-${id}`, current => {
+        if (current && typeof current === "object" && "attempt" in current && current.attempt === run.failure.id)
+            return current;
+        claim = true;
+        return { attempt: run.failure.id };
+    });
+    if (!claim)
+        return;
+    try {
+        await notify(home, id);
+    }
+    catch (error) {
+        await store.deleteState(`desktop-offer-${id}`);
+        throw error;
+    }
+}
+export async function captureDesktopRecovery(home, agent, value) {
+    const input = z.object({ session_id: z.string().min(1).max(500), cwd: z.string(), hook_event_name: z.string() }).passthrough().safeParse(value);
+    if (!input.success)
+        return;
+    const route = await recoveryRoute(home, agent);
+    if (!route || route.agent === agent)
+        return;
+    const cwd = await realpath(input.data.cwd);
+    const key = `desktop-session-${createHash("sha256").update(JSON.stringify([agent, cwd, input.data.session_id])).digest("hex")}`;
+    const store = recoveryStore(home);
+    let saved = z.object({ id: z.uuid(), at: z.number() }).safeParse(await store.readState(key));
+    if (!saved.success || Date.now() - saved.data.at > 24 * 60 * 60 * 1000) {
+        if (input.data.hook_event_name !== "UserPromptSubmit")
+            return;
+        const run = await createRecoveryRun(home, cwd, agent, route.agent, route.remote);
+        const mapping = { id: run.id, at: Date.now() };
+        await store.writeState(key, mapping);
+        saved = { success: true, data: mapping };
+    }
+    const id = saved.data.id;
+    await captureRecoveryHook(home, id, input.data, agent);
+    const run = RecoveryRunSchema.parse(await store.readState(recoveryRunKey(id)));
+    if (agent === "codex" && input.data.hook_event_name === "UserPromptSubmit")
+        detached(home, ["watch", id, String(run.turn)]);
+    if (agent === "polytoken" && input.data.hook_event_name === "UserPromptSubmit")
+        detached(home, ["watch-polytoken", id, String(run.turn)]);
+    if (agent === "copilot-cli" && input.data.hook_event_name === "UserPromptSubmit")
+        detached(home, ["watch-copilot", id, String(run.turn)]);
+    if (run.failure)
+        await offerDesktopRecovery(home, id);
+    return id;
+}
+export async function runDesktopRecovery(args, home) {
+    const id = z.uuid().parse(args[1]);
+    const store = recoveryStore(home);
+    if (args[0] === "watch" || args[0] === "watch-polytoken" || args[0] === "watch-copilot") {
+        const turn = z.coerce.number().int().nonnegative().parse(args[2]);
+        const stop = args[0] === "watch-polytoken" ? observePolytokenRecovery(home, id) : args[0] === "watch-copilot" ? observeCopilotRecovery(home, id) : observeCodexRecovery(home, id, await findAgentExecutable("codex"));
+        try {
+            const deadline = Date.now() + 24 * 60 * 60 * 1000;
+            while (Date.now() < deadline) {
+                const run = RecoveryRunSchema.parse(await store.readState(recoveryRunKey(id)));
+                if (run.turn !== turn || !run.turnPending)
+                    break;
+                if (run.failure) {
+                    await offerDesktopRecovery(home, id);
+                    break;
+                }
+                await new Promise(done => setTimeout(done, 1000));
+            }
+        }
+        finally {
+            stop();
+        }
+        return;
+    }
+    const run = RecoveryRunSchema.parse(await store.readState(recoveryRunKey(id)));
+    if (!run.failure || Date.now() - Date.parse(run.updatedAt) > 24 * 60 * 60 * 1000)
+        throw new Error("This recovery offer expired");
+    if (await store.readState("disabled"))
+        throw new Error("Recovery is disabled");
+    if (!process.stdin.isTTY || !process.stdout.isTTY)
+        throw new Error("Recovery confirmation requires an interactive terminal");
+    await store.writeState(`attempt-${id}`, run);
+    await recordRecoveryMetric(home, id, run.failure.id, "offered");
+    const fromEditor = args[0] === "launch-accepted";
+    if (fromEditor && (run.sourceHost !== "copilot-vscode" || args[2] !== run.failure.id))
+        throw new Error("The editor offer is no longer current");
+    const prompt = fromEditor ? undefined : createInterface({ input: process.stdin, output: process.stdout });
+    let answer;
+    try {
+        answer = prompt ? await prompt.question(`${run.sourceHost ?? AGENTS[run.sourceAgent].label} stopped${run.failure.reason === "rate_limit" ? " at a usage limit" : " with an error"}.\nContinue with ${AGENTS[run.targetAgent].label}${run.targetRemote ? ` on ${run.targetRemote.host}` : " locally"}? [Y/n] `) : "yes";
+    }
+    finally {
+        prompt?.close();
+        await unlink(resolve(home, ".lore/recovery/offers", `${id}.command`)).catch(() => { });
+    }
+    if (!["", "y", "yes"].includes(answer.trim().toLowerCase())) {
+        await recordRecoveryMetric(home, id, run.failure.id, "declined");
+        return;
+    }
+    const current = RecoveryRunSchema.parse(await store.readState(recoveryRunKey(id)));
+    if (await store.readState("disabled"))
+        throw new Error("Recovery was disabled while the offer was open");
+    if (current.failure?.id !== run.failure.id)
+        throw new Error("The source has moved on; this offer is no longer current");
+    if (current.sourceHost && Date.now() - Date.parse(current.updatedAt) > 10000)
+        throw new Error("The host observer is unavailable. Reconnect the host before accepting this handoff.");
+    if (current.sourceHost)
+        await (await import("./recovery-hosts.js")).validateExternalRecovery(home, current);
+    let accepted = false;
+    await store.updateState(`desktop-accepted-${id}`, prior => {
+        if (prior && typeof prior === "object" && "attempt" in prior && prior.attempt === run.failure.id)
+            return prior;
+        accepted = true;
+        return { attempt: run.failure.id };
+    });
+    if (!accepted)
+        throw new Error("This handoff was already accepted");
+    await recordRecoveryMetric(home, id, run.failure.id, "accepted");
+    await launchRecoveredRun(home, current);
+}
+//# sourceMappingURL=recovery-desktop.js.map

package/dist/recovery-desktop.js.map

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

package/dist/recovery-external.d.ts

@@ -0,0 +1,61 @@
+import { z } from "zod";
+export declare const ExternalCheckpoint: z.ZodObject<{
+    host: z.ZodEnum<{
+        t3code: "t3code";
+        cowork: "cowork";
+        "copilot-vscode": "copilot-vscode";
+    }>;
+    sourceAgent: z.ZodEnum<{
+        claude: "claude";
+        codex: "codex";
+        opencode: "opencode";
+        devin: "devin";
+        cursor: "cursor";
+        "copilot-cli": "copilot-cli";
+        polytoken: "polytoken";
+    }>;
+    sessionId: z.ZodString;
+    turnId: z.ZodString;
+    cwd: z.ZodString;
+    goal: z.ZodString;
+    messages: z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<{
+            user: "user";
+            assistant: "assistant";
+        }>;
+        text: z.ZodString;
+    }, z.core.$strip>>;
+    state: z.ZodEnum<{
+        failed: "failed";
+        running: "running";
+        completed: "completed";
+        cancelled: "cancelled";
+    }>;
+    reason: z.ZodOptional<z.ZodEnum<{
+        rate_limit: "rate_limit";
+        agent_error: "agent_error";
+    }>>;
+    observedAt: z.ZodNumber;
+}, z.core.$strip>;
+export type ExternalCheckpoint = z.infer<typeof ExternalCheckpoint>;
+export declare const ExternalSettings: z.ZodObject<{
+    fallback: z.ZodEnum<{
+        claude: "claude";
+        codex: "codex";
+        opencode: "opencode";
+        devin: "devin";
+        cursor: "cursor";
+        "copilot-cli": "copilot-cli";
+        polytoken: "polytoken";
+    }>;
+    t3Database: z.ZodOptional<z.ZodString>;
+    coworkRoots: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    vscodeRoots: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    vscodeExtension: z.ZodOptional<z.ZodString>;
+    vscodeHookFiles: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    since: z.ZodNumber;
+}, z.core.$strip>;
+export declare function externalSessionKey(input: Pick<ExternalCheckpoint, "host" | "sessionId" | "cwd">): string;
+/** Accept only host adapters' structured state. Text never determines failure. */
+export declare function captureExternalRecovery(home: string, value: unknown, notify?: (home: string, id: string) => Promise<void>): Promise<string | undefined>;
+//# sourceMappingURL=recovery-external.d.ts.map

package/dist/recovery-external.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-external.d.ts","sourceRoot":"","sources":["../src/recovery-external.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAS7B,CAAC;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AACpE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;iBAQ3B,CAAC;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,WAAW,GAAG,KAAK,CAAC,GAAG,MAAM,CAExG;AAGD,kFAAkF;AAClF,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAkD7J"}

package/dist/recovery-external.js

@@ -0,0 +1,98 @@
+import { createHash } from "node:crypto";
+import { realpath } from "node:fs/promises";
+import { z } from "zod";
+import { LAUNCHABLE_AGENTS, RECOVERY_SOURCES, findAgentExecutable } from "./agents.js";
+import { createRecoveryRun, markRecoveryFailure, RecoveryRunSchema, recoveryRunKey, recoveryStore, recoveryMessageText } from "./recovery-state.js";
+import { recoveryRoute } from "./recovery.js";
+import { offerDesktopRecovery } from "./recovery-desktop.js";
+export const ExternalCheckpoint = z.object({
+    host: z.enum(["t3code", "copilot-vscode", "cowork"]),
+    sourceAgent: z.enum(RECOVERY_SOURCES),
+    sessionId: z.string().min(1).max(500), turnId: z.string().min(1).max(500),
+    cwd: z.string().min(1), goal: z.string().min(1).max(24000),
+    messages: z.array(z.object({ role: z.enum(["user", "assistant"]), text: z.string().max(24000) })).max(20),
+    state: z.enum(["running", "completed", "failed", "cancelled"]),
+    reason: z.enum(["rate_limit", "agent_error"]).optional(),
+    observedAt: z.number(),
+});
+export const ExternalSettings = z.object({
+    fallback: z.enum(LAUNCHABLE_AGENTS),
+    t3Database: z.string().optional(),
+    coworkRoots: z.array(z.string()).default([]),
+    vscodeRoots: z.array(z.string()).default([]),
+    vscodeExtension: z.string().optional(),
+    vscodeHookFiles: z.array(z.string()).default([]),
+    since: z.number(),
+});
+export function externalSessionKey(input) {
+    return `external-${createHash("sha256").update(JSON.stringify([input.host, input.sessionId, input.cwd])).digest("hex")}`;
+}
+const safeText = recoveryMessageText;
+/** Accept only host adapters' structured state. Text never determines failure. */
+export async function captureExternalRecovery(home, value, notify) {
+    const parsed = ExternalCheckpoint.safeParse(value);
+    if (!parsed.success || Date.now() - parsed.data.observedAt > 30000 || parsed.data.observedAt > Date.now() + 5000)
+        return;
+    const store = recoveryStore(home);
+    if (await store.readState("disabled"))
+        return;
+    const settings = ExternalSettings.safeParse(await store.readState("external-settings"));
+    if (!settings.success)
+        return;
+    const input = parsed.data;
+    input.cwd = await realpath(input.cwd);
+    if (input.host === "cowork" && !settings.data.coworkRoots.includes(input.cwd))
+        return;
+    if (input.host === "copilot-vscode" && !settings.data.vscodeRoots.includes(input.cwd))
+        return;
+    const key = externalSessionKey(input);
+    const mapping = z.object({ id: z.uuid() }).safeParse(await store.readState(key));
+    let run = mapping.success ? RecoveryRunSchema.safeParse(await store.readState(recoveryRunKey(mapping.data.id))) : undefined;
+    if (run?.success && run.data.sourceAgent !== input.sourceAgent) {
+        await store.updateState(recoveryRunKey(run.data.id), current => ({ ...RecoveryRunSchema.parse(current), failure: null, turnPending: false }));
+        run = undefined;
+    }
+    if (!run?.success || Date.now() - Date.parse(run.data.startedAt) > 24 * 60 * 60 * 1000) {
+        // A resumed observer must not produce a handoff for an old completed chat.
+        if (input.state === "completed" || input.state === "cancelled")
+            return;
+        const route = await recoveryRoute(home, input.sourceAgent);
+        const fallback = route?.agent ?? settings.data.fallback;
+        if (fallback === input.sourceAgent)
+            return;
+        if (!route?.remote)
+            await findAgentExecutable(fallback);
+        const created = await createRecoveryRun(home, input.cwd, input.sourceAgent, fallback, route?.remote);
+        await store.writeState(key, { id: created.id });
+        run = { success: true, data: created };
+    }
+    const id = run.data.id;
+    await store.updateState(recoveryRunKey(id), current => {
+        const latest = RecoveryRunSchema.parse(current);
+        if (latest.sourceAgent !== input.sourceAgent)
+            return latest;
+        if (latest.supersededTurnId === input.turnId)
+            return latest;
+        if (latest.nativeTurnId !== input.turnId) {
+            latest.turn += 1;
+            latest.failure = null;
+            delete latest.supersededTurnId;
+        }
+        latest.sessionId = input.sessionId;
+        latest.nativeTurnId = input.turnId;
+        latest.goal = safeText(input.goal);
+        latest.messages = input.messages.map(m => ({ ...m, text: safeText(m.text) }));
+        latest.turnPending = input.state === "running" || input.state === "failed";
+        if (input.state !== "failed")
+            latest.failure = null;
+        latest.updatedAt = new Date().toISOString();
+        latest.sourceHost = input.host;
+        return latest;
+    });
+    if (input.state === "failed") {
+        await markRecoveryFailure(home, RecoveryRunSchema.parse(await store.readState(recoveryRunKey(id))), input.reason ?? "agent_error");
+        await offerDesktopRecovery(home, id, notify);
+    }
+    return id;
+}
+//# sourceMappingURL=recovery-external.js.map

package/dist/recovery-external.js.map

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

package/dist/recovery-hooks.d.ts

@@ -0,0 +1,5 @@
+import type { RecoverySource } from "./agents.js";
+/** Native event fields, never text scraped from the agent's answer or terminal. */
+export declare function normalizeRecoveryHook(agent: RecoverySource, value: unknown, env?: NodeJS.ProcessEnv): unknown;
+export declare function mergeNativeRecoveryHooks(agent: "cursor" | "copilot-cli" | "polytoken", value: unknown, command: string | null): unknown;
+//# sourceMappingURL=recovery-hooks.d.ts.map

package/dist/recovery-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-hooks.d.ts","sourceRoot":"","sources":["../src/recovery-hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAKlD,mFAAmF;AACnF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,oBAAc,GAAG,OAAO,CAmDvG;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,QAAQ,GAAG,aAAa,GAAG,WAAW,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CA2BvI"}

package/dist/recovery-hooks.js

@@ -0,0 +1,115 @@
+const OWNER = "--owner lore-recovery";
+const isCore = (command) => typeof command === "string" && /--owner\s+lore(?:\s|$)/u.test(command);
+/** Native event fields, never text scraped from the agent's answer or terminal. */
+export function normalizeRecoveryHook(agent, value, env = process.env) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return null;
+    const input = { ...value };
+    if (input.agent_id || input.isSidechain || input.parent_session_id)
+        return null;
+    if (agent === "cursor") {
+        input.session_id = input.conversation_id;
+        input.cwd ??= Array.isArray(input.workspace_roots) && input.workspace_roots.length === 1 ? input.workspace_roots[0] : undefined;
+        input.turn_id = input.generation_id;
+        if (input.hook_event_name === "beforeSubmitPrompt")
+            input.hook_event_name = "UserPromptSubmit";
+        else if (input.hook_event_name === "afterAgentResponse") {
+            input.hook_event_name = "Checkpoint";
+            input.last_assistant_message = input.text;
+        }
+        else if (input.hook_event_name === "stop") {
+            input.hook_event_name = input.status === "error" ? "StopFailure" : "Stop";
+            if (input.status === "error")
+                input.error = "agent_error";
+        }
+    }
+    else if (agent === "copilot-cli") {
+        input.session_id = input.sessionId;
+        input.hook_event_name ??= env.LORE_RECOVERY_EVENT;
+        if (input.hook_event_name === "userPromptSubmitted") {
+            input.hook_event_name = "UserPromptSubmit";
+            // The events journal records this same native hook timestamp before user.message.
+            if (Number.isSafeInteger(input.timestamp))
+                input.turn_id = `hook:${input.timestamp}`;
+        }
+        else if (input.hook_event_name === "agentStop") {
+            input.hook_event_name = "Stop";
+            input.last_assistant_message = input.response;
+        }
+        else if (input.hook_event_name === "errorOccurred") {
+            if (input.recoverable !== false || !["model_call", "system"].includes(input.errorContext))
+                return null;
+            input.hook_event_name = "StopFailure";
+            input.error = "agent_error";
+        }
+    }
+    else if (agent === "polytoken") {
+        input.hook_event_name ??= input.event ?? env.POLYTOKEN_HOOK_EVENT;
+        input.session_id ??= env.POLYTOKEN_SESSION_ID;
+        input.cwd ??= env.POLYTOKEN_PROJECT_DIR ?? env.POLYTOKEN_PROJECT_PATH;
+        input.turn_id ??= input.prompt_id;
+        if (input.hook_event_name === "pre_user_prompt") {
+            input.hook_event_name = "UserPromptSubmit";
+            input.prompt ??= input.user_prompt ?? input.message?.content;
+        }
+        else if (input.hook_event_name === "post_model_turn") {
+            input.hook_event_name = "Checkpoint";
+            input.last_assistant_message ??= input.assistant_message ?? input.response ?? input.text ?? input.message?.content;
+        }
+        else if (input.hook_event_name === "pre_model_turn")
+            input.hook_event_name = "Checkpoint";
+        else if (input.hook_event_name === "stop")
+            input.hook_event_name = "Stop";
+        else
+            return null;
+    }
+    else if (agent === "devin") {
+        input.cwd ??= env.DEVIN_PROJECT_DIR ?? process.cwd();
+        if (["PostToolUse", "PostCompaction"].includes(input.hook_event_name)) {
+            input.hook_event_name = "Checkpoint";
+            input.last_assistant_message = input.summary ?? `Tool ${String(input.tool_name ?? "result")}: ${JSON.stringify(input.tool_response ?? {})}`;
+        }
+    }
+    return input;
+}
+export function mergeNativeRecoveryHooks(agent, value, command) {
+    if (agent === "polytoken") {
+        if (!Array.isArray(value))
+            throw new Error("Invalid Polytoken hooks: expected an array.");
+        const hooks = value.filter(hook => typeof hook?.handler?.bash !== "string" || !hook.handler.bash.includes(OWNER));
+        if (command)
+            for (const event of ["pre_user_prompt", "pre_model_turn", "post_model_turn", "stop"]) {
+                const core = hooks.findIndex(hook => isCore(hook?.handler?.bash));
+                hooks.splice(core < 0 ? hooks.length : core, 0, { name: `Lore recovery ${event}`, event, handler: { bash: command } });
+            }
+        return hooks;
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw new Error(`Invalid ${agent} hooks.`);
+    const result = structuredClone(value);
+    if (result.hooks !== undefined && (!result.hooks || typeof result.hooks !== "object" || Array.isArray(result.hooks)))
+        throw new Error(`Invalid ${agent} hooks.`);
+    const hooks = result.hooks ?? {};
+    const events = agent === "cursor" ? ["beforeSubmitPrompt", "afterAgentResponse", "stop"] : ["userPromptSubmitted", "agentStop", "errorOccurred"];
+    for (const event of events) {
+        if (hooks[event] !== undefined && !Array.isArray(hooks[event]))
+            throw new Error(`Invalid ${agent} ${event} hooks.`);
+        const remaining = (hooks[event] ?? []).filter((hook) => !String(agent === "cursor" ? hook.command ?? "" : hook.bash ?? "").includes(OWNER));
+        if (command) {
+            const core = remaining.findIndex((hook) => isCore(agent === "cursor" ? hook.command : hook.bash));
+            remaining.splice(core < 0 ? remaining.length : core, 0, agent === "cursor" ? { command, timeout: 10 } : { type: "command", bash: `LORE_RECOVERY_EVENT=${event} ${command}`, timeoutSec: 10 });
+        }
+        if (remaining.length)
+            hooks[event] = remaining;
+        else
+            delete hooks[event];
+    }
+    if (Object.keys(hooks).length) {
+        result.hooks = hooks;
+        result.version ??= 1;
+    }
+    else
+        delete result.hooks;
+    return result;
+}
+//# sourceMappingURL=recovery-hooks.js.map

package/dist/recovery-hooks.js.map

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

package/dist/recovery-hosts.d.ts

@@ -0,0 +1,13 @@
+import type { LorePaths } from "./cli.js";
+import { type RecoveryRun } from "./recovery-state.js";
+export declare function readOwnedJson(path: string, max?: number): Promise<any>;
+export declare function installExternalRecovery(paths: LorePaths, hosts: readonly string[], cwd: string, fallback?: string, start?: boolean): Promise<string[]>;
+export declare function installRecoveryMonitor(home: string, start?: boolean): Promise<void>;
+export declare function disableExternalRecovery(home: string): Promise<void>;
+export declare function pollExternalRecovery(home: string, notify?: (home: string, id: string) => Promise<void>): Promise<void>;
+export declare function runExternalMonitor(home: string): Promise<void>;
+export declare function externalCheckpointCommand(home: string): Promise<void>;
+/** Stop offering the old saved result immediately when the editor starts a new prompt. */
+export declare function invalidateEditorRecovery(home: string, value: unknown): Promise<void>;
+export declare function validateExternalRecovery(home: string, run: RecoveryRun): Promise<void>;
+//# sourceMappingURL=recovery-hosts.d.ts.map

package/dist/recovery-hosts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recovery-hosts.d.ts","sourceRoot":"","sources":["../src/recovery-hosts.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG1C,OAAO,EAA0E,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAa/H,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,SAAc,GAAG,OAAO,CAAC,GAAG,CAAC,CAOjF;AAMD,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,UAAO,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA0CzJ;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,UAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAYtF;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBzE;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CA6B5H;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBpE;AAED,wBAAsB,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAU3E;AAED,0FAA0F;AAC1F,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAY1F;AAED,wBAAsB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAW5F"}