@myagentroam/agent 0.12.2 → 0.12.3

package/dist/host/local-exec-tool.d.ts

@@ -1,5 +1,5 @@
 import { type LocalProcessExecutor } from './local-process-executor.js';
-import type { ExecOutputSnapshot, ExecResult } from '../tools/contracts.js';
+import type { ExecOutputSnapshot, ExecResult, ExecutionSource } from '../tools/contracts.js';
 import { type ToolWaitInterrupt } from '../tools/wait.js';
 import { WorkspacePathResolver } from '../tools/shared/path-resolver.js';
 import { type ExtensionProcessInput, type ExtensionProcessHandle } from '../extensions/processes.js';
@@ -13,7 +13,7 @@ export declare class ExecTool {
     private readonly shell?;
     private readonly processExecutor;
     constructor(paths: WorkspacePathResolver, maxOutputBytes?: number, maxProcesses?: number, environment?: NodeJS.ProcessEnv, shell?: string | undefined, processExecutor?: LocalProcessExecutor);
-    execute(arguments_: unknown, signal?: AbortSignal, owner?: NonNullable<import('./local-process-executor.js').LocalProcessSpawnRequest['owner']>, waitInterrupt?: ToolWaitInterrupt, onOutput?: (output: ExecOutputSnapshot) => Promise<void>): Promise<ExecResult>;
+    execute(arguments_: unknown, signal?: AbortSignal, owner?: NonNullable<import('./local-process-executor.js').LocalProcessSpawnRequest['owner']>, waitInterrupt?: ToolWaitInterrupt, onOutput?: (output: ExecOutputSnapshot) => Promise<void>, onExecutionSource?: (source: ExecutionSource) => Promise<void> | void): Promise<ExecResult>;
     spawn(input: ExtensionProcessInput, call: ExtensionOperationContext): Promise<ExtensionProcessHandle>;
     listSessionResources(sessionId: string): {
         processId: string;

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

@@ -6,6 +6,14 @@ import { TOOL_EXECUTION_LIMITS } from '../tools/execution-limits.js';
 import { waitForToolCondition, waitMetadata } from '../tools/wait.js';
 import { validateCoreProcessInput } from '../extensions/processes.js';
 import { parseExecInput } from '../tools/local/exec.js';
+function processSource(process) {
+    return {
+        kind: 'SHELL',
+        text: process.command.slice(0, 10_000),
+        cwd: process.cwd.slice(0, 10_000),
+        truncated: process.command.length > 10_000 || process.cwd.length > 10_000
+    };
+}
 export class ExecTool {
     paths;
     maxOutputBytes;
@@ -25,7 +33,7 @@ export class ExecTool {
         this.shell = shell;
         this.processExecutor = processExecutor;
     }
-    async execute(arguments_, signal, owner, waitInterrupt, onOutput) {
+    async execute(arguments_, signal, owner, waitInterrupt, onOutput, onExecutionSource) {
         if (signal?.aborted)
             throw executionAbortReason(signal);
         const input = parseExecInput(arguments_);
@@ -36,6 +44,10 @@ export class ExecTool {
             if (completed) {
                 if (owner !== undefined && completed.ownerSessionId !== owner.sessionId)
                     throw new AgentError('MAR_AGENT_PROCESS_NOT_FOUND', 'Managed process was not found.');
+                if (onExecutionSource)
+                    await onExecutionSource(processSource(completed));
+                if (signal?.aborted)
+                    throw executionAbortReason(signal);
                 if (input.action === 'write')
                     throw new AgentError('MAR_AGENT_TOOL_INPUT_INVALID', 'Completed process cannot accept input.');
                 if (input.action === 'cancel')
@@ -52,6 +64,10 @@ export class ExecTool {
                 process.native ||
                 (owner !== undefined && process.ownerSessionId !== owner.sessionId))
                 throw new AgentError('MAR_AGENT_PROCESS_NOT_FOUND', 'Managed process was not found.');
+            if (onExecutionSource)
+                await onExecutionSource(processSource(process));
+            if (signal?.aborted)
+                throw executionAbortReason(signal);
             let outcome;
             if (input.action === 'poll' && input.yieldMs)
                 outcome = await waitForProcessCompletion(input.processId, process, Math.min(Math.max(input.yieldMs, 0), TOOL_EXECUTION_LIMITS.execMaxPollYieldMs), signal, waitInterrupt, onOutput);
@@ -427,12 +443,7 @@ export class ExecTool {
                 stdoutDroppedBytes: stdout.droppedBytes,
                 stderrDroppedBytes: stderr.droppedBytes,
                 displayOutput: displayOutput(process),
-                executionSource: {
-                    kind: 'SHELL',
-                    text: process.command.slice(0, 10_000),
-                    cwd: process.cwd.slice(0, 10_000),
-                    truncated: process.command.length > 10_000 || process.cwd.length > 10_000
-                }
+                executionSource: processSource(process)
             }
         });
         while (this.#completed.size > TOOL_EXECUTION_LIMITS.execMaxCompletedResults)
@@ -496,12 +507,7 @@ export class ExecTool {
             stdoutDroppedBytes: stdout.droppedBytes,
             stderrDroppedBytes: stderr.droppedBytes,
             displayOutput: displayOutput(process),
-            executionSource: {
-                kind: 'SHELL',
-                text: process.command.slice(0, 10_000),
-                cwd: process.cwd.slice(0, 10_000),
-                truncated: process.command.length > 10_000 || process.cwd.length > 10_000
-            }
+            executionSource: processSource(process)
         };
     }
     async dispose() {

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

@@ -98,7 +98,7 @@ export class LocalToolRegistry {
                                     ? {}
                                     : { ownerInstanceId: context.operation.ownerInstanceId })
                             })
-                    }, context.waitInterrupt, context.onOutput);
+                    }, context.waitInterrupt, context.onOutput, context.onExecutionSource);
                     return formatExecResult(result);
                 }
             ])

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

@@ -298,6 +298,9 @@ export class CodeCells {
         const cell = this.#cells.get(input.cellId);
         if (!cell || cell.sessionId !== context.sessionId)
             throw new AgentError('MAR_AGENT_CODE_CELL_NOT_FOUND', 'Code Exec cell is unavailable in this Session.');
+        if (context.onExecutionSource)
+            await context.onExecutionSource({ ...cell.source });
+        context.signal.throwIfAborted();
         if (input.action === 'cancel' && cell.status === 'running') {
             cell.controller.abort(new AgentError('MAR_AGENT_CODE_CANCELLED', 'Code Exec cell was terminated.'));
             await new Promise((resolve, reject) => {

package/dist/tools/contracts.d.ts

@@ -33,6 +33,8 @@ export interface ToolExecutionContext {
     waitInterrupt?: import('./wait.js').ToolWaitInterrupt | undefined;
     /** Live-only process output; does not consume the eventual tool result. */
     onOutput?: (output: ExecOutputSnapshot) => Promise<void>;
+    /** Publish owner-confirmed source metadata before waiting, without consuming output. */
+    onExecutionSource?: (source: ExecutionSource) => Promise<void> | void;
     sessionId: string;
     executionId: string;
     /** Current model identity for neutral Host-owned tool policies. */

package/dist/tools/runtime.js

@@ -53,6 +53,13 @@ export async function executeCapturedTool(kind, call, context) {
         ...((name === 'exec' || name === 'exec_wait' || name === 'code_exec_wait') &&
             callId !== undefined
             ? {
+                onExecutionSource: (source) => context.emit({
+                    type: 'tool.updated',
+                    toolName: name,
+                    callId,
+                    ...(context.parentCallId === undefined ? {} : { parentCallId: context.parentCallId }),
+                    data: { executionSource: source }
+                }),
                 onOutput: (output) => context.emit({
                     type: 'tool.output',
                     toolName: name,

package/package.json

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