harnery 0.8.0 → 0.10.0

package/dist/core/hooks/cli.js

@@ -26,6 +26,8 @@ import { consumeSince, writeCursor } from "../agents/events/consume.js";
 import { evaluateStopHook } from "../agents/rules/stop-hook.js";
 import { projectHeartbeats } from "../agents/state/heartbeat-projector.js";
 import { shellMutationPaths } from "../agents/state/shell-mutation.js";
+import { checkpointContext, completeContextRecovery, extractContextSample, markContextCompactionCompleted, prepareContextRecovery, readContextState, recordContextSample, } from "../context/index.js";
+import { ensureRelayDaemon, fetchPresence, publishPresence } from "../presence/index.js";
 import { captureImages, detectPresence, imageJanitor, playSound, resetSoundCounters, runSessionSyncExtension, runTurnSummary, scratchArchive, scratchJanitor, scratchRecoveryCue, soundForEvent, } from "./effects/index.js";
 import { emit } from "./events/emit.js";
 import { canonicalize } from "./guard-path.js";
@@ -69,6 +71,16 @@ async function readStdin() {
         return "";
     }
 }
+/**
+ * Env for child agent-coord spawns, with the coord root pinned. The hook
+ * process may be running with the session shell's cwd (inside a submodule or
+ * scratch dir), and agent-coord resolves its root from cwd unless overridden —
+ * without the pin a child could write state to a different .harnery than the
+ * one this hook resolved.
+ */
+function childEnv(coordRoot) {
+    return { ...process.env, HARNERY_COORD_ROOT_OVERRIDE: coordRoot };
+}
 function appendDebug(coordRoot, entry) {
     const path = join(coordRoot, ".harnery", "debug", "agent-hook.ndjson");
     try {
@@ -112,6 +124,7 @@ function assignNameViaAgentCoord(coordRoot, instanceId, kind) {
         const result = spawnSync(binary, ["assign-name", instanceId, kind], {
             encoding: "utf8",
             timeout: 2000,
+            env: childEnv(coordRoot),
         });
         if (result.status !== 0 || !result.stdout)
             return null;
@@ -206,6 +219,12 @@ function buildEventData(eventType, ctx) {
                 name: assigned?.name,
                 kind: "session",
                 agent_id: ctx.instanceId,
+                // Workflow-child linkage: `workflow run` children carry the run id in
+                // env (spawn adapters set it via buildChildEnv), so their sessions and
+                // heartbeats join back to the run journal + /workflows web view.
+                ...(coordEnv("WORKFLOW_CHILD") === "1" && coordEnv("WORKFLOW_RUN_ID")
+                    ? { workflow_run_id: coordEnv("WORKFLOW_RUN_ID") }
+                    : {}),
             };
         }
         case "session.end":
@@ -308,8 +327,40 @@ function buildEventData(eventType, ctx) {
                 ...(summary.truncated ? { truncated: true } : {}),
             };
         }
+        case "context.compaction.started": {
+            const metadata = objectRecord(p?.raw.compact_metadata);
+            return {
+                trigger: stringField(p?.raw.trigger) ?? stringField(metadata?.trigger),
+                pre_tokens: numberField(p?.raw.pre_tokens) ??
+                    numberField(metadata?.pre_tokens) ??
+                    numberField(metadata?.pre_compact_tokens),
+            };
+        }
+        case "context.compaction.completed": {
+            const metadata = objectRecord(p?.raw.compact_metadata);
+            return {
+                trigger: stringField(p?.raw.trigger) ?? stringField(metadata?.trigger),
+                pre_tokens: numberField(p?.raw.pre_tokens) ??
+                    numberField(metadata?.pre_tokens) ??
+                    numberField(metadata?.pre_compact_tokens),
+                post_tokens: numberField(p?.raw.post_tokens) ??
+                    numberField(metadata?.post_tokens) ??
+                    numberField(metadata?.post_compact_tokens),
+            };
+        }
     }
 }
+function objectRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function stringField(value) {
+    return typeof value === "string" && value.length > 0 ? value : undefined;
+}
+function numberField(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : undefined;
+}
 async function main() {
     const { eventName, extra } = parseArgv(process.argv.slice(2));
     const harness = detectHarness(process.argv.slice(2));
@@ -401,6 +452,84 @@ async function main() {
         owner_source: owner.source,
         event_id: envelope.event_id,
     });
+    // Context telemetry is opportunistic and truthful: only persist a sample
+    // when the harness payload actually exposes usage/window data. Identical
+    // measurements are de-duplicated before they reach the canonical stream.
+    if (payload?.raw) {
+        try {
+            const sample = extractContextSample(payload.raw, {
+                sessionId,
+                harness,
+                model: payload.model,
+                source: "hook",
+                confidence: "reported",
+            });
+            if (sample) {
+                const recorded = recordContextSample(coordRoot, owner.instance_id, sample);
+                if (recorded.changed) {
+                    emit(coordRoot, {
+                        event_type: "context.sampled",
+                        instance_id: owner.instance_id,
+                        session_id: sessionId,
+                        harness,
+                        data: {
+                            model: sample.model,
+                            used_tokens: sample.used_tokens,
+                            window_tokens: sample.window_tokens,
+                            used_percent: sample.used_percent,
+                            telemetry_source: sample.source,
+                            confidence: sample.confidence,
+                        },
+                    });
+                }
+            }
+        }
+        catch (err) {
+            logError(coordRoot, err, { phase: "context-sample" });
+        }
+    }
+    // A native pre-compaction signal is the safest available point to capture
+    // external work state. The operation is idempotent until recovery, so a
+    // harness retry cannot create a storm of near-identical capsules.
+    if (norm.event_type === "context.compaction.started") {
+        try {
+            const checkpoint = checkpointContext(coordRoot, {
+                sessionId,
+                instanceId: owner.instance_id,
+                harness,
+                cwd: payload?.cwd ?? process.cwd(),
+                reason: "pre_compact",
+                model: payload?.model,
+            });
+            emit(coordRoot, {
+                event_type: "context.checkpoint.created",
+                instance_id: owner.instance_id,
+                session_id: sessionId,
+                harness,
+                data: {
+                    capsule_id: checkpoint.capsule.capsule_id,
+                    generation: checkpoint.capsule.generation,
+                    path: checkpoint.state.latest_capsule ?? "",
+                    reason: checkpoint.capsule.reason,
+                    reused: checkpoint.reused,
+                },
+            });
+        }
+        catch (err) {
+            logError(coordRoot, err, { phase: "context-checkpoint" });
+        }
+    }
+    if (norm.event_type === "context.compaction.completed") {
+        try {
+            markContextCompactionCompleted(coordRoot, {
+                sessionId,
+                instanceId: owner.instance_id,
+            });
+        }
+        catch (err) {
+            logError(coordRoot, err, { phase: "context-compaction-completed" });
+        }
+    }
     // Phase 8: SessionStart post-emit: project the event so the heartbeat
     // lands synchronously, run stale-sweep, and emit the harness-shaped
     // systemMessage JSON (peer table + wiring check + council invites).
@@ -421,12 +550,50 @@ async function main() {
         catch (err) {
             logError(coordRoot, err, { phase: "session-start-image-janitor" });
         }
+        let recovery = null;
+        if (payload?.source === "compact") {
+            try {
+                emit(coordRoot, {
+                    event_type: "context.compaction.completed",
+                    instance_id: owner.instance_id,
+                    session_id: sessionId,
+                    harness,
+                    data: { trigger: "auto" },
+                });
+                markContextCompactionCompleted(coordRoot, {
+                    sessionId,
+                    instanceId: owner.instance_id,
+                });
+                recovery = prepareContextRecovery(coordRoot, {
+                    instanceId: owner.instance_id,
+                    sessionId,
+                    cwd: payload?.cwd ?? process.cwd(),
+                });
+            }
+            catch (err) {
+                logError(coordRoot, err, { phase: "context-recovery-session-start" });
+            }
+        }
         try {
-            await emitSessionStartSystemMessage(coordRoot, owner.instance_id, sessionId, data, harness);
+            const injected = await emitSessionStartSystemMessage(coordRoot, owner.instance_id, sessionId, data, harness, recovery?.briefing ?? "");
+            if (injected && recovery) {
+                completeRecoveryInjection(coordRoot, owner.instance_id, sessionId, harness, recovery, "SessionStart");
+            }
         }
         catch (err) {
             logError(coordRoot, err, { phase: "session-start-systemMessage" });
         }
+        // Cross-machine presence (ADR 0016): announce this machine's sessions and
+        // pull peers'. Both are throttled + fail-silent; network runs detached.
+        // When a relay is configured, also make sure the live-socket daemon runs.
+        try {
+            publishPresence(coordRoot);
+            fetchPresence(coordRoot);
+            ensureRelayDaemon(coordRoot);
+        }
+        catch (err) {
+            logError(coordRoot, err, { phase: "session-start-presence" });
+        }
     }
     // Phase 8: SessionEnd cleanup: delete heartbeat + pid-map rows. Harness-
     // agnostic since v0.5.0.
@@ -443,6 +610,14 @@ async function main() {
             scratchArchive(coordRoot, owner.instance_id);
             runSessionSyncExtension(coordRoot, true);
         }
+        // Presence: publish the post-cleanup state so peers see this session gone
+        // promptly rather than waiting out the remote-stale window.
+        try {
+            publishPresence(coordRoot);
+        }
+        catch (err) {
+            logError(coordRoot, err, { phase: "session-end-presence" });
+        }
     }
     // Phase 8: SubagentStart: sync-project to create the subagent heartbeat,
     // log the lifecycle event, and emit a context message announcing the
@@ -451,13 +626,17 @@ async function main() {
         try {
             const agentCoordBin = join(coordRoot, "harnery", "bin", "agent-coord");
             if (existsSync(agentCoordBin)) {
-                spawnSync(agentCoordBin, ["project"], { encoding: "utf8", timeout: 3000 });
+                spawnSync(agentCoordBin, ["project"], {
+                    encoding: "utf8",
+                    timeout: 3000,
+                    env: childEnv(coordRoot),
+                });
                 spawnSync(agentCoordBin, [
                     "log",
                     `SUBAGENT_START  agent_type=${data.agent_type ?? "unknown"} agent_id=${owner.instance_id.slice(0, 8)} platform=${harnessPlatform(harness)}`,
                     "--instance",
                     owner.instance_id,
-                ], { encoding: "utf8", timeout: 2000 });
+                ], { encoding: "utf8", timeout: 2000, env: childEnv(coordRoot) });
             }
             emitSubagentStartContext(coordRoot, owner.instance_id, sessionId, data, harness);
         }
@@ -476,7 +655,7 @@ async function main() {
                     `SUBAGENT_STOP   agent_id=${owner.instance_id.slice(0, 8)} platform=${harnessPlatform(harness)}`,
                     "--instance",
                     owner.instance_id,
-                ], { encoding: "utf8", timeout: 2000 });
+                ], { encoding: "utf8", timeout: 2000, env: childEnv(coordRoot) });
             }
         }
         catch (err) {
@@ -494,8 +673,34 @@ async function main() {
             if (prompt)
                 detectPresence(prompt);
         }
+        // Presence: throttled pull of peer machines' presence refs (default 60s
+        // interval; the systemMessage below reads whatever is locally known).
         try {
-            await emitUserPromptSubmitSystemMessage(coordRoot, owner.instance_id, sessionId, harness);
+            fetchPresence(coordRoot);
+        }
+        catch (err) {
+            logError(coordRoot, err, { phase: "user-prompt-submit-presence" });
+        }
+        let recovery = null;
+        const continuityState = readContextState(coordRoot, sessionId);
+        if (continuityState?.phase === "checkpointed" &&
+            continuityState.compaction_completed_at !== undefined) {
+            try {
+                recovery = prepareContextRecovery(coordRoot, {
+                    instanceId: owner.instance_id,
+                    sessionId,
+                    cwd: payload?.cwd ?? process.cwd(),
+                });
+            }
+            catch (err) {
+                logError(coordRoot, err, { phase: "context-recovery-user-prompt" });
+            }
+        }
+        try {
+            const injected = await emitUserPromptSubmitSystemMessage(coordRoot, owner.instance_id, sessionId, harness, recovery?.briefing ?? "");
+            if (injected && recovery) {
+                completeRecoveryInjection(coordRoot, owner.instance_id, sessionId, harness, recovery, "UserPromptSubmit");
+            }
         }
         catch (err) {
             logError(coordRoot, err, { phase: "user-prompt-submit-systemMessage" });
@@ -548,6 +753,17 @@ async function main() {
         catch (err) {
             logError(coordRoot, err, { phase: "stop-projection" });
         }
+        // Presence: publish AFTER the projection above so the blob carries this
+        // turn's fresh task/turn_summary/files. Change-batched + keepalive'd;
+        // the push itself runs detached. The relay daemon (when configured) is
+        // re-ensured here too — it self-exits on idle, and the next turn revives it.
+        try {
+            publishPresence(coordRoot);
+            ensureRelayDaemon(coordRoot);
+        }
+        catch (err) {
+            logError(coordRoot, err, { phase: "stop-presence" });
+        }
         // Stop verdict (status-box + set-task gate). Direct in-process call: the
         // rule lives in harnery. agent-hook already emitted this turn.stop (with
         // status_box_present) above, so the evidence is in the stream.
@@ -557,6 +773,7 @@ async function main() {
             session_id: sessionId,
             harness,
             bypass: coordEnv("AGENT_COORD_BYPASS_STOP") === "1",
+            workflow_child: coordEnv("WORKFLOW_CHILD") === "1",
         });
         if (!verdict.allow) {
             // Harness-aware enforcement channel: Claude Code / Codex honor exit-2 +
@@ -710,6 +927,7 @@ async function runPreToolUseGuard(coordRoot, instanceId, sessionId, data, harnes
             input: verdictReq,
             encoding: "utf8",
             timeout: 3000,
+            env: childEnv(coordRoot),
         });
         if (result.status !== 0 || !result.stdout)
             continue;
@@ -804,6 +1022,7 @@ function healHeartbeatViaCli(coordRoot, instanceId, sessionId, harness) {
     spawnSync(agentCoordBin, ["heal-heartbeat", instanceId, sessionId, `--harness=${harness}`], {
         encoding: "utf8",
         timeout: 2000,
+        env: childEnv(coordRoot),
     });
 }
 /**
@@ -908,6 +1127,7 @@ function stampToolActivity(coordRoot, instanceId, data) {
     spawnSync(agentCoordBin, ["stamp-tool-activity", instanceId, toolName, target], {
         encoding: "utf8",
         timeout: 2000,
+        env: childEnv(coordRoot),
     });
 }
 function releaseClaimOnFailure(coordRoot, instanceId, data, rawPayload) {
@@ -955,6 +1175,7 @@ function releaseClaimOnFailure(coordRoot, instanceId, data, rawPayload) {
     spawnSync(agentCoordBin, ["release-claim", instanceId, canonical], {
         encoding: "utf8",
         timeout: 2000,
+        env: childEnv(coordRoot),
     });
 }
 function cleanupSessionEnd(coordRoot, instanceId, reason) {
@@ -997,39 +1218,43 @@ function cleanupSessionEnd(coordRoot, instanceId, reason) {
         spawnSync(agentCoordBin, ["log", `SESSION_END     reason=${reason}`, "--instance", instanceId], { encoding: "utf8", timeout: 2000 });
     }
 }
-async function emitUserPromptSubmitSystemMessage(coordRoot, instanceId, sessionId, harness) {
+async function emitUserPromptSubmitSystemMessage(coordRoot, instanceId, sessionId, harness, recoveryBriefing = "") {
     const agentCoordBin = join(coordRoot, "harnery", "bin", "agent-coord");
-    if (!existsSync(agentCoordBin))
-        return;
-    // Look up the agent's name from its heartbeat (for council pending rendering).
-    let agentName = "";
-    try {
-        const fs = require("node:fs");
-        const hbPath = join(coordRoot, ".harnery", "active", `${instanceId}.json`);
-        if (fs.existsSync(hbPath)) {
-            const hb = JSON.parse(fs.readFileSync(hbPath, "utf8"));
-            agentName = hb.name ?? "";
+    let additionalContext = "";
+    if (existsSync(agentCoordBin)) {
+        // Look up the agent's name from its heartbeat (for council pending rendering).
+        let agentName = "";
+        try {
+            const fs = require("node:fs");
+            const hbPath = join(coordRoot, ".harnery", "active", `${instanceId}.json`);
+            if (fs.existsSync(hbPath)) {
+                const hb = JSON.parse(fs.readFileSync(hbPath, "utf8"));
+                agentName = hb.name ?? "";
+            }
         }
+        catch {
+            /* fall through with empty name; peer table still renders */
+        }
+        const args = ["prompt-context", "--instance", instanceId, "--session", sessionId];
+        if (agentName)
+            args.push("--name", agentName);
+        // Cursor + Codex sessions get the set-task staleness nudge. CC enforces it
+        // via the Stop-hook transcript scan; the nudge replaces that for harnesses
+        // that don't reliably expose a transcript_path during stop.
+        if (harness === "cursor" || harness === "codex")
+            args.push("--task-nudge");
+        const result = spawnSync(agentCoordBin, args, { encoding: "utf8", timeout: 3000 });
+        if (result.status === 0 && result.stdout)
+            additionalContext = result.stdout.trim();
     }
-    catch {
-        /* fall through with empty name; peer table still renders */
+    if (recoveryBriefing) {
+        additionalContext = [additionalContext, recoveryBriefing].filter(Boolean).join("\n\n");
     }
-    const args = ["prompt-context", "--instance", instanceId, "--session", sessionId];
-    if (agentName)
-        args.push("--name", agentName);
-    // Cursor + Codex sessions get the set-task staleness nudge. CC enforces it
-    // via the Stop-hook transcript scan; the nudge replaces that for harnesses
-    // that don't reliably expose a transcript_path during stop.
-    if (harness === "cursor" || harness === "codex")
-        args.push("--task-nudge");
-    const result = spawnSync(agentCoordBin, args, { encoding: "utf8", timeout: 3000 });
-    if (result.status !== 0 || !result.stdout)
-        return;
-    const additionalContext = result.stdout.trim();
     if (!additionalContext)
-        return;
+        return false;
     const { emitContext } = await import("./harness/output.js");
     emitContext(harness, "UserPromptSubmit", additionalContext);
+    return true;
 }
 function emitSubagentStartContext(coordRoot, instanceId, sessionId, data, harness) {
     // Look up the subagent's assigned name (just-written by agent-coord assignName
@@ -1063,42 +1288,40 @@ function harnessPlatform(harness) {
         return "claude_code";
     return harness;
 }
-async function emitSessionStartSystemMessage(coordRoot, instanceId, sessionId, emittedData, harness) {
+async function emitSessionStartSystemMessage(coordRoot, instanceId, sessionId, emittedData, harness, recoveryBriefing = "") {
     const agentCoordBin = join(coordRoot, "harnery", "bin", "agent-coord");
-    if (!existsSync(agentCoordBin))
-        return;
-    // Sync-project so the heartbeat exists for downstream readers (peer table,
-    // wiring check, council invites).
-    spawnSync(agentCoordBin, ["project"], { encoding: "utf8", timeout: 3000 });
-    // Stale-sweep dead peers before rendering peer table.
-    spawnSync(agentCoordBin, ["stale-sweep"], { encoding: "utf8", timeout: 3000 });
-    // SESSION_START activity log line, fired across all harnesses.
-    const model = emittedData.model ?? "unknown";
-    const source = emittedData.source ?? "startup";
-    const platform = harnessPlatform(harness);
-    spawnSync(agentCoordBin, [
-        "log",
-        `SESSION_START   model=${model} source=${source} platform=${platform}`,
-        "--instance",
-        instanceId,
-    ], { encoding: "utf8", timeout: 2000 });
-    // Render the systemMessage via agent-coord.
-    const agentName = emittedData.name ?? "";
-    const args = ["session-context", "--instance", instanceId, "--session", sessionId];
-    if (agentName)
-        args.push("--name", agentName);
-    // The "You are agent-X." prefix in session-context renders unqualified by
-    // default (claude-code-style). For cursor/codex the bash dispatchers add
-    // a "(Cursor)" / "(Codex)" suffix; pass it through as --platform-label.
-    if (harness !== "claude-code") {
-        args.push("--platform-label", platform === "cursor" ? "Cursor" : "Codex");
+    let additionalContext = "";
+    if (existsSync(agentCoordBin)) {
+        // Sync-project so the heartbeat exists for downstream readers (peer table,
+        // wiring check, council invites).
+        spawnSync(agentCoordBin, ["project"], { encoding: "utf8", timeout: 3000 });
+        // Stale-sweep dead peers before rendering peer table.
+        spawnSync(agentCoordBin, ["stale-sweep"], { encoding: "utf8", timeout: 3000 });
+        // SESSION_START activity log line, fired across all harnesses.
+        const model = emittedData.model ?? "unknown";
+        const source = emittedData.source ?? "startup";
+        const platform = harnessPlatform(harness);
+        spawnSync(agentCoordBin, [
+            "log",
+            `SESSION_START   model=${model} source=${source} platform=${platform}`,
+            "--instance",
+            instanceId,
+        ], { encoding: "utf8", timeout: 2000 });
+        // Render the systemMessage via agent-coord.
+        const agentName = emittedData.name ?? "";
+        const args = ["session-context", "--instance", instanceId, "--session", sessionId];
+        if (agentName)
+            args.push("--name", agentName);
+        // The "You are agent-X." prefix in session-context renders unqualified by
+        // default (claude-code-style). For cursor/codex the bash dispatchers add
+        // a "(Cursor)" / "(Codex)" suffix; pass it through as --platform-label.
+        if (harness !== "claude-code") {
+            args.push("--platform-label", platform === "cursor" ? "Cursor" : "Codex");
+        }
+        const result = spawnSync(agentCoordBin, args, { encoding: "utf8", timeout: 3000 });
+        if (result.status === 0 && result.stdout)
+            additionalContext = result.stdout.trim();
     }
-    const result = spawnSync(agentCoordBin, args, { encoding: "utf8", timeout: 3000 });
-    if (result.status !== 0 || !result.stdout)
-        return;
-    let additionalContext = result.stdout.trim();
-    if (!additionalContext)
-        return;
     // Effect (claude-code): merge the scratch recovery cue into the session-start
     // context. Was a standalone additionalContext emission from the previous
     // scratch-on-start adapter; now that agent-hook is the single SessionStart
@@ -1106,10 +1329,30 @@ async function emitSessionStartSystemMessage(coordRoot, instanceId, sessionId, e
     if (harness === "claude-code") {
         const cue = scratchRecoveryCue(coordRoot);
         if (cue)
-            additionalContext = `${additionalContext}\n\n${cue}`;
+            additionalContext = [additionalContext, cue].filter(Boolean).join("\n\n");
+    }
+    if (recoveryBriefing) {
+        additionalContext = [additionalContext, recoveryBriefing].filter(Boolean).join("\n\n");
     }
+    if (!additionalContext)
+        return false;
     const { emitContext } = await import("./harness/output.js");
     emitContext(harness, "SessionStart", additionalContext);
+    return true;
+}
+function completeRecoveryInjection(coordRoot, instanceId, sessionId, harness, recovery, injectionEvent) {
+    completeContextRecovery(coordRoot, { sessionId, instanceId });
+    emit(coordRoot, {
+        event_type: "context.recovery.injected",
+        instance_id: instanceId,
+        session_id: sessionId,
+        harness,
+        data: {
+            capsule_id: recovery.capsule.capsule_id,
+            generation: recovery.capsule.generation,
+            injection_event: injectionEvent,
+        },
+    });
 }
 main()
     .then((code) => process.exit(code))

package/dist/core/hooks/events/schema.d.ts

@@ -37,6 +37,10 @@ export type SessionStart = EventEnvelope<"session.start", {
     cwd: string;
     model?: string;
     pid: number;
+    /** Present iff this session is a `workflow run` child: the run id whose
+     * journal owns it (child env HARNERY_WORKFLOW_RUN_ID). Optional-field
+     * addition per the schema evolution rules (minor bump). */
+    workflow_run_id?: string;
 }>;
 export type SessionEnd = EventEnvelope<"session.end", {
     ended_at: string;
@@ -120,6 +124,35 @@ export type ImageCaptured = EventEnvelope<"image.captured", {
     intent?: string;
     command_head?: string;
 }>;
+export type ContextSampled = EventEnvelope<"context.sampled", {
+    model?: string;
+    used_tokens?: number;
+    window_tokens?: number;
+    used_percent?: number;
+    telemetry_source: "hook" | "native_event" | "result" | "transcript" | "estimate";
+    confidence: "exact" | "reported" | "estimated";
+}>;
+export type ContextCheckpointCreated = EventEnvelope<"context.checkpoint.created", {
+    capsule_id: string;
+    generation: number;
+    path: string;
+    reason: "manual" | "pressure" | "pre_compact" | "session_end";
+    reused: boolean;
+}>;
+export type ContextCompactionStarted = EventEnvelope<"context.compaction.started", {
+    trigger?: string;
+    pre_tokens?: number;
+}>;
+export type ContextCompactionCompleted = EventEnvelope<"context.compaction.completed", {
+    trigger?: string;
+    pre_tokens?: number;
+    post_tokens?: number;
+}>;
+export type ContextRecoveryInjected = EventEnvelope<"context.recovery.injected", {
+    capsule_id: string;
+    generation: number;
+    injection_event: "SessionStart" | "UserPromptSubmit";
+}>;
 export type ClaimAcquire = EventEnvelope<"claim.acquire", {
     path: string;
     mode: "read" | "write";
@@ -152,6 +185,14 @@ export type StatePresenceChange = EventEnvelope<"state.presence_change", {
     source: "hook" | "cli" | "user";
 }>;
 export type StateHeartbeat = EventEnvelope<"state.heartbeat", Record<string, never>>;
+/** A live session adopted a durable persona/role. The event is authoritative
+ * for replay; `.name-history` carries the same binding for heartbeat healing. */
+export type IdentityAssumed = EventEnvelope<"identity.assumed", {
+    name: string;
+    agent_id: string;
+    previous_name?: string;
+    previous_agent_id?: string;
+}>;
 export type CouncilOpen = EventEnvelope<"council.open", {
     council_id: string;
     topic: string;
@@ -220,7 +261,7 @@ export type HealthVerdictFailure = EventEnvelope<"health.verdict_failure", {
     timeout_ms?: number;
     fallback: "allow";
 }>;
-export type Event = SessionStart | SessionEnd | SubagentStart | SubagentStop | UserPromptSubmit | TurnStop | CommandStart | CommandOutput | CommandEnd | Narration | ToolPreUse | ToolPostUse | ToolPostUseFailure | ToolOutputChunk | ImageCaptured | ClaimAcquire | ClaimRelease | ClaimConflict | StateTaskSet | StateStatusChecked | StateScratchAppend | StatePresenceChange | StateHeartbeat | CouncilOpen | CouncilRoundOpen | CouncilContribution | CouncilRoundClose | CouncilClose | CouncilArchive | DecisionBlock | DecisionWarn | DecisionAllow | HealthHeartbeatHeal | HealthPidmapHeal | HealthHeartbeatSwept | HealthVerdictFailure;
+export type Event = SessionStart | SessionEnd | SubagentStart | SubagentStop | UserPromptSubmit | TurnStop | CommandStart | CommandOutput | CommandEnd | Narration | ToolPreUse | ToolPostUse | ToolPostUseFailure | ToolOutputChunk | ImageCaptured | ContextSampled | ContextCheckpointCreated | ContextCompactionStarted | ContextCompactionCompleted | ContextRecoveryInjected | ClaimAcquire | ClaimRelease | ClaimConflict | StateTaskSet | StateStatusChecked | StateScratchAppend | StatePresenceChange | StateHeartbeat | IdentityAssumed | CouncilOpen | CouncilRoundOpen | CouncilContribution | CouncilRoundClose | CouncilClose | CouncilArchive | DecisionBlock | DecisionWarn | DecisionAllow | HealthHeartbeatHeal | HealthPidmapHeal | HealthHeartbeatSwept | HealthVerdictFailure;
 export type EventType = Event["event_type"];
 /**
  * Redaction marker that may be attached to any `data` payload during emission.

package/dist/core/hooks/events/schema.d.ts.map

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

package/dist/core/hooks/harness/events.d.ts

@@ -36,6 +36,13 @@ export interface HarnessSpec {
     allowedTopLevelKeys?: string[];
     /** Strict hook event keys accepted by this harness, including events harnery does not wire. */
     allowedEventKeys?: string[];
+    /**
+     * Env var the harness exports to hook processes carrying the project root
+     * (e.g. Claude Code's CLAUDE_PROJECT_DIR). When set, `init` anchors the
+     * agent-hook path on it so the hook still spawns when the process cwd has
+     * wandered (the session shell `cd`ing into a subdirectory or off-repo).
+     */
+    projectDirEnv?: string;
 }
 /** Claude Code: `.claude/settings.json`. */
 export declare const CLAUDE_CODE_EVENTS: HookEvent[];

package/dist/core/hooks/harness/events.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/harness/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,SAAS;IACxB,6FAA6F;IAC7F,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,wDAAwD;IACxD,UAAU,EAAE,cAAc,CAAC;IAC3B,uFAAuF;IACvF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yFAAyF;IACzF,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;IAC3B,0FAA0F;IAC1F,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,+FAA+F;IAC/F,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,4CAA4C;AAC5C,eAAO,MAAM,kBAAkB,EAAE,SAAS,EAWzC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,EAWpC,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,YAAY,EAAE,SAAS,EAQnC,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,EAAE,SAAS,EAI1C,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,wBAAwB,UAWpC,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,SAAS,EAAE,WAAW,CAoBxD,CAAC"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/core/hooks/harness/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE3D,MAAM,WAAW,SAAS;IACxB,6FAA6F;IAC7F,WAAW,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEjD,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,wDAAwD;IACxD,UAAU,EAAE,cAAc,CAAC;IAC3B,uFAAuF;IACvF,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yFAAyF;IACzF,YAAY,CAAC,EAAE,SAAS,EAAE,CAAC;IAC3B,0FAA0F;IAC1F,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,+FAA+F;IAC/F,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,4CAA4C;AAC5C,eAAO,MAAM,kBAAkB,EAAE,SAAS,EAYzC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,EAWpC,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,YAAY,EAAE,SAAS,EAUnC,CAAC;AAEF,mFAAmF;AACnF,eAAO,MAAM,mBAAmB,EAAE,SAAS,EAI1C,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,wBAAwB,UAWpC,CAAC;AAEF,8DAA8D;AAC9D,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,SAAS,EAAE,WAAW,CAqBxD,CAAC"}