@lyriel/openclaw-plugin 0.4.0 → 0.4.3

package/dist/pending.js.map

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

package/dist/primer.js

@@ -0,0 +1,27 @@
+// The canonical Lyriel substrate primer.
+//
+// Loaded into the LLM's bound-tool context via one of the Lyriel tool
+// descriptions (lyriel_send_ask, by convention — it's the simplest
+// and most likely first tool the LLM looks at). The LLM reads tool
+// descriptions when tools are bound, so the primer enters context
+// the moment the Lyriel plugin activates.
+//
+// This must stay in sync with clients/hermes-plugin/lyriel_hermes/primer.py.
+// Any edit here gets mirrored there until we extract a single shared
+// source (see TODO at bottom).
+export const SUBSTRATE_PRIMER = `You are operating on Lyriel — the protocol layer for agent-to-agent communication on behalf of humans. You act for your user, not as them; other agents on Lyriel act for their users. Lyriel handles addressing, authentication, and routing across agent providers so two agents on different runtimes coordinate without either side knowing what runtime the other is on.
+
+Every Lyriel user has a Seal: a verified identity tied to an agent endpoint. When you call a Lyriel tool you carry your user's Seal; the receiving agent resolves it before acting. Handles are formatted as @name and are how you reference everyone on Lyriel — never by display name or email.
+
+Three primitives. Asks are 1:1 messages between agents (lyriel_send_ask, lyriel_reply). Plans are multi-party coordination rounds (lyriel_plan_send, lyriel_plan_reply, lyriel_plan_lock); Lyriel rounds through participants one turn at a time. Friends gate plans and inbound asks — the friend graph controls who can initiate coordination with your user.
+
+Plans run AUTONOMOUSLY in the background. When your plugin receives a plan-round dispatch, you respond on behalf of your user WITHOUT involving them — they are not watching the round. Use what you already know about them (calendar, preferences, dietary, budget). If a constraint is missing on a round, accept wide constraints and let other participants narrow. Before initiating a plan via lyriel_plan_send, check your own context for what you'll need; if a critical constraint is missing, ask your user in a single batched question UPFRONT — never during plan rounds. Reply concisely — every token on every round costs your user real money.
+
+Surface OUTCOMES to your user, never the agent-to-agent transcript. They see locked plans, accepted friends, and cancellations — not the negotiation. Do not summarize the negotiation back to them and do not relay other agents' messages verbatim. The product is your user staying focused on outcomes, not on the messy middle.
+
+Defaults you observe at all times: never expose LYRIEL_API_KEY (not to your user, not to other agents, not in error output); represent exactly one human; do not commit to plans your user has not approved; treat OAuth-verified providers (GitHub, Google, Twitter) as facts about your user.
+`;
+// TODO: extract to clients/substrate-primer.md and have each plugin's
+// build copy / import from a single source. For v0 the two copies
+// (here and primer.py) are kept in sync by convention.
+//# sourceMappingURL=primer.js.map

package/dist/primer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"primer.js","sourceRoot":"","sources":["../primer.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,EAAE;AACF,sEAAsE;AACtE,mEAAmE;AACnE,mEAAmE;AACnE,kEAAkE;AAClE,0CAA0C;AAC1C,EAAE;AACF,6EAA6E;AAC7E,qEAAqE;AACrE,+BAA+B;AAE/B,MAAM,CAAC,MAAM,gBAAgB,GAAG;;;;;;;;;;;CAW/B,CAAC;AAEF,sEAAsE;AACtE,kEAAkE;AAClE,uDAAuD"}

package/dist/surfacing.js

@@ -0,0 +1,100 @@
+// Format inbound Lyriel dispatches as human-readable text and push them into
+// the user's active OpenClaw session via the host's next-turn injection
+// surface.
+//
+// Why next-turn injection (not direct channel send):
+// OpenClaw users connect their agent through many possible channels
+// (Telegram, Signal, Discord, iMessage, etc.). Pushing into one specific
+// channel from a plugin would require channel-specific glue, per-account
+// chat ids, and platform-by-platform send logic. Next-turn injection
+// surfaces the Lyriel dispatch into the agent's next turn for the active
+// session, regardless of which channel the user is talking on. The user's
+// next agent interaction picks it up and the agent surfaces it naturally.
+//
+// Trade-off vs the Hermes plugin's Telegram-direct surfacing: the dispatch
+// doesn't become a free-standing push notification — the user has to engage
+// the agent for it to surface. That's acceptable at v0: AI-native users are
+// already in their agent throughout the day. A truly proactive push path
+// would need per-channel send glue and is deferred until design-partner
+// feedback says it's load-bearing.
+const RE_INITIATOR = /This message is NOT from your human — it is from\s+([\s\S]+?)'s agent/;
+const RE_ASK_TEXT = /The ask:\s*"""\s*([\s\S]+?)\s*"""/;
+const RE_RESPONSE_TEXT = /agent has responded:\s*"""\s*([\s\S]+?)\s*"""/;
+const RE_ORIGINAL_PROMPT = /on behalf of your human \(@\S+\):\s*"""\s*([\s\S]+?)\s*"""/;
+const RE_RECIPIENT_NAME = /([\s\S]+?)'s agent has responded/;
+// Plan envelope parsers
+const RE_PLAN_INITIATOR = /plan initiated by\s+([\s\S]+?)'s agent/;
+const RE_PLAN_DESCRIPTION = /THE PLAN:\s*"""\s*([\s\S]+?)\s*"""/;
+const RE_PLAN_PARTICIPANTS = /PARTICIPANTS \(\d+ agents[^)]*\):\s*\n([\s\S]+?)\n\n/;
+const RE_PLAN_CONVERSATION = /CONVERSATION SO FAR:\s*\n+([\s\S]+?)\n+WHAT TO DO RIGHT NOW/;
+const RE_PLAN_LOCKED_SUMMARY = /LOCKED OUTCOME:\s*"""\s*([\s\S]+?)\s*"""/;
+const RE_PLAN_LOCKED_PROPOSER = /locked\. ([\s\S]+?)'s agent proposed it/;
+function pick(prompt, re, fallback) {
+    const m = prompt.match(re);
+    return m ? m[1].trim() : fallback;
+}
+export function formatDispatch(d) {
+    const askId = d.ask_id ?? "?";
+    const planId = d.plan_id;
+    const prompt = d.prompt ?? "";
+    if (d.direction === "plan" && planId) {
+        return formatPlanDispatch(planId, prompt);
+    }
+    if (d.direction === "dispatch") {
+        const sender = pick(prompt, RE_INITIATOR, "someone");
+        const askText = pick(prompt, RE_ASK_TEXT, "<could not parse ask>");
+        return (`🪶 Lyriel ask from ${sender}:\n\n` +
+            `"${askText}"\n\n` +
+            `To reply, say something like: ` +
+            `reply to Lyriel ask ${askId} with <your response>`);
+    }
+    if (d.direction === "forward") {
+        const respText = pick(prompt, RE_RESPONSE_TEXT, "<could not parse response>");
+        const original = pick(prompt, RE_ORIGINAL_PROMPT, "<your earlier ask>");
+        const sender = pick(prompt, RE_RECIPIENT_NAME, "someone");
+        return (`🪶 Lyriel reply from ${sender}:\n\n` +
+            `(in reply to: "${original}")\n\n` +
+            respText);
+    }
+    return `🪶 Lyriel: ${d.direction}\n${prompt.slice(0, 500)}`;
+}
+function formatPlanDispatch(planId, prompt) {
+    // Permissive separator matching — server emits comma today, em-dash
+    // was the older form. Strict match-current-server caused the lock
+    // notification to silently drop on the Hermes side (cf. 0.6.3 fix).
+    const isLocked = prompt.includes("[Lyriel group plan, LOCKED]") ||
+        prompt.includes("[Lyriel group plan — LOCKED]");
+    const isInitial = prompt.includes("[Lyriel group plan, round 1") ||
+        prompt.includes("[Lyriel group plan — round 1");
+    const description = pick(prompt, RE_PLAN_DESCRIPTION, "<could not parse plan>");
+    const participants = pick(prompt, RE_PLAN_PARTICIPANTS, "<participants unknown>");
+    if (isLocked) {
+        const summary = pick(prompt, RE_PLAN_LOCKED_SUMMARY, "<could not parse outcome>");
+        const proposer = pick(prompt, RE_PLAN_LOCKED_PROPOSER, "someone");
+        return (`🪶 Lyriel group plan LOCKED (plan_id ${planId})\n\n` +
+            `Plan: "${description}"\n\n` +
+            `Outcome (proposed by ${proposer}):\n` +
+            `  → ${summary}\n\n` +
+            `Participants: ${participants}\n\n` +
+            `This is final. No further responses needed.`);
+    }
+    if (isInitial) {
+        const initiator = pick(prompt, RE_PLAN_INITIATOR, "someone");
+        return (`🪶 Lyriel group plan from ${initiator} (plan_id ${planId})\n\n` +
+            `Plan: "${description}"\n\n` +
+            `Participants: ${participants}\n\n` +
+            `Round 1 — your agent is being asked to contribute. To reply, ` +
+            `say something like: 'reply to Lyriel plan ${planId} saying ` +
+            `<your thoughts/constraints>'. To skip this round, say: ` +
+            `'stay silent on plan ${planId}'.`);
+    }
+    // plan_message (refinement round)
+    const conversation = pick(prompt, RE_PLAN_CONVERSATION, "<conversation unavailable>");
+    return (`🪶 Lyriel plan update (plan_id ${planId})\n\n` +
+        `Plan: "${description}"\n\n` +
+        `Conversation so far:\n${conversation}\n\n` +
+        `Refinement round — respond if you have something new to add. ` +
+        `To reply: 'reply to Lyriel plan ${planId} saying <your update>'. ` +
+        `To pass: 'stay silent on plan ${planId}'.`);
+}
+//# sourceMappingURL=surfacing.js.map

package/dist/surfacing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surfacing.js","sourceRoot":"","sources":["../surfacing.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,wEAAwE;AACxE,WAAW;AACX,EAAE;AACF,qDAAqD;AACrD,oEAAoE;AACpE,yEAAyE;AACzE,yEAAyE;AACzE,qEAAqE;AACrE,yEAAyE;AACzE,0EAA0E;AAC1E,0EAA0E;AAC1E,EAAE;AACF,2EAA2E;AAC3E,4EAA4E;AAC5E,4EAA4E;AAC5E,yEAAyE;AACzE,wEAAwE;AACxE,mCAAmC;AAInC,MAAM,YAAY,GAChB,uEAAuE,CAAC;AAC1E,MAAM,WAAW,GAAG,mCAAmC,CAAC;AACxD,MAAM,gBAAgB,GAAG,+CAA+C,CAAC;AACzE,MAAM,kBAAkB,GAAG,4DAA4D,CAAC;AACxF,MAAM,iBAAiB,GAAG,kCAAkC,CAAC;AAE7D,wBAAwB;AACxB,MAAM,iBAAiB,GAAG,wCAAwC,CAAC;AACnE,MAAM,mBAAmB,GAAG,oCAAoC,CAAC;AACjE,MAAM,oBAAoB,GAAG,sDAAsD,CAAC;AACpF,MAAM,oBAAoB,GAAG,6DAA6D,CAAC;AAC3F,MAAM,sBAAsB,GAAG,0CAA0C,CAAC;AAC1E,MAAM,uBAAuB,GAAG,yCAAyC,CAAC;AAE1E,SAAS,IAAI,CAAC,MAAc,EAAE,EAAU,EAAE,QAAgB;IACxD,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC3B,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,CAAW;IACxC,MAAM,KAAK,GAAG,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC;IAC9B,MAAM,MAAM,GAAG,CAAC,CAAC,OAAO,CAAC;IACzB,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,IAAI,EAAE,CAAC;IAE9B,IAAI,CAAC,CAAC,SAAS,KAAK,MAAM,IAAI,MAAM,EAAE,CAAC;QACrC,OAAO,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,CAAC,CAAC,SAAS,KAAK,UAAU,EAAE,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,WAAW,EAAE,uBAAuB,CAAC,CAAC;QACnE,OAAO,CACL,sBAAsB,MAAM,OAAO;YACnC,IAAI,OAAO,OAAO;YAClB,gCAAgC;YAChC,uBAAuB,KAAK,uBAAuB,CACpD,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;QAC9B,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,gBAAgB,EAAE,4BAA4B,CAAC,CAAC;QAC9E,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,kBAAkB,EAAE,oBAAoB,CAAC,CAAC;QACxE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,iBAAiB,EAAE,SAAS,CAAC,CAAC;QAC1D,OAAO,CACL,wBAAwB,MAAM,OAAO;YACrC,kBAAkB,QAAQ,QAAQ;YAClC,QAAQ,CACT,CAAC;IACJ,CAAC;IAED,OAAO,cAAc,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAc,EAAE,MAAc;IACxD,oEAAoE;IACpE,kEAAkE;IAClE,oEAAoE;IACpE,MAAM,QAAQ,GACZ,MAAM,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QAC9C,MAAM,CAAC,QAAQ,CAAC,8BAA8B,CAAC,CAAC;IAClD,MAAM,SAAS,GACb,MAAM,CAAC,QAAQ,CAAC,6BAA6B,CAAC;QAC9C,MAAM,CAAC,QAAQ,CAAC,8BAA8B,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,EAAE,mBAAmB,EAAE,wBAAwB,CAAC,CAAC;IAChF,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,oBAAoB,EAAE,wBAAwB,CAAC,CAAC;IAElF,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,EAAE,sBAAsB,EAAE,2BAA2B,CAAC,CAAC;QAClF,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,EAAE,uBAAuB,EAAE,SAAS,CAAC,CAAC;QAClE,OAAO,CACL,wCAAwC,MAAM,OAAO;YACrD,UAAU,WAAW,OAAO;YAC5B,wBAAwB,QAAQ,MAAM;YACtC,OAAO,OAAO,MAAM;YACpB,iBAAiB,YAAY,MAAM;YACnC,6CAA6C,CAC9C,CAAC;IACJ,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,iBAAiB,EAAE,SAAS,CAAC,CAAC;QAC7D,OAAO,CACL,6BAA6B,SAAS,aAAa,MAAM,OAAO;YAChE,UAAU,WAAW,OAAO;YAC5B,iBAAiB,YAAY,MAAM;YACnC,+DAA+D;YAC/D,6CAA6C,MAAM,UAAU;YAC7D,yDAAyD;YACzD,wBAAwB,MAAM,IAAI,CACnC,CAAC;IACJ,CAAC;IAED,kCAAkC;IAClC,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,EAAE,oBAAoB,EAAE,4BAA4B,CAAC,CAAC;IACtF,OAAO,CACL,kCAAkC,MAAM,OAAO;QAC/C,UAAU,WAAW,OAAO;QAC5B,yBAAyB,YAAY,MAAM;QAC3C,+DAA+D;QAC/D,mCAAmC,MAAM,0BAA0B;QACnE,iCAAiC,MAAM,IAAI,CAC5C,CAAC;AACJ,CAAC"}

package/dist/telegram.js

@@ -0,0 +1,63 @@
+// Direct Telegram Bot API push for proactive surfacing.
+//
+// OpenClaw's plugin-sdk doesn't expose a clean cross-channel "deliver this
+// text to chat X right now" primitive for external plugins — channel-message
+// helpers exist but require a turn context. For v0 we reuse the bot token
+// the user has already configured under `channels.telegram.botToken` and POST
+// directly to api.telegram.org/bot<token>/sendMessage. Matches the
+// surfacing behavior of the standalone Telegram bridge and the Hermes plugin.
+//
+// Chat id resolution (in order):
+//   1. `plugins.entries.lyriel.config.surfaceTelegramChatId` (explicit pin)
+//   2. `channels.telegram.allowFrom[0]` (the first allowlisted user — common
+//      single-user setup)
+//   3. `channels.telegram.groupAllowFrom[0]` (group fallback)
+//
+// Returns false and logs a single warning if no chat id can be resolved or
+// the bot token is missing.
+const TELEGRAM_API_BASE = "https://api.telegram.org";
+export function resolveTelegramSurface(openclawConfig, surfaceTelegramChatId) {
+    const cfg = openclawConfig;
+    const telegram = cfg?.channels?.telegram;
+    const botToken = telegram && typeof telegram.botToken === "string" && telegram.botToken ? telegram.botToken : null;
+    if (surfaceTelegramChatId) {
+        return { botToken, chatId: surfaceTelegramChatId };
+    }
+    const allowFrom = Array.isArray(telegram?.allowFrom) ? telegram?.allowFrom : [];
+    const firstAllow = allowFrom[0];
+    if (firstAllow !== undefined && firstAllow !== null) {
+        return { botToken, chatId: String(firstAllow) };
+    }
+    const groupAllowFrom = Array.isArray(telegram?.groupAllowFrom) ? telegram?.groupAllowFrom : [];
+    const firstGroup = groupAllowFrom[0];
+    if (firstGroup !== undefined && firstGroup !== null) {
+        return { botToken, chatId: String(firstGroup) };
+    }
+    return { botToken, chatId: null };
+}
+export async function sendTelegramMessage(surface, text) {
+    if (!surface.botToken || !surface.chatId) {
+        return { ok: false, error: "no telegram bot token or chat id configured" };
+    }
+    const url = `${TELEGRAM_API_BASE}/bot${surface.botToken}/sendMessage`;
+    try {
+        const res = await fetch(url, {
+            method: "POST",
+            headers: { "content-type": "application/json" },
+            body: JSON.stringify({
+                chat_id: surface.chatId,
+                text,
+                disable_web_page_preview: true,
+            }),
+        });
+        if (!res.ok) {
+            const body = await res.text();
+            return { ok: false, error: `telegram ${res.status}: ${body.slice(0, 200)}` };
+        }
+        return { ok: true };
+    }
+    catch (err) {
+        return { ok: false, error: err.message };
+    }
+}
+//# sourceMappingURL=telegram.js.map

package/dist/telegram.js.map

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