@hmharness/agent 0.23.37 → 0.23.38

package/dist/runner.d.ts

@@ -119,6 +119,11 @@ export interface InjectPoll {
 }
 export interface AgentTaskOptions {
     task: string;
+    /** Native image attachments (data URLs) for multimodal chat models:
+     * passed through to the first user message when the chat provider sees
+     * images (default-multimodal policy, 2026-10-22). Text-only providers
+     * never get these - the caller describes images into text instead. */
+    images?: string[];
     registry: Registry;
     cfg?: HmhConfig;
     ctx?: ToolContext;

package/dist/runner.js

@@ -5,7 +5,7 @@
  * Also owns the native registry factory (spawn_agent recursion) and the
  * approval gate construction.
  */
-import { homeDir, loadConfig, resolveProvider, getGoal, mcpServerTools, Registry, runLoop, Session, } from '@hmharness/kernel';
+import { chatSeesImages, homeDir, loadConfig, resolveProvider, getGoal, mcpServerTools, Registry, runLoop, Session, } from '@hmharness/kernel';
 import { brief, createTrajectoryRecorder } from '@hmharness/observability';
 import { CognitiveRunRecorder } from "./cognitive-recorder.js";
 import { readFile } from 'node:fs/promises';
@@ -412,10 +412,14 @@ export async function runAgentTask(opts) {
         session,
         onLine: (l) => events.onLine?.(l),
     };
+    // default-multimodal (2026-10-22): only attach images natively when the
+    // chat model can actually see them; a text-only chat model must receive
+    // text the caller already described
+    const nativeImages = chatSeesImages(resolveProvider(cfg, 'chat')) ? opts.images : undefined;
     const messages = [
         { role: 'system', content: system },
         ...(opts.resumeMessages ?? []),
-        { role: 'user', content: opts.task },
+        { role: 'user', content: opts.task, ...(nativeImages && nativeImages.length ? { images: nativeImages } : {}) },
     ];
     const toolsUsed = [];
     // self-noted failure patterns: 2+ errors from one tool become a memory

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hmharness/agent",
-  "version": "0.23.37",
+  "version": "0.23.38",
   "description": "hmharness agent execution layer: base tools, system prompt, sub-agent spawn, and the shared task runner that frontends (cli, web) drive.",
   "type": "module",
   "main": "dist/index.js",
@@ -15,16 +15,16 @@
     "build": "tsc -p tsconfig.build.json"
   },
   "dependencies": {
-    "@hmharness/cognitive": "0.23.37",
-    "@hmharness/domain-harmony": "0.23.37",
-    "@hmharness/domain-ops": "0.23.37",
-    "@hmharness/evolution": "0.23.37",
-    "@hmharness/kernel": "0.23.37",
-    "@hmharness/observability": "0.23.37",
-    "@hmharness/sandbox": "0.23.37",
-    "@hmharness/lsp": "0.23.37",
-    "@hmharness/browser": "0.23.37",
-    "@hmharness/extension": "0.23.37"
+    "@hmharness/cognitive": "0.23.38",
+    "@hmharness/domain-harmony": "0.23.38",
+    "@hmharness/domain-ops": "0.23.38",
+    "@hmharness/evolution": "0.23.38",
+    "@hmharness/kernel": "0.23.38",
+    "@hmharness/observability": "0.23.38",
+    "@hmharness/sandbox": "0.23.38",
+    "@hmharness/lsp": "0.23.38",
+    "@hmharness/browser": "0.23.38",
+    "@hmharness/extension": "0.23.38"
   },
   "files": [
     "dist"