@nklisch/pi-enhanced 0.1.11 → 0.2.0

package/node_modules/@nklisch/pi-plugins/dist/runtime/mcp/mcp-runtime-binding-provider.js

@@ -0,0 +1,43 @@
+import { canonicalJson } from "../../domain/canonical-json.js";
+import { verifyMcpSourceRegistration } from "../../application/mcp-source-registration.js";
+import { McpRuntimeServerBindingSchemaV1 } from "../../application/ports/mcp-runtime.js";
+import { verifyProjectionExpectation } from "../../application/ports/runtime-projection.js";
+const inspectSymbol = Symbol.for("nodejs.util.inspect.custom");
+class McpRuntimeBindingError extends Error {
+    constructor() { super("MCP runtime binding is unavailable"); this.name = "McpRuntimeBindingError"; }
+}
+function same(left, right) { return canonicalJson(left) === canonicalJson(right); }
+function token() {
+    const value = Object.create(null);
+    Object.defineProperties(value, { toString: { value: () => "[REDACTED]" }, toJSON: { value: () => "[REDACTED]" }, [inspectSymbol]: { value: () => "[REDACTED]" } });
+    return Object.freeze(value);
+}
+/** Launch-time binding validation only; no durable artifact pinning is used. */
+export function createMcpRuntimeBindingProvider(input) {
+    if (input === null || typeof input !== "object" || input.active === undefined || typeof input.sha256 !== "function")
+        throw new TypeError("MCP runtime binding dependencies are required");
+    const registration = verifyMcpSourceRegistration(input.source, input.sha256);
+    const outstanding = new WeakSet();
+    async function acquire(bindingInput, signal) {
+        signal.throwIfAborted();
+        const binding = McpRuntimeServerBindingSchemaV1.parse(bindingInput);
+        const server = registration.source.servers[binding.serverKey];
+        if (server === undefined || !same(binding.source, registration.source.identity) || server.componentId !== binding.componentId || server.transport !== binding.transport)
+            throw new McpRuntimeBindingError();
+        let valid = false;
+        await input.active.withSelection(binding, signal, async (selection) => {
+            const expectation = verifyProjectionExpectation(selection.expectation, input.sha256);
+            valid = expectation.kind === "active" && same(expectation.projection.scope, binding.source.scope) && expectation.projection.plugin === binding.source.plugin && expectation.projection.revision === binding.source.revision && expectation.projection.digest === binding.source.projectionDigest && selection.currentProject?.trust.kind === "trusted";
+        });
+        if (!valid)
+            throw new McpRuntimeBindingError();
+        const value = token();
+        outstanding.add(value);
+        return value;
+    }
+    async function release(lease, signal) { signal.throwIfAborted(); if (!outstanding.has(lease))
+        throw new McpRuntimeBindingError(); }
+    async function drain(_signal) { }
+    return Object.freeze({ acquire, release, drain });
+}
+//# sourceMappingURL=mcp-runtime-binding-provider.js.map

package/node_modules/@nklisch/pi-plugins/dist/runtime/mcp/mcp-runtime-binding-provider.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/runtime/mcp/pi-mcp-adapter-package.d.ts

@@ -1,5 +1,16 @@
 import { type PublishedPackageReceipt } from "../published-package-receipt.js";
 import { type PiMcpRuntimeAdapter } from "./pi-mcp-adapter-runtime.js";
 export declare const PI_MCP_ADAPTER_RECEIPT: PublishedPackageReceipt;
+export type PiMcpRuntimeCandidateUnavailableCode = "PACKAGE_MISSING" | "PACKAGE_DRIFT" | "PACKAGE_IMPORT_FAILED";
+export type PiMcpRuntimeCandidate = Readonly<{
+    kind: "verified";
+    adapter: PiMcpRuntimeAdapter;
+}> | Readonly<{
+    kind: "unavailable";
+    code: PiMcpRuntimeCandidateUnavailableCode;
+    /** Fixed, user-safe explanation; native causes stay on the internal result. */
+    explanation: string;
+    cause?: unknown;
+}>;
 /** Verify exact local bytes before evaluating the documented programmatic export. */
-export declare function createVerifiedPiMcpRuntimeCandidate(signal?: AbortSignal): Promise<PiMcpRuntimeAdapter | undefined>;
+export declare function createVerifiedPiMcpRuntimeCandidate(signal?: AbortSignal): Promise<PiMcpRuntimeCandidate>;

package/node_modules/@nklisch/pi-plugins/dist/runtime/mcp/pi-mcp-adapter-package.js

@@ -2,7 +2,7 @@ import { probePublishedPackage, } from "../published-package-receipt.js";
 import { createPiMcpRuntime, } from "./pi-mcp-adapter-runtime.js";
 export const PI_MCP_ADAPTER_RECEIPT = Object.freeze({
     packageName: "@nklisch/pi-mcp-adapter",
-    version: "2.20.1-nklisch.1",
+    version: "2.21.0-nklisch.0",
     license: "MIT",
     nodeEngine: ">=22.19.0",
     piPeerRange: ">=0.82.0 <1",
@@ -15,6 +15,19 @@ function programmaticModule(value) {
         return undefined;
     return value;
 }
+function unavailable(code, explanation, cause) {
+    return Object.freeze({
+        kind: "unavailable",
+        code,
+        explanation,
+        ...(cause === undefined ? {} : { cause }),
+    });
+}
+function probeExplanation(code) {
+    return code === "PACKAGE_MISSING"
+        ? "The MCP adapter package is not installed."
+        : "The installed MCP adapter package does not match the required release.";
+}
 /** Verify exact local bytes before evaluating the documented programmatic export. */
 export async function createVerifiedPiMcpRuntimeCandidate(signal = new AbortController().signal) {
     const probe = await probePublishedPackage({
@@ -23,22 +36,26 @@ export async function createVerifiedPiMcpRuntimeCandidate(signal = new AbortCont
         signal,
     });
     if (probe.kind !== "verified")
-        return undefined;
+        return unavailable(probe.code, probeExplanation(probe.code));
     signal.throwIfAborted();
     try {
         const module = programmaticModule(await import(probe.entry));
-        if (module === undefined)
-            return undefined;
-        return createPiMcpRuntime({
-            packageFactory: module.createMcpAdapter,
-            initialSources: [],
-            fileDiscovery: "disabled",
+        if (module === undefined) {
+            return unavailable("PACKAGE_IMPORT_FAILED", "The MCP adapter package does not expose a usable programmatic runtime.", new TypeError("published MCP adapter programmatic export is incomplete"));
+        }
+        return Object.freeze({
+            kind: "verified",
+            adapter: createPiMcpRuntime({
+                packageFactory: module.createMcpAdapter,
+                initialSources: [],
+                fileDiscovery: "disabled",
+            }),
         });
     }
-    catch {
+    catch (cause) {
         if (signal.aborted)
             throw signal.reason;
-        return undefined;
+        return unavailable("PACKAGE_IMPORT_FAILED", "The MCP adapter package could not be loaded.", cause);
     }
 }
 //# sourceMappingURL=pi-mcp-adapter-package.js.map

package/node_modules/@nklisch/pi-plugins/dist/runtime/mcp/pi-mcp-adapter-package.js.map

@@ -1 +1 @@
-{"version":3,"file":"pi-mcp-adapter-package.js","sourceRoot":"","sources":["../../../src/runtime/mcp/pi-mcp-adapter-package.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,GAEtB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,kBAAkB,GAEnB,MAAM,6BAA6B,CAAC;AAErC,MAAM,CAAC,MAAM,sBAAsB,GAA4B,MAAM,CAAC,MAAM,CAAC;IAC3E,WAAW,EAAE,yBAAyB;IACtC,OAAO,EAAE,kBAAkB;IAC3B,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,WAAW;IACvB,WAAW,EAAE,aAAa;IAC1B,eAAe,EAAE,CAAC,GAAG,EAAE,gBAAgB,CAAC;IACxC,YAAY,EAAE,CAAC,YAAY,CAAC;CAC7B,CAAC,CAAC;AAMH,SAAS,kBAAkB,CAAC,KAAc;IACxC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAC3C,OAAQ,KAAwC,CAAC,gBAAgB,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IACvG,OAAO,KAA2B,CAAC;AACrC,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,mCAAmC,CACvD,MAAM,GAAgB,IAAI,eAAe,EAAE,CAAC,MAAM;IAElD,MAAM,KAAK,GAAG,MAAM,qBAAqB,CAAC;QACxC,cAAc,EAAE,sCAAsC;QACtD,OAAO,EAAE,sBAAsB;QAC/B,MAAM;KACP,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,CAAC,cAAc,EAAE,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7D,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC3C,OAAO,kBAAkB,CAAC;YACxB,cAAc,EAAE,MAAM,CAAC,gBAAgB;YACvC,cAAc,EAAE,EAAE;YAClB,aAAa,EAAE,UAAU;SAC1B,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,MAAM,CAAC,OAAO;YAAE,MAAM,MAAM,CAAC,MAAM,CAAC;QACxC,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}
+{"version":3,"file":"pi-mcp-adapter-package.js","sourceRoot":"","sources":["../../../src/runtime/mcp/pi-mcp-adapter-package.ts"],"names":[],"mappings":"AACA,OAAO,EACL,qBAAqB,GAEtB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,kBAAkB,GAEnB,MAAM,6BAA6B,CAAC;AAErC,MAAM,CAAC,MAAM,sBAAsB,GAA4B,MAAM,CAAC,MAAM,CAAC;IAC3E,WAAW,EAAE,yBAAyB;IACtC,OAAO,EAAE,kBAAkB;IAC3B,OAAO,EAAE,KAAK;IACd,UAAU,EAAE,WAAW;IACvB,WAAW,EAAE,aAAa;IAC1B,eAAe,EAAE,CAAC,GAAG,EAAE,gBAAgB,CAAC;IACxC,YAAY,EAAE,CAAC,YAAY,CAAC;CAC7B,CAAC,CAAC;AAqBH,SAAS,kBAAkB,CAAC,KAAc;IACxC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAC3C,OAAQ,KAAwC,CAAC,gBAAgB,KAAK,UAAU;QAAE,OAAO,SAAS,CAAC;IACvG,OAAO,KAA2B,CAAC;AACrC,CAAC;AAED,SAAS,WAAW,CAClB,IAA0C,EAC1C,WAAmB,EACnB,KAAe;IAEf,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,aAAsB;QAC5B,IAAI;QACJ,WAAW;QACX,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;KAC1C,CAAC,CAAC;AACL,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAyC;IACjE,OAAO,IAAI,KAAK,iBAAiB;QAC/B,CAAC,CAAC,2CAA2C;QAC7C,CAAC,CAAC,wEAAwE,CAAC;AAC/E,CAAC;AAED,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,mCAAmC,CACvD,MAAM,GAAgB,IAAI,eAAe,EAAE,CAAC,MAAM;IAElD,MAAM,KAAK,GAAG,MAAM,qBAAqB,CAAC;QACxC,cAAc,EAAE,sCAAsC;QACtD,OAAO,EAAE,sBAAsB;QAC/B,MAAM;KACP,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,WAAW,CAAC,KAAK,CAAC,IAAI,EAAE,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IAC5F,MAAM,CAAC,cAAc,EAAE,CAAC;IACxB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7D,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,WAAW,CAChB,uBAAuB,EACvB,wEAAwE,EACxE,IAAI,SAAS,CAAC,yDAAyD,CAAC,CACzE,CAAC;QACJ,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,UAAmB;YACzB,OAAO,EAAE,kBAAkB,CAAC;gBAC1B,cAAc,EAAE,MAAM,CAAC,gBAAgB;gBACvC,cAAc,EAAE,EAAE;gBAClB,aAAa,EAAE,UAAU;aAC1B,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,MAAM,CAAC,OAAO;YAAE,MAAM,MAAM,CAAC,MAAM,CAAC;QACxC,OAAO,WAAW,CAChB,uBAAuB,EACvB,8CAA8C,EAC9C,KAAK,CACN,CAAC;IACJ,CAAC;AACH,CAAC"}

package/node_modules/@nklisch/pi-plugins/dist/runtime/mcp/pi-mcp-adapter-runtime.js

@@ -4,7 +4,7 @@ import { BoundaryError, DiagnosticSchema, ErrorCodeRegistry, diagnosticFromZodEr
 const PACKAGE_PROVIDER = Object.freeze({
     kind: "published-package",
     packageName: "@nklisch/pi-mcp-adapter",
-    version: "2.20.1-nklisch.1",
+    version: "2.21.0-nklisch.0",
     nodeEngine: ">=22.19.0",
     piPeerRange: ">=0.82.0 <1",
     contractVersion: 1,

package/node_modules/@nklisch/pi-plugins/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nklisch/pi-plugins",
-  "version": "0.3.9",
+  "version": "0.4.0",
   "private": false,
   "description": "Native marketplace and plugin lifecycle management for Pi, with Claude Code and Codex compatibility.",
   "license": "MIT",
@@ -67,7 +67,7 @@
     "@nklisch/pi-subagents"
   ],
   "dependencies": {
-    "@nklisch/pi-mcp-adapter": "2.20.1-nklisch.1",
+    "@nklisch/pi-mcp-adapter": "2.21.0-nklisch.0",
     "@nklisch/pi-subagents": "18.1.0-nklisch.1",
     "jiti": "2.7.0",
     "semver": "7.8.1",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@nklisch/pi-enhanced",
-  "version": "0.1.11",
-  "description": "Pi, enhanced — one install for nklisch's full harness: policy-gated command review, plugin marketplace, subagents, background tasks, research tools, search, model modes, and a curated UX set.",
+  "version": "0.2.0",
+  "description": "Pi, enhanced \u2014 one install for nklisch's full harness: policy-gated command review, plugin marketplace, subagents, background tasks, research tools, search, model modes, and a curated UX set.",
   "author": {
     "name": "nklisch"
   },
@@ -70,7 +70,7 @@
     "@nklisch/pi-clearance": "^0",
     "@nklisch/pi-conveniences": "^0",
     "@nklisch/pi-fff-compat": "^0",
-    "@nklisch/pi-mcp-adapter": "2.20.1-nklisch.1",
+    "@nklisch/pi-mcp-adapter": "2.21.0-nklisch.0",
     "@nklisch/pi-model-modes": "^0",
     "@nklisch/pi-plugins": "^0",
     "@sinclair/typebox": "^0.34.49",

package/node_modules/@nklisch/pi-plugins/dist/application/generation-mutation-coordinator.d.ts

@@ -1,79 +0,0 @@
-import { type PluginKey } from "../domain/identity.js";
-import { type Generation } from "../domain/state/config-state.js";
-import { type ScopeContext } from "../domain/state/scope.js";
-import { type GenerationSnapshot, type VerifiedStateMutation } from "./state-contract.js";
-import type { LifecycleStateStore } from "./ports/lifecycle-state-store.js";
-import type { ScopeLockManager } from "./ports/scope-lock.js";
-import type { KeyedMutationScheduler } from "./mutation-coordination.js";
-export type PreparedMutationRequest = Readonly<{
-    scope: ScopeContext;
-    plugins: readonly PluginKey[];
-    expectedGeneration: Generation;
-}>;
-export type PreparedMutationContext = Readonly<{
-    snapshot: GenerationSnapshot;
-    assertOwned(): Promise<void>;
-}>;
-export type PreparedMutation<T> = Readonly<{
-    mutation: VerifiedStateMutation;
-    value: T;
-    /** Last authority check while the scope lease is still owned, immediately before durable commit. */
-    beforeCommit?: () => Promise<void>;
-}>;
-export type GenerationMutationResult<T> = Readonly<{
-    kind: "committed";
-    value: T;
-    snapshot: GenerationSnapshot;
-}> | Readonly<{
-    kind: "stale-generation";
-    expected: Generation;
-    actual: Generation;
-}> | Readonly<{
-    kind: "commit-failed";
-    value: T;
-    expected: Generation;
-    actual: Generation;
-}> | Readonly<{
-    kind: "commit-ambiguous";
-    value: T;
-    expected: Generation;
-    actual?: Generation;
-}>;
-/** Retains both failures when a mutation and its lock cleanup fail together. */
-export declare class MutationCleanupError extends Error {
-    readonly operationError: unknown;
-    readonly cleanupError: unknown;
-    readonly causes: readonly [unknown, unknown];
-    readonly outcome: GenerationMutationResult<unknown> | undefined;
-    readonly observedSnapshot: GenerationSnapshot | undefined;
-    constructor(operationError: unknown, cleanupError: unknown, evidence?: Readonly<{
-        outcome?: GenerationMutationResult<unknown>;
-        observedSnapshot?: GenerationSnapshot;
-    }>);
-}
-/**
- * A committed state result is durable even if the lease cannot be cleaned up.
- * Callers receive the evidence needed to inspect/recover instead of blindly
- * replaying a mutation whose promotion may already be visible.
- */
-export declare class CommittedMutationCleanupError<T> extends Error {
-    readonly committed: Readonly<{
-        value: T;
-        snapshot: GenerationSnapshot;
-    }>;
-    readonly cleanupError: unknown;
-    readonly cause: unknown;
-    constructor(committed: Readonly<{
-        value: T;
-        snapshot: GenerationSnapshot;
-    }>, cleanupError: unknown);
-}
-export interface GenerationMutationCoordinator {
-    runPreparedMutation<T>(request: PreparedMutationRequest, prepareCommit: (context: PreparedMutationContext) => Promise<PreparedMutation<T>>, signal: AbortSignal): Promise<GenerationMutationResult<T>>;
-}
-export type GenerationMutationCoordinatorDependencies = Readonly<{
-    scheduler: KeyedMutationScheduler;
-    locks: ScopeLockManager;
-    state: LifecycleStateStore;
-}>;
-export declare function createGenerationMutationCoordinator(dependencies: GenerationMutationCoordinatorDependencies): GenerationMutationCoordinator;