@myagentroam/agent 0.9.146 → 0.9.148

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

@@ -48,17 +48,18 @@ export async function createMarAgentWithAdapter(options) {
                     activeAdapters.add(adapter);
         return activeAdapters;
     };
+    const settings = {
+        ...(options.workspaceMapping === undefined
+            ? {}
+            : { workspaceMapping: options.workspaceMapping }),
+        ...(options.systemInstruction === undefined
+            ? {}
+            : { systemInstruction: options.systemInstruction })
+    };
     const openSession = createSessionOpener({
         host: options.host,
         description,
-        settings: {
-            ...(options.workspaceMapping === undefined
-                ? {}
-                : { workspaceMapping: options.workspaceMapping }),
-            ...(options.systemInstruction === undefined
-                ? {}
-                : { systemInstruction: options.systemInstruction })
-        },
+        settings,
         store,
         registry: {
             active,
@@ -95,6 +96,14 @@ export async function createMarAgentWithAdapter(options) {
             await options.host.disposeSessionResources?.(id);
             await store.clearSession(id);
         },
+        setSystemInstruction: (systemInstruction) => {
+            if (disposed)
+                throw new MarAgentError('MAR_AGENT_DISPOSED', 'Agent is disposed.');
+            if (systemInstruction === undefined)
+                delete settings.systemInstruction;
+            else
+                settings.systemInstruction = systemInstruction;
+        },
         reconfigureModels: async (input) => {
             if (disposed)
                 throw new MarAgentError('MAR_AGENT_DISPOSED', 'Agent is disposed.');

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

@@ -109,6 +109,7 @@ export function createSessionOpener(services) {
                 ...currentLocalTimeContext()
             };
             const { models: executionModels, defaultModelId: executionDefaultModelId, generation: executionModelGeneration } = services.modelState();
+            const executionSystemInstruction = settings.systemInstruction;
             const manualCompactionId = mode === 'compact' ? randomUUID() : undefined;
             active.set(`${sessionId}:${executionId}`, controller);
             const mailbox = [...(internal.initialMailbox ?? [])];
@@ -564,7 +565,7 @@ export function createSessionOpener(services) {
                             .map((tool) => tool.name),
                         highDensityCompaction: selectedModel.highDensityCompaction,
                         extension: [
-                            settings.systemInstruction,
+                            executionSystemInstruction,
                             instructionContext?.skillCatalog,
                             sessionSource.type === 'subagent' ? childSubagentInstruction : undefined
                         ]

package/dist/agent-core/sdk/types.d.ts

@@ -37,6 +37,8 @@ export interface MarAgent {
     }>;
     setSessionTitle(sessionId: string, title: string, input?: SessionTitleUpdateInput): Promise<boolean>;
     clearSession(sessionId: string): Promise<void>;
+    /** Updates future execution snapshots only; undefined clears the Host instruction extension. */
+    setSystemInstruction(systemInstruction?: string): void;
     /** Rebinds future main executions only; running subagents keep their captured model providers. */
     reconfigureModels(input: {
         readonly models: readonly MarAgentModelConfiguration[];

package/dist/agent-core/tools/code-mode/index.js

@@ -18,7 +18,10 @@ export const codeModeToolDefinition = {
     name: 'code_exec',
     description: `Run JavaScript to orchestrate or compose tool calls.
 - Code Mode Only: call the programmatic tools listed below through tools.NAME inside this tool, including single-tool operations. They are omitted from the top-level tool list. Direct-only tools remain separate model tools and cannot be called here.
-- Use bounded combinations, parallel independent calls, and filtering of large intermediate results to reduce model round trips.
+- Run independent calls concurrently with Promise.all; await sequentially when data, side effects, or failure handling require ordering.
+- Complete known, bounded steps and deterministic result processing in code when this avoids a model round trip. Return to the model when interpretation or a new decision is needed; do not invent extra work to fill a cell.
+- Observe only evidence needed for the next decision or verification: use observe.result for original results, observe.text for derived values, and observe.image for image values. Preserve source and failure details needed for reasoning; keep other intermediate data in the cell.
+- Single-tool cells are valid. Keep loops and retries bounded, and do not blindly replay operations with side effects.
 - Evaluates source in a fresh restricted ECMAScript runtime with top-level await and Promise.all. It is not Node.js or a browser. JavaScript globals do not survive between cells; bounded JSON state is available through state.
 - Accepts raw JavaScript source text, not JSON, quoted strings, or markdown code fences. Responses uses the source directly; Anthropic uses the code field of its tool input object. In either case, do not quote or fence the source again.
 - Use only standard ECMAScript built-ins and the explicitly documented tools, observe, state, catalog and cell namespaces. Do not use Node.js, browser or Web APIs. Module imports, filesystem and network APIs are unavailable. Obtain external capabilities only through available tools. Use tools.exec to start managed processes when permitted; use tools.exec_wait afterward to wait, write stdin or cancel.
@@ -31,7 +34,7 @@ Tool calls:
 
 Built-in namespaces:
 - observe.result(result): void registers an unmodified complete tools.NAME result or caught tool error as a trusted tool_result, using the original text and all images without repeating program data. Non-original, copied or modified values are rejected. This selects evidence for the next model response, not a log and not a new model call. Prefer observe.result for inspecting tool results.
-- observe.text(value): void registers bounded text/JSON values. observe.image(value): void registers one image value using the existing capability, MIME, byte and count limits. Both accept original tool results for compatibility and use the same complete tool_result observation path; they do not select part of an original result. Extracted single images, copies and computed summaries are value observations, never trusted tool results. Observations are returned in registration order. Only explicitly observed evidence reaches the model; registration does not prove inspection. Sources and types are runtime-assigned. No out or callable observe(value) alias exists.
+- observe.text(value): void registers bounded text/JSON values. observe.image(value): void registers one image value using the existing capability, MIME and byte limits. Both accept original tool results for compatibility and use the same complete tool_result observation path; they do not select part of an original result. Extracted single images, copies and computed summaries are value observations, never trusted tool results. Observations are returned in registration order. Only explicitly observed evidence reaches the model; registration does not prove inspection. Sources and types are runtime-assigned. No out or callable observe(value) alias exists.
 - state.get(key), state.has(key), state.set(key, value), state.delete(key) access bounded session JSON state. Mutations commit atomically only when the cell succeeds; failed or cancelled cells discard them.
 - catalog.tools() returns a read-only snapshot of the tools callable in this cell, including name, description, inputSchema and inputMode. It does not discover or authorize additional tools.
 - await cell.sleep(ms) performs a cancellable Host-side delay up to 30000 ms and remains subject to the cell deadline.
@@ -353,8 +356,6 @@ export class CodeModeTool {
                 const addImage = (raw) => {
                     if (!context.codeMode?.supportsImages)
                         throw new MarAgentError('MAR_AGENT_INPUT_CAPABILITY_UNSUPPORTED', 'The current model cannot receive image observations.');
-                    if (images.length >= 5)
-                        throw new MarAgentError('MAR_AGENT_TOOL_OUTPUT_LIMIT', 'Code Mode emitted too many images.');
                     const image = parseImage(raw);
                     const index = images.length;
                     images.push(image);
@@ -439,8 +440,6 @@ export class CodeModeTool {
                 if (!context.codeMode?.supportsImages)
                     throw new MarAgentError('MAR_AGENT_INPUT_CAPABILITY_UNSUPPORTED', 'The current Code Mode context does not support image output.');
                 const image = parseImage(frame.value);
-                if (images.length >= 5)
-                    throw new MarAgentError('MAR_AGENT_TOOL_OUTPUT_LIMIT', 'Code Mode emitted too many images.');
                 images.push(image);
                 output?.image(image);
                 appendObservation({

package/package.json

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