@hmharness/agent 0.3.0 → 0.4.0

package/dist/runner.d.ts

@@ -6,6 +6,7 @@
  * approval gate construction.
  */
 import { Registry, type ChatMessage, type DeltaKind, type HmhConfig, type LoopApproval, type LoopResult, type McpClient, type McpServerConfig, type McpServerImport, type ToolContext } from '@hmharness/kernel';
+import { type EmbeddingProvider } from '@hmharness/evolution';
 import * as readline from 'node:readline/promises';
 import { type SpawnBase } from './spawn.ts';
 /** Flatten the config.json shape into the runtime discriminated union. */
@@ -29,7 +30,10 @@ export declare function buildRegistry(opts?: {
  *  P0 canary: ~20% of sessions (deterministic by session id) also receive
  *  the canary skill block, watermarked as experimental references - the
  *  impact loop compares these sessions against the rest. */
-export declare function contextPack(task: string, sessionId?: string): Promise<{
+export declare function contextPack(task: string, sessionId?: string, opts?: {
+    workspace?: string | null;
+    embedding?: EmbeddingProvider;
+}): Promise<{
     memory: string;
     skills: string;
     insights: string;

package/dist/runner.js

@@ -6,7 +6,7 @@
  * approval gate construction.
  */
 import { homeDir, loadConfig, resolveProvider, mcpServerTools, Registry, runLoop, Session, } from '@hmharness/kernel';
-import { appendMemory, listSkills, readInsights, readNotes, recentInsights, recordInsight, retrieveMemory, skillsToPrompt, sessionGetsCanary, canaryWatermark, listCanary } from '@hmharness/evolution';
+import { appendMemory, listSkills, readInsights, readNotes, recentInsights, recordInsight, retrieveMemory, skillsToPrompt, sessionGetsCanary, canaryWatermark, listCanary, workspaceForCwd } from '@hmharness/evolution';
 import { harmonyTools } from '@hmharness/domain-harmony';
 import { opsTools } from '@hmharness/domain-ops';
 import * as readline from 'node:readline/promises';
@@ -76,10 +76,10 @@ export async function buildRegistry(opts = {}) {
  *  P0 canary: ~20% of sessions (deterministic by session id) also receive
  *  the canary skill block, watermarked as experimental references - the
  *  impact loop compares these sessions against the rest. */
-export async function contextPack(task, sessionId) {
+export async function contextPack(task, sessionId, opts = {}) {
     const home = homeDir();
     const [memory, skills, insights] = await Promise.all([
-        retrieveMemory(home, task),
+        retrieveMemory(home, task, { workspace: opts.workspace ?? undefined, embedding: opts.embedding }),
         listSkills(home),
         recentInsights(home),
     ]);
@@ -129,9 +129,17 @@ export async function runAgentTask(opts) {
     const ctx = opts.ctx ?? { cwd: process.cwd(), home: homeDir() };
     const events = opts.events ?? {};
     const session = new Session(ctx.home, ctx.cwd, cfg.provider.model);
+    // workspace scoping + optional embedding hybrid for memory retrieval.
+    // Embeddings only when routing.embedding is EXPLICITLY set - an inherited
+    // chat route would 404 on /embeddings once per task for nothing.
+    const workspace = await workspaceForCwd(ctx.home, ctx.cwd);
+    const embeddingRoute = cfg.routing?.['embedding'];
+    const embedding = embeddingRoute && cfg.providers?.[embeddingRoute]
+        ? cfg.providers[embeddingRoute]
+        : undefined;
     // contextPack needs the session id: canary injection is deterministic
     // per-session (stable attribution), decided before the prompt is built
-    const pack = await contextPack(opts.task, session.id);
+    const pack = await contextPack(opts.task, session.id, { workspace, embedding });
     const system = buildSystemPrompt({
         cwd: ctx.cwd,
         home: ctx.home,
@@ -160,13 +168,26 @@ export async function runAgentTask(opts) {
     // note, so the NEXT session starts knowing what broke this one (the
     // self-evolution loop's missing per-session feedback channel)
     const toolErrors = new Map();
+    // rolling digest hook: compaction-evicted tool output is distilled into a
+    // persistent summary note by the chat model instead of being dropped
+    // (failures degrade silently to the deterministic prune inside the kernel)
+    const chatProvider = resolveProvider(cfg, 'chat');
+    const { chat: chatFn } = await import('@hmharness/kernel');
+    const summarizeContext = async (input) => {
+        const r = await chatFn(chatProvider, [
+            { role: 'system', content: 'You compress evicted agent transcript content into a dense factual digest. Keep: what was done, key results, paths, versions, decisions, errors and their fixes. Drop: raw listings, repetition, fluff. Max 120 words. Plain text bullets, no preamble.' },
+            { role: 'user', content: (input.previousDigest ? `PREVIOUS DIGEST (merge, keep still-relevant facts):\n${input.previousDigest}\n\n` : '') + `NEWLY EVICTED CONTENT:\n${input.evicted.join('\n---\n').slice(0, 24_000)}` },
+        ]);
+        return r.message.content ?? '';
+    };
     const result = await runLoop({
-        provider: resolveProvider(cfg, 'chat'),
+        provider: chatProvider,
         registry: opts.registry,
         messages,
         ctx,
         maxTurns: cfg.maxTurns,
         maxContextChars: cfg.maxContextChars,
+        summarizeContext,
         approval: spawnBase.current.approval,
         events: {
             onDelta: (kind, chunk) => events.onDelta?.(kind, chunk),
@@ -207,7 +228,7 @@ export async function runAgentTask(opts) {
             const last = notes.slice(-40).map((n) => n.text).join('\n');
             if (last.includes(`[self-note] tool ${name}`))
                 continue;
-            await appendMemory(ctx.home, `[self-note] tool ${name} failed ${errs.length}x in one session; samples: ${[...new Set(errs)].slice(0, 2).join(' | ')}`);
+            await appendMemory(ctx.home, `[self-note] tool ${name} failed ${errs.length}x in one session; samples: ${[...new Set(errs)].slice(0, 2).join(' | ')}`, workspace ?? undefined);
         }
     }
     catch {
@@ -232,7 +253,7 @@ export async function runAgentTask(opts) {
                 ]);
                 const lesson = (r.message.content ?? '').trim();
                 if (lesson && lesson.toUpperCase() !== 'NONE' && lesson.length < 300) {
-                    await appendMemory(ctx.home, `[lesson] ${lesson}`);
+                    await appendMemory(ctx.home, `[lesson] ${lesson}`, workspace ?? undefined);
                 }
             }
             catch {

package/dist/tools.js

@@ -528,11 +528,13 @@ export const rememberTool = {
         properties: { note: { type: 'string', description: 'the fact/lesson to remember, one line preferred' } },
         required: ['note'],
     },
-    async execute(args) {
+    async execute(args, ctx) {
         try {
-            const { appendMemory } = await import('@hmharness/evolution');
-            await appendMemory(homeDir(), String(args.note ?? ''));
-            return { output: 'remembered.' };
+            const { appendMemory, workspaceForCwd } = await import('@hmharness/evolution');
+            const home = ctx?.home ?? homeDir();
+            const ws = await workspaceForCwd(home, ctx?.cwd ?? process.cwd());
+            await appendMemory(home, String(args.note ?? ''), ws ?? undefined);
+            return { output: ws ? `remembered (workspace: ${ws}).` : 'remembered.' };
         }
         catch (err) {
             return { output: String(err), isError: true };

package/package.json

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