@myagentroam/node 0.9.148 → 0.9.149

package/dist/connector.js

@@ -2157,7 +2157,7 @@ export class NodeConnector {
         if (isPlainRecord(payload) && isPlainRecord(payload.session)) {
             const workspaceId = payload.session.workspaceId;
             if (typeof workspaceId === 'string') {
-                this.workspaceSessionService.invalidateCache(workspaceId);
+                this.workspaceSessionService.markCacheStale(workspaceId);
                 void this.workspaceWorkbenchService?.invalidateTopic(workspaceId, 'sessions');
             }
         }

package/dist/runner/mar-agent/byted-ark-imagegen-skill.js

@@ -8,6 +8,7 @@ For text-to-image, provide prompt and omit both image selectors.
 For image-to-image, pass referenced_image_paths with existing absolute image paths, or use num_last_images_to_include for the smallest sufficient suffix of current Execution images. Never combine selectors. Do not invent missing references.
 Describe which reference provides the subject, composition or style; specify what to change and what to preserve. Preserve literal requested text.
 The service returns exactly one PNG with 2K size and no watermark. Group generation, video and streaming are not supported. Do not invent count, sequential, endpoint or model parameters.
+In Code Mode, call tools.byted_ark_image_gen. Independent single-image calls can run with Promise.all; await earlier results when later images depend on them.
 
 Inspect references with view_image when that tool is available. Text-only models can submit references through the Host boundary but must not claim to have visually inspected them.
 Generation may take several minutes. Await the result; do not blindly retry timeouts, since the upstream may already have produced an image.

package/dist/runner/mar-agent/codex-imagegen-skill.js

@@ -19,6 +19,7 @@ Use codex_image_gen only when the user requests image generation or editing, or
 
 ### Generate and check
 - Call codex_image_gen with its actual schema. It produces one PNG per call; use separate calls for separately requested assets. Do not add unsupported parameters for model, dimensions, quality, masks, output format, or destination.
+- In Code Mode, call tools.codex_image_gen. Independent calls can run with Promise.all; await earlier results when later images depend on them.
 - The service configuration controls model and automatic size/quality/background. A prompt can request an aspect ratio or transparency, but these are not guaranteed API settings. Check the actual result before claiming compliance.
 - Generation may take minutes. Await the tool result; do not blindly repeat a timed-out or interrupted request because the upstream operation may already have run. Report failures rather than claiming an artifact exists.
 - A successful result returns the saved path, not inspected pixels. When view_image is available, use it for visual acceptance: subject, exact text, composition, edit invariants, and unwanted elements. Otherwise explicitly state that visual acceptance was not performed. Make targeted corrections only within the requested scope.

package/dist/runner/mar-agent/conversation-normalizer.js

@@ -68,7 +68,8 @@ export class MarAgentConversationNormalizer {
         if (event.type === 'tool.started' ||
             event.type === 'tool.completed' ||
             event.type === 'tool.failed') {
-            if (event.parentCallId !== undefined)
+            // Generated artifacts must remain deliverable even when the cell does not observe them.
+            if (event.parentCallId !== undefined && !isImageGenerationTool(event.toolName))
                 return [];
             if (event.type === 'tool.started')
                 return this.#toolStarted(event);
@@ -593,9 +594,7 @@ function genericToolItem(id, toolName, status, input, outputSummary = null, erro
         }, status);
     }
     const subagent = marAgentSubagentProjection(toolName, input, output, subagentTitle, knownSubagentDetails);
-    const toolCategory = ['codex_image_gen', 'byted_ark_image_gen'].includes(toolName)
-        ? 'IMAGE_GENERATION'
-        : undefined;
+    const toolCategory = isImageGenerationTool(toolName) ? 'IMAGE_GENERATION' : undefined;
     return {
         itemId: id,
         kind: 'tool_call',
@@ -937,9 +936,11 @@ function boundedId(value) {
 function nonnegativeInteger(value) {
     return typeof value === 'number' && Number.isInteger(value) && value >= 0 ? value : null;
 }
+function isImageGenerationTool(toolName) {
+    return toolName === 'codex_image_gen' || toolName === 'byted_ark_image_gen';
+}
 function imageArtifacts(event) {
-    if (!['codex_image_gen', 'byted_ark_image_gen'].includes(event.toolName) ||
-        !Array.isArray(event.artifacts))
+    if (!isImageGenerationTool(event.toolName) || !Array.isArray(event.artifacts))
         return [];
     return event.artifacts.flatMap((value) => {
         const artifact = record(value);

package/dist/runner/mar-agent/image-generation.js

@@ -23,6 +23,8 @@ const IMAGE_GENERATION_RESPONSE_TIMEOUT_MS = 5 * 60 * 1000;
 export const codexImageGenToolDefinition = {
     name: 'codex_image_gen',
     agentScope: 'ROOT_ONLY',
+    allowedCallers: ['direct', 'programmatic'],
+    parallelSafety: 'safe',
     description: 'Only when the user requests or explicitly authorizes image generation or editing, use the configured Codex Images API. First load and follow skill({name:"codex-imagegen"}); reload if its guidance is no longer in context. Do not generate unsolicited visuals. Omit both selectors for a new image without references. For image inputs, inspect unseen local images with view_image when available; TEXT-only models must not claim visual inspection. Use referenced_image_paths when every image has an absolute path; otherwise use num_last_images_to_include for the smallest sufficient number of currently available conversation images. Never provide both selectors. Include at most five images; if required inputs are missing, ask for them rather than silently omitting them. Recent images are in-memory in the current Execution, not a permanent history library. One PNG is saved in the current Session and its path is returned, not inspected pixels. Use view_image when available to check the result; otherwise report that visual acceptance was not performed. Full workflow guidance is in the codex-imagegen skill.',
     inputSchema: {
         type: 'object',

package/dist/service/workspace-session-service.js

@@ -7,6 +7,7 @@ export class WorkspaceSessionService {
     cacheGenerations = new Map();
     initialReads = new Map();
     incompleteDiscoveries = new Set();
+    staleDiscoveries = new Set();
     constructor(state, options) {
         this.state = state;
         this.options = options;
@@ -56,7 +57,7 @@ export class WorkspaceSessionService {
                 const previous = this.state.sessionCache.get(workspaceId)?.sessions;
                 this.state.sessionCache.set(workspaceId, {
                     sessions,
-                    expiresAt: Date.now() + CACHE_TTL_MS
+                    expiresAt: this.staleDiscoveries.has(workspaceId) ? 0 : Date.now() + CACHE_TTL_MS
                 });
                 if (notify &&
                     previous !== undefined &&
@@ -102,8 +103,12 @@ export class WorkspaceSessionService {
             })
                 .finally(() => {
                 acceptingBatches = false;
-                if (this.state.sessionCacheReads.get(workspaceId) === read)
+                if (this.state.sessionCacheReads.get(workspaceId) === read) {
                     this.state.sessionCacheReads.delete(workspaceId);
+                    // Events during discovery require a trailing refresh, even if its result is unchanged.
+                    if (this.staleDiscoveries.delete(workspaceId))
+                        notifyCompletion = true;
+                }
                 if (this.initialReads.get(workspaceId) === initial)
                     this.initialReads.delete(workspaceId);
                 if (notifyCompletion && (this.cacheGenerations.get(workspaceId) ?? 0) === generation)
@@ -137,17 +142,26 @@ export class WorkspaceSessionService {
         this.state.sessionCacheReads.clear();
         this.initialReads.clear();
         this.incompleteDiscoveries.clear();
+        this.staleDiscoveries.clear();
     }
     invalidate(workspaceId) {
         this.invalidateCache(workspaceId);
         this.stopWatch(workspaceId);
     }
+    markCacheStale(workspaceId) {
+        const cached = this.state.sessionCache.get(workspaceId);
+        if (cached !== undefined)
+            this.state.sessionCache.set(workspaceId, { ...cached, expiresAt: 0 });
+        if (this.state.sessionCacheReads.has(workspaceId))
+            this.staleDiscoveries.add(workspaceId);
+    }
     invalidateCache(workspaceId) {
         this.bumpCacheGeneration(workspaceId);
         this.state.sessionCache.delete(workspaceId);
         this.state.sessionCacheReads.delete(workspaceId);
         this.initialReads.delete(workspaceId);
         this.incompleteDiscoveries.delete(workspaceId);
+        this.staleDiscoveries.delete(workspaceId);
     }
     bumpCacheGeneration(workspaceId) {
         this.cacheGenerations.set(workspaceId, (this.cacheGenerations.get(workspaceId) ?? 0) + 1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myagentroam/node",
-  "version": "0.9.148",
+  "version": "0.9.149",
   "description": "MyAgentRoam Node runtime CLI.",
   "license": "Apache-2.0 AND GPL-2.0-or-later",
   "type": "module",
@@ -34,10 +34,10 @@
     "npm": "11.12.1",
     "ws": "^8.21.3",
     "zod": "4.4.3",
-    "@myagentroam/marctl": "0.9.120",
     "@myagentroam/code-navigation": "0.9.129",
-    "@myagentroam/agent": "0.9.148",
-    "@myagentroam/protocol": "0.9.148"
+    "@myagentroam/agent": "0.9.149",
+    "@myagentroam/protocol": "0.9.149",
+    "@myagentroam/marctl": "0.9.120"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1"