@noopolis/daimon 0.1.0 → 0.1.1

package/dist/pi/piHarness.d.ts

@@ -1,6 +1,8 @@
+import { createAgentSession } from "@earendil-works/pi-coding-agent";
 import type { AgentHandle, AgentHarnessAdapter, AgentStartInput, HarnessModelSpec } from "../core/types.js";
 export interface PiHarnessOptions {
     authPath: string;
+    sessionFactory?: PiSessionFactory;
     model?: {
         auth?: HarnessModelSpec["auth"];
         endpoint?: HarnessModelSpec["endpoint"];
@@ -8,11 +10,17 @@ export interface PiHarnessOptions {
         name: string;
     };
     modelsPath?: string;
+    memory?: {
+        source?: string;
+        tokenBudget?: number;
+    };
 }
+export type PiSessionFactory = (input: Parameters<typeof createAgentSession>[0]) => ReturnType<typeof createAgentSession>;
 export declare class PiHarnessAdapter implements AgentHarnessAdapter {
     private readonly options;
     private readonly authStorage;
     private readonly modelRegistry;
+    private readonly sessionFactory;
     constructor(options: PiHarnessOptions);
     startAgent(input: AgentStartInput): Promise<AgentHandle>;
 }

package/dist/pi/piHarness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"piHarness.d.ts","sourceRoot":"","sources":["../../src/pi/piHarness.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,eAAe,EAEf,gBAAgB,EAGjB,MAAM,kBAAkB,CAAC;AAM1B,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAChC,QAAQ,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;QACxC,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AA4HD,qBAAa,gBAAiB,YAAW,mBAAmB;IAI9C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAHpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;gBAEjB,OAAO,EAAE,gBAAgB;IAKhD,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;CAgC/D"}
+{"version":3,"file":"piHarness.d.ts","sourceRoot":"","sources":["../../src/pi/piHarness.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,kBAAkB,EAMnB,MAAM,iCAAiC,CAAC;AAEzC,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,eAAe,EAEf,gBAAgB,EAGjB,MAAM,kBAAkB,CAAC;AAe1B,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,gBAAgB,CAAC;IAClC,KAAK,CAAC,EAAE;QACN,IAAI,CAAC,EAAE,gBAAgB,CAAC,MAAM,CAAC,CAAC;QAChC,QAAQ,CAAC,EAAE,gBAAgB,CAAC,UAAU,CAAC,CAAC;QACxC,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,MAAM,gBAAgB,GAAG,CAC7B,KAAK,EAAE,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC,KAC5C,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAwP3C,qBAAa,gBAAiB,YAAW,mBAAmB;IAK9C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAc;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAmB;gBAErB,OAAO,EAAE,gBAAgB;IAMhD,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC;CAiD/D"}

package/dist/pi/piHarness.js

@@ -2,6 +2,8 @@ import { mkdir } from "node:fs/promises";
 import path from "node:path";
 import { AuthStorage, createAgentSession, createExtensionRuntime, ModelRegistry, SessionManager, SettingsManager } from "@earendil-works/pi-coding-agent";
 import { resolvePiHarnessModel } from "./modelConfig.js";
+import { createPiMemoryTools, piMemoryToolNames } from "./memoryTools.js";
+import { createMemoryRuntime, memoryScopeId, readMemoryContext } from "@noopolis/mneme";
 const createModelRegistry = (authStorage, options) => {
     const registry = options.modelsPath
         ? ModelRegistry.create(authStorage, options.modelsPath)
@@ -19,23 +21,46 @@ const createModelRegistry = (authStorage, options) => {
     }
     return registry;
 };
+const fallbackPacket = (input) => ({
+    principal: {
+        agentId: "unknown",
+        scope: "global"
+    },
+    sections: [{ heading: "Wake event", text: formatWakePrompt(input) }],
+    rawHint: "memory bypass active"
+});
+const extractOutputText = (chunks) => chunks.join("\n").trim();
 class PiAgentHandle {
     id;
     session;
+    memory;
+    memoryToolContext;
     state = "idle";
     lastWakeAt;
     lastError;
-    constructor(id, session) {
+    wakeQueue = Promise.resolve();
+    constructor(id, session, memory, memoryToolContext) {
         this.id = id;
         this.session = session;
+        this.memory = memory;
+        this.memoryToolContext = memoryToolContext;
     }
     async wake(event) {
+        const queued = this.wakeQueue.then(() => this.runWake(event), () => this.runWake(event));
+        this.wakeQueue = queued.then(() => undefined, () => undefined);
+        return queued;
+    }
+    async runWake(event) {
         const startedAt = Date.now();
         const chunks = [];
+        const toolEvents = [];
         this.state = "running";
         this.lastWakeAt = new Date().toISOString();
         this.lastError = undefined;
         const unsubscribe = this.session.subscribe((piEvent) => {
+            if (piEvent && typeof piEvent === "object" && "type" in piEvent && piEvent.type !== "turn_end") {
+                toolEvents.push(piEvent);
+            }
             if (piEvent.type !== "turn_end") {
                 return;
             }
@@ -54,21 +79,107 @@ class PiAgentHandle {
                     .join(""));
             }
         });
+        const memoryContext = readMemoryContext({
+            kind: event.kind,
+            id: event.id,
+            from: event.from,
+            text: event.text,
+            context: event.context
+        });
+        const request = {
+            eventId: event.id,
+            kind: event.kind,
+            text: event.text,
+            from: event.from,
+            context: memoryContext
+        };
+        let prepared;
+        let promptText = formatWakePrompt(event);
         try {
-            await this.session.prompt(formatWakePrompt(event), { expandPromptTemplates: false });
+            if (this.memory) {
+                prepared = await this.memory.prepareTurn(request);
+                promptText = prepared.promptText;
+                if (this.memoryToolContext) {
+                    this.memoryToolContext.current = {
+                        wakeId: event.id,
+                        threadId: `${memoryContext.networkId ?? "local"}:${memoryContext.roomId ?? event.from ?? "manual"}`,
+                        principal: prepared.principal,
+                        conversationScope: memoryScopeId(prepared.principal),
+                        audienceKey: memoryContext.roomId ?? event.from ?? this.id,
+                        transport: "in_process"
+                    };
+                }
+            }
+            await this.session.prompt(promptText, { expandPromptTemplates: false });
             this.state = "idle";
+            const outputText = extractOutputText(chunks);
+            if (this.memory) {
+                const promptPacket = prepared?.packet ?? fallbackPacket(event);
+                await this.memory.recordTurn({
+                    principal: {
+                        agentId: this.id,
+                        scope: prepared?.principal.scope ?? "global",
+                        qualifier: prepared?.principal.qualifier
+                    },
+                    prompt: {
+                        ...promptPacket,
+                        principal: {
+                            agentId: this.id,
+                            scope: prepared?.principal.scope ?? "global",
+                            qualifier: prepared?.principal.qualifier
+                        }
+                    },
+                    request,
+                    recall: prepared?.recall,
+                    result: "completed",
+                    outputText,
+                    toolEvents
+                });
+            }
             return {
                 agentId: this.id,
-                text: chunks.join("\n").trim(),
+                text: outputText,
                 durationMs: Date.now() - startedAt
             };
         }
         catch (error) {
             this.state = "failed";
             this.lastError = error instanceof Error ? error.message : String(error);
+            if (this.memory) {
+                try {
+                    const promptPacket = prepared?.packet ?? fallbackPacket(event);
+                    await this.memory.recordTurn({
+                        principal: {
+                            agentId: this.id,
+                            scope: prepared?.principal.scope ?? "global",
+                            qualifier: prepared?.principal.qualifier
+                        },
+                        prompt: {
+                            ...promptPacket,
+                            principal: {
+                                agentId: this.id,
+                                scope: prepared?.principal.scope ?? "global",
+                                qualifier: prepared?.principal.qualifier
+                            }
+                        },
+                        request,
+                        recall: prepared?.recall,
+                        result: "failed",
+                        outputText: extractOutputText(chunks),
+                        toolEvents,
+                        error: this.lastError
+                    });
+                }
+                catch {
+                    // Memory write-back is best-effort when waking fails.
+                }
+            }
             throw error;
         }
         finally {
+            if (this.memoryToolContext) {
+                this.memoryToolContext.current = undefined;
+            }
             unsubscribe();
         }
     }
@@ -97,6 +208,7 @@ const createResourceLoader = (input) => {
         input.instructions,
         "You are running inside a harnessed workspace prepared by the caller.",
         "Use the available coding tools when asked to read, write, edit, or inspect files.",
+        "Use memory_search, memory_locate, memory_register, memory_summarize, and memory_forget when scoped memory matters.",
         "Keep responses brief and report the exact files you created or modified."
     ].join("\n\n");
     return {
@@ -115,10 +227,12 @@ export class PiHarnessAdapter {
     options;
     authStorage;
     modelRegistry;
+    sessionFactory;
     constructor(options) {
         this.options = options;
         this.authStorage = AuthStorage.create(options.authPath);
         this.modelRegistry = createModelRegistry(this.authStorage, options);
+        this.sessionFactory = options.sessionFactory ?? createAgentSession;
     }
     async startAgent(input) {
         await mkdir(input.runtimeHomePath, { recursive: true });
@@ -133,7 +247,23 @@ export class PiHarnessAdapter {
         if (!model) {
             throw new Error(`Pi model not found: ${resolvedModel.provider}/${resolvedModel.name}`);
         }
-        const { session } = await createAgentSession({
+        const memory = createMemoryRuntime({
+            agentId: input.id,
+            runtimeHomePath: input.runtimeHomePath,
+            source: this.options.memory?.source,
+            tokenBudget: this.options.memory?.tokenBudget
+        });
+        const memoryToolContext = {};
+        const memoryTools = createPiMemoryTools({
+            agentId: input.id,
+            memory,
+            contextRef: memoryToolContext
+        });
+        const toolNames = [
+            ...(input.tools ?? ["read", "write", "edit", "bash", "grep", "find", "ls"]),
+            ...piMemoryToolNames(memoryTools)
+        ];
+        const { session } = await this.sessionFactory({
             cwd: input.workspacePath,
             agentDir: input.runtimeHomePath,
             authStorage: this.authStorage,
@@ -141,13 +271,14 @@ export class PiHarnessAdapter {
             model,
             thinkingLevel: "off",
             resourceLoader: createResourceLoader(input),
-            tools: input.tools ?? ["read", "write", "edit", "bash", "grep", "find", "ls"],
+            tools: [...new Set(toolNames)],
+            customTools: memoryTools,
             sessionManager: SessionManager.create(input.workspacePath, path.join(input.runtimeHomePath, "sessions")),
             settingsManager: SettingsManager.inMemory({
                 compaction: { enabled: false },
                 retry: { enabled: true, maxRetries: 1 }
             })
         });
-        return new PiAgentHandle(input.id, session);
+        return new PiAgentHandle(input.id, session, memory, memoryToolContext);
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@noopolis/daimon",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Noopolis native per-agent runtime harness built on Pi.",
   "license": "MIT",
   "type": "module",
@@ -10,6 +10,14 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./pi": {
+      "types": "./dist/pi/index.d.ts",
+      "import": "./dist/pi/index.js"
+    },
+    "./observability": {
+      "types": "./dist/observability/index.d.ts",
+      "import": "./dist/observability/index.js"
     }
   },
   "files": [
@@ -30,16 +38,30 @@
     "prepublishOnly": "npm run typecheck && npm test",
     "typecheck": "tsc --project tsconfig.json --noEmit",
     "test": "node --import tsx --test \"src/**/*.test.ts\"",
-    "e2e:pi-agent": "tsx src/examples/pi-agent.ts"
+    "e2e:pi-agent": "tsx src/examples/pi-agent.ts",
+    "e2e:pi-memory-org": "tsx src/examples/pi-memory-org.ts",
+    "e2e:mixed-engine-org": "tsx src/examples/mixed-engine-org.ts",
+    "e2e:jungian-play-org": "tsx src/examples/jungian-play-org.ts",
+    "e2e:jungian-triad-org": "tsx src/examples/jungian-triad-org.ts",
+    "image:runtime:local": "docker build -f Dockerfile.runtime -t noopolis/spawnfile-runtime-daimon:0.1.1-local --build-arg DAIMON_VERSION=0.1.1 --build-arg MNEME_VERSION=0.1.0 --build-arg PI_VERSION=0.79.10 ."
   },
   "engines": {
     "node": ">=22.19.0"
   },
   "dependencies": {
-    "@earendil-works/pi-ai": "^0.79.9",
-    "@earendil-works/pi-coding-agent": "^0.79.9"
+    "@earendil-works/pi-ai": "^0.79.10",
+    "@earendil-works/pi-coding-agent": "^0.79.10"
+  },
+  "peerDependencies": {
+    "@noopolis/mneme": "^0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@noopolis/mneme": {
+      "optional": true
+    }
   },
   "devDependencies": {
+    "@noopolis/mneme": "^0.1.0",
     "@types/node": "^24.12.4",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"