@perkos/perkos-a2a 0.12.40 → 0.12.42

package/dist/index.d.ts

@@ -25,6 +25,12 @@ type OpenClawSessionEntry = Record<string, unknown>;
  * whose default model metadata can reference a plugin harness that is absent.
  */
 export declare function omitUnavailableAgentHarness(value: unknown, unavailableHarnessId: string): unknown;
+/**
+ * Select OpenClaw's built-in harness for the route OpenClaw itself resolved.
+ * This changes no provider/model selection: the temporary policy is scoped to
+ * that exact runtime-owned route and exists only for this retry.
+ */
+export declare function useNativeHarnessForResolvedRoute(value: unknown, provider?: string, model?: string): unknown;
 /**
  * Remove model and harness selections persisted by an earlier chat wake so
  * the next turn resolves the gateway's current default. A configured plugin
@@ -32,6 +38,10 @@ export declare function omitUnavailableAgentHarness(value: unknown, unavailableH
  * model, without imposing a provider on every invited agent.
  */
 export declare function alignOpenClawChatSessionModel(entry: OpenClawSessionEntry, configuredModel?: string): OpenClawSessionEntry;
+export declare function prepareOpenClawChatSession(api: any, config: A2APluginConfig, sessionKey: string, logger: {
+    info: (...args: unknown[]) => void;
+    error: (...args: unknown[]) => void;
+}): Promise<void>;
 type EmbeddedChatRunResult = {
     payloads?: Array<{
         text?: string;
@@ -45,6 +55,19 @@ type EmbeddedChatRunResult = {
     };
 };
 export declare function extractOpenClawChatReply(result: EmbeddedChatRunResult): string | null;
+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":"AAAA;;;;;;;;GAQG;AAaH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAGV,WAAW,EAEZ,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,cAAc,YAAY,CAAC;AA0C3B,kEAAkE;AAClE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAItF;AAED,KAAK,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AASpD;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,OAAO,EACd,oBAAoB,EAAE,MAAM,GAC3B,OAAO,CA2BT;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,oBAAoB,EAC3B,eAAe,CAAC,EAAE,MAAM,GACvB,oBAAoB,CA+BtB;AAiED,KAAK,qBAAqB,GAAG;IAC3B,QAAQ,CAAC,EAAE,KAAK,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,YAAY,CAAC,EAAE,OAAO,CAAC;KACxB,CAAC,CAAC;IACH,IAAI,CAAC,EAAE;QACL,yBAAyB,CAAC,EAAE,MAAM,CAAC;QACnC,qBAAqB,CAAC,EAAE,MAAM,CAAC;KAChC,CAAC;CACH,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI,CAYrF;AAQD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE;IAAE,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAA;CAAE,GAClF,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuFxB;AAYD,oFAAoF;AACpF,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,WAAW,EAAE,EACvB,gBAAgB,EAAE,MAAM,GACvB,MAAM,CAWR;AA4CD,8EAA8E;AAC9E,wBAAgB,eAAe,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAe/D;AAMD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAc7E;AAED,MAAM,CAAC,OAAO,UAAU,QAAQ,CAAC,GAAG,EAAE,GAAG,QAszBxC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -29443,6 +29443,58 @@ function openclawChatSessionKey(config, convId) {
   const safe = convId.replace(/[^a-zA-Z0-9_.-]/g, "-").slice(0, 120) || "unknown";
   return `${configured}:perkos-chat-${safe}`;
 }
+async function mutateOpenClawChatSession(api, config, sessionKey, update) {
+  const sessionApi = api.runtime?.agent?.session;
+  const patchSessionEntry = sessionApi?.patchSessionEntry;
+  if (typeof patchSessionEntry === "function") {
+    await patchSessionEntry({
+      sessionKey,
+      fallbackEntry: { sessionId: randomUUID7(), updatedAt: Date.now() },
+      preserveActivity: true,
+      replaceEntry: true,
+      update
+    });
+    return "modern";
+  }
+  const resolveStorePath = sessionApi?.resolveStorePath;
+  const updateSessionStore = sessionApi?.updateSessionStore;
+  if (typeof resolveStorePath !== "function" || typeof updateSessionStore !== "function") {
+    return null;
+  }
+  const agentId = openclawAgentId(config);
+  const storePath = resolveStorePath(void 0, { agentId });
+  await updateSessionStore(
+    storePath,
+    (store) => {
+      const current = store[sessionKey] ?? { sessionId: randomUUID7(), updatedAt: Date.now() };
+      store[sessionKey] = update(current);
+      return store[sessionKey];
+    },
+    { activeSessionKey: sessionKey }
+  );
+  return "legacy";
+}
+function readOpenClawChatSession(api, agentId, sessionKey) {
+  const sessionApi = api.runtime?.agent?.session;
+  const modernEntry = sessionApi?.getSessionEntry?.({ agentId, sessionKey });
+  if (modernEntry && typeof modernEntry === "object") return { entry: modernEntry };
+  const resolveStorePath = sessionApi?.resolveStorePath;
+  const loadSessionStore = sessionApi?.loadSessionStore;
+  if (typeof resolveStorePath !== "function" || typeof loadSessionStore !== "function") {
+    return {};
+  }
+  try {
+    const storePath = resolveStorePath(void 0, { agentId });
+    const store = loadSessionStore(storePath, { skipCache: true, clone: true });
+    const entry = store?.[sessionKey];
+    const sessionId = typeof entry?.sessionId === "string" ? entry.sessionId : void 0;
+    const resolveSessionFilePath = sessionApi?.resolveSessionFilePath;
+    const sessionFile = sessionId && typeof resolveSessionFilePath === "function" ? resolveSessionFilePath(sessionId, entry, { agentId, storePath }) : void 0;
+    return { entry, sessionFile };
+  } catch {
+    return {};
+  }
+}
 var MISSING_AGENT_HARNESS_RE = /Requested agent harness "([^"]+)" is not registered\./u;
 function missingAgentHarnessId(error) {
   const message = error instanceof Error ? error.message : String(error);
@@ -29466,6 +29518,33 @@ function omitUnavailableAgentHarness(value, unavailableHarnessId) {
   }
   return next;
 }
+function useNativeHarnessForResolvedRoute(value, provider, model) {
+  const selectedProvider = provider?.trim();
+  const selectedModel = model?.trim();
+  if (!value || typeof value !== "object" || !selectedProvider || !selectedModel) return value;
+  const source = value;
+  const agents = source.agents && typeof source.agents === "object" ? source.agents : {};
+  const defaults = agents.defaults && typeof agents.defaults === "object" ? agents.defaults : {};
+  const models = defaults.models && typeof defaults.models === "object" ? defaults.models : {};
+  const modelKey = selectedModel.includes("/") ? selectedModel : `${selectedProvider}/${selectedModel}`;
+  const modelEntry = models[modelKey] && typeof models[modelKey] === "object" ? models[modelKey] : {};
+  return {
+    ...source,
+    agents: {
+      ...agents,
+      defaults: {
+        ...defaults,
+        models: {
+          ...models,
+          [modelKey]: {
+            ...modelEntry,
+            agentRuntime: { id: "pi" }
+          }
+        }
+      }
+    }
+  };
+}
 function alignOpenClawChatSessionModel(entry, configuredModel) {
   const next = { ...entry };
   for (const key of [
@@ -29498,21 +29577,19 @@ function alignOpenClawChatSessionModel(entry, configuredModel) {
   return next;
 }
 async function prepareOpenClawChatSession(api, config, sessionKey, logger) {
-  const patchSessionEntry = api.runtime?.agent?.session?.patchSessionEntry;
-  if (typeof patchSessionEntry !== "function") {
-    logger.info("[perkos-chat] OpenClaw session metadata API unavailable \u2014 using gateway session defaults");
-    return;
-  }
   try {
-    await patchSessionEntry({
+    const source = await mutateOpenClawChatSession(
+      api,
+      config,
       sessionKey,
-      fallbackEntry: { sessionId: randomUUID7(), updatedAt: Date.now() },
-      preserveActivity: true,
-      replaceEntry: true,
-      update: (entry) => alignOpenClawChatSessionModel(entry, config.runtime?.model)
-    });
+      (entry) => alignOpenClawChatSessionModel(entry, config.runtime?.model)
+    );
+    if (!source) {
+      logger.info("[perkos-chat] OpenClaw session metadata API unavailable \u2014 using gateway session defaults");
+      return;
+    }
     logger.info(
-      config.runtime?.model ? `[perkos-chat] session ${sessionKey} pinned to ${config.runtime.model}` : `[perkos-chat] session ${sessionKey} aligned to the gateway's active default model`
+      config.runtime?.model ? `[perkos-chat] session ${sessionKey} pinned to ${config.runtime.model}` : `[perkos-chat] session ${sessionKey} aligned to the gateway's active default model (${source} session API)`
     );
   } catch (err) {
     logger.error(
@@ -29521,23 +29598,22 @@ async function prepareOpenClawChatSession(api, config, sessionKey, logger) {
   }
 }
 async function forceNativeOpenClawChatRuntime(api, config, sessionKey, logger) {
-  const patchSessionEntry = api.runtime?.agent?.session?.patchSessionEntry;
-  if (typeof patchSessionEntry !== "function") return;
   try {
-    await patchSessionEntry({
+    const source = await mutateOpenClawChatSession(
+      api,
+      config,
       sessionKey,
-      fallbackEntry: { sessionId: randomUUID7(), updatedAt: Date.now() },
-      preserveActivity: true,
-      replaceEntry: true,
-      update: (entry) => ({
+      (entry) => ({
         ...alignOpenClawChatSessionModel(entry, config.runtime?.model),
         // OpenClaw <= 2026.5.x calls its built-in runtime "pi". Newer
         // gateways normalize the alias to their native "openclaw" harness.
         agentRuntimeOverride: "pi",
         agentHarnessId: "pi"
       })
-    });
-    logger.info(`[perkos-chat] session ${sessionKey} retrying with the native OpenClaw harness`);
+    );
+    if (source) {
+      logger.info(`[perkos-chat] session ${sessionKey} retrying with the native OpenClaw harness (${source} session API)`);
+    }
   } catch (err) {
     logger.error(
       `[perkos-chat] failed to select native OpenClaw harness: ${err instanceof Error ? err.message : String(err)}`
@@ -29555,6 +29631,31 @@ function openclawAgentId(config) {
   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;
@@ -29565,20 +29666,34 @@ 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 entry = api.runtime?.agent?.session?.getSessionEntry?.({ agentId, sessionKey });
+  const sessionContext = readOpenClawChatSession(api, agentId, sessionKey);
+  const entry = sessionContext.entry;
   const sessionId = typeof entry?.sessionId === "string" && entry.sessionId.trim() ? entry.sessionId : randomUUID7();
   const configuredTimeout = api.runtime?.agent?.resolveAgentTimeoutMs?.(runtimeConfig);
   const timeoutMs = Math.min(
     75e3,
     typeof configuredTimeout === "number" && configuredTimeout > 0 ? configuredTimeout : 75e3
   );
+  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,
     agentId,
     workspaceDir,
     config: configOverride,
+    ...sessionContext.sessionFile ? { sessionFile: sessionContext.sessionFile } : {},
     prompt,
     transcriptPrompt,
     timeoutMs,
@@ -29590,6 +29705,11 @@ 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();
+    },
     ...retryNative ? {
       // Cross-version compatibility: 2026.5.x recognizes `pi`, while
       // current gateways recognize the explicit native runtime override.
@@ -29610,7 +29730,11 @@ async function runOpenClawChatTurn(api, config, sessionKey, prompt, transcriptPr
       );
       await forceNativeOpenClawChatRuntime(api, config, sessionKey, logger);
       result = await run(
-        omitUnavailableAgentHarness(runtimeConfig, unavailableHarnessId),
+        useNativeHarnessForResolvedRoute(
+          omitUnavailableAgentHarness(runtimeConfig, unavailableHarnessId),
+          selectedProvider,
+          selectedModel
+        ),
         true
       );
     }
@@ -30418,7 +30542,10 @@ export {
   normalizeOpenClawPluginConfig,
   omitUnavailableAgentHarness,
   openclawChatSessionKey,
-  runOpenClawChatTurn
+  prepareOpenClawChatSession,
+  resolveOpenClawRuntimeModelRoute,
+  runOpenClawChatTurn,
+  useNativeHarnessForResolvedRoute
 };
 /*! Bundled license information: