@osolmaz/pi-workflows 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Onur Solmaz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,182 @@
+# pi-workflows
+
+pi-workflows is a workflow extension for the [pi coding agent](https://pi.dev).
+It lets you define multi-step agent workflows as TypeScript graphs, trigger
+them at any point in a pi conversation with `/workflow`, and watch them run
+live in a standalone terminal viewer.
+
+The workflow model is a port of [openclaw/acpx](https://github.com/openclaw/acpx)
+flows into pi itself. Agent steps run inside your current pi conversation, so
+the model keeps everything it already knows from the discussion. The model
+completes each step by calling a JSON `workflow` tool, which gives the engine
+structured, validated output to route on.
+
+## Install
+
+```bash
+pi install npm:@osolmaz/pi-workflows
+```
+
+You can also install directly from GitHub:
+
+```bash
+pi install git:github.com/osolmaz/pi-workflows
+```
+
+Or try the npm package without installing it:
+
+```bash
+pi -e npm:@osolmaz/pi-workflows
+```
+
+The `pi-workflows` viewer binary is part of the same package. To get it on
+your PATH, clone the repo and run `npm install && npm run build && npm link`,
+or run it in place with `npx tsx src/viewer/cli.ts`.
+
+## Quick start
+
+Put a workflow file in `.pi/workflows/` (project) or `~/.pi/agent/workflows/`
+(global):
+
+```typescript
+// .pi/workflows/echo.workflow.ts
+import { agent, defineWorkflow } from "@osolmaz/pi-workflows";
+
+export default defineWorkflow({
+  name: "echo",
+  presentationPrompt: "Give the user the concise reply from the workflow result.",
+  startAt: "reply",
+  nodes: {
+    reply: agent({
+      prompt: ({ input }) => `Answer concisely: ${(input as { task?: string }).task}`,
+      expectedOutput: `{ "reply": "your concise answer" }`,
+    }),
+  },
+  edges: [],
+});
+```
+
+Then, from any pi conversation:
+
+```
+/workflow echo summarize this repository
+```
+
+`/workflow` with no arguments lists discovered workflows. `/workflow pause`
+lets the current step finish and then holds the run before the next node —
+useful when you want to interject in the conversation mid-workflow —
+and `/workflow resume` continues it. Pressing escape to interrupt a turn
+pauses the workflow automatically, so the run never nudges the model while
+you have taken the conversation back; `/workflow resume` re-delivers the
+pending step prompt. `/workflow cancel` stops the active run; if the last run
+already ended (for example parked at a checkpoint), it clears the leftover
+widget instead. Trailing text becomes `{ task: "..." }`; pass arbitrary input
+with `--input-json {"key": "value"}`. The names `cancel`, `list`, `pause`,
+and `resume` are reserved and rejected as workflow names.
+
+While a run is on screen, the footer status bar shows a compact
+`wf <name> [status] <node>` indicator alongside the widget.
+
+`presentationPrompt` is optional. When present, pi-workflows uses it after the
+structured run ends to request one normal, human-readable assistant response.
+Workflows without it remain silent after their final structured output, which
+keeps shell-only and machine-consumed workflows model-free.
+
+Because the workflow runs in your current conversation, you can have a long
+discussion first and then trigger a workflow that builds on it. The
+`elegant-solution` example does exactly that. It asks the model for the most
+elegant long-term production-ready solution to the problem you discussed, then
+for the holy grail, then whether the two are the same (y/n). On `y` it routes
+straight into implementation, and on `n` it asks the model to reconcile the
+gap and pauses at a checkpoint for you to decide. In either case, its
+`presentationPrompt` turns the final structured result into a plain assistant
+response.
+
+## Watching a run
+
+Runs persist to `~/.pi/agent/workflows/runs/` as they execute. The viewer
+tails that directory and re-renders on every state change:
+
+```bash
+pi-workflows view          # interactive picker, live updates
+pi-workflows view <runId>  # jump straight to one run
+pi-workflows runs          # plain list of recent runs
+pi-workflows view --once   # print a snapshot and exit (good for scripts)
+```
+
+The run detail view draws the workflow as a boxed graph, like the acpx replay
+viewer: every node sits in a box (heavy border for the active node), branches
+carry their case labels, the taken path is highlighted, and loops route
+through a gutter on the right back into their target from above. `←/→` scrubs
+backwards and forwards through the recorded steps and re-derives every node's
+status as of that step, with the selected step's full output shown below;
+scrubbing to the end snaps back to following the run live.
+
+```
+              │ ┌──────────────────┐
+              ▼ ▼                  │
+  ┌──────────────────────────┐     │
+  │ ✓ verify [action] 8.0s ×2 │    │
+  └──────────────────────────┘     │
+              │                    │
+              ▼                    │
+  ┏━━━━━━━━━━━━━━━━━━━━━━━━━━┓     │
+  ┃ ◐ review [agent] 12s ×2  ┃     │
+  ┗━━━━━━━━━━━━━━━━━━━━━━━━━━┛     │
+     ┌─ clean ─┘ └─ issues ─┐      │
+     ▼                      ▼      │
+┌───────────┐    ┌───────────────┐ │
+│ · done    │    │ ✓ fix [agent] │ │
+└───────────┘    └───────────────┘ │
+                        └──────────┘
+```
+
+Inside pi, a widget above the editor shows the same boxed graph while a
+workflow is running, windowed around the active node when it is taller than
+pi's widget budget. Scroll the window with `shift+↑` / `shift+↓`; it snaps back
+to following the active node whenever the workflow advances a step.
+
+## Node types
+
+A workflow is a graph of named nodes with exactly one entry point. Each node
+finishes with a JSON output, and edges decide what runs next.
+
+An `agent` node sends a prompt into the pi conversation and waits for the
+model to submit its output through the `workflow` tool. A `compute` node runs
+a pure TypeScript function. An `action` node performs a side effect, either a
+TypeScript function (`action({ run })`) or a runtime-owned shell command
+(`shell({ exec, parse })`). A `checkpoint` node ends the run in a `waiting`
+state so a human can pick it up. On top of `agent`, the `decision` helper asks
+the model to pick from a fixed set of choices and validates the answer, and
+`decisionEdge` routes on the result with compile-time case checking.
+
+See [docs/workflows.md](docs/workflows.md) for the full authoring reference
+and [docs/run-bundles.md](docs/run-bundles.md) for the on-disk run format.
+
+## Examples
+
+The [examples/workflows/](examples/workflows/) directory mirrors the acpx
+example set. Copy any of them into `.pi/workflows/` to use them:
+
+- `echo` is the smallest possible workflow, one agent step.
+- `branch` classifies a task with a `decision` and routes to either a
+  continue lane or a clarification checkpoint.
+- `shell` runs a runtime-owned shell command and parses its output, with no
+  agent step at all.
+- `two-turn` chains three agent steps that build on each other's outputs in
+  the same conversation.
+- `elegant-solution` is the mid-conversation trigger described above.
+- `autoimplement` runs an implement, verify, review loop where the review
+  decision routes `issues_found` back to a fix step until it comes back
+  `clean`, bounded by `maxSteps`.
+- `autoresearch` runs an iterative feature-search loop in the style of
+  [karpathy/autoresearch](https://github.com/karpathy/autoresearch): setup
+  creates a frozen evaluation harness, one editable feature file, and a
+  journal; each loop iteration runs one generation of experiments and
+  journals every result; an assess decision keeps looping until a kept
+  result plateaus or a diverse generation all fails, then conclusions are
+  written before the winner is promoted out of the loop directory.
+
+## License
+
+[MIT](LICENSE)

package/dist/extension/executor.d.ts

@@ -0,0 +1,58 @@
+import type { AgentStepExecutor, AgentStepRequest, AgentStepSubmission } from "../workflows/types.js";
+export type SubmissionResult = {
+    accepted: true;
+    message: string;
+} | {
+    accepted: false;
+    message: string;
+};
+export type PromptDelivery = {
+    prompt: string;
+    /** True when the agent is known to be mid-run, so delivery must be queued. */
+    streaming: boolean;
+};
+export type ConversationStepExecutorOptions = {
+    /** Deliver a prompt into the pi conversation. */
+    sendPrompt: (delivery: PromptDelivery) => void;
+    /** Reminders sent when the agent settles without submitting. Default 2. */
+    maxNudges?: number;
+};
+/**
+ * AgentStepExecutor that runs steps inside the current pi conversation. The
+ * engine hands it a prompt; it delivers the prompt as a user message and
+ * resolves once the model submits an accepted output through the `workflow`
+ * tool. If the agent settles without submitting, it nudges the model a
+ * bounded number of times before failing the step.
+ */
+export declare class ConversationStepExecutor implements AgentStepExecutor {
+    private readonly sendPrompt;
+    private readonly maxNudges;
+    private pending;
+    private streaming;
+    private heldByUser;
+    constructor(options: ConversationStepExecutorOptions);
+    /** Track agent streaming state (wire to agent_start / agent_settled). */
+    setStreaming(streaming: boolean): void;
+    get pendingStepId(): string | null;
+    /**
+     * Hold the pending step for the user: no nudges are sent while held, so an
+     * escape-interrupted conversation stays quiet until the user resumes.
+     */
+    hold(): void;
+    get held(): boolean;
+    /**
+     * Release a user hold. When a step is still pending, its prompt is
+     * re-delivered so the model picks the step back up.
+     */
+    release(): void;
+    runAgentStep(request: AgentStepRequest, signal: AbortSignal): Promise<AgentStepSubmission>;
+    /** Called by the `workflow` tool when the model submits a step output. */
+    submit(stepId: string, attemptId: string, output: unknown): Promise<SubmissionResult>;
+    /**
+     * Called when the agent settles. Returns true when a nudge was sent, false
+     * when there was nothing to do. Fails the pending step once the nudge
+     * budget is exhausted.
+     */
+    handleAgentSettled(): boolean;
+    private clearPending;
+}

package/dist/extension/executor.js

@@ -0,0 +1,201 @@
+const DEFAULT_MAX_NUDGES = 2;
+/**
+ * AgentStepExecutor that runs steps inside the current pi conversation. The
+ * engine hands it a prompt; it delivers the prompt as a user message and
+ * resolves once the model submits an accepted output through the `workflow`
+ * tool. If the agent settles without submitting, it nudges the model a
+ * bounded number of times before failing the step.
+ */
+export class ConversationStepExecutor {
+    sendPrompt;
+    maxNudges;
+    pending = null;
+    streaming = false;
+    heldByUser = false;
+    constructor(options) {
+        this.sendPrompt = options.sendPrompt;
+        this.maxNudges = options.maxNudges ?? DEFAULT_MAX_NUDGES;
+    }
+    /** Track agent streaming state (wire to agent_start / agent_settled). */
+    setStreaming(streaming) {
+        this.streaming = streaming;
+    }
+    get pendingStepId() {
+        return this.pending?.request.contract.nodeId ?? null;
+    }
+    /**
+     * Hold the pending step for the user: no nudges are sent while held, so an
+     * escape-interrupted conversation stays quiet until the user resumes.
+     */
+    hold() {
+        this.heldByUser = true;
+    }
+    get held() {
+        return this.heldByUser;
+    }
+    /**
+     * Release a user hold. When a step is still pending, its prompt is
+     * re-delivered so the model picks the step back up.
+     */
+    release() {
+        if (!this.heldByUser) {
+            return;
+        }
+        this.heldByUser = false;
+        const pending = this.pending;
+        if (!pending) {
+            return;
+        }
+        try {
+            this.sendPrompt({ prompt: pending.request.prompt, streaming: this.streaming });
+        }
+        catch (error) {
+            this.clearPending();
+            pending.reject(error);
+        }
+    }
+    async runAgentStep(request, signal) {
+        if (this.pending) {
+            throw new Error("Another workflow step is already awaiting output");
+        }
+        return await new Promise((resolve, reject) => {
+            const onAbort = () => {
+                const reason = signal.reason ?? new Error("Workflow step aborted");
+                this.clearPending();
+                reject(reason);
+            };
+            signal.addEventListener("abort", onAbort, { once: true });
+            let markCleared;
+            const cleared = new Promise((resolveCleared) => {
+                markCleared = resolveCleared;
+            });
+            this.pending = {
+                request,
+                resolve,
+                reject,
+                nudgesSent: 0,
+                cleanup: () => signal.removeEventListener("abort", onAbort),
+                cleared,
+                markCleared,
+            };
+            if (signal.aborted) {
+                onAbort();
+                return;
+            }
+            try {
+                this.sendPrompt({ prompt: request.prompt, streaming: this.streaming });
+            }
+            catch (error) {
+                // A failed delivery must not leave the step installed, or every
+                // subsequent agent node would fail with "already awaiting output".
+                this.clearPending();
+                reject(error);
+            }
+        });
+    }
+    /** Called by the `workflow` tool when the model submits a step output. */
+    async submit(stepId, attemptId, output) {
+        const pending = this.pending;
+        if (!pending) {
+            return {
+                accepted: false,
+                message: "No workflow step is awaiting output. Do not call the workflow tool outside an active workflow step.",
+            };
+        }
+        const expected = pending.request.contract.nodeId;
+        if (stepId !== expected) {
+            return {
+                accepted: false,
+                message: `Wrong step id ${JSON.stringify(stepId)}; the pending step is ${JSON.stringify(expected)}.`,
+            };
+        }
+        // Loops revisit the same node id, so a delayed duplicate submission from
+        // an earlier attempt would otherwise be accepted as this attempt's output.
+        const expectedAttempt = pending.request.contract.attemptId;
+        if (attemptId !== expectedAttempt) {
+            return {
+                accepted: false,
+                message: `Stale attempt id ${JSON.stringify(attemptId)} for step ${JSON.stringify(stepId)}; the pending attempt is ${JSON.stringify(expectedAttempt)}. Use the attempt id from the latest step contract.`,
+            };
+        }
+        // Race validation against the step being cleared: a hung `validate`
+        // callback must not leave this tool call (and therefore pi) blocked after
+        // a timeout or cancel already resolved the run.
+        const result = await Promise.race([
+            pending.request.accept(output),
+            pending.cleared.then(() => null),
+        ]);
+        // The step may have timed out or been cancelled (and a newer step
+        // installed) while validation was awaited; a stale submission must not
+        // clear or resolve the newer pending step.
+        if (result === null || this.pending !== pending) {
+            return {
+                accepted: false,
+                message: `Step ${JSON.stringify(stepId)} is no longer awaiting output.`,
+            };
+        }
+        if (!result.ok) {
+            return {
+                accepted: false,
+                message: `Output rejected for step ${JSON.stringify(stepId)}: ${result.error}`,
+            };
+        }
+        this.clearPending();
+        pending.resolve({ output: result.value });
+        return {
+            accepted: true,
+            message: [
+                `Output accepted for step ${JSON.stringify(stepId)}.`,
+                "If the workflow continues, the next step arrives as a new user message. End your turn now.",
+            ].join(" "),
+        };
+    }
+    /**
+     * Called when the agent settles. Returns true when a nudge was sent, false
+     * when there was nothing to do. Fails the pending step once the nudge
+     * budget is exhausted.
+     */
+    handleAgentSettled() {
+        const pending = this.pending;
+        if (!pending) {
+            return false;
+        }
+        if (this.heldByUser) {
+            // The user interrupted deliberately; reminding the model now would
+            // steal the conversation back. The step waits for an explicit resume.
+            return false;
+        }
+        if (pending.nudgesSent >= this.maxNudges) {
+            this.clearPending();
+            pending.reject(new Error(`Agent settled ${pending.nudgesSent + 1} times without submitting step ${JSON.stringify(pending.request.contract.nodeId)} via the workflow tool`));
+            return false;
+        }
+        pending.nudgesSent += 1;
+        const { nodeId, attemptId } = pending.request.contract;
+        try {
+            this.sendPrompt({
+                prompt: [
+                    `Reminder: workflow step ${JSON.stringify(nodeId)} is still awaiting your output.`,
+                    "Complete it by calling the `workflow` tool with:",
+                    `{"step": ${JSON.stringify(nodeId)}, "attempt": ${JSON.stringify(attemptId)}, "output": <your result>}`,
+                    `Expected output: ${pending.request.contract.expectedOutput ?? "a JSON object with your result"}`,
+                ].join("\n"),
+                streaming: this.streaming,
+            });
+        }
+        catch (error) {
+            // No reminder turn was started, so nothing would settle the step; fail
+            // it promptly instead of waiting out the node timeout.
+            this.clearPending();
+            pending.reject(error);
+            return false;
+        }
+        return true;
+    }
+    clearPending() {
+        this.pending?.cleanup();
+        this.pending?.markCleared();
+        this.pending = null;
+    }
+}
+//# sourceMappingURL=executor.js.map

package/dist/extension/executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor.js","sourceRoot":"","sources":["../../src/extension/executor.ts"],"names":[],"mappings":"AAkCA,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAE7B;;;;;;GAMG;AACH,MAAM,OAAO,wBAAwB;IAClB,UAAU,CAAqC;IAC/C,SAAS,CAAS;IAC3B,OAAO,GAAuB,IAAI,CAAC;IACnC,SAAS,GAAG,KAAK,CAAC;IAClB,UAAU,GAAG,KAAK,CAAC;IAE3B,YAAY,OAAwC;QAClD,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC;IAC3D,CAAC;IAED,yEAAyE;IACzE,YAAY,CAAC,SAAkB;QAC7B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC;IACvD,CAAC;IAED;;;OAGG;IACH,IAAI;QACF,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;IACzB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;;OAGG;IACH,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC;QACxB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QACjF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,OAAyB,EAAE,MAAmB;QAC/D,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,MAAM,IAAI,OAAO,CAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAChE,MAAM,OAAO,GAAG,GAAG,EAAE;gBACnB,MAAM,MAAM,GAAY,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;gBAC5E,IAAI,CAAC,YAAY,EAAE,CAAC;gBACpB,MAAM,CAAC,MAAM,CAAC,CAAC;YACjB,CAAC,CAAC;YACF,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1D,IAAI,WAAwB,CAAC;YAC7B,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,CAAC,cAAc,EAAE,EAAE;gBACnD,WAAW,GAAG,cAAc,CAAC;YAC/B,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,OAAO,GAAG;gBACb,OAAO;gBACP,OAAO;gBACP,MAAM;gBACN,UAAU,EAAE,CAAC;gBACb,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC;gBAC3D,OAAO;gBACP,WAAW;aACZ,CAAC;YACF,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO,EAAE,CAAC;gBACV,OAAO;YACT,CAAC;YACD,IAAI,CAAC;gBACH,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;YACzE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,gEAAgE;gBAChE,mEAAmE;gBACnE,IAAI,CAAC,YAAY,EAAE,CAAC;gBACpB,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,0EAA0E;IAC1E,KAAK,CAAC,MAAM,CAAC,MAAc,EAAE,SAAiB,EAAE,MAAe;QAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,OAAO,EACL,qGAAqG;aACxG,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;QACjD,IAAI,MAAM,KAAK,QAAQ,EAAE,CAAC;YACxB,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,iBAAiB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,yBAAyB,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG;aACrG,CAAC;QACJ,CAAC;QACD,yEAAyE;QACzE,2EAA2E;QAC3E,MAAM,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC3D,IAAI,SAAS,KAAK,eAAe,EAAE,CAAC;YAClC,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,oBAAoB,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,aAAa,IAAI,CAAC,SAAS,CAC/E,MAAM,CACP,4BAA4B,IAAI,CAAC,SAAS,CAAC,eAAe,CAAC,qDAAqD;aAClH,CAAC;QACJ,CAAC;QACD,oEAAoE;QACpE,0EAA0E;QAC1E,gDAAgD;QAChD,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC;YAChC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC;YAC9B,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;SACjC,CAAC,CAAC;QACH,kEAAkE;QAClE,uEAAuE;QACvE,2CAA2C;QAC3C,IAAI,MAAM,KAAK,IAAI,IAAI,IAAI,CAAC,OAAO,KAAK,OAAO,EAAE,CAAC;YAChD,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,QAAQ,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,gCAAgC;aACxE,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO;gBACL,QAAQ,EAAE,KAAK;gBACf,OAAO,EAAE,4BAA4B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC,KAAK,EAAE;aAC/E,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;QAC1C,OAAO;YACL,QAAQ,EAAE,IAAI;YACd,OAAO,EAAE;gBACP,4BAA4B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG;gBACrD,4FAA4F;aAC7F,CAAC,IAAI,CAAC,GAAG,CAAC;SACZ,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,kBAAkB;QAChB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,mEAAmE;YACnE,sEAAsE;YACtE,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACzC,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,OAAO,CAAC,MAAM,CACZ,IAAI,KAAK,CACP,iBAAiB,OAAO,CAAC,UAAU,GAAG,CAAC,kCAAkC,IAAI,CAAC,SAAS,CACrF,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAChC,wBAAwB,CAC1B,CACF,CAAC;YACF,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,CAAC,UAAU,IAAI,CAAC,CAAC;QACxB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;QACvD,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,CAAC;gBACd,MAAM,EAAE;oBACN,2BAA2B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,iCAAiC;oBAClF,kDAAkD;oBAClD,YAAY,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,4BAA4B;oBACvG,oBAAoB,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,cAAc,IAAI,gCAAgC,EAAE;iBAClG,CAAC,IAAI,CAAC,IAAI,CAAC;gBACZ,SAAS,EAAE,IAAI,CAAC,SAAS;aAC1B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,uEAAuE;YACvE,uDAAuD;YACvD,IAAI,CAAC,YAAY,EAAE,CAAC;YACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,YAAY;QAClB,IAAI,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;CACF"}

package/dist/extension/index.d.ts

@@ -0,0 +1,17 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+export type ParsedWorkflowArgs = {
+    kind: "list";
+} | {
+    kind: "cancel";
+} | {
+    kind: "pause";
+} | {
+    kind: "resume";
+} | {
+    kind: "run";
+    ref: string;
+    input: unknown;
+};
+/** Parse `/workflow` arguments. Exported for tests. */
+export declare function parseWorkflowArgs(args: string): ParsedWorkflowArgs;
+export default function piWorkflows(pi: ExtensionAPI): void;