@myagentroam/agent 0.9.118 → 0.9.120

package/dist/model/contracts.d.ts

@@ -122,6 +122,11 @@ export type ModelEvent = {
         query?: string | undefined;
         url?: string | undefined;
         title?: string | undefined;
+        sources?: readonly {
+            url: string;
+            title?: string | undefined;
+        }[] | undefined;
+        sourcesTruncated?: boolean | undefined;
     };
 } | {
     type: 'citation';

package/dist/model/openai-responses.js

@@ -282,6 +282,7 @@ export class OpenAiResponsesAdapter {
         const pendingCompletedText = new Map();
         const emittedCompletedText = new Set();
         const emittedFunctionCalls = new Set();
+        const hostedWebCalls = new Map();
         try {
             for await (const raw of rawEvents) {
                 const event = record(raw);
@@ -427,20 +428,25 @@ export class OpenAiResponsesAdapter {
                 else if (type.includes('web_search_call') ||
                     text(record(event.item).type) === 'web_search_call') {
                     const item = record(event.item);
+                    const itemId = text(event.item_id) ?? text(item.id) ?? 'web';
+                    const previous = hostedWebCalls.get(itemId);
                     const action = record(Object.keys(record(event.action)).length ? event.action : item.action);
                     const actionType = text(action.type);
+                    const kind = actionType === 'open_page' || actionType === 'find_in_page'
+                        ? 'WEB_FETCH'
+                        : (previous?.kind ?? 'WEB_SEARCH');
+                    const summary = { ...previous?.summary, ...hostedWebActionSummary(action) };
+                    hostedWebCalls.set(itemId, { kind, summary });
                     yield {
                         type: 'hosted_tool',
-                        itemId: text(event.item_id) ?? 'web',
-                        kind: actionType === 'open_page' || actionType === 'find_in_page'
-                            ? 'WEB_FETCH'
-                            : 'WEB_SEARCH',
+                        itemId,
+                        kind,
                         status: type.endsWith('.failed')
                             ? 'FAILED'
                             : type.endsWith('.completed') || type === 'response.output_item.done'
                                 ? 'COMPLETED'
                                 : 'RUNNING',
-                        summary: { query: text(action.query), url: text(action.url) }
+                        summary
                     };
                 }
                 else if (type === 'response.output_text.annotation.added') {
@@ -884,7 +890,12 @@ function responsesRequestBody(configuration, request, messages, prefixIdentity =
         parallel_tool_calls: !lite,
         store: false,
         text: { verbosity: 'low' },
-        include: ['reasoning.encrypted_content'],
+        include: [
+            'reasoning.encrypted_content',
+            ...(configuration.hostedWebSearch && request.allowTools !== false && toolChoice !== 'none'
+                ? ['web_search_call.action.sources']
+                : [])
+        ],
         ...(request.promptCacheKey ? { prompt_cache_key: request.promptCacheKey } : {}),
         reasoning: {
             effort: request.requestReasoningEffort?.trim() ||
@@ -1512,6 +1523,41 @@ const RESPONSE_ITEM_TYPES = new Set([
 ]);
 // A freeform patch item can contain the complete 4 MiB patch plus its JSON envelope.
 const MAX_RESPONSE_ITEM_BYTES = 5 * 1024 * 1024;
+function hostedWebActionSummary(action) {
+    const queries = Array.isArray(action.queries)
+        ? action.queries
+            .slice(0, 10)
+            .filter((query) => typeof query === 'string' && query.length > 0)
+        : [];
+    const query = text(action.query) || queries.join('\n');
+    const url = text(action.url);
+    const title = text(action.title);
+    const sources = Array.isArray(action.sources)
+        ? action.sources
+            .slice(0, 20)
+            .map((source) => {
+            const value = record(source);
+            const sourceUrl = text(value.url);
+            if (!sourceUrl)
+                return undefined;
+            const sourceTitle = text(value.title);
+            return {
+                url: sourceUrl.slice(0, 2048),
+                ...(sourceTitle ? { title: sourceTitle.slice(0, 256) } : {})
+            };
+        })
+            .filter((source) => source !== undefined)
+        : [];
+    return {
+        ...(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) && action.sources.length > 20
+            ? { sourcesTruncated: true }
+            : {})
+    };
+}
 function responseItem(value) {
     const item = record(value);
     const itemType = text(item.type);

package/dist/sdk/types.d.ts

@@ -122,6 +122,11 @@ export type MarAgentEvent = MarAgentEventBase & ({
         query?: string | undefined;
         url?: string | undefined;
         title?: string | undefined;
+        sources?: readonly {
+            url: string;
+            title?: string | undefined;
+        }[] | undefined;
+        sourcesTruncated?: boolean | undefined;
     };
 } | {
     type: 'citation.added';

package/package.json

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