@noopolis/daimon 0.1.2 → 0.2.1

package/dist/pi/grokStreamUsage.js

@@ -0,0 +1,51 @@
+import { GROK_ENGINE_BROKER } from "../contracts/runtimeContractManifest.js";
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const tokenCount = (value) => typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : undefined;
+const SESSION_ID = /^[A-Za-z0-9][A-Za-z0-9-]{0,63}$/u;
+const MODEL_KEY = /^[a-z0-9][a-z0-9.-]{0,63}$/u;
+const decodeUsage = (usage) => {
+    if (!isRecord(usage))
+        return undefined;
+    const input = tokenCount(usage.input_tokens), output = tokenCount(usage.output_tokens), cacheRead = tokenCount(usage.cache_read_input_tokens), cacheWrite = tokenCount(usage.cache_creation_input_tokens);
+    if (input === undefined || output === undefined || cacheRead === undefined || cacheWrite === undefined)
+        return undefined;
+    const total = input + cacheRead + cacheWrite + output;
+    // Beyond the model context window one request cannot have spent it: invalid, like a malformed block.
+    if (total > GROK_ENGINE_BROKER.turnLimits.requestUsageMaxTokens)
+        return undefined;
+    return { input, cacheRead, cacheWrite, output, total };
+};
+export const decodeGrokStreamUsage = (output) => {
+    const byMessage = new Map();
+    const reportedModels = new Set();
+    let sessionId, corrupt = false;
+    for (const line of output.split(/\r?\n/u)) {
+        if (line.trim().length === 0)
+            continue;
+        let event;
+        try {
+            event = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (!isRecord(event))
+            continue;
+        if (typeof event.session_id === "string" && SESSION_ID.test(event.session_id))
+            sessionId ??= event.session_id;
+        if (event.type === "result" && isRecord(event.modelUsage))
+            for (const key of Object.keys(event.modelUsage))
+                reportedModels.add(MODEL_KEY.test(key) ? key : "invalid");
+        if (event.type !== "assistant" || event.parent_tool_use_id !== null || !isRecord(event.message) || event.message.usage === undefined)
+            continue;
+        const decoded = decodeUsage(event.message.usage);
+        if (decoded === undefined || typeof event.message.id !== "string") {
+            corrupt = true;
+            continue;
+        }
+        // One request can surface as more than one frame of the same message; it is one request.
+        byMessage.set(event.message.id, decoded);
+    }
+    const requests = corrupt ? [] : [...byMessage.values()].map((usage, index) => Object.freeze({ index, ...usage }));
+    return { requests, ...(sessionId === undefined ? {} : { sessionId }), reportedModels: [...reportedModels].sort() };
+};

package/dist/pi/memoryClock.d.ts

@@ -0,0 +1,25 @@
+import * as mneme from "@noopolis/mneme";
+import { type TaskClock } from "../runtime/taskClock.js";
+type MnemeClockModule = {
+    readonly createOffsetClock?: unknown;
+};
+type MemoryConfig = Parameters<typeof mneme.createMemoryRuntime>[0];
+type MemoryModule = MnemeClockModule & {
+    createMemoryRuntime(config: MemoryConfig & {
+        clock?: () => number;
+    }): ReturnType<typeof mneme.createMemoryRuntime>;
+};
+/** Keep construction and capability detection together while the published types catch up. */
+export declare function createClockedMemoryRuntime(config: MemoryConfig, clock?: Readonly<{
+    raw: string;
+    origin: string;
+    anchorEpochMs: number;
+    at(realEpochMs: number): number;
+    now(): number;
+}> | undefined, moduleRoot?: MemoryModule): mneme.MemoryRuntime;
+/** The root export is Mneme's capability signal, including across older published versions. */
+export declare function memoryClockOptions(clock?: TaskClock | undefined, moduleRoot?: MnemeClockModule): {
+    clock?: () => number;
+};
+export {};
+//# sourceMappingURL=memoryClock.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"memoryClock.d.ts","sourceRoot":"","sources":["../../src/pi/memoryClock.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAiB,KAAK,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAExE,KAAK,gBAAgB,GAAG;IAAE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEjE,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,KAAK,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;AACpE,KAAK,YAAY,GAAG,gBAAgB,GAAG;IAAE,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,MAAM,CAAA;KAAE,GAAG,UAAU,CAAC,OAAO,KAAK,CAAC,mBAAmB,CAAC,CAAA;CAAE,CAAC;AAE9J,8FAA8F;AAC9F,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK;;;;;;cAAkB,EAAE,UAAU,GAAE,YAAoB,uBAEzH;AAED,+FAA+F;AAC/F,wBAAgB,kBAAkB,CAChC,KAAK,GAAE,SAAS,GAAG,SAA2B,EAC9C,UAAU,GAAE,gBAA4C,GACvD;IAAE,KAAK,CAAC,EAAE,MAAM,MAAM,CAAA;CAAE,CAQ1B"}

package/dist/pi/memoryClock.js

@@ -0,0 +1,18 @@
+import * as mneme from "@noopolis/mneme";
+import { readTaskClock } from "../runtime/taskClock.js";
+/** Keep construction and capability detection together while the published types catch up. */
+export function createClockedMemoryRuntime(config, clock = readTaskClock(), moduleRoot = mneme) {
+    return moduleRoot.createMemoryRuntime({ ...config, ...memoryClockOptions(clock, moduleRoot) });
+}
+/** The root export is Mneme's capability signal, including across older published versions. */
+export function memoryClockOptions(clock = readTaskClock(), moduleRoot = mneme) {
+    if (clock === undefined)
+        return {};
+    if (typeof moduleRoot.createOffsetClock !== "function") {
+        throw new Error("NOOPOLIS_TASK_CLOCK requires @noopolis/mneme with the root createOffsetClock export and createMemoryRuntime({ clock }) support");
+    }
+    const memoryClock = moduleRoot.createOffsetClock({ origin: clock.origin, anchorMs: clock.anchorEpochMs });
+    if (typeof memoryClock !== "function")
+        throw new Error("@noopolis/mneme createOffsetClock must return an epoch-ms clock function");
+    return { clock: memoryClock };
+}

package/dist/pi/piAgentHandle.d.ts

@@ -6,7 +6,7 @@ import { persistPiTurnTrace, type PiTurnTraceModel } from "./turnTrace.js";
 import { type PiRawTrainingCaptureOptions, type PiRawTrainingCaptureRef } from "./rawTrainingCapture.js";
 import { type PiWorldToolContextRef } from "./worldNudge.js";
 import { type PiWorldTrajectoryIdentity } from "./worldTrajectory.js";
-import { type PiNativeSessionCreator, type PiSession, type PiSessionCreator, type PiSessionLike } from "./piAgentWakeSupport.js";
+import type { PiNativeSessionCreator, PiSession, PiSessionCreator, PiSessionLike, PiWakeEnvironmentContextRef } from "./piAgentWakeSupport.js";
 import { type MemoryRuntime } from "@noopolis/mneme";
 export type { PiSession, PiSessionLike, PiSessionCreator, PiNativeSessionCreator } from "./piAgentWakeSupport.js";
 export type WakeAcceptanceInput = {
@@ -14,6 +14,7 @@ export type WakeAcceptanceInput = {
     completeTurn?: typeof stampTurnOutputCompleted;
     traceTurn?: typeof persistPiTurnTrace;
     createWakeAcceptance?: (runtimeHomePath: string, agentId: string) => WakeAcceptanceStoreLike;
+    causalRunId?: string;
 };
 export declare class PiAgentHandle implements AgentHandle {
     readonly id: string;
@@ -28,6 +29,7 @@ export declare class PiAgentHandle implements AgentHandle {
     private readonly rawTrainingCaptureOptions?;
     private readonly worldTrajectoryIdentity?;
     private readonly piSessionForRawCapture?;
+    private readonly wakeEnvironmentContext?;
     private state;
     private lastWakeAt;
     private lastError;
@@ -35,8 +37,9 @@ export declare class PiAgentHandle implements AgentHandle {
     private readonly stampTurnInputSubmitted;
     private readonly stampTurnOutputCompleted;
     private readonly persistTrace;
-    constructor(id: string, session: PiSession, createSession: PiNativeSessionCreator, runtimeHomePath: string, traceModel: PiTurnTraceModel, memory?: MemoryRuntime, memoryToolContext?: PiMemoryToolContextRef, dependencies?: WakeAcceptanceInput, worldToolContext?: PiWorldToolContextRef, rawTrainingCaptureRef?: PiRawTrainingCaptureRef, rawTrainingCaptureOptions?: PiRawTrainingCaptureOptions, worldTrajectoryIdentity?: PiWorldTrajectoryIdentity, rawTrainingCaptureSession?: PiSession);
-    constructor(id: string, session: PiSessionLike, createSession: PiSessionCreator, runtimeHomePath: string, traceModel: PiTurnTraceModel, memory?: MemoryRuntime, memoryToolContext?: PiMemoryToolContextRef, dependencies?: WakeAcceptanceInput, worldToolContext?: PiWorldToolContextRef, rawTrainingCaptureRef?: never, rawTrainingCaptureOptions?: never, worldTrajectoryIdentity?: PiWorldTrajectoryIdentity, rawTrainingCaptureSession?: never);
+    private readonly causalRunId?;
+    constructor(id: string, session: PiSession, createSession: PiNativeSessionCreator, runtimeHomePath: string, traceModel: PiTurnTraceModel, memory?: MemoryRuntime, memoryToolContext?: PiMemoryToolContextRef, dependencies?: WakeAcceptanceInput, worldToolContext?: PiWorldToolContextRef, rawTrainingCaptureRef?: PiRawTrainingCaptureRef, rawTrainingCaptureOptions?: PiRawTrainingCaptureOptions, worldTrajectoryIdentity?: PiWorldTrajectoryIdentity, rawTrainingCaptureSession?: PiSession, wakeEnvironmentContext?: PiWakeEnvironmentContextRef);
+    constructor(id: string, session: PiSessionLike, createSession: PiSessionCreator, runtimeHomePath: string, traceModel: PiTurnTraceModel, memory?: MemoryRuntime, memoryToolContext?: PiMemoryToolContextRef, dependencies?: WakeAcceptanceInput, worldToolContext?: PiWorldToolContextRef, rawTrainingCaptureRef?: never, rawTrainingCaptureOptions?: never, worldTrajectoryIdentity?: PiWorldTrajectoryIdentity, rawTrainingCaptureSession?: never, wakeEnvironmentContext?: PiWakeEnvironmentContextRef);
     wake(event: WakeEvent): Promise<WakeResult>;
     private runWake;
     status(): AgentStatus;

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

@@ -1 +1 @@
-{"version":3,"file":"piAgentHandle.d.ts","sourceRoot":"","sources":["../../src/pi/piAgentHandle.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"piAgentHandle.d.ts","sourceRoot":"","sources":["../../src/pi/piAgentHandle.ts"],"names":[],"mappings":"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"}

package/dist/pi/piAgentHandle.js

@@ -1,5 +1,5 @@
 import { createTrustedPiMemoryToolContext } from "./memoryTools.js";
-import { formatWakePrompt } from "./prompts.js";
+import { formatWakePrompt, preserveModelFacingWakeIdentity } from "./prompts.js";
 import { stampTurnInputSubmitted, stampTurnOutputCompleted } from "./turnCausal.js";
 import { WakeAcceptanceStore } from "./wakeAcceptance.js";
 import { persistPiTurnTrace } from "./turnTrace.js";
@@ -7,7 +7,7 @@ import { formatDreamPrompt } from "./wakeModes.js";
 import { createPiRawTrainingCapture } from "./rawTrainingCapture.js";
 import { formatWorldWakePrompt, worldWakeContext } from "./worldNudge.js";
 import { createPiWorldTrajectoryCapture } from "./worldTrajectory.js";
-import { cloneWakeEvent, persistPiTurnArtifacts, PiWakeDeliveryQueue, selectPiSessionForWake, subscribeToPiTurnEvents } from "./piAgentWakeSupport.js";
+import { cloneWakeEvent, disposePiSession, persistPiTurnArtifacts, PiWakeDeliveryQueue, selectPiSessionForWake, subscribeToPiTurnEvents } from "./piAgentWakeSupport.js";
 import { readMemoryContext } from "@noopolis/mneme";
 export class PiAgentHandle {
     id;
@@ -22,6 +22,7 @@ export class PiAgentHandle {
     rawTrainingCaptureOptions;
     worldTrajectoryIdentity;
     piSessionForRawCapture;
+    wakeEnvironmentContext;
     state = "idle";
     lastWakeAt;
     lastError;
@@ -29,7 +30,8 @@ export class PiAgentHandle {
     stampTurnInputSubmitted;
     stampTurnOutputCompleted;
     persistTrace;
-    constructor(id, session, createSession, runtimeHomePath, traceModel, memory, memoryToolContext, dependencies = {}, worldToolContext, rawTrainingCaptureRef, rawTrainingCaptureOptions, worldTrajectoryIdentity, piSessionForRawCapture) {
+    causalRunId;
+    constructor(id, session, createSession, runtimeHomePath, traceModel, memory, memoryToolContext, dependencies = {}, worldToolContext, rawTrainingCaptureRef, rawTrainingCaptureOptions, worldTrajectoryIdentity, piSessionForRawCapture, wakeEnvironmentContext) {
         this.id = id;
         this.session = session;
         this.createSession = createSession;
@@ -42,11 +44,12 @@ export class PiAgentHandle {
         this.rawTrainingCaptureOptions = rawTrainingCaptureOptions;
         this.worldTrajectoryIdentity = worldTrajectoryIdentity;
         this.piSessionForRawCapture = piSessionForRawCapture;
+        this.wakeEnvironmentContext = wakeEnvironmentContext;
         this.stampTurnInputSubmitted = dependencies.runWake ?? stampTurnInputSubmitted;
         this.stampTurnOutputCompleted = dependencies.completeTurn ?? stampTurnOutputCompleted;
         this.persistTrace = dependencies.traceTurn ?? persistPiTurnTrace;
-        const wakeAcceptance = dependencies.createWakeAcceptance?.(runtimeHomePath, id) ??
-            new WakeAcceptanceStore(runtimeHomePath, id);
+        this.causalRunId = dependencies.causalRunId;
+        const wakeAcceptance = dependencies.createWakeAcceptance?.(runtimeHomePath, id) ?? new WakeAcceptanceStore(runtimeHomePath, id, undefined, this.causalRunId);
         this.wakeDeliveryQueue = new PiWakeDeliveryQueue(id, wakeAcceptance);
     }
     async wake(event) {
@@ -88,7 +91,7 @@ export class PiAgentHandle {
             ? undefined
             : createPiWorldTrajectoryCapture();
         const request = {
-            eventId: event.id,
+            eventId: /^(simfile|moltnet|mneme|daimon):.+$/u.test(event.id) ? event.id : `daimon:${event.id}`,
             kind: event.kind,
             text: safeWakeText,
             from: event.from,
@@ -98,6 +101,10 @@ export class PiAgentHandle {
             ? formatWakePrompt(event)
             : safeWakeText;
         try {
+            if (this.wakeEnvironmentContext !== undefined) {
+                this.wakeEnvironmentContext.current = event.id;
+                this.wakeEnvironmentContext.spokeFor = undefined;
+            }
             if (this.worldToolContext !== undefined) {
                 this.worldToolContext.current = worldContext;
             }
@@ -139,7 +146,7 @@ export class PiAgentHandle {
                     prepared,
                     status: "completed"
                 };
-                promptText = prepared.promptText;
+                promptText = preserveModelFacingWakeIdentity(prepared.promptText, event, request.eventId);
                 if (this.memoryToolContext !== undefined) {
                     this.memoryToolContext.observeTool = (toolEvent) => tools.push(toolEvent);
                     this.memoryToolContext.current = createTrustedPiMemoryToolContext({
@@ -157,6 +164,7 @@ export class PiAgentHandle {
             }
             stage = "causal_input";
             const turnInput = await this.stampTurnInputSubmitted({
+                runId: this.causalRunId,
                 agentId: this.id,
                 event,
                 prepared,
@@ -169,18 +177,24 @@ export class PiAgentHandle {
             }
             stage = "engine_prompt";
             const engineStartedAt = Date.now();
+            selectedSession.session.bindWake?.(event);
             await selectedSession.session.prompt(promptText, { expandPromptTemplates: false });
             enginePromptMs = Date.now() - engineStartedAt;
             this.state = "idle";
             const outputText = chunks.join("\n").trim();
             stage = "causal_output";
             await this.stampTurnOutputCompleted({
+                runId: this.causalRunId,
                 agentId: this.id,
                 causeEventId: turnInput.event_id,
                 outputText,
                 runtimeHomePath: this.runtimeHomePath,
                 turnId: event.id
             });
+            if (this.memory !== undefined && prepared !== undefined) {
+                await this.memory.recordTurn({ principal: prepared.principal, prompt: prepared.packet, request, recall: prepared.recall, result: "completed", outputText, toolEvents: tools })
+                    .catch((recordError) => { this.lastError = `memory record failed: ${recordError instanceof Error ? recordError.message : String(recordError)}`; });
+            }
             await this.persistTrace({
                 agentId: this.id,
                 enginePromptMs,
@@ -203,9 +217,6 @@ export class PiAgentHandle {
             if (rawTrainingCapture !== undefined
                 && this.rawTrainingCaptureOptions !== undefined
                 && this.piSessionForRawCapture !== undefined) {
-                // Do not retry a partially failed private capture in the catch path.
-                // The first failure is authoritative and retrying the same immutable
-                // turn path would only mask it with an EEXIST/partial-write error.
                 rawTrainingCapturePersistAttempted = true;
             }
             await persistPiTurnArtifacts({
@@ -225,9 +236,18 @@ export class PiAgentHandle {
                 worldTrajectory,
                 worldTrajectoryIdentity: this.worldTrajectoryIdentity
             });
+            // An agent with a mounted `moltnet_send` tool has exactly one
+            // legitimate publication channel; its terminal text is always a
+            // private note to the runtime — whether it spoke, stayed silent, or
+            // narrated a failure back as its reply — never the bridge's
+            // terminal-text fallback (moltnet/internal/bridge/daimon/
+            // receipt_tracker.go), which is reserved for agents with no send tool
+            // at all. `outputText` itself stays intact for the turn trace and
+            // memory record above.
+            const hasSendCapability = this.wakeEnvironmentContext?.hasSendCapability === true;
             return {
                 agentId: this.id,
-                text: outputText,
+                text: hasSendCapability ? "" : outputText,
                 durationMs: Date.now() - startedAtMs
             };
         }
@@ -264,6 +284,9 @@ export class PiAgentHandle {
                     ? {}
                     : { worldContextBound: worldContext !== undefined })
             }).catch(() => undefined);
+            if (this.memory !== undefined && prepared !== undefined) {
+                await this.memory.recordTurn({ principal: prepared.principal, prompt: prepared.packet, request, recall: prepared.recall, result: "failed", error: message, outputText: chunks.join("\n").trim(), toolEvents: tools }).catch(() => undefined);
+            }
             const persistRawCapture = !rawTrainingCapturePersistAttempted
                 && selectedSession !== undefined;
             if (persistRawCapture && rawTrainingCapture !== undefined) {
@@ -293,6 +316,11 @@ export class PiAgentHandle {
             throw error;
         }
         finally {
+            selectedSession?.session.bindWake?.();
+            if (this.wakeEnvironmentContext !== undefined) {
+                this.wakeEnvironmentContext.current = undefined;
+                this.wakeEnvironmentContext.spokeFor = undefined;
+            }
             if (this.memoryToolContext !== undefined) {
                 this.memoryToolContext.current = undefined;
                 this.memoryToolContext.observeTool = undefined;
@@ -318,7 +346,9 @@ export class PiAgentHandle {
         };
     }
     async stop() {
-        this.session.dispose();
+        // CLI-backed sessions may own a process group, while native Pi remains
+        // source-compatible through the synchronous dispose() hook.
+        await disposePiSession(this.session);
         this.state = "stopped";
     }
 }

package/dist/pi/piAgentWakeSupport.d.ts

@@ -10,8 +10,43 @@ export type PiSession = Awaited<ReturnType<typeof createAgentSession>>["session"
 export interface PiSessionLike {
     subscribe(listener: Parameters<PiSession["subscribe"]>[0]): () => void;
     prompt(text: string, options?: Parameters<PiSession["prompt"]>[1]): Promise<void>;
+    /** Optional per-turn context for isolated CLI child environments. */
+    bindWake?(event?: WakeEvent): void;
+    /** Kept synchronous for existing Pi session implementations. */
     dispose(): void;
+    /** Optional additive hook for sessions that must asynchronously quiesce children. */
+    disposeAsync?(): Promise<void>;
 }
+export type PiWakeEnvironmentContextRef = {
+    current?: string;
+    /**
+     * Set to the delivery id of the current wake once `moltnet_send` has been
+     * accepted during it. Bookkeeping only: it no longer gates whether the wake
+     * completion path publishes terminal text (see `hasSendCapability`), but it
+     * still records, per wake, whether this agent actually spoke. Never a
+     * boolean: a boolean could survive a stale reset and silently misattribute
+     * a later wake.
+     */
+    spokeFor?: string;
+    /**
+     * Set once per agent, at harness construction, to whether a `moltnet_send`
+     * tool is mounted for it (`piHarness.ts`, from `productionTools`) — never
+     * reset per wake, unlike `current`/`spokeFor`.
+     *
+     * A turn that fails partway (a tool error the model narrates back as
+     * terminal text, e.g. "Blocked: Moltnet auth is not mounted...") still
+     * completes structurally and used to publish that narration through the
+     * terminal-text fallback even though `moltnet_send` was never actually
+     * called — a second, unintended echo into the room. An agent with a
+     * mounted send tool has exactly one legitimate publication channel
+     * (`moltnet_send`); its terminal text is always a private note to the
+     * runtime, whether it spoke, stayed silent, or failed. Only an agent with
+     * no send tool at all keeps the documented terminal-text fallback
+     * (`moltnet/internal/bridge/daimon/AGENTS.md`).
+     */
+    hasSendCapability?: boolean;
+};
+export declare function disposePiSession(session: PiSessionLike): Promise<void>;
 export type PiSessionCreator = (mode: MemoryWakeMode, sessionDirectory: string) => Promise<PiSessionLike>;
 export type PiNativeSessionCreator = (mode: MemoryWakeMode, sessionDirectory: string) => Promise<PiSession>;
 export interface WakeSessionSelection {

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

@@ -1 +1 @@
-{"version":3,"file":"piAgentWakeSupport.d.ts","sourceRoot":"","sources":["../../src/pi/piAgentWakeSupport.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"piAgentWakeSupport.d.ts","sourceRoot":"","sources":["../../src/pi/piAgentWakeSupport.ts"],"names":[],"mappings":"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"}

package/dist/pi/piAgentWakeSupport.js

@@ -3,6 +3,10 @@ import { summarizeSessionEvent, } from "./turnTrace.js";
 import { createAwakeThreadId, createDreamSessionDirectory, createDreamSessionKey, createDreamThreadId, } from "./wakeModes.js";
 import { WakeAcceptanceError, } from "./wakeAcceptance.js";
 import { capturePiWorldTrajectoryEvent, persistPiWorldTrajectory, } from "./worldTrajectory.js";
+export async function disposePiSession(session) {
+    await Promise.resolve(session.dispose());
+    await session.disposeAsync?.();
+}
 export class PiWakeDeliveryQueue {
     agentId;
     acceptance;

package/dist/pi/piHarness.d.ts

@@ -1,8 +1,10 @@
-import { createAgentSession } from "@earendil-works/pi-coding-agent";
-import { type MemoryAuthorityConfig } from "@noopolis/mneme";
+import { createAgentSession, type ToolDefinition } from "@earendil-works/pi-coding-agent";
+import type { MemoryAuthorityConfig } from "@noopolis/mneme";
 import type { AgentHandle, AgentHarnessAdapter, AgentStartInput, HarnessModelSpec } from "../core/types.js";
 import { type PiSessionLike } from "./piAgentHandle.js";
+import { type PiWakeEnvironmentContextRef } from "./piAgentWakeSupport.js";
 import { type PiWorldBinding } from "./worldTools.js";
+import { type TaskClockProcessProbe } from "./taskClockProcess.js";
 import { type PiRawTrainingCaptureOptions } from "./rawTrainingCapture.js";
 type HarnessMemoryEmbeddingProvider = {
     dimensions?: number;
@@ -18,6 +20,8 @@ type PiHarnessBaseOptions = {
         name: string;
     };
     modelsPath?: string;
+    /** Host-only names removed from every engine and Pi bash child environment. */
+    protectedEnvironmentNames?: readonly string[];
     memory?: {
         authority?: MemoryAuthorityConfig;
         embeddingProvider?: HarnessMemoryEmbeddingProvider;
@@ -27,6 +31,10 @@ type PiHarnessBaseOptions = {
     };
     thinkingLevel?: PiThinkingLevel;
     world?: PiWorldBinding;
+    productionTools?: readonly ToolDefinition[];
+    /** Engine-owned default; an empty list disables Pi builtins for confined CLI engines. */
+    toolNames?: readonly string[];
+    wakeEnvironmentContext?: PiWakeEnvironmentContextRef;
 };
 export type PiHarnessOptions = PiHarnessBaseOptions & ({
     rawTrainingCapture?: PiRawTrainingCaptureOptions;
@@ -37,16 +45,23 @@ export type PiHarnessOptions = PiHarnessBaseOptions & ({
 });
 export type PiSessionFactoryInput = Exclude<Parameters<typeof createAgentSession>[0], undefined> & {
     daimonSecretEnvironmentNames?: readonly string[];
+    /** The isolated runtime home assigned by Daimon to this one agent. */
+    runtimeHomePath?: string;
 };
 export type PiSessionFactory = (input: PiSessionFactoryInput) => Promise<{
     session: PiSessionLike;
 }>;
 export declare class PiHarnessAdapter implements AgentHarnessAdapter {
     private readonly options;
+    private readonly taskClockProbe?;
+    static readonly capabilities: Readonly<{
+        causalRunId: true;
+        memoryCausalRunId: false;
+    }>;
     private readonly authStorage;
     private readonly modelRegistry;
     private readonly sessionFactory;
-    constructor(options: PiHarnessOptions);
+    constructor(options: PiHarnessOptions, /** @internal */ taskClockProbe?: TaskClockProcessProbe | undefined);
     startAgent(input: AgentStartInput): Promise<AgentHandle>;
 }
 export {};

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

@@ -1 +1 @@
-{"version":3,"file":"piHarness.d.ts","sourceRoot":"","sources":["../../src/pi/piHarness.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,kBAAkB,EAInB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAuB,KAAK,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAElF,OAAO,KAAK,EAAE,WAAW,EAAE,mBAAmB,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAM5G,OAAO,EAAqE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC3H,OAAO,EAAwC,KAAK,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAE5F,OAAO,EAGL,KAAK,2BAA2B,EAEjC,MAAM,yBAAyB,CAAC;AAEjC,KAAK,8BAA8B,GAAG;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,WAAW,CACvC,WAAW,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CACvE,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC1B,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;IACpB,MAAM,CAAC,EAAE;QACP,SAAS,CAAC,EAAE,qBAAqB,CAAC;QAClC,iBAAiB,CAAC,EAAE,8BAA8B,CAAC;QACnD,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IACF,aAAa,CAAC,EAAE,eAAe,CAAC;IAChC,KAAK,CAAC,EAAE,cAAc,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,oBAAoB,GAAG,CAClD;IACA,kBAAkB,CAAC,EAAE,2BAA2B,CAAC;IACjD,cAAc,CAAC,EAAE,KAAK,CAAC;CACxB,GACC;IACA,kBAAkB,CAAC,EAAE,KAAK,CAAC;IAC3B,cAAc,EAAE,gBAAgB,CAAC;CAClC,CACF,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG;IACjG,4BAA4B,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,qBAAqB,KAAK,OAAO,CAAC;IAAE,OAAO,EAAE,aAAa,CAAA;CAAE,CAAC,CAAC;AAErG,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;CA4I/D"}
+{"version":3,"file":"piHarness.d.ts","sourceRoot":"","sources":["../../src/pi/piHarness.ts"],"names":[],"mappings":"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"}