@lyriel/openclaw-plugin 0.1.0

package/README.md

@@ -0,0 +1,242 @@
+# Lyriel plugin for OpenClaw
+
+Native OpenClaw integration for the Lyriel substrate. Cross-provider parity
+with the Hermes plugin — a Hermes user and an OpenClaw user coordinate
+through Lyriel without either one knowing what runtime the other is on,
+because both runtimes integrate against the same HTTP substrate API.
+
+## What you get
+
+- 🪶 **Inbound surfacing.** Lyriel asks and group-plan updates arrive in your
+  active OpenClaw session as the next turn's context. A daemon long-polls
+  `/api/inbox` and injects each dispatch via
+  `api.session.workflow.enqueueNextTurnInjection`, so the next thing your
+  agent says to you references the incoming Lyriel ask.
+- **Five LLM tools** so you drive Lyriel in natural language:
+  - `lyriel_send_ask` — "ping @noor about dinner thursday"
+  - `lyriel_reply` — "reply yes thursday works"
+  - `lyriel_plan_send` — "start a plan with @noor and @maya about dinner"
+  - `lyriel_plan_reply` — "tell the plan I can do friday too"
+  - `lyriel_plan_lock` — "lock the plan at thursday 7pm Mission Cantina"
+- **Full agent context** when drafting Lyriel replies — your OpenClaw
+  memory, calendar tools, preferences, etc. are all available to the LLM.
+- **Channel-agnostic.** Works no matter which messaging channel your
+  OpenClaw is connected to (Telegram, Signal, Discord, iMessage, etc.). The
+  surfacing path uses the host-owned next-turn injection surface rather
+  than a specific channel adapter, so there's nothing to wire per platform.
+
+## Install
+
+### Local development (against a globally-installed OpenClaw)
+
+OpenClaw's `--link` install path expects compiled JavaScript output, not raw
+TypeScript (source-checkout fallback only applies inside the openclaw monorepo
+itself). One-time setup from this directory:
+
+```bash
+# 1. Symlink the global openclaw runtime so tsc can resolve plugin-sdk types.
+mkdir -p node_modules
+ln -sfn /opt/homebrew/lib/node_modules/openclaw node_modules/openclaw
+
+# 2. Install local build deps.
+npm install --no-save typebox typescript
+
+# 3. Re-create the openclaw symlink (npm install clobbers it).
+ln -sfn /opt/homebrew/lib/node_modules/openclaw node_modules/openclaw
+
+# 4. Build to dist/.
+npx tsc -p tsconfig.build.json
+
+# 5. Link the plugin into OpenClaw.
+openclaw plugins install --link "$(pwd)"
+
+# 6. Restart so the runtime picks up the new plugin.
+openclaw gateway restart
+```
+
+Re-run `npx tsc -p tsconfig.build.json` after any edit to the `*.ts` files;
+the gateway re-reads `dist/` on the next plugin reload.
+
+### Bundled (in-tree development against the openclaw monorepo)
+
+```bash
+cd /path/to/openclaw
+ln -s /path/to/lyriel-repo/clients/openclaw-plugin extensions/lyriel
+pnpm install
+pnpm test -- extensions/lyriel/
+```
+
+The bundled path discovers TS source directly; no precompile needed.
+
+### Published (from npm)
+
+```bash
+npm install -g @lyriel/openclaw-plugin
+openclaw plugins install @lyriel/openclaw-plugin
+```
+
+The `prepare` script in package.json builds `dist/` on install, so the
+plugin is ready as soon as npm finishes. `openclaw plugins install`
+then registers it with the OpenClaw runtime. ClawHub publish
+(`openclaw plugins install clawhub:lyriel/openclaw-plugin`) is a v0.2
+follow-up that wraps the same npm package.
+
+## Configure
+
+OpenClaw config lives at `~/.openclaw/openclaw.json`. Add a `plugins.entries.lyriel`
+block alongside whatever other plugin entries you already have:
+
+```json
+{
+  "plugins": {
+    "entries": {
+      "lyriel": {
+        "enabled": true,
+        "config": {
+          "apiKey": "lyk_xxxxxxxxxxxxxxxx",
+          "baseUrl": "https://lyriel.ai"
+        }
+      }
+    }
+  }
+}
+```
+
+- `apiKey` — your `lyk_...` from https://lyriel.ai/me/agent (required)
+- `baseUrl` — defaults to `https://lyriel.ai`; override for dev
+  (`http://localhost:5173`) or a cloudflared tunnel
+- `surfaceSessionKey` — optional. Pin a specific session for inbound surfacing;
+  otherwise the plugin auto-tracks the most recently active session.
+
+Prefer editing the file via `openclaw config` so the gateway picks up changes
+without manual JSON re-parsing.
+
+If `surfaceSessionKey` is unset, the plugin tracks the most recent session
+that received any user message and injects Lyriel surfaces there. The first
+inbound dispatch may not surface until you've engaged at least once after
+gateway start.
+
+## How it works
+
+```
+                ┌───────────────────────────────────────────────────────┐
+                │           OpenClaw Gateway (always-on)                │
+                │                                                       │
+   register()   │  ┌──────────────────┐    ┌─────────────────────────┐  │
+   ─────────▶   │  │ Inbox poll loop  │    │ LLM tool handlers       │  │
+                │  │ (gateway_start)  │    │ lyriel_send_ask         │  │
+                │  └─────────┬────────┘    │ lyriel_reply            │  │
+                │            │             │ lyriel_plan_send        │  │
+                │            ▼             │ lyriel_plan_reply       │  │
+                │  pending.ts (ask_id /    │ lyriel_plan_lock        │  │
+                │   plan_id → callback)    └────────────┬────────────┘  │
+                │            │                          │               │
+                │            ▼                          │               │
+                │  api.session.workflow.                │               │
+                │    enqueueNextTurnInjection({         │               │
+                │      sessionKey,                      │               │
+                │      text: formatted surface,         │               │
+                │    })                                 │               │
+                │            │                          │               │
+                └────────────┼──────────────────────────┼───────────────┘
+                             │                          │
+                             ▼                          ▼
+                ┌───────────────────────────────────────────────────────┐
+                │                User's OpenClaw session                │
+                │                                                       │
+                │  Next agent turn picks up:                            │
+                │  🪶 Lyriel ask from @noor: "dinner thursday?"         │
+                │                                                       │
+                │  User says: "yes thursday works"                      │
+                │                                                       │
+                │  LLM calls lyriel_reply → plugin POSTs callback       │
+                └───────────────────────────────────────────────────────┘
+```
+
+## Comparison with the Hermes plugin
+
+| | Hermes plugin | This plugin |
+|---|---|---|
+| Language | Python | TypeScript |
+| Surface path | Hermes `inject_message` (CLI) + gateway Telegram adapter | OpenClaw `enqueueNextTurnInjection` (channel-agnostic) |
+| Background task | `threading.Thread(daemon=True)` | `gateway_start` lifecycle hook + `setTimeout` loop |
+| Tool registration | `ctx.register_tool` | `api.registerTool` |
+| Pending callback state | in-process `dict` | in-process `Map` |
+| Proactive notification | yes — Telegram push | no — appears on next agent turn |
+
+The "no proactive push" gap is deliberate. OpenClaw users connect via many
+possible channels; surfacing through next-turn injection is one path that
+works for all of them. A truly push-notification path can be added later
+once we know which channel design partners actually live in.
+
+## Cross-provider interop
+
+The whole point of having a plugin per provider: a user can be on Hermes
+and address a friend who's on OpenClaw (or vice versa) and neither side
+needs to know about the other's runtime. The provider adapter on Lyriel's
+server (`web/src/lib/server/agents/{hermes,openclaw}.ts`) dispatches into
+each user's provider via that provider's inbound API. This plugin is the
+client-side half of the OpenClaw integration.
+
+End-to-end: Hermes user → Hermes Lyriel plugin → Lyriel API → Lyriel
+OpenClaw adapter → OpenClaw `/v1/chat/completions` → user's OpenClaw
+agent → OpenClaw Lyriel plugin (this) → callback → Lyriel → Hermes Lyriel
+plugin surfaces the reply.
+
+## Troubleshooting
+
+**"apiKey missing" warning in logs.** Set `plugins.entries.lyriel.config.apiKey`
+to your `lyk_...` token from `https://lyriel.ai/me/agent` (or your
+`LYRIEL_BASE_URL` equivalent). Restart the gateway after editing config.
+
+**Tools register but inbox dispatches never appear.** Most likely cause:
+the user hasn't sent any message after gateway start, so the plugin doesn't
+know which session to surface into. Send anything to your agent; the next
+poll cycle will surface accumulated dispatches.
+
+**"could not extract callback URL/token" warnings.** The inbound dispatch
+envelope didn't match the expected pattern. Likely a Lyriel server version
+mismatch — re-pair your agent at `/me/agent` for a fresh setup.
+
+**Surfaces arrive but in the wrong session.** Set
+`plugins.entries.lyriel.config.surfaceSessionKey` to pin a specific session.
+The auto-tracking heuristic ("most recent message_received") may pick up
+short-lived sub-sessions; pinning is more predictable.
+
+**Hot reload.** OpenClaw plugin reloads keep durable session extension
+state and re-run cleanup callbacks. The inbox loop stops cleanly on
+`gateway_stop` and restarts on the next `gateway_start`.
+
+## v0 limitations
+
+- **In-process pending map.** If the gateway restarts mid-flight, pending
+  callback tokens are lost. The user will see "no pending Lyriel asks" if
+  they try to reply to an ask that arrived before the restart. Move to
+  `api.runtime.state.openKeyedStore` to survive restarts.
+- **One-pending-per-ask.** If multiple asks pile up, the LLM disambiguates
+  via ask_id (shown in each surface message).
+- **No truly proactive push.** Dispatches surface on the next agent turn
+  in the configured session. Adding per-channel push is a v0.2 task.
+- **Single user per OpenClaw gateway.** One `apiKey` per plugin instance.
+  Multi-user gateways aren't supported yet.
+
+## Publishing
+
+The package is `@lyriel/openclaw-plugin` on npm. Prerequisites: an npm
+account with publish rights on the `@lyriel` scope (claim it once with
+`npm org create lyriel`), authenticated via `npm login`.
+
+```bash
+# 1. Bump the version in package.json (and openclaw.plugin.json if the
+#    OpenClaw-facing version should track).
+# 2. Publish. prepublishOnly runs the TypeScript build into dist/ first;
+#    the files whitelist in package.json scopes the tarball to dist/ +
+#    openclaw.plugin.json.
+npm publish
+```
+
+`publishConfig.access: public` in package.json lets the scoped
+package go up without `--access public` on the command line. After
+publish, the install paste-prompt (`npm install -g
+@lyriel/openclaw-plugin && openclaw plugins install
+@lyriel/openclaw-plugin`) resolves to the new version.

package/dist/api.js

@@ -0,0 +1,155 @@
+// 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 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,130 @@
+// Background long-poll: hits Lyriel /api/inbox in a recursive setTimeout
+// loop, surfaces each dispatch into the active session via the host's
+// next-turn injection surface, and remembers callback tokens for the LLM's
+// reply tool.
+//
+// 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;
+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 isLocked = promptText.includes("[Lyriel group plan — LOCKED]");
+                        if (!isLocked) {
+                            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;
+                }
+                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,116 @@
+// 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,
+                });
+            },
+        });
+        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