@perkos/perkos-a2a 0.12.41 → 0.12.43

package/dist/index.d.ts

@@ -55,6 +55,21 @@ type EmbeddedChatRunResult = {
     };
 };
 export declare function extractOpenClawChatReply(result: EmbeddedChatRunResult): string | null;
+/** Remove the conversation routing marker if an external model echoes it. */
+export declare function stripPerkosChatTransportMarker(reply: string, convId: string): string;
+export type OpenClawRuntimeModelRoute = {
+    provider: string;
+    model: string;
+    source: "plugin-override" | "agent-default" | "gateway-default";
+};
+/**
+ * Resolve the provider/model route already owned by OpenClaw. The embedded
+ * runner in OpenClaw 2026.5.x does not resolve `agents.defaults.model` when a
+ * plugin calls it directly; without explicit run parameters it silently
+ * starts from openai/gpt-5.5. Passing this resolved route is therefore an
+ * adapter responsibility, not a PerkOS model choice.
+ */
+export declare function resolveOpenClawRuntimeModelRoute(runtimeConfig: unknown, agentId: string, explicitPluginOverride?: string): OpenClawRuntimeModelRoute | null;
 export declare function runOpenClawChatTurn(api: any, config: A2APluginConfig, sessionKey: string, prompt: string, transcriptPrompt: string, logger: {
     info: (...args: unknown[]) => void;
     error: (...args: unknown[]) => void;

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -29626,11 +29626,40 @@ function extractOpenClawChatReply(result) {
   const payloadText = result.payloads?.filter((payload) => !payload.isError && !payload.isReasoning && !payload.isCommentary).map((payload) => payload.text?.trim()).filter((text) => Boolean(text)).join("\n\n").trim();
   return payloadText || null;
 }
+function stripPerkosChatTransportMarker(reply, convId) {
+  const marker = `[PERKOS_CHAT:${convId}]`;
+  return reply.split(marker).join("").trim();
+}
 function openclawAgentId(config) {
   const sessionKey = config.runtime?.sessionKey || "agent:main";
   const parts = sessionKey.split(":");
   return parts[0] === "agent" && parts[1] ? parts[1] : "main";
 }
+function parseOpenClawModelRef(value) {
+  const modelRef = typeof value === "string" ? value.trim() : value && typeof value === "object" && typeof value.primary === "string" ? String(value.primary).trim() : "";
+  const separator = modelRef.indexOf("/");
+  if (separator <= 0 || separator >= modelRef.length - 1) return null;
+  return {
+    provider: modelRef.slice(0, separator),
+    model: modelRef.slice(separator + 1)
+  };
+}
+function resolveOpenClawRuntimeModelRoute(runtimeConfig, agentId, explicitPluginOverride) {
+  const explicit = parseOpenClawModelRef(explicitPluginOverride);
+  if (explicit) return { ...explicit, source: "plugin-override" };
+  if (!runtimeConfig || typeof runtimeConfig !== "object") return null;
+  const agents = runtimeConfig.agents;
+  if (!agents || typeof agents !== "object") return null;
+  const agentConfig = agents;
+  const list = Array.isArray(agentConfig.list) ? agentConfig.list : [];
+  const selectedAgent = list.find((entry) => entry && typeof entry === "object" && String(entry.id ?? "").trim() === agentId);
+  const selected = parseOpenClawModelRef(selectedAgent?.model);
+  if (selected) return { ...selected, source: "agent-default" };
+  const defaults = agentConfig.defaults;
+  if (!defaults || typeof defaults !== "object") return null;
+  const gateway = parseOpenClawModelRef(defaults.model);
+  return gateway ? { ...gateway, source: "gateway-default" } : null;
+}
 async function runOpenClawChatTurn(api, config, sessionKey, prompt, transcriptPrompt, logger) {
   const runEmbeddedAgent = api.runtime?.agent?.runEmbeddedAgent;
   const currentConfig = api.runtime?.config?.current;
@@ -29641,6 +29670,11 @@ async function runOpenClawChatTurn(api, config, sessionKey, prompt, transcriptPr
   }
   const agentId = openclawAgentId(config);
   const runtimeConfig = currentConfig();
+  const runtimeRoute = resolveOpenClawRuntimeModelRoute(
+    runtimeConfig,
+    agentId,
+    config.runtime?.model
+  );
   const workspaceDir = resolveAgentWorkspaceDir(runtimeConfig, agentId);
   const sessionContext = readOpenClawChatSession(api, agentId, sessionKey);
   const entry = sessionContext.entry;
@@ -29650,8 +29684,13 @@ async function runOpenClawChatTurn(api, config, sessionKey, prompt, transcriptPr
     75e3,
     typeof configuredTimeout === "number" && configuredTimeout > 0 ? configuredTimeout : 75e3
   );
-  let selectedProvider;
-  let selectedModel;
+  let selectedProvider = runtimeRoute?.provider;
+  let selectedModel = runtimeRoute?.model;
+  if (runtimeRoute) {
+    logger.info(
+      `[perkos-chat] using OpenClaw runtime-owned route ${runtimeRoute.provider}/${runtimeRoute.model} (${runtimeRoute.source})`
+    );
+  }
   const run = async (configOverride, retryNative = false) => runEmbeddedAgent({
     sessionId,
     sessionKey,
@@ -29670,6 +29709,7 @@ async function runOpenClawChatTurn(api, config, sessionKey, prompt, transcriptPr
     terminalReplyExpectation: "required",
     suppressLiveStreamOutput: true,
     cleanupBundleMcpOnRunEnd: true,
+    ...selectedProvider && selectedModel ? { provider: selectedProvider, model: selectedModel } : {},
     onExecutionPhase: (info) => {
       if (info.provider?.trim()) selectedProvider = info.provider.trim();
       if (info.model?.trim()) selectedModel = info.model.trim();
@@ -30032,7 +30072,8 @@ function register(api) {
     const chatSessionKey = openclawChatSessionKey(pluginConfig, frame.convId);
     await prepareOpenClawChatSession(api, pluginConfig, chatSessionKey, logger);
     if (walletAddress) {
-      const reply = await runOpenClawChatTurn(api, pluginConfig, chatSessionKey, directRunPrompt, frame.text, logger);
+      const embeddedReply = await runOpenClawChatTurn(api, pluginConfig, chatSessionKey, directRunPrompt, frame.text, logger);
+      const reply = embeddedReply ? stripPerkosChatTransportMarker(embeddedReply, frame.convId) : null;
       if (reply) {
         const result = await supervisorClient.sendChatReply({
           convId: frame.convId,
@@ -30043,6 +30084,9 @@ function register(api) {
         logger.info(`[perkos-chat] embedded reply ${result.delivered ? "delivered" : "queued (offline)"} for ${frame.convId}`);
         return;
       }
+      if (embeddedReply) {
+        logger.error(`[perkos-chat] embedded OpenClaw reply contained only transport metadata for ${frame.convId}`);
+      }
     }
     if (enqueueSystemEvent) enqueueSystemEvent(eventText, { sessionKey: chatSessionKey });
     wakeGatewayAgent(requestHeartbeatNow, `[PerkOS-Chat] inbound message in ${frame.convId}`, logger, chatSessionKey);
@@ -30507,7 +30551,9 @@ export {
   omitUnavailableAgentHarness,
   openclawChatSessionKey,
   prepareOpenClawChatSession,
+  resolveOpenClawRuntimeModelRoute,
   runOpenClawChatTurn,
+  stripPerkosChatTransportMarker,
   useNativeHarnessForResolvedRoute
 };
 /*! Bundled license information: