@zihanw/pi-forge 0.5.3 → 0.5.5

package/dist/index.js

@@ -1,3 +1,7 @@
+import { registerForgeCommand } from "./forge-command.js";
+import { createCapabilityRuntime } from "./runtime/capability-runtime.js";
+import { registerCapabilityCommand } from "./capability-command.js";
+import { registerCapabilityTool } from "./capability-tool.js";
 import { registerLifecycleHandlers } from "./lifecycle.js";
 import { registerPayloadCommands, registerPayloadRequestHandler, armPayloadIntercept, clearPayloadCapture, recordProviderResponseUsage, webPayloadSnapshot } from "./payload-command.js";
 import { buildPreview } from "./preview.js";
@@ -5,37 +9,65 @@ import { registerPresetCommand } from "./preset-command.js";
 import { registerProfileCommand } from "./profile-command.js";
 import { applyResolvedAgentProfile } from "./profile-service.js";
 import { formatResourceKey } from "./resource-identity.js";
+import { ForgeActiveStatePublisher } from "./active-state.js";
 import { createProfileRuntime } from "./runtime/profile-runtime.js";
 import { createPromptStackRuntime } from "./runtime/prompt-stack-runtime.js";
 import { ForgeWorkspace } from "./workspace.js";
 import { createToolPolicyRuntime } from "./runtime/tool-policy-runtime.js";
 import { createWebEditorRuntime } from "./runtime/web-editor-runtime.js";
 import { createCompileCycleState } from "./compile-cycle.js";
-import { getContextDiffView } from "./context-diff-history.js";
+import { getContextDiffView, getLatestContextDiffUsage } from "./context-diff-history.js";
 import { createPayloadState } from "./payload-state.js";
 /**
  * Intentional public surface (0.5.0): the default Pi extension factory plus
  * the trusted-extension API (`registerMacro`/`registerSlot` and their contract
- * types). Everything else is internal; the only other entry point is
- * `@zihanw/pi-forge/subagent`, the versioned host port.
+ * types). Other intentional entries are the /subagent and /ui-contribution ports
+ * and the local /command-contribution contract. Everything else is internal.
  */
 export { registerMacro, } from "./macro-engine.js";
 export { registerSlot, } from "./slot-renderers.js";
 export default function piForge(pi) {
     const workspace = new ForgeWorkspace();
+    const activeState = new ForgeActiveStatePublisher({
+        transport: pi.events,
+        readWorkspace: () => {
+            if (!workspace.snapshotKnown)
+                return { stackKey: null };
+            const snapshot = workspace.snapshot();
+            return {
+                stackKey: snapshot.active ? formatResourceKey(snapshot.active.key) : null,
+                profile: snapshot.lastAppliedProfile
+                    ? {
+                        profileId: snapshot.lastAppliedProfile.profileId,
+                        scope: snapshot.lastAppliedProfile.scope,
+                        promptStack: snapshot.lastAppliedProfile.snapshot.promptStack,
+                    }
+                    : undefined,
+            };
+        },
+    });
+    // Optional observer: publishes on reload, active-stack/profile changes, and
+    // web-editor mutations without any provider/model/tool-policy side effect.
+    workspace.subscribe(() => activeState.publish());
     const compileCycle = createCompileCycleState();
     const payloadState = createPayloadState();
     const currentActive = () => workspace.snapshotKnown ? workspace.snapshot().active : undefined;
     const toolPolicy = createToolPolicyRuntime(pi, () => currentActive());
+    const instructions = createCapabilityRuntime(pi, workspace, toolPolicy);
     let profileRuntime;
     const stackRuntime = createPromptStackRuntime(pi, workspace, compileCycle, {
-        syncToolPolicy: toolPolicy.sync,
+        syncToolPolicy: instructions.sync,
     });
     profileRuntime = createProfileRuntime(pi, workspace, {
         setActive: (id, ctx) => stackRuntime.setActive(id, ctx),
         updateStatus: stackRuntime.updateStatus,
     });
     const webEditorRuntime = createWebEditorRuntime((ctx, promptOptions) => ({
+        readCapabilities: () => workspace.reloadCapabilities(ctx.cwd, ctx.isProjectTrusted()).capabilities,
+        readCapabilityState: () => instructions.readState(),
+        readCapabilityChoices: () => instructions.readAvailableCapabilities(),
+        mutateCapabilityState: (input) => instructions.mutateState(input),
+        enableCapability: (input) => instructions.enableCapability(input),
         getStacks: () => [...workspace.snapshot().stacks],
         getActive: () => currentActive(),
         getActiveId: stackRuntime.activeId,
@@ -77,7 +109,18 @@ export default function piForge(pi) {
         activateFreshSessionDefaults: profileRuntime.activateFreshSessionDefaults,
         refreshWebEditorHost: webEditorRuntime.refreshHost,
         notifyActivePreset: stackRuntime.notifyActivePreset,
-        syncActiveToolPolicy: toolPolicy.sync,
+        syncActiveToolPolicy: instructions.sync,
+        disposeCapabilities: instructions.dispose,
+        prepareCapabilityRestore: instructions.prepareRestore,
+        restoreCapabilities: instructions.restore,
+        projectCapabilities: instructions.project,
+        prepareCapabilityMessages: instructions.prepareMessages,
+        commitEndCapabilityAnchors: instructions.commitEndAnchors,
+        setCapabilityAgentBusy: instructions.setAgentBusy,
+        toolPromptOptions: (options) => {
+            const active = currentActive();
+            return active ? toolPolicy.previewOptions({ ...options, selectedTools: pi.getActiveTools() }, active.stack) : options;
+        },
         restoreActiveToolPolicy: toolPolicy.restore,
         toolPolicyBlockReason: toolPolicy.blockReason,
         persistActiveSelection: stackRuntime.persistActiveSelection,
@@ -87,22 +130,30 @@ export default function piForge(pi) {
             workspace.startHostPort(pi.events);
         },
         disposeForgeWorkspace: () => workspace.dispose(),
+        suspendActiveState: () => activeState.suspend(),
+        bindActiveState: (ctx) => activeState.bindSession({ sessionId: ctx.sessionManager.getSessionId(), cwd: ctx.cwd }),
+        disposeActiveState: () => activeState.dispose(),
         recordProviderResponseUsage: (message) => recordProviderResponseUsage(payloadState, message),
     });
     registerPayloadRequestHandler(pi, payloadState, () => currentActive());
-    registerPayloadCommands(pi, payloadState);
+    registerCapabilityCommand(pi, instructions);
+    registerCapabilityTool(pi, instructions);
+    const payloadCommand = registerPayloadCommands(pi, payloadState);
+    registerForgeCommand(pi, { openWebEditor: webEditorRuntime.open, stopWebEditor: webEditorRuntime.stop }, payloadCommand);
     registerPresetCommand(pi, workspace, compileCycle, {
         selectedActiveId: stackRuntime.selectedActiveId,
         setActive: stackRuntime.setActive,
         reloadStacks: stackRuntime.reloadStacks,
         openWebEditor: webEditorRuntime.open,
         stopWebEditor: webEditorRuntime.stop,
+        latestContextDiffUsage: () => getLatestContextDiffUsage(payloadState.contextDiffHistory),
     });
-    registerProfileCommand(pi, workspace, {
+    registerProfileCommand(pi, workspace, compileCycle, {
         reloadProfiles: profileRuntime.reloadProfiles,
         resolveProfile: profileRuntime.resolveProfile,
         setActive: stackRuntime.setActive,
         previewToolNames: toolPolicy.previewToolNames,
+        latestContextDiffUsage: () => getLatestContextDiffUsage(payloadState.contextDiffHistory),
     });
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/json-fingerprint.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Forge canonical JSON fingerprints shared by instruction snapshots and the
+ * existing subagent wire adapter. The algorithm is unchanged: sorted plain
+ * objects, finite numbers, no cycles or sparse arrays. This is content identity,
+ * not an authentication signature.
+ */
+export declare const JSON_FINGERPRINT_PREFIX: "sha256:v1:";
+export type JsonFingerprint = `${typeof JSON_FINGERPRINT_PREFIX}${string}`;
+export declare function canonicalJson(value: unknown): string;
+export declare function fingerprintJson(value: unknown): JsonFingerprint;
+//# sourceMappingURL=json-fingerprint.d.ts.map

package/dist/json-fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-fingerprint.d.ts","sourceRoot":"","sources":["../src/json-fingerprint.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,EAAG,YAAqB,CAAC;AAC7D,MAAM,MAAM,eAAe,GAAG,GAAG,OAAO,uBAAuB,GAAG,MAAM,EAAE,CAAC;AAE3E,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEpD;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAK/D"}

package/dist/json-fingerprint.js

@@ -0,0 +1,66 @@
+import { createHash } from "node:crypto";
+/**
+ * Forge canonical JSON fingerprints shared by instruction snapshots and the
+ * existing subagent wire adapter. The algorithm is unchanged: sorted plain
+ * objects, finite numbers, no cycles or sparse arrays. This is content identity,
+ * not an authentication signature.
+ */
+export const JSON_FINGERPRINT_PREFIX = "sha256:v1:";
+export function canonicalJson(value) {
+    return canonicalize(value, "$", new Set());
+}
+export function fingerprintJson(value) {
+    const digest = createHash("sha256")
+        .update(canonicalJson(value))
+        .digest("hex");
+    return `${JSON_FINGERPRINT_PREFIX}${digest}`;
+}
+function canonicalize(value, path, ancestors) {
+    if (value === null)
+        return "null";
+    if (typeof value === "string" || typeof value === "boolean") {
+        return JSON.stringify(value);
+    }
+    if (typeof value === "number") {
+        if (!Number.isFinite(value)) {
+            throw new TypeError(`Cannot fingerprint non-finite number at ${path}.`);
+        }
+        return JSON.stringify(Object.is(value, -0) ? 0 : value);
+    }
+    if (typeof value !== "object" || value === undefined) {
+        throw new TypeError(`Cannot fingerprint ${typeof value} at ${path}.`);
+    }
+    if (ancestors.has(value)) {
+        throw new TypeError(`Cannot fingerprint cyclic value at ${path}.`);
+    }
+    ancestors.add(value);
+    try {
+        if (Array.isArray(value)) {
+            const items = [];
+            for (let index = 0; index < value.length; index += 1) {
+                if (!Object.hasOwn(value, index)) {
+                    throw new TypeError(`Cannot fingerprint sparse array item at ${path}[${index}].`);
+                }
+                items.push(canonicalize(value[index], `${path}[${index}]`, ancestors));
+            }
+            return `[${items.join(",")}]`;
+        }
+        const prototype = Object.getPrototypeOf(value);
+        if (prototype !== Object.prototype && prototype !== null) {
+            throw new TypeError(`Cannot fingerprint non-plain object at ${path}.`);
+        }
+        const record = value;
+        const keys = Object.keys(record)
+            .filter((key) => record[key] !== undefined)
+            .sort();
+        const properties = keys.map((key) => {
+            const property = canonicalize(record[key], `${path}.${key}`, ancestors);
+            return `${JSON.stringify(key)}:${property}`;
+        });
+        return `{${properties.join(",")}}`;
+    }
+    finally {
+        ancestors.delete(value);
+    }
+}
+//# sourceMappingURL=json-fingerprint.js.map

package/dist/json-fingerprint.js.map

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

package/dist/lifecycle.d.ts

@@ -1,4 +1,5 @@
 import type { BuildSystemPromptOptions, ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
+import type { AgentMessage } from "@earendil-works/pi-agent-core";
 import type { AssistantMessage } from "@earendil-works/pi-ai";
 import { type CompileCycleState } from "./compile-cycle.ts";
 import type { ForgeWorkspace } from "./workspace.ts";
@@ -20,7 +21,20 @@ export interface LifecycleDeps {
     restorePersistedActiveId(id?: string): void;
     reloadForgeWorkspace(ctx: ExtensionContext): void;
     disposeForgeWorkspace(): void;
+    suspendActiveState(): void;
+    bindActiveState(ctx: ExtensionContext): void;
+    disposeActiveState(): void;
     recordProviderResponseUsage(message: AssistantMessage): void;
+    disposeCapabilities?(): void;
+    prepareCapabilityRestore?(ctx: ExtensionContext): void;
+    restoreCapabilities?(ctx: ExtensionContext, options?: {
+        deferToolPolicy?: boolean;
+    }): void;
+    projectCapabilities?(messages: AgentMessage[], ctx: ExtensionContext): AgentMessage[];
+    prepareCapabilityMessages?(raw: AgentMessage[], ctx: ExtensionContext): AgentMessage[];
+    commitEndCapabilityAnchors?(ctx: ExtensionContext): void;
+    setCapabilityAgentBusy?(busy: boolean): void;
+    toolPromptOptions?(options: BuildSystemPromptOptions): BuildSystemPromptOptions;
 }
 export declare function registerLifecycleHandlers(pi: ExtensionAPI, workspace: ForgeWorkspace, compileCycle: CompileCycleState, deps: LifecycleDeps): void;
 //# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,YAAY,EAAE,gBAAgB,EAAqB,MAAM,iCAAiC,CAAC;AACnI,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAQ9D,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,aAAa;IAC7B,YAAY,CAAC,GAAG,EAAE,gBAAgB,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAC;QAAC,oBAAoB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClJ,yBAAyB,IAAI,qBAAqB,EAAE,CAAC;IACrD,4BAA4B,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,oBAAoB,CAAC,GAAG,EAAE,gBAAgB,EAAE,aAAa,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAC5F,kBAAkB,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAChE,oBAAoB,CAAC,GAAG,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACnD,uBAAuB,IAAI,IAAI,CAAC;IAChC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC5D,sBAAsB,IAAI,IAAI,CAAC;IAC/B,wBAAwB,CAAC,GAAG,EAAE,gBAAgB,EAAE,WAAW,EAAE,qBAAqB,EAAE,GAAG,IAAI,CAAC;IAC5F,wBAAwB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,oBAAoB,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClD,qBAAqB,IAAI,IAAI,CAAC;IAC9B,2BAA2B,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;CAC7D;AAED,wBAAgB,yBAAyB,CACxC,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,cAAc,EACzB,YAAY,EAAE,iBAAiB,EAC/B,IAAI,EAAE,aAAa,GACjB,IAAI,CAoIN"}
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,YAAY,EAAE,gBAAgB,EAAqB,MAAM,iCAAiC,CAAC;AACnI,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAElE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAQ9D,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE/E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,WAAW,aAAa;IAC7B,YAAY,CAAC,GAAG,EAAE,gBAAgB,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAC;QAAC,oBAAoB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClJ,yBAAyB,IAAI,qBAAqB,EAAE,CAAC;IACrD,4BAA4B,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,oBAAoB,CAAC,GAAG,EAAE,gBAAgB,EAAE,aAAa,CAAC,EAAE,wBAAwB,GAAG,IAAI,CAAC;IAC5F,kBAAkB,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAChE,oBAAoB,CAAC,GAAG,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACnD,uBAAuB,IAAI,IAAI,CAAC;IAChC,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC5D,sBAAsB,IAAI,IAAI,CAAC;IAC/B,wBAAwB,CAAC,GAAG,EAAE,gBAAgB,EAAE,WAAW,EAAE,qBAAqB,EAAE,GAAG,IAAI,CAAC;IAC5F,wBAAwB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5C,oBAAoB,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAClD,qBAAqB,IAAI,IAAI,CAAC;IAC9B,kBAAkB,IAAI,IAAI,CAAC;IAC3B,eAAe,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC7C,kBAAkB,IAAI,IAAI,CAAC;IAC3B,2BAA2B,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC7D,mBAAmB,CAAC,IAAI,IAAI,CAAC;IAC7B,wBAAwB,CAAC,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACvD,mBAAmB,CAAC,CAAC,GAAG,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3F,mBAAmB,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAAC;IACtF,yBAAyB,CAAC,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE,GAAG,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAAC;IACvF,0BAA0B,CAAC,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACzD,sBAAsB,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC7C,iBAAiB,CAAC,CAAC,OAAO,EAAE,wBAAwB,GAAG,wBAAwB,CAAC;CAChF;AAED,wBAAgB,yBAAyB,CACxC,EAAE,EAAE,YAAY,EAChB,SAAS,EAAE,cAAc,EACzB,YAAY,EAAE,iBAAiB,EAC/B,IAAI,EAAE,aAAa,GACjB,IAAI,CAgNN"}

package/dist/lifecycle.js

@@ -1,37 +1,74 @@
-import { compileMessages, getLatestUserMessage, } from "./compiler.js";
-import { PromptCompilationContext } from "./compiler.js";
+import { getPiBasePrompt, projectPresetSystemPrompt } from "./capability-projection.js";
+import { getLatestUserMessage, } from "./compiler.js";
+import { PromptCompilationContext, dedupeDiagnostics } from "./compiler.js";
 import { applyFinalizeRegexRulesToMessage, applyRequestFrequencyRulesToMessages, hasRequestFrequencyRules } from "./regex.js";
 import { promptRuntimeFromPi } from "./prompt-runtime.js";
+import { formatResourceKey } from "./resource-identity.js";
 import { resetCompileCycle } from "./compile-cycle.js";
 import { getCurrentBranchEntries, getLegacyVariableStateDiagnostic, getRestoredActiveId, getRestoredProfileProvenance } from "./session-adapter.js";
 export function registerLifecycleHandlers(pi, workspace, compileCycle, deps) {
     let startupToolPolicyPending = false;
+    let runFailed = false;
     pi.on("session_shutdown", async () => {
-        // Pi carries the old runtime's active built-in tool names into a replacement
-        // runtime. Restore the pre-policy set before reload/session replacement so the
-        // replacement pi-forge instance can capture a complete baseline.
+        runFailed = false;
+        deps.setCapabilityAgentBusy?.(false);
+        // Publish a final cleared active-state snapshot before teardown so optional
+        // consumers do not retain appearance context from the retiring session.
+        // Active-state is optional, so a throwing transport/listener must never
+        // block tool-policy restoration or workspace teardown.
+        disposeActiveStateSafely(deps);
         startupToolPolicyPending = false;
-        deps.restoreActiveToolPolicy();
-        // Tear down the host first so a throwing subagent disposal cannot leak a
-        // live host that keeps advertising the stale snapshot.
-        deps.disposeForgeWorkspace();
-        deps.disposePromptStackRuntime();
+        // Every teardown step runs even if a preceding one throws (for example
+        // when an optional bus transport rejects emit/unsubscribe). The first
+        // failure is rethrown only after all cleanup has been attempted.
+        let firstError;
+        for (const step of [
+            // A shared editor may outlive this runtime; stale hosts must stop accepting controls.
+            () => deps.disposeCapabilities?.(),
+            // Pi carries the old runtime's active built-in tool names into a
+            // replacement runtime. Restore the pre-policy set before reload/session
+            // replacement so the replacement can capture a complete baseline.
+            () => deps.restoreActiveToolPolicy(),
+            // Tear down the host first so a throwing subagent disposal cannot leak
+            // a live host that keeps advertising the stale snapshot.
+            () => deps.disposeForgeWorkspace(),
+            () => deps.disposePromptStackRuntime(),
+        ]) {
+            try {
+                step();
+            }
+            catch (error) {
+                firstError ??= error;
+            }
+        }
+        if (firstError !== undefined)
+            throw firstError;
     });
     pi.on("session_start", async (event, ctx) => {
+        runFailed = false;
+        deps.setCapabilityAgentBusy?.(false);
         startupToolPolicyPending = true;
+        // Suspend before any workspace reload so intermediate snapshots cannot be
+        // published under the still-bound old session id.
+        deps.suspendActiveState();
         try {
             const freshSession = shouldAutoActivateForSessionStart(event, ctx);
             await restoreBranchScopedRuntime(ctx, workspace, compileCycle, deps, { deferToolPolicy: true, suppressAutoActivate: freshSession });
             if (freshSession)
                 await deps.activateFreshSessionDefaults(ctx);
+            deps.reloadForgeWorkspace(ctx);
+            deps.refreshWebEditorHost(ctx);
+            deps.notifyActivePreset(ctx, "after session " + event.reason);
+            // Resume and bind only once the restored workspace is complete.
+            deps.bindActiveState(ctx);
         }
         catch (error) {
             startupToolPolicyPending = false;
+            // A failed restore leaves the old binding stale; detach/clear instead
+            // of publishing it under a foreign workspace.
+            disposeActiveStateSafely(deps);
             throw error;
         }
-        deps.reloadForgeWorkspace(ctx);
-        deps.refreshWebEditorHost(ctx);
-        deps.notifyActivePreset(ctx, "after session " + event.reason);
     });
     pi.on("resources_discover", async (_event, ctx) => {
         if (!startupToolPolicyPending)
@@ -40,73 +77,115 @@ export function registerLifecycleHandlers(pi, workspace, compileCycle, deps) {
         deps.syncActiveToolPolicy(ctx);
     });
     pi.on("session_tree", async (_event, ctx) => {
-        await restoreBranchScopedRuntime(ctx, workspace, compileCycle, deps);
-        deps.reloadForgeWorkspace(ctx);
-        deps.refreshWebEditorHost(ctx);
-        deps.notifyActivePreset(ctx, "after tree navigation");
+        runFailed = false;
+        deps.setCapabilityAgentBusy?.(false);
+        deps.suspendActiveState();
+        try {
+            await restoreBranchScopedRuntime(ctx, workspace, compileCycle, deps);
+            deps.reloadForgeWorkspace(ctx);
+            deps.refreshWebEditorHost(ctx);
+            deps.notifyActivePreset(ctx, "after tree navigation");
+            deps.bindActiveState(ctx);
+        }
+        catch (error) {
+            disposeActiveStateSafely(deps);
+            throw error;
+        }
     });
     pi.on("session_compact", async (_event, ctx) => {
-        await restoreBranchScopedRuntime(ctx, workspace, compileCycle, deps);
-        deps.reloadForgeWorkspace(ctx);
-        deps.refreshWebEditorHost(ctx);
-        deps.notifyActivePreset(ctx, "after compaction");
+        runFailed = false;
+        deps.setCapabilityAgentBusy?.(false);
+        deps.suspendActiveState();
+        try {
+            await restoreBranchScopedRuntime(ctx, workspace, compileCycle, deps);
+            deps.reloadForgeWorkspace(ctx);
+            deps.refreshWebEditorHost(ctx);
+            deps.notifyActivePreset(ctx, "after compaction");
+            // Same session: bindSession keeps the live instance and revision
+            // epoch, so compaction does not clear/recreate cosmetic state.
+            deps.bindActiveState(ctx);
+        }
+        catch (error) {
+            disposeActiveStateSafely(deps);
+            throw error;
+        }
     });
-    pi.on("turn_start", async () => {
-        deps.syncActiveToolPolicy();
+    pi.on("turn_start", async (_event, ctx) => {
+        deps.syncActiveToolPolicy(ctx);
         deps.persistActiveSelection();
     });
-    pi.on("input", async () => {
-        deps.syncActiveToolPolicy();
+    pi.on("input", async (_event, ctx) => {
+        deps.syncActiveToolPolicy(ctx);
     });
     pi.on("tool_call", async (event) => {
         const reason = deps.toolPolicyBlockReason(event.toolName);
         return reason ? { block: true, reason } : undefined;
     });
     pi.on("before_agent_start", async (event, ctx) => {
+        runFailed = false;
+        deps.setCapabilityAgentBusy?.(true);
         compileCycle.currentSystemPromptOptions = event.systemPromptOptions;
         deps.refreshWebEditorHost(ctx, event.systemPromptOptions);
         compileCycle.currentLatestUserMessage = event.prompt;
         compileCycle.contextRewritePending = true;
-        const active = workspace.snapshotKnown ? workspace.snapshot().active : undefined;
-        if (!active)
-            return;
-        const compilationRuntime = promptRuntimeFromPi(event.systemPromptOptions, ctx, event.prompt);
-        compileCycle.currentCompilationContext = new PromptCompilationContext(active.stack, compilationRuntime);
-        const result = compileCycle.currentCompilationContext.compileSystemPrompt(event.systemPrompt);
-        deps.recordCompileDiagnostics(ctx, result.diagnostics);
-        return { systemPrompt: result.systemPrompt };
+        compileCycle.currentBaseSystemPrompt = event.systemPrompt;
+        compileCycle.currentCompiledSystemPrompt = undefined;
+        compileCycle.currentCompiledStackKey = undefined;
+        compileCycle.currentPromptInputKey = undefined;
+        compileCycle.currentCompilationContext = undefined;
+        compileCycle.currentCompilationRuntime = promptRuntimeFromPi(event.systemPromptOptions, ctx, event.prompt);
+        // Never return a forced full systemPrompt: Pi reapplies it AFTER context hooks,
+        // which would silently suppress native instruction sections on tool follow-ups.
     });
-    pi.on("context", async (event, ctx) => {
-        const active = workspace.snapshotKnown ? workspace.snapshot().active : undefined;
-        if (!active || !compileCycle.currentSystemPromptOptions)
-            return;
-        if (!compileCycle.contextRewritePending) {
-            // Tool-result follow-up requests receive Pi's natural context. Outgoing
-            // rules that opt into every-request application (frequency: "request")
-            // still run over the full natural context — this is the only regex
-            // pipeline entry on follow-ups, and it is wire-consistent because each
-            // request is rebuilt from the transcript rather than from the first
-            // request's rewritten output.
-            if (!hasRequestFrequencyRules(active.stack))
-                return;
-            const diagnostics = [];
-            const messages = applyRequestFrequencyRulesToMessages(active.stack, event.messages, diagnostics);
-            if (diagnostics.length > 0)
-                deps.recordCompileDiagnostics(ctx, diagnostics);
+    // Pi 0.87 ordinary context hooks intentionally exclude System messages.
+    // Keep the complete Forge pipeline together at the full-transcript boundary.
+    pi.on("context_with_system", async (event, ctx) => {
+        try {
+            deps.syncActiveToolPolicy(ctx);
+            let messages = event.messages;
+            messages = deps.prepareCapabilityMessages?.(messages, ctx) ?? messages;
+            const active = workspace.snapshotKnown ? workspace.snapshot().active : undefined;
+            if (active && compileCycle.currentSystemPromptOptions) {
+                const options = deps.toolPromptOptions?.(compileCycle.currentSystemPromptOptions) ?? compileCycle.currentSystemPromptOptions;
+                const runtime = promptRuntimeFromPi(options, ctx, compileCycle.currentLatestUserMessage, compileCycle.currentCompilationRuntime?.now);
+                const basePrompt = getPiBasePrompt(event.messages, compileCycle.currentBaseSystemPrompt ?? "");
+                const key = JSON.stringify([active.stack, runtime.options, runtime.model, basePrompt]);
+                if (!compileCycle.currentCompilationContext || compileCycle.currentPromptInputKey !== key) {
+                    compileCycle.currentCompilationRuntime = runtime;
+                    compileCycle.currentCompilationContext = new PromptCompilationContext(active.stack, runtime);
+                    const result = compileCycle.currentCompilationContext.compileSystemPrompt(basePrompt);
+                    compileCycle.currentBaseSystemPrompt = basePrompt;
+                    compileCycle.currentCompiledSystemPrompt = result.systemPrompt;
+                    compileCycle.currentCompiledStackKey = formatResourceKey(active.key);
+                    compileCycle.currentPromptInputKey = key;
+                    deps.recordCompileDiagnostics(ctx, result.diagnostics);
+                }
+                if (compileCycle.contextRewritePending) {
+                    compileCycle.contextRewritePending = false;
+                    const latest = getLatestUserMessage(messages) ?? compileCycle.currentLatestUserMessage;
+                    compileCycle.currentCompilationContext.setLatestUserMessage(latest ?? "");
+                    const result = compileCycle.currentCompilationContext.compileMessages(messages);
+                    messages = result.messages;
+                    deps.recordCompileDiagnostics(ctx, dedupeDiagnostics([compileCycle.latestCompileDiagnostics, result.diagnostics]));
+                }
+                else if (hasRequestFrequencyRules(active.stack)) {
+                    const diagnostics = [];
+                    messages = applyRequestFrequencyRulesToMessages(active.stack, messages, diagnostics);
+                    if (diagnostics.length)
+                        deps.recordCompileDiagnostics(ctx, diagnostics);
+                }
+                messages = projectPresetSystemPrompt(messages, compileCycle.currentCompiledSystemPrompt ?? "");
+            }
+            messages = deps.projectCapabilities?.(messages, ctx) ?? messages;
             return messages === event.messages ? undefined : { messages };
         }
-        // Rewrite the message layout only for the first provider request of a user-submitted prompt.
-        // Tool-result follow-up turns must receive Pi's natural context; otherwise post-history
-        // prompt blocks such as COT / {{lastUserMessage}} are re-appended after every tool call
-        // and the model restarts its planning instead of continuing from the tool result.
-        compileCycle.contextRewritePending = false;
-        const latestUserMessage = getLatestUserMessage(event.messages) ?? compileCycle.currentLatestUserMessage;
-        compileCycle.currentCompilationContext?.setLatestUserMessage(latestUserMessage ?? "");
-        const result = compileCycle.currentCompilationContext
-            ? compileCycle.currentCompilationContext.compileMessages(event.messages)
-            : compileMessages(active.stack, promptRuntimeFromPi(compileCycle.currentSystemPromptOptions, ctx, latestUserMessage), event.messages);
-        deps.recordCompileDiagnostics(ctx, [...compileCycle.latestCompileDiagnostics, ...result.diagnostics]);
-        return { messages: result.messages };
+        catch (error) {
+            // Pi logs hook exceptions and may otherwise dispatch the unmodified context.
+            // Abort explicitly so malformed state never yields text/tool half-application.
+            runFailed = true;
+            ctx.abort();
+            throw error;
+        }
     });
     pi.on("message_end", async (event, ctx) => {
         if (event.message.role === "assistant")
@@ -117,23 +196,53 @@ export function registerLifecycleHandlers(pi, workspace, compileCycle, deps) {
         const diagnostics = [];
         const message = applyFinalizeRegexRulesToMessage(active.stack, event.message, diagnostics);
         if (diagnostics.length > 0)
-            deps.recordCompileDiagnostics(ctx, [...compileCycle.latestCompileDiagnostics, ...diagnostics]);
+            deps.recordCompileDiagnostics(ctx, dedupeDiagnostics([compileCycle.latestCompileDiagnostics, diagnostics]));
         if (!message)
             return;
         return { message };
     });
-    pi.on("agent_end", async () => {
-        resetCompileCycle(compileCycle);
+    pi.on("agent_end", async (_event, ctx) => {
+        // This is a safe low-level boundary, not the end of Pi's outer run.
+        // agent_before_settle may still request a continuation without another
+        // before_agent_start. Keep the compiled preset inputs until final settlement.
+        if (!runFailed && ctx)
+            deps.commitEndCapabilityAnchors?.(ctx);
     });
+    pi.on("agent_settled", async (_event, ctx) => {
+        try {
+            deps.setCapabilityAgentBusy?.(false);
+            if (!runFailed && ctx)
+                deps.commitEndCapabilityAnchors?.(ctx);
+        }
+        finally {
+            resetCompileCycle(compileCycle);
+        }
+    });
+}
+function disposeActiveStateSafely(deps) {
+    try {
+        deps.disposeActiveState();
+    }
+    catch {
+        // Optional active-state observers must never block lifecycle cleanup.
+    }
 }
 async function restoreBranchScopedRuntime(ctx, workspace, compileCycle, deps, options) {
+    deps.setCapabilityAgentBusy?.(false);
+    deps.prepareCapabilityRestore?.(ctx);
     const restoredProfile = getRestoredProfileProvenance(ctx);
     compileCycle.currentCompilationContext = undefined;
+    compileCycle.currentCompilationRuntime = undefined;
+    compileCycle.currentBaseSystemPrompt = undefined;
+    compileCycle.currentCompiledSystemPrompt = undefined;
+    compileCycle.currentCompiledStackKey = undefined;
+    compileCycle.currentPromptInputKey = undefined;
     compileCycle.latestCompileDiagnostics = getLegacyVariableStateDiagnostic(ctx);
     const restoredActiveId = getRestoredActiveId(ctx);
     deps.restorePersistedActiveId(restoredActiveId);
-    await deps.reloadStacks(ctx, restoredActiveId, options);
+    await deps.reloadStacks(ctx, restoredActiveId, { ...options, deferToolPolicy: true });
     workspace.setLastAppliedProfile(restoredProfile);
+    deps.restoreCapabilities?.(ctx, options);
 }
 function shouldAutoActivateForSessionStart(event, ctx) {
     if (event.reason === "new")