@myagentroam/node 0.11.44 → 0.11.45

package/dist/runner/claude/managed-run-controller.js

@@ -462,26 +462,19 @@ export class ClaudeManagedRunController {
                             const tool = toolInputs.get(result.toolUseId);
                             if (tool === undefined)
                                 continue;
-                            const normalized = normalizeClaudeTool(tool.name, tool.input, result.output, result.failed, tool.inputTruncated || result.truncated, knownSubagents, result.claudeResult, result.truncated);
+                            const normalized = normalizeClaudeTool(tool.name, tool.input, result.output, result.failed, tool.inputTruncated || result.truncated, knownSubagents, result.claudeResult, result.truncated, tool.inputTruncated, result.truncated ? 'HEAD' : undefined);
                             this.host.emitItem(runId, {
                                 itemId: boundedConversationItemId('claude-tool', result.toolUseId),
                                 kind,
                                 status: result.failed ? 'FAILED' : 'COMPLETED',
                                 payload: kind === 'command_execution'
-                                    ? {
-                                        outputPreview: result.output,
-                                        exitCode: null,
-                                        durationMs: null,
-                                        truncated: result.truncated
-                                    }
+                                    ? normalized.payload
                                     : kind === 'file_change'
                                         ? {}
                                         : {
                                             ...normalized.payload,
-                                            outputSummary: result.output,
                                             progressLabel: null,
-                                            errorCode: result.failed ? 'TOOL_EXECUTION_FAILED' : null,
-                                            truncated: result.truncated
+                                            errorCode: result.failed ? 'TOOL_EXECUTION_FAILED' : null
                                         },
                                 merge: true
                             });

package/dist/runner/claude/native-transcript.js

@@ -339,7 +339,7 @@ export const claudeNativeTranscriptAdapter = {
         return {
             userText: (text) => publicGoalHistoryText(stripClaudePlanTag(text)),
             planText: claudePlanText,
-            normalizeTool: (entry) => normalizeClaudeTool(entry.toolName, entry.input, entry.outputSummary, entry.failed, entry.inputTruncated || entry.outputTruncated, titles, claudeNativeToolResultMetadata(entry.subagentResult), entry.outputTruncated),
+            normalizeTool: (entry) => normalizeClaudeTool(entry.toolName, entry.input, entry.outputSummary, entry.failed, entry.inputTruncated || entry.outputTruncated, titles, claudeNativeToolResultMetadata(entry.subagentResult), entry.outputTruncated, entry.inputTruncated, entry.outputTruncated ? 'HEAD' : undefined),
             userInputQuestions: (entry) => entry.toolName === 'AskUserQuestion' && isPlainRecord(entry.input)
                 ? claudeUserInputQuestions(entry.input)
                 : []

package/dist/runner/claude/tool-normalizer.js

@@ -1,5 +1,5 @@
 import { claudeContentBlocks } from './message-parsers.js';
-import { compactRunnerText, compactRunnerValue, publicOutputSnapshot } from '../normalization.js';
+import { compactRunnerText, compactRunnerValue, publicOutputSnapshot, publicToolOutput } from '../normalization.js';
 import { shellExecution } from '../execution-presentation.js';
 import { RunnerUsageTracker, usageToken, usageTokenSum } from '../../service/runner-usage-tracker.js';
 export class ClaudeUsageNormalizer {
@@ -99,11 +99,9 @@ export function extractClaudeToolResults(message) {
         };
     });
 }
-export function normalizeClaudeTool(toolName, input, output, failed, truncated, knownSubagents = new Map(), resultMetadata, sourceOutputTruncated = output === null ? false : truncated) {
+export function normalizeClaudeTool(toolName, input, output, failed, truncated, knownSubagents = new Map(), resultMetadata, sourceOutputTruncated = output === null ? false : truncated, sourceInputTruncated = output === null ? truncated : false, outputDirection) {
     const values = record(input);
     const normalizedToolName = compactRunnerText(toolName, 128) || 'unknown';
-    const normalizedOutput = output === null ? null : compactRunnerText(output, 10_000);
-    const outputTruncated = sourceOutputTruncated || (output?.length ?? 0) > 10_000;
     const subagent = claudeSubagentProjection(toolName, input, resultMetadata ?? output, knownSubagents);
     if (isCommandTool(toolName))
         return {
@@ -112,14 +110,15 @@ export function normalizeClaudeTool(toolName, input, output, failed, truncated,
                 toolName: normalizedToolName,
                 command: compactRunnerText(typeof values?.command === 'string' ? values.command : normalizedToolName, 10_000),
                 cwd: null,
-                outputPreview: normalizedOutput ?? '',
                 exitCode: null,
                 durationMs: null,
-                truncated: truncated || outputTruncated,
                 ...(output === null || output === undefined
                     ? {}
-                    : { output: publicOutputSnapshot(output, outputTruncated) }),
-                toolPresentation: shellExecution(output ?? undefined, outputTruncated)
+                    : {
+                        output: publicToolOutput(output, outputDirection ?? (sourceOutputTruncated ? 'SOURCE' : undefined), 'COMBINED')
+                    }),
+                toolPresentation: shellExecution(sourceInputTruncated ||
+                    (typeof values?.command === 'string' && values.command.length > 10_000))
             }
         };
     if (isFileTool(toolName)) {
@@ -154,11 +153,17 @@ export function normalizeClaudeTool(toolName, input, output, failed, truncated,
             toolName: normalizedToolName,
             title: compactRunnerText(toolName, 500) || normalizedToolName,
             inputSummary: compactRunnerValue(input, 10_000).text || null,
-            outputSummary: normalizedOutput,
-            ...(output === null ? {} : { output: publicOutputSnapshot(output, outputTruncated) }),
+            outputSummary: null,
+            ...(output === null
+                ? {}
+                : {
+                    output: publicToolOutput(output, outputDirection ?? (sourceOutputTruncated ? 'SOURCE' : undefined))
+                }),
             progressLabel: null,
             errorCode: failed ? 'TOOL_EXECUTION_FAILED' : null,
-            truncated: truncated || outputTruncated,
+            ...(sourceInputTruncated || compactRunnerValue(input, 10_000).truncated
+                ? { inputTruncated: true }
+                : {}),
             ...(toolName === 'Read'
                 ? {
                     toolPresentation: {

package/dist/runner/codex/conversation-parser.js

@@ -132,7 +132,7 @@ import { conversationImageAttachmentSchema } from '@myagentroam/protocol';
 import { parseCodexComposerImageMarkers } from './composer-image-markers.js';
 import { normalizeCodexTool } from './tool-normalizer.js';
 import { shellExecution } from '../execution-presentation.js';
-import { publicOutputSnapshot } from '../normalization.js';
+import { publicToolOutput } from '../normalization.js';
 import { publicGoalHistoryText } from '../../service/goal-runtime.js';
 const MAX_COMPOSER_ATTACHMENT_BYTES = 5 * 1024 * 1024;
 const MAX_COMPOSER_ATTACHMENTS_BYTES = 10 * 1024 * 1024;
@@ -551,13 +551,9 @@ export function mergeCodexCustomToolItems(invocation, result) {
             completedAt: result.completedAt,
             payload: {
                 ...invocationPayload,
-                outputPreview: resultPayload.outputPreview ??
-                    resultPayload.outputSummary ??
-                    invocationPayload.outputPreview,
                 ...(resultPayload.output === undefined ? {} : { output: resultPayload.output }),
                 exitCode: resultPayload.exitCode ?? invocationPayload.exitCode,
                 durationMs: resultPayload.durationMs ?? invocationPayload.durationMs,
-                truncated: invocationPayload.truncated === true || resultPayload.truncated === true,
                 ...(resultPayload.attachments === undefined
                     ? {}
                     : { attachments: resultPayload.attachments })
@@ -576,7 +572,6 @@ export function mergeCodexCustomToolItems(invocation, result) {
             outputSummary: resultPayload.outputSummary ?? invocationPayload.outputSummary,
             ...(resultPayload.output === undefined ? {} : { output: resultPayload.output }),
             errorCode: resultPayload.errorCode ?? invocationPayload.errorCode,
-            truncated: invocationPayload.truncated === true || resultPayload.truncated === true,
             ...(resultPayload.attachments === undefined ? {} : { attachments: resultPayload.attachments })
         }
     };
@@ -720,7 +715,6 @@ export function codexOfficialItem(session, nativeTurnId, value, turnSequence, it
                     ? compactRunnerText(value.command, 10_000)
                     : '(No command provided)',
                 cwd: typeof value.cwd === 'string' ? compactRunnerText(value.cwd, 4_096) : null,
-                outputPreview: publicOutputSnapshot(output).text,
                 exitCode: typeof value.exitCode === 'number' && Number.isInteger(value.exitCode)
                     ? value.exitCode
                     : null,
@@ -729,21 +723,16 @@ export function codexOfficialItem(session, nativeTurnId, value, turnSequence, it
                     value.durationMs >= 0
                     ? value.durationMs
                     : null,
-                truncated: output.length > 10_000,
-                ...(base.status !== 'IN_PROGRESS'
-                    ? {
-                        output: typeof value.aggregatedOutput === 'string'
-                            ? publicOutputSnapshot(output)
-                            : undefined
-                    }
+                ...(typeof value.aggregatedOutput === 'string'
+                    ? { output: publicToolOutput(output, undefined, 'COMBINED') }
                     : {}),
-                toolPresentation: shellExecution(base.status === 'IN_PROGRESS' || typeof value.aggregatedOutput !== 'string'
-                    ? undefined
-                    : output)
+                toolPresentation: shellExecution((typeof value.command === 'string' && value.command.length > 10_000) ||
+                    (typeof value.cwd === 'string' && value.cwd.length > 4_096))
             }
         };
     }
-    if (value.type === 'mcpToolCall')
+    if (value.type === 'mcpToolCall') {
+        const input = compactRunnerValue(value.arguments, 10_000);
         return {
             ...base,
             kind: 'tool_call',
@@ -756,12 +745,14 @@ export function codexOfficialItem(session, nativeTurnId, value, turnSequence, it
                     .join('.'),
                 namespace: typeof value.server === 'string' ? value.server : '',
                 toolName: typeof value.tool === 'string' ? value.tool : '',
-                inputSummary: codexCompactJson(value.arguments),
-                outputSummary: codexCompactJson(value.result),
-                ...(value.result == null ? {} : { output: publicOutputSnapshot(value.result) }),
+                inputSummary: input.text,
+                ...(input.truncated ? { inputTruncated: true } : {}),
+                outputSummary: null,
+                ...(value.result == null ? {} : { output: publicToolOutput(value.result) }),
                 ...(value.error === undefined ? {} : { errorCode: codexCompactJson(value.error) })
             }
         };
+    }
     if (value.type === 'webSearch')
         return {
             ...base,
@@ -804,15 +795,16 @@ export function codexOfficialItem(session, nativeTurnId, value, turnSequence, it
                 ? value.name
                 : 'tool';
         const outputValue = value.contentItems ?? value.output;
-        const output = outputValue == null ? undefined : publicOutputSnapshot(codexToolOutput(outputValue));
+        const output = outputValue == null ? undefined : codexToolOutput(outputValue);
+        const input = compactRunnerValue(value.arguments ?? value.input, 10_000);
         const normalized = normalizeCodexTool({
             name,
             namespace: typeof value.namespace === 'string' ? value.namespace : 'codex',
             rawInput: value.arguments ?? value.input,
-            inputSummary: codexCompactJson(value.arguments ?? value.input),
-            outputSummary: output?.text ?? null,
-            outputTruncated: output?.truncated ?? false,
-            truncated: output?.truncated ?? false,
+            inputSummary: input.text || null,
+            inputTruncated: input.truncated,
+            outputSummary: output === undefined ? null : typeof output === 'string' ? output : JSON.stringify(output),
+            outputTruncated: false,
             outputOnly: value.type === 'custom_tool_call_output' ||
                 value.type === 'function_call_output' ||
                 value.type === 'customToolCallOutput' ||
@@ -906,7 +898,6 @@ export function codexLiveConversationItem(value, completed, imageAttachments = [
                     ? compactRunnerText(value.command, 10_000)
                     : '(No command provided)',
                 cwd: typeof value.cwd === 'string' ? compactRunnerText(value.cwd, 4_096) : null,
-                outputPreview: publicOutputSnapshot(output).text,
                 exitCode: typeof value.exitCode === 'number' && Number.isInteger(value.exitCode)
                     ? value.exitCode
                     : null,
@@ -915,21 +906,20 @@ export function codexLiveConversationItem(value, completed, imageAttachments = [
                     value.durationMs >= 0
                     ? value.durationMs
                     : null,
-                truncated: output.length > 10_000,
                 ...(completed
                     ? {
                         output: typeof value.aggregatedOutput === 'string'
-                            ? publicOutputSnapshot(output)
+                            ? publicToolOutput(output, undefined, 'COMBINED')
                             : undefined
                     }
                     : {}),
-                toolPresentation: shellExecution(!completed || typeof value.aggregatedOutput !== 'string' ? undefined : output)
+                toolPresentation: shellExecution((typeof value.command === 'string' && value.command.length > 10_000) ||
+                    (typeof value.cwd === 'string' && value.cwd.length > 4_096))
             }
         };
     }
     if (value.type === 'mcpToolCall') {
         const input = compactRunnerValue(value.arguments, 10_000);
-        const output = compactRunnerValue(value.result, 10_000);
         const error = compactRunnerValue(value.error, 80);
         const server = typeof value.server === 'string' ? value.server : 'mcp';
         const tool = typeof value.tool === 'string' ? value.tool : 'tool';
@@ -942,11 +932,11 @@ export function codexLiveConversationItem(value, completed, imageAttachments = [
                 toolName: compactRunnerText(tool, 128),
                 title: compactRunnerText(`${server}.${tool}`, 500),
                 inputSummary: input.text || null,
-                outputSummary: output.text || null,
-                ...(value.result == null ? {} : { output: publicOutputSnapshot(value.result) }),
+                outputSummary: null,
+                ...(value.result == null ? {} : { output: publicToolOutput(value.result) }),
                 progressLabel: null,
                 errorCode: error.text || null,
-                truncated: input.truncated || output.truncated || error.truncated
+                ...(input.truncated ? { inputTruncated: true } : {})
             }
         };
     }
@@ -1021,7 +1011,7 @@ export function codexLiveConversationItem(value, completed, imageAttachments = [
                 : 'tool';
         const input = compactRunnerValue(value.arguments ?? value.input, 10_000);
         const outputValue = value.contentItems ?? value.output;
-        const output = outputValue == null ? undefined : publicOutputSnapshot(codexToolOutput(outputValue));
+        const output = outputValue == null ? undefined : codexToolOutput(outputValue);
         const outputOnly = value.type === 'custom_tool_call_output' ||
             value.type === 'function_call_output' ||
             value.type === 'customToolCallOutput' ||
@@ -1031,9 +1021,10 @@ export function codexLiveConversationItem(value, completed, imageAttachments = [
             namespace: typeof value.namespace === 'string' ? value.namespace : 'codex',
             rawInput: value.arguments ?? value.input,
             inputSummary: input.text || null,
-            outputSummary: output?.text ?? null,
-            truncated: input.truncated || output?.truncated === true,
-            outputTruncated: output?.truncated ?? false,
+            inputTruncated: input.truncated,
+            outputSummary: output === undefined ? null : typeof output === 'string' ? output : JSON.stringify(output),
+            truncated: input.truncated,
+            outputTruncated: false,
             outputOnly,
             attachments: imageAttachments
         });

package/dist/runner/codex/managed-run-controller.js

@@ -1,7 +1,7 @@
 import { NODE_MCP } from '../../mcp/naming.js';
 import { nodeExecutionEnvironment } from '../../node-execution-environment.js';
 import { extractId } from './conversation-parser.js';
-import { publicOutputSnapshot } from '../normalization.js';
+import { publicToolOutput } from '../normalization.js';
 import { normalizeCodexApproval } from './tool-normalizer.js';
 import { parseSecretEnvironment } from '../../mcp/secret-environment.js';
 import { safeErrorCode } from '../../util/safe-error.js';
@@ -280,14 +280,14 @@ export class CodexManagedRunController {
         if (notification.method === 'item/commandExecution/outputDelta' &&
             typeof params.itemId === 'string' &&
             typeof params.delta === 'string') {
-            const output = publicOutputSnapshot(params.delta);
+            const output = publicToolOutput(params.delta, undefined, 'COMBINED');
             this.emitItem(runId, {
                 itemId: boundedConversationItemId('codex', params.itemId),
                 kind: 'command_execution',
                 status: 'IN_PROGRESS',
-                payload: { outputPreview: output.text, output },
+                payload: { output },
                 merge: true,
-                append: 'output'
+                ...(output.truncation === 'HEAD' ? {} : { append: 'output' })
             });
             return;
         }

package/dist/runner/codex/native-transcript.js

@@ -1,7 +1,7 @@
 import { homedir } from 'node:os';
 import { basename, join } from 'node:path';
 import { forEachJsonlRecord } from '../../native-jsonl-reader.js';
-import { compactRunnerValue as compactValue } from '../normalization.js';
+import { compactRunnerValue as compactValue, publicOutputSnapshot } from '../normalization.js';
 import { stripGoalStartPrompt, publicGoalHistoryText } from '../../service/goal-runtime.js';
 import { parseCodexComposerImageMarkers } from './composer-image-markers.js';
 import { codexTranscriptSourceItemId } from './conversation-parser.js';
@@ -167,7 +167,7 @@ function codexToolResultsOf(record, createdAt) {
     const toolUseId = firstString(payload, ['call_id', 'id']);
     if (toolUseId === undefined)
         return [];
-    const output = compactValue(codexToolOutput(payload['output'] ?? payload['contentItems']), 10_000);
+    const output = publicOutputSnapshot(codexToolOutput(payload['output'] ?? payload['contentItems']));
     const imageAttachments = codexImagePlaceholders(payload['output'] ?? payload['contentItems']);
     return [
         {
@@ -566,7 +566,9 @@ export const codexNativeTranscriptAdapter = {
                 rawInput: entry.input,
                 inputSummary: entry.inputSummary,
                 outputSummary: entry.outputSummary,
-                truncated: entry.inputTruncated || entry.outputTruncated,
+                inputTruncated: entry.inputTruncated,
+                outputTruncated: entry.outputTruncated,
+                ...(entry.outputTruncated ? { outputDirection: 'HEAD' } : {}),
                 ...(entry.imageAttachments === undefined ? {} : { attachments: entry.imageAttachments })
             }),
             userInputQuestions: () => []

package/dist/runner/codex/tool-normalizer.js

@@ -1,4 +1,4 @@
-import { compactRunnerText, publicOutputSnapshot } from '../normalization.js';
+import { compactRunnerText, publicToolOutput } from '../normalization.js';
 import { shellExecution } from '../execution-presentation.js';
 export function normalizeCodexApproval(method) {
     return method === 'item/commandExecution/requestApproval'
@@ -10,20 +10,18 @@ export function normalizeCodexTool(input) {
     const rawInput = input.rawInput;
     const attachments = input.attachments ?? [];
     const outputTruncated = input.outputTruncated ?? (input.outputSummary != null && input.truncated === true);
+    const outputDirection = input.outputDirection ?? (outputTruncated ? 'SOURCE' : undefined);
     const subagent = codexSubagentProjection(input.namespace, name, rawInput, input.outputSummary);
     if (isCommandTool(name)) {
-        const outputPreview = compactRunnerText(input.outputSummary ?? '', 10_000);
         if (input.outputOnly === true)
             return {
                 kind: 'command_execution',
                 payload: {
                     toolName: name,
-                    outputPreview,
-                    truncated: input.truncated === true || (input.outputSummary?.length ?? 0) > 10_000,
                     ...(input.outputSummary == null
                         ? {}
-                        : { output: publicOutputSnapshot(input.outputSummary, outputTruncated) }),
-                    toolPresentation: shellExecution(input.outputSummary ?? undefined, outputTruncated),
+                        : { output: publicToolOutput(input.outputSummary, outputDirection, 'COMBINED') }),
+                    toolPresentation: shellExecution(),
                     ...(attachments.length === 0 ? {} : { attachments })
                 }
             };
@@ -41,16 +39,14 @@ export function normalizeCodexTool(input) {
                 toolName: name,
                 command: compactRunnerText(command, 10_000),
                 cwd: typeof values?.cwd === 'string' ? compactRunnerText(values.cwd, 4_096) : null,
-                outputPreview,
                 exitCode: null,
                 durationMs: null,
-                toolPresentation: shellExecution(input.outputSummary ?? undefined, outputTruncated),
+                toolPresentation: shellExecution(input.inputTruncated === true ||
+                    command.length > 10_000 ||
+                    (typeof values?.cwd === 'string' && values.cwd.length > 4_096)),
                 ...(input.outputSummary == null
                     ? {}
-                    : { output: publicOutputSnapshot(input.outputSummary, outputTruncated) }),
-                truncated: input.truncated === true ||
-                    command.length > 10_000 ||
-                    (input.outputSummary?.length ?? 0) > 10_000,
+                    : { output: publicToolOutput(input.outputSummary, outputDirection, 'COMBINED') }),
                 ...(attachments.length === 0 ? {} : { attachments })
             }
         };
@@ -59,10 +55,10 @@ export function normalizeCodexTool(input) {
         return {
             kind: 'tool_call',
             payload: {
-                outputSummary: input.outputSummary == null ? null : compactRunnerText(input.outputSummary, 10_000),
+                outputSummary: null,
                 ...(input.outputSummary == null
                     ? {}
-                    : { output: publicOutputSnapshot(input.outputSummary, outputTruncated) }),
+                    : { output: publicToolOutput(input.outputSummary, outputDirection) }),
                 ...subagent,
                 ...(attachments.length === 0 ? {} : { attachments })
             }
@@ -74,13 +70,13 @@ export function normalizeCodexTool(input) {
             namespace: compactRunnerText(input.namespace ?? 'codex', 128),
             toolName: name,
             inputSummary: input.inputSummary ?? null,
-            outputSummary: input.outputSummary == null ? null : compactRunnerText(input.outputSummary, 10_000),
+            outputSummary: null,
             ...(input.outputSummary == null
                 ? {}
-                : { output: publicOutputSnapshot(input.outputSummary, outputTruncated) }),
+                : { output: publicToolOutput(input.outputSummary, outputDirection) }),
             progressLabel: null,
             errorCode: null,
-            truncated: input.truncated === true,
+            ...(input.inputTruncated ? { inputTruncated: true } : {}),
             ...subagent,
             ...(attachments.length === 0 ? {} : { attachments })
         }

package/dist/runner/execution-presentation.js

@@ -1,53 +1,10 @@
-const MAX_BYTES = 128 * 1024;
-function tail(text, limit) {
-    if (limit === 0)
-        return '';
-    const result = text.slice(-limit);
-    const first = result.charCodeAt(0);
-    return first >= 0xdc00 && first <= 0xdfff ? result.slice(1) : result;
-}
-/** Keep public execution output bounded without copying an unbounded source. */
-export function boundExecutionPresentation(execution) {
-    let truncated = (execution.output?.length ?? 0) > 4;
-    const output = execution.output?.slice(0, 4).map((block) => {
-        if (block.text.length > 10_000)
-            truncated = true;
-        return { ...block, text: tail(block.text, 10_000) };
-    });
-    const detail = {
-        ...execution,
-        ...(output === undefined ? {} : { output }),
-        ...(execution.truncation === undefined ? {} : { truncation: { ...execution.truncation } })
-    };
-    if (truncated)
-        detail.truncation = { ...detail.truncation, output: detail.truncation?.output ?? 'HEAD' };
-    const presentation = { kind: 'EXECUTION', execution: detail };
-    const size = () => Buffer.byteLength(JSON.stringify(presentation));
-    for (const block of [...(detail.output ?? [])].reverse()) {
-        if (size() <= MAX_BYTES)
-            break;
-        const source = block.text;
-        detail.truncation = { ...detail.truncation, output: detail.truncation?.output ?? 'HEAD' };
-        truncated = true;
-        let low = 0;
-        let high = source.length;
-        while (low < high) {
-            const middle = Math.ceil((low + high) / 2);
-            block.text = tail(source, middle);
-            if (size() <= MAX_BYTES)
-                low = middle;
-            else
-                high = middle - 1;
+/** Execution metadata is independent of the public output body and its budget. */
+export function shellExecution(inputTruncated = false) {
+    return {
+        kind: 'EXECUTION',
+        execution: {
+            kind: 'SHELL',
+            ...(inputTruncated ? { truncation: { input: true } } : {})
         }
-        block.text = tail(source, low);
-    }
-    return { presentation, truncated };
-}
-/** Project only the stream facts actually supplied by the runner. */
-export function shellExecution(output, sourceTruncated = false) {
-    return boundExecutionPresentation({
-        kind: 'SHELL',
-        ...(output === undefined ? {} : { output: [{ channel: 'COMBINED', text: output }] }),
-        ...(sourceTruncated ? { truncation: { output: 'SOURCE' } } : {})
-    }).presentation;
+    };
 }

package/dist/runner/mar-agent/agent-network-extension.js

@@ -1,4 +1,5 @@
 import { agentNetworkWaitModelOutput } from './agent-network-wait-output.js';
+import { agentOperationEvent } from './agent-operation-presentation.js';
 const text = { type: 'string', minLength: 1 };
 const attachmentIds = {
     type: 'array',
@@ -112,11 +113,50 @@ const tools = [
         required: ['agentId']
     }
 ];
+const delegationPrompt = [
+    '# Delegation and coordination',
+    'Delegate bounded, self-contained tasks when independent progress or context savings materially helps. Keep simple or tightly coupled work local.',
+    'Give each child an objective, necessary context, expected output, and a read-only boundary or non-overlapping write scope.',
+    'While children run, continue meaningful non-overlapping work. Do not redo delegated work. Wait only when the next step needs the result.',
+    'Verify consequential findings and changes. Join or stop task-required child work before final delivery, and retain responsibility for the final result.'
+].join('\n\n');
+const collaborationPrompt = [
+    '# Workspace collaboration',
+    "Use native agent_* tools to collaborate within the Agent Network when another Session's context or ongoing work materially helps. Keep requests focused and avoid unnecessary cross-Session coordination. Peer Sessions retain their own work and lifecycle; do not treat them as task-owned children or stop them merely for task cleanup. Sending to a non-child does not subscribe to its updates; explicitly wait when you need its progress or completion."
+].join('\n\n');
+const managementPrompt = [
+    '# Workspace management',
+    "Load marctl when needed to manage existing Session settings, titles, persistent prompts or schedules, or to discover authorized Nodes, execute remote commands or transfer files. Ordinary Agent collaboration and selecting a child's model or effort at creation use native agent_* tools. Do not switch to marctl when a native operation fails."
+].join('\n\n');
 export function agentNetworkExtension(invoke, currentExecution) {
     return {
         id: 'mar.node.agent-network',
         apiVersion: '1.0',
         attachSession(context) {
+            context.hooks.intercept('prompt.sections', (input, _call, next) => {
+                const available = new Set(input.facts?.tools);
+                const enabled = input.facts?.mode !== 'compact';
+                return next({
+                    ...input,
+                    sections: [
+                        ...input.sections,
+                        {
+                            id: 'mar.node.agent-network:delegation',
+                            text: enabled && available.has('agent_start') ? delegationPrompt : null
+                        },
+                        {
+                            id: 'mar.node.agent-network:collaboration',
+                            text: enabled && available.has('agent_send') ? collaborationPrompt : null
+                        },
+                        {
+                            id: 'mar.node.agent-network:management',
+                            text: enabled && tools.some((tool) => available.has(`agent_${tool.action}`))
+                                ? managementPrompt
+                                : null
+                        }
+                    ]
+                });
+            });
             for (const tool of tools)
                 context.tools.register({
                     name: `agent_${tool.action}`,
@@ -124,6 +164,7 @@ export function agentNetworkExtension(invoke, currentExecution) {
                     allowedCallers: ['direct', 'programmatic'],
                     eventInputFields: [
                         'agentId',
+                        'agentIds',
                         'title',
                         'executionId',
                         'runner',
@@ -144,22 +185,11 @@ export function agentNetworkExtension(invoke, currentExecution) {
                         if (!executionId)
                             throw new Error('AGENT_ACTOR_NOT_ACTIVE');
                         const result = await invoke(executionId, tool.action, input, call);
-                        const value = result !== null && typeof result === 'object' && !Array.isArray(result)
-                            ? result
-                            : undefined;
-                        const id = value?.agentId;
-                        const eventData = ['start', 'send', 'stop', 'wait'].includes(tool.action) &&
-                            typeof id === 'string' &&
-                            id.length > 0 &&
-                            id.length <= 128
-                            ? { agentId: id, productSessionId: id }
-                            : undefined;
                         const modelResult = tool.action === 'wait' ? agentNetworkWaitModelOutput(result) : result;
                         return {
                             data: result,
                             content: JSON.stringify(modelResult),
-                            eventSummary: JSON.stringify(eventData ?? {}),
-                            eventData: eventData ?? {}
+                            ...agentOperationEvent(tool.action, input, result)
                         };
                     }
                 });