@alfe.ai/openclaw-chat 0.9.1 → 0.9.3

package/dist/index.d.cts

@@ -1,2 +1,2 @@
-import { S as SessionSummary, _ as AlfeChannelConfig, b as ChatMessage, f as plugin, g as createAlfeChannelPlugin, v as AlfePluginConfig, x as SessionData, y as AlfeResolvedAccount } from "./plugin.cjs";
+import { C as SessionSummary, S as SessionData, _ as createAlfeChannelPlugin, b as AlfeResolvedAccount, p as plugin, v as AlfeChannelConfig, x as ChatMessage, y as AlfePluginConfig } from "./plugin.cjs";
 export { type AlfeChannelConfig, type AlfePluginConfig, type AlfeResolvedAccount, type ChatMessage, type SessionData, type SessionSummary, createAlfeChannelPlugin, plugin as default };

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { S as SessionSummary, _ as AlfeChannelConfig, b as ChatMessage, f as plugin, g as createAlfeChannelPlugin, v as AlfePluginConfig, x as SessionData, y as AlfeResolvedAccount } from "./plugin.js";
+import { C as SessionSummary, S as SessionData, _ as createAlfeChannelPlugin, b as AlfeResolvedAccount, p as plugin, v as AlfeChannelConfig, x as ChatMessage, y as AlfePluginConfig } from "./plugin.js";
 export { type AlfeChannelConfig, type AlfePluginConfig, type AlfeResolvedAccount, type ChatMessage, type SessionData, type SessionSummary, createAlfeChannelPlugin, plugin as default };

package/dist/index.js

@@ -1,2 +1,2 @@
-import { m as createAlfeChannelPlugin, u as plugin } from "./plugin2.js";
+import { d as plugin, h as createAlfeChannelPlugin } from "./plugin2.js";
 export { createAlfeChannelPlugin, plugin as default };

package/dist/plugin.cjs

@@ -3,6 +3,7 @@ Object.defineProperties(exports, {
 	[Symbol.toStringTag]: { value: "Module" }
 });
 const require_plugin = require("./plugin2.cjs");
+exports.CROSS_AGENT_TOOLS_SYSTEM_PROMPT = require_plugin.CROSS_AGENT_TOOLS_SYSTEM_PROMPT;
 exports.VOICE_REPLY_SYSTEM_PROMPT = require_plugin.VOICE_REPLY_SYSTEM_PROMPT;
 exports.__agentTurnQueueForTest = require_plugin.__agentTurnQueueForTest;
 exports.__resetAgentTurnQueueForTest = require_plugin.__resetAgentTurnQueueForTest;

package/dist/plugin.d.cts

@@ -606,13 +606,24 @@ declare function resolveAbortTargetKeys(active: ActiveRunRef | null, abortSessio
  */
 declare const VOICE_REPLY_SYSTEM_PROMPT: string;
 /**
- * Per-turn envelope context derived from the RPC `origin` flag. For a live
- * voice call it returns a `GroupSystemPrompt` block, which is the PROVEN
- * runtime-rendered seam for per-turn system-prompt guidance: dispatchInbound
- * spreads `extraContext` into `finalizeInboundContext` → `sessionCtx.GroupSystemPrompt`
+ * One-liner disambiguating Alfe's cross-agent tools from the OpenClaw
+ * runtime's look-alike built-ins. Observed failure mode (prod, 2026-07-07):
+ * asked to "tell the other agents", the model called the runtime's
+ * `sessions_send` with Alfe `agt_…` IDs — those built-ins only know local
+ * runtime sessions, so every call died with "agent not found" and the model
+ * burned turns flailing between tools. Tool descriptions alone didn't
+ * disambiguate; this rides the system prompt on every turn (~40 tokens).
+ */
+declare const CROSS_AGENT_TOOLS_SYSTEM_PROMPT: string;
+/**
+ * Per-turn envelope context derived from the RPC `origin` flag, returned as a
+ * `GroupSystemPrompt` block — the PROVEN runtime-rendered seam for per-turn
+ * system-prompt guidance: dispatchInbound spreads `extraContext` into
+ * `finalizeInboundContext` → `sessionCtx.GroupSystemPrompt`
  * → `extraSystemPrompt` → the model's system prompt (rendered under a
  * "## Group Chat Context" heading; read unconditionally, NOT gated on group
- * chats). Returns `{}` for every other origin, so text/A2A turns are unchanged.
+ * chats). Every origin carries the cross-agent tool disambiguation; live
+ * voice calls additionally get the spoken-reply style guidance.
  *
  * Why `GroupSystemPrompt` and not a bespoke key like `A2ASystemPrompt`: the
  * OpenClaw runtime does NOT read arbitrary `extraContext` keys — a custom key
@@ -638,4 +649,4 @@ declare const plugin: {
   deactivate(api: PluginApi): Promise<void>;
 };
 //#endregion
-export { SessionSummary as S, AlfeChannelConfig as _, __resetAgentTurnQueueForTest as a, ChatMessage as b, buildA2ACompletePayload as c, joinAssistantText as d, plugin as f, createAlfeChannelPlugin as g, stripLeakedToolSummary as h, __agentTurnQueueForTest as i, buildOriginEnvelopeContext as l, rewriteAssistantText as m, RunEventGate as n, __setActiveRunForTest as o, resolveAbortTargetKeys as p, VOICE_REPLY_SYSTEM_PROMPT as r, admitAgentEvent as s, ActiveRunRef as t, buildToolActivity as u, AlfePluginConfig as v, SessionData as x, AlfeResolvedAccount as y };
+export { SessionSummary as C, SessionData as S, createAlfeChannelPlugin as _, __agentTurnQueueForTest as a, AlfeResolvedAccount as b, admitAgentEvent as c, buildToolActivity as d, joinAssistantText as f, stripLeakedToolSummary as g, rewriteAssistantText as h, VOICE_REPLY_SYSTEM_PROMPT as i, buildA2ACompletePayload as l, resolveAbortTargetKeys as m, CROSS_AGENT_TOOLS_SYSTEM_PROMPT as n, __resetAgentTurnQueueForTest as o, plugin as p, RunEventGate as r, __setActiveRunForTest as s, ActiveRunRef as t, buildOriginEnvelopeContext as u, AlfeChannelConfig as v, ChatMessage as x, AlfePluginConfig as y };

package/dist/plugin.d.ts

@@ -606,13 +606,24 @@ declare function resolveAbortTargetKeys(active: ActiveRunRef | null, abortSessio
  */
 declare const VOICE_REPLY_SYSTEM_PROMPT: string;
 /**
- * Per-turn envelope context derived from the RPC `origin` flag. For a live
- * voice call it returns a `GroupSystemPrompt` block, which is the PROVEN
- * runtime-rendered seam for per-turn system-prompt guidance: dispatchInbound
- * spreads `extraContext` into `finalizeInboundContext` → `sessionCtx.GroupSystemPrompt`
+ * One-liner disambiguating Alfe's cross-agent tools from the OpenClaw
+ * runtime's look-alike built-ins. Observed failure mode (prod, 2026-07-07):
+ * asked to "tell the other agents", the model called the runtime's
+ * `sessions_send` with Alfe `agt_…` IDs — those built-ins only know local
+ * runtime sessions, so every call died with "agent not found" and the model
+ * burned turns flailing between tools. Tool descriptions alone didn't
+ * disambiguate; this rides the system prompt on every turn (~40 tokens).
+ */
+declare const CROSS_AGENT_TOOLS_SYSTEM_PROMPT: string;
+/**
+ * Per-turn envelope context derived from the RPC `origin` flag, returned as a
+ * `GroupSystemPrompt` block — the PROVEN runtime-rendered seam for per-turn
+ * system-prompt guidance: dispatchInbound spreads `extraContext` into
+ * `finalizeInboundContext` → `sessionCtx.GroupSystemPrompt`
  * → `extraSystemPrompt` → the model's system prompt (rendered under a
  * "## Group Chat Context" heading; read unconditionally, NOT gated on group
- * chats). Returns `{}` for every other origin, so text/A2A turns are unchanged.
+ * chats). Every origin carries the cross-agent tool disambiguation; live
+ * voice calls additionally get the spoken-reply style guidance.
  *
  * Why `GroupSystemPrompt` and not a bespoke key like `A2ASystemPrompt`: the
  * OpenClaw runtime does NOT read arbitrary `extraContext` keys — a custom key
@@ -638,4 +649,4 @@ declare const plugin: {
   deactivate(api: PluginApi): Promise<void>;
 };
 //#endregion
-export { SessionSummary as S, AlfeChannelConfig as _, __resetAgentTurnQueueForTest as a, ChatMessage as b, buildA2ACompletePayload as c, joinAssistantText as d, plugin as f, createAlfeChannelPlugin as g, stripLeakedToolSummary as h, __agentTurnQueueForTest as i, buildOriginEnvelopeContext as l, rewriteAssistantText as m, RunEventGate as n, __setActiveRunForTest as o, resolveAbortTargetKeys as p, VOICE_REPLY_SYSTEM_PROMPT as r, admitAgentEvent as s, ActiveRunRef as t, buildToolActivity as u, AlfePluginConfig as v, SessionData as x, AlfeResolvedAccount as y };
+export { SessionSummary as C, SessionData as S, createAlfeChannelPlugin as _, __agentTurnQueueForTest as a, AlfeResolvedAccount as b, admitAgentEvent as c, buildToolActivity as d, joinAssistantText as f, stripLeakedToolSummary as g, rewriteAssistantText as h, VOICE_REPLY_SYSTEM_PROMPT as i, buildA2ACompletePayload as l, resolveAbortTargetKeys as m, CROSS_AGENT_TOOLS_SYSTEM_PROMPT as n, __resetAgentTurnQueueForTest as o, plugin as p, RunEventGate as r, __setActiveRunForTest as s, ActiveRunRef as t, buildOriginEnvelopeContext as u, AlfeChannelConfig as v, ChatMessage as x, AlfePluginConfig as y };

package/dist/plugin.js

@@ -1,2 +1,2 @@
-import { a as admitAgentEvent, c as buildToolActivity, d as resolveAbortTargetKeys, f as rewriteAssistantText, i as __setActiveRunForTest, l as joinAssistantText, n as __agentTurnQueueForTest, o as buildA2ACompletePayload, p as stripLeakedToolSummary, r as __resetAgentTurnQueueForTest, s as buildOriginEnvelopeContext, t as VOICE_REPLY_SYSTEM_PROMPT, u as plugin } from "./plugin2.js";
-export { VOICE_REPLY_SYSTEM_PROMPT, __agentTurnQueueForTest, __resetAgentTurnQueueForTest, __setActiveRunForTest, admitAgentEvent, buildA2ACompletePayload, buildOriginEnvelopeContext, buildToolActivity, plugin as default, joinAssistantText, resolveAbortTargetKeys, rewriteAssistantText, stripLeakedToolSummary };
+import { a as __setActiveRunForTest, c as buildOriginEnvelopeContext, d as plugin, f as resolveAbortTargetKeys, i as __resetAgentTurnQueueForTest, l as buildToolActivity, m as stripLeakedToolSummary, n as VOICE_REPLY_SYSTEM_PROMPT, o as admitAgentEvent, p as rewriteAssistantText, r as __agentTurnQueueForTest, s as buildA2ACompletePayload, t as CROSS_AGENT_TOOLS_SYSTEM_PROMPT, u as joinAssistantText } from "./plugin2.js";
+export { CROSS_AGENT_TOOLS_SYSTEM_PROMPT, VOICE_REPLY_SYSTEM_PROMPT, __agentTurnQueueForTest, __resetAgentTurnQueueForTest, __setActiveRunForTest, admitAgentEvent, buildA2ACompletePayload, buildOriginEnvelopeContext, buildToolActivity, plugin as default, joinAssistantText, resolveAbortTargetKeys, rewriteAssistantText, stripLeakedToolSummary };

package/dist/plugin2.cjs

@@ -2304,13 +2304,24 @@ const VOICE_REPLY_SYSTEM_PROMPT = [
 	"This is guidance on speaking STYLE only. Do NOT skip tool calls you would otherwise make, and never omit information the user actually needs — just deliver it the way you would say it out loud."
 ].join("\n");
 /**
-* Per-turn envelope context derived from the RPC `origin` flag. For a live
-* voice call it returns a `GroupSystemPrompt` block, which is the PROVEN
-* runtime-rendered seam for per-turn system-prompt guidance: dispatchInbound
-* spreads `extraContext` into `finalizeInboundContext` → `sessionCtx.GroupSystemPrompt`
+* One-liner disambiguating Alfe's cross-agent tools from the OpenClaw
+* runtime's look-alike built-ins. Observed failure mode (prod, 2026-07-07):
+* asked to "tell the other agents", the model called the runtime's
+* `sessions_send` with Alfe `agt_…` IDs — those built-ins only know local
+* runtime sessions, so every call died with "agent not found" and the model
+* burned turns flailing between tools. Tool descriptions alone didn't
+* disambiguate; this rides the system prompt on every turn (~40 tokens).
+*/
+const CROSS_AGENT_TOOLS_SYSTEM_PROMPT = ["Cross-agent messaging: to contact another Alfe agent (IDs like agt_…), use list_agents to discover and message_agent to send.", "The runtime's sessions_send / sessions_spawn tools do NOT know Alfe agent IDs and will fail with \"agent not found\" — never use them to reach another agent."].join("\n");
+/**
+* Per-turn envelope context derived from the RPC `origin` flag, returned as a
+* `GroupSystemPrompt` block — the PROVEN runtime-rendered seam for per-turn
+* system-prompt guidance: dispatchInbound spreads `extraContext` into
+* `finalizeInboundContext` → `sessionCtx.GroupSystemPrompt`
 * → `extraSystemPrompt` → the model's system prompt (rendered under a
 * "## Group Chat Context" heading; read unconditionally, NOT gated on group
-* chats). Returns `{}` for every other origin, so text/A2A turns are unchanged.
+* chats). Every origin carries the cross-agent tool disambiguation; live
+* voice calls additionally get the spoken-reply style guidance.
 *
 * Why `GroupSystemPrompt` and not a bespoke key like `A2ASystemPrompt`: the
 * OpenClaw runtime does NOT read arbitrary `extraContext` keys — a custom key
@@ -2327,8 +2338,8 @@ const VOICE_REPLY_SYSTEM_PROMPT = [
 * Exported pure for unit testing (mirrors the codebase's pure-helper pattern).
 */
 function buildOriginEnvelopeContext(origin) {
-	if (origin === "voice") return { GroupSystemPrompt: VOICE_REPLY_SYSTEM_PROMPT };
-	return {};
+	if (origin === "voice") return { GroupSystemPrompt: `${VOICE_REPLY_SYSTEM_PROMPT}\n\n${CROSS_AGENT_TOOLS_SYSTEM_PROMPT}` };
+	return { GroupSystemPrompt: CROSS_AGENT_TOOLS_SYSTEM_PROMPT };
 }
 async function handleAgentRequest(request, log) {
 	const runtime = pluginRuntime;
@@ -2912,6 +2923,12 @@ const plugin = {
 	}
 };
 //#endregion
+Object.defineProperty(exports, "CROSS_AGENT_TOOLS_SYSTEM_PROMPT", {
+	enumerable: true,
+	get: function() {
+		return CROSS_AGENT_TOOLS_SYSTEM_PROMPT;
+	}
+});
 Object.defineProperty(exports, "VOICE_REPLY_SYSTEM_PROMPT", {
 	enumerable: true,
 	get: function() {

package/dist/plugin2.d.cts

@@ -1,2 +1,2 @@
-import { a as __resetAgentTurnQueueForTest, c as buildA2ACompletePayload, d as joinAssistantText, f as plugin, h as stripLeakedToolSummary, i as __agentTurnQueueForTest, l as buildOriginEnvelopeContext, m as rewriteAssistantText, n as RunEventGate, o as __setActiveRunForTest, p as resolveAbortTargetKeys, r as VOICE_REPLY_SYSTEM_PROMPT, s as admitAgentEvent, t as ActiveRunRef, u as buildToolActivity } from "./plugin.cjs";
-export { ActiveRunRef, RunEventGate, VOICE_REPLY_SYSTEM_PROMPT, __agentTurnQueueForTest, __resetAgentTurnQueueForTest, __setActiveRunForTest, admitAgentEvent, buildA2ACompletePayload, buildOriginEnvelopeContext, buildToolActivity, plugin as default, joinAssistantText, resolveAbortTargetKeys, rewriteAssistantText, stripLeakedToolSummary };
+import { a as __agentTurnQueueForTest, c as admitAgentEvent, d as buildToolActivity, f as joinAssistantText, g as stripLeakedToolSummary, h as rewriteAssistantText, i as VOICE_REPLY_SYSTEM_PROMPT, l as buildA2ACompletePayload, m as resolveAbortTargetKeys, n as CROSS_AGENT_TOOLS_SYSTEM_PROMPT, o as __resetAgentTurnQueueForTest, p as plugin, r as RunEventGate, s as __setActiveRunForTest, t as ActiveRunRef, u as buildOriginEnvelopeContext } from "./plugin.cjs";
+export { ActiveRunRef, CROSS_AGENT_TOOLS_SYSTEM_PROMPT, RunEventGate, VOICE_REPLY_SYSTEM_PROMPT, __agentTurnQueueForTest, __resetAgentTurnQueueForTest, __setActiveRunForTest, admitAgentEvent, buildA2ACompletePayload, buildOriginEnvelopeContext, buildToolActivity, plugin as default, joinAssistantText, resolveAbortTargetKeys, rewriteAssistantText, stripLeakedToolSummary };

package/dist/plugin2.d.ts

@@ -1,2 +1,2 @@
-import { a as __resetAgentTurnQueueForTest, c as buildA2ACompletePayload, d as joinAssistantText, f as plugin, h as stripLeakedToolSummary, i as __agentTurnQueueForTest, l as buildOriginEnvelopeContext, m as rewriteAssistantText, n as RunEventGate, o as __setActiveRunForTest, p as resolveAbortTargetKeys, r as VOICE_REPLY_SYSTEM_PROMPT, s as admitAgentEvent, t as ActiveRunRef, u as buildToolActivity } from "./plugin.js";
-export { ActiveRunRef, RunEventGate, VOICE_REPLY_SYSTEM_PROMPT, __agentTurnQueueForTest, __resetAgentTurnQueueForTest, __setActiveRunForTest, admitAgentEvent, buildA2ACompletePayload, buildOriginEnvelopeContext, buildToolActivity, plugin as default, joinAssistantText, resolveAbortTargetKeys, rewriteAssistantText, stripLeakedToolSummary };
+import { a as __agentTurnQueueForTest, c as admitAgentEvent, d as buildToolActivity, f as joinAssistantText, g as stripLeakedToolSummary, h as rewriteAssistantText, i as VOICE_REPLY_SYSTEM_PROMPT, l as buildA2ACompletePayload, m as resolveAbortTargetKeys, n as CROSS_AGENT_TOOLS_SYSTEM_PROMPT, o as __resetAgentTurnQueueForTest, p as plugin, r as RunEventGate, s as __setActiveRunForTest, t as ActiveRunRef, u as buildOriginEnvelopeContext } from "./plugin.js";
+export { ActiveRunRef, CROSS_AGENT_TOOLS_SYSTEM_PROMPT, RunEventGate, VOICE_REPLY_SYSTEM_PROMPT, __agentTurnQueueForTest, __resetAgentTurnQueueForTest, __setActiveRunForTest, admitAgentEvent, buildA2ACompletePayload, buildOriginEnvelopeContext, buildToolActivity, plugin as default, joinAssistantText, resolveAbortTargetKeys, rewriteAssistantText, stripLeakedToolSummary };

package/dist/plugin2.js

@@ -2304,13 +2304,24 @@ const VOICE_REPLY_SYSTEM_PROMPT = [
 	"This is guidance on speaking STYLE only. Do NOT skip tool calls you would otherwise make, and never omit information the user actually needs — just deliver it the way you would say it out loud."
 ].join("\n");
 /**
-* Per-turn envelope context derived from the RPC `origin` flag. For a live
-* voice call it returns a `GroupSystemPrompt` block, which is the PROVEN
-* runtime-rendered seam for per-turn system-prompt guidance: dispatchInbound
-* spreads `extraContext` into `finalizeInboundContext` → `sessionCtx.GroupSystemPrompt`
+* One-liner disambiguating Alfe's cross-agent tools from the OpenClaw
+* runtime's look-alike built-ins. Observed failure mode (prod, 2026-07-07):
+* asked to "tell the other agents", the model called the runtime's
+* `sessions_send` with Alfe `agt_…` IDs — those built-ins only know local
+* runtime sessions, so every call died with "agent not found" and the model
+* burned turns flailing between tools. Tool descriptions alone didn't
+* disambiguate; this rides the system prompt on every turn (~40 tokens).
+*/
+const CROSS_AGENT_TOOLS_SYSTEM_PROMPT = ["Cross-agent messaging: to contact another Alfe agent (IDs like agt_…), use list_agents to discover and message_agent to send.", "The runtime's sessions_send / sessions_spawn tools do NOT know Alfe agent IDs and will fail with \"agent not found\" — never use them to reach another agent."].join("\n");
+/**
+* Per-turn envelope context derived from the RPC `origin` flag, returned as a
+* `GroupSystemPrompt` block — the PROVEN runtime-rendered seam for per-turn
+* system-prompt guidance: dispatchInbound spreads `extraContext` into
+* `finalizeInboundContext` → `sessionCtx.GroupSystemPrompt`
 * → `extraSystemPrompt` → the model's system prompt (rendered under a
 * "## Group Chat Context" heading; read unconditionally, NOT gated on group
-* chats). Returns `{}` for every other origin, so text/A2A turns are unchanged.
+* chats). Every origin carries the cross-agent tool disambiguation; live
+* voice calls additionally get the spoken-reply style guidance.
 *
 * Why `GroupSystemPrompt` and not a bespoke key like `A2ASystemPrompt`: the
 * OpenClaw runtime does NOT read arbitrary `extraContext` keys — a custom key
@@ -2327,8 +2338,8 @@ const VOICE_REPLY_SYSTEM_PROMPT = [
 * Exported pure for unit testing (mirrors the codebase's pure-helper pattern).
 */
 function buildOriginEnvelopeContext(origin) {
-	if (origin === "voice") return { GroupSystemPrompt: VOICE_REPLY_SYSTEM_PROMPT };
-	return {};
+	if (origin === "voice") return { GroupSystemPrompt: `${VOICE_REPLY_SYSTEM_PROMPT}\n\n${CROSS_AGENT_TOOLS_SYSTEM_PROMPT}` };
+	return { GroupSystemPrompt: CROSS_AGENT_TOOLS_SYSTEM_PROMPT };
 }
 async function handleAgentRequest(request, log) {
 	const runtime = pluginRuntime;
@@ -2912,4 +2923,4 @@ const plugin = {
 	}
 };
 //#endregion
-export { admitAgentEvent as a, buildToolActivity as c, resolveAbortTargetKeys as d, rewriteAssistantText as f, __setActiveRunForTest as i, joinAssistantText as l, createAlfeChannelPlugin as m, __agentTurnQueueForTest as n, buildA2ACompletePayload as o, stripLeakedToolSummary as p, __resetAgentTurnQueueForTest as r, buildOriginEnvelopeContext as s, VOICE_REPLY_SYSTEM_PROMPT as t, plugin as u };
+export { __setActiveRunForTest as a, buildOriginEnvelopeContext as c, plugin as d, resolveAbortTargetKeys as f, createAlfeChannelPlugin as h, __resetAgentTurnQueueForTest as i, buildToolActivity as l, stripLeakedToolSummary as m, VOICE_REPLY_SYSTEM_PROMPT as n, admitAgentEvent as o, rewriteAssistantText as p, __agentTurnQueueForTest as r, buildA2ACompletePayload as s, CROSS_AGENT_TOOLS_SYSTEM_PROMPT as t, joinAssistantText as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alfe.ai/openclaw-chat",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "description": "OpenClaw chat plugin for Alfe — web widget and mobile app channels",
   "type": "module",
   "main": "./dist/plugin.js",
@@ -27,8 +27,8 @@
     "openclaw.plugin.json"
   ],
   "dependencies": {
-    "@alfe.ai/agent-api-client": "^0.8.0",
-    "@alfe.ai/chat": "^0.0.15",
+    "@alfe.ai/agent-api-client": "^0.9.0",
+    "@alfe.ai/chat": "^0.0.16",
     "@alfe.ai/config": "^0.3.0"
   },
   "peerDependencies": {