@lyriel/openclaw-plugin 0.1.0

package/dist/tools.js

@@ -0,0 +1,368 @@
+// Five LLM tools the Lyriel plugin exposes to the OpenClaw agent.
+//
+//   lyriel_send_ask(to, prompt)            — initiate a 1:1 ask
+//   lyriel_reply(ask_id, response)         — reply to a pending inbound ask
+//   lyriel_plan_send(participants, ...)    — start a group plan
+//   lyriel_plan_reply(plan_id, content)    — contribute to an ongoing plan
+//   lyriel_plan_lock(plan_id, summary)     — initiator locks the outcome
+//
+// Schemas use typebox (OpenClaw's standard). Handlers return JSON in the
+// content[] shape OpenClaw tools use. Errors are returned as
+// {"error": "..."} rather than thrown — the runtime surfaces the JSON back
+// to the LLM, which then explains the failure to the user.
+import { Type } from "typebox";
+import * as api from "./api.js";
+import * as pending from "./pending.js";
+import { SUBSTRATE_PRIMER } from "./primer.js";
+// Synchronous-completion absorption window. See clients/hermes-plugin/tools.py
+// for the long-form reasoning. Short summary: when the ask is to an in-process
+// system agent (today: @lyriel), the response is written to the ask row before
+// POST /api/asks returns. Brief poll on GET /api/asks/:id afterwards so the
+// response shows up inline in the LLM's tool result, and mark the ask
+// "absorbed" so the inbox poll skips the duplicate forward.
+const ABSORB_WINDOW_MS = 2_500;
+const ABSORB_POLL_INTERVAL_MS = 250;
+function asText(payload) {
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(payload),
+            },
+        ],
+        details: payload,
+    };
+}
+export const sendAskSchema = Type.Object({
+    to: Type.String({
+        description: "Recipient's Lyriel handle, with or without leading @. Examples: 'noor', '@charlie', 'lyriel' (for the system welcome agent).",
+    }),
+    prompt: Type.String({
+        description: "The message body to send. Plain text. The recipient's agent will surface this to their human.",
+    }),
+});
+export const replySchema = Type.Object({
+    ask_id: Type.String({
+        description: "The UUID of the pending ask to reply to.",
+    }),
+    response: Type.String({
+        description: "The user's reply, paraphrased or verbatim.",
+    }),
+});
+export const planSendSchema = Type.Object({
+    participants: Type.Array(Type.String(), {
+        description: "Lyriel handles of the OTHER participants (not the user themselves). With or without leading @. Examples: ['noor', '@maya'].",
+    }),
+    description: Type.String({
+        description: "Free-form description of what the group is coordinating. Include constraints the user already knows. Be specific — every participant's agent reads this verbatim.",
+    }),
+    max_messages: Type.Optional(Type.Integer({
+        description: "Optional cap on conversation length (default 20). Auto-fails if exceeded.",
+    })),
+});
+export const planReplySchema = Type.Object({
+    plan_id: Type.String({
+        description: "The plan_id shown in the surface message.",
+    }),
+    content: Type.String({
+        description: "The user's contribution to the plan conversation. Speak as the user's agent representing them. Pass empty string if stay_silent=true.",
+    }),
+    stay_silent: Type.Optional(Type.Boolean({
+        description: "Set to true to opt out of this round without contributing. Default false.",
+    })),
+});
+export const planLockSchema = Type.Object({
+    plan_id: Type.String({
+        description: "The plan_id to lock.",
+    }),
+    summary: Type.String({
+        description: "Short, human-readable description of the locked outcome (e.g. 'Thursday 7pm at Mission Cantina'). Broadcast to every participant.",
+    }),
+});
+// All five tools share the same client config — passed in at registration.
+export function makeHandlers(client) {
+    async function absorbIfQuick(askId) {
+        const deadline = Date.now() + ABSORB_WINDOW_MS;
+        while (Date.now() < deadline) {
+            try {
+                const data = await api.getAsk(client, askId);
+                if (data.status === "completed") {
+                    return typeof data.response === "string" && data.response ? data.response : null;
+                }
+                if (data.status === "failed") {
+                    return null;
+                }
+            }
+            catch {
+                return null;
+            }
+            await new Promise((r) => setTimeout(r, ABSORB_POLL_INTERVAL_MS));
+        }
+        return null;
+    }
+    async function handleSendAsk(params) {
+        const to = (params.to ?? "").trim();
+        const prompt = (params.prompt ?? "").trim();
+        if (!to || !prompt) {
+            return asText({ error: "Both 'to' and 'prompt' are required" });
+        }
+        let result;
+        try {
+            result = await api.sendAsk(client, to, prompt);
+        }
+        catch (err) {
+            const e = err;
+            return asText({ error: e.message, status: e.status });
+        }
+        const askId = result.ask_id ?? "?";
+        const absorbed = await absorbIfQuick(askId);
+        if (absorbed !== null) {
+            pending.markAbsorbed(askId);
+            return asText({
+                success: true,
+                ask_id: askId,
+                recipient: result.recipient ?? to,
+                status: "completed",
+                completed_inline: true,
+                response: absorbed,
+                note: `${to} responded instantly (in-process system agent). The response is inlined below. ` +
+                    `Summarize or paraphrase it to the user — do NOT wait for a separate Lyriel reply.`,
+            });
+        }
+        return asText({
+            success: true,
+            ask_id: askId,
+            recipient: result.recipient ?? to,
+            status: result.status ?? "dispatched",
+            note: `Ask dispatched to ${to}. The recipient's reply will arrive in this chat as a ` +
+                `🪶 Lyriel reply (ask_id ${askId}) when their agent responds. Acknowledge briefly — ` +
+                `do NOT promise or paraphrase the reply yourself; the surfacing layer delivers it.`,
+        });
+    }
+    async function handleReply(params) {
+        const askId = (params.ask_id ?? "").trim();
+        const response = (params.response ?? "").trim();
+        if (!askId || !response) {
+            return asText({ error: "Both 'ask_id' and 'response' are required" });
+        }
+        const entry = pending.takeAsk(askId);
+        if (!entry) {
+            const snapshot = pending.listPendingAsks();
+            const ids = Object.keys(snapshot);
+            if (ids.length === 0) {
+                return asText({
+                    error: `No pending Lyriel asks. ask_id=${askId} either already had a reply sent OR ` +
+                        `was never received (check the chat for a surface message).`,
+                });
+            }
+            return asText({
+                error: `No pending ask with id ${askId}. Currently pending: ${JSON.stringify(ids)}`,
+                pending_ids: ids,
+            });
+        }
+        try {
+            const result = await api.sendCallback(entry.callbackUrl, entry.callbackToken, response);
+            return asText({
+                success: true,
+                ask_id: askId,
+                callback_status: result.status ?? "ok",
+                idempotent: result.idempotent ?? false,
+                note: "Reply sent through Lyriel.",
+            });
+        }
+        catch (err) {
+            pending.restoreAsk(askId, entry);
+            const e = err;
+            return asText({ error: e.message, status: e.status, retryable: true });
+        }
+    }
+    async function handlePlanSend(params) {
+        const participants = Array.isArray(params.participants) ? params.participants : [];
+        const description = (params.description ?? "").trim();
+        if (participants.length === 0 || !description) {
+            return asText({ error: "Both 'participants' and 'description' are required" });
+        }
+        try {
+            const result = await api.sendPlan(client, participants, description, params.max_messages);
+            return asText({
+                success: true,
+                plan_id: result.plan_id ?? "?",
+                participants: result.participants ?? [],
+                status: result.status ?? "open",
+                note: `Group plan ${result.plan_id} broadcast to participants. Their agents will negotiate. ` +
+                    `Refinement updates and the final locked outcome will arrive in this chat as 🪶 Lyriel ` +
+                    `plan updates. When the user wants to lock with a final decision, use lyriel_plan_lock.`,
+            });
+        }
+        catch (err) {
+            const e = err;
+            return asText({ error: e.message, status: e.status });
+        }
+    }
+    async function handlePlanReply(params) {
+        const planId = (params.plan_id ?? "").trim();
+        const content = (params.content ?? "").trim();
+        const staySilent = Boolean(params.stay_silent);
+        if (!planId) {
+            return asText({ error: "'plan_id' is required" });
+        }
+        if (!staySilent && !content) {
+            return asText({ error: "'content' is required unless stay_silent=true" });
+        }
+        const entry = pending.takePlan(planId);
+        if (!entry) {
+            const snapshot = pending.listPendingPlans();
+            const ids = Object.keys(snapshot);
+            if (ids.length === 0) {
+                return asText({
+                    error: `No pending plan callbacks. plan_id=${planId} either already had a contribution ` +
+                        `this round, OR the plan locked, OR the envelope wasn't received.`,
+                });
+            }
+            return asText({
+                error: `No pending callback for plan ${planId}. Currently pending plans: ${JSON.stringify(ids)}`,
+                pending_plan_ids: ids,
+            });
+        }
+        try {
+            await api.sendPlanCallback(entry.callbackUrl, entry.callbackToken, content, staySilent);
+            return asText({
+                success: true,
+                plan_id: planId,
+                silent: staySilent,
+                note: "Contribution sent. The other participants' agents will now consider it in their " +
+                    "next response. Further refinement rounds and the locked outcome will arrive as " +
+                    "🪶 Lyriel plan updates.",
+            });
+        }
+        catch (err) {
+            pending.restorePlan(planId, entry);
+            const e = err;
+            return asText({ error: e.message, status: e.status, retryable: true });
+        }
+    }
+    async function handlePlanLock(params) {
+        const planId = (params.plan_id ?? "").trim();
+        const summary = (params.summary ?? "").trim();
+        if (!planId || !summary) {
+            return asText({ error: "Both 'plan_id' and 'summary' are required" });
+        }
+        try {
+            const result = await api.lockPlan(client, planId, summary);
+            pending.forgetPlan(planId);
+            return asText({
+                success: true,
+                plan_id: planId,
+                status: result.status ?? "locked",
+                locked_at: result.locked_at,
+                note: `Plan ${planId} locked: ${summary}. Every participant's agent has been notified and ` +
+                    `will surface the final outcome to their human.`,
+            });
+        }
+        catch (err) {
+            const e = err;
+            return asText({ error: e.message, status: e.status });
+        }
+    }
+    return {
+        handleSendAsk,
+        handleReply,
+        handlePlanSend,
+        handlePlanReply,
+        handlePlanLock,
+    };
+}
+function paramRecord(params) {
+    return params && typeof params === "object" && !Array.isArray(params)
+        ? params
+        : {};
+}
+// Defensive narrowing: LLM-emitted tool args are unknown shape; non-string
+// inputs should be treated as empty rather than stringified to
+// "[object Object]". The typebox schema declares each field as a string, but
+// don't trust the validator at this seam.
+function asString(value) {
+    return typeof value === "string" ? value : "";
+}
+export function buildToolDescriptors(client) {
+    const h = makeHandlers(client);
+    return [
+        {
+            name: "lyriel_send_ask",
+            label: "Lyriel: send ask",
+            // The substrate primer is prepended here so it loads into the
+            // LLM's bound-tool context. Tool-specific instructions follow
+            // after a blank line. The other Lyriel tools have shorter,
+            // tool-specific descriptions; the primer in this one
+            // description is enough to frame the whole toolset.
+            description: SUBSTRATE_PRIMER +
+                "\n\n" +
+                "Tool — send a 1:1 ask. Use this when your user wants to ping exactly one other Lyriel user by handle. Returns an ask_id; the recipient's response arrives later as a 'reply' dispatch in the inbox, surfaced into this chat automatically — you do not need to poll. For multi-party coordination, use lyriel_plan_send instead.",
+            parameters: sendAskSchema,
+            async execute(_id, params) {
+                const p = paramRecord(params);
+                return h.handleSendAsk({
+                    to: asString(p.to),
+                    prompt: asString(p.prompt),
+                });
+            },
+        },
+        {
+            name: "lyriel_reply",
+            label: "Lyriel: reply",
+            description: "Reply to a pending inbound Lyriel ask. Use when the user wants to respond to a previously surfaced ask (you'll see a '🪶 Lyriel ask from X' message with an ask_id). Extract the ask_id exactly. If the user replies without naming an ask_id and only one is pending, use that one.",
+            parameters: replySchema,
+            async execute(_id, params) {
+                const p = paramRecord(params);
+                return h.handleReply({
+                    ask_id: asString(p.ask_id),
+                    response: asString(p.response),
+                });
+            },
+        },
+        {
+            name: "lyriel_plan_send",
+            label: "Lyriel: start group plan",
+            description: "Start a group plan through Lyriel. Each participant's agent negotiates on their human's behalf to converge on an outcome. Use when coordinating across multiple verified Lyriel handles — NOT for single 1:1 asks. Returns a plan_id; further rounds arrive as 🪶 Lyriel plan updates.",
+            parameters: planSendSchema,
+            async execute(_id, params) {
+                const p = paramRecord(params);
+                return h.handlePlanSend({
+                    participants: Array.isArray(p.participants)
+                        ? p.participants.filter((x) => typeof x === "string")
+                        : [],
+                    description: asString(p.description),
+                    max_messages: typeof p.max_messages === "number" ? p.max_messages : undefined,
+                });
+            },
+        },
+        {
+            name: "lyriel_plan_reply",
+            label: "Lyriel: contribute to plan",
+            description: "Contribute to an ongoing Lyriel group plan. Use when the user wants to add availability, preferences, constraints, or proposed times to the group conversation. To explicitly opt out of a round, pass stay_silent=true.",
+            parameters: planReplySchema,
+            async execute(_id, params) {
+                const p = paramRecord(params);
+                return h.handlePlanReply({
+                    plan_id: asString(p.plan_id),
+                    content: asString(p.content),
+                    stay_silent: Boolean(p.stay_silent),
+                });
+            },
+        },
+        {
+            name: "lyriel_plan_lock",
+            label: "Lyriel: lock plan",
+            description: "Lock a Lyriel group plan with a final outcome. Only the plan's initiator can lock (Lyriel returns 403 otherwise). The locked outcome is broadcast to every participant's agent.",
+            parameters: planLockSchema,
+            async execute(_id, params) {
+                const p = paramRecord(params);
+                return h.handlePlanLock({
+                    plan_id: asString(p.plan_id),
+                    summary: asString(p.summary),
+                });
+            },
+        },
+    ];
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/openclaw.plugin.json

@@ -0,0 +1,59 @@
+{
+  "id": "lyriel",
+  "name": "Lyriel",
+  "description": "Lyriel plugin for OpenClaw. Long-polls Lyriel's /api/inbox for inbound asks, surfaces them into the user's active session, and exposes five LLM tools for sending/replying to asks and driving group plans in natural language. Cross-provider parity with the Hermes plugin.",
+  "enabledByDefault": false,
+  "activation": {
+    "onStartup": true,
+    "onCapabilities": ["tool"]
+  },
+  "contracts": {
+    "tools": [
+      "lyriel_send_ask",
+      "lyriel_reply",
+      "lyriel_plan_send",
+      "lyriel_plan_reply",
+      "lyriel_plan_lock"
+    ]
+  },
+  "uiHints": {
+    "apiKey": {
+      "label": "Lyriel API Key",
+      "help": "Your lyk_... key from https://lyriel.ai/me/agent setup. Required.",
+      "sensitive": true
+    },
+    "baseUrl": {
+      "label": "Lyriel Base URL",
+      "help": "Defaults to https://lyriel.ai. Override for dev (e.g. http://localhost:5173 or a cloudflared tunnel)."
+    },
+    "surfaceSessionKey": {
+      "label": "Surface Session Key",
+      "help": "Session to inject inbound Lyriel asks into when Telegram push is unavailable. Leave blank to auto-track the user's most recently active session.",
+      "advanced": true
+    },
+    "surfaceTelegramChatId": {
+      "label": "Surface Telegram Chat ID",
+      "help": "Pinned Telegram chat id for proactive push notifications. Leave blank to auto-resolve from channels.telegram.allowFrom.",
+      "advanced": true
+    }
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "apiKey": {
+        "type": "string"
+      },
+      "baseUrl": {
+        "type": "string",
+        "default": "https://lyriel.ai"
+      },
+      "surfaceSessionKey": {
+        "type": "string"
+      },
+      "surfaceTelegramChatId": {
+        "type": "string"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@lyriel/openclaw-plugin",
+  "version": "0.1.0",
+  "description": "Lyriel plugin for OpenClaw. Long-polls Lyriel's /api/inbox, surfaces inbound dispatches into the user's active OpenClaw session via next-turn injection, and registers 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. Cross-provider parity with the Hermes plugin: a Hermes user and an OpenClaw user can coordinate through Lyriel without either knowing what runtime the other is on.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Lyriel",
+  "homepage": "https://lyriel.ai",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/CharlieKerfoot/agent-net.git",
+    "directory": "clients/openclaw-plugin"
+  },
+  "bugs": {
+    "url": "https://github.com/CharlieKerfoot/agent-net/issues"
+  },
+  "keywords": [
+    "lyriel",
+    "openclaw",
+    "plugin",
+    "agent",
+    "coordination"
+  ],
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "openclaw.plugin.json"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "typebox": "1.1.38"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0"
+  },
+  "peerDependencies": {
+    "openclaw": "^2026.5.20"
+  },
+  "peerDependenciesMeta": {
+    "openclaw": {
+      "optional": true
+    }
+  },
+  "openclaw": {
+    "extensions": [
+      "./dist/index.js"
+    ],
+    "install": {
+      "defaultChoice": "link",
+      "minHostVersion": ">=2026.5.0"
+    },
+    "compat": {
+      "pluginApi": ">=2026.5.0"
+    },
+    "build": {
+      "openclawVersion": "2026.5.18"
+    }
+  }
+}