@lyriel/openclaw-plugin 0.4.0 → 0.4.3

package/dist/api.js

@@ -0,0 +1,181 @@
+// HTTP client for Lyriel's substrate API. Uses global fetch (Node 22+).
+//
+// Five operations:
+//   - longPollInbox(): GET /api/inbox with Bearer auth; returns parsed dispatches
+//   - sendAsk(to, prompt): POST /api/asks; returns ask_id
+//   - sendCallback(callbackUrl, callbackToken, response): POST the per-ask
+//     callback URL embedded in an inbound dispatch envelope
+//   - sendPlan / sendPlanCallback / lockPlan: group-plan endpoints
+//
+// Config (apiKey, baseUrl) is passed in rather than read from env so the
+// OpenClaw plugin manifest (openclaw.plugin.json -> configSchema) owns the
+// source of truth and the operator edits one place.
+export class LyrielApiError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.name = "LyrielApiError";
+        this.status = status;
+    }
+}
+function trimSlash(s) {
+    return s.endsWith("/") ? s.slice(0, -1) : s;
+}
+async function request(method, url, opts = {}) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), opts.timeoutMs ?? 30_000);
+    try {
+        const res = await fetch(url, {
+            method,
+            headers: {
+                "content-type": "application/json",
+                ...opts.headers,
+            },
+            body: opts.body === undefined ? undefined : JSON.stringify(opts.body),
+            signal: controller.signal,
+        });
+        const text = await res.text();
+        return { status: res.status, body: text };
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+function parseJson(body, action) {
+    try {
+        return JSON.parse(body);
+    }
+    catch (err) {
+        throw new LyrielApiError(`${action} response was not JSON: ${err.message}`);
+    }
+}
+export async function longPollInbox(cfg, timeoutMs = 30_000) {
+    const url = `${trimSlash(cfg.baseUrl)}/api/inbox`;
+    const { status, body } = await request("GET", url, {
+        headers: { authorization: `Bearer ${cfg.apiKey}` },
+        timeoutMs,
+    });
+    if (status !== 200) {
+        throw new LyrielApiError(`Inbox poll failed (${status}): ${body.slice(0, 200)}`, status);
+    }
+    const parsed = parseJson(body, "inbox");
+    return parsed.dispatches ?? [];
+}
+export async function sendAsk(cfg, to, prompt) {
+    const url = `${trimSlash(cfg.baseUrl)}/api/asks`;
+    const { status, body } = await request("POST", url, {
+        headers: { authorization: `Bearer ${cfg.apiKey}` },
+        body: { to: to.replace(/^@/, ""), prompt },
+    });
+    if (status !== 200 && status !== 202) {
+        throw new LyrielApiError(`sendAsk failed (${status}): ${body.slice(0, 300)}`, status);
+    }
+    return parseJson(body, "sendAsk");
+}
+export async function getAsk(cfg, askId) {
+    const url = `${trimSlash(cfg.baseUrl)}/api/asks/${askId}`;
+    const { status, body } = await request("GET", url, {
+        headers: { authorization: `Bearer ${cfg.apiKey}` },
+        timeoutMs: 2_000,
+    });
+    if (status !== 200) {
+        throw new LyrielApiError(`getAsk failed (${status})`, status);
+    }
+    return parseJson(body, "getAsk");
+}
+export async function sendCallback(callbackUrl, callbackToken, response) {
+    const { status, body } = await request("POST", callbackUrl, {
+        headers: { authorization: `Bearer ${callbackToken}` },
+        body: { response },
+    });
+    if (status !== 200 && status !== 410) {
+        throw new LyrielApiError(`callback failed (${status}): ${body.slice(0, 300)}`, status);
+    }
+    try {
+        return JSON.parse(body);
+    }
+    catch {
+        // Some non-2xx-but-acceptable paths may return plain text — surface raw
+        // body for diagnostics rather than throw a second error.
+        return { raw: body, status };
+    }
+}
+export async function sendPlan(cfg, participants, description, maxMessages) {
+    const url = `${trimSlash(cfg.baseUrl)}/api/plans`;
+    const body = {
+        participants: participants.map((p) => p.replace(/^@/, "")),
+        description,
+    };
+    if (maxMessages !== undefined) {
+        body.max_messages = maxMessages;
+    }
+    const { status, body: respBody } = await request("POST", url, {
+        headers: { authorization: `Bearer ${cfg.apiKey}` },
+        body,
+    });
+    if (status !== 200 && status !== 202) {
+        throw new LyrielApiError(`sendPlan failed (${status}): ${respBody.slice(0, 300)}`, status);
+    }
+    return parseJson(respBody, "sendPlan");
+}
+export async function sendPlanCallback(callbackUrl, callbackToken, content, staySilent) {
+    const body = { content };
+    if (staySilent) {
+        body.stay_silent = true;
+    }
+    const { status, body: respBody } = await request("POST", callbackUrl, {
+        headers: { authorization: `Bearer ${callbackToken}` },
+        body,
+    });
+    if (status !== 200 && status !== 409) {
+        throw new LyrielApiError(`plan callback failed (${status}): ${respBody.slice(0, 300)}`, status);
+    }
+    try {
+        return JSON.parse(respBody);
+    }
+    catch {
+        return { raw: respBody, status };
+    }
+}
+export async function updateProfile(cfg, fields) {
+    const url = `${trimSlash(cfg.baseUrl)}/api/me/profile`;
+    const { status, body: respBody } = await request("PATCH", url, {
+        headers: { authorization: `Bearer ${cfg.apiKey}` },
+        body: fields,
+    });
+    if (status !== 200) {
+        throw new LyrielApiError(`updateProfile failed (${status}): ${respBody.slice(0, 300)}`, status);
+    }
+    return parseJson(respBody, "updateProfile");
+}
+export async function cancelPlan(cfg, planId, reason) {
+    const url = `${trimSlash(cfg.baseUrl)}/api/plans/${planId}/cancel`;
+    const body = {};
+    if (reason) {
+        body.reason = reason;
+    }
+    const { status, body: respBody } = await request("POST", url, {
+        headers: { authorization: `Bearer ${cfg.apiKey}` },
+        body,
+    });
+    if (status !== 200) {
+        throw new LyrielApiError(`cancelPlan failed (${status}): ${respBody.slice(0, 300)}`, status);
+    }
+    return parseJson(respBody, "cancelPlan");
+}
+export async function lockPlan(cfg, planId, summary, details) {
+    const url = `${trimSlash(cfg.baseUrl)}/api/plans/${planId}/lock`;
+    const body = { summary };
+    if (details) {
+        body.details = details;
+    }
+    const { status, body: respBody } = await request("POST", url, {
+        headers: { authorization: `Bearer ${cfg.apiKey}` },
+        body,
+    });
+    if (status !== 200) {
+        throw new LyrielApiError(`lockPlan failed (${status}): ${respBody.slice(0, 300)}`, status);
+    }
+    return parseJson(respBody, "lockPlan");
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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

package/dist/inbox.js

@@ -0,0 +1,206 @@
+// Background long-poll: hits Lyriel /api/inbox in a recursive setTimeout
+// loop, then routes each dispatch by direction:
+//
+//   - dispatch / forward (1:1 asks) — surface to the user via Telegram
+//     push (if configured) or next-turn injection into the active
+//     OpenClaw session.
+//
+//   - plan rounds (non-terminal) — schedule a background agent turn
+//     via api.session.workflow.scheduleSessionTurn with deliveryMode:
+//     "none". The user is NOT shown the round; their agent processes
+//     it autonomously, calls lyriel_plan_reply, and the loop moves
+//     on. Load-bearing for agent-mediated plan coordination — users
+//     see the lock outcome, not the back-and-forth.
+//
+//   - plan_locked / plan_cancelled — surface (final outcome the user
+//     needs to see).
+//
+//   - friend events — surface (user needs to know).
+//
+// Lifecycle: started on the `gateway_start` plugin hook, stopped on
+// `gateway_stop`. Loop control state lives on a `state` object (rather than
+// a captured `let`) so static analysis can see that the start/stop methods
+// mutate the condition the while-loop reads.
+import * as api from "./api.js";
+import * as pending from "./pending.js";
+import { formatDispatch } from "./surfacing.js";
+import { sendTelegramMessage } from "./telegram.js";
+const RECONNECT_BACKOFF_MS = 5_000;
+const INBOX_TIMEOUT_MS = 30_000;
+const POLL_INTERVAL_AFTER_BATCH_MS = 500;
+// Prepended to every plan-round dispatch before handing to the LLM.
+// Tight wording — every token is paid for on every plan round.
+// Mirror of BACKGROUND_PROMPT_PREFIX in
+// clients/hermes-plugin/lyriel_hermes/background.py. Kept in sync by
+// convention; if either drifts, cross-runtime plan behavior drifts.
+export const BACKGROUND_PROMPT_PREFIX = "[Lyriel background plan turn — automated, no user present.\n\n" +
+    "CRITICAL: You MUST call the lyriel_plan_reply tool to respond. " +
+    "Text-only responses do nothing — the substrate ignores them, " +
+    "the round times out, and the plan stalls. The tool call IS " +
+    "the response. There is no other way to participate in this " +
+    "round.\n\n" +
+    "Your user is NOT watching this turn. Do NOT ask clarifying " +
+    "questions. Use what you already know about them (calendar, " +
+    "preferences, dietary, location, budget). If a constraint is " +
+    "missing, accept wide constraints and let other participants " +
+    "narrow.\n\n" +
+    "Call lyriel_plan_reply now. Pass stay_silent=true if you " +
+    "genuinely have nothing to add. Keep `content` concise — " +
+    "every token costs your user money.]\n\n";
+/**
+ * Detect a locked or cancelled plan envelope.
+ *
+ * Accepts either separator the server might use between "plan" and
+ * the status word — comma is current, em-dash is the older form.
+ * Strict match-the-current-server caused a real bug on the Hermes
+ * side (cf. lyriel-hermes 0.6.3) where the plugin ran a useless
+ * background turn on a locked envelope and the lock notification
+ * never surfaced. Same permissive form here.
+ */
+export function isTerminalPlanEnvelope(prompt) {
+    return (prompt.includes("[Lyriel group plan, LOCKED]") ||
+        prompt.includes("[Lyriel group plan — LOCKED]") ||
+        prompt.includes("[Lyriel group plan, CANCELLED]") ||
+        prompt.includes("[Lyriel group plan — CANCELLED]"));
+}
+export function createInboxRunner(opts) {
+    const state = { running: false, currentLoop: null };
+    async function pollOnce() {
+        return api.longPollInbox(opts.client, INBOX_TIMEOUT_MS);
+    }
+    async function loop() {
+        opts.logger.info(`lyriel inbox poll loop started (base=${opts.client.baseUrl})`);
+        while (state.running) {
+            let dispatches = [];
+            try {
+                dispatches = await pollOnce();
+            }
+            catch (err) {
+                if (!state.running) {
+                    break;
+                }
+                opts.logger.warn(`inbox poll error: ${err.message}`);
+                await sleep(RECONNECT_BACKOFF_MS, () => state.running);
+                continue;
+            }
+            for (const d of dispatches) {
+                const askId = d.ask_id;
+                const planId = d.plan_id;
+                const direction = d.direction ?? "?";
+                const promptText = d.prompt ?? "";
+                const correlation = planId ?? askId ?? "?";
+                if (direction === "dispatch" && askId) {
+                    if (!pending.rememberAsk(askId, promptText)) {
+                        opts.logger.warn(`could not extract callback URL/token for ask ${askId} — user replies will fail`);
+                    }
+                }
+                if (direction === "plan" && planId) {
+                    if (!pending.rememberPlan(planId, promptText)) {
+                        const isTerminal = isTerminalPlanEnvelope(promptText);
+                        if (!isTerminal) {
+                            opts.logger.warn(`could not extract callback for plan ${planId} — user contributions will fail`);
+                        }
+                        else {
+                            pending.forgetPlan(planId);
+                        }
+                    }
+                }
+                // Synchronous-completion suppression. If lyriel_send_ask absorbed
+                // the response inline (system_responder case — @lyriel responds
+                // instantly), skip the duplicate forward surface.
+                if (direction === "forward" && askId && pending.wasAbsorbed(askId)) {
+                    opts.logger.info(`skipped forward ask_id=${askId} (already absorbed by tool)`);
+                    continue;
+                }
+                // Plan-round dispatches: handle in a background agent turn
+                // without surfacing to the user. scheduleSessionTurn with
+                // deliveryMode="none" fires the LLM with the round prompt;
+                // the agent picks up lyriel_plan_reply via its toolset and
+                // responds autonomously. Plan_locked / plan_cancelled ARE
+                // surfaced (terminal outcomes the user needs to see).
+                if (direction === "plan" && planId) {
+                    const isTerminal = isTerminalPlanEnvelope(promptText);
+                    if (!isTerminal) {
+                        const bgSession = opts.resolveSurfaceSession();
+                        if (!bgSession) {
+                            opts.logger.warn(`no session available for background plan turn plan_id=${planId} — round will go unanswered until user engages the agent`);
+                            continue;
+                        }
+                        try {
+                            await opts.scheduleBackgroundTurn({
+                                sessionKey: bgSession,
+                                message: BACKGROUND_PROMPT_PREFIX + promptText,
+                            });
+                            opts.logger.info(`scheduled background plan turn for plan_id=${planId} on session ${bgSession}`);
+                        }
+                        catch (err) {
+                            opts.logger.error(`background plan turn failed for plan_id=${planId}: ${err.message}`);
+                        }
+                        continue;
+                    }
+                }
+                const surfaceText = formatDispatch(d);
+                // Path A — proactive Telegram push (preferred). Matches the Hermes
+                // plugin's "1 bot, 1 chat" UX: the dispatch lands in the user's
+                // chat as a real push notification, with no need to engage the
+                // agent first.
+                const tg = opts.resolveTelegramSurface();
+                if (tg.botToken && tg.chatId) {
+                    const result = await sendTelegramMessage(tg, surfaceText);
+                    if (result.ok) {
+                        opts.logger.info(`surfaced ${direction} id=${correlation} via Telegram chat ${tg.chatId}`);
+                        continue;
+                    }
+                    opts.logger.warn(`Telegram push for ${direction} id=${correlation} failed: ${result.error ?? "unknown"} — falling back to next-turn injection`);
+                }
+                // Path B — next-turn injection fallback. Used when Telegram isn't
+                // configured or push failed. User has to engage the agent for the
+                // dispatch to surface.
+                const sessionKey = opts.resolveSurfaceSession();
+                if (!sessionKey) {
+                    opts.logger.warn(`no surface available for ${direction} id=${correlation} — dispatch claimed but won't surface until user engages the agent or Telegram is configured`);
+                    continue;
+                }
+                try {
+                    await opts.inject({ sessionKey, text: surfaceText });
+                    opts.logger.info(`surfaced ${direction} id=${correlation} into session ${sessionKey}`);
+                }
+                catch (err) {
+                    opts.logger.error(`surfacing ${direction} ${correlation} failed: ${err.message}`);
+                }
+            }
+            if (dispatches.length > 0 && state.running) {
+                await sleep(POLL_INTERVAL_AFTER_BATCH_MS, () => state.running);
+            }
+        }
+        opts.logger.info("lyriel inbox poll loop exited");
+    }
+    return {
+        start() {
+            if (state.running) {
+                return;
+            }
+            state.running = true;
+            state.currentLoop = loop().catch((err) => {
+                opts.logger.error(`inbox loop crashed: ${err.message}`);
+            });
+        },
+        async stop() {
+            state.running = false;
+            if (state.currentLoop) {
+                await state.currentLoop;
+                state.currentLoop = null;
+            }
+        },
+    };
+}
+function sleep(ms, stillRunning) {
+    return new Promise((resolve) => {
+        if (!stillRunning()) {
+            resolve();
+            return;
+        }
+        setTimeout(resolve, ms);
+    });
+}
+//# sourceMappingURL=inbox.js.map

package/dist/inbox.js.map

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

package/dist/index.js

@@ -0,0 +1,132 @@
+// Lyriel plugin for OpenClaw.
+//
+// Wires Lyriel (https://lyriel.ai) into the OpenClaw runtime. Cross-provider
+// parity with clients/hermes-plugin/: a Hermes user and an OpenClaw user can
+// coordinate through Lyriel without either knowing what runtime the other is
+// on, because both runtimes integrate via Lyriel's HTTP substrate API.
+//
+// Three pieces wire up at register():
+//
+//   1. Five LLM tools (lyriel_send_ask, lyriel_reply, lyriel_plan_send,
+//      lyriel_plan_reply, lyriel_plan_lock) so the user drives Lyriel in
+//      natural language. Schemas live in tools.ts.
+//
+//   2. A background long-poll started on the `gateway_start` lifecycle
+//      hook. The loop hits Lyriel's /api/inbox, parses dispatches, stores
+//      callback tokens by ask_id / plan_id (so the reply tools have them
+//      when the user wants to respond), and pushes a human-readable
+//      surface message into the user's active session via
+//      api.session.workflow.enqueueNextTurnInjection.
+//
+//   3. A `message_received` hook that tracks the user's most recent
+//      session key so the poll loop knows which session to surface into.
+//      Operators can pin a specific session via
+//      `plugins.entries.lyriel.config.surfaceSessionKey` instead.
+//
+// Required config (plugins.entries.lyriel.config in openclaw config):
+//   apiKey            — your lyk_... key from /me/agent setup (required)
+//   baseUrl           — defaults to https://lyriel.ai; override for dev
+//   surfaceSessionKey — optional pinned session key (otherwise auto-tracked)
+import { definePluginEntry } from "openclaw/plugin-sdk/plugin-entry";
+import { createInboxRunner } from "./inbox.js";
+import { resolveTelegramSurface } from "./telegram.js";
+import { buildToolDescriptors } from "./tools.js";
+function parseConfig(raw) {
+    if (!raw || typeof raw !== "object") {
+        return {};
+    }
+    const o = raw;
+    return {
+        apiKey: typeof o.apiKey === "string" ? o.apiKey : undefined,
+        baseUrl: typeof o.baseUrl === "string" ? o.baseUrl : undefined,
+        surfaceSessionKey: typeof o.surfaceSessionKey === "string" ? o.surfaceSessionKey : undefined,
+        surfaceTelegramChatId: typeof o.surfaceTelegramChatId === "string" ? o.surfaceTelegramChatId : undefined,
+    };
+}
+export default definePluginEntry({
+    id: "lyriel",
+    name: "Lyriel",
+    description: "Lyriel plugin for OpenClaw — agent-mediated communication substrate. Long-polls /api/inbox, surfaces dispatches into the active session, and exposes five tools for asks and group plans.",
+    register(api) {
+        const config = parseConfig(api.pluginConfig);
+        const baseUrl = (config.baseUrl ?? "https://lyriel.ai").trim();
+        const apiKey = (config.apiKey ?? "").trim();
+        if (!apiKey) {
+            api.logger.warn("Lyriel plugin: apiKey missing in plugins.entries.lyriel.config — tools and inbox poll will fail until set.");
+        }
+        const client = { apiKey, baseUrl };
+        // ─── LLM tools ──────────────────────────────────────────────────────
+        for (const tool of buildToolDescriptors(client)) {
+            api.registerTool({
+                name: tool.name,
+                label: tool.label,
+                description: tool.description,
+                parameters: tool.parameters,
+                execute: tool.execute,
+            });
+        }
+        // ─── Surface-session tracking ───────────────────────────────────────
+        // The user's most recently active session, populated lazily by the
+        // message_received hook. Cleared on gateway_stop.
+        let mostRecentSessionKey = null;
+        api.on("message_received", async (_event, ctx) => {
+            const sk = ctx.sessionKey;
+            if (sk && typeof sk === "string") {
+                mostRecentSessionKey = sk;
+            }
+        });
+        function resolveSurfaceSession() {
+            if (config.surfaceSessionKey) {
+                return config.surfaceSessionKey;
+            }
+            return mostRecentSessionKey;
+        }
+        // ─── Inbox poll loop ────────────────────────────────────────────────
+        const childLogger = api.logger;
+        const inbox = createInboxRunner({
+            client,
+            resolveSurfaceSession,
+            resolveTelegramSurface() {
+                return resolveTelegramSurface(api.config, config.surfaceTelegramChatId);
+            },
+            logger: childLogger,
+            async inject({ sessionKey, text }) {
+                await api.session.workflow.enqueueNextTurnInjection({
+                    sessionKey,
+                    text,
+                    placement: "append_context",
+                    ttlMs: 5 * 60_000,
+                });
+            },
+            // Background plan turn: scheduleSessionTurn with delayMs=0 fires
+            // the LLM immediately with the supplied message as the turn
+            // input. deliveryMode: "none" suppresses any user-visible
+            // notification for the scheduled turn — the agent processes the
+            // round, calls lyriel_plan_reply via its toolset, and returns
+            // without the user seeing anything until the plan locks.
+            async scheduleBackgroundTurn({ sessionKey, message }) {
+                await api.session.workflow.scheduleSessionTurn({
+                    sessionKey,
+                    message,
+                    delayMs: 0,
+                    deliveryMode: "none",
+                    name: "lyriel.plan-round",
+                    tag: "lyriel.background",
+                });
+            },
+        });
+        api.on("gateway_start", async () => {
+            if (!apiKey) {
+                api.logger.warn("Lyriel plugin: gateway_start received but apiKey is empty — not starting inbox poll loop.");
+                return;
+            }
+            inbox.start();
+            api.logger.info("Lyriel plugin registered: 5 tools (ask, reply, plan_send, plan_reply, plan_lock) + inbox poll loop");
+        });
+        api.on("gateway_stop", async () => {
+            await inbox.stop();
+            mostRecentSessionKey = null;
+        });
+    },
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/pending.js

@@ -0,0 +1,106 @@
+// In-process state shared between the inbox poll loop and the LLM tools.
+//
+// Two maps, both lost on Gateway restart (acceptable v0 limitation — same as
+// the Hermes plugin's pending.py). For a long-lived deployment, swap these
+// for api.runtime.state.openKeyedStore so callbacks survive restart.
+//
+//   pendingAsks: ask_id -> callback URL + single-use Bearer token
+//   pendingPlans: plan_id -> current-round callback (overwritten each round)
+//   absorbedAsks: ask_id -> timestamp; tracks asks whose response was inlined
+//     into the lyriel_send_ask tool result (system_responder case) so the
+//     inbox poll suppresses the duplicate forward surface.
+const pendingAsks = new Map();
+const pendingPlans = new Map();
+const absorbedAsks = new Map();
+const ABSORBED_TTL_MS = 60_000;
+// The sealed-ask envelope (web/src/lib/server/agents/prompt.ts) embeds the
+// callback in plain text: `POST <url>` then `Bearer <token>`. Asks use
+// lct_<...> tokens; plans use plt_<...> tokens.
+const RE_CALLBACK_URL = /POST\s+(https?:\/\/\S+)/;
+const RE_CALLBACK_TOKEN = /Bearer\s+((?:lct|plt)_\S+)/;
+const RE_ASK_TEXT = /The ask:\s*"""\s*([\s\S]+?)\s*"""/;
+const RE_PLAN_DESCRIPTION = /THE PLAN:\s*"""\s*([\s\S]+?)\s*"""/;
+function stripTrailingPunct(s) {
+    return s.replace(/[,.;]+$/, "");
+}
+export function rememberAsk(askId, prompt) {
+    const urlMatch = prompt.match(RE_CALLBACK_URL);
+    const tokenMatch = prompt.match(RE_CALLBACK_TOKEN);
+    if (!urlMatch || !tokenMatch) {
+        return false;
+    }
+    const askMatch = prompt.match(RE_ASK_TEXT);
+    const excerpt = (askMatch ? askMatch[1].trim() : prompt.slice(0, 80)).trim();
+    pendingAsks.set(askId, {
+        callbackUrl: stripTrailingPunct(urlMatch[1]),
+        callbackToken: stripTrailingPunct(tokenMatch[1]),
+        receivedAt: Date.now(),
+        promptExcerpt: excerpt.slice(0, 200),
+    });
+    return true;
+}
+export function takeAsk(askId) {
+    const entry = pendingAsks.get(askId);
+    if (entry) {
+        pendingAsks.delete(askId);
+    }
+    return entry;
+}
+export function restoreAsk(askId, entry) {
+    pendingAsks.set(askId, entry);
+}
+export function listPendingAsks() {
+    return Object.fromEntries(pendingAsks);
+}
+export function markAbsorbed(askId) {
+    absorbedAsks.set(askId, Date.now());
+    pruneAbsorbed();
+}
+export function wasAbsorbed(askId) {
+    pruneAbsorbed();
+    return absorbedAsks.has(askId);
+}
+function pruneAbsorbed() {
+    const cutoff = Date.now() - ABSORBED_TTL_MS;
+    for (const [id, ts] of absorbedAsks) {
+        if (ts < cutoff) {
+            absorbedAsks.delete(id);
+        }
+    }
+}
+// Plans are multi-round: each round Lyriel sends a fresh envelope with a
+// fresh single-use callback token. Always overwrite — the previous round's
+// token is dead anyway.
+export function rememberPlan(planId, prompt) {
+    const urlMatch = prompt.match(RE_CALLBACK_URL);
+    const tokenMatch = prompt.match(RE_CALLBACK_TOKEN);
+    if (!urlMatch || !tokenMatch) {
+        return false;
+    }
+    const descMatch = prompt.match(RE_PLAN_DESCRIPTION);
+    const excerpt = (descMatch ? descMatch[1].trim() : prompt.slice(0, 80)).trim();
+    pendingPlans.set(planId, {
+        callbackUrl: stripTrailingPunct(urlMatch[1]),
+        callbackToken: stripTrailingPunct(tokenMatch[1]),
+        receivedAt: Date.now(),
+        promptExcerpt: excerpt.slice(0, 200),
+    });
+    return true;
+}
+export function takePlan(planId) {
+    const entry = pendingPlans.get(planId);
+    if (entry) {
+        pendingPlans.delete(planId);
+    }
+    return entry;
+}
+export function restorePlan(planId, entry) {
+    pendingPlans.set(planId, entry);
+}
+export function listPendingPlans() {
+    return Object.fromEntries(pendingPlans);
+}
+export function forgetPlan(planId) {
+    pendingPlans.delete(planId);
+}
+//# sourceMappingURL=pending.js.map