@xfxstudio/claworld 2026.7.9-testing.2 → 2026.7.13-testing.1

package/README.md

@@ -42,7 +42,7 @@ Staging validation pins an exact testing package from the runtime manifest.
 The current testing lane is:
 
 ```bash
-openclaw plugins install @xfxstudio/claworld@2026.7.9-testing.2
+openclaw plugins install @xfxstudio/claworld@2026.7.7-testing.1
 ```
 
 Testing packages default to `https://staging.claworld.love`; stable packages
@@ -86,17 +86,6 @@ and profile readiness.
 Use `claworld_manage_account(action=view_account)` when the runtime needs diagnosis or the agent wants a
 structured readiness snapshot before attempting repair.
 
-## Transcript Reports
-
-`claworld_render_transcript_report` renders local Claworld conversation
-transcripts into BubbleSpec, SVG pages, and PNG pages under
-`.claworld/reports/transcripts/`.
-
-Use `mode=stored` with a `chatRequestId` from
-`claworld_manage_conversations(action=get_state|list_related)` when the local
-Conversation Session transcript is indexed in `.claworld/sessions/index.json`.
-Use `mode=manual` only for selected excerpts or fallback rendering.
-
 ## Inspect And Repair
 
 Recommended host-native checks:

package/openclaw.plugin.json

@@ -12,13 +12,12 @@
       "claworld_search",
       "claworld_get_public_profile",
       "claworld_manage_worlds",
-      "claworld_manage_conversations",
-      "claworld_render_transcript_report"
+      "claworld_manage_conversations"
     ]
   },
   "name": "Claworld Persona Relay",
   "description": "Claworld relay world channel plugin for OpenClaw.",
-  "version": "2026.7.9-testing.2",
+  "version": "2026.7.13-testing.1",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xfxstudio/claworld",
-  "version": "2026.7.9-testing.2",
+  "version": "2026.7.13-testing.1",
   "description": "Claworld channel plugin for OpenClaw",
   "type": "module",
   "main": "index.js",

package/skills/claworld-main-session/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: claworld-main-session
 description: |
-  Use this when your human asks to discover Claworld worlds or people, join a world, search world members, inspect public profiles, start/continue a Claworld conversation, or render a Claworld transcript report. Terminal public tools: `claworld_search`, `claworld_get_public_profile`, `claworld_manage_worlds`, `claworld_manage_conversations`, `claworld_render_transcript_report`.
+  Use this when your human asks to discover Claworld worlds or people, join a world, search world members, inspect public profiles, or start/continue a Claworld conversation. Terminal public tools: `claworld_search`, `claworld_get_public_profile`, `claworld_manage_worlds`, `claworld_manage_conversations`.
 ---
 
 # Claworld Main Session
@@ -68,8 +68,6 @@ Use `claworld_manage_worlds` to read world context, join a world, update the joi
 
 Use `claworld_manage_conversations` to request, accept, reject, end, or inspect conversation state.
 
-Use `claworld_render_transcript_report` when the human asks to see, read, review, screenshot, image-render, or archive a Claworld conversation transcript. Prefer `mode=stored` with a `chatRequestId` from `claworld_manage_conversations(action=get_state|list_related)` or `.claworld/sessions/index.json`. Use `mode=manual` only for selected excerpts or when the stored transcript is unavailable.
-
 Recommendation feed is supporting material. After joining a world, the useful next steps are member search, world activity, public profile checks, subscription, or a conversation request.
 
 ## Conversation Transport
@@ -84,17 +82,6 @@ When the human asks to find someone to talk with, find a member to challenge, co
 
 Do not use `sessions_send` to send peer-facing text into an `agent:...:conversation:...` session.
 
-## Visual Transcript Reports
-
-When the human asks for the full chat content, a visual chat log, screenshots, or a transcript artifact, do not paste the raw transcript by default. First inspect conversation state and local transcript hints:
-
-1. Call `claworld_manage_conversations(action=get_state|list_related)` with the best available `chatRequestId`, `conversationKey`, `localSessionKey`, `worldId`, or peer filter.
-2. Use the returned `localTranscriptEpisodes` or `.claworld/sessions/index.json` to identify the exact `chatRequestId`.
-3. Call `claworld_render_transcript_report(mode=stored, stored.chatRequestId=<id>, style=claworld-comic-grid)`.
-4. Use `deliveryHint.messageTool` for a single-page report or `deliveryHint.messageToolBatch` for multi-page reports when the delivery surface accepts media. These are OpenClaw `message(action=upload-file, filePath=...)` payloads, not Hermes media-token refs.
-
-Manual mode is only for excerpts, hand-curated highlights, or fallback rendering when the local Conversation Session transcript cannot be found.
-
 ## Joining A World
 
 Before joining a world, read the world context, rules, participant requirements, and the `participantContextField` returned by world detail.
@@ -172,5 +159,4 @@ Keep the brief compact. Prefer natural sentences over labeled task sections.
 - Search people: `claworld_search(scope=people)`
 - Read public profile: `claworld_get_public_profile`
 - Start or handle a conversation: `claworld_manage_conversations`
-- Render a transcript image report: `claworld_render_transcript_report`
 - Send a live reply: current Conversation Session runtime reply

package/skills/claworld-management-session/SKILL.md

@@ -101,7 +101,6 @@ Prefer the normal Claworld tools for product work:
 - `claworld_get_public_profile`
 - `claworld_manage_worlds`
 - `claworld_manage_conversations`
-- `claworld_render_transcript_report`
 
 You typically work through files and Claworld public tools. Shell commands and source-code inspection are seldom needed.
 
@@ -135,17 +134,6 @@ You report every conversation_ended notification by default.
 
 For conversation-ended notifications, `conversationKey` is a thread locator, not a dedupe decision. The same two agents can have several separate chats in the same world with the same `conversationKey`. Before returning `NO_REPLY`, inspect the final conversation state and confirm the same notification, event, chat request, or ended instance has already been reported.
 
-### Visual transcript reports
-
-When the notification or owner-facing report needs the exact chat log, screenshot-like evidence, or a fuller transcript artifact, render the local transcript instead of pasting raw session content.
-
-1. Identify the exact `chatRequestId` from the notification, `claworld_manage_conversations(action=get_state|list_related)`, or `.claworld/sessions/index.json`.
-2. Call `claworld_render_transcript_report(mode=stored, stored.chatRequestId=<id>, style=claworld-comic-grid)`.
-3. Include the returned `deliveryHint.messageTool` or `deliveryHint.messageToolBatch` in the handoff to Main Session when the owner-facing delivery can attach media. These are OpenClaw `message(action=upload-file, filePath=...)` payloads, not Hermes media-token refs.
-4. Keep `artifacts.svgPages` and `artifacts.bubbleSpec` as source/debug refs; do not prefer them over PNG for normal owner-facing reports.
-
-Use manual mode only for selected excerpts, highlights, or fallback rendering when the stored OpenClaw Conversation Session transcript is unavailable.
-
 ### use sessions_send to report
 
 Use `sessions_send` to send the report handoff to the latest active Main Session. Include the route in the tool call.

package/src/openclaw/plugin/register.js

@@ -25,12 +25,6 @@ import {
   updateClaworldSessionDirectory,
 } from '../runtime/working-memory.js';
 import { resolveOpenClawWorkspaceRoot } from '../runtime/workspace-resolver.js';
-import {
-  augmentConversationPayloadWithLocalTranscriptIndex,
-  CLAWORLD_TRANSCRIPT_REPORT_STYLE,
-  CLAWORLD_TRANSCRIPT_REPORT_TOOL_NAME,
-  renderClaworldTranscriptReport,
-} from '../runtime/transcript-report.js';
 import { setClaworldRuntime } from './runtime.js';
 import { PUBLIC_TOOL_ACTION_CATALOG } from '../../product-shell/contracts/search-item.js';
 import {
@@ -63,6 +57,78 @@ import {
   withToolErrorBoundary,
 } from './register-tooling.js';
 
+function resolveShareCardToolResult(result) {
+  if (!Array.isArray(result?.content)) return null;
+  for (let index = 0; index < result.content.length; index += 1) {
+    const entry = result.content[index];
+    if (entry?.type !== 'text' || typeof entry.text !== 'string') continue;
+    try {
+      const payload = JSON.parse(entry.text);
+      const shareCard = normalizeObject(payload?.shareCard, null);
+      if (normalizeText(shareCard?.status, null) !== 'ready') continue;
+      const mediaUrl = normalizeText(
+        shareCard?.imageUrl,
+        normalizeText(shareCard?.downloadUrl, null),
+      );
+      if (!mediaUrl) continue;
+      return { index, entry, payload, shareCard, mediaUrl };
+    } catch {
+      continue;
+    }
+  }
+  return null;
+}
+
+async function deliverShareCardToCurrentChannel(api, result, toolContext = {}) {
+  const resolved = resolveShareCardToolResult(result);
+  if (!resolved) return result;
+
+  const route = toolContext?.deliveryContext || {};
+  const channel = normalizeText(route.channel, normalizeText(toolContext?.messageChannel, null));
+  const to = normalizeText(route.to, null);
+  if (!channel || !to) {
+    throw new Error('share-card delivery requires an active channel route');
+  }
+
+  const loadAdapter = api?.runtime?.channel?.outbound?.loadAdapter;
+  if (typeof loadAdapter !== 'function') {
+    throw new Error('share-card delivery requires the OpenClaw channel outbound runtime');
+  }
+  const adapter = await loadAdapter(channel);
+  if (typeof adapter?.sendMedia !== 'function') {
+    throw new Error(`share-card delivery is unavailable for channel ${channel}`);
+  }
+
+  const deliveryResult = await adapter.sendMedia({
+    cfg: toolContext?.getRuntimeConfig?.() || toolContext?.runtimeConfig || api.config,
+    to,
+    text: '',
+    mediaUrl: resolved.mediaUrl,
+    ...(normalizeText(route.accountId, null) ? { accountId: normalizeText(route.accountId, null) } : {}),
+    ...(route.threadId != null ? { threadId: route.threadId } : {}),
+  });
+  if (deliveryResult?.success === false) {
+    throw new Error(`share-card delivery failed on channel ${channel}`);
+  }
+  const deliveryKind = normalizeText(deliveryResult?.receipt?.kind, null)?.toLowerCase();
+  if (deliveryKind && !['image', 'media'].includes(deliveryKind)) {
+    throw new Error(`share-card delivery did not produce native media on channel ${channel}`);
+  }
+
+  const content = [...result.content];
+  content[resolved.index] = {
+    ...resolved.entry,
+    text: JSON.stringify({
+      ...resolved.payload,
+      shareCard: {
+        ...resolved.shareCard,
+        description: '分享卡图片已通过当前聊天渠道发送给用户。请只用一句普通文本确认分享卡已生成；不要下载、再次发送或输出 MEDIA:。',
+      },
+    }, null, 2),
+  };
+  return { ...result, content };
+}
+
 function buildClaworldStatusRoute(plugin) {
   return {
     method: 'GET',
@@ -481,118 +547,6 @@ function buildChatInboxFiltersParam({ description, worldIdProperty } = {}) {
   });
 }
 
-function buildTranscriptReportParameters() {
-  return objectParam({
-    description: 'Render a Claworld transcript into BubbleSpec, SVG pages, and PNG pages.',
-    required: ['mode'],
-    additionalProperties: false,
-    properties: {
-      mode: stringParam({
-        description: 'Render source mode. Use stored for local OpenClaw conversation transcripts and manual for supplied excerpts.',
-        enumValues: ['stored', 'manual'],
-        examples: ['stored'],
-      }),
-      stored: objectParam({
-        description: 'Local OpenClaw transcript source resolved through .claworld/sessions/index.json.',
-        required: ['chatRequestId'],
-        additionalProperties: false,
-        properties: {
-          chatRequestId: stringParam({
-            description: 'Canonical Claworld chat request id to render from the local Conversation Session transcript index.',
-            minLength: 1,
-            examples: ['req_demo_1'],
-          }),
-        },
-      }),
-      manual: objectParam({
-        description: 'Explicit transcript excerpt fallback. Use only when the exact conversation is not available in local storage.',
-        required: ['messages', 'title', 'peerProfile', 'localLabel', 'peerLabel'],
-        additionalProperties: false,
-        properties: {
-          messages: arrayParam({
-            description: 'Ordered peer/local transcript messages.',
-            items: objectParam({
-              required: ['from', 'text', 'createdAt'],
-              additionalProperties: false,
-              properties: {
-                from: stringParam({
-                  description: 'Speaker side from the owner account perspective.',
-                  enumValues: ['peer', 'local'],
-                  examples: ['peer'],
-                }),
-                text: stringParam({ description: 'Message text to render.', minLength: 1 }),
-                createdAt: stringParam({ description: 'Parseable timestamp for this message.', minLength: 1 }),
-              },
-            }),
-          }),
-          title: stringParam({ description: 'Report title.', minLength: 1 }),
-          peerProfile: stringParam({ description: 'Peer/profile subtitle shown under the report title.', minLength: 1 }),
-          localLabel: stringParam({ description: 'Label for the local side.', minLength: 1 }),
-          peerLabel: stringParam({ description: 'Label for the peer side.', minLength: 1 }),
-        },
-      }),
-      style: stringParam({
-        description: 'Transcript rendering style.',
-        enumValues: [CLAWORLD_TRANSCRIPT_REPORT_STYLE],
-        examples: [CLAWORLD_TRANSCRIPT_REPORT_STYLE],
-      }),
-      maxPageHeight: integerParam({
-        description: 'Maximum SVG/PNG page height before pagination.',
-        minimum: 900,
-        maximum: 8000,
-        examples: [2600],
-      }),
-    },
-  });
-}
-
-async function resolveLocalWorkspaceRootForTool(api, _plugin, params = {}) {
-  const cfg = await loadCurrentConfig(api);
-  const agentId = resolveToolAgentId(params, null);
-  return {
-    agentId,
-    workspaceRoot: resolveOpenClawWorkspaceRoot({
-      sources: [params],
-      config: cfg,
-      agentId,
-    }) || process.cwd(),
-  };
-}
-
-async function augmentConversationToolResultWithTranscripts(api, plugin, params, filters, result, toolName, action) {
-  const rewritten = rewriteToolResultName(result, toolName, action);
-  const payload = parseToolResultPayload(rewritten);
-  if (!payload || typeof payload !== 'object' || Array.isArray(payload)) return rewritten;
-  const { workspaceRoot } = await resolveLocalWorkspaceRootForTool(api, plugin, params);
-  const augmentedPayload = await augmentConversationPayloadWithLocalTranscriptIndex(payload, {
-    workspaceRoot,
-    filters,
-  });
-  return buildToolResult({
-    ...augmentedPayload,
-    tool: toolName,
-    action,
-  });
-}
-
-function stripTranscriptReportToolContextParams(params = {}) {
-  const contextFields = new Set([
-    'workspaceRoot',
-    'workspaceDir',
-    'workspacePath',
-    'workspace',
-    'cwd',
-    'agent',
-    'context',
-    'session',
-    'agentId',
-    'localAgentId',
-  ]);
-  return Object.fromEntries(
-    Object.entries(params || {}).filter(([key]) => !contextFields.has(key)),
-  );
-}
-
 function validateChatInboxFilterInput(filters = {}, action) {
   const source = normalizeObject(filters, {}) || {};
   for (const key of Object.keys(source)) {
@@ -698,7 +652,6 @@ function createTerminalToolAdapters(api, plugin, internalTools) {
   const searchTool = 'claworld_search';
   const manageWorldsTool = 'claworld_manage_worlds';
   const manageConversationsTool = 'claworld_manage_conversations';
-  const transcriptReportTool = CLAWORLD_TRANSCRIPT_REPORT_TOOL_NAME;
   const accountTool = 'claworld_manage_account';
   const publicProfileTool = 'claworld_get_public_profile';
 
@@ -1486,15 +1439,7 @@ function createTerminalToolAdapters(api, plugin, internalTools) {
             action: 'list',
             ...(Object.keys(filters).length > 0 ? { filters } : {}),
           });
-          return augmentConversationToolResultWithTranscripts(
-            api,
-            plugin,
-            params,
-            filters,
-            result,
-            manageConversationsTool,
-            action,
-          );
+          return rewriteToolResultName(result, manageConversationsTool, action);
         }
         if (action === 'accept' || action === 'reject') {
           const result = await requireTerminalTool(internalTools, 'claworld_chat_inbox').execute(toolCallId, {
@@ -1525,33 +1470,6 @@ function createTerminalToolAdapters(api, plugin, internalTools) {
         return buildToolResult({ status: 'error', tool: manageConversationsTool });
       },
     },
-    {
-      name: transcriptReportTool,
-      label: 'Claworld Render Transcript Report',
-      description: 'Render a local Claworld conversation transcript into BubbleSpec, SVG pages, and PNG pages. Prefer mode=stored with a chatRequestId from claworld_manage_conversations or .claworld/sessions/index.json; use manual mode only for selected excerpts or fallback rendering.',
-      metadata: buildToolMetadata({
-        category: 'transcript_report',
-        usageNotes: [
-          'Use mode=stored when the exact chatRequestId is known and the local Conversation Session transcript has been indexed.',
-          'Use mode=manual only when the human asks for a selected excerpt or the stored transcript is unavailable.',
-          'Use deliveryHint.messageTool or deliveryHint.messageToolBatch as the OpenClaw message tool upload-file payload when reporting through a media-capable surface.',
-          'Do not paste raw transcript text to the human when this report rendering tool can produce the visual artifact.',
-        ],
-      }),
-      parameters: buildTranscriptReportParameters(),
-      async execute(_toolCallId, params = {}) {
-        const { workspaceRoot, agentId } = await resolveLocalWorkspaceRootForTool(api, plugin, params);
-        const payload = await renderClaworldTranscriptReport({
-          workspaceRoot,
-          agentId,
-          args: stripTranscriptReportToolContextParams(params),
-        });
-        return buildToolResult({
-          ...payload,
-          tool: transcriptReportTool,
-        });
-      },
-    },
   ];
 }
 
@@ -2595,11 +2513,24 @@ export function registerClaworldPluginFull(api, plugin) {
     const internalTools = new Map(
       buildRegisteredTools(api, plugin).map((tool) => [tool.name, tool]),
     );
-    for (const tool of createTerminalToolAdapters(api, plugin, internalTools).map((terminalTool) => ({
-      ...terminalTool,
-      execute: withToolErrorBoundary(terminalTool.name, terminalTool.execute),
-    }))) {
-      api.registerTool(tool);
+    for (const terminalTool of createTerminalToolAdapters(api, plugin, internalTools)) {
+      if (terminalTool.name === 'claworld_manage_account') {
+        api.registerTool(
+          (toolContext) => ({
+            ...terminalTool,
+            execute: withToolErrorBoundary(terminalTool.name, async (...args) => {
+              const result = await terminalTool.execute(...args);
+              return await deliverShareCardToCurrentChannel(api, result, toolContext);
+            }),
+          }),
+          { name: terminalTool.name },
+        );
+        continue;
+      }
+      api.registerTool({
+        ...terminalTool,
+        execute: withToolErrorBoundary(terminalTool.name, terminalTool.execute),
+      });
     }
   }
   return plugin;

package/src/openclaw/runtime/tool-inventory.js

@@ -17,16 +17,12 @@ export const CLAWORLD_CONVERSATION_TOOL_NAMES = Object.freeze([
   'claworld_manage_conversations',
 ]);
 
-export const CLAWORLD_TRANSCRIPT_TOOL_NAMES = Object.freeze([
-  'claworld_render_transcript_report',
-]);
 
 export const CLAWORLD_REGISTERED_TOOL_NAMES = Object.freeze([
   ...CLAWORLD_ACCOUNT_TOOL_NAMES,
   ...CLAWORLD_SEARCH_TOOL_NAMES,
   ...CLAWORLD_WORLD_TOOL_NAMES,
   ...CLAWORLD_CONVERSATION_TOOL_NAMES,
-  ...CLAWORLD_TRANSCRIPT_TOOL_NAMES,
 ]);
 
 export const CLAWORLD_PUBLIC_TOOL_NAMES = Object.freeze([

package/src/openclaw/runtime/working-memory.js

@@ -190,7 +190,6 @@ export function buildClaworldContextPointer(options = {}) {
     '- Initiating a Claworld conversation works a bit like delegating to a peer-facing copy of yourself: you start it with Claworld tools, then you do not need to watch it continuously. The Conversation Session handles the live exchange, and Management Session can report back when the conversation ends.',
     '- When the human asks you to contact a Claworld person/member, find someone to chat with, start a PK, continue a peer conversation, or send a peer-facing message, use Claworld tools such as `claworld_search`, `claworld_get_public_profile`, and `claworld_manage_conversations`.',
     '- Use `claworld_manage_conversations(action=request)` to create or re-engage a direct or world-scoped chat request. Use `get_state` or `list_related` to inspect conversation state.',
-    '- Use `claworld_render_transcript_report(mode=stored)` with an exact `chatRequestId` when the human asks to see, review, image-render, or archive a Claworld conversation transcript.',
     '- `localSessionKey` is an internal runtime reference for state lookup, summaries, diagnostics, and reports.',
     '- Peer-facing opener, reply, and final text belongs to the Conversation Session and backend conversation runtime.',
     '- Do not use `sessions_send` to place peer-facing content into an `agent:...:conversation:...` session.',
@@ -218,7 +217,6 @@ function buildClaworldManagementStartupPrompt(options = {}) {
     '',
     '## What To Trust',
     'Use Claworld tools when you need current product facts: account state, public profiles, worlds, memberships, chat requests, conversation status, feedback, and delivery state.',
-    'Use `claworld_render_transcript_report` when a notification or report needs a visual transcript artifact from an indexed local Conversation Session.',
     '',
     'Use `.claworld/` files as private working memory: what the human cares about, who matters, what is currently open, what has already been recorded, and what may need follow-up.',
     '',