ralph-flow-pi 0.1.0

package/dist/pi/adapter.js

@@ -0,0 +1,231 @@
+/**
+ * Anti-corruption layer over the Pi SDK.
+ *
+ * This is the ONLY file in the package allowed to import @earendil-works/*.
+ * Pi is on 0.x with a fast release cadence (244 releases by v0.80.7), so the
+ * blast radius of an API change has to stay inside these ~250 lines: everything
+ * else talks to the narrow interfaces below and to our own normalized event
+ * type, never to Pi's.
+ *
+ * Upgrade drill: bump the pinned version → fix this file → run the adapter
+ * contract tests → run the CHECK smoke (`ralph _check-once`).
+ */
+import fs from "fs";
+import path from "path";
+import { createAgentSession, defineTool, DefaultResourceLoader, ModelRuntime, getAgentDir, resolveCliModel, SessionManager, SettingsManager, CURRENT_SESSION_VERSION, loadSkillsFromDir, VERSION as PI_VERSION, } from "@earendil-works/pi-coding-agent";
+export { defineTool, loadSkillsFromDir, CURRENT_SESSION_VERSION };
+/** Pi's read-only built-in tool set. Deliberately excludes bash: the verifier's
+ *  only shell access is our whitelisted check_bash custom tool. This matches the
+ *  Claude version's `--allowedTools "Read(*) Glob(*) Grep(*) …"` allow-list. */
+export const READ_ONLY_TOOL_NAMES = ["read", "grep", "find", "ls"];
+/** Full coding tool set for DO steps. */
+export const CODING_TOOL_NAMES = ["read", "bash", "edit", "write", "grep", "find", "ls"];
+function textOf(content) {
+    if (!Array.isArray(content))
+        return "";
+    return content
+        .filter((c) => c && c.type === "text" && typeof c.text === "string")
+        .map((c) => c.text)
+        .join("\n");
+}
+/** Translate one Pi event into zero or one of ours. */
+function normalize(event) {
+    const e = event;
+    switch (e.type) {
+        case "message_update": {
+            const inner = e.assistantMessageEvent;
+            if (!inner)
+                return null;
+            if (inner.type === "text_delta" && typeof inner.delta === "string")
+                return { type: "text", delta: inner.delta };
+            if (inner.type === "thinking_delta" && typeof inner.delta === "string")
+                return { type: "reasoning", delta: inner.delta };
+            return null;
+        }
+        case "tool_execution_start":
+            return { type: "tool_start", toolCallId: String(e.toolCallId ?? ""), toolName: String(e.toolName ?? ""), args: e.args };
+        case "tool_execution_end":
+            return {
+                type: "tool_end",
+                toolCallId: String(e.toolCallId ?? ""),
+                toolName: String(e.toolName ?? ""),
+                isError: !!e.isError,
+                text: textOf(e.result?.content),
+            };
+        case "turn_end":
+            return { type: "turn_end" };
+        case "agent_end":
+            // willRetry means Pi is auto-retrying a provider error — the turn is not
+            // actually over, so don't wake the runner's keep-alive on it.
+            return e.willRetry ? null : { type: "agent_end" };
+        case "compaction_end":
+            return e.aborted ? null : { type: "compaction_end" };
+        default:
+            return null;
+    }
+}
+function wrap(session, jsonlPath) {
+    let disposed = false;
+    return {
+        jsonlPath,
+        async prompt(text) {
+            await session.prompt(text);
+        },
+        async followUp(text) {
+            await session.followUp(text);
+        },
+        async steer(text) {
+            await session.steer(text);
+        },
+        subscribe(listener) {
+            return session.subscribe((event) => {
+                const normalized = normalize(event);
+                if (normalized)
+                    listener(normalized);
+            });
+        },
+        async abort() {
+            try {
+                await session.abort();
+            }
+            catch { }
+        },
+        dispose() {
+            if (disposed)
+                return;
+            disposed = true;
+            try {
+                session.dispose();
+            }
+            catch { }
+        },
+    };
+}
+let sharedRuntime = null;
+async function getRuntime() {
+    if (!sharedRuntime) {
+        sharedRuntime = await ModelRuntime.create();
+    }
+    return sharedRuntime;
+}
+/**
+ * Resolve a "provider/model" or "provider/model:thinking" string.
+ *
+ * This is where adversarial_check.model gets its cross-provider superpower for
+ * free: pi-ai resolves any provider, so a workflow can verify Claude's work with
+ * GPT without the engine knowing anything about either.
+ *
+ * Returns `{ error }` rather than throwing — callers fall back to the session's
+ * default model, matching the plugin versions' "unresolvable model falls back"
+ * behavior.
+ */
+export async function resolveModel(spec) {
+    const trimmed = String(spec || "").trim();
+    if (!trimmed)
+        return { model: undefined, error: "empty model spec" };
+    try {
+        const modelRuntime = await getRuntime();
+        const result = resolveCliModel({ cliModel: trimmed, modelRuntime });
+        return {
+            model: result.model,
+            thinkingLevel: result.thinkingLevel,
+            warning: result.warning ?? undefined,
+            error: result.error ?? undefined,
+        };
+    }
+    catch (e) {
+        return { model: undefined, error: e?.message || String(e) };
+    }
+}
+/** The existing transcript in a session dir, if any. */
+export function findSessionFile(sessionDir) {
+    try {
+        const files = fs.readdirSync(sessionDir).filter((f) => f.endsWith(".jsonl")).sort();
+        // Newest wins if a dir somehow holds several (Pi's names sort chronologically).
+        return files.length > 0 ? path.join(sessionDir, files[files.length - 1]) : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function build(options) {
+    const { cwd, model, thinkingLevel, tools, customTools, systemPrompt, appendSystemPrompt, sessionDir, disableCompaction, noExtensions, skillPaths, noSkills, } = options;
+    // Pi's `tools` option is an allowlist over ALL tools, custom ones included
+    // (sdk.js: `initialActiveToolNames = options.tools ? [...options.tools] : …`).
+    // Registering a custom tool without naming it here leaves it inactive — which
+    // for the check session would mean a verifier that can never submit a verdict,
+    // and would look like a permanent infra failure rather than a wiring bug.
+    const activeTools = [...tools, ...(customTools ?? []).map((t) => t.name)];
+    const resourceLoader = new DefaultResourceLoader({
+        cwd,
+        agentDir: getAgentDir(),
+        // The verifier must not inherit the user's pi extensions: an extension can
+        // register arbitrary tools, and a write tool smuggled into the check session
+        // would break the read-only guarantee this whole design rests on.
+        ...(noExtensions ? { noExtensions: true } : {}),
+        ...(noSkills ? { noSkills: true } : {}),
+        ...(skillPaths && skillPaths.length > 0 ? { additionalSkillPaths: skillPaths } : {}),
+        ...(systemPrompt !== undefined ? { systemPromptOverride: () => systemPrompt } : {}),
+        ...(appendSystemPrompt !== undefined
+            ? { appendSystemPromptOverride: (base) => [...base, appendSystemPrompt] }
+            : {}),
+    });
+    await resourceLoader.reload();
+    let sessionManager;
+    if (sessionDir) {
+        fs.mkdirSync(sessionDir, { recursive: true });
+        const existing = findSessionFile(sessionDir);
+        sessionManager = existing
+            ? SessionManager.open(existing, sessionDir, cwd)
+            : SessionManager.create(cwd, sessionDir);
+    }
+    else {
+        sessionManager = SessionManager.inMemory(cwd);
+    }
+    const settingsManager = disableCompaction
+        ? SettingsManager.inMemory({ compaction: { enabled: false } })
+        : undefined;
+    const { session } = await createAgentSession({
+        cwd,
+        agentDir: getAgentDir(),
+        ...(model ? { model: model } : {}),
+        ...(thinkingLevel ? { thinkingLevel: thinkingLevel } : {}),
+        tools: activeTools,
+        ...(customTools ? { customTools } : {}),
+        resourceLoader,
+        sessionManager,
+        ...(settingsManager ? { settingsManager } : {}),
+    });
+    // Resolved only after creation: Pi names the file lazily.
+    const resolvedPath = (() => {
+        try {
+            return sessionManager.getSessionFile() ?? null;
+        }
+        catch {
+            return null;
+        }
+    })();
+    return wrap(session, resolvedPath);
+}
+/** A DO step session: full coding tools, persisted, fresh context per step. */
+export async function createStepSession(options) {
+    return build({ ...options, tools: options.tools ?? CODING_TOOL_NAMES });
+}
+/**
+ * A CHECK session: read-only built-ins only.
+ *
+ * The read-only guarantee is structural, not prompted — `edit`/`write`/`bash`
+ * are simply not in the tool set, so the verifier cannot mutate the workspace it
+ * is judging even if the model decides it wants to.
+ */
+export async function createCheckSession(options) {
+    // noSkills: the verifier's job is to judge against the check criteria, not to
+    // follow a playbook. Skills describe how to BUILD things; handing them to the
+    // checker invites it to sympathize with the implementation it is grading.
+    return build({ ...options, tools: READ_ONLY_TOOL_NAMES, noExtensions: true, noSkills: true });
+}
+/** The pinned Pi version, surfaced for diagnostics. */
+export function piVersion() {
+    return PI_VERSION;
+}
+//# sourceMappingURL=adapter.js.map

package/dist/pi/adapter.js.map

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

package/dist/pi/interactive.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Booting pi's InteractiveMode, kept behind the anti-corruption layer with the
+ * rest of the SDK contact (see adapter.ts).
+ *
+ * The assembly mirrors what pi's own `main.ts` does, minus every CLI concern we
+ * don't have (flag parsing, --api-key, model scopes, print/rpc modes):
+ *
+ *   services  ← createAgentSessionServices, carrying our inline extension
+ *   session   ← createAgentSessionFromServices
+ *   runtime   ← createAgentSessionRuntime
+ *   UI        ← new InteractiveMode(runtime).run()
+ *
+ * The extension is passed as an `extensionFactories` entry, which is how pi
+ * loads in-process extensions — the same door its own bundled ones come through.
+ */
+export interface BootInteractiveOptions {
+    cwd: string;
+    /** An inline extension: `{ name, factory(api) }`. */
+    extension: unknown;
+    /** If set, sent as the first message on startup (used to seed the create flow). */
+    initialMessage?: string;
+    /** Receives the main session's id once it exists. */
+    onSessionId(id: string): void;
+    /** Run on SIGINT / normal exit, before the process goes away. */
+    onShutdown(): void;
+}
+export declare function bootInteractive(options: BootInteractiveOptions): Promise<void>;
+//# sourceMappingURL=interactive.d.ts.map

package/dist/pi/interactive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.d.ts","sourceRoot":"","sources":["../../src/pi/interactive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,qDAAqD;IACrD,SAAS,EAAE,OAAO,CAAC;IACnB,mFAAmF;IACnF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,iEAAiE;IACjE,UAAU,IAAI,IAAI,CAAC;CACpB;AAED,wBAAsB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0CpF"}

package/dist/pi/interactive.js

@@ -0,0 +1,58 @@
+/**
+ * Booting pi's InteractiveMode, kept behind the anti-corruption layer with the
+ * rest of the SDK contact (see adapter.ts).
+ *
+ * The assembly mirrors what pi's own `main.ts` does, minus every CLI concern we
+ * don't have (flag parsing, --api-key, model scopes, print/rpc modes):
+ *
+ *   services  ← createAgentSessionServices, carrying our inline extension
+ *   session   ← createAgentSessionFromServices
+ *   runtime   ← createAgentSessionRuntime
+ *   UI        ← new InteractiveMode(runtime).run()
+ *
+ * The extension is passed as an `extensionFactories` entry, which is how pi
+ * loads in-process extensions — the same door its own bundled ones come through.
+ */
+import { createAgentSessionFromServices, createAgentSessionRuntime, createAgentSessionServices, getAgentDir, InteractiveMode, SessionManager, } from "@earendil-works/pi-coding-agent";
+export async function bootInteractive(options) {
+    const { cwd, extension, initialMessage, onSessionId, onShutdown } = options;
+    const agentDir = getAgentDir();
+    const sessionManager = SessionManager.create(cwd);
+    const runtime = await createAgentSessionRuntime(async ({ cwd: runtimeCwd, agentDir: runtimeAgentDir, sessionManager: sm, sessionStartEvent }) => {
+        const services = await createAgentSessionServices({
+            cwd: runtimeCwd,
+            agentDir: runtimeAgentDir,
+            resourceLoaderOptions: {
+                extensionFactories: [extension],
+            },
+        });
+        const created = await createAgentSessionFromServices({ services, sessionManager: sm, sessionStartEvent });
+        return { ...created, services, diagnostics: [...services.diagnostics] };
+    }, { cwd, agentDir, sessionManager });
+    onSessionId(sessionManager.getSessionId());
+    // Interrupted instances must be parked before we die, or their next run would
+    // see a live-looking state with a dead pid and have to guess. Registered
+    // before the UI starts so a crash during startup is still covered.
+    let shuttingDown = false;
+    const shutdown = () => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        try {
+            onShutdown();
+        }
+        catch { }
+    };
+    process.on("exit", shutdown);
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    const interactive = new InteractiveMode(runtime, initialMessage ? { initialMessage } : undefined);
+    try {
+        await interactive.init();
+        await interactive.run();
+    }
+    finally {
+        shutdown();
+    }
+}
+//# sourceMappingURL=interactive.js.map

package/dist/pi/interactive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interactive.js","sourceRoot":"","sources":["../../src/pi/interactive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,8BAA8B,EAC9B,yBAAyB,EACzB,0BAA0B,EAC1B,WAAW,EACX,eAAe,EACf,cAAc,GACf,MAAM,iCAAiC,CAAC;AAczC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAA+B;IACnE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,cAAc,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAC5E,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,MAAM,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAElD,MAAM,OAAO,GAAG,MAAM,yBAAyB,CAC7C,KAAK,EAAE,EAAE,GAAG,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,EAAE,cAAc,EAAE,EAAE,EAAE,iBAAiB,EAAE,EAAE,EAAE;QAC9F,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC;YAChD,GAAG,EAAE,UAAU;YACf,QAAQ,EAAE,eAAe;YACzB,qBAAqB,EAAE;gBACrB,kBAAkB,EAAE,CAAC,SAAgB,CAAC;aACvC;SACF,CAAC,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,8BAA8B,CAAC,EAAE,QAAQ,EAAE,cAAc,EAAE,EAAE,EAAE,iBAAiB,EAAE,CAAC,CAAC;QAC1G,OAAO,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,GAAG,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;IAC1E,CAAC,EACD,EAAE,GAAG,EAAE,QAAQ,EAAE,cAAc,EAAE,CAClC,CAAC;IAEF,WAAW,CAAC,cAAc,CAAC,YAAY,EAAE,CAAC,CAAC;IAE3C,8EAA8E;IAC9E,yEAAyE;IACzE,mEAAmE;IACnE,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,IAAI,YAAY;YAAE,OAAO;QACzB,YAAY,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC;YAAC,UAAU,EAAE,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IAChC,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEhC,MAAM,WAAW,GAAG,IAAI,eAAe,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAClG,IAAI,CAAC;QACH,MAAM,WAAW,CAAC,IAAI,EAAE,CAAC;QACzB,MAAM,WAAW,CAAC,GAAG,EAAE,CAAC;IAC1B,CAAC;YAAS,CAAC;QACT,QAAQ,EAAE,CAAC;IACb,CAAC;AACH,CAAC"}

package/dist/pi/tui.d.ts

@@ -0,0 +1,12 @@
+/**
+ * The single point of contact with pi-tui and pi's theme module.
+ *
+ * Same anti-corruption discipline as adapter.ts: pi-tui is on the same fast 0.x
+ * cadence as the SDK, so every `@earendil-works/pi-tui` and theme import lives
+ * here and the run view talks only to these re-exports. A pi-tui API change is a
+ * one-file fix.
+ */
+export { TUI, Container, Text, Markdown, SelectList, Input, ProcessTerminal, matchesKey, parseKey, Key, type Component, type SelectItem, type SelectListTheme, type Terminal, type EditorTheme, } from "@earendil-works/pi-tui";
+export { visibleWidth, wrapTextWithAnsi, truncateToWidth, } from "@earendil-works/pi-tui";
+export { initTheme, getSelectListTheme, getMarkdownTheme, CustomEditor, Theme, type KeybindingsManager, type ThemeColor, } from "@earendil-works/pi-coding-agent";
+//# sourceMappingURL=tui.d.ts.map

package/dist/pi/tui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../src/pi/tui.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,GAAG,EACH,SAAS,EACT,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,KAAK,EACL,eAAe,EACf,UAAU,EACV,QAAQ,EACR,GAAG,EACH,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,QAAQ,EACb,KAAK,WAAW,GACjB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,KAAK,EACL,KAAK,kBAAkB,EACvB,KAAK,UAAU,GAChB,MAAM,iCAAiC,CAAC"}

package/dist/pi/tui.js

@@ -0,0 +1,12 @@
+/**
+ * The single point of contact with pi-tui and pi's theme module.
+ *
+ * Same anti-corruption discipline as adapter.ts: pi-tui is on the same fast 0.x
+ * cadence as the SDK, so every `@earendil-works/pi-tui` and theme import lives
+ * here and the run view talks only to these re-exports. A pi-tui API change is a
+ * one-file fix.
+ */
+export { TUI, Container, Text, Markdown, SelectList, Input, ProcessTerminal, matchesKey, parseKey, Key, } from "@earendil-works/pi-tui";
+export { visibleWidth, wrapTextWithAnsi, truncateToWidth, } from "@earendil-works/pi-tui";
+export { initTheme, getSelectListTheme, getMarkdownTheme, CustomEditor, Theme, } from "@earendil-works/pi-coding-agent";
+//# sourceMappingURL=tui.js.map

package/dist/pi/tui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.js","sourceRoot":"","sources":["../../src/pi/tui.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,GAAG,EACH,SAAS,EACT,IAAI,EACJ,QAAQ,EACR,UAAU,EACV,KAAK,EACL,eAAe,EACf,UAAU,EACV,QAAQ,EACR,GAAG,GAMJ,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,SAAS,EACT,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,KAAK,GAGN,MAAM,iCAAiC,CAAC"}

package/dist/tui/app.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The chat surface — `ralphflow`'s default entry point.
+ *
+ * A general chat, same as talking to Claude Code: starting/watching a workflow
+ * is one of the things you can ask it to do (natural language or a
+ * /ralphflow-* command), not a separate forced-first mode. When a workflow is
+ * actually running, ralphflow_start/continue/watch (commands/tools.ts) borrow
+ * this SAME chat session's TUI via Pi's `ctx.ui.custom()` and hand it to the
+ * dedicated run view (tui/run-app.ts's runInstanceInTui) for the duration of
+ * the run — see tui/embed.ts. Detaching (Esc) hands the terminal straight
+ * back to this chat, mid-conversation, workflow still running in the
+ * background. Designing a NEW workflow (/ralphflow-create) is also just a
+ * conversation in this same surface, seeded with a different opening message.
+ *
+ * It reuses pi's InteractiveMode with our inline extension (the seven
+ * ralphflow_* tools + eight slash commands).
+ */
+/** Launch the chat surface. `seed`, if given, is sent as the first message. */
+export declare function runChat(cwd: string, seed?: string): Promise<void>;
+/**
+ * `ralphflow create [描述]` — drop into the chat already pointed at the
+ * create flow, so the user lands in a workflow-design conversation.
+ */
+export declare function runCreateMode(cwd: string, description: string): Promise<void>;
+//# sourceMappingURL=app.d.ts.map

package/dist/tui/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/tui/app.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,+EAA+E;AAC/E,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBvE;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGnF"}

package/dist/tui/app.js

@@ -0,0 +1,47 @@
+/**
+ * The chat surface — `ralphflow`'s default entry point.
+ *
+ * A general chat, same as talking to Claude Code: starting/watching a workflow
+ * is one of the things you can ask it to do (natural language or a
+ * /ralphflow-* command), not a separate forced-first mode. When a workflow is
+ * actually running, ralphflow_start/continue/watch (commands/tools.ts) borrow
+ * this SAME chat session's TUI via Pi's `ctx.ui.custom()` and hand it to the
+ * dedicated run view (tui/run-app.ts's runInstanceInTui) for the duration of
+ * the run — see tui/embed.ts. Detaching (Esc) hands the terminal straight
+ * back to this chat, mid-conversation, workflow still running in the
+ * background. Designing a NEW workflow (/ralphflow-create) is also just a
+ * conversation in this same surface, seeded with a different opening message.
+ *
+ * It reuses pi's InteractiveMode with our inline extension (the seven
+ * ralphflow_* tools + eight slash commands).
+ */
+import { createEngine } from "../engine/core.js";
+import { abortActiveCheck } from "../engine/check.js";
+import { createRalphExtension } from "./extension.js";
+import { bootInteractive } from "../pi/interactive.js";
+/** Launch the chat surface. `seed`, if given, is sent as the first message. */
+export async function runChat(cwd, seed) {
+    const engine = createEngine(cwd, { abortActiveCheck });
+    engine.ensureProjectWorkflows();
+    // The main session's id is the ownership token in every instance's state.json.
+    // It only exists once pi has built the session, so the extension reads it
+    // lazily rather than capturing it at construction.
+    let sessionId = "";
+    const ralph = createRalphExtension(engine, () => sessionId);
+    await bootInteractive({
+        cwd,
+        extension: ralph.extension,
+        initialMessage: seed,
+        onSessionId: (id) => { sessionId = id; },
+        onShutdown: () => ralph.shutdown(),
+    });
+}
+/**
+ * `ralphflow create [描述]` — drop into the chat already pointed at the
+ * create flow, so the user lands in a workflow-design conversation.
+ */
+export async function runCreateMode(cwd, description) {
+    const seed = `我想创建一个新的工作流。${description ? `需求：${description}` : ""}\n\n请用 /ralphflow-create 的流程带我设计：先了解要自动化的流程和人工审查点，再设计步骤图给我看，然后写 YAML 并用 ralphflow_doctor 校验到干净。`;
+    await runChat(cwd, seed);
+}
+//# sourceMappingURL=app.js.map

package/dist/tui/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/tui/app.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,IAAa;IACtD,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,EAAE,EAAE,gBAAgB,EAAE,CAAC,CAAC;IACvD,MAAM,CAAC,sBAAsB,EAAE,CAAC;IAEhC,+EAA+E;IAC/E,0EAA0E;IAC1E,mDAAmD;IACnD,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,MAAM,KAAK,GAAG,oBAAoB,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAE5D,MAAM,eAAe,CAAC;QACpB,GAAG;QACH,SAAS,EAAE,KAAK,CAAC,SAAS;QAC1B,cAAc,EAAE,IAAI;QACpB,WAAW,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,SAAS,GAAG,EAAE,CAAC,CAAC,CAAC;QACxC,UAAU,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE;KACnC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,GAAW,EAAE,WAAmB;IAClE,MAAM,IAAI,GAAG,eAAe,WAAW,CAAC,CAAC,CAAC,MAAM,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,iGAAiG,CAAC;IACpK,MAAM,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AAC3B,CAAC"}

package/dist/tui/embed.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The chat session's "take over the terminal to run a workflow" seam.
+ *
+ * `ralphflow_start`/`ralphflow_continue`/`ralphflow_watch` (commands/tools.ts)
+ * call `attachRunView` once an instance is actively running. It borrows the
+ * SAME `TUI` the chat session already owns (via Pi's `ctx.ui.custom()`) rather
+ * than spawning a second one — save the chat's current root components,
+ * clear, mount the run view, run it to completion/cancellation/detach,
+ * restore the saved components, hand back.
+ *
+ * Verified against a real terminal + real model (see fancy-purring-sparkle.md
+ * step 3): the chat's header/transcript/editor survive a takeover-and-restore
+ * cycle intact, and the model resumes exactly where it left off. The one
+ * subtlety that mattered in that spike: the factory passed to `ui.custom`
+ * must not resolve until AFTER `done()` has been called. `showExtensionCustom`
+ * does `Promise.resolve(factory(...)).then(c => { if (!closed) { editor
+ * Container.clear(); editorContainer.addChild(c); ... } })` the moment the
+ * factory's returned promise settles — if that happened while we're still
+ * mid-takeover, it would clobber the chat's real editor with `undefined`.
+ * Keeping the factory itself pending until we call `done()` (which flips
+ * `closed` to true) makes that branch a no-op.
+ */
+import type { Engine } from "../engine/core.js";
+import type { Runner } from "../engine/runner.js";
+import { type RunInstanceOutcome } from "./run-app.js";
+import type { TUI } from "../pi/tui.js";
+/**
+ * The slice of Pi's extension context this file touches. `custom`'s result is
+ * `T | undefined` to match Pi's real signature (`done` takes an optional
+ * result) — we always call `done(result)` with a real value below, so
+ * `attachRunView` narrows it back to a guaranteed `RunInstanceOutcome` for
+ * its own callers.
+ */
+export interface UiCustomHost {
+    ui: {
+        custom<T>(factory: (tui: TUI, theme: unknown, keybindings: unknown, done: (result?: T) => void) => unknown): Promise<T | undefined>;
+    };
+    /** ExtensionContext.abort — see tools.ts's attachResult for why this, not just `terminate`, is called on detach. */
+    abort?(): void;
+}
+export declare function attachRunView(ctx: UiCustomHost, engine: Engine, runner: Runner, sessionId: string, instId: string): Promise<RunInstanceOutcome>;
+//# sourceMappingURL=embed.d.ts.map

package/dist/tui/embed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../../src/tui/embed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAoB,KAAK,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE;QAAE,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,IAAI,KAAK,OAAO,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA;KAAE,CAAC;IAC5I,oHAAoH;IACpH,KAAK,CAAC,IAAI,IAAI,CAAC;CAChB;AAED,wBAAsB,aAAa,CACjC,GAAG,EAAE,YAAY,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,kBAAkB,CAAC,CAY7B"}

package/dist/tui/embed.js

@@ -0,0 +1,38 @@
+/**
+ * The chat session's "take over the terminal to run a workflow" seam.
+ *
+ * `ralphflow_start`/`ralphflow_continue`/`ralphflow_watch` (commands/tools.ts)
+ * call `attachRunView` once an instance is actively running. It borrows the
+ * SAME `TUI` the chat session already owns (via Pi's `ctx.ui.custom()`) rather
+ * than spawning a second one — save the chat's current root components,
+ * clear, mount the run view, run it to completion/cancellation/detach,
+ * restore the saved components, hand back.
+ *
+ * Verified against a real terminal + real model (see fancy-purring-sparkle.md
+ * step 3): the chat's header/transcript/editor survive a takeover-and-restore
+ * cycle intact, and the model resumes exactly where it left off. The one
+ * subtlety that mattered in that spike: the factory passed to `ui.custom`
+ * must not resolve until AFTER `done()` has been called. `showExtensionCustom`
+ * does `Promise.resolve(factory(...)).then(c => { if (!closed) { editor
+ * Container.clear(); editorContainer.addChild(c); ... } })` the moment the
+ * factory's returned promise settles — if that happened while we're still
+ * mid-takeover, it would clobber the chat's real editor with `undefined`.
+ * Keeping the factory itself pending until we call `done()` (which flips
+ * `closed` to true) makes that branch a no-op.
+ */
+import { runInstanceInTui } from "./run-app.js";
+export async function attachRunView(ctx, engine, runner, sessionId, instId) {
+    const result = await ctx.ui.custom(async (tui, _theme, _keybindings, done) => {
+        const saved = [...tui.children];
+        tui.clear();
+        const outcome = await runInstanceInTui({ engine, tui, sessionId, instId, runner });
+        tui.clear();
+        for (const c of saved)
+            tui.addChild(c);
+        tui.requestRender(true);
+        done(outcome);
+        return undefined; // ignored: `done()` already closed the custom UI
+    });
+    return result ?? { outcome: "detached" };
+}
+//# sourceMappingURL=embed.js.map

package/dist/tui/embed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.js","sourceRoot":"","sources":["../../src/tui/embed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAIH,OAAO,EAAE,gBAAgB,EAA2B,MAAM,cAAc,CAAC;AAgBzE,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,GAAiB,EACjB,MAAc,EACd,MAAc,EACd,SAAiB,EACjB,MAAc;IAEd,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,EAAE,CAAC,MAAM,CAAqB,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE;QAC/F,MAAM,KAAK,GAAG,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;QAChC,GAAG,CAAC,KAAK,EAAE,CAAC;QACZ,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACnF,GAAG,CAAC,KAAK,EAAE,CAAC;QACZ,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QACvC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,CAAC;QACd,OAAO,SAAS,CAAC,CAAC,iDAAiD;IACrE,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,CAAC;AAC3C,CAAC"}

package/dist/tui/extension.d.ts

@@ -0,0 +1,88 @@
+/**
+ * The ralph-flow extension for the main chat session.
+ *
+ * This is the whole TUI. The plan budgeted ~870 lines for a hand-built one
+ * (transcript pane, streaming renderer, slash dispatcher, status bar) — none of
+ * that got written, because pi's InteractiveMode already IS a Claude-Code-style
+ * TUI and its extension API exposes exactly the three seams we need:
+ *
+ *   registerTool     → the six ralphflow_* tools, so the model can drive them
+ *                      from plain language ("start the spec workflow on X")
+ *   registerCommand  → the eight /ralphflow-* slash commands, verbatim
+ *   sendMessage      → the runner's output, rendered into the same transcript
+ *
+ * The important thing this does NOT do: hand pi the workflow. Step sessions are
+ * still created and driven by our runner, one fresh context per step. The main
+ * chat session is a control surface and a viewport — if it were the DO session
+ * we would have rebuilt the opencode plugin's central flaw on a new stack.
+ */
+import type { Engine } from "../engine/core.js";
+import { type Runner } from "../engine/runner.js";
+/**
+ * Pi's extension surface, narrowed to what this file touches.
+ *
+ * Two different objects, easy to conflate (a real crash the first time
+ * around): `ExtensionAPI` — this file's `api`, from `factory(api)` — has
+ * `registerTool`/`registerCommand`/`sendMessage`/`sendUserMessage`/`on`, and
+ * NO `ui`. `ExtensionContext` — a *different* type, handed to every `on(...)`
+ * handler and command/tool `execute()` as a context argument — is where `ui`
+ * (`.custom`, `.setEditorComponent`, …) actually lives. `ui.custom` (used in
+ * tools.ts's attachRunView) is only ever reached via a tool's own `execute()`
+ * receiving that context, never via this top-level `api`.
+ */
+interface PiExtensionApi {
+    registerTool(tool: any): void;
+    registerCommand(name: string, options: {
+        description?: string;
+        handler: (args: string, ctx: any) => Promise<void>;
+    }): void;
+    sendMessage(message: {
+        customType: string;
+        content: string;
+        display?: string;
+        details?: unknown;
+    }, options?: {
+        triggerTurn?: boolean;
+        deliverAs?: "steer" | "followUp" | "nextTurn";
+    }): void;
+    sendUserMessage(content: string, options?: {
+        deliverAs?: "steer" | "followUp";
+    }): void;
+    on(event: string, handler: (event: any, ctx: ExtensionContextLike) => void): void;
+}
+/** Just the corner of ExtensionContext (extensions/types.ts) this file needs. */
+interface ExtensionContextLike {
+    mode: string;
+    ui: {
+        setEditorComponent(factory: ((tui: any, theme: any, keybindings: any) => unknown) | undefined): void;
+        setHeader(factory: ((tui: any, theme: any) => unknown) | undefined): void;
+    };
+}
+export interface RalphExtensionResult {
+    runner: Runner;
+    /** Called on SIGINT/exit so interrupted instances resume cleanly. */
+    shutdown(): void;
+}
+/**
+ * Build the inline extension. `getSessionId` must return the main session's id
+ * — it is the ownership token written into every instance's state.json.
+ */
+export declare function createRalphExtension(engine: Engine, getSessionId: () => string): {
+    extension: {
+        name: string;
+        factory(a: PiExtensionApi): void;
+    };
+    readonly runner: {
+        ensureRunning: (instId: string) => void;
+        reviseGate: (instId: string, instruction: string) => void;
+        sendUserMessage: (instId: string, text: string) => boolean;
+        addEventListener: (l: import("../engine/runner.js").RunnerEvents) => () => void;
+        abortActiveStep: (instId: string) => void;
+        isRunning: (instId: string) => boolean;
+        idle: () => Promise<void>;
+        pauseAllForShutdown: () => void;
+    };
+    shutdown: () => void;
+};
+export {};
+//# sourceMappingURL=extension.d.ts.map

package/dist/tui/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../src/tui/extension.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAOhE;;;;;;;;;;;GAWG;AACH,UAAU,cAAc;IACtB,YAAY,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAAC;IAC9B,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3H,WAAW,CAAC,OAAO,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,UAAU,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7L,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,GAAG,UAAU,CAAA;KAAE,GAAG,IAAI,CAAC;IACvF,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,oBAAoB,KAAK,IAAI,GAAG,IAAI,CAAC;CACnF;AAED,iFAAiF;AACjF,UAAU,oBAAoB;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE;QACF,kBAAkB,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC;QACrG,SAAS,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC;KAC3E,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,qEAAqE;IACrE,QAAQ,IAAI,IAAI,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,MAAM;;;mBAahE,cAAc;;;;;;;;;;;;;EA6E5B"}