@ryanfw/prompt-orchestration-pipeline 1.3.0 → 1.3.2

package/src/harness/index.ts

@@ -0,0 +1,22 @@
+export {
+  run,
+  getHarnessStatus,
+  discoverHarnesses,
+  listModels,
+  HarnessRunError,
+} from "local-llm-cli-adapter";
+
+export type {
+  HarnessName,
+  HarnessEvent,
+  Usage,
+  RunFailureReason,
+  RunResult,
+  RunOptions,
+  HarnessRun,
+  HarnessStatus,
+  ModelOption,
+  ModelPayload,
+  McpServerConfig,
+  PermissionMode,
+} from "local-llm-cli-adapter";

package/src/harness/mcp-io-server.ts

@@ -4,7 +4,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
 import { z } from "zod";
 import type { TaskFileIO } from "../core/file-io.ts";
-import type { McpServerConnection } from "./types.ts";
+import type { McpServerConnection } from "../core/agent-types.ts";
 
 export interface McpIoServerHandle {
   connection: McpServerConnection;

package/src/ui/client/hooks/useJobListWithUpdates.ts

@@ -33,8 +33,23 @@ function sortNormalizedJobs(jobs: NormalizedJobSummary[]): NormalizedJobSummary[
   });
 }
 
+function completedCountFromTasks(job: NormalizedJobSummary): number {
+  return Object.values(job.tasks).filter((task) => task.state === "done" || task.state === "skipped").length;
+}
+
+function comparableJob(job: NormalizedJobSummary): Record<string, unknown> {
+  const comparable: Record<string, unknown> = { ...job };
+  for (const [key, value] of Object.entries(comparable)) {
+    if (value === undefined) delete comparable[key];
+  }
+  if (comparable["completedCount"] === completedCountFromTasks(job)) {
+    delete comparable["completedCount"];
+  }
+  return comparable;
+}
+
 function jobsEqual(left: NormalizedJobSummary[], right: NormalizedJobSummary[]): boolean {
-  return JSON.stringify(left) === JSON.stringify(right);
+  return JSON.stringify(left.map(comparableJob)) === JSON.stringify(right.map(comparableJob));
 }
 
 function mergeJob(current: NormalizedJobSummary, incoming: NormalizedJobSummary): NormalizedJobSummary {

package/src/ui/dist/assets/{index-D7hzshSS.js → index--RH3sAt3.js}

@@ -20094,6 +20094,15 @@ const createLucideIcon = (iconName, iconNode) => {
   Component.displayName = toPascalCase(iconName);
   return Component;
 };
+const __iconNode$h = [
+  ["path", { d: "M12 8V4H8", key: "hb8ula" }],
+  ["rect", { width: "16", height: "12", x: "4", y: "8", rx: "2", key: "enze0r" }],
+  ["path", { d: "M2 14h2", key: "vft8re" }],
+  ["path", { d: "M20 14h2", key: "4cs60a" }],
+  ["path", { d: "M15 13v2", key: "1xurst" }],
+  ["path", { d: "M9 13v2", key: "rq6x2g" }]
+];
+const Bot = createLucideIcon("bot", __iconNode$h);
 const __iconNode$g = [["path", { d: "M20 6 9 17l-5-5", key: "1gmf2c" }]];
 const Check = createLucideIcon("check", __iconNode$g);
 const __iconNode$f = [["path", { d: "m6 9 6 6 6-6", key: "qrunsl" }]];
@@ -21096,6 +21105,7 @@ const SECTIONS = [
   { id: "run-control", label: "Run Control", icon: GitBranch },
   { id: "io-api", label: "IO API", icon: Database },
   { id: "llm-api", label: "LLM API", icon: Cpu },
+  { id: "agent-api", label: "Agent API", icon: Bot },
   { id: "validation", label: "Validation", icon: Shield }
 ];
 const SAMPLE_PIPELINE_JSON = {
@@ -21226,6 +21236,26 @@ const VALIDATION_EXAMPLE_CODE = `export const validateStructure = async ({
   }
   return { output: {}, flags };
 };`;
+const AGENT_OPTIONS = [
+  { name: "harness", required: true, type: '"claude" | "codex" | "opencode"', description: "Which CLI agent to run." },
+  { name: "prompt", required: true, type: "string", description: "The instruction handed to the agent. Build it from seed or upstream stage data." },
+  { name: "model", required: false, type: "string", description: "Model id passed through to the CLI verbatim." },
+  { name: "io", required: false, type: "boolean", description: "Bridge POP file I/O into the agent (read_artifact / write_artifact tools). Default true." },
+  { name: "timeoutMs", required: false, type: "number", description: "Overall wall-clock cap in milliseconds." },
+  { name: "captureDiff", required: false, type: "boolean", description: "Capture a git diff of the working tree as an agent.patch artifact." }
+];
+const AGENT_EXAMPLE_CODE = `export const inference = async ({ runAgent, io, data, flags }) => {
+  // Build the prompt programmatically from upstream data
+  const prompt = \`Summarize: \${data.ingestion.topic}.\` +
+    " Save the summary as a POP artifact named summary.md via write_artifact.";
+
+  const result = await runAgent({ harness: "claude", prompt });
+  if (!result.ok) throw new Error(result.error);
+
+  // The agent wrote summary.md through POP's bridged file I/O
+  const summary = await io.readArtifact("summary.md");
+  return { output: { summary }, flags };
+};`;
 function CollapsibleSection({
   id,
   title,
@@ -21693,6 +21723,91 @@ function Code() {
               ]
             }
           ) }),
+          /* @__PURE__ */ jsxRuntimeExports.jsx("div", { id: "agent-api", ref: sectionRef("agent-api"), className: "scroll-mt-24", children: /* @__PURE__ */ jsxRuntimeExports.jsxs(
+            CollapsibleSection,
+            {
+              id: "agent-api",
+              title: "Agent API",
+              icon: Bot,
+              isOpen: openSections["agent-api"],
+              onToggle: () => toggle("agent-api"),
+              children: [
+                /* @__PURE__ */ jsxRuntimeExports.jsxs("p", { className: "text-base text-gray-600 mb-6", children: [
+                  "Run a CLI coding agent (claude, codex, or opencode) from inside a task stage with",
+                  " ",
+                  /* @__PURE__ */ jsxRuntimeExports.jsx("code", { className: "text-sm font-mono", children: "runAgent" }),
+                  ". Unlike a single",
+                  " ",
+                  /* @__PURE__ */ jsxRuntimeExports.jsx("code", { className: "text-sm font-mono", children: "llm" }),
+                  " call, the agent uses tools over multiple turns and can read and write the task's artifacts."
+                ] }),
+                /* @__PURE__ */ jsxRuntimeExports.jsxs("div", { className: "space-y-6", children: [
+                  /* @__PURE__ */ jsxRuntimeExports.jsxs("div", { children: [
+                    /* @__PURE__ */ jsxRuntimeExports.jsx("span", { className: "text-sm font-medium mb-3 block", children: "Options" }),
+                    /* @__PURE__ */ jsxRuntimeExports.jsx("div", { className: "border border-gray-200 rounded-md overflow-hidden", children: /* @__PURE__ */ jsxRuntimeExports.jsxs("table", { className: "w-full text-sm", children: [
+                      /* @__PURE__ */ jsxRuntimeExports.jsx("thead", { children: /* @__PURE__ */ jsxRuntimeExports.jsxs("tr", { children: [
+                        /* @__PURE__ */ jsxRuntimeExports.jsx("th", { className: "bg-gray-50 px-4 py-3 text-left font-medium", children: "Option" }),
+                        /* @__PURE__ */ jsxRuntimeExports.jsx("th", { className: "bg-gray-50 px-4 py-3 text-left font-medium", children: "Type" }),
+                        /* @__PURE__ */ jsxRuntimeExports.jsx("th", { className: "bg-gray-50 px-4 py-3 text-left font-medium", children: "Required" }),
+                        /* @__PURE__ */ jsxRuntimeExports.jsx("th", { className: "bg-gray-50 px-4 py-3 text-left font-medium", children: "Description" })
+                      ] }) }),
+                      /* @__PURE__ */ jsxRuntimeExports.jsx("tbody", { children: AGENT_OPTIONS.map((field) => /* @__PURE__ */ jsxRuntimeExports.jsxs("tr", { className: "border-t border-gray-100", children: [
+                        /* @__PURE__ */ jsxRuntimeExports.jsx("td", { className: "px-4 py-3", children: /* @__PURE__ */ jsxRuntimeExports.jsx("code", { className: "text-sm font-mono", children: field.name }) }),
+                        /* @__PURE__ */ jsxRuntimeExports.jsx("td", { className: "px-4 py-3", children: /* @__PURE__ */ jsxRuntimeExports.jsx("code", { className: "text-xs font-mono text-gray-600", children: field.type }) }),
+                        /* @__PURE__ */ jsxRuntimeExports.jsx("td", { className: "px-4 py-3", children: field.required ? /* @__PURE__ */ jsxRuntimeExports.jsx("span", { className: "text-red-600 font-medium", children: "Yes" }) : /* @__PURE__ */ jsxRuntimeExports.jsx("span", { className: "text-gray-400", children: "No" }) }),
+                        /* @__PURE__ */ jsxRuntimeExports.jsx("td", { className: "px-4 py-3 text-gray-600", children: field.description })
+                      ] }, field.name)) })
+                    ] }) })
+                  ] }),
+                  /* @__PURE__ */ jsxRuntimeExports.jsxs("div", { children: [
+                    /* @__PURE__ */ jsxRuntimeExports.jsx("span", { className: "text-sm font-medium mb-2 block", children: "Returns" }),
+                    /* @__PURE__ */ jsxRuntimeExports.jsx("div", { className: "bg-gray-50 rounded-md p-3 border border-gray-200", children: /* @__PURE__ */ jsxRuntimeExports.jsx("code", { className: "text-sm font-mono", children: `Promise<{ ok, finalMessage, artifactsWritten, usage?, costUsd?, sessionId?, error? }>` }) })
+                  ] }),
+                  /* @__PURE__ */ jsxRuntimeExports.jsxs("div", { className: "bg-[#f5f3ff] border border-[#ede9fe] rounded-md p-4", children: [
+                    /* @__PURE__ */ jsxRuntimeExports.jsxs("div", { className: "flex items-center gap-2 mb-2", children: [
+                      /* @__PURE__ */ jsxRuntimeExports.jsx(Bot, { className: "h-4 w-4 text-[#6d28d9]" }),
+                      /* @__PURE__ */ jsxRuntimeExports.jsx("span", { className: "text-sm font-medium text-gray-900", children: "runAgent vs llm vs agent entries" }),
+                      /* @__PURE__ */ jsxRuntimeExports.jsx(Badge, { intent: "green", children: "NEW" })
+                    ] }),
+                    /* @__PURE__ */ jsxRuntimeExports.jsxs("ul", { className: "space-y-1 text-sm text-gray-700", children: [
+                      /* @__PURE__ */ jsxRuntimeExports.jsxs("li", { className: "flex items-start gap-2", children: [
+                        /* @__PURE__ */ jsxRuntimeExports.jsx("span", { className: "text-[#6d28d9] mt-0.5", children: "•" }),
+                        /* @__PURE__ */ jsxRuntimeExports.jsxs("span", { children: [
+                          "Use ",
+                          /* @__PURE__ */ jsxRuntimeExports.jsx("code", { className: "font-mono text-xs", children: "llm.<provider>.chat()" }),
+                          " for a single request/response model call."
+                        ] })
+                      ] }),
+                      /* @__PURE__ */ jsxRuntimeExports.jsxs("li", { className: "flex items-start gap-2", children: [
+                        /* @__PURE__ */ jsxRuntimeExports.jsx("span", { className: "text-[#6d28d9] mt-0.5", children: "•" }),
+                        /* @__PURE__ */ jsxRuntimeExports.jsxs("span", { children: [
+                          "Use ",
+                          /* @__PURE__ */ jsxRuntimeExports.jsx("code", { className: "font-mono text-xs", children: "runAgent()" }),
+                          " for a tool-using CLI agent that reads and writes files over multiple turns."
+                        ] })
+                      ] }),
+                      /* @__PURE__ */ jsxRuntimeExports.jsxs("li", { className: "flex items-start gap-2", children: [
+                        /* @__PURE__ */ jsxRuntimeExports.jsx("span", { className: "text-[#6d28d9] mt-0.5", children: "•" }),
+                        /* @__PURE__ */ jsxRuntimeExports.jsxs("span", { children: [
+                          "Prefer ",
+                          /* @__PURE__ */ jsxRuntimeExports.jsx("code", { className: "font-mono text-xs", children: "runAgent()" }),
+                          " over a static",
+                          " ",
+                          /* @__PURE__ */ jsxRuntimeExports.jsx("code", { className: "font-mono text-xs", children: "agent:" }),
+                          " pipeline entry when the prompt is built from seed or stage data."
+                        ] })
+                      ] })
+                    ] })
+                  ] }),
+                  /* @__PURE__ */ jsxRuntimeExports.jsxs("div", { children: [
+                    /* @__PURE__ */ jsxRuntimeExports.jsx("span", { className: "text-sm font-medium mb-2 block", children: "Usage Example" }),
+                    /* @__PURE__ */ jsxRuntimeExports.jsx(CopyableCodeBlock, { maxHeight: "260px", children: AGENT_EXAMPLE_CODE })
+                  ] }),
+                  /* @__PURE__ */ jsxRuntimeExports.jsx("div", { className: "text-sm text-gray-500", children: "Requires the selected harness CLI to be installed and authenticated on the host." })
+                ] })
+              ]
+            }
+          ) }),
           /* @__PURE__ */ jsxRuntimeExports.jsx("div", { id: "validation", ref: sectionRef("validation"), className: "scroll-mt-24", children: /* @__PURE__ */ jsxRuntimeExports.jsxs(
             CollapsibleSection,
             {
@@ -78316,8 +78431,21 @@ function sortNormalizedJobs(jobs) {
     return left.jobId.localeCompare(right.jobId);
   });
 }
+function completedCountFromTasks(job) {
+  return Object.values(job.tasks).filter((task) => task.state === "done" || task.state === "skipped").length;
+}
+function comparableJob(job) {
+  const comparable = { ...job };
+  for (const [key, value] of Object.entries(comparable)) {
+    if (value === void 0) delete comparable[key];
+  }
+  if (comparable["completedCount"] === completedCountFromTasks(job)) {
+    delete comparable["completedCount"];
+  }
+  return comparable;
+}
 function jobsEqual(left, right) {
-  return JSON.stringify(left) === JSON.stringify(right);
+  return JSON.stringify(left.map(comparableJob)) === JSON.stringify(right.map(comparableJob));
 }
 function mergeJob(current, incoming) {
   return {