@hmharness/agent 0.19.1 → 0.19.2

package/dist/cognitive-tools.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @hmharness/agent - cognitive query tool (blueprint §18/UX-004 seed)
+ *
+ * Gives the LIVE model read access to its own accumulated world model:
+ * which tool types historically succeed, how calibrated its predictions
+ * are, and what the diagnosis layer thinks is worth learning. Read-only by
+ * design — the model cannot write beliefs; those update only from real
+ * trajectories (no self-grading channel).
+ */
+import type { Tool } from '@hmharness/kernel';
+export declare const cognitiveQueryTool: Tool;

package/dist/cognitive-tools.js

@@ -0,0 +1,53 @@
+export const cognitiveQueryTool = {
+    name: 'cognitive_query',
+    description: 'Query the cognitive layer\'s accumulated knowledge about past runs: which action/tool types historically succeed (belief table with confidence and evidence counts), prediction calibration, planner-trusted action types, learning opportunities, and memory contradictions. Read-only. Args: focus=beliefs|calibration|diagnosis|memory (optional; omit for a summary).',
+    parameters: {
+        type: 'object',
+        properties: {
+            focus: { type: 'string', description: 'beliefs | calibration | diagnosis | memory (optional)' },
+        },
+    },
+    async execute(args, ctx) {
+        const focus = String(args.focus ?? 'summary');
+        try {
+            const { analyzeWorldModel, diagnoseOpportunities, CognitiveMemory } = await import('@hmharness/cognitive');
+            const lines = [];
+            if (focus === 'summary' || focus === 'beliefs') {
+                const wm = await analyzeWorldModel(ctx.home);
+                lines.push(`world model (${wm.trajectoriesReplayed} trajectories, ${wm.stepsReplayed} steps replayed):`);
+                if (wm.beliefs.length === 0)
+                    lines.push('  (no beliefs yet — run a few tasks first)');
+                for (const b of wm.beliefs.slice(0, 12)) {
+                    lines.push(`  ${b.actionType.padEnd(24)} conf=${b.confidence.toFixed(2)} n=${b.evidenceCount}`);
+                }
+                if (focus === 'beliefs') {
+                    lines.push(`planner gate: trusted=[${wm.plannerGate.trusted.join(',')}] untrusted=[${wm.plannerGate.untrusted.join(',')}] unknown=[${wm.plannerGate.unknown.join(',')}]`);
+                }
+            }
+            if (focus === 'summary' || focus === 'calibration') {
+                const wm = await analyzeWorldModel(ctx.home);
+                const cal = wm.calibration;
+                lines.push(`calibration: ${cal.resolved} resolved predictions${cal.meanError !== undefined ? `, mean |error|=${cal.meanError}` : ' (no predictions recorded yet — steps carry no confidence)'}`);
+            }
+            if (focus === 'summary' || focus === 'diagnosis') {
+                const d = await diagnoseOpportunities(ctx.home);
+                lines.push(`diagnosis (${d.trajectories} trajectories):`);
+                if (d.opportunities.length === 0)
+                    lines.push('  (no learning opportunity meets the evidence threshold yet)');
+                for (const o of d.opportunities.slice(0, 6)) {
+                    lines.push(`  [${o.suggestedTargets.join('/')}] ${o.signal}`);
+                }
+            }
+            if (focus === 'summary' || focus === 'memory') {
+                const mem = new CognitiveMemory(ctx.home);
+                await mem.load();
+                const stats = mem.stats();
+                lines.push(`memory: working:${stats.working} episodic:${stats.episodic} semantic:${stats.semantic} procedural:${stats.procedural} world:${stats.world}, contradictions pending: ${mem.detectContradictions().length}`);
+            }
+            return { output: lines.join('\n') };
+        }
+        catch (err) {
+            return { output: 'cognitive_query failed: ' + String(err).slice(0, 200), isError: true };
+        }
+    },
+};

package/dist/tools.js

@@ -9,6 +9,7 @@ import { copyFile, readFile, readdir, writeFile } from 'node:fs/promises';
 import { isAbsolute, join, resolve } from 'node:path';
 import { promisify } from 'node:util';
 import { chatVision, homeDir, isBareProbe, isVisionRefusal, loadConfig, visionProviderChain } from '@hmharness/kernel';
+import { cognitiveQueryTool } from "./cognitive-tools.js";
 const execCb = promisify(exec);
 const DENY_PATTERNS = [
     // recursive deletes aimed at ROOT/HOME/SYSTEM targets only - relative
@@ -662,4 +663,5 @@ export const seeImageTool = {
 export const baseTools = [
     readFileTool, editFileTool, writeFileTool, listDirTool, runCommandTool, rememberTool, seeImageTool,
     webSearchTool, webFetchTool, browserOpenTool, desktopScreenshotTool, desktopClickTool, desktopTypeTool, sshRunTool,
+    cognitiveQueryTool,
 ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hmharness/agent",
-  "version": "0.19.1",
+  "version": "0.19.2",
   "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,13 +15,13 @@
     "build": "tsc -p tsconfig.build.json"
   },
   "dependencies": {
-    "@hmharness/cognitive": "0.19.1",
-    "@hmharness/domain-harmony": "0.19.1",
-    "@hmharness/domain-ops": "0.19.1",
-    "@hmharness/evolution": "0.19.1",
-    "@hmharness/kernel": "0.19.1",
-    "@hmharness/observability": "0.19.1",
-    "@hmharness/sandbox": "0.19.1"
+    "@hmharness/cognitive": "0.19.2",
+    "@hmharness/domain-harmony": "0.19.2",
+    "@hmharness/domain-ops": "0.19.2",
+    "@hmharness/evolution": "0.19.2",
+    "@hmharness/kernel": "0.19.2",
+    "@hmharness/observability": "0.19.2",
+    "@hmharness/sandbox": "0.19.2"
   },
   "files": [
     "dist"