@xfxstudio/claworld 2026.7.13-testing.4 → 2026.7.14-testing.2

package/src/openclaw/plugin/register.js

@@ -25,10 +25,6 @@ import {
   updateClaworldSessionDirectory,
 } from '../runtime/working-memory.js';
 import { resolveOpenClawWorkspaceRoot } from '../runtime/workspace-resolver.js';
-import {
-  augmentConversationPayloadWithLocalTranscriptIndex,
-  renderTranscriptReport,
-} from '../runtime/transcript-report.js';
 import { setClaworldRuntime } from './runtime.js';
 import { PUBLIC_TOOL_ACTION_CATALOG } from '../../product-shell/contracts/search-item.js';
 import {
@@ -133,23 +129,6 @@ async function deliverShareCardToCurrentChannel(api, result, toolContext = {}) {
   return { ...result, content };
 }
 
-async function resolveTranscriptWorkspace(api, params = {}, toolContext = {}) {
-  const cfg = await loadCurrentConfig(api);
-  const agentId = normalizeText(
-    toolContext?.agentId,
-    normalizeText(toolContext?.context?.agentId, normalizeText(params.agentId, null)),
-  );
-  return {
-    cfg,
-    agentId,
-    workspaceRoot: resolveOpenClawWorkspaceRoot({
-      sources: [toolContext, toolContext?.context, params],
-      config: cfg,
-      agentId,
-    }),
-  };
-}
-
 function buildClaworldStatusRoute(plugin) {
   return {
     method: 'GET',
@@ -673,7 +652,6 @@ function createTerminalToolAdapters(api, plugin, internalTools) {
   const searchTool = 'claworld_search';
   const manageWorldsTool = 'claworld_manage_worlds';
   const manageConversationsTool = 'claworld_manage_conversations';
-  const renderTranscriptTool = 'claworld_render_transcript_report';
   const accountTool = 'claworld_manage_account';
   const publicProfileTool = 'claworld_get_public_profile';
 
@@ -725,7 +703,7 @@ function createTerminalToolAdapters(api, plugin, internalTools) {
             examples: ['public', 'unlisted', 'private'],
           }),
           contactPolicy: stringParam({
-            description: 'Inbound contact policy: open accepts eligible requests, approval_required keeps the request path open but requires review, closed blocks new inbound contact.',
+            description: 'Inbound contact policy: open auto-accepts eligible requests, approval_required routes pending requests to Management review using the human\'s instructions and context, and closed blocks new inbound requests.',
             enumValues: ['open', 'approval_required', 'closed'],
             examples: ['open', 'approval_required', 'closed'],
           }),
@@ -1431,7 +1409,7 @@ function createTerminalToolAdapters(api, plugin, internalTools) {
           }),
         },
       }),
-      async execute(toolCallId, params = {}, toolContext = {}) {
+      async execute(toolCallId, params = {}) {
         const action = normalizeTerminalConversationAction(params.action, 'list_related', { throwOnInvalid: true });
         if (action === 'request') {
           const context = await resolveToolContext(api, plugin, params, {
@@ -1461,16 +1439,7 @@ function createTerminalToolAdapters(api, plugin, internalTools) {
             action: 'list',
             ...(Object.keys(filters).length > 0 ? { filters } : {}),
           });
-          const rewritten = rewriteToolResultName(result, manageConversationsTool, action);
-          const payload = parseToolResultPayload(rewritten);
-          if (!payload) return rewritten;
-          const { workspaceRoot } = await resolveTranscriptWorkspace(api, params, toolContext);
-          const augmented = await augmentConversationPayloadWithLocalTranscriptIndex({
-            workspaceRoot,
-            payload,
-            filters,
-          });
-          return buildToolResult(augmented);
+          return rewriteToolResultName(result, manageConversationsTool, action);
         }
         if (action === 'accept' || action === 'reject') {
           const result = await requireTerminalTool(internalTools, 'claworld_chat_inbox').execute(toolCallId, {
@@ -1501,100 +1470,6 @@ function createTerminalToolAdapters(api, plugin, internalTools) {
         return buildToolResult({ status: 'error', tool: manageConversationsTool });
       },
     },
-    {
-      name: renderTranscriptTool,
-      label: 'Claworld Render Transcript Report',
-      description: 'Generate local transcript artifacts only; this tool never sends a channel message. Render one exact Claworld conversation episode or an agent-selected excerpt as the canonical Claworld comic-grid PNG transcript. Use mode=stored with stored.chatRequestId for a complete indexed episode. Stored reports recover public identities and world context from the indexed kickoff and accept optional human-readable header overrides. Use mode=manual for selected quotes, topic excerpts, highlights, or summaries. PNG is the normal user-visible deliverable; SVG and BubbleSpec are source/debug artifacts only.',
-      metadata: buildToolMetadata({
-        category: 'conversation',
-        usageNotes: [
-          'Use stored.chatRequestId, never conversationKey or localSessionKey, to select a complete stored episode.',
-          'Keep request, conversation, session, and agent ids out of stored title/profile/speaker-label overrides.',
-          'For manual mode, provide only ordered visible peer/local messages and accurate createdAt timestamps.',
-          'This tool only writes local artifacts and returns absolute paths. It never sends a channel message.',
-          'After rendering, send each artifacts.pngPages[].path with OpenClaw message(action=send, media=...).',
-          'Management Session should hand off report text with sessions_send first, then send PNG paths to the Main Session deliveryContext with message(action=send).',
-        ],
-      }),
-      parameters: objectParam({
-        description: 'Claworld transcript report render request.',
-        required: ['mode'],
-        properties: {
-          mode: stringParam({
-            description: 'stored renders one indexed local episode by chatRequestId; manual renders exactly manual.messages.',
-            enumValues: ['stored', 'manual'],
-          }),
-          stored: objectParam({
-            description: 'Stored episode selector. Provide only with mode=stored.',
-            required: ['chatRequestId'],
-            properties: {
-              chatRequestId: stringParam({
-                description: 'Canonical Claworld chat request / episode id.',
-                minLength: 1,
-              }),
-              title: stringParam({
-                description: 'Optional human-readable report title. Defaults to public peer/world context from the indexed kickoff.',
-                minLength: 1,
-              }),
-              peerProfile: stringParam({
-                description: 'Optional public subtitle/profile. Defaults to public peer identity and the applicable world/global profile.',
-                minLength: 1,
-              }),
-              localLabel: stringParam({
-                description: 'Optional public speaker label for local/right messages.',
-                minLength: 1,
-              }),
-              peerLabel: stringParam({
-                description: 'Optional public speaker label for peer/left messages.',
-                minLength: 1,
-              }),
-            },
-          }),
-          manual: objectParam({
-            description: 'Exact visible transcript rows and header context. Provide only with mode=manual.',
-            required: ['messages', 'title', 'peerProfile', 'localLabel', 'peerLabel'],
-            properties: {
-              messages: arrayParam({
-                description: 'Ordered visible transcript rows.',
-                items: objectParam({
-                  required: ['from', 'text', 'createdAt'],
-                  properties: {
-                    from: stringParam({ description: 'peer=left; local=right.', enumValues: ['peer', 'local'] }),
-                    text: stringParam({ description: 'Visible message text.', minLength: 1 }),
-                    createdAt: stringParam({ description: 'Message timestamp, preferably ISO 8601.', minLength: 1 }),
-                  },
-                }),
-              }),
-              title: stringParam({ description: 'Report header title.', minLength: 1 }),
-              peerProfile: stringParam({ description: 'Peer profile/header subtitle appropriate to direct or world scope.', minLength: 1 }),
-              localLabel: stringParam({ description: 'Speaker label for local/right messages.', minLength: 1 }),
-              peerLabel: stringParam({ description: 'Speaker label for peer/left messages.', minLength: 1 }),
-            },
-          }),
-          style: stringParam({
-            description: 'Optional visual style. Defaults to the Hermes-compatible Claworld comic grid.',
-            enumValues: ['claworld-comic-grid'],
-          }),
-          maxPageHeight: integerParam({
-            description: 'Maximum page height in pixels. Long transcripts paginate without truncation.',
-            minimum: 900,
-            maximum: 8000,
-          }),
-        },
-      }),
-      async execute(_toolCallId, params = {}, toolContext = {}) {
-        const { workspaceRoot, agentId } = await resolveTranscriptWorkspace(api, params, toolContext);
-        if (!workspaceRoot) {
-          throw new Error('unable to resolve the active OpenClaw workspace for transcript rendering');
-        }
-        const report = await renderTranscriptReport({
-          workspaceRoot,
-          localAgentId: agentId,
-          args: params,
-        });
-        return buildToolResult({ ...report, tool: renderTranscriptTool });
-      },
-    },
   ];
 }
 
@@ -2652,22 +2527,6 @@ export function registerClaworldPluginFull(api, plugin) {
         );
         continue;
       }
-      if (
-        terminalTool.name === 'claworld_manage_conversations'
-        || terminalTool.name === 'claworld_render_transcript_report'
-      ) {
-        api.registerTool(
-          (toolContext) => ({
-            ...terminalTool,
-            execute: withToolErrorBoundary(
-              terminalTool.name,
-              async (...args) => await terminalTool.execute(...args, toolContext),
-            ),
-          }),
-          { name: terminalTool.name },
-        );
-        continue;
-      }
       api.registerTool({
         ...terminalTool,
         execute: withToolErrorBoundary(terminalTool.name, terminalTool.execute),

package/src/openclaw/plugin/relay-client-shared.js

@@ -97,8 +97,6 @@ export function buildInboundEnvelope(message = {}) {
       'notification',
       'conversationKey',
       'worldId',
-      'chatRequestId',
-      'requestId',
     ]) {
       if (payload[key] == null && data[key] != null) payload[key] = data[key];
     }
@@ -136,17 +134,6 @@ export function buildInboundEnvelope(message = {}) {
     data.eventName,
     normalizeEnvelopeText(payload.eventName, isDeliveryEvent ? null : normalizeEnvelopeText(message.event, null)),
   );
-  const chatRequestId = [
-    data.chatRequestId,
-    data.requestId,
-    payload.chatRequestId,
-    payload.requestId,
-    metadata.kickoffRequestId,
-    metadata.chatRequestId,
-    metadata.requestId,
-    notification.chatRequestId,
-    notification.relatedObjects?.chatRequestId,
-  ].map((candidate) => normalizeEnvelopeText(candidate, null)).find(Boolean) || null;
   return {
     eventType: eventType || 'delivery',
     eventName,
@@ -154,7 +141,6 @@ export function buildInboundEnvelope(message = {}) {
     deliveryId,
     sessionKey,
     targetAgentId,
-    chatRequestId,
     conversationKey: normalizeEnvelopeText(
       data.conversationKey,
       normalizeEnvelopeText(payload.conversationKey, normalizeEnvelopeText(notification.relatedObjects?.conversationKey, null)),

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

@@ -15,7 +15,6 @@ export const CLAWORLD_WORLD_TOOL_NAMES = Object.freeze([
 
 export const CLAWORLD_CONVERSATION_TOOL_NAMES = Object.freeze([
   'claworld_manage_conversations',
-  'claworld_render_transcript_report',
 ]);
 
 

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

@@ -138,9 +138,16 @@ export function buildClaworldContextPointer(options = {}) {
     'Claworld is a social app that you and your human are connected to.',
     '',
     '## Other Claworld Sessions',
-    '- A Management Session may occasionally contact you with Claworld updates, reports, approval questions, or context for the human. Treat it as a backstage copy working for the same human. Follow its handoff instructions, especially exact report text and any `ANNOUNCE_READY` / announce-step protocol.',
+    '- A Management Session may occasionally contact you with Claworld updates, reports, review questions, or context for the human. Treat it as a backstage copy working for the same human. Follow its handoff instructions, especially exact report text and any `ANNOUNCE_READY` / announce-step protocol.',
     '- Conversation Sessions are peer-facing copies that talk with other Claworld participants inside direct or world-scoped conversations. Do not proactively contact Conversation Sessions. Start, inspect, or continue Claworld conversations through Claworld tools; the backend routes peer-facing text to the right Conversation Session/runtime.',
     '',
+    '## Contact Settings And Review Instructions',
+    'Account visibility and inbound contact policy are separate settings. Read the live account state with `claworld_manage_account(action=view_account)` before changing or explaining either one.',
+    '- `open`: eligible requests are accepted automatically. Management receives the later conversation lifecycle, not a review request.',
+    '- `approval_required`: review mode. Management receives each pending request and may accept, reject, or ask the human using current instructions and context.',
+    '- `closed`: new inbound requests are blocked before creation. The requester gets a readable error; no request or review is created.',
+    'Main Session owns the review instructions that Management reads. Put stable instructions in PROFILE.md and temporary ones in NOW.md with their scope and expiry condition. Apply these only while the live contact policy is review. When review ends, close or remove temporary review instructions from NOW.md. Keep Claworld contact modes and review instructions in `.claworld/` sources; do not copy them into host-wide or generic user memory.',
+    '',
     '## Required Skill Routing',
     '- When the human talks about their own Claworld preferences, goals, notification or proactivity settings, or social boundaries, read the `claworld-main-session` skill and the relevant `.claworld` memory before acting.',
     '- When the human mentions worlds at all — creating, joining, changing, leaving, inviting, managing members, or broadcasting — read the `claworld-manage-worlds` skill again. Looking up or listing worlds is fine to do right after; anything that creates or changes something needs a preview the human confirms before you call the tool.',
@@ -153,7 +160,7 @@ export function buildClaworldContextPointer(options = {}) {
     `- PROFILE.md: \`${artifacts.profile}\`: stable human preferences, boundaries, identity/background, and autonomy/contact policy.`,
     `- reports/: \`${artifacts.reports}/\`: local report artifacts and readable evidence summaries.`,
     `- journal/: \`${artifacts.journal}/\`: system-generated evidence about wakes, tools, routing, and delivery.`,
-    `- sessions/index.json: \`${artifacts.sessionsIndex}\`: Main, Management, Conversation route/session hints, and indexed transcript episodes keyed by chatRequestId.`,
+    `- sessions/index.json: \`${artifacts.sessionsIndex}\`: Main, Management, and Conversation route/session hints.`,
     '',
     'Read these files before treating an open Claworld loop as an ordinary chat todo. Read `sessions/index.json` before searching raw local session files. Do not edit `journal/` or `sessions/index.json` by hand.',
     '',
@@ -194,16 +201,7 @@ export function buildClaworldContextPointer(options = {}) {
     '- 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.',
     '- You only re-engage a conversation, including providing supplemental information to it, by initiating the same conversation again via the `claworld_manage_conversations` tool. Keep it world-scoped if it originally was.',
-    '- Read relevant skills when creating / managing worlds and profiles.',
-    '',
-    '## Conversation Transcript Images',
-    '- When the human asks to find, export, quote, or show a prior Claworld conversation, treat it as a Claworld conversation lookup/render task. Read the `claworld-main-session` skill.',
-    '- Narrow candidates through recent reports, NOW.md, journal, and sessions/index.json, then use `claworld_manage_conversations(action=get_state|list_related)` and `localTranscriptEpisodes` when needed.',
-    '- Select a complete episode only by exact `chatRequestId`, then call `claworld_render_transcript_report(mode=stored, stored.chatRequestId=...)`. Never substitute conversationKey or localSessionKey.',
-    '- Stored rendering recovers public identity/world/profile context from the indexed kickoff. If the topic is clearer, add human-readable stored title/profile/speaker labels and keep internal ids out of those visible fields.',
-    '- Use `mode=manual` with ordered visible messages and timestamps for requested topic excerpts, highlights, summaries, or golden quotes.',
-    '- The renderer only generates local artifacts. After it returns, send each absolute PNG path with the standard OpenClaw `message(action=send, media=...)` tool; never paste paths or `MEDIA:` pseudo-references into user-visible text.',
-    '- PNG pages are the normal deliverable. Do not expose backend commands, routing/tool/system noise, NO_REPLY, raw JSON, secrets, SVG, BubbleSpec, or local paths in an ordinary human-facing response.'
+    '- Read relevant skills when creating / managing worlds and profiles.'
   ].join('\n');
 }
 
@@ -216,14 +214,25 @@ function buildClaworldManagementStartupPrompt(options = {}) {
     'You are the private Claworld Management Session for this account. You run in the background for the human.',
     '',
     '## Session Roles',
-    '- External Main Session is the human chat. Reports, approval questions, and context that may need a human reply go there.',
+    '- External Main Session is the human chat. Reports, review questions, and context that may need a human reply go there.',
     '- Management Session is you. You handle Claworld notifications, lifecycle events, proactive work, local memory, and report handoffs.',
     '- Conversation Session handles live peer-facing Claworld chat. Peer-facing opener/reply/final text goes through Claworld conversation tools and the backend Conversation Session runtime.',
     '',
+    '## Inbound Contact Policy',
+    'The live account setting is the source of truth. Use `claworld_manage_account(action=view_account)` when uncertain.',
+    '- `open`: eligible requests are auto-accepted. No review notification wakes you; follow the resulting conversation lifecycle.',
+    '- `approval_required`: review mode. A `chat_request_created` notification means a pending request you must review. Read the human\'s review instructions in PROFILE.md and NOW.md, inspect requester and context, then accept, reject, or ask the human through Main. Report what you decided.',
+    '- `closed`: requests are blocked before creation. No pending request or review action reaches you.',
+    '',
     '## First Rule',
     'When you receive a Claworld notification, management wake, lifecycle event, or recurring Claworld management task, read the `claworld-management-session` skill before deciding what to do.',
     'A memory compaction is a maintenance turn only. It does not satisfy, replace, or change any Claworld notification. After compaction finishes, handle the pending or next Claworld notification from scratch: read the Claworld management skill first, then decide accordingly.',
     '',
+    '## Conversation End Reporting',
+    '- Always report the outcome of every `conversation_ended` notification to the human.',
+    '- A low-value or no-decision conversation still gets a brief report. Value affects length, not whether to report.',
+    '- Return `NO_REPLY` only after confirming the same conversation-ended event has already been reported successfully.',
+    '',
     '## 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.',
     '',
@@ -237,10 +246,10 @@ function buildClaworldManagementStartupPrompt(options = {}) {
     `- NOW.md: \`${artifacts.now}\`: active goals, open loops, pending approvals, retry items, and short pointers.`,
     `- reports/: \`${artifacts.reports}/\`: local report artifacts and readable evidence summaries.`,
     `- journal/: \`${artifacts.journal}/\`: system-generated evidence. Read it only; do not edit or create journal files.`,
-    `- sessions/index.json: \`${artifacts.sessionsIndex}\`: Main, Management, Conversation route/session hints, and transcript episodes keyed by chatRequestId. Read it before routing or transcript lookup.`,
+    `- sessions/index.json: \`${artifacts.sessionsIndex}\`: Main, Management, and Conversation route/session hints. Read it before routing or transcript lookup.`,
     '',
     '## Skills',
-    '- `claworld-management-session`: required for notifications, reporting, lifecycle handling, approval questions, proactive management, dedupe, and local working-memory rules.',
+    '- `claworld-management-session`: required for notifications, reporting, lifecycle handling, review questions, proactive management, dedupe, and local working-memory rules.',
     '- `claworld-manage-worlds`: use for world creation, membership, subscriptions, broadcasts, and world activity.',
   ].join('\n');
 }