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

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.1
+openclaw plugins install @xfxstudio/claworld@2026.7.9-testing.2
 ```
 
 Testing packages default to `https://staging.claworld.love`; stable packages

package/openclaw.plugin.json

@@ -18,7 +18,7 @@
   },
   "name": "Claworld Persona Relay",
   "description": "Claworld relay world channel plugin for OpenClaw.",
-  "version": "2026.7.9-testing.1",
+  "version": "2026.7.9-testing.2",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

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

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

@@ -91,7 +91,7 @@ When the human asks for the full chat content, a visual chat log, screenshots, o
 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.primaryMedia` for a single-page report or `deliveryHint.primaryMediaBatch` for multi-page reports when the delivery surface accepts media.
+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.
 

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

@@ -141,7 +141,7 @@ When the notification or owner-facing report needs the exact chat log, screensho
 
 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.primaryMedia` or `deliveryHint.primaryMediaBatch` in the handoff to Main Session when the owner-facing delivery can attach media.
+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.

package/src/openclaw/plugin/register.js

@@ -575,6 +575,24 @@ async function augmentConversationToolResultWithTranscripts(api, plugin, params,
   });
 }
 
+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)) {
@@ -1516,7 +1534,7 @@ function createTerminalToolAdapters(api, plugin, internalTools) {
         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.',
-          'Attach deliveryHint.primaryMedia or deliveryHint.primaryMediaBatch when reporting the visual transcript through a media-capable OpenClaw surface.',
+          '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.',
         ],
       }),
@@ -1526,7 +1544,7 @@ function createTerminalToolAdapters(api, plugin, internalTools) {
         const payload = await renderClaworldTranscriptReport({
           workspaceRoot,
           agentId,
-          args: params,
+          args: stripTranscriptReportToolContextParams(params),
         });
         return buildToolResult({
           ...payload,

package/src/openclaw/runtime/transcript-report.js

@@ -695,12 +695,36 @@ function displayColumns(text) {
 function wrapText(text, maxColumns) {
   const source = String(text || '').replace(/\r/g, '').split('\n');
   const lines = [];
+  const pushHardWrappedToken = (token) => {
+    let current = '';
+    let columns = 0;
+    for (const char of String(token || '')) {
+      const charColumns = displayColumns(char);
+      if (current && columns + charColumns > maxColumns) {
+        lines.push(current);
+        current = '';
+        columns = 0;
+      }
+      current += char;
+      columns += charColumns;
+    }
+    if (current) lines.push(current);
+  };
   for (const paragraph of source) {
     let current = '';
     let columns = 0;
     const words = paragraph.includes(' ') ? paragraph.split(/(\s+)/) : [...paragraph];
     for (const word of words) {
       const wordColumns = displayColumns(word);
+      if (!/^\s+$/.test(word) && wordColumns > maxColumns) {
+        if (current) {
+          lines.push(current.trimEnd());
+          current = '';
+          columns = 0;
+        }
+        pushHardWrappedToken(word);
+        continue;
+      }
       if (current && columns + wordColumns > maxColumns) {
         lines.push(current.trimEnd());
         current = '';
@@ -742,12 +766,12 @@ function buildRenderItems(messages = []) {
 }
 
 function estimateMessageLayout(message) {
-  const maxColumns = message.side === 'local' ? 42 : 40;
+  const maxColumns = message.side === 'local' ? 36 : 36;
   const lines = wrapText(message.text, maxColumns);
   const tagRows = message.tags.length > 0 ? 1 : 0;
   const textWidth = Math.min(
-    440,
-    Math.max(160, Math.max(...lines.map(displayColumns), 10) * 8 + 34),
+    460,
+    Math.max(160, Math.max(...lines.map(displayColumns), 10) * 8.5 + 44),
   );
   const height = 24 + lines.length * 20 + tagRows * 25;
   return {
@@ -853,11 +877,9 @@ function renderSvgPage({ page, header, pageCount }) {
     parts.push(`<rect class="${bubbleClass}" x="${x}" y="${y + 14}" width="${width}" height="${height}" rx="16"/>`);
     const textX = x + 17;
     let textY = y + 40;
-    parts.push(`<text class="msg" x="${textX}" y="${textY}">`);
     for (const [index, line] of layout.lines.entries()) {
-      parts.push(`<tspan x="${textX}" dy="${index === 0 ? 0 : 20}">${escapeXml(line)}</tspan>`);
+      parts.push(`<text class="msg" x="${textX}" y="${textY + index * 20}">${escapeXml(line)}</text>`);
     }
-    parts.push('</text>');
     textY += layout.lines.length * 20 + 4;
     let tagX = textX;
     for (const tag of message.tags) {
@@ -1043,11 +1065,13 @@ async function writeArtifacts({ workspaceRoot, artifactId, spec, layout }) {
       page: page.page,
       format: 'png',
       path: pngPath,
+      filePath: pngPath,
+      filename: path.basename(pngPath),
+      mimeType: 'image/png',
       width: page.width,
       height: page.height,
       renderer,
       sha256: await hashFile(pngPath),
-      mediaRef: `MEDIA:${pngPath}`,
     });
   }
   return {
@@ -1061,6 +1085,19 @@ async function writeArtifacts({ workspaceRoot, artifactId, spec, layout }) {
   };
 }
 
+function buildOpenClawUploadArgs(page, message = null) {
+  if (!page?.path) return null;
+  return {
+    action: 'upload-file',
+    filePath: page.path,
+    path: page.path,
+    media: page.path,
+    filename: page.filename || path.basename(page.path),
+    mimeType: page.mimeType || 'image/png',
+    ...(message ? { message } : {}),
+  };
+}
+
 function buildDiagnostics({ sourceRecords, normalizedMessages, renderedMessages, source }) {
   return {
     source: {
@@ -1168,10 +1205,16 @@ export async function renderClaworldTranscriptReport({
     style: params.style,
     artifacts,
     deliveryHint: {
-      primaryMedia: artifacts.pngPages[0]?.mediaRef || null,
-      primaryMediaBatch: artifacts.pngPages.map((page) => page.mediaRef).join('\n'),
-      sourceSvgDocument: artifacts.svgPages[0] ? `[[as_document]]\nMEDIA:${artifacts.svgPages[0].path}` : null,
-      openClawMediaPaths: artifacts.pngPages.map((page) => page.path),
+      primaryFilePath: artifacts.pngPages[0]?.path || null,
+      imageFilePaths: artifacts.pngPages.map((page) => page.path),
+      sourceSvgFilePaths: artifacts.svgPages.map((page) => page.path),
+      messageTool: buildOpenClawUploadArgs(
+        artifacts.pngPages[0],
+        source.chatRequestId
+          ? `Claworld transcript report for ${source.chatRequestId}`
+          : 'Claworld transcript report',
+      ),
+      messageToolBatch: artifacts.pngPages.map((page) => buildOpenClawUploadArgs(page)).filter(Boolean),
     },
     diagnostics: buildDiagnostics({
       sourceRecords,