@nklisch/pi-enhanced 0.1.0

package/node_modules/@nklisch/pi-plugins/dist/pi/pi-reload-broker.js

@@ -0,0 +1,77 @@
+import { randomUUID } from "node:crypto";
+const REGISTRY = Symbol.for("@nklisch/pi-plugins/reload-broker-v1");
+function registry() {
+    const root = globalThis;
+    if (root[REGISTRY] !== undefined)
+        return root[REGISTRY];
+    const created = { tickets: new Map() };
+    Object.defineProperty(root, REGISTRY, { value: created, configurable: false });
+    return created;
+}
+function publicTicket(state) {
+    return Object.freeze({ id: state.id, sessionId: state.sessionId, cwd: state.cwd, scope: state.scope, transition: state.transition });
+}
+function exact(state, ticket) {
+    return state.id === ticket.id && state.sessionId === ticket.sessionId && state.cwd === ticket.cwd &&
+        JSON.stringify(state.scope) === JSON.stringify(ticket.scope) && state.transition === ticket.transition;
+}
+export function createPiReloadBroker() {
+    const states = registry();
+    function lookup(ticket) {
+        const state = states.tickets.get(ticket.id);
+        if (state === undefined || !exact(state, ticket))
+            throw new Error("Pi reload ticket is unavailable");
+        return state;
+    }
+    function open(binding, scope, transition) {
+        if ([...states.tickets.values()].some((ticket) => !ticket.settled && ticket.sessionId === binding.sessionId)) {
+            throw new Error("a Pi reload ticket is already pending for this session");
+        }
+        let resolve;
+        let reject;
+        const promise = new Promise((accept, decline) => { resolve = accept; reject = decline; });
+        // A successor can fail while the predecessor is still inside
+        // `await context.reload()`, before it can call wait(). Attach a handler
+        // immediately so that exact failure remains broker evidence rather than an
+        // unhandled process-level rejection.
+        void promise.catch(() => undefined);
+        const state = { id: randomUUID(), sessionId: binding.sessionId, cwd: binding.cwd, scope, transition, claimed: false, settled: false, resolve, reject, promise };
+        states.tickets.set(state.id, state);
+        return publicTicket(state);
+    }
+    function claimSuccessor(binding) {
+        const matches = [...states.tickets.values()].filter((ticket) => !ticket.settled && !ticket.claimed && ticket.sessionId === binding.sessionId && ticket.cwd === binding.cwd);
+        if (matches.length !== 1)
+            return undefined;
+        matches[0].claimed = true;
+        return publicTicket(matches[0]);
+    }
+    function publish(ticket, observations) {
+        const state = lookup(ticket);
+        if (!state.claimed || state.settled)
+            throw new Error("Pi reload ticket cannot be published");
+        state.settled = true;
+        state.resolve(Object.freeze([...observations]));
+    }
+    function fail(ticket, error = new Error("Pi reload successor failed")) {
+        const state = lookup(ticket);
+        if (state.settled)
+            return;
+        state.settled = true;
+        state.reject(error);
+    }
+    async function wait(ticket, signal) {
+        const state = lookup(ticket);
+        signal.throwIfAborted();
+        const abort = new Promise((_, reject) => signal.addEventListener("abort", () => reject(signal.reason), { once: true }));
+        try {
+            return await Promise.race([state.promise, abort]);
+        }
+        finally {
+            if (state.settled)
+                states.tickets.delete(state.id);
+        }
+    }
+    return Object.freeze({ open, claimSuccessor, publish, fail, wait });
+}
+//# sourceMappingURL=pi-reload-broker.js.map

package/node_modules/@nklisch/pi-plugins/dist/pi/pi-reload-broker.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/pi/pi-session-binding.d.ts

@@ -0,0 +1,4 @@
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import { type PiSessionBindingPort } from "../composition/packaged-plugin-host-contract.js";
+/** Bind one started host to the exact Pi context that selected its project. */
+export declare function createPiSessionBinding(context: ExtensionContext): PiSessionBindingPort;

package/node_modules/@nklisch/pi-plugins/dist/pi/pi-session-binding.js

@@ -0,0 +1,59 @@
+import { isAbsolute, resolve } from "node:path";
+import { PackagedPluginHostError, PackagedPluginHostErrorCode, } from "../composition/packaged-plugin-host-contract.js";
+function mismatch() {
+    throw new PackagedPluginHostError(PackagedPluginHostErrorCode.sessionMismatch, "Pi context does not belong to the bound host session");
+}
+function readSessionId(context) {
+    const value = context.sessionManager.getSessionId();
+    if (typeof value !== "string" || value.length === 0)
+        mismatch();
+    return value;
+}
+/** Bind one started host to the exact Pi context that selected its project. */
+export function createPiSessionBinding(context) {
+    if (context === null || typeof context !== "object")
+        mismatch();
+    const sessionId = readSessionId(context);
+    if (typeof context.cwd !== "string" || context.cwd.length === 0 || !isAbsolute(context.cwd))
+        mismatch();
+    const cwd = resolve(context.cwd);
+    if (cwd !== context.cwd)
+        mismatch();
+    const sessionFile = context.sessionManager.getSessionFile();
+    if (sessionFile !== undefined && (typeof sessionFile !== "string" || sessionFile.length === 0))
+        mismatch();
+    const projectTrusted = context.isProjectTrusted();
+    if (typeof projectTrusted !== "boolean")
+        mismatch();
+    const binding = Object.freeze({
+        sessionId,
+        ...(sessionFile === undefined ? {} : { sessionFile }),
+        cwd,
+        mode: context.mode,
+        projectTrusted,
+    });
+    return Object.freeze({
+        current() {
+            return binding;
+        },
+        assertContext(candidate) {
+            if (candidate === null || typeof candidate !== "object")
+                mismatch();
+            let candidateId;
+            try {
+                candidateId = readSessionId(candidate);
+            }
+            catch {
+                mismatch();
+            }
+            if (candidateId !== binding.sessionId || candidate.cwd !== binding.cwd)
+                mismatch();
+        },
+        isProjectTrusted() {
+            // Trust is live policy evidence. It must not be inferred from the startup
+            // value retained only for status/audit output.
+            return context.isProjectTrusted() === true;
+        },
+    });
+}
+//# sourceMappingURL=pi-session-binding.js.map

package/node_modules/@nklisch/pi-plugins/dist/pi/pi-session-binding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-session-binding.js","sourceRoot":"","sources":["../../src/pi/pi-session-binding.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EACL,uBAAuB,EACvB,2BAA2B,GAG5B,MAAM,iDAAiD,CAAC;AAEzD,SAAS,QAAQ;IACf,MAAM,IAAI,uBAAuB,CAC/B,2BAA2B,CAAC,eAAe,EAC3C,sDAAsD,CACvD,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,OAAyB;IAC9C,MAAM,KAAK,GAAG,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC;IACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,QAAQ,EAAE,CAAC;IAChE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,sBAAsB,CAAC,OAAyB;IAC9D,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,QAAQ,EAAE,CAAC;IAChE,MAAM,SAAS,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,QAAQ,EAAE,CAAC;IACxG,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,GAAG,KAAK,OAAO,CAAC,GAAG;QAAE,QAAQ,EAAE,CAAC;IACpC,MAAM,WAAW,GAAG,OAAO,CAAC,cAAc,CAAC,cAAc,EAAE,CAAC;IAC5D,IAAI,WAAW,KAAK,SAAS,IAAI,CAAC,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,CAAC;QAAE,QAAQ,EAAE,CAAC;IAC3G,MAAM,cAAc,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;IAClD,IAAI,OAAO,cAAc,KAAK,SAAS;QAAE,QAAQ,EAAE,CAAC;IAEpD,MAAM,OAAO,GAAqB,MAAM,CAAC,MAAM,CAAC;QAC9C,SAAS;QACT,GAAG,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC;QACrD,GAAG;QACH,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,cAAc;KACf,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO;YACL,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,aAAa,CAAC,SAA2B;YACvC,IAAI,SAAS,KAAK,IAAI,IAAI,OAAO,SAAS,KAAK,QAAQ;gBAAE,QAAQ,EAAE,CAAC;YACpE,IAAI,WAAmB,CAAC;YACxB,IAAI,CAAC;gBACH,WAAW,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;YACzC,CAAC;YAAC,MAAM,CAAC;gBACP,QAAQ,EAAE,CAAC;YACb,CAAC;YACD,IAAI,WAAW,KAAK,OAAO,CAAC,SAAS,IAAI,SAAS,CAAC,GAAG,KAAK,OAAO,CAAC,GAAG;gBAAE,QAAQ,EAAE,CAAC;QACrF,CAAC;QACD,gBAAgB;YACd,0EAA0E;YAC1E,+CAA+C;YAC/C,OAAO,OAAO,CAAC,gBAAgB,EAAE,KAAK,IAAI,CAAC;QAC7C,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/node_modules/@nklisch/pi-plugins/dist/pi/pi-subagent-session-context.d.ts

@@ -0,0 +1,8 @@
+import type { PiSessionBindingPort } from "../composition/packaged-plugin-host-contract.js";
+import type { PiProjectContextAdapters } from "./pi-project-context.js";
+import type { SubagentHookSessionContextPort } from "../runtime/subagents/subagent-hook-session-context.js";
+/** Resolve only the exact current Plugin Host parent session. */
+export declare function createPiSubagentSessionContext(input: Readonly<{
+    binding: PiSessionBindingPort;
+    project: PiProjectContextAdapters;
+}>): SubagentHookSessionContextPort;

package/node_modules/@nklisch/pi-plugins/dist/pi/pi-subagent-session-context.js

@@ -0,0 +1,20 @@
+import { HookSessionEvidenceSchema } from "../runtime/hooks/event-contract.js";
+/** Resolve only the exact current Plugin Host parent session. */
+export function createPiSubagentSessionContext(input) {
+    return Object.freeze({
+        async resolve(parentSessionId, signal) {
+            signal.throwIfAborted();
+            const binding = input.binding.current();
+            if (parentSessionId !== binding.sessionId)
+                return undefined;
+            return HookSessionEvidenceSchema.parse({
+                sessionId: binding.sessionId,
+                ...(binding.sessionFile === undefined ? {} : { transcriptPath: binding.sessionFile }),
+                cwd: binding.cwd,
+                currentProject: input.project.current(),
+                piProjectTrusted: input.binding.isProjectTrusted(),
+            });
+        },
+    });
+}
+//# sourceMappingURL=pi-subagent-session-context.js.map

package/node_modules/@nklisch/pi-plugins/dist/pi/pi-subagent-session-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-subagent-session-context.js","sourceRoot":"","sources":["../../src/pi/pi-subagent-session-context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AAG/E,iEAAiE;AACjE,MAAM,UAAU,8BAA8B,CAAC,KAG7C;IACA,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK,CAAC,OAAO,CAAC,eAAuB,EAAE,MAAmB;YACxD,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YACxC,IAAI,eAAe,KAAK,OAAO,CAAC,SAAS;gBAAE,OAAO,SAAS,CAAC;YAC5D,OAAO,yBAAyB,CAAC,KAAK,CAAC;gBACrC,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,GAAG,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,WAAW,EAAE,CAAC;gBACrF,GAAG,EAAE,OAAO,CAAC,GAAG;gBAChB,cAAc,EAAE,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE;gBACvC,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC,gBAAgB,EAAE;aACnD,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/node_modules/@nklisch/pi-plugins/dist/pi/pi-update-notification-publisher.d.ts

@@ -0,0 +1,16 @@
+import type { ExtensionAPI, ExtensionContext, SessionShutdownEvent } from "@earendil-works/pi-coding-agent";
+import type { UpdateNotificationPublisherPort } from "../application/ports/update-notification-publisher.js";
+export declare class PiUpdateNotificationUnavailableError extends Error {
+    readonly code = "PI_UPDATE_NOTIFICATION_UI_UNAVAILABLE";
+    constructor();
+}
+export interface PiUpdateNotificationPublisher extends UpdateNotificationPublisherPort {
+    bind(context: ExtensionContext): void;
+    unbind(reason: SessionShutdownEvent["reason"]): void;
+    restore(context: ExtensionContext): void;
+    close(): Promise<void>;
+}
+/** Session-bindable notification adapter; application notice state remains authority. */
+export declare function createPiUpdateNotificationPublisher(input: Readonly<{
+    pi: ExtensionAPI;
+}>): PiUpdateNotificationPublisher;

package/node_modules/@nklisch/pi-plugins/dist/pi/pi-update-notification-publisher.js

@@ -0,0 +1,66 @@
+import { UpdateNoticeIdSchema } from "../domain/update-policy.js";
+import { projectTerminalText } from "./manager/pi-terminal-text.js";
+const UPDATE_ENTRY = "plugin-host:update-notified-v1";
+export class PiUpdateNotificationUnavailableError extends Error {
+    code = "PI_UPDATE_NOTIFICATION_UI_UNAVAILABLE";
+    constructor() {
+        super("Pi update notification UI is unavailable");
+        this.name = "PiUpdateNotificationUnavailableError";
+    }
+}
+function safe(value) { return projectTerminalText(value, 512).text; }
+/** Session-bindable notification adapter; application notice state remains authority. */
+export function createPiUpdateNotificationPublisher(input) {
+    let context;
+    let terminal = false;
+    const published = new Set();
+    const publisher = {
+        bind(next) {
+            if (terminal)
+                throw new PiUpdateNotificationUnavailableError();
+            context = next;
+            published.clear();
+        },
+        unbind(_reason) {
+            context = undefined;
+            published.clear();
+        },
+        restore(current) {
+            if (context !== current || terminal)
+                return;
+            for (const entry of current.sessionManager.getEntries()) {
+                if (entry.type !== "custom" || entry.customType !== UPDATE_ENTRY || entry.data === null || typeof entry.data !== "object")
+                    continue;
+                const parsed = UpdateNoticeIdSchema.safeParse(entry.data.noticeId);
+                if (parsed.success)
+                    published.add(parsed.data);
+            }
+        },
+        async publish(event, signal) {
+            signal.throwIfAborted();
+            const active = context;
+            if (terminal || active === undefined || !active.hasUI || (active.mode !== "tui" && active.mode !== "rpc")) {
+                throw new PiUpdateNotificationUnavailableError();
+            }
+            if (published.has(event.id))
+                return "already-published";
+            const disposition = event.disposition === "automatic-applied"
+                ? "applied automatically"
+                : event.disposition === "manual-required" ? "manual review required" : safe(event.disposition);
+            active.ui.notify(`${safe(event.plugin)} ${safe(event.installed)} → ${safe(event.available)} · ${disposition}`, "info");
+            // Set before yielding so concurrent same-process retries cannot duplicate.
+            published.add(event.id);
+            input.pi.appendEntry(UPDATE_ENTRY, { noticeId: event.id });
+            return "published";
+        },
+        async close() {
+            if (terminal)
+                return;
+            terminal = true;
+            context = undefined;
+            published.clear();
+        },
+    };
+    return Object.freeze(publisher);
+}
+//# sourceMappingURL=pi-update-notification-publisher.js.map

package/node_modules/@nklisch/pi-plugins/dist/pi/pi-update-notification-publisher.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/pi/plain-language.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Plain-language projection for user-facing failure text.
+ *
+ * Internal codes (HOOK_*, planning codes, lifecycle codes) are the failure
+ * log's vocabulary. Notifications and screens speak in the user's frame of
+ * reference: the plugin they added, the message they typed, and the one
+ * action they can take. Every phrase here leads with what happened and what
+ * to do; codes never appear in UI text.
+ */
+/** Hook event names → the moment the user recognizes. */
+export declare function plainHookMoment(event: string): string;
+/** Internal hook failure code → a short plain reason. */
+export declare function plainHookFailure(code: string): string;
+/** One simple sentence for a hook that didn't run. */
+export declare function plainHookWarning(input: Readonly<{
+    event: string;
+    code: string;
+    plugin?: string;
+}>): string;
+/** Lifecycle failure code → a short plain reason. */
+export declare function plainLifecycleFailure(code: string): string;
+/** Kebab-case machine phase ("activation-observation") → words the user recognizes. */
+export declare function plainLifecyclePhase(phase: string): string;

package/node_modules/@nklisch/pi-plugins/dist/pi/plain-language.js

@@ -0,0 +1,97 @@
+/**
+ * Plain-language projection for user-facing failure text.
+ *
+ * Internal codes (HOOK_*, planning codes, lifecycle codes) are the failure
+ * log's vocabulary. Notifications and screens speak in the user's frame of
+ * reference: the plugin they added, the message they typed, and the one
+ * action they can take. Every phrase here leads with what happened and what
+ * to do; codes never appear in UI text.
+ */
+/** Hook event names → the moment the user recognizes. */
+export function plainHookMoment(event) {
+    switch (event) {
+        case "SessionStart": return "at session start";
+        case "SessionEnd": return "at session end";
+        case "UserPromptSubmit": return "on your message";
+        case "PreToolUse": return "before a tool call";
+        case "PostToolUse":
+        case "PostToolUseFailure": return "after a tool call";
+        case "PreCompact":
+        case "PostCompact": return "during compaction";
+        case "Stop": return "at turn end";
+        case "SubagentStart": return "starting a subagent";
+        case "SubagentStop": return "finishing a subagent";
+        default: return "";
+    }
+}
+const PLAIN_HOOK_FAILURES = Object.freeze({
+    HOOK_TIMEOUT: "it took too long",
+    HOOK_SPAWN_FAILED: "it couldn't start",
+    HOOK_EXECUTABLE_UNAVAILABLE: "it couldn't start",
+    HOOK_OUTPUT_LIMIT: "its output was too large",
+    HOOK_INVALID_OUTPUT: "it gave an unexpected response",
+    HOOK_UNSUPPORTED_OUTPUT: "it asked for something unsupported",
+    HOOK_INVALID_UTF8: "it gave an unreadable response",
+    HOOK_INVALID_PLAN: "its setup was invalid",
+    HOOK_SELECTED_LIMIT: "too many hooks ran at once",
+    HOOK_AUTHORITY_REJECTED: "the plugin runtime wasn't ready yet",
+    HOOK_CONFIGURATION_FAILED: "its configuration couldn't be read",
+    HOOK_CANCELLED: "it was cancelled",
+    HOOK_AGGREGATE_LIMIT: "the combined hook output was too large",
+    HOOK_CONTINUATION_EXHAUSTED: "it asked to continue too many times",
+    HOOK_PERMISSION_UNAVAILABLE: "its permission question couldn't be shown",
+    CURRENT_PROJECT_MISMATCH: "the project changed underneath it",
+    PROJECT_SCOPE_MISMATCH: "the project changed underneath it",
+    PROJECT_UNTRUSTED: "this project isn't trusted",
+    PI_PROJECT_UNTRUSTED: "this project isn't trusted",
+    PROJECTION_MISMATCH: "the plugin changed since it was loaded",
+    SELECTOR_RECOMPILATION_MISMATCH: "the plugin changed since it was loaded",
+    CATALOG_UNAVAILABLE: "the plugin catalog isn't ready yet",
+    CATALOG_UNINITIALIZED: "the plugin catalog isn't ready yet",
+    INVALID_REQUEST: "it got a request it didn't understand",
+    UNSUPPORTED_EVENT: "it doesn't support that moment",
+    CANCELLED: "it was cancelled",
+});
+/** Internal hook failure code → a short plain reason. */
+export function plainHookFailure(code) {
+    return PLAIN_HOOK_FAILURES[code] ?? "it hit an internal error";
+}
+/** One simple sentence for a hook that didn't run. */
+export function plainHookWarning(input) {
+    const who = input.plugin ?? "A plugin";
+    const when = plainHookMoment(input.event);
+    return `${who}'s hook ${when === "" ? "didn't run" : `didn't run ${when}`} — ${plainHookFailure(input.code)}. Continuing without it.`;
+}
+const PLAIN_LIFECYCLE_FAILURES = Object.freeze({
+    "reload-rejected": "Pi couldn't reload with the plugin",
+    "observation-mismatch": "it didn't come up as expected",
+    "adapter-error": "an internal error interrupted it",
+    ADAPTER_FAILED: "an internal error interrupted it",
+    PROGRESS_DELIVERY_FAILED: "progress reporting broke",
+    PROJECT_INTENT_WRITE_FAILED: "the project's plugin list couldn't be written",
+    CLEANUP_FAILED: "cleanup didn't finish",
+    DISPOSED: "the plugin runtime was shut down",
+    CONFIG_REQUIRED: "a required setting is missing",
+    CONSENT_REQUIRED: "the executable disclosure needs a decision",
+});
+/** Lifecycle failure code → a short plain reason. */
+export function plainLifecycleFailure(code) {
+    return PLAIN_LIFECYCLE_FAILURES[code] ?? "an internal error interrupted it";
+}
+/** Kebab-case machine phase ("activation-observation") → words the user recognizes. */
+export function plainLifecyclePhase(phase) {
+    const words = phase.replaceAll("-", " ");
+    switch (phase) {
+        case "activation-observation": return "the post-install check";
+        case "activation-transaction": return "the install itself";
+        case "candidate-acquisition": return "downloading the plugin";
+        case "input-validation": return "checking your configuration";
+        case "configuration-custody": return "storing your configuration";
+        case "trust-decision": return "the trust decision";
+        case "uninstall-cleanup": return "cleanup after removal";
+        case "project-reconciliation": return "syncing the project";
+        case "completed": return "the final step";
+        default: return words;
+    }
+}
+//# sourceMappingURL=plain-language.js.map

package/node_modules/@nklisch/pi-plugins/dist/pi/plain-language.js.map

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

package/node_modules/@nklisch/pi-plugins/dist/pi/plugin-command.d.ts

@@ -0,0 +1,40 @@
+import type { ExtensionAPI, ExtensionCommandContext, ExtensionContext, SessionShutdownEvent } from "@earendil-works/pi-coding-agent";
+import type { NativeControlDynamicCandidate } from "../application/native-control-help.js";
+import type { NativeControlInputPort } from "../application/ports/native-control-input.js";
+import type { NativeControlExecutionReport, NativeControlFrameSink } from "../application/ports/native-control-execution.js";
+import type { NativeControlFrame } from "../application/native-control-progress.js";
+import type { PackagedPluginHost } from "../composition/packaged-plugin-host-contract.js";
+import type { PiControlChannel } from "./pi-control-channel.js";
+import type { PiInlinePresenter } from "./manager/pi-control-input.js";
+import type { PiManagerReloadHandoff } from "./pi-manager-reload-handoff.js";
+export type PluginManagerLiveOperation = Readonly<{
+    signal?: AbortSignal;
+    reloadSafe: boolean;
+    run(sink: NativeControlFrameSink, signal: AbortSignal): Promise<NativeControlExecutionReport>;
+    settle(report: NativeControlExecutionReport): "local" | "successor";
+}>;
+export interface PluginManagerPresentation {
+    open(context: ExtensionCommandContext): Promise<void>;
+    presentOperation(context: ExtensionCommandContext, operation: PluginManagerLiveOperation): Promise<void>;
+    presentReport(context: ExtensionCommandContext, report: NativeControlExecutionReport, frames: readonly NativeControlFrame[]): Promise<void>;
+    dynamicCompletions(): readonly NativeControlDynamicCandidate[];
+    /** The surface that can mount mid-operation input custody inline, if one is presented. */
+    inlinePresenter?(): PiInlinePresenter | undefined;
+    close(reason: SessionShutdownEvent["reason"]): Promise<void>;
+}
+export type PluginCommandAdapter = Readonly<{
+    register(): void;
+    bindSession(context: ExtensionContext): void;
+    unbindSession(reason: SessionShutdownEvent["reason"]): void;
+    close(): Promise<void>;
+}>;
+/** Register the sole Pi management command without interpreting its grammar. */
+export declare function createPluginCommandAdapter(input: Readonly<{
+    pi: ExtensionAPI;
+    sourceUrl: string;
+    host: PackagedPluginHost;
+    manager: PluginManagerPresentation;
+    channel: PiControlChannel;
+    handoff?: Pick<PiManagerReloadHandoff, "open" | "publish" | "fail">;
+    createInput?: (context: ExtensionCommandContext, mode: ExtensionContext["mode"]) => NativeControlInputPort;
+}>): PluginCommandAdapter;

package/node_modules/@nklisch/pi-plugins/dist/pi/plugin-command.js

@@ -0,0 +1,162 @@
+import { normalize, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createNativeControlParser } from "../application/native-control-parser.js";
+function linkedAbort(parent) {
+    const controller = new AbortController();
+    if (parent === undefined)
+        return { controller, dispose() { } };
+    const abort = () => controller.abort(parent.reason);
+    if (parent.aborted)
+        abort();
+    else
+        parent.addEventListener("abort", abort, { once: true });
+    return Object.freeze({ controller, dispose: () => parent.removeEventListener("abort", abort) });
+}
+function ownInvocationName(pi, sourceUrl) {
+    const ownPath = normalize(resolve(fileURLToPath(sourceUrl)));
+    const commands = pi.getCommands().filter((command) => {
+        if (command.source !== "extension")
+            return false;
+        return normalize(resolve(command.sourceInfo.path)) === ownPath;
+    });
+    return commands.length === 1 ? commands[0].name : undefined;
+}
+function reloadDestination(command) {
+    if (command === "install.run" || command === "install.apply" || command === "install.recover")
+        return "install-result";
+    if (command.startsWith("lifecycle.") || command === "project.sync" || command === "updates.automatic.run")
+        return "operation-result";
+    return undefined;
+}
+/** Register the sole Pi management command without interpreting its grammar. */
+export function createPluginCommandAdapter(input) {
+    const staticParser = createNativeControlParser();
+    let registered = false;
+    let closed = false;
+    async function handler(args, context) {
+        if (closed) {
+            context.ui.notify("Plugin Host presentation is closed.", "error");
+            return;
+        }
+        const current = input.host.current();
+        if (current === undefined) {
+            context.ui.notify("Plugin Host is still starting; retry /plugin.", "warning");
+            return;
+        }
+        const parsed = current.application.control.parseText(args);
+        if (parsed.kind === "parsed" && parsed.command.command === "presentation" && context.mode === "tui") {
+            await context.waitForIdle();
+            await input.manager.open(context);
+            return;
+        }
+        const destination = parsed.kind === "parsed" ? reloadDestination(parsed.command.command) : undefined;
+        // Pi aborts the predecessor command context as part of a successful
+        // extension reload. Activation commands must survive that boundary long
+        // enough to consume successor observation and settle the durable
+        // transition; their operation registry still owns explicit cancellation.
+        const abort = linkedAbort(destination === undefined ? context.signal : undefined);
+        let handoffTicket;
+        if (destination !== undefined && input.handoff !== undefined) {
+            handoffTicket = input.handoff.open({ sessionId: context.sessionManager.getSessionId(), cwd: context.cwd, destination });
+        }
+        const executionInput = parsed.kind === "parsed" && !parsed.command.invocation.nonInteractive && input.createInput !== undefined
+            ? input.createInput(context, context.mode)
+            : undefined;
+        try {
+            const output = parsed.kind === "parsed" ? parsed.command.invocation.output : "human";
+            if (context.mode === "tui") {
+                await input.manager.presentOperation(context, {
+                    signal: abort.controller.signal,
+                    reloadSafe: destination !== undefined,
+                    async run(viewSink, signal) {
+                        // The live TUI owns these frames directly. Retaining them in the
+                        // Pi channel would require touching the predecessor command context
+                        // after a reload, when only the plain-data handoff remains valid.
+                        return input.host.runWithPiOperationContext(context, signal, (application) => application.control.runText(args, {
+                            mode: context.mode,
+                            output,
+                            sink: viewSink,
+                            ...(executionInput === undefined ? {} : { input: executionInput }),
+                        }, signal));
+                    },
+                    settle(report) {
+                        return handoffTicket === undefined || input.handoff === undefined
+                            ? "local"
+                            : input.handoff.publish(handoffTicket, report);
+                    },
+                });
+            }
+            else {
+                const report = await input.host.runWithPiOperationContext(context, abort.controller.signal, (application) => application.control.runText(args, {
+                    mode: context.mode,
+                    output,
+                    sink: input.channel.createSink(context, context.mode),
+                    ...(executionInput === undefined ? {} : { input: executionInput }),
+                }, abort.controller.signal));
+                const presentation = handoffTicket === undefined || input.handoff === undefined
+                    ? "local"
+                    : input.handoff.publish(handoffTicket, report);
+                if (presentation === "successor")
+                    return;
+                await input.channel.publishReport(context, report);
+            }
+        }
+        catch {
+            if (handoffTicket !== undefined && input.handoff !== undefined) {
+                try {
+                    input.handoff.fail(handoffTicket);
+                }
+                catch { /* retain the original command failure */ }
+            }
+            // Native errors and causes are deliberately not reflected into UI/protocol
+            // channels. The facade envelope is the only detailed management result.
+            context.ui.notify("Plugin Host command could not complete.", "error");
+        }
+        finally {
+            abort.dispose();
+            const disposable = executionInput;
+            disposable?.dispose?.();
+        }
+    }
+    return Object.freeze({
+        register() {
+            if (registered)
+                return;
+            registered = true;
+            input.pi.registerCommand("plugin", {
+                description: "Manage Pi plugins",
+                getArgumentCompletions(argumentPrefix) {
+                    const control = input.host.current()?.application.control;
+                    const completion = (control ?? staticParser).complete({
+                        text: argumentPrefix,
+                        dynamic: input.manager.dynamicCompletions(),
+                    });
+                    if (completion.candidates.length === 0)
+                        return null;
+                    return completion.candidates.map((candidate) => ({
+                        value: candidate.value,
+                        label: candidate.safe.text,
+                    }));
+                },
+                handler,
+            });
+        },
+        bindSession(context) {
+            const invocationName = ownInvocationName(input.pi, input.sourceUrl);
+            if (invocationName !== undefined && invocationName !== "plugin") {
+                input.channel.publishCollision(context, invocationName);
+            }
+        },
+        unbindSession(_reason) {
+            // Command registration is process-owned by Pi. Session-scoped objects are
+            // closed by the presentation lifecycle rather than unregistered here.
+        },
+        async close() {
+            if (closed)
+                return;
+            closed = true;
+            await input.manager.close("quit");
+        },
+    });
+}
+//# sourceMappingURL=plugin-command.js.map

package/node_modules/@nklisch/pi-plugins/dist/pi/plugin-command.js.map

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