@osolmaz/pi-workflows 0.8.2 → 0.9.1

package/README.md

@@ -71,6 +71,25 @@ The npm package also includes the simpler `pi-workflows` snapshot viewer. To
 link that command from a clone, run `npm install && npm run build && npm link`,
 or run it in place with `npx tsx src/viewer/cli.ts`.
 
+## Herdr integration
+
+Pi Workflows also ships as a [Herdr](https://herdr.dev) plugin. After installing
+`piw` and Pi Workflows, link the bundled plugin once:
+
+```bash
+pi-workflows herdr setup
+```
+
+When Pi runs inside Herdr, a workflow widget shows `Ctrl+Shift+R piw`. When the widget has hidden rows, this call to action shares the existing scroll-controls line instead of taking another line.
+The shortcut opens the exact run bundle and lets you choose a split, tab, or new
+workspace. `/piw` opens the same menu, and `/piw right`, `/piw below`, `/piw
+left`, `/piw above`, `/piw tab`, or `/piw workspace` selects a placement
+directly. If a viewer for that run already exists, Pi Workflows focuses it
+instead of opening a duplicate.
+
+The plugin uses Herdr's public pane APIs and runs no service or polling loop. It
+is also available through the [Herdr plugin marketplace](https://herdr.dev/plugins/).
+
 ## Quick start
 
 Put a workflow file in `.pi/workflows/` (project) or `~/.pi/agent/workflows/`

package/dist/extension/herdr-viewer.d.ts

@@ -0,0 +1,50 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export declare const PIW_SHORTCUT = "ctrl+shift+r";
+export declare const PIW_SHORTCUT_HINT = "Ctrl+Shift+R piw";
+export declare const VIEWER_PLACEMENTS: readonly ["right", "below", "left", "above", "tab", "workspace"];
+export type ViewerPlacement = (typeof VIEWER_PLACEMENTS)[number];
+export type WorkflowViewTarget = {
+    runId: string;
+    workflowName: string;
+    runDir: string;
+};
+export type HerdrCapability = {
+    available: true;
+} | {
+    available: false;
+    reason: string;
+};
+export type ViewerOpenResult = {
+    paneId: string;
+    reused: boolean;
+    warning?: string;
+};
+type Exec = ExtensionAPI["exec"];
+type HerdrPane = {
+    paneId: string;
+    tabId: string;
+    workspaceId: string;
+    label?: string;
+};
+export declare class HerdrWorkflowViewer {
+    private readonly exec;
+    private readonly env;
+    private readonly knownPanes;
+    private readonly opening;
+    constructor(exec: Exec, env?: NodeJS.ProcessEnv);
+    probe(): Promise<HerdrCapability>;
+    focusExisting(target: WorkflowViewTarget): Promise<boolean>;
+    open(target: WorkflowViewTarget, placement: ViewerPlacement, cwd: string): Promise<ViewerOpenResult>;
+    private openOnce;
+    private findAndFocus;
+    find(target: WorkflowViewTarget): Promise<HerdrPane | undefined>;
+    private currentPane;
+    private openPluginPane;
+    private openWorkspace;
+    private closePane;
+    private run;
+    private runJson;
+}
+export declare function parseViewerPlacement(value: string): ViewerPlacement | undefined;
+export declare function viewerPaneLabel(runId: string): string;
+export {};

package/dist/extension/herdr-viewer.js

@@ -0,0 +1,310 @@
+import { HERDR_PLUGIN_ENTRYPOINT, HERDR_PLUGIN_ID } from "../herdr/constants.js";
+export const PIW_SHORTCUT = "ctrl+shift+r";
+export const PIW_SHORTCUT_HINT = "Ctrl+Shift+R piw";
+const COMMAND_TIMEOUT_MS = 5_000;
+const MAX_JSON_CHARS = 1_000_000;
+const VIEWER_LABEL_PREFIX = "piw · ";
+export const VIEWER_PLACEMENTS = ["right", "below", "left", "above", "tab", "workspace"];
+export class HerdrWorkflowViewer {
+    exec;
+    env;
+    knownPanes = new Map();
+    opening = new Map();
+    constructor(exec, env = process.env) {
+        this.exec = exec;
+        this.env = env;
+    }
+    async probe() {
+        if (this.env.HERDR_ENV !== "1") {
+            return { available: false, reason: "Pi is not running in Herdr." };
+        }
+        try {
+            await this.currentPane();
+            const plugin = await this.runJson("herdr", [
+                "plugin",
+                "list",
+                "--plugin",
+                HERDR_PLUGIN_ID,
+                "--json",
+            ]);
+            if (!pluginIsEnabled(plugin)) {
+                return {
+                    available: false,
+                    reason: `Herdr plugin ${HERDR_PLUGIN_ID} is not linked and enabled.`,
+                };
+            }
+            await this.run("piw", ["--version"]);
+            return { available: true };
+        }
+        catch (error) {
+            return { available: false, reason: errorMessage(error) };
+        }
+    }
+    async focusExisting(target) {
+        return (await this.findAndFocus(target)) !== undefined;
+    }
+    async open(target, placement, cwd) {
+        const pending = this.opening.get(target.runId);
+        if (pending !== undefined)
+            return await pending;
+        const opening = this.openOnce(target, placement, cwd).finally(() => {
+            if (this.opening.get(target.runId) === opening)
+                this.opening.delete(target.runId);
+        });
+        this.opening.set(target.runId, opening);
+        return await opening;
+    }
+    async openOnce(target, placement, cwd) {
+        const existingPaneId = await this.findAndFocus(target);
+        if (existingPaneId !== undefined) {
+            return { paneId: existingPaneId, reused: true };
+        }
+        const caller = await this.currentPane();
+        if (placement === "workspace") {
+            const opened = await this.openWorkspace(target, cwd);
+            this.knownPanes.set(target.runId, opened.paneId);
+            return { ...opened, reused: false };
+        }
+        const opened = await this.openPluginPane(target, placement, caller);
+        if (placement === "left" || placement === "above") {
+            try {
+                await this.run("herdr", [
+                    "pane",
+                    "swap",
+                    "--source-pane",
+                    opened.paneId,
+                    "--target-pane",
+                    caller.paneId,
+                ]);
+            }
+            catch (error) {
+                await this.closePane(opened.paneId);
+                throw error;
+            }
+        }
+        this.knownPanes.set(target.runId, opened.paneId);
+        return { paneId: opened.paneId, reused: false };
+    }
+    async findAndFocus(target) {
+        const knownPaneId = this.knownPanes.get(target.runId);
+        if (knownPaneId !== undefined) {
+            try {
+                await this.run("herdr", ["plugin", "pane", "focus", knownPaneId]);
+                return knownPaneId;
+            }
+            catch {
+                this.knownPanes.delete(target.runId);
+            }
+        }
+        const existing = await this.find(target);
+        if (existing === undefined)
+            return undefined;
+        try {
+            await this.run("herdr", ["plugin", "pane", "focus", existing.paneId]);
+            this.knownPanes.set(target.runId, existing.paneId);
+            return existing.paneId;
+        }
+        catch {
+            // The pane can close between the snapshot and focus request.
+            return undefined;
+        }
+    }
+    async find(target) {
+        const snapshot = await this.runJson("herdr", ["api", "snapshot"]);
+        return snapshotPanes(snapshot).find((pane) => pane.label === viewerPaneLabel(target.runId));
+    }
+    async currentPane() {
+        return parseCurrentPane(await this.runJson("herdr", ["pane", "current", "--current"]));
+    }
+    async openPluginPane(target, placement, caller) {
+        const args = [
+            "plugin",
+            "pane",
+            "open",
+            "--plugin",
+            HERDR_PLUGIN_ID,
+            "--entrypoint",
+            HERDR_PLUGIN_ENTRYPOINT,
+            "--env",
+            `PI_WORKFLOWS_RUN_ID=${target.runId}`,
+            "--env",
+            `PI_WORKFLOWS_RUN_DIR=${target.runDir}`,
+            "--focus",
+        ];
+        if (placement === "tab") {
+            args.push("--placement", "tab", "--workspace", caller.workspaceId);
+        }
+        else {
+            args.push("--placement", "split", "--target-pane", caller.paneId, "--direction", placement === "below" || placement === "above" ? "down" : "right");
+        }
+        return parseOpenedPane(await this.runJson("herdr", args));
+    }
+    async openWorkspace(target, cwd) {
+        const created = parseCreatedWorkspace(await this.runJson("herdr", [
+            "workspace",
+            "create",
+            "--cwd",
+            cwd,
+            "--label",
+            workspaceLabel(target.workflowName),
+            "--no-focus",
+        ]));
+        let opened;
+        try {
+            opened = parseOpenedPane(await this.runJson("herdr", [
+                "plugin",
+                "pane",
+                "open",
+                "--plugin",
+                HERDR_PLUGIN_ID,
+                "--entrypoint",
+                HERDR_PLUGIN_ENTRYPOINT,
+                "--placement",
+                "tab",
+                "--workspace",
+                created.workspaceId,
+                "--env",
+                `PI_WORKFLOWS_RUN_ID=${target.runId}`,
+                "--env",
+                `PI_WORKFLOWS_RUN_DIR=${target.runDir}`,
+                "--focus",
+            ]));
+        }
+        catch (error) {
+            await this.run("herdr", ["workspace", "close", created.workspaceId]).catch(() => undefined);
+            throw error;
+        }
+        try {
+            await this.run("herdr", ["tab", "close", created.bootstrapTabId]);
+            return { paneId: opened.paneId };
+        }
+        catch (error) {
+            return {
+                paneId: opened.paneId,
+                warning: `The piw viewer opened, but its empty bootstrap tab could not be closed: ${errorMessage(error)}`,
+            };
+        }
+    }
+    async closePane(paneId) {
+        await this.run("herdr", ["plugin", "pane", "close", paneId]).catch(() => undefined);
+    }
+    async run(command, args) {
+        const result = await this.exec(command, args, { timeout: COMMAND_TIMEOUT_MS });
+        if (result.killed) {
+            throw new Error(`${command} timed out.`);
+        }
+        if (result.code !== 0) {
+            const message = result.stderr.trim() || result.stdout.trim() || `exit ${result.code}`;
+            throw new Error(`${command} failed: ${boundedText(message)}`);
+        }
+        return result.stdout;
+    }
+    async runJson(command, args) {
+        const stdout = await this.run(command, args);
+        if (stdout.length > MAX_JSON_CHARS) {
+            throw new Error(`${command} returned too much data.`);
+        }
+        try {
+            return JSON.parse(stdout);
+        }
+        catch {
+            throw new Error(`${command} returned invalid JSON.`);
+        }
+    }
+}
+export function parseViewerPlacement(value) {
+    return VIEWER_PLACEMENTS.find((placement) => placement === value);
+}
+export function viewerPaneLabel(runId) {
+    return `${VIEWER_LABEL_PREFIX}${runId}`;
+}
+function pluginIsEnabled(value) {
+    const result = recordValue(value, "result");
+    const plugins = result === undefined ? undefined : arrayValue(result, "plugins");
+    return (plugins?.some((plugin) => recordValue(plugin, "plugin_id") === HERDR_PLUGIN_ID &&
+        recordValue(plugin, "enabled") === true) === true);
+}
+function parseCurrentPane(value) {
+    const result = requiredRecord(value, "result", "Herdr pane response");
+    return paneFromValue(requiredRecord(result, "pane", "Herdr pane response"));
+}
+function parseOpenedPane(value) {
+    const result = requiredRecord(value, "result", "Herdr plugin pane response");
+    const pluginPane = requiredRecord(result, "plugin_pane", "Herdr plugin pane response");
+    return paneFromValue(requiredRecord(pluginPane, "pane", "Herdr plugin pane response"));
+}
+function parseCreatedWorkspace(value) {
+    const result = requiredRecord(value, "result", "Herdr workspace response");
+    const workspace = requiredRecord(result, "workspace", "Herdr workspace response");
+    const rootPane = requiredRecord(result, "root_pane", "Herdr workspace response");
+    return {
+        workspaceId: requiredString(workspace, "workspace_id", "Herdr workspace response"),
+        bootstrapTabId: requiredString(rootPane, "tab_id", "Herdr workspace response"),
+    };
+}
+function snapshotPanes(value) {
+    const result = requiredRecord(value, "result", "Herdr snapshot");
+    const snapshot = requiredRecord(result, "snapshot", "Herdr snapshot");
+    const panes = arrayValue(snapshot, "panes");
+    if (panes === undefined)
+        throw new Error("Herdr snapshot has no panes.");
+    return panes.flatMap((pane) => {
+        try {
+            return [paneFromValue(pane)];
+        }
+        catch {
+            return [];
+        }
+    });
+}
+function paneFromValue(value) {
+    if (!isRecord(value))
+        throw new Error("Herdr returned an invalid pane.");
+    const label = recordValue(value, "label");
+    return {
+        paneId: requiredString(value, "pane_id", "Herdr pane"),
+        tabId: requiredString(value, "tab_id", "Herdr pane"),
+        workspaceId: requiredString(value, "workspace_id", "Herdr pane"),
+        ...(typeof label === "string" ? { label } : {}),
+    };
+}
+function workspaceLabel(workflowName) {
+    const compact = workflowName.replace(/[\r\n\t]+/gu, " ").trim();
+    return `piw · ${(compact || "workflow").slice(0, 60)}`;
+}
+function requiredRecord(value, key, label) {
+    if (!isRecord(value))
+        throw new Error(`${label} is invalid.`);
+    const nested = value[key];
+    if (!isRecord(nested))
+        throw new Error(`${label} has no ${key}.`);
+    return nested;
+}
+function requiredString(value, key, label) {
+    const nested = value[key];
+    if (typeof nested !== "string" || nested.length === 0) {
+        throw new Error(`${label} has no ${key}.`);
+    }
+    return nested;
+}
+function recordValue(value, key) {
+    return isRecord(value) ? value[key] : undefined;
+}
+function arrayValue(value, key) {
+    const nested = recordValue(value, key);
+    return Array.isArray(nested) ? nested : undefined;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function boundedText(value) {
+    const compact = value
+        .replace(/[\r\n\t]+/gu, " ")
+        .replace(/ +/gu, " ")
+        .trim();
+    return compact.length <= 300 ? compact : `${compact.slice(0, 299)}…`;
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=herdr-viewer.js.map

package/dist/extension/herdr-viewer.js.map

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

package/dist/extension/index.js

@@ -1,4 +1,5 @@
 import { randomUUID } from "node:crypto";
+import path from "node:path";
 import { isDeepStrictEqual } from "node:util";
 import { builtinWorkflowCatalog } from "../builtins/catalog.js";
 import { projectControllerStorePath, SqliteControllerStore } from "../controllers/index.js";
@@ -10,6 +11,7 @@ import { appendProgressHistory, progressRecordsFromTrace } from "../workflows/pr
 import { createRunId, listRunBundles, readLastTraceEvent, readRunBundle, WorkflowRunStore, createDefinitionSnapshot, } from "../workflows/store.js";
 import { PiControllerHost, parseControllerArgs, } from "./controller-host.js";
 import { ConversationStepExecutor } from "./executor.js";
+import { HerdrWorkflowViewer, parseViewerPlacement, PIW_SHORTCUT, PIW_SHORTCUT_HINT, VIEWER_PLACEMENTS, } from "./herdr-viewer.js";
 import { SessionRecorder } from "./recorder.js";
 import { registerWorkflowAgentStepMessageRenderer, WORKFLOW_AGENT_STEP_MESSAGE_SCHEMA, WORKFLOW_AGENT_STEP_MESSAGE_TYPE, } from "./step-message.js";
 import { buildWidgetView } from "./widget.js";
@@ -27,6 +29,15 @@ const MAX_STATUS_ERROR_CHARS = 4_000;
 const MAX_WORKFLOW_LIST_ITEMS = 50;
 const MAX_WORKFLOW_LIST_NAME_CHARS = 3_500;
 const PRESENTATION_TIMEOUT_MS = 30_000;
+const PIW_PLACEMENT_LABELS = {
+    right: "Split right",
+    below: "Split below",
+    left: "Split left",
+    above: "Split above",
+    tab: "New tab",
+    workspace: "New workspace",
+};
+const PIW_PLACEMENT_BY_LABEL = new Map(VIEWER_PLACEMENTS.map((placement) => [PIW_PLACEMENT_LABELS[placement], placement]));
 class PresentationSupersededError extends Error {
 }
 class PresentationTimeoutError extends Error {
@@ -123,6 +134,14 @@ function workflowStateSummary(state) {
 }
 export default function piWorkflows(pi) {
     registerWorkflowAgentStepMessageRenderer(pi);
+    const herdrEnabled = process.env.HERDR_ENV === "1";
+    const herdrViewer = new HerdrWorkflowViewer((command, args, options) => pi.exec(command, args, options));
+    let herdrCapability = {
+        available: false,
+        reason: "Herdr integration has not been checked.",
+    };
+    let workflowViewTarget = null;
+    let herdrProbeGeneration = 0;
     // One runner identity per session; it names this session in run claims.
     const runnerId = randomUUID();
     let runQueueStore = null;
@@ -277,7 +296,12 @@ export default function piWorkflows(pi) {
         const render = (width = Number.POSITIVE_INFINITY, theme) => {
             if (!widgetSource)
                 return [];
-            const view = buildWidgetView(widgetSource.state, widgetSource.snapshot, new Date(), widgetScroll, runHeld(), width, theme, widgetSource.updateHistory);
+            const view = buildWidgetView(widgetSource.state, widgetSource.snapshot, new Date(), widgetScroll, runHeld(), width, theme, widgetSource.updateHistory, ctx.mode === "tui" &&
+                herdrEnabled &&
+                herdrCapability.available &&
+                workflowViewTarget?.runId === widgetSource.state.runId
+                ? PIW_SHORTCUT_HINT
+                : undefined);
             widgetShownScroll = view.scroll;
             widgetMaxScroll = view.maxScroll;
             if (widgetScroll !== null) {
@@ -308,14 +332,66 @@ export default function piWorkflows(pi) {
             snapshot,
             ...(updateHistory !== undefined ? { updateHistory: [...updateHistory] } : {}),
         };
+        workflowViewTarget = {
+            runId: state.runId,
+            workflowName: state.workflowName,
+            runDir: path.resolve(new WorkflowRunStore().runDirFor(state.runId)),
+        };
         renderWidget(ctx);
     };
     const clearWidget = (ctx) => {
         widgetSource = null;
+        workflowViewTarget = null;
         widgetScroll = null;
         setWidget(ctx, undefined);
         setStatus(ctx, undefined);
     };
+    const refreshHerdrCapability = async (ctx) => {
+        const generation = ++herdrProbeGeneration;
+        const capability = await herdrViewer.probe();
+        if (!sessionClosed && generation === herdrProbeGeneration) {
+            herdrCapability = capability;
+            renderWidget(ctx);
+        }
+        return capability;
+    };
+    const selectPiwPlacement = async (ctx) => {
+        if (!ctx.hasUI || ctx.mode !== "tui")
+            return undefined;
+        const label = await ctx.ui.select("Open workflow in piw", VIEWER_PLACEMENTS.map((placement) => PIW_PLACEMENT_LABELS[placement]));
+        return label === undefined ? undefined : PIW_PLACEMENT_BY_LABEL.get(label);
+    };
+    const openPiw = async (ctx, requestedPlacement) => {
+        const target = workflowViewTarget;
+        if (target === null) {
+            notify(ctx, "No workflow run is available to open in piw.", "warning");
+            return;
+        }
+        const capability = await refreshHerdrCapability(ctx);
+        if (!capability.available) {
+            notify(ctx, capability.reason, "warning");
+            return;
+        }
+        try {
+            if (await herdrViewer.focusExisting(target)) {
+                notify(ctx, `Focused the piw viewer for ${target.workflowName}.`);
+                return;
+            }
+            const placement = requestedPlacement ?? (await selectPiwPlacement(ctx));
+            if (placement === undefined) {
+                if (!ctx.hasUI || ctx.mode !== "tui") {
+                    notify(ctx, "Specify a piw placement: right, below, left, above, tab, or workspace.");
+                }
+                return;
+            }
+            const opened = await herdrViewer.open(target, placement, ctx.cwd);
+            if (opened.warning !== undefined)
+                notify(ctx, opened.warning, "warning");
+        }
+        catch (error) {
+            notify(ctx, `Could not open piw: ${errorMessage(error)}`, "error");
+        }
+    };
     const scrollWidget = (ctx, delta) => {
         if (!widgetSource || widgetMaxScroll === 0) {
             return;
@@ -696,6 +772,7 @@ export default function piWorkflows(pi) {
             run.renewTimer.unref?.();
         }
         clearWidgetTimer();
+        workflowViewTarget = null;
         startWidgetTicker(ctx, run);
         if (!options.quiet) {
             notify(ctx, `Workflow ${workflow.name} started. Follow it live with: pi-workflows view`);
@@ -1191,6 +1268,22 @@ export default function piWorkflows(pi) {
             throw error;
         }
     };
+    pi.registerCommand("piw", {
+        description: "Open the current workflow run in piw through Herdr",
+        getArgumentCompletions: async (prefix) => {
+            const items = VIEWER_PLACEMENTS.filter((placement) => placement.startsWith(prefix)).map((placement) => ({ value: placement, label: placement }));
+            return items.length > 0 ? items : null;
+        },
+        handler: async (args, ctx) => {
+            const value = args.trim();
+            const placement = value.length === 0 ? undefined : parseViewerPlacement(value);
+            if (value.length > 0 && placement === undefined) {
+                notify(ctx, "piw placement must be right, below, left, above, tab, or workspace.", "error");
+                return;
+            }
+            await openPiw(ctx, placement);
+        },
+    });
     pi.registerCommand("workflow", {
         description: "Run or manage a workflow: /workflow <name-or-path> [task | --input-json {…}]; also: status, pause, resume, cancel, answer",
         getArgumentCompletions: async (prefix) => {
@@ -1406,6 +1499,12 @@ export default function piWorkflows(pi) {
             };
         },
     });
+    if (herdrEnabled) {
+        pi.registerShortcut(PIW_SHORTCUT, {
+            description: "Open the current workflow run in piw",
+            handler: async (ctx) => await openPiw(ctx),
+        });
+    }
     pi.registerShortcut("shift+up", {
         description: "Scroll the workflow widget up",
         handler: (ctx) => scrollWidget(ctx, -WIDGET_SCROLL_STEP),
@@ -1417,6 +1516,8 @@ export default function piWorkflows(pi) {
     pi.on("session_start", async (_event, ctx) => {
         sessionClosed = false;
         controllerContext = ctx;
+        if (herdrEnabled)
+            void refreshHerdrCapability(ctx);
         try {
             const queue = ensureRunQueueStore(ctx.cwd);
             const migration = await migrateLegacyWorkflowSources({
@@ -1550,6 +1651,7 @@ export default function piWorkflows(pi) {
     });
     pi.on("session_shutdown", async () => {
         sessionClosed = true;
+        herdrProbeGeneration += 1;
         systemTurnAbort = null;
         suppressWorkflowAssistantTail = false;
         supersedePresentation();
@@ -1581,6 +1683,7 @@ export default function piWorkflows(pi) {
         clearWidgetTimer();
         stopWidgetTicker();
         widgetSource = null;
+        workflowViewTarget = null;
         widgetScroll = null;
     });
 }