@marcoscale98/pi-extensible-workflows 5.14.1-fork.1

package/dist/src/workflow-artifacts.d.ts

@@ -0,0 +1,14 @@
+import type { JsonValue } from "./types.js";
+export interface WorkflowArtifact {
+    extension: ".js" | ".json" | ".md";
+    content: string;
+}
+export type WorkflowTui = {
+    stop(): void;
+    start(): void;
+    requestRender(force?: boolean): void;
+};
+export declare function workflowScriptArtifact(script: string): WorkflowArtifact;
+export declare function workflowPromptArtifact(prompt: string): WorkflowArtifact;
+export declare function workflowResultArtifact(value: JsonValue): WorkflowArtifact;
+export declare function openWorkflowArtifact(tui: WorkflowTui, command: string, artifact: WorkflowArtifact): Promise<number | null>;

package/dist/src/workflow-artifacts.js

@@ -0,0 +1,40 @@
+import { spawn } from "node:child_process";
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+export function workflowScriptArtifact(script) { return { extension: ".js", content: script }; }
+export function workflowPromptArtifact(prompt) { return { extension: ".md", content: prompt }; }
+export function workflowResultArtifact(value) { return typeof value === "string" ? { extension: ".md", content: value } : { extension: ".json", content: `${JSON.stringify(value, null, 2)}\n` }; }
+async function spawnWorkflowEditor(command, path) {
+    const [editor, ...editorArgs] = command.split(" ");
+    if (!editor)
+        return null;
+    return new Promise((resolve) => {
+        try {
+            const child = spawn(editor, [...editorArgs, path], { stdio: "inherit", shell: process.platform === "win32" });
+            child.once("error", () => { resolve(null); });
+            child.once("close", (code) => { resolve(code); });
+        }
+        catch {
+            resolve(null);
+        }
+    });
+}
+export async function openWorkflowArtifact(tui, command, artifact) {
+    const directory = await mkdtemp(join(tmpdir(), "pi-workflow-editor-"));
+    const path = join(directory, `artifact${artifact.extension}`);
+    try {
+        await writeFile(path, artifact.content, { encoding: "utf8", mode: 0o600 });
+        tui.stop();
+        try {
+            return await spawnWorkflowEditor(command, path);
+        }
+        finally {
+            tui.start();
+            tui.requestRender(true);
+        }
+    }
+    finally {
+        await rm(directory, { recursive: true, force: true });
+    }
+}

package/dist/starter/index.d.ts

@@ -0,0 +1 @@
+export default function (): void;

package/dist/starter/index.js

@@ -0,0 +1,103 @@
+// starter/index.ts
+import {
+  registerWorkflowExtension
+} from "@marcoscale98/pi-extensible-workflows";
+
+// starter/review-loop.ts
+import { Type } from "typebox";
+import {
+  defineWorkflowFunction
+} from "@marcoscale98/pi-extensible-workflows";
+var reviewLoop = defineWorkflowFunction({
+  description: "Run developer and reviewer agents until review passes or the iteration limit is reached",
+  async run({ task, maxIterations = 5 }, { agent, prompt }) {
+    const reviewSchema = Type.Object(
+      {
+        pass: Type.Boolean(),
+        findings: Type.Array(Type.String())
+      },
+      { additionalProperties: false }
+    );
+    let devResult = null;
+    let review = { pass: false, findings: [] };
+    for (let iterations = 1; iterations <= maxIterations; iterations += 1) {
+      const devPrompt = iterations === 1 ? prompt("Implement this task:\n\n{task}", { task }) : prompt(
+        `Address the previous review findings and complete the task.
+<original_task>{task}</original_task>
+<last_review>{review}</last_review>`,
+        { task, review: review.findings }
+      );
+      devResult = await agent(devPrompt, { role: "developer" });
+      review = await agent(
+        prompt(
+          `Review the implementation against the task. Set pass=true only when the task is complete and correct. The developer may have addressed a previous review run of yours. So its summary is related to the last round of review if present.
+<original_task>{task}</original_task>
+<last_review>{review}</last_review>
+<dev_summary>{devResult}</dev_summary>`,
+          { task, devResult, review: review.findings }
+        ),
+        { role: "reviewer", outputSchema: reviewSchema }
+      );
+      if (review.pass) return { pass: true, iterations, devResult, review };
+    }
+    return { pass: false, iterations: maxIterations, devResult, review };
+  },
+  input: Type.Object(
+    {
+      task: Type.String(),
+      maxIterations: Type.Optional(Type.Integer({ minimum: 1 }))
+    },
+    { additionalProperties: false }
+  ),
+  output: Type.Object(
+    {
+      pass: Type.Boolean(),
+      iterations: Type.Integer(),
+      devResult: Type.Any(),
+      review: Type.Object(
+        {
+          pass: Type.Boolean(),
+          findings: Type.Array(Type.String())
+        },
+        { additionalProperties: false }
+      )
+    },
+    { additionalProperties: false }
+  )
+});
+var reviewLoopInputSchema = reviewLoop.input;
+var reviewLoopOutputSchema = reviewLoop.output;
+
+// starter/index.ts
+var extension = {
+  source: import.meta.url,
+  dependencies: ["typebox"],
+  version: "1.0.0",
+  headline: "Developer-review starter workflows",
+  functions: { reviewLoop },
+  modelAliases: {
+    "reviewer-model": {
+      resolve: ({ rootModel }) => `${rootModel.provider}/${rootModel.model}`
+    },
+    "developer-model": {
+      resolve: ({ rootModel }) => `${rootModel.provider}/${rootModel.model}`
+    },
+    "scout-model": {
+      resolve: ({ rootModel }) => `${rootModel.provider}/${rootModel.model}`
+    },
+    "oracle-model": {
+      resolve: ({ rootModel }) => `${rootModel.provider}/${rootModel.model}`
+    },
+    "researcher-model": {
+      resolve: ({ rootModel }) => `${rootModel.provider}/${rootModel.model}`
+    }
+  },
+  roleDirectories: [new URL("./roles/", import.meta.url)]
+};
+function starter_default() {
+  registerWorkflowExtension(extension);
+}
+export {
+  starter_default as default
+};
+//# sourceMappingURL=index.js.map

package/dist/starter/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../starter/index.ts", "../../starter/review-loop.ts"],
+  "mappings": "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",
+  "names": []
+}

package/dist/starter/review-loop.d.ts

@@ -0,0 +1,72 @@
+import { Type } from "typebox";
+import { type JsonValue } from "@marcoscale98/pi-extensible-workflows";
+export declare const reviewLoop: Omit<{
+    description: string;
+    input: Type.TObject<{
+        task: Type.TString;
+        maxIterations: Type.TOptional<Type.TInteger>;
+    }>;
+    output: Type.TObject<{
+        pass: Type.TBoolean;
+        iterations: Type.TInteger;
+        devResult: Type.TAny;
+        review: Type.TObject<{
+            pass: Type.TBoolean;
+            findings: Type.TArray<Type.TString>;
+        }>;
+    }>;
+    run: (input: Readonly<{
+        maxIterations?: number;
+        task: string;
+    }>, context: Readonly<import("@marcoscale98/pi-extensible-workflows").WorkflowFunctionContext>) => {
+        review: {
+            pass: boolean;
+            findings: string[];
+        };
+        pass: boolean;
+        iterations: number;
+        devResult: any;
+    } | Promise<{
+        review: {
+            pass: boolean;
+            findings: string[];
+        };
+        pass: boolean;
+        iterations: number;
+        devResult: any;
+    }>;
+}, "run"> & {
+    run: ({ task, maxIterations }: Readonly<{
+        maxIterations?: number;
+        task: string;
+    }>, { agent, prompt }: Readonly<import("@marcoscale98/pi-extensible-workflows").WorkflowFunctionContext>) => Promise<{
+        pass: true;
+        iterations: number;
+        devResult: JsonValue;
+        review: {
+            pass: boolean;
+            findings: string[];
+        };
+    } | {
+        pass: false;
+        iterations: number;
+        devResult: JsonValue;
+        review: {
+            pass: boolean;
+            findings: string[];
+        };
+    }>;
+};
+export declare const reviewLoopInputSchema: Type.TObject<{
+    task: Type.TString;
+    maxIterations: Type.TOptional<Type.TInteger>;
+}>;
+export declare const reviewLoopOutputSchema: Type.TObject<{
+    pass: Type.TBoolean;
+    iterations: Type.TInteger;
+    devResult: Type.TAny;
+    review: Type.TObject<{
+        pass: Type.TBoolean;
+        findings: Type.TArray<Type.TString>;
+    }>;
+}>;

package/dist/starter/review-loop.js

@@ -0,0 +1,43 @@
+import { Type } from "typebox";
+import { defineWorkflowFunction, } from "@marcoscale98/pi-extensible-workflows";
+export const reviewLoop = defineWorkflowFunction({
+    description: "Run developer and reviewer agents until review passes or the iteration limit is reached",
+    async run({ task, maxIterations = 5 }, { agent, prompt }) {
+        const reviewSchema = Type.Object({
+            pass: Type.Boolean(),
+            findings: Type.Array(Type.String()),
+        }, { additionalProperties: false });
+        let devResult = null;
+        let review = { pass: false, findings: [] };
+        for (let iterations = 1; iterations <= maxIterations; iterations += 1) {
+            const devPrompt = iterations === 1
+                ? prompt("Implement this task:\n\n{task}", { task })
+                : prompt(`Address the previous review findings and complete the task.
+<original_task>{task}</original_task>
+<last_review>{review}</last_review>`, { task, review: review.findings });
+            devResult = await agent(devPrompt, { role: "developer" });
+            review = await agent(prompt(`Review the implementation against the task. Set pass=true only when the task is complete and correct. The developer may have addressed a previous review run of yours. So its summary is related to the last round of review if present.
+<original_task>{task}</original_task>
+<last_review>{review}</last_review>
+<dev_summary>{devResult}</dev_summary>`, { task, devResult, review: review.findings }), { role: "reviewer", outputSchema: reviewSchema });
+            if (review.pass)
+                return { pass: true, iterations, devResult, review };
+        }
+        return { pass: false, iterations: maxIterations, devResult, review };
+    },
+    input: Type.Object({
+        task: Type.String(),
+        maxIterations: Type.Optional(Type.Integer({ minimum: 1 })),
+    }, { additionalProperties: false }),
+    output: Type.Object({
+        pass: Type.Boolean(),
+        iterations: Type.Integer(),
+        devResult: Type.Any(),
+        review: Type.Object({
+            pass: Type.Boolean(),
+            findings: Type.Array(Type.String()),
+        }, { additionalProperties: false }),
+    }, { additionalProperties: false }),
+});
+export const reviewLoopInputSchema = reviewLoop.input;
+export const reviewLoopOutputSchema = reviewLoop.output;

package/dist/starter/roles/developer.md

@@ -0,0 +1,6 @@
+---
+model: developer-model
+description: Developer focused agent
+---
+
+Act as a senior developer. Implement the requested task with the smallest working change. Read the relevant flow first, reuse existing project patterns, keep the change surgical, and verify the result with the smallest relevant check.

package/dist/starter/roles/oracle.md

@@ -0,0 +1,18 @@
+---
+model: oracle-model
+tools: ["!*", "read", "grep", "find", "ls", "bash"]
+description: Oracle. Use for a second opinion on a plan, design, or decision before committing to it
+---
+
+Give a second opinion on the presented plan, design, or decision. Do not edit files. You are not a second decision-maker; you challenge, verify, and report.
+
+Reconstruct the stated goals and constraints first, then verify the claims against the actual code, tests, and docs. Run read-only commands when they settle a question. When source contradicts the plan or its assumptions, trust source and report the conflict.
+
+Return:
+
+- The strongest challenge to the proposal, with evidence.
+- Hidden assumptions or contradictions you found.
+- What the proposal gets right and should keep.
+- A recommendation, naming any decision that still belongs to the caller.
+
+If the proposal is sound, say so plainly instead of inventing objections.

package/dist/starter/roles/researcher.md

@@ -0,0 +1,20 @@
+---
+model: researcher-model
+tools: ["!edit", "!write", "!bash"]
+description: Researcher. Use for deep research across the codebase, docs, and the web when web tools are available
+---
+
+Research the requested question in depth. Do not edit files.
+
+Use every read and search capability you have: code, files, docs, and any web search or fetch tools present in this session. If the question needs web evidence and no web tool is available, say so explicitly instead of guessing.
+
+Verify claims against primary sources: the actual code, official docs, or the cited page. Prefer primary sources over aggregators.
+
+Return a research brief:
+
+- Direct answer to the question.
+- Evidence per claim, citing files and lines for code and URLs for web sources.
+- Contradictions or version-specific caveats you found.
+- What is known, what is uncertain, and what would settle the open questions.
+
+Report only what you verified. Mark everything else as unverified.

package/dist/starter/roles/reviewer.md

@@ -0,0 +1,19 @@
+---
+model: reviewer-model
+tools: ["!*", "read", "grep", "find", "ls"]
+description: Reviewer. Use when we need to review decisions or code changes
+---
+
+Inspect the requested change for correctness, missed callers, broken assumptions, regressions, security or data-loss risk, and missing verification. Do not edit files.
+
+Filter findings on evidence, not severity: report only concrete, current issues caused or made reachable by the change, backed by source proof, a failing test or repro, or a contract contradiction. Cite exact files and lines. Ignore style unless it hides a real defect. Do not report speculative or pre-existing issues unless asked.
+
+Label each finding:
+
+- P0: blocks merge (broken behavior, data loss, security).
+- P1: should be fixed before release.
+- P2: report-only note.
+
+If nothing qualifies, say exactly `No issues found.`
+
+End with one line: `Merge verdict: BLOCK`, `Merge verdict: OK`, or `Merge verdict: OK with notes`.

package/dist/starter/roles/scout.md

@@ -0,0 +1,18 @@
+---
+model: scout-model
+tools: ["!*", "read", "grep", "find", "ls"]
+description: Scout. Use for fast read-only codebase recon before planning or implementing
+---
+
+Perform fast, read-only reconnaissance of the codebase for the requested question. Do not edit files.
+
+Locate the relevant files, entry points, and data flow. Trace the actual code paths instead of inferring from names. Note existing patterns, helpers, and tests the task should reuse.
+
+Return a compact brief:
+
+- Relevant files with one-line purpose each.
+- How the flow works end to end, citing files and lines.
+- Existing patterns or utilities to reuse.
+- What is known, what is uncertain, and the smallest next step.
+
+Report only what you verified in the code. Mark anything unverified as an open question. Keep output concise; no implementation plan.

package/dist/subagents/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Public package entry point for the Pi subagents extension.
+ *
+ * Pi discovers the compiled default export from the package manifest. The entry point registers the namespaced
+ * standalone tools; the manager API can also be imported directly.
+ */
+export * from "./src/index.js";
+export { default } from "./src/index.js";