openclaw-openagent 1.0.9 → 1.0.12

package/src/app/remote-agent-tool.ts

@@ -206,14 +206,20 @@ function formatMediaDownloadLines(urls: string[]): string {
 function normalizeRemoteToolExecuteArgs(
   signalOrUpdate?: AbortSignal | ToolUpdateCallback,
   onUpdateOrContext?: ToolUpdateCallback | unknown,
-  legacySignal?: AbortSignal,
-): { signal?: AbortSignal; onUpdate?: ToolUpdateCallback; signature: string } {
+  contextOrSignal?: unknown,
+): { signal?: AbortSignal; onUpdate?: ToolUpdateCallback; context?: unknown; signature: string } {
+  const contextCandidate = (value: unknown): unknown | undefined => {
+    if (!value || typeof value !== 'object' || isAbortSignalLike(value)) return undefined;
+    return value;
+  };
+
   if (typeof signalOrUpdate === 'function') {
     return {
       onUpdate: signalOrUpdate,
-      signal: isAbortSignalLike(legacySignal)
-        ? legacySignal
+      signal: isAbortSignalLike(contextOrSignal)
+        ? contextOrSignal
         : getObjectSignal(onUpdateOrContext),
+      context: contextCandidate(onUpdateOrContext),
       signature: 'legacy:update-third',
     };
   }
@@ -222,7 +228,8 @@ function normalizeRemoteToolExecuteArgs(
     return {
       signal: isAbortSignalLike(signalOrUpdate) ? signalOrUpdate : undefined,
       onUpdate: onUpdateOrContext as ToolUpdateCallback,
-      signature: 'modern:signal-update',
+      context: contextCandidate(contextOrSignal),
+      signature: contextCandidate(contextOrSignal) ? 'modern:signal-update-context' : 'modern:signal-update',
     };
   }
 
@@ -233,15 +240,108 @@ function normalizeRemoteToolExecuteArgs(
   const nestedSignal =
     isAbortSignalLike(signalOrUpdate)
       ? signalOrUpdate
-      : getObjectSignal(onUpdateOrContext) || (isAbortSignalLike(legacySignal) ? legacySignal : undefined);
+      : getObjectSignal(onUpdateOrContext) || (isAbortSignalLike(contextOrSignal) ? contextOrSignal : undefined);
 
   return {
     signal: nestedSignal,
     onUpdate: nestedUpdate,
+    context: contextCandidate(contextOrSignal) || contextCandidate(onUpdateOrContext),
     signature: nestedUpdate ? 'context:update-callback' : 'unknown:no-update',
   };
 }
 
+function readNonEmptyString(value: unknown): string | undefined {
+  return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+
+function readRecord(value: unknown): Record<string, unknown> | undefined {
+  return value && typeof value === 'object' ? value as Record<string, unknown> : undefined;
+}
+
+function callStringGetter(target: unknown, methodName: string): string | undefined {
+  const record = readRecord(target);
+  const fn = record?.[methodName];
+  if (typeof fn !== 'function') return undefined;
+  try {
+    return readNonEmptyString(fn.call(target));
+  } catch {
+    return undefined;
+  }
+}
+
+function readNestedString(root: unknown, path: string[]): string | undefined {
+  let cur: unknown = root;
+  for (const key of path) {
+    const record = readRecord(cur);
+    if (!record) return undefined;
+    cur = record[key];
+  }
+  return readNonEmptyString(cur);
+}
+
+function resolveOpenclawSessionKey(context: unknown): string | undefined {
+  const ctx = readRecord(context);
+  if (!ctx) return undefined;
+
+  const sessionManager = ctx.sessionManager;
+  const managerSessionId = callStringGetter(sessionManager, 'getSessionId');
+  if (managerSessionId) return `session:${managerSessionId}`;
+
+  const directSessionId =
+    readNonEmptyString(ctx.sessionId) ||
+    readNonEmptyString(ctx.openclawSessionId) ||
+    readNonEmptyString(ctx.agentSessionId) ||
+    readNestedString(ctx, ['session', 'sessionId']);
+  if (directSessionId) return `session:${directSessionId}`;
+
+  const sessionFile =
+    callStringGetter(sessionManager, 'getSessionFile') ||
+    readNestedString(ctx, ['session', 'sessionFile']);
+  if (sessionFile) return `file:${sessionFile}`;
+
+  return undefined;
+}
+
+function getRememberedRemoteSessionId(
+  runtime: { store?: { getRemoteAgentSession?: (openclawSessionKey: string, targetAgentId: string) => string | null } | null },
+  openclawSessionKey: string | undefined,
+  agentId: string,
+): string | undefined {
+  if (!openclawSessionKey) return undefined;
+  try {
+    return runtime.store?.getRemoteAgentSession?.(openclawSessionKey, agentId) || undefined;
+  } catch (err) {
+    logger.warn(`[remote-tool] Failed to read remembered OASN session: ${(err as Error).message}`);
+    return undefined;
+  }
+}
+
+function rememberRemoteSessionId(
+  runtime: {
+    store?: {
+      upsertRemoteAgentSession?: (record: {
+        openclaw_session_key: string;
+        target_agent_id: string;
+        session_id: string;
+      }) => void;
+    } | null;
+  },
+  openclawSessionKey: string | undefined,
+  agentId: string,
+  sessionId: string | undefined,
+): void {
+  if (!openclawSessionKey || !sessionId) return;
+  try {
+    runtime.store?.upsertRemoteAgentSession?.({
+      openclaw_session_key: openclawSessionKey,
+      target_agent_id: agentId,
+      session_id: sessionId,
+    });
+  } catch (err) {
+    logger.warn(`[remote-tool] Failed to remember OASN session: ${(err as Error).message}`);
+  }
+}
+
 // ── Tool Factory ──
 
 /**
@@ -259,9 +359,9 @@ export function createCallRemoteAgentTool(): ToolDescriptor {
     label: 'Call Remote Agent',
     description:
       'Route a user request to a remote specialist Agent via the OpenAgent network. ' +
-      'TRIGGER: When the user message contains a {openagent_call_remote_agent:agent_id="...",agent_name="...",instruction="..."} marker, ' +
+      'TRIGGER: When the user message contains a {openagent_call_remote_agent:agent_id="...",agent_name="...",agent_bio="...",instruction="..."} marker, ' +
       'call this tool to forward the request to the specified remote Agent. ' +
-      'Extract agent_id and agent_name from the marker; use the remaining natural-language text as the task parameter. ' +
+      'Extract agent_id, agent_name, and optional agent_bio from the marker; use the remaining natural-language text as the task parameter. ' +
       'Do not display the raw marker to the user. ' +
       'mode "session" (default) preserves remote conversation history; mode "run" starts fresh — include full context in task.',
     parameters: {
@@ -275,6 +375,10 @@ export function createCallRemoteAgentTool(): ToolDescriptor {
           type: 'string',
           description: 'Display name of the remote Agent from the marker. Use this in your reply to the user.',
         },
+        agent_bio: {
+          type: 'string',
+          description: 'Short description of the remote Agent from the marker. Preserve it for UI display.',
+        },
         task: {
           type: 'string',
           description: 'The user\'s natural-language request text, excluding the marker.',
@@ -303,18 +407,18 @@ export function createCallRemoteAgentTool(): ToolDescriptor {
       params: ToolParams,
       signalOrUpdate?: AbortSignal | ToolUpdateCallback,
       onUpdateOrContext?: ToolUpdateCallback | unknown,
-      legacySignal?: AbortSignal,
+      contextOrSignal?: unknown,
     ): Promise<ToolResult> {
-      const { signal, onUpdate, signature } = normalizeRemoteToolExecuteArgs(
+      const { signal, onUpdate, context, signature } = normalizeRemoteToolExecuteArgs(
         signalOrUpdate,
         onUpdateOrContext,
-        legacySignal,
+        contextOrSignal,
       );
       logger.info(
         `[remote-tool] Execute args: toolCallId=${String(_id)} signature=${signature} ` +
           `hasSignal=${Boolean(signal)} hasOnUpdate=${Boolean(onUpdate)} ` +
           `third=${describeExecuteArg(signalOrUpdate)} fourth=${describeExecuteArg(onUpdateOrContext)} ` +
-          `fifth=${describeExecuteArg(legacySignal)}`,
+          `fifth=${describeExecuteArg(contextOrSignal)}`,
       );
 
       // ① Check runtime (same pattern as messaging-tools.ts)
@@ -334,7 +438,7 @@ export function createCallRemoteAgentTool(): ToolDescriptor {
 
       const agentId = String(params.agent_id || '').trim();
       const task = String(params.task || '').trim();
-      const mode = String(params.mode || 'session').trim();
+      const mode = String(params.mode || 'session').trim() === 'run' ? 'run' : 'session';
 
       // ② Validate required params
       if (!agentId) {
@@ -402,15 +506,20 @@ export function createCallRemoteAgentTool(): ToolDescriptor {
         const inputFileRefs: string[] | undefined = Array.isArray(params.input_file_refs)
           ? (params.input_file_refs as string[]).filter((r: unknown) => typeof r === 'string' && r.trim())
           : undefined;
+        const openclawSessionKey = resolveOpenclawSessionKey(context);
+        const rememberedSessionId = mode === 'session'
+          ? getRememberedRemoteSessionId(rt, openclawSessionKey, agentId)
+          : undefined;
+        if (mode === 'session' && !openclawSessionKey) {
+          logger.warn('[remote-tool] OASN session mode requested but OpenClaw session scope is unavailable');
+        }
 
         const taskReq: TaskRequest = {
           requestId,
           task,
+          sessionId: rememberedSessionId,
           inputFileRefs: inputFileRefs?.length ? inputFileRefs : undefined,
           timeoutMs: OASN_INVOCATION_TIMEOUT_MS,
-          // mode='session' 时不在协议层 join 已有 session（OASN 默认每次起新 Invocation）。
-          // 上游若需要保留对话历史，请在 task 文本里显式带 session_id；
-          // 暂不在工具层做 session 续传，避免误用导致跨用户串号。
         };
 
         let handle: TaskHandle;
@@ -424,6 +533,9 @@ export function createCallRemoteAgentTool(): ToolDescriptor {
           `[remote-tool] OASN invocation created: invocationId=${handle.invocationId} ` +
             `sessionId=${handle.sessionId ?? '-'} effectiveTimeoutMs=${handle.effectiveTimeoutMs ?? '-'}`,
         );
+        if (mode === 'session') {
+          rememberRemoteSessionId(rt, openclawSessionKey, agentId, handle.sessionId);
+        }
 
         try {
           const result = await oasnTransport.waitForTaskResult(handle, {
@@ -435,6 +547,9 @@ export function createCallRemoteAgentTool(): ToolDescriptor {
           const artifacts = result.artifacts ?? [];
           let content = result.content;
           let mediaUrls: string[] = [];
+          if (mode === 'session') {
+            rememberRemoteSessionId(rt, openclawSessionKey, agentId, result.webuiContinuation?.sessionId);
+          }
 
           if (!content.trim()) {
             for (const textArtifact of artifacts) {

package/src/app/types.ts

@@ -41,7 +41,7 @@ export interface ToolDescriptor {
    * Execute the tool.
    *
    * OpenClaw runtime usually calls:
-   *   tool.execute(toolCallId, params, signal, onUpdate)
+   *   tool.execute(toolCallId, params, signal, onUpdate, ctx)
    *
    * Older adapters used:
    *   tool.execute(toolCallId, params, onUpdate, ctx, signal)
@@ -56,7 +56,7 @@ export interface ToolDescriptor {
     params: ToolParams,
     signalOrUpdate?: AbortSignal | ToolUpdateCallback,
     onUpdateOrContext?: ToolUpdateCallback | unknown,
-    legacySignal?: AbortSignal,
+    contextOrSignal?: unknown,
   ) => Promise<ToolResult>;
 }
 

package/src/plugin-ui/adapters/oc-2026-04.js

@@ -0,0 +1,103 @@
+// ── OpenClaw 2026.4 host adapter ──
+// Host DOM: chat-tool-msg-collapse -> chat-tool-msg-body -> chat-tool-card.
+
+(function _clInstallHostAdapter202604() {
+  function _matches(node, selector) {
+    return !!(node && selector && node.matches && node.matches(selector));
+  }
+
+  var adapter = {
+    id: 'oc-2026-04',
+    family: '2026.4',
+    css: {
+      remoteShell: [
+        'details.chat-tool-msg-collapse:has(.cl-remote-agent-card)',
+        '.chat-tool-msg-collapse:has(.cl-remote-agent-card)',
+      ],
+      outputHostMargin: [],
+      outputHostMarginReset: [
+        'details.chat-tool-msg-collapse:has(.cl-remote-agent-card)',
+        '.chat-tool-msg-collapse:has(.cl-remote-agent-card)',
+      ],
+      summaryHidden: [
+        'details.chat-tool-msg-collapse:has(.cl-remote-agent-card) > summary.chat-tool-msg-summary',
+        '.chat-tool-msg-collapse:has(.cl-remote-agent-card) > .chat-tool-msg-summary',
+      ],
+      hostShellRawText: [
+        '.chat-tool-msg-body.cl-remote-agent-host-shell > .chat-text',
+      ],
+      rawTextCardHosts: [
+        '.chat-tool-msg-body:has(.cl-remote-agent-card) > .chat-text',
+        '.chat-tool-card__detail:has(.cl-remote-agent-card) > .chat-text',
+      ],
+      rawTextPlaceholderHosts: [
+        '.chat-tool-msg-body:has(.cl-remote-agent-output-placeholder) > .chat-text',
+        '.chat-tool-card__detail:has(.cl-remote-agent-output-placeholder) > .chat-text',
+      ],
+      hostBody: [
+        'details.chat-tool-msg-collapse:has(.cl-remote-agent-card) > .chat-tool-msg-body',
+        '.chat-tool-msg-collapse:has(.cl-remote-agent-card) > .chat-tool-msg-body',
+      ],
+      manualOpenReset: [
+        '.chat-tool-msg-collapse.chat-tool-msg-collapse--manual.is-open:has(.cl-remote-agent-card)',
+      ],
+      hostShellReset: [
+        '.cl-remote-agent-host-shell.chat-tool-card',
+        '.cl-remote-agent-host-shell.chat-tool-card__detail',
+        '.cl-remote-agent-host-shell.chat-tool-msg-body',
+        'details.cl-remote-agent-host-shell',
+      ],
+      hostShellSummary: [
+        '.cl-remote-agent-host-shell > summary.chat-tool-msg-summary',
+        '.cl-remote-agent-host-shell > .chat-tool-msg-summary',
+      ],
+      modernCardLayout: false,
+    },
+    nativeStyle: {
+      shellSelectors: [
+        '.chat-tool-card:not(:has(.cl-remote-agent-card))',
+        '.chat-tool-msg-collapse:not(:has(.cl-remote-agent-card))',
+      ],
+      summarySelectors: [
+        '.chat-tool-card__header',
+        '.chat-tool-card__title',
+        '.chat-tool-msg-summary:not(.cl-remote-agent-host-shell *)',
+      ],
+      indentSelectors: [
+        '.chat-group.tool:not(:has(.cl-remote-agent-card))',
+        '.chat-bubble:not(:has(.cl-remote-agent-card))',
+      ],
+    },
+    selectors: {
+      textContext: '.chat-text, .chat-tool-card__detail, .chat-tool-msg-body',
+      summary: ':scope > .chat-tool-msg-summary, .chat-tool-msg-summary',
+      forceOpenHeader: '.chat-tool-msg-summary',
+      rawTextHostClosest: [
+        '.chat-tool-msg-body',
+        '.chat-tool-card__detail',
+        '.chat-bubble',
+      ],
+      rawTextHostsWithinShell: '.chat-tool-msg-body, .chat-tool-card__detail, .chat-bubble',
+    },
+    isRemoteNativeToolShellCandidate: function(node) {
+      return _matches(node, 'details.chat-tool-msg-collapse, .chat-tool-msg-collapse, .chat-tool-card');
+    },
+    isNativeToolShell: function(node) {
+      return _matches(node, 'details.chat-tool-msg-collapse, .chat-tool-msg-collapse');
+    },
+    isToolLikeShell: function(node) {
+      return _matches(node, 'details.chat-tool-msg-collapse, .chat-tool-msg-collapse, .chat-tool-card, .chat-tool-msg-body, .chat-tool-card__detail');
+    },
+    isToolBody: function(node) {
+      return _matches(node, '.chat-tool-msg-body');
+    },
+    isMarkableHost: function(node) {
+      return _matches(node, 'details.chat-tool-msg-collapse, .chat-tool-card, .chat-tool-card__detail, .chat-tool-msg-body');
+    },
+  };
+
+  CL.hostAdapter = adapter;
+  try {
+    document.documentElement.setAttribute('data-openagent-host-adapter', adapter.id);
+  } catch (e) {}
+})();

package/src/plugin-ui/adapters/oc-2026-05.js

@@ -0,0 +1,125 @@
+// ── OpenClaw 2026.5 host adapter ──
+// Host DOM uses the newer tools-collapse family, with msg-collapse kept as a
+// compatible secondary path for mixed 2026.5 builds.
+
+(function _clInstallHostAdapter202605() {
+  function _matches(node, selector) {
+    return !!(node && selector && node.matches && node.matches(selector));
+  }
+
+  var adapter = {
+    id: 'oc-2026-05',
+    family: '2026.5',
+    css: {
+      remoteShell: [
+        'details.chat-tools-collapse:has(.cl-remote-agent-card)',
+        'details.chat-tool-msg-collapse:has(.cl-remote-agent-card)',
+        '.chat-tools-collapse:has(.cl-remote-agent-card)',
+        '.chat-tool-msg-collapse:has(.cl-remote-agent-card)',
+      ],
+      outputHostMargin: [
+        'details.chat-tools-collapse:has(.cl-output-card)',
+        '.chat-tools-collapse:has(.cl-output-card)',
+        'details.chat-tool-msg-collapse:has(.cl-remote-agent-card)',
+        '.chat-tool-msg-collapse:has(.cl-remote-agent-card)',
+      ],
+      outputHostMarginReset: [],
+      summaryHidden: [
+        'details.chat-tools-collapse:has(.cl-remote-agent-card) > summary.chat-tools-summary',
+        'details.chat-tool-msg-collapse:has(.cl-remote-agent-card) > summary.chat-tool-msg-summary',
+        '.chat-tools-collapse:has(.cl-remote-agent-card) > .chat-tools-summary',
+        '.chat-tool-msg-collapse:has(.cl-remote-agent-card) > .chat-tool-msg-summary',
+      ],
+      hostShellRawText: [
+        '.chat-tools-collapse__body.cl-remote-agent-host-shell > .chat-text',
+        '.chat-tool-msg-body.cl-remote-agent-host-shell > .chat-text',
+      ],
+      rawTextCardHosts: [
+        '.chat-tools-collapse__body:has(.cl-remote-agent-card) > .chat-text',
+        '.chat-tool-msg-body:has(.cl-remote-agent-card) > .chat-text',
+        '.chat-tool-card__detail:has(.cl-remote-agent-card) > .chat-text',
+      ],
+      rawTextPlaceholderHosts: [
+        '.chat-tools-collapse__body:has(.cl-remote-agent-output-placeholder) > .chat-text',
+        '.chat-tool-msg-body:has(.cl-remote-agent-output-placeholder) > .chat-text',
+        '.chat-tool-card__detail:has(.cl-remote-agent-output-placeholder) > .chat-text',
+      ],
+      hostBody: [
+        'details.chat-tools-collapse:has(.cl-remote-agent-card) > .chat-tools-collapse__body',
+        'details.chat-tool-msg-collapse:has(.cl-remote-agent-card) > .chat-tool-msg-body',
+        '.chat-tools-collapse:has(.cl-remote-agent-card) > .chat-tools-collapse__body',
+        '.chat-tool-msg-collapse:has(.cl-remote-agent-card) > .chat-tool-msg-body',
+      ],
+      manualOpenReset: [
+        '.chat-tool-msg-collapse.chat-tool-msg-collapse--manual.is-open:has(.cl-remote-agent-card)',
+      ],
+      hostShellReset: [
+        '.cl-remote-agent-host-shell.chat-tool-card',
+        '.cl-remote-agent-host-shell.chat-tool-card__detail',
+        '.cl-remote-agent-host-shell.chat-tools-collapse__body',
+        '.cl-remote-agent-host-shell.chat-tool-msg-body',
+        'details.cl-remote-agent-host-shell',
+      ],
+      hostShellSummary: [
+        '.cl-remote-agent-host-shell > summary.chat-tools-summary',
+        '.cl-remote-agent-host-shell > summary.chat-tool-msg-summary',
+        '.cl-remote-agent-host-shell > .chat-tools-summary',
+        '.cl-remote-agent-host-shell > .chat-tool-msg-summary',
+      ],
+      modernCardLayout: true,
+    },
+    nativeStyle: {
+      shellSelectors: [
+        '.chat-tool-card:not(:has(.cl-remote-agent-card))',
+        '.chat-tool-msg-collapse:not(:has(.cl-remote-agent-card))',
+        '.chat-tools-collapse:not(:has(.cl-remote-agent-card))',
+        '.tool-card:not(:has(.cl-remote-agent-card))',
+        '.chat-tool-card__wrapper:not(:has(.cl-remote-agent-card))',
+      ],
+      summarySelectors: [
+        '.chat-tool-card__header',
+        '.chat-tool-card__title',
+        '.chat-tool-msg-summary:not(.cl-remote-agent-host-shell *)',
+        '.chat-tools-summary:not(.cl-remote-agent-host-shell *)',
+        '.tool-card__header',
+        '.tool-card__title',
+      ],
+      indentSelectors: [
+        '.chat-group.tool:not(:has(.cl-remote-agent-card))',
+        '.chat-bubble:not(:has(.cl-remote-agent-card))',
+      ],
+    },
+    selectors: {
+      textContext: '.chat-text, .chat-tool-card__detail, .chat-tool-msg-body, .chat-tools-collapse__body',
+      summary: ':scope > summary, :scope > .chat-tools-summary, :scope > .chat-tool-msg-summary, .chat-tools-summary, .chat-tool-msg-summary',
+      forceOpenHeader: '.chat-tool-msg-summary, .chat-tools-summary',
+      rawTextHostClosest: [
+        '.chat-tools-collapse__body',
+        '.chat-tool-msg-body',
+        '.chat-tool-card__detail',
+        '.chat-bubble',
+      ],
+      rawTextHostsWithinShell: '.chat-tools-collapse__body, .chat-tool-msg-body, .chat-tool-card__detail, .chat-bubble',
+    },
+    isRemoteNativeToolShellCandidate: function(node) {
+      return _matches(node, 'details.chat-tools-collapse, details.chat-tool-msg-collapse, .chat-tools-collapse, .chat-tool-msg-collapse, .chat-tool-card');
+    },
+    isNativeToolShell: function(node) {
+      return _matches(node, 'details.chat-tools-collapse, details.chat-tool-msg-collapse, .chat-tools-collapse, .chat-tool-msg-collapse');
+    },
+    isToolLikeShell: function(node) {
+      return _matches(node, 'details.chat-tools-collapse, details.chat-tool-msg-collapse, .chat-tools-collapse, .chat-tool-msg-collapse, .chat-tool-card, .chat-tools-collapse__body, .chat-tool-msg-body, .chat-tool-card__detail');
+    },
+    isToolBody: function(node) {
+      return _matches(node, '.chat-tools-collapse__body, .chat-tool-msg-body');
+    },
+    isMarkableHost: function(node) {
+      return _matches(node, 'details.chat-tools-collapse, details.chat-tool-msg-collapse, .chat-tool-card, .chat-tool-card__detail, .chat-tools-collapse__body, .chat-tool-msg-body');
+    },
+  };
+
+  CL.hostAdapter = adapter;
+  try {
+    document.documentElement.setAttribute('data-openagent-host-adapter', adapter.id);
+  } catch (e) {}
+})();

package/src/plugin-ui/adapters/oc-2026-06.js

@@ -0,0 +1,125 @@
+// ── OpenClaw 2026.6 host adapter ──
+// 2026.6 uses the V2 OpenAgent card path and the newer tools-collapse host
+// structure. Selector values intentionally mirror the 2026.5 adapter.
+
+(function _clInstallHostAdapter202606() {
+  function _matches(node, selector) {
+    return !!(node && selector && node.matches && node.matches(selector));
+  }
+
+  var adapter = {
+    id: 'oc-2026-06',
+    family: '2026.6',
+    css: {
+      remoteShell: [
+        'details.chat-tools-collapse:has(.cl-remote-agent-card)',
+        'details.chat-tool-msg-collapse:has(.cl-remote-agent-card)',
+        '.chat-tools-collapse:has(.cl-remote-agent-card)',
+        '.chat-tool-msg-collapse:has(.cl-remote-agent-card)',
+      ],
+      outputHostMargin: [
+        'details.chat-tools-collapse:has(.cl-output-card)',
+        '.chat-tools-collapse:has(.cl-output-card)',
+        'details.chat-tool-msg-collapse:has(.cl-remote-agent-card)',
+        '.chat-tool-msg-collapse:has(.cl-remote-agent-card)',
+      ],
+      outputHostMarginReset: [],
+      summaryHidden: [
+        'details.chat-tools-collapse:has(.cl-remote-agent-card) > summary.chat-tools-summary',
+        'details.chat-tool-msg-collapse:has(.cl-remote-agent-card) > summary.chat-tool-msg-summary',
+        '.chat-tools-collapse:has(.cl-remote-agent-card) > .chat-tools-summary',
+        '.chat-tool-msg-collapse:has(.cl-remote-agent-card) > .chat-tool-msg-summary',
+      ],
+      hostShellRawText: [
+        '.chat-tools-collapse__body.cl-remote-agent-host-shell > .chat-text',
+        '.chat-tool-msg-body.cl-remote-agent-host-shell > .chat-text',
+      ],
+      rawTextCardHosts: [
+        '.chat-tools-collapse__body:has(.cl-remote-agent-card) > .chat-text',
+        '.chat-tool-msg-body:has(.cl-remote-agent-card) > .chat-text',
+        '.chat-tool-card__detail:has(.cl-remote-agent-card) > .chat-text',
+      ],
+      rawTextPlaceholderHosts: [
+        '.chat-tools-collapse__body:has(.cl-remote-agent-output-placeholder) > .chat-text',
+        '.chat-tool-msg-body:has(.cl-remote-agent-output-placeholder) > .chat-text',
+        '.chat-tool-card__detail:has(.cl-remote-agent-output-placeholder) > .chat-text',
+      ],
+      hostBody: [
+        'details.chat-tools-collapse:has(.cl-remote-agent-card) > .chat-tools-collapse__body',
+        'details.chat-tool-msg-collapse:has(.cl-remote-agent-card) > .chat-tool-msg-body',
+        '.chat-tools-collapse:has(.cl-remote-agent-card) > .chat-tools-collapse__body',
+        '.chat-tool-msg-collapse:has(.cl-remote-agent-card) > .chat-tool-msg-body',
+      ],
+      manualOpenReset: [
+        '.chat-tool-msg-collapse.chat-tool-msg-collapse--manual.is-open:has(.cl-remote-agent-card)',
+      ],
+      hostShellReset: [
+        '.cl-remote-agent-host-shell.chat-tool-card',
+        '.cl-remote-agent-host-shell.chat-tool-card__detail',
+        '.cl-remote-agent-host-shell.chat-tools-collapse__body',
+        '.cl-remote-agent-host-shell.chat-tool-msg-body',
+        'details.cl-remote-agent-host-shell',
+      ],
+      hostShellSummary: [
+        '.cl-remote-agent-host-shell > summary.chat-tools-summary',
+        '.cl-remote-agent-host-shell > summary.chat-tool-msg-summary',
+        '.cl-remote-agent-host-shell > .chat-tools-summary',
+        '.cl-remote-agent-host-shell > .chat-tool-msg-summary',
+      ],
+      modernCardLayout: true,
+    },
+    nativeStyle: {
+      shellSelectors: [
+        '.chat-tool-card:not(:has(.cl-remote-agent-card))',
+        '.chat-tool-msg-collapse:not(:has(.cl-remote-agent-card))',
+        '.chat-tools-collapse:not(:has(.cl-remote-agent-card))',
+        '.tool-card:not(:has(.cl-remote-agent-card))',
+        '.chat-tool-card__wrapper:not(:has(.cl-remote-agent-card))',
+      ],
+      summarySelectors: [
+        '.chat-tool-card__header',
+        '.chat-tool-card__title',
+        '.chat-tool-msg-summary:not(.cl-remote-agent-host-shell *)',
+        '.chat-tools-summary:not(.cl-remote-agent-host-shell *)',
+        '.tool-card__header',
+        '.tool-card__title',
+      ],
+      indentSelectors: [
+        '.chat-group.tool:not(:has(.cl-remote-agent-card))',
+        '.chat-bubble:not(:has(.cl-remote-agent-card))',
+      ],
+    },
+    selectors: {
+      textContext: '.chat-text, .chat-tool-card__detail, .chat-tool-msg-body, .chat-tools-collapse__body',
+      summary: ':scope > summary, :scope > .chat-tools-summary, :scope > .chat-tool-msg-summary, .chat-tools-summary, .chat-tool-msg-summary',
+      forceOpenHeader: '.chat-tool-msg-summary, .chat-tools-summary',
+      rawTextHostClosest: [
+        '.chat-tools-collapse__body',
+        '.chat-tool-msg-body',
+        '.chat-tool-card__detail',
+        '.chat-bubble',
+      ],
+      rawTextHostsWithinShell: '.chat-tools-collapse__body, .chat-tool-msg-body, .chat-tool-card__detail, .chat-bubble',
+    },
+    isRemoteNativeToolShellCandidate: function(node) {
+      return _matches(node, 'details.chat-tools-collapse, details.chat-tool-msg-collapse, .chat-tools-collapse, .chat-tool-msg-collapse, .chat-tool-card');
+    },
+    isNativeToolShell: function(node) {
+      return _matches(node, 'details.chat-tools-collapse, details.chat-tool-msg-collapse, .chat-tools-collapse, .chat-tool-msg-collapse');
+    },
+    isToolLikeShell: function(node) {
+      return _matches(node, 'details.chat-tools-collapse, details.chat-tool-msg-collapse, .chat-tools-collapse, .chat-tool-msg-collapse, .chat-tool-card, .chat-tools-collapse__body, .chat-tool-msg-body, .chat-tool-card__detail');
+    },
+    isToolBody: function(node) {
+      return _matches(node, '.chat-tools-collapse__body, .chat-tool-msg-body');
+    },
+    isMarkableHost: function(node) {
+      return _matches(node, 'details.chat-tools-collapse, details.chat-tool-msg-collapse, .chat-tool-card, .chat-tool-card__detail, .chat-tools-collapse__body, .chat-tool-msg-body');
+    },
+  };
+
+  CL.hostAdapter = adapter;
+  try {
+    document.documentElement.setAttribute('data-openagent-host-adapter', adapter.id);
+  } catch (e) {}
+})();

package/src/plugin-ui/adapters/oc-unknown.js

@@ -0,0 +1,48 @@
+// ── Unknown OpenClaw host adapter ──
+// Fail closed: render OpenAgent's own card, but do not apply host-structure
+// takeover selectors when the host version is not one of the supported series.
+
+(function _clInstallHostAdapterUnknown() {
+  function _false() { return false; }
+
+  var adapter = {
+    id: 'oc-unknown',
+    family: 'unknown',
+    css: {
+      remoteShell: [],
+      outputHostMargin: [],
+      outputHostMarginReset: [],
+      summaryHidden: [],
+      hostShellRawText: [],
+      rawTextCardHosts: [],
+      rawTextPlaceholderHosts: [],
+      hostBody: [],
+      manualOpenReset: [],
+      hostShellReset: [],
+      hostShellSummary: [],
+      modernCardLayout: false,
+    },
+    nativeStyle: {
+      shellSelectors: [],
+      summarySelectors: [],
+      indentSelectors: [],
+    },
+    selectors: {
+      textContext: '.chat-text',
+      summary: '',
+      forceOpenHeader: '',
+      rawTextHostClosest: [],
+      rawTextHostsWithinShell: '',
+    },
+    isRemoteNativeToolShellCandidate: _false,
+    isNativeToolShell: _false,
+    isToolLikeShell: _false,
+    isToolBody: _false,
+    isMarkableHost: _false,
+  };
+
+  CL.hostAdapter = adapter;
+  try {
+    document.documentElement.setAttribute('data-openagent-host-adapter', adapter.id);
+  } catch (e) {}
+})();