@myagentroam/agent 0.10.54 → 0.10.56

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

@@ -92,7 +92,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;
+    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;
 } | {
     type: 'tool.failed';
     resultExtensions?: readonly import('../tools/result-extensions.js').ToolResultExtension[];

package/dist/agent-core/sdk/session.js

@@ -1004,7 +1004,8 @@ export function createSessionOpener(services) {
                             ...(subagents === undefined || mode === 'compact'
                                 ? {}
                                 : {
-                                    subagents: coreExtensions.bindAgents(subagents.captureExecution(executionId))
+                                    subagents: coreExtensions.bindAgents(subagents.captureExecution(executionId)),
+                                    subagentMessages: subagents.modelMessages
                                 }),
                             mode,
                             sessionId,

package/dist/agent-core/subagent/session-controller.d.ts

@@ -1,3 +1,4 @@
+import { type ToolWaitInterrupt } from '../tools/wait.js';
 import type { CoreOperationContext } from '../extensions/operation.js';
 import type { MarAgentReasoningEffort } from '../model/configuration.js';
 import type { ExecutionResult } from '../runtime/contracts.js';
@@ -89,6 +90,7 @@ export declare class SubagentSessionController implements SubagentController {
         maxTasks: number;
         maxConcurrent: number;
     };
+    readonly modelMessages: ToolWaitInterrupt;
     private constructor();
     static open(input: {
         readonly parentSessionId: string;

package/dist/agent-core/subagent/session-controller.js

@@ -13,6 +13,19 @@ export class SubagentSessionController {
     #queue = [];
     #completionWaiters = new Set();
     #activityWaiters = new Set();
+    modelMessages = {
+        pending: () => [...this.#agents.values()].some((state) => state.messageRevision > state.observedMessageRevision),
+        subscribe: (listener) => {
+            const notify = (activity) => {
+                if (activity.kind === 'message')
+                    listener();
+            };
+            this.#activityWaiters.add(notify);
+            return () => {
+                this.#activityWaiters.delete(notify);
+            };
+        }
+    };
     #nativeObservations = new Map();
     #activityRevision = 0;
     #resourceRevision = 0;

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

@@ -0,0 +1,12 @@
+import type { ClientToolDefinition } from '../../model/contracts.js';
+import type { ToolRuntimeContext } from '../runtime-context.js';
+export interface SleepResult {
+    durationMs: number;
+    elapsedMs: number;
+    wakeReason: 'elapsed' | 'steer' | 'subagent_message';
+}
+export declare const sleepToolDefinition: ClientToolDefinition;
+export declare function executeSleep(arguments_: unknown, context: ToolRuntimeContext): Promise<{
+    content: string;
+    data: SleepResult;
+}>;

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

@@ -0,0 +1,47 @@
+import { MarAgentError } from '../../error.js';
+import { TOOL_EXECUTION_LIMITS } from '../execution-limits.js';
+import { waitForToolCondition } from '../wait.js';
+export const sleepToolDefinition = {
+    name: 'sleep',
+    allowedCallers: ['direct'],
+    parallelSafety: 'serial',
+    description: 'Pause for up to durationMs milliseconds. Returns early when user input or a new public subagent message is available. Returns elapsed time and the wake reason.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            durationMs: {
+                type: 'integer',
+                minimum: 1,
+                maximum: TOOL_EXECUTION_LIMITS.sleepMaxDurationMs
+            }
+        },
+        required: ['durationMs'],
+        additionalProperties: false
+    }
+};
+export async function executeSleep(arguments_, context) {
+    const durationMs = arguments_ && typeof arguments_ === 'object' && !Array.isArray(arguments_)
+        ? arguments_.durationMs
+        : undefined;
+    if (typeof durationMs !== 'number' ||
+        !Number.isInteger(durationMs) ||
+        durationMs < 1 ||
+        durationMs > TOOL_EXECUTION_LIMITS.sleepMaxDurationMs)
+        throw new MarAgentError('MAR_AGENT_TOOL_INPUT_INVALID', 'Sleep duration is out of range.');
+    const started = performance.now();
+    const messages = context.subagentMessages;
+    const outcome = await waitForToolCondition({
+        ready: () => messages?.pending() ?? false,
+        subscribe: (notify) => messages?.subscribe(notify) ?? (() => { }),
+        waitMs: durationMs,
+        signal: context.signal,
+        interrupt: context.waitInterrupt
+    });
+    context.signal.throwIfAborted();
+    const data = {
+        durationMs,
+        elapsedMs: performance.now() - started,
+        wakeReason: outcome === 'ready' ? 'subagent_message' : outcome === 'interrupted' ? 'steer' : 'elapsed'
+    };
+    return { content: JSON.stringify(data), data };
+}

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

@@ -19,6 +19,7 @@ export function allowsToolCaller(tool, caller) {
             'tool_search',
             'question',
             'skill',
+            'sleep',
             'agent_start',
             'agent_wait',
             'agent_message',

package/dist/agent-core/tools/execution-limits.d.ts

@@ -47,6 +47,7 @@ export declare const TOOL_EXECUTION_LIMITS: Readonly<{
     agentWaitDefaultWaitMs: 30000;
     agentWaitMaxWaitMs: 300000;
     agentWaitMaxAgents: 8;
+    sleepMaxDurationMs: 300000;
     subagentDescriptionMaxCharacters: 80;
     subagentPromptMaxBytes: 131072;
     subagentMessageMaxBytes: 131072;

package/dist/agent-core/tools/execution-limits.js

@@ -47,6 +47,7 @@ export const TOOL_EXECUTION_LIMITS = Object.freeze({
     agentWaitDefaultWaitMs: 30_000,
     agentWaitMaxWaitMs: 300_000,
     agentWaitMaxAgents: 8,
+    sleepMaxDurationMs: 300_000,
     subagentDescriptionMaxCharacters: 80,
     subagentPromptMaxBytes: 131_072,
     subagentMessageMaxBytes: 131_072,

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

@@ -1,6 +1,7 @@
 import type { SubagentTaskSnapshot, SubagentManyOutput } from '../subagent/contracts.js';
 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';
 export declare function currentExecutionImages(modelInputImages: readonly {
     readonly mimeType: string;
     readonly dataBase64: string;
@@ -10,7 +11,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 | undefined;
+export declare function structuredToolEventData(toolName: string, value: unknown): CodeCellEventData | ExecResult | ApplyPatchResult | ReadEventData | ViewImageResult | SubagentTaskSnapshot | SubagentManyOutput | SleepResult | 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

@@ -35,6 +35,22 @@ export function boundedModelToolOutput(toolName, value, data) {
 export function structuredToolEventData(toolName, value) {
     if (!isRecord(value))
         return undefined;
+    if (toolName === 'sleep' &&
+        typeof value.durationMs === 'number' &&
+        Number.isInteger(value.durationMs) &&
+        value.durationMs >= 1 &&
+        value.durationMs <= TOOL_EXECUTION_LIMITS.sleepMaxDurationMs &&
+        typeof value.elapsedMs === 'number' &&
+        Number.isFinite(value.elapsedMs) &&
+        value.elapsedMs >= 0 &&
+        (value.wakeReason === 'elapsed' ||
+            value.wakeReason === 'steer' ||
+            value.wakeReason === 'subagent_message'))
+        return {
+            durationMs: value.durationMs,
+            elapsedMs: value.elapsedMs,
+            wakeReason: value.wakeReason
+        };
     if (toolName === 'agent_wait' &&
         (value.mode === 'any' || value.mode === 'all') &&
         (value.waitFor === 'completion' || value.waitFor === 'message') &&

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

@@ -13,6 +13,7 @@ import { executeTodoWrite, todoWriteToolDefinition } from './agent/todo-write.js
 import { executeToolSearch, toolSearchToolDefinition } from './mcp/tool-search.js';
 import { viewImageToolDefinition } from './local/view-image.js';
 import { smartCompactToolDefinition, executeSmartCompact } from './agent/smart-compact.js';
+import { executeSleep, sleepToolDefinition } from './agent/sleep.js';
 export const BUILTIN_TOOL_DEFINITIONS = [
     skillToolDefinition,
     toolSearchToolDefinition,
@@ -30,10 +31,12 @@ export const BUILTIN_TOOL_DEFINITIONS = [
     agentWaitToolDefinition,
     agentMessageToolDefinition,
     agentCancelToolDefinition,
-    smartCompactToolDefinition
+    smartCompactToolDefinition,
+    sleepToolDefinition
 ];
 export const AGENT_TOOL_HANDLERS = new Map([
     ['skill', executeSkill],
+    ['sleep', executeSleep],
     ['smart_compact', executeSmartCompact],
     ['tool_search', executeToolSearch],
     ['question', executeQuestion],

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

@@ -48,6 +48,7 @@ export interface ToolRuntimeContext {
     modelId?: string;
     signal: AbortSignal;
     waitInterrupt?: import('./wait.js').ToolWaitInterrupt | undefined;
+    subagentMessages?: import('./wait.js').ToolWaitInterrupt;
     permissionPolicy?: import('./permissions.js').ExecutionToolPermissions;
     parentCallId?: string;
     writeToolResultResource?: import('./result-extensions.js').ToolResultResourceWriter;

package/package.json

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