@timurproko/a1 0.1.8-dev.de7821a → 0.2.0

package/dist/integrations/pi/engine/workflow-runner.js

@@ -0,0 +1,536 @@
+import { mkdir, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { dirname, join } from "node:path";
+import { PRODUCT_IDENTITY } from "../../../product-identity.js";
+import { isRecord, readModel, readThinkingLevel, requireCapability, stringProperty } from "./message-values.js";
+import { AUTH_REFRESH_TIMEOUT_MS, commandMissing, errorMessage, findExactWorkflowModel, isAbortError, pathArgument, pinnedHotkeySummary, pinnedSessionInfoPresentation, shareCommandFailureDetail, shareViewerUrl, workflowConfirmation, workflowResult, } from "./workflow-support.js";
+import { PiProviderAuthentication } from "./provider-authentication.js";
+/** How many workflows and engine commands may be admitted together before new work is rejected. */
+const MAX_PENDING_WORK = 32;
+/**
+ * Pinned Pi's slash-command workflows, run against the adapter's current session and runtime
+ * through ports. The runner owns workflow admission (the pending set and its cancellation), the
+ * clipboard writer the owned UI binds, provider authentication, and the per-command result
+ * wording; the adapter decides what the session is, how the view is published, and when work is
+ * refused, and the contexts collaborator supplies selector state.
+ */
+export class PiWorkflowRunner {
+    #agentDir;
+    #host;
+    #authentication;
+    #ports;
+    #pending = new Set();
+    #clipboardWriter;
+    constructor(options, ports) {
+        this.#agentDir = options.agentDir;
+        this.#host = options.host;
+        this.#ports = ports;
+        this.#authentication = new PiProviderAuthentication({ agentDir: options.agentDir, contexts: options.contexts }, {
+            runtime: () => ports.runtime(),
+            requireSession: () => this.#requireSession(),
+            disposed: () => ports.disposed(),
+            sessionGeneration: () => ports.sessionGeneration(),
+            interaction: () => ports.interaction(),
+            setActiveModel: model => { ports.setActiveModel(model); },
+            reconcileActiveModelAvailability: () => { ports.reconcileActiveModelAvailability(); },
+            emitView: () => { ports.emitView(); },
+        });
+    }
+    /** Workflows admitted and not yet settled. */
+    get pendingCount() {
+        return this.#pending.size;
+    }
+    /** Resolve every admitted workflow as cancelled, except the named command. */
+    cancelPending(except) {
+        for (const pending of this.#pending)
+            if (pending.command !== except)
+                pending.cancel();
+    }
+    #requireSession() {
+        const session = this.#ports.session();
+        if (this.#ports.disposed() || !this.#ports.runtime() || !session)
+            throw new Error("engine adapter is not running");
+        return session;
+    }
+    async cycleModelWorkflow(direction) {
+        try {
+            const session = this.#requireSession();
+            const result = await requireCapability(session.cycleModel, "cycleModel").call(session, direction);
+            if (!isRecord(result) || !isRecord(result.model)) {
+                const scoped = Array.isArray(session.scopedModels) && session.scopedModels.length > 0;
+                return workflowResult("model", "completed", scoped ? "Only one model in scope" : "Only one model available", undefined, "status");
+            }
+            const model = readModel(result.model);
+            if (model)
+                this.#ports.setActiveModel(model);
+            if (result.thinkingLevel !== undefined)
+                this.#ports.setThinkingLevel(readThinkingLevel(result.thinkingLevel));
+            this.#ports.emitView();
+            const modelName = stringProperty(result.model, "name") ?? stringProperty(result.model, "id") ?? "model";
+            const reasoning = result.model.reasoning === true;
+            const thinking = this.#ports.thinkingLevel();
+            const suffix = reasoning && thinking !== "off" ? ` (thinking: ${thinking})` : "";
+            return workflowResult("model", "completed", `Switched to ${modelName}${suffix}`, undefined, "status");
+        }
+        catch (error) {
+            return workflowResult("model", "failed", error instanceof Error ? error.message : String(error));
+        }
+    }
+    /** Bind the owned UI's clipboard lifecycle without changing the comparison host. True means acknowledged delivery. */
+    bindClipboardWriter(writer) {
+        const previous = this.#clipboardWriter;
+        this.#clipboardWriter = writer;
+        return () => { if (this.#clipboardWriter === writer)
+            this.#clipboardWriter = previous; };
+    }
+    /** Workflow and tree copying share the active owner's write fence and delivery acknowledgment. */
+    async copyWorkflowText(text) {
+        if (this.#clipboardWriter !== undefined)
+            return this.#clipboardWriter(text);
+        await this.#host.copyText(text);
+        return true;
+    }
+    abortBashWorkflow() {
+        this.#requireSession().abortBash?.();
+    }
+    async executeBashWorkflow(command, excludeFromContext) {
+        const session = this.#requireSession();
+        const result = await requireCapability(session.executeBash, "executeBash").call(session, command, undefined, { excludeFromContext });
+        if (!isRecord(result))
+            throw new Error("Pi bash workflow returned a malformed result");
+        return {
+            command,
+            output: typeof result.output === "string" ? result.output : "",
+            exitCode: typeof result.exitCode === "number" ? result.exitCode : undefined,
+            cancelled: result.cancelled === true,
+            truncated: result.truncated === true,
+            excludeFromContext,
+        };
+    }
+    reloadBlockedResult() {
+        const session = this.#requireSession();
+        if (session.isStreaming)
+            return workflowResult("reload", "failed", "Wait for the current response to finish before reloading.", undefined, "warning");
+        if (session.isCompacting)
+            return workflowResult("reload", "failed", "Wait for compaction to finish before reloading.", undefined, "warning");
+        return null;
+    }
+    async executeWorkflow(request) {
+        const cancelled = workflowResult(request.command, "cancelled", "", undefined, "silent");
+        if (this.#ports.admissionStopped() || this.#ports.pendingCommandCount() + this.#pending.size >= MAX_PENDING_WORK)
+            return cancelled;
+        let cancel;
+        const cancellation = new Promise(resolve => { cancel = () => resolve(cancelled); });
+        const pending = { command: request.command, cancel };
+        this.#pending.add(pending);
+        this.#ports.beginRunning();
+        const operation = this.#runWorkflow(request).finally(() => { this.#ports.endRunning(); });
+        try {
+            return await Promise.race([operation, cancellation]);
+        }
+        finally {
+            this.#pending.delete(pending);
+        }
+    }
+    async #runWorkflow(request) {
+        try {
+            return await this.#performWorkflow(request);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            const contextualMessage = request.command === "export"
+                ? `Failed to export session: ${errorMessage(error, "Unknown error")}`
+                : request.command === "import"
+                    ? `Failed to import session: ${message}`
+                    : request.command === "new"
+                        ? `Failed to create session: ${message}`
+                        : request.command === "resume"
+                            ? `Failed to resume session: ${message}`
+                            : request.command === "reload" ? `Reload failed: ${message}` : message;
+            return workflowResult(request.command, "failed", contextualMessage);
+        }
+    }
+    async #selectModel(request, reference, options) {
+        const session = this.#requireSession();
+        const runtime = this.#ports.runtime();
+        if (!runtime)
+            throw new Error("engine runtime is unavailable");
+        let model = findExactWorkflowModel(reference, options.pool);
+        const messages = [];
+        const generation = this.#ports.sessionGeneration();
+        const current = () => !this.#ports.disposed() && generation === this.#ports.sessionGeneration();
+        const publish = (message) => {
+            if (!current())
+                return;
+            const interaction = this.#ports.interaction();
+            if (interaction.publish)
+                interaction.publish(message);
+            else
+                messages.push(message);
+        };
+        if (model === undefined && options.refreshOnMiss) {
+            publish({ kind: "status", message: "Refreshing model catalogs…" });
+            const controller = new AbortController();
+            let timedOut = false;
+            const timeout = setTimeout(() => {
+                timedOut = true;
+                controller.abort();
+            }, AUTH_REFRESH_TIMEOUT_MS);
+            try {
+                const refreshed = await runtime.services.modelRuntime.refresh?.({ signal: controller.signal });
+                if (isRecord(refreshed) && refreshed.aborted === true && timedOut) {
+                    publish({ kind: "warning", message: "Model refresh timed out; searching cached models." });
+                }
+                else if (isRecord(refreshed) && refreshed.errors instanceof Map && refreshed.errors.size > 0) {
+                    publish({ kind: "warning", message: `Could not refresh ${[...refreshed.errors.keys()].join(", ")}; searching cached models.` });
+                }
+            }
+            catch (error) {
+                publish({
+                    kind: "warning",
+                    message: timedOut
+                        ? "Model refresh timed out; searching cached models."
+                        : `Could not refresh model catalogs: ${error instanceof Error ? error.message : String(error)}`,
+                });
+            }
+            finally {
+                clearTimeout(timeout);
+            }
+            model = findExactWorkflowModel(reference, [...(runtime.services.modelRuntime.getAvailableSnapshot?.() ?? [])]);
+        }
+        if (!current())
+            return workflowResult(request.command, "cancelled", "Model selection cancelled", undefined, "silent");
+        if (model === undefined) {
+            if (options.onMiss === "failed") {
+                const failure = { kind: "error", message: `Model not found: ${reference}` };
+                return workflowResult(request.command, "failed", failure.message, undefined, "error", messages.length === 0 ? undefined : [...messages, failure]);
+            }
+            return {
+                ...workflowResult(request.command, "requires-selection", "Select a model", reference, "silent"),
+                ...(messages.length === 0 ? {} : { messages: Object.freeze(messages) }),
+            };
+        }
+        try {
+            await session.setModel(model, { persist: options.persist });
+        }
+        catch (error) {
+            if (!current())
+                return workflowResult(request.command, "cancelled", "Model selection cancelled", undefined, "silent");
+            const failure = { kind: "error", message: error instanceof Error ? error.message : String(error) };
+            return workflowResult(request.command, "failed", failure.message, undefined, "error", messages.length === 0 ? undefined : [...messages, failure]);
+        }
+        if (!current())
+            return workflowResult(request.command, "cancelled", "Model selection cancelled", undefined, "silent");
+        const providerId = stringProperty(model, "provider") ?? "unknown";
+        const modelId = stringProperty(model, "id") ?? reference;
+        this.#ports.setActiveModel({ providerId, modelId, displayName: stringProperty(model, "name") ?? modelId });
+        this.#ports.emitView();
+        const resultMessage = { kind: "status", message: options.persist ? `Default model: ${providerId}/${modelId}` : `Model: ${modelId}` };
+        return messages.length === 0
+            ? workflowResult(request.command, "completed", resultMessage.message)
+            : workflowResult(request.command, "completed", resultMessage.message, undefined, "status", [...messages, resultMessage]);
+    }
+    async #performWorkflow(request) {
+        const session = this.#requireSession();
+        const runtime = this.#ports.runtime();
+        if (!runtime)
+            throw new Error("engine runtime is unavailable");
+        const argument = request.argument.trim();
+        const selected = request.selection?.trim();
+        const selection = selected && selected.length > 0 ? selected : undefined;
+        switch (request.command) {
+            case "settings": {
+                if (!selection)
+                    return workflowResult(request.command, "failed", "Settings requires the owned settings controller");
+                return await this.#ports.applyPinnedSetting(selection);
+            }
+            case "thinking": {
+                const requested = (selection ?? argument).trim();
+                if (!requested)
+                    return workflowResult(request.command, "requires-selection", "Select a thinking level", undefined, "silent");
+                const available = (session.getAvailableThinkingLevels?.() ?? []).map(String);
+                // Compatibility: pinned Pi matches the argument case-insensitively and words the failure with the available levels.
+                const level = available.find(candidate => candidate.toLowerCase() === requested.toLowerCase());
+                if (level === undefined) {
+                    return workflowResult(request.command, "failed", `Unknown thinking level "${requested}". Available levels: ${available.join(", ")}.`);
+                }
+                try {
+                    session.setThinkingLevel(readThinkingLevel(level), { persist: request.persist === true });
+                }
+                catch (error) {
+                    return workflowResult(request.command, "failed", error instanceof Error ? error.message : String(error));
+                }
+                this.#ports.setThinkingLevel(readThinkingLevel(session.thinkingLevel));
+                this.#ports.emitView();
+                return workflowResult(request.command, "completed", request.persist === true ? `Default thinking level: ${level}` : `Thinking level: ${level}`);
+            }
+            case "model": {
+                const reference = selection ?? argument;
+                if (!reference)
+                    return workflowResult(request.command, "failed", "Model requires the owned model controller");
+                const scopedModels = Array.isArray(session.scopedModels)
+                    ? session.scopedModels.map(item => item.model)
+                    : [];
+                // Compatibility: pinned Pi searches the session scope when one exists and refreshes catalogs only for an unscoped miss.
+                return this.#selectModel(request, reference, {
+                    pool: scopedModels.length > 0 ? scopedModels : [...(runtime.services.modelRuntime.getAvailableSnapshot?.() ?? [])],
+                    refreshOnMiss: scopedModels.length === 0,
+                    persist: request.persist === true,
+                    onMiss: "requires-selection",
+                });
+            }
+            case "models": {
+                // Invariant: the bare dialog seeds its query from the argument; only an explicit selection switches models.
+                if (!selection)
+                    return workflowResult(request.command, "requires-selection", "Select a model", argument || undefined, "silent");
+                return this.#selectModel(request, selection, {
+                    pool: [...(runtime.services.modelRuntime.getAvailableSnapshot?.() ?? [])],
+                    refreshOnMiss: true,
+                    persist: true,
+                    onMiss: "failed",
+                });
+            }
+            case "scoped-models": {
+                if (!selection)
+                    return workflowResult(request.command, "failed", "Scoped models requires the owned scoped-model controller");
+                const [providerId, modelId] = selection.split("/", 2);
+                const model = providerId && modelId ? runtime.services.modelRuntime.getModel(providerId, modelId) : undefined;
+                if (!model)
+                    return workflowResult(request.command, "failed", `Model is unavailable: ${selection}`);
+                requireCapability(session.setScopedModels, "setScopedModels").call(session, [{ model }]);
+                return workflowResult(request.command, "completed", `Enabled scoped model ${selection}`);
+            }
+            case "export": {
+                const path = pathArgument(argument);
+                const file = path?.toLowerCase().endsWith(".jsonl")
+                    ? requireCapability(session.exportToJsonl, "exportToJsonl").call(session, path)
+                    : await requireCapability(session.exportToHtml, "exportToHtml").call(session, path);
+                return workflowResult(request.command, "completed", `Session exported to: ${String(file)}`);
+            }
+            case "import": {
+                const path = pathArgument(argument);
+                if (!path)
+                    return workflowResult(request.command, "failed", "Usage: /import <path.jsonl>");
+                if (request.confirmed === undefined) {
+                    return workflowConfirmation(request.command, `Replace current session with ${path}?`);
+                }
+                if (!request.confirmed)
+                    return workflowResult(request.command, "cancelled", "Import cancelled", undefined, "status");
+                try {
+                    const result = await requireCapability(runtime.importFromJsonl, "importFromJsonl").call(runtime, path, request.cwdOverride);
+                    if (isRecord(result) && result.cancelled === true)
+                        return workflowResult(request.command, "cancelled", "Import cancelled", undefined, "status");
+                    return workflowResult(request.command, "completed", `Session imported from: ${path}`);
+                }
+                catch (error) {
+                    const issue = isRecord(error) && isRecord(error.issue) ? error.issue : undefined;
+                    const fallbackCwd = issue === undefined ? undefined : stringProperty(issue, "fallbackCwd");
+                    if (fallbackCwd !== undefined && request.cwdOverride === undefined) {
+                        const sessionCwd = stringProperty(issue, "sessionCwd") ?? "the session working directory";
+                        return workflowConfirmation(request.command, `cwd from session file does not exist\n${sessionCwd}\n\ncontinue in current cwd\n${fallbackCwd}`, fallbackCwd);
+                    }
+                    throw error;
+                }
+            }
+            case "share": {
+                const signal = request.signal;
+                if (signal?.aborted)
+                    return workflowResult(request.command, "cancelled", "Share cancelled", undefined, "status");
+                try {
+                    await this.#host.runCommand("gh", ["auth", "status"], signal === undefined ? undefined : { signal });
+                }
+                catch (error) {
+                    if (signal?.aborted || isAbortError(error))
+                        return workflowResult(request.command, "cancelled", "Share cancelled", undefined, "status");
+                    const message = commandMissing(error)
+                        ? "GitHub CLI (gh) is not installed. Install it from https://cli.github.com/"
+                        : "GitHub CLI is not logged in. Run 'gh auth login' first.";
+                    return workflowResult(request.command, "failed", message);
+                }
+                const temporary = join(tmpdir(), `${PRODUCT_IDENTITY.filesystem.temporaryPrefix}pi-session-${process.pid}.html`);
+                try {
+                    try {
+                        await requireCapability(session.exportToHtml, "exportToHtml").call(session, temporary);
+                    }
+                    catch (error) {
+                        return workflowResult(request.command, "failed", `Failed to export session: ${errorMessage(error, "Unknown error")}`);
+                    }
+                    if (signal?.aborted)
+                        return workflowResult(request.command, "cancelled", "Share cancelled", undefined, "status");
+                    let gist;
+                    try {
+                        gist = await this.#host.runCommand("gh", ["gist", "create", "--public=false", temporary], signal === undefined ? undefined : { signal });
+                    }
+                    catch (error) {
+                        if (signal?.aborted || isAbortError(error))
+                            return workflowResult(request.command, "cancelled", "Share cancelled", undefined, "status");
+                        return workflowResult(request.command, "failed", `Failed to create gist: ${shareCommandFailureDetail(error)}`);
+                    }
+                    if (signal?.aborted)
+                        return workflowResult(request.command, "cancelled", "Share cancelled", undefined, "status");
+                    const gistUrl = gist.stdout.trim();
+                    const gistId = gistUrl.split("/").at(-1);
+                    if (!gistId)
+                        return workflowResult(request.command, "failed", "Failed to parse gist ID from gh output");
+                    return workflowResult(request.command, "completed", `Share URL: ${shareViewerUrl(gistId)}`, gistUrl);
+                }
+                finally {
+                    await rm(temporary, { force: true });
+                }
+            }
+            case "copy": {
+                const text = requireCapability(session.getLastAssistantText, "getLastAssistantText").call(session);
+                if (typeof text !== "string" || text.length === 0)
+                    return workflowResult(request.command, "failed", "No agent messages to copy yet.");
+                const acknowledged = await this.copyWorkflowText(text);
+                return workflowResult(request.command, "completed", acknowledged ? "Copied last agent message to clipboard" : "Submitted last agent message to clipboard");
+            }
+            case "name": {
+                const manager = session.sessionManager;
+                if (!argument) {
+                    const current = manager?.getSessionName();
+                    return typeof current === "string"
+                        ? workflowResult(request.command, "completed", `Session name: ${current}`)
+                        : workflowResult(request.command, "failed", "Usage: /name <name>", undefined, "warning");
+                }
+                requireCapability(session.setSessionName, "setSessionName").call(session, argument);
+                const normalized = manager?.getSessionName();
+                const actual = typeof normalized === "string" ? normalized : argument;
+                return workflowResult(request.command, "completed", `Session name set: ${actual}`, actual === argument ? undefined : `Session name was normalized from ${JSON.stringify(argument)} to ${JSON.stringify(actual)}`);
+            }
+            case "session": {
+                const manager = session.sessionManager;
+                const stats = requireCapability(session.getSessionStats, "getSessionStats").call(session);
+                const entries = manager?.getEntries();
+                return {
+                    ...workflowResult(request.command, "completed", "Session Info"),
+                    presentation: pinnedSessionInfoPresentation(stats, manager?.getSessionName(), Array.isArray(entries) ? entries : [], runtime.services.modelRuntime, {
+                        mode: runtime.services.settingsManager?.getCacheWarmingMode?.(),
+                        status: session.cacheWarmingStatus,
+                    }),
+                };
+            }
+            case "changelog": {
+                const changelog = await this.#host.readChangelog();
+                return workflowResult(request.command, "completed", "What's New", changelog);
+            }
+            case "hotkeys":
+                return workflowResult(request.command, "completed", "Keyboard Shortcuts", pinnedHotkeySummary());
+            case "fork": {
+                if (!selection)
+                    return workflowResult(request.command, "failed", "Fork requires the owned user-message controller");
+                const result = await requireCapability(runtime.fork, "fork").call(runtime, selection, { position: "before" });
+                if (isRecord(result) && result.cancelled === true)
+                    return workflowResult(request.command, "cancelled", "Fork cancelled", undefined, "silent");
+                return workflowResult(request.command, "completed", "Forked to new session");
+            }
+            case "clone": {
+                const manager = session.sessionManager;
+                const leaf = manager?.getLeafId?.();
+                if (typeof leaf !== "string")
+                    return workflowResult(request.command, "completed", "Nothing to clone yet", undefined, "status");
+                const result = await requireCapability(runtime.fork, "fork").call(runtime, leaf, { position: "at" });
+                if (isRecord(result) && result.cancelled === true)
+                    return workflowResult(request.command, "cancelled", "Clone cancelled", undefined, "silent");
+                return workflowResult(request.command, "completed", "Cloned to new session");
+            }
+            case "tree": {
+                if (!selection)
+                    return workflowResult(request.command, "failed", "Tree navigation requires the owned tree controller");
+                const navigateTree = requireCapability(session.navigateTree, "navigateTree");
+                const result = request.treeSummary === undefined
+                    ? await navigateTree.call(session, selection)
+                    : await navigateTree.call(session, selection, {
+                        summarize: request.treeSummary.summarize,
+                        ...(request.treeSummary.customInstructions === undefined ? {} : { customInstructions: request.treeSummary.customInstructions }),
+                    });
+                if (isRecord(result) && result.aborted === true)
+                    return workflowResult(request.command, "cancelled", "Branch summarization cancelled", undefined, "status");
+                if (isRecord(result) && result.cancelled === true)
+                    return workflowResult(request.command, "cancelled", "Navigation cancelled", undefined, "status");
+                return workflowResult(request.command, "completed", "Navigated to selected point");
+            }
+            case "trust": {
+                if (!selection)
+                    return workflowResult(request.command, "failed", "Trust requires the owned trust controller");
+                requireCapability(runtime.services.settingsManager?.setProjectTrusted, "setProjectTrusted").call(runtime.services.settingsManager, selection === "trust");
+                return workflowResult(request.command, "completed", selection === "trust" ? "Project trusted" : "Project trust removed");
+            }
+            case "login":
+                return await this.#authentication.login(request, session, runtime, argument, selection);
+            case "logout":
+                if (!selection)
+                    return workflowResult(request.command, "failed", "Logout requires the owned authentication controller");
+                return await this.#authentication.logout(request, runtime, selection);
+            case "new": {
+                const result = await runtime.newSession();
+                if (isRecord(result) && result.cancelled === true)
+                    return workflowResult(request.command, "cancelled", "New session cancelled", undefined, "silent");
+                return workflowResult(request.command, "completed", "✓ New session started", undefined, "accent");
+            }
+            case "compact": {
+                try {
+                    await session.compact(argument || undefined);
+                    return workflowResult(request.command, "completed", "Compaction requested", undefined, "silent");
+                }
+                catch (error) {
+                    return workflowResult(request.command, "failed", error instanceof Error ? error.message : String(error), undefined, "silent");
+                }
+            }
+            case "resume": {
+                if (!selection && !argument)
+                    return workflowResult(request.command, "failed", "Resume requires the owned session controller");
+                const sessionPath = selection ?? argument;
+                try {
+                    const result = await runtime.switchSession(sessionPath);
+                    if (isRecord(result) && result.cancelled === true)
+                        return workflowResult(request.command, "cancelled", "Resume cancelled", undefined, "silent");
+                    return workflowResult(request.command, "completed", "Resumed session");
+                }
+                catch (error) {
+                    const issue = isRecord(error) && isRecord(error.issue) ? error.issue : undefined;
+                    const fallbackCwd = issue === undefined ? undefined : stringProperty(issue, "fallbackCwd");
+                    if (fallbackCwd === undefined)
+                        throw error;
+                    if (request.confirmed === undefined) {
+                        const sessionCwd = stringProperty(issue, "sessionCwd") ?? "the session working directory";
+                        return workflowConfirmation(request.command, `cwd from session file does not exist\n${sessionCwd}\n\ncontinue in current cwd\n${fallbackCwd}`);
+                    }
+                    if (!request.confirmed)
+                        return workflowResult(request.command, "cancelled", "Resume cancelled", undefined, "status");
+                    const result = await runtime.switchSession(sessionPath, { cwdOverride: fallbackCwd });
+                    if (isRecord(result) && result.cancelled === true)
+                        return workflowResult(request.command, "cancelled", "Resume cancelled", undefined, "silent");
+                    return workflowResult(request.command, "completed", "Resumed session in current cwd");
+                }
+            }
+            case "reload": {
+                const blocked = this.reloadBlockedResult();
+                if (blocked)
+                    return blocked;
+                await requireCapability(session.reload, "reload").call(session);
+                await this.#ports.bindExtensionUiToSession();
+                const message = "Reloaded keybindings, extensions, skills, prompts, themes, and context files";
+                const modelError = runtime.services.modelRuntime.getError?.();
+                return workflowResult(request.command, "completed", message, undefined, "status", modelError ? [
+                    { kind: "error", message: `models.json error: ${modelError}` },
+                    { kind: "status", message },
+                ] : undefined);
+            }
+            case "quit": {
+                await this.#ports.dispose();
+                return workflowResult(request.command, "completed", "Shutdown complete");
+            }
+            case "debug": {
+                const debugPath = join(this.#agentDir, "pi-debug.log");
+                await mkdir(dirname(debugPath), { recursive: true });
+                await writeFile(debugPath, `${JSON.stringify(this.#ports.snapshot(), null, 2)}\n`, "utf8");
+                return workflowResult(request.command, "completed", "✓ Debug log written", debugPath);
+            }
+            case "arminsayshi":
+                return workflowResult(request.command, "completed", "Armin says hi");
+            case "dementedelves":
+                return workflowResult(request.command, "completed", "Demented elves announcement");
+        }
+    }
+}

package/dist/integrations/pi/engine/workflow-support.d.ts

@@ -0,0 +1,38 @@
+import { type AgentSessionServices } from "../startup-public.js";
+import type { PiScopedModelDescriptor, PiSessionInfoPresentation, PiWorkflowHost, PiWorkflowLoginNotification, PiWorkflowMessage, PiWorkflowOption, PiWorkflowRequest, PiWorkflowResult } from "./workflows.js";
+type PiServicesApi = AgentSessionServices;
+export declare const AUTH_REFRESH_TIMEOUT_MS = 15000;
+export declare const PINNED_DEFAULT_MODEL_BY_PROVIDER: Readonly<Record<string, string>>;
+export declare function pinnedSessionInfoPresentation(value: unknown, sessionName: string | undefined, entries: readonly unknown[], modelRuntime: PiServicesApi["modelRuntime"], cacheWarming: {
+    readonly mode: unknown;
+    readonly status: unknown;
+}): PiSessionInfoPresentation;
+/** The engine reports warming as a mode plus, once it has acted, the decision that produced the state. */
+export declare function pinnedCacheWarming(mode: unknown, status: unknown): PiSessionInfoPresentation["cacheWarming"];
+export declare function pinnedUsageCostBreakdown(entries: readonly unknown[]): PiSessionInfoPresentation["usageBreakdown"];
+export declare function pinnedCacheWaste(entries: readonly unknown[], modelRuntime: PiServicesApi["modelRuntime"]): PiSessionInfoPresentation["cacheWaste"];
+export declare function defaultWorkflowHost(): PiWorkflowHost;
+export declare function workflowLoginNotification(event: unknown): PiWorkflowLoginNotification | undefined;
+export declare function workflowResult(command: PiWorkflowRequest["command"], outcome: PiWorkflowResult["outcome"], message: string, detail?: string, messageKind?: PiWorkflowResult["messageKind"], messages?: readonly PiWorkflowMessage[]): PiWorkflowResult;
+export declare function workflowConfirmation(command: PiWorkflowRequest["command"], message: string, detail?: string): PiWorkflowResult;
+export declare function errorMessage(error: unknown, fallback: string): string;
+export declare function shareCommandFailureDetail(error: unknown): string;
+export declare function commandMissing(error: unknown): boolean;
+export declare function isAbortError(error: unknown): boolean;
+export declare function shareViewerUrl(gistId: string): string;
+export declare function workflowOptions(value: unknown, idKey: string, labelKey: string): readonly PiWorkflowOption[];
+export declare function sessionInfoOptions(value: readonly unknown[]): readonly PiWorkflowOption[];
+export declare function pathArgument(value: string): string | undefined;
+export declare function pinnedHotkeySummary(): string;
+export declare function scopedModelRecords(modelRuntime: PiServicesApi["modelRuntime"]): readonly {
+    readonly descriptor: PiScopedModelDescriptor;
+    readonly model: ReturnType<PiServicesApi["modelRuntime"]["getAvailableSnapshot"]>[number];
+}[];
+export declare function scopedModelReference(value: unknown): string | undefined;
+export declare function resolveConfiguredModelIds(patterns: readonly string[], models: readonly {
+    readonly descriptor: PiScopedModelDescriptor;
+}[]): readonly string[];
+export declare function wildcardMatcher(pattern: string): RegExp;
+export declare function isUnknownModel(value: unknown): boolean;
+export declare function findExactWorkflowModel<T>(reference: string, models: readonly T[]): T | undefined;
+export {};