@myagentroam/agent 0.11.67 → 0.11.69

package/dist/host/local-tool-registry.js

@@ -6,7 +6,7 @@ import { CodeModeTool, codeModeToolDefinition, codeExecWaitToolDefinition } from
 import { normalizeToolInput } from '../tools/input.js';
 import { execToolInput, execToolDefinition, execWaitToolDefinition, formatExecResult } from '../tools/local/exec.js';
 import { ExecTool } from './local-exec-tool.js';
-import { ReadTool, formatBatchReadOutput, readToolDefinition } from '../tools/local/read.js';
+import { ReadTool, formatBatchReadOutput, formatReadEventOutput, readToolDefinition } from '../tools/local/read.js';
 import { WorkspacePathResolver } from '../tools/shared/path-resolver.js';
 import { ViewImageTool, viewImageToolDefinition } from '../tools/local/view-image.js';
 const definitions = [
@@ -58,9 +58,15 @@ export class LocalToolRegistry {
                 async (arguments_, context) => {
                     const result = await read.execute(arguments_, context.signal);
                     const formatted = formatBatchReadOutput(result.results);
+                    const publicResult = formatReadEventOutput(result.results);
                     return {
                         content: formatted.content,
                         data: result,
+                        eventSummary: publicResult.source,
+                        eventData: {
+                            ...publicResult.data,
+                            truncated: result.truncated || publicResult.truncated
+                        },
                         truncated: result.truncated || formatted.truncated
                     };
                 }

package/dist/runtime/event-projection.d.ts

@@ -4,6 +4,7 @@ import type { EventPayload, AgentEvent } from './events.js';
 export declare function toolEventSummary(text: string): {
     summary: string;
     truncated: boolean;
+    retainedLength: number;
 };
 /** Keep streaming deltas live-only; exec output has one durable copy in model context records. */
 export declare function eventForPersistence(event: AgentEvent): AgentEvent | undefined;

package/dist/runtime/event-projection.js

@@ -4,10 +4,10 @@ import { publicToolMetadata } from './public-tool-metadata.js';
 export function toolEventSummary(text) {
     const limit = AGENT_EXECUTION_POLICY.toolEventSummaryCharacters;
     if (text.length <= limit)
-        return { summary: text, truncated: false };
+        return { summary: text, truncated: false, retainedLength: text.length };
     const marker = '... [tool event summary truncated]';
     const prefix = text.slice(0, limit - marker.length).replace(/[\uD800-\uDBFF]$/u, '');
-    return { summary: prefix + marker, truncated: true };
+    return { summary: prefix + marker, truncated: true, retainedLength: prefix.length };
 }
 /** Keep streaming deltas live-only; exec output has one durable copy in model context records. */
 export function eventForPersistence(event) {

package/dist/runtime/public-tool-metadata.d.ts

@@ -1,5 +1,6 @@
 export type PublicToolMetadata = ({
     query?: string;
+    sourcesOnly?: true;
     sources?: {
         url: string;
         title?: string;
@@ -16,6 +17,10 @@ export type PublicToolMetadata = ({
     name: string;
     description?: string;
     source?: string;
+} | {
+    tools: string[];
+} | {
+    status: 'accepted';
 }) & {
     hostedToolKind?: 'WEB_SEARCH' | 'WEB_FETCH';
 };

package/dist/runtime/public-tool-metadata.js

@@ -1,6 +1,12 @@
 /** Public metadata only; page bodies and skill instructions stay in the bounded output. */
 export function publicToolMetadata(toolName, value) {
     const text = (key, limit) => typeof value[key] === 'string' ? value[key].slice(0, limit) : undefined;
+    if (toolName === 'tool_search' &&
+        Array.isArray(value.tools) &&
+        value.tools.every((name) => typeof name === 'string'))
+        return { tools: value.tools.slice(0, 20).map((name) => name.slice(0, 512)) };
+    if (toolName === 'smart_compact' && value.status === 'accepted')
+        return { status: 'accepted' };
     if (toolName === 'web_search') {
         const entries = Array.isArray(value.results)
             ? value.results
@@ -21,7 +27,21 @@ export function publicToolMetadata(toolName, value) {
                 }
             ];
         });
+        const sourcesComplete = entries !== undefined &&
+            sources !== undefined &&
+            entries.length <= 20 &&
+            entries.length === sources.length &&
+            value.truncated !== true &&
+            value.sourcesTruncated !== true &&
+            entries.every((entry, index) => {
+                const source = entry;
+                const projected = sources[index];
+                return (source.url === projected.url &&
+                    source.title === projected.title &&
+                    source.snippet === projected.snippet);
+            });
         return {
+            ...(value.sourcesOnly === true && sourcesComplete ? { sourcesOnly: true } : {}),
             ...(text('query', 500) === undefined ? {} : { query: text('query', 500) }),
             ...(sources === undefined
                 ? {}

package/dist/tools/code-mode/dispatch.js

@@ -40,7 +40,10 @@ export function createCodeToolDispatch(input) {
                     ...(expected ? { expectedMcpTool: expected } : {})
                 }, 'programmatic');
                 const bounded = boundedModelToolOutput(call.name, result.content, result.data);
-                const data = call.name === 'exec' || call.name === 'exec_wait'
+                const data = call.name === 'read' ||
+                    call.name === 'web_search' ||
+                    call.name === 'exec' ||
+                    call.name === 'exec_wait'
                     ? structuredToolEventData(call.name, result.eventData ?? result.data)
                     : result.eventData === undefined
                         ? structuredToolEventData(call.name, result.data)
@@ -63,7 +66,7 @@ export function createCodeToolDispatch(input) {
                     truncated: result.truncated === true || bounded.truncated || preview.truncated,
                     ...(result.artifacts ? { artifacts: result.artifacts } : {})
                 });
-                const { eventData: _eventData, ...guestResult } = result;
+                const { eventData: _eventData, eventSummary: _eventSummary, ...guestResult } = result;
                 return {
                     ...guestResult,
                     ...((call.name === 'exec' || call.name === 'exec_wait') && data !== undefined

package/dist/tools/contracts.d.ts

@@ -198,6 +198,11 @@ export interface ReadEventData {
         path: string;
         startLine?: number;
         endLine?: number;
+        contentRange?: {
+            start: number;
+            end: number;
+        };
+        empty?: true;
         error?: {
             code: string;
             message: string;

package/dist/tools/execution.js

@@ -128,7 +128,9 @@ export async function executeRoundTools(calls, scope) {
                 : typeof output.eventSummary === 'string'
                     ? output.eventSummary
                     : '');
-            const structuredData = call.name === 'exec' ||
+            const structuredData = call.name === 'read' ||
+                call.name === 'web_search' ||
+                call.name === 'exec' ||
                 call.name === 'exec_wait' ||
                 call.name === 'code_exec' ||
                 call.name === 'code_exec_wait'

package/dist/tools/local/read.d.ts

@@ -1,4 +1,5 @@
 import type { ClientToolDefinition } from '../contracts.js';
+import type { ReadEventData } from '../contracts.js';
 import { WorkspacePathResolver } from '../shared/path-resolver.js';
 export type { ReadEventData } from '../contracts.js';
 export declare const readToolDefinition: ClientToolDefinition;
@@ -31,6 +32,13 @@ export interface BatchReadResult {
     results: Array<ReadResult | ReadErrorResult>;
     truncated: boolean;
 }
+/** Produce public text and offsets together, independently of model-visible markup. */
+export declare function formatReadEventOutput(results: BatchReadResult['results']): {
+    source: string;
+    summary: string;
+    truncated: boolean;
+    data: ReadEventData;
+};
 export declare class ReadTool {
     #private;
     private readonly paths;

package/dist/tools/local/read.js

@@ -6,6 +6,7 @@ import { createReadStream } from 'node:fs';
 import { lstat, open } from 'node:fs/promises';
 import { TextDecoder } from 'node:util';
 import { AgentError } from '../../error.js';
+import { toolEventSummary } from '../../runtime/event-projection.js';
 import { TOOL_EXECUTION_LIMITS } from '../execution-limits.js';
 export const readToolDefinition = {
     name: 'read',
@@ -85,6 +86,52 @@ export const readToolDefinition = {
         additionalProperties: false
     }
 };
+/** Produce public text and offsets together, independently of model-visible markup. */
+export function formatReadEventOutput(results) {
+    let source = '';
+    const projected = [];
+    for (const item of results.slice(0, TOOL_EXECUTION_LIMITS.readMaxBatchItems)) {
+        const path = item.path.slice(0, 4096).replace(/[\uD800-\uDBFF]$/u, '');
+        source += `${source ? '\n\n' : ''}${path}\n`;
+        if ('error' in item) {
+            const error = {
+                code: item.error.code.slice(0, 80),
+                message: item.error.message.slice(0, 1000)
+            };
+            source += `${error.code}: ${error.message}`;
+            projected.push({ path, error });
+        }
+        else {
+            const start = source.length;
+            source += item.text;
+            projected.push({
+                path,
+                startLine: item.startLine,
+                ...(item.endLine === undefined ? {} : { endLine: item.endLine }),
+                ...(item.text.length === 0 ? { empty: true } : {}),
+                contentRange: { start, end: source.length }
+            });
+        }
+    }
+    const preview = toolEventSummary(source);
+    const retained = preview.retainedLength;
+    for (const item of projected) {
+        const range = item.contentRange;
+        if (!range)
+            continue;
+        if (range.start > retained || (range.start === retained && range.end > range.start)) {
+            delete item.contentRange;
+        }
+        else {
+            range.end = Math.min(range.end, retained);
+        }
+    }
+    return {
+        source,
+        ...preview,
+        data: { mode: 'batch', results: projected, truncated: preview.truncated }
+    };
+}
 export class ReadTool {
     paths;
     constructor(paths) {

package/dist/tools/output-projection.js

@@ -300,6 +300,12 @@ export function structuredToolEventData(toolName, value) {
             typeof result.path === 'string' &&
             (result.startLine === undefined || isNonnegativeInteger(result.startLine)) &&
             (result.endLine === undefined || isNonnegativeInteger(result.endLine)) &&
+            (result.empty === undefined || result.empty === true) &&
+            (result.contentRange === undefined ||
+                (isRecord(result.contentRange) &&
+                    isNonnegativeInteger(result.contentRange.start) &&
+                    isNonnegativeInteger(result.contentRange.end) &&
+                    result.contentRange.end >= result.contentRange.start)) &&
             (result.error === undefined ||
                 (isRecord(result.error) &&
                     typeof result.error.code === 'string' &&
@@ -314,6 +320,8 @@ export function structuredToolEventData(toolName, value) {
                     ? { startLine: item.startLine }
                     : {}),
                 ...('endLine' in item && item.endLine !== undefined ? { endLine: item.endLine } : {}),
+                ...(item.contentRange === undefined ? {} : { contentRange: { ...item.contentRange } }),
+                ...(item.empty === true ? { empty: true } : {}),
                 ...('error' in item ? { error: { ...item.error } } : {})
             }))
         };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myagentroam/agent",
-  "version": "0.11.67",
+  "version": "0.11.69",
   "description": "Embeddable MAR coding agent SDK and CLI.",
   "license": "Apache-2.0",
   "type": "module",