@nklisch/pi-enhanced 0.2.3 → 0.2.5

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

@@ -1,839 +0,0 @@
-import { Key, matchesKey } from "@earendil-works/pi-tui";
-import { NativeInspectionDetailResultSchema } from "../../application/native-inspection-contract.js";
-import { NativeAutomaticUpdateRunResultSchema, NativeUpdatePolicyApplyResultSchema, NativeUpdatePolicyPreviewResultSchema, NativeUpdateStatusSchema, } from "../../application/native-update-contract.js";
-import { TrustedInstallActivationResultSchema, TrustedInstallOpenResultSchema, } from "../../application/trusted-install-contract.js";
-import { nativeControlHumanLines } from "../native-control-human.js";
-import { plainLifecycleFailure } from "../plain-language.js";
-import { ConfirmationSurface, presentConfirmationSurface } from "./confirmation-surface.js";
-import { createPiControlInputPort } from "./pi-control-input.js";
-import { createPiManagerFrameSink } from "./pi-manager-frame-sink.js";
-import { PluginInstallComponent } from "./plugin-install-component.js";
-import { createPluginInstallState, pluginInstallReducer } from "./plugin-install-flow.js";
-import { createPluginManagerActionRunner, } from "./plugin-manager-actions.js";
-import { PluginManagerComponent } from "./plugin-manager-component.js";
-import { detailCommand, updatePolicySetCommand, updateStatusCommand } from "./plugin-manager-commands.js";
-import { createPluginManagerController } from "./plugin-manager-controller.js";
-import { pluginManagerVisibleRows, rowKeyIdentity } from "./plugin-manager-model.js";
-import { PluginOperationView } from "./plugin-operation-view.js";
-import { TextInputSurface } from "./text-input-surface.js";
-function handoffInstallSummary(envelope) {
-    const activation = TrustedInstallActivationResultSchema.safeParse(envelope.data);
-    if (activation.success && activation.data.kind === "succeeded") {
-        return `✓ Added ${activation.data.plugin} · session reloaded`;
-    }
-    if (activation.success && activation.data.kind === "current-state") {
-        return `✓ ${activation.data.plugin} already added · session reloaded`;
-    }
-    return `✓ ${nativeControlHumanLines(envelope)[0] ?? "Plugin added"} · session reloaded`;
-}
-function selectedRow(state) {
-    const rows = pluginManagerVisibleRows(state);
-    if (state.focus.row === undefined)
-        return rows[0];
-    return rows.find((row) => rowKeyIdentity(row.key) === rowKeyIdentity(state.focus.row)) ?? rows[0];
-}
-const automaticRunResult = (envelope) => NativeAutomaticUpdateRunResultSchema.safeParse(envelope.data);
-function reportOperationalFailure(label, error) {
-    let detail = "unknown failure";
-    try {
-        detail = error instanceof Error ? error.message : String(error);
-    }
-    catch {
-        detail = "unreadable failure";
-    }
-    try {
-        console.error(`Pi Plugin Host ${label} failed: ${detail}`);
-    }
-    catch { /* a broken diagnostic sink cannot escape detached cleanup */ }
-}
-function safeNotify(context, message, level) {
-    try {
-        context.ui.notify(message, level);
-    }
-    catch { /* a stale UI must not reject detached work */ }
-}
-async function cleanupSequentially(steps, message) {
-    const failures = [];
-    for (const step of steps) {
-        try {
-            await step();
-        }
-        catch (error) {
-            failures.push(error);
-        }
-    }
-    if (failures.length > 0)
-        throw new AggregateError(failures, message);
-}
-/**
- * Sync-now defers activation. When anything is live on the next start,
- * offer exactly one reload so the user can use the new versions immediately;
- * declining leaves activation to the next start. The offer lives only in this
- * foreground gesture — never in durable state, never from the background.
- */
-async function offerDeferredReload(context, envelope, confirm) {
-    const parsed = automaticRunResult(envelope);
-    if (!parsed.success)
-        return;
-    const deferred = parsed.data.outcomes.filter((outcome) => outcome.kind === "live-next-start").length;
-    if (deferred === 0)
-        return;
-    const confirmed = await confirm(`${deferred} update${deferred === 1 ? "" : "s"} installed — reload now to use ${deferred === 1 ? "it" : "them"}?`, ["The updates are already installed. Reloading activates them now; otherwise they go live on the next start."]);
-    if (confirmed)
-        await context.reload();
-}
-function actionIntent(action, state) {
-    if (action === "update-all")
-        return { action };
-    const row = selectedRow(state);
-    if (row === undefined)
-        throw new TypeError("plugin manager action requires a selected row");
-    if (action === "enable" || action === "disable" || action === "update")
-        return { action, row };
-    if (action === "uninstall-delete")
-        return { action, row };
-    if (action === "marketplace-refresh" || action === "marketplace-remove" || action === "notice-acknowledge")
-        return { action, row };
-    if (action === "project-sync-apply")
-        return { action: "project-sync", mode: "apply-intent" };
-    if (action === "project-sync-publish")
-        return { action: "project-sync", mode: "publish-intent" };
-    if (action === "project-sync-merge")
-        return { action: "project-sync", mode: "merge" };
-    if (action === "diagnose-host")
-        return { action };
-    throw new TypeError("plugin manager action is unavailable for this row");
-}
-function linkedAbort(parent) {
-    const controller = new AbortController();
-    if (parent === undefined)
-        return Object.freeze({ 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) });
-}
-/** Own one fresh controller/component/input set per command presentation. */
-export function createPluginManagerSession(input) {
-    let bound;
-    let activeController;
-    let activeManagerComponent;
-    let activeRunner;
-    let activeClose;
-    let activeOperationAbort;
-    let activeOperationReloadSafe = false;
-    let activeOperationPresenter;
-    let presentationDetached = false;
-    let closingReason;
-    let completions = Object.freeze([]);
-    let closed = false;
-    function execute(context, argv, options, signal) {
-        return input.host.runWithPiOperationContext(context, signal, (application) => application.control.runArgv(argv, { mode: "tui", output: "json", sink: options.sink, ...(options.input === undefined ? {} : { input: options.input }) }, signal));
-    }
-    function currentPresenter() {
-        if (activeManagerComponent !== undefined)
-            return activeManagerComponent;
-        return activeOperationPresenter;
-    }
-    function freshRunner(context, options = {}) {
-        const runner = createPluginManagerActionRunner({
-            execute: (argv, executionOptions, signal) => execute(context, argv, { sink: executionOptions.sink, ...(executionOptions.input === undefined ? {} : { input: executionOptions.input }) }, signal),
-            ...(options.input === undefined ? {} : { input: options.input }),
-            handoff: input.handoff,
-            session: { sessionId: context.sessionManager.getSessionId(), cwd: context.cwd },
-            ...(options.onFrame === undefined ? {} : { onFrame: options.onFrame }),
-            ...(options.confirm === true ? {
-                confirm: (confirmation, signal) => {
-                    const presenter = currentPresenter();
-                    if (presenter !== undefined) {
-                        return presenter.presentInline((tui, theme, keybindings, done) => new ConfirmationSurface({
-                            theme,
-                            keybindings,
-                            title: confirmation.title,
-                            lines: confirmation.lines,
-                            height: () => tui.terminal.rows,
-                            done,
-                        })).then((confirmed) => confirmed === true);
-                    }
-                    return presentConfirmationSurface(context, {
-                        title: confirmation.title,
-                        lines: confirmation.lines,
-                    }, signal);
-                },
-            } : {}),
-        });
-        activeRunner = runner;
-        return runner;
-    }
-    async function replaceActive(reason = "new") {
-        const close = activeClose;
-        const controller = activeController;
-        const runner = activeRunner;
-        const operationAbort = activeOperationAbort;
-        const operationReloadSafe = activeOperationReloadSafe;
-        // Revoke all session-bound handles before awaiting any cleanup. A failing
-        // predecessor must not leave a second callback reachable during teardown.
-        activeClose = undefined;
-        activeController = undefined;
-        activeRunner = undefined;
-        activeOperationAbort = undefined;
-        await cleanupSequentially([
-            () => close?.(),
-            () => {
-                if (controller !== undefined)
-                    completions = controller.dynamicCompletions();
-            },
-            () => controller?.close(reason),
-            () => runner?.close(reason),
-            () => {
-                if (operationAbort !== undefined && !(reason === "reload" && operationReloadSafe)) {
-                    operationAbort.abort(new DOMException("plugin presentation replaced", "AbortError"));
-                }
-            },
-        ], "plugin presentation replacement cleanup failed");
-    }
-    // Pi's own ui.select/ui.input cannot receive keystrokes while a custom
-    // component owns the keyboard, so interactive prompts inside the manager
-    // are presented inline like every other manager surface.
-    async function promptChoice(context, title, labels) {
-        const manager = activeManagerComponent;
-        if (manager === undefined) {
-            const selected = await context.ui.select(title, [...labels]);
-            const index = selected === undefined ? -1 : labels.findIndex((label) => label === selected);
-            return index < 0 ? undefined : index;
-        }
-        return manager.presentInline((tui, theme, keybindings, done) => {
-            let index = 0;
-            const component = {
-                invalidate() { },
-                render: () => [
-                    theme.fg("accent", theme.bold(title)),
-                    "",
-                    ...labels.map((label, candidate) => candidate === index ? theme.bg("selectedBg", `→ ${label}`) : `  ${label}`),
-                    "",
-                    theme.fg("muted", "up/down choose · enter continue · escape cancel"),
-                ],
-                handleInput(data) {
-                    if (keybindings.matches(data, "tui.select.up"))
-                        index = (index - 1 + labels.length) % labels.length;
-                    else if (keybindings.matches(data, "tui.select.down"))
-                        index = (index + 1) % labels.length;
-                    else if (keybindings.matches(data, "tui.select.confirm") || matchesKey(data, Key.enter))
-                        return done(index);
-                    else if (keybindings.matches(data, "tui.select.cancel") || keybindings.matches(data, "app.interrupt") || matchesKey(data, Key.escape))
-                        return done();
-                    manager.invalidate();
-                    tui.requestRender();
-                },
-            };
-            return component;
-        });
-    }
-    async function promptText(context, label, description) {
-        const manager = activeManagerComponent;
-        if (manager === undefined)
-            return context.ui.input(label, description);
-        return manager.presentInline((tui, theme, keybindings, done) => new TextInputSurface({
-            theme,
-            keybindings,
-            label,
-            ...(description === undefined ? {} : { description }),
-            done: (value) => done(value),
-        }));
-    }
-    async function confirmInline(context, title, lines) {
-        const presenter = currentPresenter();
-        if (presenter !== undefined) {
-            const confirmed = await presenter.presentInline((tui, theme, keybindings, done) => new ConfirmationSurface({
-                theme,
-                keybindings,
-                title,
-                lines,
-                height: () => tui.terminal.rows,
-                done,
-            }));
-            return confirmed === true;
-        }
-        return presentConfirmationSurface(context, { title, lines }, new AbortController().signal);
-    }
-    /** One policy change, including the exact consent-preview round trip enabling automatic updates requires. */
-    async function runPolicySet(context, change) {
-        const signal = new AbortController().signal;
-        const run = (argv) => input.host.runWithPiOperationContext(context, signal, (application) => application.control.runArgv(argv, { mode: "tui", output: "json" }, signal));
-        let report = await run(updatePolicySetCommand(change));
-        const preview = NativeUpdatePolicyPreviewResultSchema.safeParse(report.envelope.data);
-        if (preview.success) {
-            if (preview.data.kind === "rejected") {
-                context.ui.notify(`Update policy change was rejected (${preview.data.code.toLowerCase().replaceAll("_", " ")}).`, "warning");
-                return "failed";
-            }
-            const consent = preview.data.preview.consent;
-            if (!consent.required || consent.consentId === undefined) {
-                // Unreachable today (the facade only previews when consent is
-                // required and always binds its id); fail loudly if that changes.
-                context.ui.notify("Update policy preview did not match the public facade contract.", "error");
-                return "failed";
-            }
-            const audience = consent.disclosure === "global-current-and-future" ? "every current and future plugin"
-                : consent.disclosure === "scope-current-and-future" ? "current and future plugins in this scope"
-                    : "the current target";
-            const approved = await confirmInline(context, change.policyKind === "application" && change.policyMode === "automatic" ? "Turn on automatic updates?" : "Change update policy?", [
-                `Applies to ${audience}.`,
-                "Eligible updates install without asking each time; trust, configuration, and health checks still run.",
-            ]);
-            if (!approved)
-                return "cancelled";
-            report = await run(updatePolicySetCommand(change, { previewId: preview.data.preview.previewId, consentId: consent.consentId }));
-        }
-        const applied = NativeUpdatePolicyApplyResultSchema.safeParse(report.envelope.data);
-        if (!applied.success) {
-            context.ui.notify("Update policy response did not match the public facade contract.", "error");
-            return "failed";
-        }
-        if (applied.data.kind === "changed" || applied.data.kind === "unchanged")
-            return "applied";
-        if (applied.data.kind === "stale")
-            context.ui.notify("Things changed while setting update policy — try again.", "warning");
-        else if (applied.data.kind === "rejected")
-            context.ui.notify(`Update policy change was rejected (${applied.data.code.toLowerCase().replaceAll("_", " ")}).`, "warning");
-        else
-            context.ui.notify("Update policy change could not complete.", "warning");
-        return "failed";
-    }
-    async function runUpdatePolicyFlow(context) {
-        const signal = new AbortController().signal;
-        let current;
-        try {
-            const report = await input.host.runWithPiOperationContext(context, signal, (application) => application.control.runArgv(updateStatusCommand(), { mode: "tui", output: "json" }, signal));
-            const status = NativeUpdateStatusSchema.safeParse(report.envelope.data);
-            if (status.success)
-                current = status.data.policy.global;
-        }
-        catch { /* an unreadable current policy must not block choosing a new one */ }
-        const modeIndex = await promptChoice(context, `Automatic updates (currently ${current === undefined ? "unknown" : current.application === "automatic" ? "on" : "off"})`, ["On — install eligible updates automatically", "Off — tell me about updates, I'll apply them"]);
-        if (modeIndex === undefined)
-            return Object.freeze({ kind: "cancelled" });
-        const mode = modeIndex === 0 ? "automatic" : "manual";
-        let cadence;
-        if (mode === "automatic") {
-            const cadences = [
-                { value: "balanced", label: "Every 6 hours (balanced)" },
-                { value: "conservative", label: "Once a day (conservative)" },
-                { value: "frequent", label: "Every hour (frequent)" },
-                { value: "paused", label: "Never check (paused)" },
-            ];
-            const cadenceIndex = await promptChoice(context, `How often should Pi check? (currently ${current?.cadence ?? "unknown"})`, cadences.map((entry) => entry.label));
-            if (cadenceIndex === undefined)
-                return Object.freeze({ kind: "cancelled" });
-            cadence = cadences[cadenceIndex].value;
-        }
-        try {
-            if (current?.application !== mode) {
-                const result = await runPolicySet(context, { policyKind: "application", policyMode: mode });
-                if (result === "cancelled")
-                    return Object.freeze({ kind: "cancelled" });
-                if (result === "failed")
-                    return Object.freeze({ kind: "handled", presentation: "local" });
-            }
-            if (cadence !== undefined && current?.cadence !== cadence) {
-                const result = await runPolicySet(context, { policyKind: "cadence", cadence });
-                if (result === "failed")
-                    return Object.freeze({ kind: "handled", presentation: "local" });
-            }
-        }
-        catch {
-            context.ui.notify("Update policy change could not complete.", "error");
-            return Object.freeze({ kind: "handled", presentation: "local" });
-        }
-        context.ui.notify(mode === "automatic" ? `Automatic updates on · ${cadence ?? current?.cadence ?? ""}` : "Automatic updates off — you'll be notified about updates instead", "info");
-        return Object.freeze({ kind: "handled", presentation: "local" });
-    }
-    async function chooseInstallScope(context, manager, scopes) {
-        const labels = scopes.map((scope) => scope === "project" ? "Current project" : "User account");
-        const index = await promptChoice(context, "Add plugin to", labels);
-        return index === undefined ? undefined : scopes[index];
-    }
-    async function runInstallFlow(context, managerState) {
-        let row = selectedRow(managerState);
-        let detail = NativeInspectionDetailResultSchema.safeParse(managerState.detail.envelope?.data);
-        const manager = activeManagerComponent;
-        if (row === undefined || !detail.success || detail.data.kind !== "found")
-            return Object.freeze({ kind: "cancelled" });
-        if (row.availableScopes !== undefined && row.availableScopes.length > 1) {
-            const scope = await chooseInstallScope(context, manager, row.availableScopes);
-            if (scope === undefined)
-                return Object.freeze({ kind: "cancelled" });
-            if (scope !== row.scope) {
-                const scopedRow = Object.freeze({ ...row, scope });
-                const argv = detailCommand(scopedRow);
-                if (argv === undefined)
-                    return Object.freeze({ kind: "cancelled" });
-                const signal = new AbortController().signal;
-                const report = await input.host.runWithPiOperationContext(context, signal, (application) => application.control.runArgv(argv, { mode: "tui", output: "json" }, signal));
-                detail = NativeInspectionDetailResultSchema.safeParse(report.envelope.data);
-                if (!detail.success || detail.data.kind !== "found")
-                    return Object.freeze({ kind: "cancelled" });
-                row = scopedRow;
-            }
-        }
-        const candidateDetail = detail.data.detail;
-        let state = createPluginInstallState(candidateDetail);
-        let component;
-        let currentRunner;
-        let result = Object.freeze({ kind: "cancelled" });
-        const present = manager === undefined ? context.ui.custom.bind(context.ui) : manager.presentInline.bind(manager);
-        await present((tui, theme, keybindings, done) => {
-            const apply = (event) => {
-                state = pluginInstallReducer(state, event);
-                component?.update(state);
-                manager?.invalidate();
-                tui.requestRender();
-            };
-            const phaseFailure = (error) => {
-                if (closingReason === "reload" || closed)
-                    return;
-                try {
-                    apply({ type: "busy", value: false });
-                }
-                catch { /* stale component state is already detached */ }
-                safeNotify(context, error instanceof DOMException && error.name === "AbortError"
-                    ? "Install cancellation is waiting for owner truth."
-                    : "Install flow could not complete.", "warning");
-            };
-            const runPhase = async (phase) => {
-                if (state.busy)
-                    return;
-                let port;
-                let runner;
-                try {
-                    apply({ type: "busy", value: true });
-                    port = phase === "open"
-                        ? undefined
-                        : createPiControlInputPort({ context, mode: "tui", preset: { nonSensitive: state.values, ...(state.consentId === undefined ? {} : { consentId: state.consentId }) }, present: currentPresenter });
-                    runner = freshRunner(context, {
-                        ...(port === undefined ? {} : { input: port }),
-                        onFrame: (frame) => {
-                            if (presentationDetached)
-                                return;
-                            try {
-                                apply({ type: "frame", frame });
-                            }
-                            catch (error) {
-                                phaseFailure(error);
-                            }
-                        },
-                    });
-                    currentRunner = runner;
-                    if (phase === "open") {
-                        const phaseResult = await runner.run({
-                            action: "install-open",
-                            row,
-                            snapshotId: candidateDetail.snapshotId,
-                            detailId: candidateDetail.summary.detailId,
-                        });
-                        if (phaseResult.kind === "cancelled") {
-                            apply({ type: "busy", value: false });
-                            return;
-                        }
-                        const opened = TrustedInstallOpenResultSchema.safeParse(phaseResult.envelope.data);
-                        if (!opened.success || opened.data.kind !== "opened") {
-                            safeNotify(context, "Install candidate evidence changed; review the refreshed candidate before continuing.", "warning");
-                            // Leave the flow so the manager can refresh authority behind it;
-                            // retrying with the same stale evidence would loop.
-                            result = Object.freeze({ kind: "handled", presentation: "local" });
-                            done();
-                            return;
-                        }
-                        apply({ type: "session-opened", session: opened.data.session });
-                        return;
-                    }
-                    const session = state.session;
-                    if (session === undefined || state.consentId !== session.consent.consentId) {
-                        apply({ type: "busy", value: false });
-                        return;
-                    }
-                    const phaseResult = await runner.run({ action: "install-apply", token: session.token });
-                    if (phaseResult.kind === "cancelled") {
-                        apply({ type: "busy", value: false });
-                        return;
-                    }
-                    if (phaseResult.presentation === "successor") {
-                        result = Object.freeze({ kind: "handled", presentation: "successor" });
-                        // Reload teardown already closed the predecessor custom component.
-                        // Calling its done callback here would reuse stale Pi/TUI state.
-                        return;
-                    }
-                    const activation = TrustedInstallActivationResultSchema.safeParse(phaseResult.envelope.data);
-                    if (!activation.success) {
-                        apply({ type: "busy", value: false });
-                        const diagnostic = phaseResult.envelope.diagnostics[0]?.code;
-                        safeNotify(context, `Install result did not match the public facade contract (${phaseResult.envelope.status}${diagnostic === undefined ? "" : ` · ${diagnostic}`}).`, "error");
-                        return;
-                    }
-                    if (activation.data.kind === "needs-input") {
-                        apply({ type: "session-opened", session: activation.data.session, submission: "apply" });
-                        safeNotify(context, "Configuration or exact consent needs renewed input.", "warning");
-                        return;
-                    }
-                    result = Object.freeze({ kind: "handled", presentation: "local" });
-                    if (activation.data.kind === "succeeded") {
-                        const components = activation.data.components;
-                        const inventory = [
-                            `${components.skills} skill${components.skills === 1 ? "" : "s"}`,
-                            `${components.hooks} hook${components.hooks === 1 ? "" : "s"}`,
-                            `${components.mcpServers} MCP server${components.mcpServers === 1 ? "" : "s"}`,
-                        ].join(", ");
-                        safeNotify(context, `Added ${activation.data.plugin} — ${inventory} ready to use`, "info");
-                        if (candidateDetail.compatibility.components.foreign.some((component) => component.nativeKind.text === "pi-extension")) {
-                            safeNotify(context, `Heads up: ${activation.data.plugin} also ships a Pi extension (tools/commands), which this host doesn't run — those won't register. Install it pi-natively to use them.`, "warning");
-                        }
-                    }
-                    else if (activation.data.kind === "current-state") {
-                        safeNotify(context, `${activation.data.plugin} is already added`, "info");
-                    }
-                    else if (activation.data.kind === "degraded") {
-                        safeNotify(context, `Added ${activation.data.plugin}, but it is degraded — repair or rollback it from /plugins → Health.`, "warning");
-                    }
-                    else if (activation.data.kind === "cancelled") {
-                        safeNotify(context, "Add cancelled — nothing was installed.", "warning");
-                    }
-                    else if (activation.data.kind === "rejected") {
-                        safeNotify(context, `Adding was rejected — ${plainLifecycleFailure(activation.data.code)}.`, "error");
-                    }
-                    else {
-                        safeNotify(context, "Things changed while installing — press a to try again.", "warning");
-                    }
-                    done();
-                }
-                catch (error) {
-                    phaseFailure(error);
-                }
-                finally {
-                    try {
-                        port?.dispose();
-                    }
-                    catch (error) {
-                        reportOperationalFailure("install input cleanup", error);
-                        phaseFailure(error);
-                    }
-                    try {
-                        runner?.close(closingReason ?? "quit");
-                    }
-                    catch (error) {
-                        reportOperationalFailure("install runner cleanup", error);
-                        phaseFailure(error);
-                    }
-                    if (currentRunner === runner)
-                        currentRunner = undefined;
-                    if (activeRunner === runner)
-                        activeRunner = undefined;
-                }
-            };
-            const action = (event) => {
-                if (event.type === "cancel") {
-                    currentRunner?.cancel();
-                    return;
-                }
-                if (event.type === "edit-field") {
-                    // Non-sensitive values edit in place inside the component; only the
-                    // sensitive path routes here because secrets never enter flow state.
-                    if (event.sensitive) {
-                        context.ui.notify("Sensitive values stay out of flow state and are collected in masked custody only when Apply begins.", "info");
-                    }
-                    return;
-                }
-                if (event.type === "back") {
-                    if (state.busy)
-                        return;
-                    if (state.step === "activation-result") {
-                        result = Object.freeze({ kind: "handled", presentation: "local" });
-                    }
-                    else {
-                        // The flattened flow has no review screen to fall back to; Back
-                        // from configuration exits the flow like Back from the open step.
-                        result = Object.freeze({ kind: "cancelled" });
-                    }
-                    done();
-                    return;
-                }
-                if (state.step === "activation-result") {
-                    const activation = state.result;
-                    result = Object.freeze({ kind: "handled", presentation: "local" });
-                    done();
-                }
-                else
-                    void runPhase(state.step === "choose-inspect" ? "open" : state.submission).catch(phaseFailure);
-            };
-            component = new PluginInstallComponent({ state, theme, keybindings, height: () => manager === undefined ? tui.terminal.rows : Math.max(4, tui.terminal.rows - 3), onEvent: apply, onAction: action });
-            if (manager === undefined)
-                activeClose = () => done();
-            // The candidate was already reviewed in the manager detail pane; open
-            // the install session immediately instead of staging a review screen.
-            queueMicrotask(() => {
-                try {
-                    action({ type: "continue" });
-                }
-                catch (error) {
-                    phaseFailure(error);
-                }
-            });
-            return component;
-        });
-        if (manager === undefined)
-            activeClose = undefined;
-        try {
-            currentRunner?.close(closingReason ?? "quit");
-        }
-        catch (error) {
-            reportOperationalFailure("install flow cleanup", error);
-            safeNotify(context, "Install flow cleanup could not complete.", "warning");
-        }
-        return result;
-    }
-    async function open(context) {
-        if (closed)
-            return;
-        await replaceActive("new");
-        let controller;
-        const read = (argv, signal) => input.host.runWithPiOperationContext(context, signal, (application) => application.control.runArgv(argv, { mode: "tui", output: "json" }, signal));
-        const actions = {
-            async run(action, state) {
-                if (action === "install")
-                    return runInstallFlow(context, state);
-                if (action === "update-policy")
-                    return runUpdatePolicyFlow(context);
-                let resolvedIntent;
-                if (action === "marketplace-add") {
-                    const sourceKinds = ["github", "git", "local-git"];
-                    const typeIndex = await promptChoice(context, "Marketplace type", ["GitHub repository", "Git URL", "Local Git checkout"]);
-                    if (typeIndex === undefined)
-                        return Object.freeze({ kind: "cancelled", presentation: "local" });
-                    const sourceKind = sourceKinds[typeIndex];
-                    const placeholder = sourceKind === "github" ? "owner/repository" : sourceKind === "git" ? "https://example.com/plugins.git" : "/path/to/plugins";
-                    const source = await promptText(context, "Marketplace location", placeholder);
-                    if (source === undefined || source.trim().length === 0)
-                        return Object.freeze({ kind: "cancelled", presentation: "local" });
-                    const ref = await promptText(context, "Git ref (optional)", "branch, tag, or commit; leave empty for default");
-                    if (ref === undefined)
-                        return Object.freeze({ kind: "cancelled", presentation: "local" });
-                    resolvedIntent = { action: "marketplace-add", source: source.trim(), sourceKind, ...(ref.trim().length === 0 ? {} : { ref: ref.trim() }) };
-                }
-                else
-                    resolvedIntent = actionIntent(action, state);
-                const port = createPiControlInputPort({ context, mode: "tui", present: currentPresenter });
-                const runner = freshRunner(context, {
-                    input: port,
-                    confirm: true,
-                    onFrame: (frame) => {
-                        if (!presentationDetached)
-                            controller.observe({ type: "frame", frame });
-                    },
-                });
-                try {
-                    const result = await runner.run(resolvedIntent);
-                    if (resolvedIntent.action === "update-all" && result.kind === "completed") {
-                        await offerDeferredReload(context, result.envelope, (title, lines) => confirmInline(context, title, lines));
-                    }
-                    return result;
-                }
-                finally {
-                    port.dispose();
-                    runner.close(closingReason ?? "quit");
-                    if (activeRunner === runner)
-                        activeRunner = undefined;
-                }
-            },
-            cancel() { activeRunner?.cancel(); },
-        };
-        controller = createPluginManagerController({ execute: read, actions });
-        activeController = controller;
-        // Mount first: facade reads may touch several local stores and should never
-        // leave a command invocation looking frozen. The reducer publishes loading
-        // state synchronously and authoritative results replace it in place.
-        void controller.refresh("all");
-        try {
-            await context.ui.custom((tui, theme, keybindings, done) => {
-                const component = new PluginManagerComponent({ tui, theme, keybindings, controller, done });
-                activeManagerComponent = component;
-                activeClose = () => component.requestClose();
-                return component;
-            });
-            activeClose = undefined;
-        }
-        catch {
-            if (!presentationDetached)
-                context.ui.notify("Plugin manager terminal rendering failed; facade state is unchanged.", "error");
-        }
-        finally {
-            if (activeController === controller) {
-                completions = controller.dynamicCompletions();
-                await controller.close(closingReason ?? "quit");
-                activeController = undefined;
-            }
-            activeManagerComponent = undefined;
-            activeClose = undefined;
-        }
-    }
-    async function presentStaticOperation(context, envelope, frames, title = "Plugin operation") {
-        if (context.mode !== "tui" || closed)
-            return;
-        await replaceActive("new");
-        try {
-            await context.ui.custom((tui, theme, keybindings, done) => {
-                const view = new PluginOperationView({ theme, keybindings, height: () => tui.terminal.rows, title, cancel: () => { }, close: () => done() });
-                for (const frame of frames)
-                    view.push(frame);
-                view.finish(envelope);
-                activeClose = () => done();
-                return view;
-            });
-        }
-        catch {
-            if (!presentationDetached)
-                context.ui.notify(`Plugin operation ${envelope.status}; custom renderer unavailable.`, envelope.exit.code === 0 ? "info" : "error");
-        }
-        finally {
-            activeClose = undefined;
-        }
-    }
-    async function presentOperation(context, operation) {
-        if (closed)
-            return;
-        await replaceActive("new");
-        const linked = linkedAbort(operation.signal);
-        activeOperationAbort = linked.controller;
-        activeOperationReloadSafe = operation.reloadSafe;
-        presentationDetached = false;
-        let task;
-        let failure;
-        try {
-            await context.ui.custom((tui, theme, keybindings, done) => {
-                const view = new PluginOperationView({
-                    theme,
-                    keybindings,
-                    height: () => tui.terminal.rows,
-                    cancel: () => linked.controller.abort(new DOMException("plugin command cancelled", "AbortError")),
-                    close: () => done(),
-                    tui,
-                });
-                activeOperationPresenter = Object.freeze({ presentInline: (factory) => view.presentInline(factory) });
-                activeClose = () => done();
-                task = Promise.resolve().then(async () => {
-                    const sink = createPiManagerFrameSink({
-                        onFrame: (frame) => {
-                            if (presentationDetached)
-                                return;
-                            view.push(frame);
-                            tui.requestRender();
-                        },
-                    });
-                    try {
-                        const report = await operation.run(sink, linked.controller.signal);
-                        const presentation = operation.settle(report);
-                        if (presentationDetached || presentation === "successor") {
-                            // session_shutdown already closed the predecessor view. No Pi/TUI
-                            // callback remains valid once the successor owns presentation.
-                            return;
-                        }
-                        view.finish(report.envelope);
-                        tui.requestRender();
-                    }
-                    catch (error) {
-                        failure = error;
-                        done();
-                    }
-                });
-                return view;
-            });
-            await task;
-            if (failure !== undefined)
-                throw failure;
-        }
-        finally {
-            linked.dispose();
-            if (activeOperationAbort === linked.controller)
-                activeOperationAbort = undefined;
-            activeOperationReloadSafe = false;
-            activeOperationPresenter = undefined;
-            activeClose = undefined;
-        }
-    }
-    const session = {
-        bind(context) {
-            closed = false;
-            closingReason = undefined;
-            presentationDetached = false;
-            bound = Object.freeze({ sessionId: context.sessionManager.getSessionId(), cwd: context.cwd });
-        },
-        open,
-        presentOperation,
-        async presentReport(context, report, frames) {
-            await presentStaticOperation(context, report.envelope, frames);
-        },
-        async presentHandoff(context, destination, envelope) {
-            const current = bound;
-            if (current === undefined || current.sessionId !== context.sessionManager.getSessionId() || current.cwd !== context.cwd)
-                return;
-            // A handoff across a reload is always one plain notification, never a
-            // result screen: the reload itself is the visible effect, and /plugins
-            // shows authoritative state and any needed action.
-            if (context.mode !== "tui" || closed)
-                return;
-            if (envelope.status === "ok" || envelope.status === "no-change") {
-                const line = destination === "install-result"
-                    ? handoffInstallSummary(envelope)
-                    : `✓ ${nativeControlHumanLines(envelope)[0] ?? "Plugin operation completed"}`;
-                context.ui.notify(line, "info");
-                return;
-            }
-            const summary = nativeControlHumanLines(envelope)[0];
-            context.ui.notify(`Plugin operation needs attention${summary === undefined ? "" : ` — ${summary}`} · open /plugins for details`, "warning");
-        },
-        dynamicCompletions() {
-            return activeController?.dynamicCompletions() ?? completions;
-        },
-        inlinePresenter() {
-            return currentPresenter();
-        },
-        async close(reason) {
-            if (closed && activeController === undefined && activeClose === undefined && activeRunner === undefined && activeOperationAbort === undefined)
-                return;
-            closed = true;
-            closingReason = reason;
-            presentationDetached = true;
-            const close = activeClose;
-            const runner = activeRunner;
-            const operationAbort = activeOperationAbort;
-            const operationReloadSafe = activeOperationReloadSafe;
-            const controller = activeController;
-            // Revoke stale presentation handles before any await. Cleanup is
-            // best-effort per resource, but every failure remains observable in the
-            // aggregate returned to Pi's host-owned shutdown boundary.
-            activeClose = undefined;
-            activeRunner = undefined;
-            activeOperationAbort = undefined;
-            activeController = undefined;
-            bound = undefined;
-            if (reason !== "reload")
-                completions = Object.freeze([]);
-            await cleanupSequentially([
-                () => close?.(),
-                () => runner?.close(reason),
-                () => {
-                    if (operationAbort !== undefined && !(reason === "reload" && operationReloadSafe)) {
-                        operationAbort.abort(new DOMException("plugin presentation closed", "AbortError"));
-                    }
-                },
-                () => {
-                    if (controller !== undefined && reason === "reload")
-                        completions = controller.dynamicCompletions();
-                },
-                () => controller?.close(reason),
-            ], "plugin presentation cleanup failed");
-        },
-    };
-    return Object.freeze(session);
-}
-//# sourceMappingURL=plugin-manager-session.js.map