@myagentroam/agent 0.9.82 → 0.9.83

package/dist/prompts/compact.js

@@ -9,7 +9,7 @@ Preserve, when present:
 - confirmed decisions, constraints, interfaces, invariants, assumptions that still matter, and exact identifiers;
 - completed actions and edits with exact file paths, symbols, commands, migrations, or external state changes;
 - verification actually run and its result, important tool evidence, reproducible errors, failed approaches and what they proved;
-- unresolved questions, blockers, risks, uncommitted changes, Todo/plan state, pending approvals, and live/background process or subagent state;
+- unresolved questions, blockers, risks, uncommitted changes, Todo/plan state, and pending approvals;
 - the next concrete action and the evidence still required before completion.
 
 Distinguish clearly between completed, attempted, planned, inferred, and unverified work. Newer user instructions override older ones; retain superseded instructions only when needed to explain current state. Never invent completion, test results, file contents, permissions, or external effects.
@@ -17,6 +17,7 @@ Distinguish clearly between completed, attempted, planned, inferred, and unverif
 Remove aggressively:
 - greetings, acknowledgements, progress chatter, repeated instructions, repeated status, and conclusions already represented once;
 - user-level, project-level, or directory-level AGENTS.md instructions and constraints derived only from those files, because the next Execution reloads and replaces them separately;
+- retained process/Subagent inventory, IDs, status, commands, cwd, and reuse instructions, because Runtime reloads and replaces that state separately;
 - raw long logs, large source excerpts, verbose tool payloads, duplicated search/read output, and implementation detail recoverable from named files or commands;
 - abandoned hypotheses and failed attempts that do not constrain the next action;
 - hidden reasoning, secrets, credentials, authorization values, and unrelated conversation.
@@ -52,7 +53,7 @@ branch changed -> inherited_evidence=unverified
 - direct user/caller authorization、prohibition、exclusion 保留 exact action/scope，不概括成更宽泛边界。
 
 2. 当前状态 / Current state
-- 对象：file、symbol、feature、migration、test、worktree、process、subagent、selected Skill、Todo/plan、approval、external side effect。
+- 对象：file、symbol、feature、migration、test、worktree、selected Skill、Todo/plan、approval、external side effect。retained process/subagent inventory 由 Runtime 重建，不进入 IR。
 - 分离 completion（pending / in_progress / completed / blocked）、epistemic（observed / verified / inferred / proposed / disproved）、freshness（current / stale / superseded）、scope（turn / worktree / base / branch / external system）；仅在消歧时标注。
 - 明确 completed、not started、unverified、active。相同精度下选择更短状态原子；中文、English 均可，如 根因已证、edit=pending、tests=not run。
 - selected Skill | 保留仍适用的 skill name + 续作必需约束；Todo/plan | 保留 revision、item/status、当前最小 step。
@@ -70,7 +71,7 @@ branch changed -> inherited_evidence=unverified
 - 下一 Agent 无法使用、仅供 local storage validation 的 integrity hash：删除。
 
 5. 未闭环 / Open loops
-- unresolved、unverified、blocker、pending approval、活动 process/subagent、Todo/plan current step、仍需 evidence。
+- unresolved、unverified、blocker、pending approval、Todo/plan current step、仍需 evidence。
 - 只保留已确定的最小 next action + preconditions；不复制可重算的长 plan。
 
 编译规则：
@@ -85,7 +86,7 @@ observed HEAD、validated base、target commit、current worktree 不得折叠
 
 语言：标题/一般叙述跟随 latest active user instructions 和当前任务主语言；每条 record 按局部精度与密度选择中文、English 或 mixed phrasing。保留 established term/exact identifier，不为语言统一展开或翻译。English codebase 不等于 English handoff。
 
-删除 greetings、progress chatter、过程叙事、重复事实、无剩余约束的 superseded hypothesis、长日志、source body、verbose payload、可从精确 path/command 廉价恢复的正文。删除 user/project/directory AGENTS.md 正文及仅由这些文件派生的 constraint，包括其中 exclusions；下一 Execution 会重新加载并整体替换。不得保留 hidden reasoning、secret、credential、无关内容。
+删除 greetings、progress chatter、过程叙事、重复事实、无剩余约束的 superseded hypothesis、长日志、source body、verbose payload、可从精确 path/command 廉价恢复的正文。删除 user/project/directory AGENTS.md 正文及仅由这些文件派生的 constraint，包括其中 exclusions；下一 Execution 会重新加载并整体替换。删除 retained process/Subagent inventory、ID、status、command、cwd 和 reuse instruction；Runtime 会重新加载并替换。不得保留 hidden reasoning、secret、credential、无关内容。
 
 只输出 compact Markdown IR。`;
 }

package/dist/prompts/index.d.ts

@@ -1,8 +1,7 @@
 import type { ExecutionMode } from '../sdk/types.js';
 import { type ExecutionBudgetPromptState } from './execution-budget.js';
-import { type RetainedSessionResources } from './resources.js';
 import { type CurrentAgentModel, type SubagentModelOption } from './subagent.js';
-export declare const MAR_AGENT_PROMPT_VERSION = "1.49";
+export declare const MAR_AGENT_PROMPT_VERSION = "1.50";
 export declare function buildSystemPrompt(input: {
     mode: ExecutionMode;
     platform: string;
@@ -16,7 +15,6 @@ export declare function buildSystemPrompt(input: {
     tools: readonly string[];
     currentAgentModel?: CurrentAgentModel;
     subagentModels?: readonly SubagentModelOption[];
-    retainedSessionResources?: RetainedSessionResources;
     executionBudget?: ExecutionBudgetPromptState;
     highDensityCompaction?: boolean;
     extension?: string | undefined;

package/dist/prompts/index.js

@@ -3,10 +3,9 @@ import { environmentPrompt, identityPrompt, instructionPriorityPrompt, workspace
 import { executionBudgetPrompt } from './execution-budget.js';
 import { modePrompt } from './modes.js';
 import { outputStylePrompt } from './output.js';
-import { retainedSessionResourcesPrompt } from './resources.js';
 import { subagentModelOptionsPrompt, subagentPrompt, currentAgentModelPrompt } from './subagent.js';
 import { interactionPrompt, longRunningPrompt, safetyPrompt, toolUsagePrompt, workflowPrompt } from './workflow.js';
-export const MAR_AGENT_PROMPT_VERSION = '1.49';
+export const MAR_AGENT_PROMPT_VERSION = '1.50';
 export function buildSystemPrompt(input) {
     const toolNames = new Set(input.tools);
     const hasLongRunningCapability = [
@@ -28,9 +27,6 @@ export function buildSystemPrompt(input) {
         environmentPrompt(input),
         input.tools.length > 0 ? toolUsagePrompt(input.tools) : '',
         hasLongRunningCapability ? longRunningPrompt(input.tools) : '',
-        input.retainedSessionResources
-            ? retainedSessionResourcesPrompt(input.retainedSessionResources)
-            : '',
         input.executionBudget ? executionBudgetPrompt(input.executionBudget) : '',
         modePrompt(input.mode, {
             questionAvailable: toolNames.has('question'),

package/dist/prompts/resources.d.ts

@@ -12,4 +12,5 @@ export interface RetainedSessionResources {
         description: string;
     }[];
 }
-export declare function retainedSessionResourcesPrompt(input: RetainedSessionResources): string;
+export declare function retainedSessionResourcesSnapshot(input: RetainedSessionResources): string | undefined;
+export declare function retainedSessionResourcesUpdate(snapshot: string | undefined, previousSnapshot: string | undefined, previousMayContainResources?: boolean): string | undefined;

package/dist/prompts/resources.js

@@ -1,31 +1,42 @@
-export function retainedSessionResourcesPrompt(input) {
+export function retainedSessionResourcesSnapshot(input) {
     if (input.processes.length === 0 && input.subagents.length === 0)
-        return '';
+        return undefined;
+    const processes = [...input.processes].sort((left, right) => left.processId.localeCompare(right.processId));
+    const subagents = [...input.subagents].sort((left, right) => left.agentId.localeCompare(right.agentId));
     return [
         '# Retained Session resources',
         'These resources belong to this Session and survived the previous Execution. Reuse their stable IDs instead of starting duplicate processes or subagents.',
-        input.processes.length === 0
-            ? ''
-            : 'Cancelling a managed process releases that process resource.',
-        input.subagents.length === 0
+        processes.length === 0 ? '' : 'Cancelling a managed process releases that process resource.',
+        subagents.length === 0
             ? ''
             : 'agent_cancel stops only the current child turn and retains its Session for later messages or explicit deletion.',
         input.idleTtlMs === undefined
             ? ''
             : `When the Session becomes idle again, unclaimed resources are retained for up to ${input.idleTtlMs} ms.`,
-        input.processes.length === 0
+        processes.length === 0
             ? ''
             : [
                 'Managed processes:',
-                ...input.processes.map((process) => `- processId: ${process.processId}; status: ${process.status}; cwd: ${process.cwd}; command: ${process.command}`)
+                ...processes.map((process) => `- processId: ${process.processId}; status: ${process.status}; cwd: ${process.cwd}; command: ${process.command}`)
             ].join('\n'),
-        input.subagents.length === 0
+        subagents.length === 0
             ? ''
             : [
                 'Subagents:',
-                ...input.subagents.map((task) => `- agentId: ${task.agentId}; status: ${task.status}; description: ${task.description}`)
+                ...subagents.map((task) => `- agentId: ${task.agentId}; status: ${task.status}; description: ${task.description}`)
             ].join('\n')
     ]
         .filter(Boolean)
         .join('\n');
 }
+export function retainedSessionResourcesUpdate(snapshot, previousSnapshot, previousMayContainResources = false) {
+    if (!previousMayContainResources && snapshot === previousSnapshot)
+        return undefined;
+    if (!snapshot)
+        return previousSnapshot || previousMayContainResources
+            ? 'The previously provided retained Session resources no longer apply. No retained processes or subagents remain.'
+            : undefined;
+    return previousSnapshot || previousMayContainResources
+        ? `This replaces all previously provided retained Session resources.\n\n${snapshot}`
+        : snapshot;
+}

package/dist/sdk/agent.js

@@ -18,6 +18,7 @@ import { DEFAULT_COMPACTION_FOCUS, CompactionOperation, buildCompactionInput, bu
 import { buildSystemPrompt, MAR_AGENT_PROMPT_VERSION } from '../prompts/index.js';
 import { buildEnvironmentContext } from '../prompts/core.js';
 import { modelOutputContinuationMessage } from '../prompts/output.js';
+import { retainedSessionResourcesSnapshot, retainedSessionResourcesUpdate } from '../prompts/resources.js';
 import { environmentContextUpdate, restoreEnvironmentState } from '../runtime/environment-context.js';
 import { childSubagentInstruction } from '../prompts/subagent.js';
 import { sessionTitlePrompt } from '../prompts/title.js';
@@ -249,22 +250,24 @@ export async function createMarAgent(options) {
                     const sessionState = await store.readExecutionState(sessionId);
                     const todo = TodoStore.restore(sessionState.todo);
                     const contextRecords = sessionState.contextRecords;
-                    const contextualInstructionGeneration = latestContextualInstructionGeneration(contextRecords);
-                    const restoredContextualInstructions = sessionRuntime.contextualInstructions;
-                    let contextualInstructions;
-                    if (restoredContextualInstructions === undefined ||
-                        restoredContextualInstructions.generation !== contextualInstructionGeneration) {
-                        contextualInstructions = {
-                            generation: contextualInstructionGeneration,
+                    const contextualWorldStateGeneration = latestContextualWorldStateGeneration(contextRecords);
+                    const restoredContextualWorldState = sessionRuntime.contextualWorldState;
+                    let contextualWorldState;
+                    if (restoredContextualWorldState === undefined ||
+                        restoredContextualWorldState.generation !== contextualWorldStateGeneration) {
+                        contextualWorldState = {
+                            generation: contextualWorldStateGeneration,
                             initialized: false,
-                            snapshot: undefined,
+                            instructionSnapshot: undefined,
+                            resourceSnapshot: undefined,
                             entries: []
                         };
-                        sessionRuntime.contextualInstructions = contextualInstructions;
+                        sessionRuntime.contextualWorldState = contextualWorldState;
                     }
                     else
-                        contextualInstructions = restoredContextualInstructions;
+                        contextualWorldState = restoredContextualWorldState;
                     const compactMayContainAgentInstructions = contextRecords.some((record) => compactSummaryFromCheckpoint(record) !== undefined);
+                    const compactMayContainRetainedResources = compactHistoryMayContainRetainedResources(contextRecords);
                     const restored = await restoreMessages(store, sessionId, contextRecords, {
                         includeImages: mode !== 'compact'
                     });
@@ -462,29 +465,29 @@ export async function createMarAgent(options) {
                         agentInstructionInsertIndex &&
                         messages[agentInstructionInsertIndex - 1]?.contextKind === 'environment')
                         agentInstructionInsertIndex--;
-                    if (!contextualInstructions.initialized ||
-                        contextualInstructions.snapshot !== currentInstructionSnapshot) {
-                        const content = renderAgentInstructions(instructionEntries, compactMayContainAgentInstructions || contextualInstructions.entries.length > 0);
-                        if (content !== undefined)
-                            contextualInstructions.entries.push({
-                                index: agentInstructionInsertIndex,
-                                content
-                            });
-                        contextualInstructions.snapshot = currentInstructionSnapshot;
-                        contextualInstructions.initialized = true;
-                    }
                     const tools = withCodeModeResultTypes(availableTools.filter((tool) => tool.name !== 'skill' || (instructionContext?.skills.size ?? 0) > 0));
                     const executionTools = tools;
-                    const hostResources = (await options.host.listSessionResources?.(sessionId)) ?? {
-                        processes: []
-                    };
-                    const retainedSessionResources = {
-                        ...(hostResources.idleTtlMs === undefined
-                            ? {}
-                            : { idleTtlMs: hostResources.idleTtlMs }),
-                        processes: hostResources.processes,
-                        subagents: subagents?.listSessionResources() ?? []
+                    const loadRetainedSessionResources = async () => {
+                        const hostResources = (await options.host.listSessionResources?.(sessionId)) ?? {
+                            processes: []
+                        };
+                        return {
+                            ...(hostResources.idleTtlMs === undefined
+                                ? {}
+                                : { idleTtlMs: hostResources.idleTtlMs }),
+                            processes: hostResources.processes,
+                            subagents: subagents?.listSessionResources() ?? []
+                        };
                     };
+                    let currentResourceSnapshot = retainedSessionResourcesSnapshot(await loadRetainedSessionResources());
+                    contextualWorldState = updateContextualWorldState(contextualWorldState, agentInstructionInsertIndex, {
+                        instructionSnapshot: currentInstructionSnapshot,
+                        instructionContent: renderAgentInstructions(instructionEntries, compactMayContainAgentInstructions ||
+                            contextualWorldState.instructionSnapshot !== undefined),
+                        resourceSnapshot: currentResourceSnapshot,
+                        previousMayContainResources: compactMayContainRetainedResources
+                    });
+                    sessionRuntime.contextualWorldState = contextualWorldState;
                     const buildExecutionSystemPrompt = (availableTools = executionTools, promptMode = mode) => buildSystemPrompt({
                         mode: promptMode,
                         platform: description.platform,
@@ -512,7 +515,6 @@ export async function createMarAgent(options) {
                                 reasoningEfforts: configuration.reasoningEfforts
                             }))
                             : [],
-                        retainedSessionResources,
                         highDensityCompaction: selectedModel.highDensityCompaction,
                         ...(rolloutBudget?.active
                             ? {
@@ -537,7 +539,9 @@ export async function createMarAgent(options) {
                     if (mode === 'compact') {
                         const compactSystemPrompt = initialSystemPrompt;
                         const compactHistory = [...messages];
-                        const projectedHistory = normalizeMessagesForModel(insertContextualInstructions(compactHistory, contextualInstructions.entries), { supportsImages: false });
+                        const projectedHistory = normalizeMessagesForModel(insertContextualWorldState(compactHistory, contextualWorldState.entries, {
+                            excludeResources: true
+                        }), { supportsImages: false });
                         const nativeMessages = buildNativeCompactionMessages(projectedHistory, {
                             focus: input.prompt,
                             highDensityCompaction: selectedModel.highDensityCompaction
@@ -593,7 +597,9 @@ export async function createMarAgent(options) {
                         let compactSummary = '';
                         const compactSystemPrompt = buildExecutionSystemPrompt(executionTools, 'run');
                         const compactHistory = retainCurrent ? messages.slice(0, -1) : messages;
-                        const projectedHistory = normalizeMessagesForModel(insertContextualInstructions(compactHistory, contextualInstructions.entries), { supportsImages: false });
+                        const projectedHistory = normalizeMessagesForModel(insertContextualWorldState(compactHistory, contextualWorldState.entries, {
+                            excludeResources: true
+                        }), { supportsImages: false });
                         const nativeCompactMessages = buildNativeCompactionMessages(projectedHistory, {
                             highDensityCompaction: selectedModel.highDensityCompaction
                         });
@@ -686,8 +692,14 @@ export async function createMarAgent(options) {
                             .filter((message) => message.kind === 'user_input')
                             .map((message) => message.content);
                         agentInstructionInsertIndex = Math.max(0, messages.length - 1);
-                        contextualInstructions = resetContextualInstructions(compactRecord.recordId, currentInstructionSnapshot, agentInstructionInsertIndex, renderAgentInstructions(instructionEntries, true));
-                        sessionRuntime.contextualInstructions = contextualInstructions;
+                        currentResourceSnapshot = retainedSessionResourcesSnapshot(await loadRetainedSessionResources());
+                        contextualWorldState = resetContextualWorldState(compactRecord.recordId, agentInstructionInsertIndex, {
+                            instructionSnapshot: currentInstructionSnapshot,
+                            instructionContent: renderAgentInstructions(instructionEntries, true),
+                            resourceSnapshot: currentResourceSnapshot,
+                            previousMayContainResources: compactSummary.includes('# Retained Session resources')
+                        });
+                        sessionRuntime.contextualWorldState = contextualWorldState;
                         sessionRuntime.responsesChain = undefined;
                         lastServerContextTokens = undefined;
                         lastServerUsage = undefined;
@@ -726,7 +738,7 @@ export async function createMarAgent(options) {
                             .update(stableJson({
                             modelId: selectedModel.id,
                             systemPrompt,
-                            contextualInstructions: contextualInstructions.entries,
+                            contextualWorldState: contextualWorldState.entries,
                             tools: roundTools,
                             reasoningEffort
                         }))
@@ -745,7 +757,7 @@ export async function createMarAgent(options) {
                             : undefined;
                         const modelMessages = mode === 'compact'
                             ? normalizeMessagesForModel(requestContextMessages, { supportsImages: false })
-                            : normalizeMessagesForModel(insertContextualInstructions(requestContextMessages, contextualInstructions.entries), {
+                            : normalizeMessagesForModel(insertContextualWorldState(requestContextMessages, contextualWorldState.entries), {
                                 supportsImages: selectedModel.inputCapabilities.includes('IMAGE')
                             });
                         let sawModelSemanticEvent = false;
@@ -1167,8 +1179,14 @@ export async function createMarAgent(options) {
                                 if (agentInstructionInsertIndex &&
                                     messages[agentInstructionInsertIndex - 1]?.contextKind === 'environment')
                                     agentInstructionInsertIndex--;
-                                contextualInstructions = resetContextualInstructions(latestContextualInstructionGeneration(committed.records), currentInstructionSnapshot, agentInstructionInsertIndex, renderAgentInstructions(instructionEntries, committed.records.some((record) => compactSummaryFromCheckpoint(record) !== undefined)));
-                                sessionRuntime.contextualInstructions = contextualInstructions;
+                                currentResourceSnapshot = retainedSessionResourcesSnapshot(await loadRetainedSessionResources());
+                                contextualWorldState = resetContextualWorldState(latestContextualWorldStateGeneration(committed.records), agentInstructionInsertIndex, {
+                                    instructionSnapshot: currentInstructionSnapshot,
+                                    instructionContent: renderAgentInstructions(instructionEntries, committed.records.some((record) => compactSummaryFromCheckpoint(record) !== undefined)),
+                                    resourceSnapshot: currentResourceSnapshot,
+                                    previousMayContainResources: compactHistoryMayContainRetainedResources(committed.records)
+                                });
+                                sessionRuntime.contextualWorldState = contextualWorldState;
                             }
                         }
                         if (controller.signal.aborted) {
@@ -1764,17 +1782,19 @@ function modelIdFromPayload(payload, key = 'modelId') {
     const value = payload[key];
     return typeof value === 'string' && value.length > 0 ? value : undefined;
 }
-function insertContextualInstructions(messages, entries) {
+function insertContextualWorldState(messages, entries, options = {}) {
     const result = [...messages];
     let offset = 0;
     for (const entry of entries) {
+        if (options.excludeResources && entry.kind === 'resources')
+            continue;
         const insertionIndex = Math.max(0, Math.min(entry.index + offset, result.length));
         result.splice(insertionIndex, 0, { role: 'user', content: entry.content });
         offset++;
     }
     return result;
 }
-function latestContextualInstructionGeneration(records) {
+function latestContextualWorldStateGeneration(records) {
     let generation;
     for (const record of records)
         if (record.type === 'context.gc.completed' ||
@@ -1782,12 +1802,39 @@ function latestContextualInstructionGeneration(records) {
             generation = record.recordId;
     return generation;
 }
-function resetContextualInstructions(generation, snapshot, index, content) {
+function compactHistoryMayContainRetainedResources(records) {
+    return records.some((record) => compactSummaryFromCheckpoint(record)?.includes('# Retained Session resources'));
+}
+function updateContextualWorldState(state, index, current) {
+    const entries = [...state.entries];
+    if (!state.initialized || state.instructionSnapshot !== current.instructionSnapshot) {
+        if (current.instructionContent !== undefined)
+            entries.push({ index, kind: 'instructions', content: current.instructionContent });
+    }
+    const resourceContent = retainedSessionResourcesUpdate(current.resourceSnapshot, state.initialized ? state.resourceSnapshot : undefined, !state.initialized && current.previousMayContainResources);
+    if (resourceContent !== undefined)
+        entries.push({ index, kind: 'resources', content: resourceContent });
+    return {
+        generation: state.generation,
+        initialized: true,
+        instructionSnapshot: current.instructionSnapshot,
+        resourceSnapshot: current.resourceSnapshot,
+        entries
+    };
+}
+function resetContextualWorldState(generation, index, current) {
+    const entries = [];
+    if (current.instructionContent !== undefined)
+        entries.push({ index, kind: 'instructions', content: current.instructionContent });
+    const resourceContent = retainedSessionResourcesUpdate(current.resourceSnapshot, undefined, current.previousMayContainResources);
+    if (resourceContent !== undefined)
+        entries.push({ index, kind: 'resources', content: resourceContent });
     return {
         generation,
         initialized: true,
-        snapshot,
-        entries: content === undefined ? [] : [{ index, content }]
+        instructionSnapshot: current.instructionSnapshot,
+        resourceSnapshot: current.resourceSnapshot,
+        entries
     };
 }
 function contextualInstructionInsertIndex(messages) {

package/dist/subagent/session-controller.js

@@ -160,9 +160,9 @@ export class SubagentSessionController {
         if (waitFor === 'completion') {
             const completed = await this.#waitForCompletion(state, waitMs, options.signal);
             options.signal?.throwIfAborted();
-            const includeLatestMessage = completed ? this.#hasUnreadMessage(state) : false;
+            const includeLatestMessage = this.#hasUnreadMessage(state);
             const includeTerminalDetails = completed ? this.#observeTerminal(state) : false;
-            if (completed)
+            if (includeLatestMessage)
                 this.#observeLatestMessage(state);
             return {
                 ...this.#snapshot(state, { includeLatestMessage, includeTerminalDetails }),
@@ -244,12 +244,13 @@ export class SubagentSessionController {
         }
         const completed = await this.#waitForAnyCompletion(live, waitMs, options.signal);
         options.signal?.throwIfAborted();
-        const includeLatestMessage = completed ? this.#hasUnreadMessage(completed) : false;
-        const includeTerminalDetails = completed ? this.#observeTerminal(completed) : false;
-        if (completed)
-            this.#observeLatestMessage(completed);
+        const state = completed ?? this.#oldestUnreadMessage(live) ?? live.at(-1);
+        const includeLatestMessage = this.#hasUnreadMessage(state);
+        const includeTerminalDetails = completed ? this.#observeTerminal(state) : false;
+        if (includeLatestMessage)
+            this.#observeLatestMessage(state);
         return {
-            ...this.#snapshot(completed ?? live.at(-1), {
+            ...this.#snapshot(state, {
                 includeLatestMessage,
                 includeTerminalDetails
             }),

package/dist/tools/agent-wait.js

@@ -3,7 +3,7 @@ import { TOOL_EXECUTION_LIMITS } from './execution-limits.js';
 export const agentWaitToolDefinition = {
     name: 'agent_wait',
     parallelSafety: 'serial',
-    description: 'Read or wait a bounded time for a child agent result. waitFor defaults to "completion"; use "message" only when a fresh public commentary/final message would change the next decision. Omit agentId to wait for whichever live child returns first, matching Codex-style untargeted waiting and avoiding UUID transcription; provide the exact agentId returned by agent_start only when observing a specific child. If no child is live, untargeted waiting reads the most recently created child. For an exec processId, use exec with action:"poll" instead. Omitting waitMs waits up to 30 seconds by default; waitMs=0 returns the current snapshot immediately. Positive waits range up to 5 minutes, and positive values below 10 seconds are raised to 10 seconds. When blocked on a live child result, prefer one 300000 ms completion wait rather than repeated short waits. Every result includes waitOutcome as snapshot, message, completion, or timeout plus the real agentId and description. A message or first terminal completion result includes the newly observed latest public commentary/final message; snapshot, timeout, and repeated terminal results omit previously observed message text. latestActivity can still identify a public message or bounded tool started/completed/failed status. A queued or running result is not completion. A message wait consumes only the latest unread public message in the current Session runtime; tool activity does not wake it, and parent cancellation preserves unread progress for a later Execution. Do not use message waits as heartbeat checks or request progress merely to confirm that a child is still running. First terminal results include bounded summary, changedFiles, verification, and read evidence with path/line ranges; use that evidence to avoid repeating the full exploration, while independently checking consequential edits and claims.',
+    description: 'Read or wait a bounded time for a child agent result. waitFor defaults to "completion"; use "message" only when a fresh public commentary/final message would change the next decision. Omit agentId to wait for whichever live child returns first, matching Codex-style untargeted waiting and avoiding UUID transcription; provide the exact agentId returned by agent_start only when observing a specific child. If no child is live, untargeted waiting reads the most recently created child. For an exec processId, use exec with action:"poll" instead. Omitting waitMs waits up to 30 seconds by default; waitMs=0 returns the current snapshot immediately. Positive waits range up to 5 minutes, and positive values below 10 seconds are raised to 10 seconds. When blocked on a live child result, prefer one 300000 ms completion wait rather than repeated short waits. Every result includes waitOutcome as snapshot, message, completion, or timeout plus the real agentId and description. A message, timeout with unread progress, or first terminal completion result includes the newly observed latest public commentary/final message; snapshots and repeated observations omit previously observed message text. latestActivity can still identify a public message or bounded tool started/completed/failed status. A queued or running result is not completion. A message wait consumes only the latest unread public message in the current Session runtime; tool activity does not wake it, and parent cancellation preserves unread progress for a later Execution. Do not use message waits as heartbeat checks or request progress merely to confirm that a child is still running. First terminal results include bounded summary, changedFiles, verification, and read evidence with path/line ranges; use that evidence to avoid repeating the full exploration, while independently checking consequential edits and claims.',
     inputSchema: {
         type: 'object',
         properties: {

package/package.json

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