@myagentroam/agent 0.10.57 → 0.10.58

package/dist/agent-core/model/anthropic-messages.js

@@ -235,7 +235,7 @@ export class AnthropicMessagesAdapter {
                         const sources = anthropicHostedSources(result);
                         const summary = {
                             ...hosted.summary,
-                            ...(sources.length ? { sources } : {}),
+                            ...(Array.isArray(result) ? { sources } : {}),
                             ...(Array.isArray(result) && result.length > 20 ? { sourcesTruncated: true } : {})
                         };
                         hostedTools.set(toolId, { ...hosted, summary });
@@ -466,9 +466,11 @@ function anthropicHostedSources(result) {
         if (!url)
             return undefined;
         const title = text(source.title);
+        const snippet = text(source.snippet);
         return {
             url: url.slice(0, 2_048),
-            ...(title ? { title: title.slice(0, 256) } : {})
+            ...(title ? { title: title.slice(0, 256) } : {}),
+            ...(snippet ? { snippet: snippet.slice(0, 2000) } : {})
         };
     })
         .filter((source) => source !== undefined);

package/dist/agent-core/model/contracts.d.ts

@@ -191,6 +191,7 @@ export type ModelEvent = {
         sources?: readonly {
             url: string;
             title?: string | undefined;
+            snippet?: string | undefined;
         }[] | undefined;
         sourcesTruncated?: boolean | undefined;
     };

package/dist/agent-core/model/openai-responses.js

@@ -1740,9 +1740,11 @@ function hostedWebActionSummary(action) {
             if (!sourceUrl)
                 return undefined;
             const sourceTitle = text(value.title);
+            const snippet = text(value.snippet);
             return {
                 url: sourceUrl.slice(0, 2048),
-                ...(sourceTitle ? { title: sourceTitle.slice(0, 256) } : {})
+                ...(sourceTitle ? { title: sourceTitle.slice(0, 256) } : {}),
+                ...(snippet ? { snippet: snippet.slice(0, 2000) } : {})
             };
         })
             .filter((source) => source !== undefined)
@@ -1751,7 +1753,7 @@ function hostedWebActionSummary(action) {
         ...(query ? { query: query.slice(0, 10_000) } : {}),
         ...(url ? { url: url.slice(0, 2048) } : {}),
         ...(title ? { title: title.slice(0, 256) } : {}),
-        ...(sources.length ? { sources } : {}),
+        ...(Array.isArray(action.sources) ? { sources } : {}),
         ...(Array.isArray(action.sources) && action.sources.length > 20
             ? { sourcesTruncated: true }
             : {})

package/dist/agent-core/runtime/event-projection.js

@@ -1,4 +1,5 @@
 import { AGENT_EXECUTION_POLICY } from './execution-policy.js';
+import { publicToolMetadata } from '../tools/public-metadata.js';
 /** Mark display-only clipping without changing tool output or model context. */
 export function toolEventSummary(text) {
     const limit = AGENT_EXECUTION_POLICY.toolEventSummaryCharacters;
@@ -50,6 +51,10 @@ export function publicHostedToolEvents(event) {
         type: 'tool.started',
         toolName,
         callId: event.itemId,
+        data: {
+            ...publicToolMetadata(event.kind === 'WEB_SEARCH' ? 'web_search' : 'web_fetch', event.summary),
+            hostedToolKind: event.kind
+        },
         ...(input === undefined ? {} : { input }),
         ...(truncated ? { truncated: true } : {})
     };
@@ -67,5 +72,15 @@ export function publicHostedToolEvents(event) {
                 truncated
             }
         ];
-    return [started, { type: 'tool.completed', toolName, callId: event.itemId, summary, truncated }];
+    return [
+        started,
+        {
+            type: 'tool.completed',
+            toolName,
+            callId: event.itemId,
+            summary,
+            truncated,
+            data: started.data
+        }
+    ];
 }

package/dist/agent-core/runtime/events.d.ts

@@ -68,6 +68,7 @@ export type MarAgentEvent = MarAgentEventBase & ({
         sources?: readonly {
             url: string;
             title?: string | undefined;
+            snippet?: string | undefined;
         }[] | undefined;
         sourcesTruncated?: boolean | undefined;
     };
@@ -82,6 +83,7 @@ export type MarAgentEvent = MarAgentEventBase & ({
     callId: string;
     parentCallId?: string;
     input?: unknown;
+    data?: import('../tools/public-metadata.js').PublicToolMetadata;
     truncated?: boolean;
 } | {
     type: 'tool.completed';
@@ -92,7 +94,7 @@ export type MarAgentEvent = MarAgentEventBase & ({
     summary: string;
     truncated?: boolean;
     artifacts?: readonly MarAgentToolArtifact[];
-    data?: CodeCellEventData | import('../tools/contracts.js').ExecResult | Omit<import('../tools/contracts.js').ExecResult, 'stdout' | 'stderr'> | import('../tools/contracts.js').ApplyPatchResult | import('../tools/contracts.js').ReadEventData | import('../tools/contracts.js').ViewImageResult | import('../subagent/contracts.js').SubagentTaskSnapshot | import('../subagent/contracts.js').SubagentManyOutput | import('../tools/agent/sleep.js').SleepResult;
+    data?: CodeCellEventData | import('../tools/contracts.js').ExecResult | Omit<import('../tools/contracts.js').ExecResult, 'stdout' | 'stderr'> | import('../tools/contracts.js').ApplyPatchResult | import('../tools/contracts.js').ReadEventData | import('../tools/contracts.js').ViewImageResult | import('../subagent/contracts.js').SubagentTaskSnapshot | import('../subagent/contracts.js').SubagentManyOutput | import('../tools/agent/sleep.js').SleepResult | import('../tools/public-metadata.js').PublicToolMetadata;
 } | {
     type: 'tool.failed';
     resultExtensions?: readonly import('../tools/result-extensions.js').ToolResultExtension[];
@@ -104,6 +106,11 @@ export type MarAgentEvent = MarAgentEventBase & ({
     message?: string;
     permissionStop?: import('../tools/permissions.js').PermissionStop;
     truncated?: boolean;
+} | {
+    type: 'sleep.started';
+    callId: string;
+    durationMs: number;
+    startedAt: string;
 } | {
     type: 'usage.updated';
     purpose?: 'compact';

package/dist/agent-core/tools/agent/sleep.d.ts

@@ -6,7 +6,7 @@ export interface SleepResult {
     wakeReason: 'elapsed' | 'steer' | 'subagent_message';
 }
 export declare const sleepToolDefinition: ClientToolDefinition;
-export declare function executeSleep(arguments_: unknown, context: ToolRuntimeContext): Promise<{
+export declare function executeSleep(arguments_: unknown, context: ToolRuntimeContext, callId: string): Promise<{
     content: string;
     data: SleepResult;
 }>;

package/dist/agent-core/tools/agent/sleep.js

@@ -19,7 +19,7 @@ export const sleepToolDefinition = {
         additionalProperties: false
     }
 };
-export async function executeSleep(arguments_, context) {
+export async function executeSleep(arguments_, context, callId) {
     const durationMs = arguments_ && typeof arguments_ === 'object' && !Array.isArray(arguments_)
         ? arguments_.durationMs
         : undefined;
@@ -28,12 +28,19 @@ export async function executeSleep(arguments_, context) {
         durationMs < 1 ||
         durationMs > TOOL_EXECUTION_LIMITS.sleepMaxDurationMs)
         throw new MarAgentError('MAR_AGENT_TOOL_INPUT_INVALID', 'Sleep duration is out of range.');
+    context.signal.throwIfAborted();
     const started = performance.now();
+    await context.emit({
+        type: 'sleep.started',
+        callId,
+        durationMs,
+        startedAt: new Date().toISOString()
+    });
     const messages = context.subagentMessages;
     const outcome = await waitForToolCondition({
         ready: () => messages?.pending() ?? false,
         subscribe: (notify) => messages?.subscribe(notify) ?? (() => { }),
-        waitMs: durationMs,
+        waitMs: Math.max(0, durationMs - (performance.now() - started)),
         signal: context.signal,
         interrupt: context.waitInterrupt
     });

package/dist/agent-core/tools/output-projection.d.ts

@@ -2,6 +2,7 @@ import type { SubagentTaskSnapshot, SubagentManyOutput } from '../subagent/contr
 import type { ApplyPatchResult, ApplyPatchPartialResult, CodeCellEventData, ExecResult, MarAgentToolArtifact, ToolExecutionResult, ReadEventData, ViewImageResult } from './contracts.js';
 import type { ToolRuntimeImage } from './runtime-context.js';
 import type { SleepResult } from './agent/sleep.js';
+import { type PublicToolMetadata } from './public-metadata.js';
 export declare function currentExecutionImages(modelInputImages: readonly {
     readonly mimeType: string;
     readonly dataBase64: string;
@@ -11,7 +12,7 @@ export declare function boundedModelToolOutput(toolName: string, value: string,
     truncated: boolean;
 };
 /** Project only known, validated tool result shapes into public structured events. */
-export declare function structuredToolEventData(toolName: string, value: unknown): CodeCellEventData | ExecResult | ApplyPatchResult | ReadEventData | ViewImageResult | SubagentTaskSnapshot | SubagentManyOutput | SleepResult | undefined;
+export declare function structuredToolEventData(toolName: string, value: unknown): CodeCellEventData | ExecResult | ApplyPatchResult | ReadEventData | ViewImageResult | SubagentTaskSnapshot | SubagentManyOutput | SleepResult | PublicToolMetadata | undefined;
 /** Partial patch facts are allowlisted; arbitrary error details never become public event data. */
 export declare function structuredToolFailureData(toolName: string, error: unknown): ApplyPatchPartialResult | undefined;
 export declare function structuredToolArtifacts(value: readonly MarAgentToolArtifact[] | undefined): readonly MarAgentToolArtifact[] | undefined;

package/dist/agent-core/tools/output-projection.js

@@ -3,6 +3,7 @@ import { parseApplyPatchResult, parseApplyPatchPartialResult } from './shared/pa
 import { AGENT_EXECUTION_POLICY } from '../runtime/execution-policy.js';
 import { countModelTokens, countTextLines, truncateModelText } from '../runtime/token-budget.js';
 import { TOOL_EXECUTION_LIMITS } from './execution-limits.js';
+import { publicToolMetadata } from './public-metadata.js';
 export function currentExecutionImages(modelInputImages, toolImages) {
     return [
         ...(modelInputImages ?? []).map((image) => ({
@@ -35,6 +36,9 @@ export function boundedModelToolOutput(toolName, value, data) {
 export function structuredToolEventData(toolName, value) {
     if (!isRecord(value))
         return undefined;
+    const metadata = publicToolMetadata(toolName, value);
+    if (metadata !== undefined)
+        return metadata;
     if (toolName === 'sleep' &&
         typeof value.durationMs === 'number' &&
         Number.isInteger(value.durationMs) &&

package/dist/agent-core/tools/public-metadata.d.ts

@@ -0,0 +1,23 @@
+export type PublicToolMetadata = ({
+    query?: string;
+    sources?: {
+        url: string;
+        title?: string;
+        snippet?: string;
+    }[];
+    sourceCount?: number;
+} | {
+    url?: string;
+    title?: string;
+    mode?: 'http' | 'browser';
+    status?: number;
+    contentType?: string;
+} | {
+    name: string;
+    description?: string;
+    source?: string;
+}) & {
+    hostedToolKind?: 'WEB_SEARCH' | 'WEB_FETCH';
+};
+/** Public metadata only; page bodies and skill instructions stay in the bounded output. */
+export declare function publicToolMetadata(toolName: string, value: Record<string, unknown>): PublicToolMetadata | undefined;

package/dist/agent-core/tools/public-metadata.js

@@ -0,0 +1,56 @@
+/** 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 === 'web_search') {
+        const entries = Array.isArray(value.results)
+            ? value.results
+            : Array.isArray(value.sources)
+                ? value.sources
+                : undefined;
+        const sources = entries?.flatMap((entry) => {
+            if (!entry || typeof entry !== 'object' || Array.isArray(entry))
+                return [];
+            const source = entry;
+            if (typeof source.url !== 'string' || !source.url)
+                return [];
+            return [
+                {
+                    url: source.url.slice(0, 8192),
+                    ...(typeof source.title === 'string' ? { title: source.title.slice(0, 1000) } : {}),
+                    ...(typeof source.snippet === 'string' ? { snippet: source.snippet.slice(0, 2000) } : {})
+                }
+            ];
+        });
+        return {
+            ...(text('query', 500) === undefined ? {} : { query: text('query', 500) }),
+            ...(sources === undefined
+                ? {}
+                : {
+                    sources: sources.slice(0, 20),
+                    ...(value.sourcesTruncated === true ? {} : { sourceCount: sources.length })
+                })
+        };
+    }
+    if (toolName === 'web_fetch')
+        return {
+            ...(text('url', 8192) === undefined ? {} : { url: text('url', 8192) }),
+            ...(text('title', 1000) === undefined ? {} : { title: text('title', 1000) }),
+            ...(value.mode === 'http' || value.mode === 'browser' ? { mode: value.mode } : {}),
+            ...(typeof value.status === 'number' &&
+                Number.isInteger(value.status) &&
+                value.status >= 100 &&
+                value.status <= 599
+                ? { status: value.status }
+                : {}),
+            ...(text('contentType', 256) === undefined ? {} : { contentType: text('contentType', 256) })
+        };
+    if (toolName === 'skill' && typeof value.name === 'string')
+        return {
+            name: value.name.slice(0, 128),
+            ...(text('description', 2000) === undefined
+                ? {}
+                : { description: text('description', 2000) }),
+            ...(text('source', 4096) === undefined ? {} : { source: text('source', 4096) })
+        };
+    return undefined;
+}

package/dist/agent-core/tools/runtime-context.d.ts

@@ -4,6 +4,11 @@ import type { AgentSkill } from '../runtime/context/instructions.js';
 import type { SubagentController, SubagentLatestMessage } from '../subagent/scheduler.js';
 import type { TodoStore } from './agent/todo.js';
 export type ToolRuntimeEvent = {
+    type: 'sleep.started';
+    callId: string;
+    durationMs: number;
+    startedAt: string;
+} | {
     type: 'todo.updated';
     revision: number;
     items: readonly import('./agent/todo.js').TodoItem[];

package/package.json

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