@bastani/atomic 0.8.21-0 → 0.8.22-0

package/dist/builtin/workflows/builtin/goal.ts

@@ -10,7 +10,8 @@ import { randomUUID } from "node:crypto";
 import { mkdtemp, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { join } from "node:path";
-import { defineWorkflow } from "../src/index.js";
+import { defineWorkflow } from "../src/workflows/define-workflow.js";
+import { Type } from "typebox";
 import type { WorkflowTaskResult } from "../src/shared/types.js";
 import { WORKER_PREFLIGHT_CONTRACT } from "./shared-prompts.js";
 
@@ -127,12 +128,6 @@ type ReducerOutcome = {
   readonly blockerObservation?: BlockerObservation;
 };
 
-type GoalInputs = {
-  readonly objective?: string;
-  readonly max_turns?: number;
-  readonly base_branch?: string;
-};
-
 function positiveInteger(value: number | undefined, fallback: number): number {
   if (typeof value !== "number" || !Number.isFinite(value) || value <= 0) {
     return fallback;
@@ -790,7 +785,7 @@ function renderReviewerPrompt(args: {
       [
         "Inspect the actual diff/repository state rather than trusting stage summaries.",
         "Identify the smallest relevant validation set from repository evidence: targeted tests, lint, typecheck, build, generated-artifact checks, CI-equivalent scripts, or user-flow proof.",
-        "When practical, include an end-to-end QA check that exercises the app the way a user would: use the tmux skill for terminal app environments and playwright-cli for web app environments.",
+        "When practical, include an end-to-end QA check that exercises the app the way a user would: use the tmux skill for terminal app environments and browser-use for web app environments.",
         "For web app environments, capture a screenshot as a certificate of correct completion when the UI state proves the objective; for terminal app environments, capture the terminal window/output that shows proof of correctness.",
         "Run or delegate focused validation when it is necessary to distinguish a real bug from a hunch.",
         "If tests or typechecks fail because dependencies are missing, install/download the missing dependencies with the repo's documented package manager instead of bypassing the check.",
@@ -962,26 +957,45 @@ export default defineWorkflow("goal")
   .description(
     "Goal Runner workflow with bounded LM turns, ledger artifacts, parallel reviewers, and reducer-gated completion.",
   )
-  .input("objective", {
-    type: "text",
-    required: true,
-    description: "The objective for the Goal Runner workflow.",
-  })
-  .input("max_turns", {
-    type: "number",
+  .input("objective", Type.String({ description: "The objective for the Goal Runner workflow." }))
+  .input("max_turns", Type.Number({
     default: DEFAULT_MAX_TURNS,
-    description:
-      "Maximum worker/review turns before Goal Runner stops as needs_human.",
-  })
-  .input("base_branch", {
-    type: "string",
+    description: "Maximum worker/review turns before Goal Runner stops as needs_human.",
+  }))
+  .input("base_branch", Type.String({
     default: "origin/main",
-    description:
-      "Optional branch reviewers compare the current code delta against (default origin/main).",
-  })
+    description: "Optional branch reviewers compare the current code delta against (default origin/main).",
+  }))
+  .output("result", Type.Optional(Type.String({ description: "Final report with objective, status, receipts, turns, and remaining work." })))
+  .output("status", Type.Optional(Type.Union(
+    [Type.Literal("complete"), Type.Literal("blocked"), Type.Literal("needs_human"), Type.Literal("active")],
+    { description: "Final reducer status: complete, blocked, needs_human, or active if externally interrupted." },
+  )))
+  .output("approved", Type.Optional(Type.Boolean({ description: "Whether the reducer reached complete." })))
+  .output("goal_id", Type.Optional(Type.String({ description: "Per-run goal identifier stored in the ledger." })))
+  .output("objective", Type.Optional(Type.String({ description: "Normalized goal objective used by the run." })))
+  .output("ledger_path", Type.Optional(Type.String({ description: "OS-temp path to goal-ledger.json with receipts, reviewer decisions, blockers, and lifecycle events." })))
+  .output("turns_completed", Type.Optional(Type.Number({ description: "Worker/review turns completed." })))
+  .output("iterations_completed", Type.Optional(Type.Number({ description: "Worker/review turns completed, retained for status summaries." })))
+  .output(
+    "receipts",
+    Type.Optional(
+      Type.Array(
+        Type.Object({
+          turn: Type.Number(),
+          stage: Type.String(),
+          artifact_path: Type.String(),
+          summary: Type.String(),
+        }),
+        { description: "Ledger receipt summaries and worker artifact paths." },
+      ),
+    ),
+  )
+  .output("remaining_work", Type.Optional(Type.String({ description: "Remaining gaps or blockers when incomplete, or none." })))
+  .output("review_report", Type.Optional(Type.String({ description: "Markdown report containing the last structured reviewer decision payloads used by the reducer." })))
   .run(async (ctx) => {
-    const inputs = ctx.inputs as GoalInputs;
-    const objective = (inputs.objective ?? "").trim();
+    const inputs = ctx.inputs;
+    const objective = inputs.objective.trim();
     if (!objective) {
       throw new Error("goal requires an objective input.");
     }

package/dist/builtin/workflows/builtin/open-claude-design.ts

@@ -21,13 +21,14 @@
  *
  * The refinement loop has been re-shaped so that the artifact under review is
  * a real HTML page on disk (`preview.html`). The workflow attempts to open it
- * through `playwright-cli` so the user can interactively review and annotate;
- * when playwright-cli is unavailable, the file path is surfaced so the user
+ * through `browser-use` so the user can interactively review and annotate;
+ * when browser-use is unavailable, the file path is surfaced so the user
  * can open it manually. The final exporter produces a rich `spec.html` that
  * embeds the agreed-upon design alongside the implementation handoff.
  */
 
-import { defineWorkflow } from "../src/index.js";
+import { defineWorkflow } from "../src/workflows/define-workflow.js";
+import { Type } from "typebox";
 import type {
   WorkflowTaskResult,
   WorkflowTaskStep,
@@ -140,7 +141,7 @@ function prepareArtifactDir(cwd = process.cwd()): {
   }
   // Last-resort: synthesize paths even if mkdir failed; downstream agents will
   // recreate parents using their Write tool.
-  const fallback = join(tmpdir(), "pi-open-claude-design", runId);
+  const fallback = join(tmpdir(), "open-claude-design", runId);
   return {
     runId,
     artifactDir: fallback,
@@ -164,56 +165,52 @@ const ANTI_SLOP_RULES = [
   "Commit to a specific aesthetic direction; do not hedge with generic SaaS defaults.",
 ].join("\n");
 
-const PLAYWRIGHT_BROWSER_BOOTSTRAP_RULES = [
-  "Probe for playwright-cli availability with `playwright-cli --version` (or `npx --no-install playwright-cli --version` when relying on a project-local install). Do not install playwright-cli itself.",
-  "If playwright-cli is available but opening a page fails because Chrome, Chrome for Testing, Chromium, or another browser executable is not installed, run `playwright-cli install-browser chrome-for-testing` (or the equivalent `npx --no-install playwright-cli install-browser chrome-for-testing`) and retry the browser action once.",
-  "Only install the missing browser runtime; do not install npm packages, change project dependencies, or repeatedly retry failed installs.",
-  "If playwright-cli is unavailable or browser installation still fails, degrade gracefully and surface the manual file path / URL.",
+const BROWSER_USE_BOOTSTRAP_RULES = [
+  "Probe for browser-use availability with `browser-use --version` (or `bunx browser-use --version` when relying on an ephemeral Bun execution). Do not install browser-use itself.",
+  "If browser-use is available but opening a page fails because Chrome, Chrome for Testing, Chromium, or another browser executable is not installed, first run `browser-use doctor`, then run `browser-use setup` if the doctor output recommends setup, and retry the browser action once.",
+  "Only install or configure the missing browser runtime; do not install npm packages, change project dependencies, or repeatedly retry failed setup.",
+  "If browser-use is unavailable or browser setup still fails, degrade gracefully and surface the manual file path / URL.",
 ].join("\n");
 
 export default defineWorkflow("open-claude-design")
   .description(
-    "AI-powered design workflow: design-system onboarding → reference import → HTML generation → impeccable-driven refinement → quality gate → rich HTML handoff. Each stage delegates to a specific impeccable sub-skill; the user can iteratively review and annotate the generated HTML through playwright-cli.",
+    "AI-powered design workflow: design-system onboarding → reference import → HTML generation → impeccable-driven refinement → quality gate → rich HTML handoff. Each stage delegates to a specific impeccable sub-skill; the user can iteratively review and annotate the generated HTML through browser-use.",
   )
-  .input("prompt", {
-    type: "text",
-    required: true,
-    description:
-      "What to design (for example, a dashboard, page, component, or prototype).",
-  })
-  .input("reference", {
-    type: "text",
-    required: false,
-    description:
-      "URL, file path, screenshot path, or design doc to import as a reference.",
-  })
-  .input("output_type", {
-    type: "select",
-    choices: OUTPUT_TYPES,
-    default: DEFAULT_OUTPUT_TYPE,
-    description: "Kind of design artifact to produce.",
-  })
-  .input("design_system", {
-    type: "text",
-    required: false,
+  .input("prompt", Type.String({
+    description: "What to design (for example, a dashboard, page, component, or prototype).",
+  }))
+  .input("reference", Type.Optional(Type.String({
+    description: "URL, file path, screenshot path, or design doc to import as a reference.",
+  })))
+  .input("output_type", Type.Union(
+    [...OUTPUT_TYPES].map((value) => Type.Literal(value)),
+    { default: DEFAULT_OUTPUT_TYPE, description: "Kind of design artifact to produce." },
+  ))
+  .input("design_system", Type.Optional(Type.String({
     description:
       "Path(s) or description of an existing design system (DESIGN.md, PRODUCT.md, etc.); skips onboarding when provided.",
-  })
-  .input("max_refinements", {
-    type: "number",
+  })))
+  .input("max_refinements", Type.Number({
     default: DEFAULT_MAX_REFINEMENTS,
     description: `Maximum critique/apply refinement iterations (default ${DEFAULT_MAX_REFINEMENTS}).`,
-  })
+  }))
+  .output("output_type", Type.Optional(Type.String({ description: "Kind of design artifact produced." })))
+  .output("design_system", Type.Optional(Type.String({ description: "Design system source used for generation: supplied input or project-derived design system." })))
+  .output("artifact", Type.Optional(Type.String({ description: "Latest final design summary from the approved preview artifact." })))
+  .output("handoff", Type.Optional(Type.String({ description: "Final rich HTML spec and implementation handoff summary." })))
+  .output("approved_for_export", Type.Optional(Type.Boolean({ description: "Whether refinement completed before the final export gate." })))
+  .output("refinements_completed", Type.Optional(Type.Number({ description: "Number of refinement iterations completed." })))
+  .output("import_context", Type.Optional(Type.String({ description: "Reference-import context used during generation." })))
+  .output("run_id", Type.Optional(Type.String({ description: "Per-run design workflow artifact identifier." })))
+  .output("artifact_dir", Type.Optional(Type.String({ description: "Directory containing preview and spec artifacts." })))
+  .output("preview_path", Type.Optional(Type.String({ description: "Absolute path to the generated preview.html file." })))
+  .output("preview_file_url", Type.Optional(Type.String({ description: "file:// URL for the generated preview.html file." })))
+  .output("spec_path", Type.Optional(Type.String({ description: "Absolute path to the generated spec.html file." })))
+  .output("spec_file_url", Type.Optional(Type.String({ description: "file:// URL for the generated spec.html file." })))
   .run(async (ctx) => {
-    const inputs = ctx.inputs as {
-      prompt?: string;
-      reference?: string;
-      output_type?: string;
-      design_system?: string;
-      max_refinements?: number;
-    };
+    const inputs = ctx.inputs;
 
-    const prompt = inputs.prompt ?? "";
+    const prompt = inputs.prompt;
     const reference = inputs.reference?.trim() ?? "";
     const outputType = normalizeOutputType(inputs.output_type);
     const designSystemInput = (inputs.design_system ?? "").trim();
@@ -456,12 +453,12 @@ export default defineWorkflow("open-claude-design")
             "impeccable_skill",
             "extract — separate one-off styling from repeated, intentional patterns. Only carry forward what is used 3+ times or what is structurally load-bearing.",
           ],
-          ["playwright_browser_bootstrap", PLAYWRIGHT_BROWSER_BOOTSTRAP_RULES],
+          ["browser_use_bootstrap", BROWSER_USE_BOOTSTRAP_RULES],
           [
             "instructions",
             [
-              "1. Use browser/screenshot tooling (e.g. playwright-cli) if available; cite observable evidence rather than guessing.",
-              "2. If playwright-cli is available but opening the reference URL reports a missing browser executable, install Chrome for Testing with the bootstrap command and retry once.",
+              "1. Use browser/screenshot tooling (e.g. browser-use) if available; cite observable evidence rather than guessing.",
+              "2. If browser-use is available but opening the reference URL reports a missing browser executable, follow the bootstrap rules and retry once.",
               "3. Analyze: layout, visual hierarchy, navigation, color, typography, spacing, states, interactions, responsive behavior.",
               "4. Separate reference-specific styling from requirements that should transfer to this project's design system.",
               "5. If the URL is inaccessible or browser bootstrap fails, state that and provide a best-effort fallback based only on available information — never fabricate observations.",
@@ -570,7 +567,7 @@ export default defineWorkflow("open-claude-design")
     let approvedForExport = false;
     let refinementCount = 0;
 
-    // Try to display the freshly generated preview to the user via playwright-cli.
+    // Try to display the freshly generated preview to the user via browser-use.
     await ctx
       .task("preview-display-initial", {
         prompt: taggedPrompt([
@@ -580,19 +577,19 @@ export default defineWorkflow("open-claude-design")
           ],
           [
             "objective",
-            "Open the HTML preview file in a browser using playwright-cli and prompt the user for annotated feedback. Gracefully degrade if playwright-cli is unavailable.",
+            "Open the HTML preview file in a browser using browser-use and prompt the user for annotated feedback. Gracefully degrade if browser-use is unavailable.",
           ],
           ["preview_path", previewPath],
           ["preview_file_url", previewFileUrl],
-          ["playwright_browser_bootstrap", PLAYWRIGHT_BROWSER_BOOTSTRAP_RULES],
+          ["browser_use_bootstrap", BROWSER_USE_BOOTSTRAP_RULES],
           [
             "instructions",
             [
-              "1. Probe for playwright-cli availability using the bootstrap rules above.",
-              `2. If available, run: \`playwright-cli open ${previewFileUrl}\`. If that reports a missing browser executable, install Chrome for Testing with the bootstrap command and retry once.`,
-              "3. Then run `playwright-cli show --annotate` so the user can draw boxes and leave notes directly on the live page.",
+              "1. Probe for browser-use availability using the bootstrap rules above.",
+              `2. If available, run: \`browser-use open ${previewFileUrl}\`. If that reports a missing browser executable, follow the bootstrap rules and retry once.`,
+              "3. Then run `browser-use show --annotate` so the user can draw boxes and leave notes directly on the live page.",
               "4. Once the user finishes annotating, capture the returned annotated snapshot path / notes and surface them in your output.",
-              `5. If playwright-cli is NOT available or browser bootstrap fails, print a clear instruction block telling the user to open the file manually at: ${previewPath} (or via the URL ${previewFileUrl}).`,
+              `5. If browser-use is NOT available or browser bootstrap fails, print a clear instruction block telling the user to open the file manually at: ${previewPath} (or via the URL ${previewFileUrl}).`,
               "6. Never block the workflow on unavailable tooling; always exit with a non-empty status string.",
             ].join("\n"),
           ],
@@ -713,16 +710,16 @@ export default defineWorkflow("open-claude-design")
               ["preview_file_url", previewFileUrl],
               ["current_design_and_feedback", "{previous}"],
               [
-                "playwright_browser_bootstrap",
-                PLAYWRIGHT_BROWSER_BOOTSTRAP_RULES,
+                "browser_use_bootstrap",
+                BROWSER_USE_BOOTSTRAP_RULES,
               ],
               [
                 "instructions",
                 [
-                  `1. Attempt rendering verification via playwright-cli: \`playwright-cli open ${previewFileUrl}\`. If that reports a missing browser executable, install Chrome for Testing with the bootstrap command and retry once.`,
-                  `2. Then run \`playwright-cli resize 360 800\`, \`playwright-cli screenshot --filename=${join(artifactDir, `mobile-${iteration}.png`)}\`, \`playwright-cli resize 1440 900\`, \`playwright-cli screenshot --filename=${join(artifactDir, `desktop-${iteration}.png`)}\`.`,
+                  `1. Attempt rendering verification via browser-use: \`browser-use open ${previewFileUrl}\`. If that reports a missing browser executable, follow the bootstrap rules and retry once.`,
+                  `2. Then run \`browser-use resize 360 800\`, \`browser-use screenshot ${join(artifactDir, `mobile-${iteration}.png`)}\`, \`browser-use resize 1440 900\`, \`browser-use screenshot ${join(artifactDir, `desktop-${iteration}.png`)}\`.`,
                   "3. Check: contrast (WCAG AA), overflow, spacing rhythm, alignment, breakpoint behavior, empty/loading/error states, keyboard/pointer affordances, focus rings, prefers-reduced-motion.",
-                  "4. If playwright-cli is unavailable or browser bootstrap fails, perform a static design review of the HTML source and mark every finding as `needs-rendering-verification`.",
+                  "4. If browser-use is unavailable or browser bootstrap fails, perform a static design review of the HTML source and mark every finding as `needs-rendering-verification`.",
                   "5. Distinguish confirmed visual issues from risks that need rendering verification. Never fabricate rendered evidence.",
                 ].join("\n"),
               ],
@@ -804,15 +801,15 @@ export default defineWorkflow("open-claude-design")
             ["preview_path", previewPath],
             ["preview_file_url", previewFileUrl],
             [
-              "playwright_browser_bootstrap",
-              PLAYWRIGHT_BROWSER_BOOTSTRAP_RULES,
+              "browser_use_bootstrap",
+              BROWSER_USE_BOOTSTRAP_RULES,
             ],
             [
               "instructions",
               [
-                `1. If playwright-cli is available, run \`playwright-cli goto ${previewFileUrl}\` (or \`playwright-cli open ${previewFileUrl}\` if no session is active). If that reports a missing browser executable, install Chrome for Testing with the bootstrap command and retry once.`,
-                "2. Then run `playwright-cli show --annotate` to invite annotated feedback.",
-                `3. If playwright-cli is unavailable or browser bootstrap fails, surface the path clearly: ${previewPath} (URL: ${previewFileUrl}).`,
+                `1. If browser-use is available, run \`browser-use open ${previewFileUrl}\`. If that reports a missing browser executable, follow the bootstrap rules and retry once.`,
+                "2. Then run `browser-use show --annotate` to invite annotated feedback.",
+                `3. If browser-use is unavailable or browser bootstrap fails, surface the path clearly: ${previewPath} (URL: ${previewFileUrl}).`,
                 "4. Return any captured annotations as structured notes the next user-feedback step can read.",
                 "5. Do not block on unavailable tooling.",
               ].join("\n"),
@@ -941,7 +938,7 @@ export default defineWorkflow("open-claude-design")
             "Return markdown with headings (NOT the HTML):",
             "1. Spec written to (absolute path)",
             "2. Sections included",
-            "3. How to open the spec (playwright-cli command + manual fallback path)",
+            "3. How to open the spec (browser-use command + manual fallback path)",
             "4. Recommended files and components",
             "5. Implementation steps",
             "6. Usage example",
@@ -965,19 +962,19 @@ export default defineWorkflow("open-claude-design")
           ],
           [
             "objective",
-            "Open the final spec.html in a browser via playwright-cli so the user can review the agreed design and implementation handoff. Degrade gracefully if playwright-cli is unavailable.",
+            "Open the final spec.html in a browser via browser-use so the user can review the agreed design and implementation handoff. Degrade gracefully if browser-use is unavailable.",
           ],
           ["spec_path", specPath],
           ["spec_file_url", specFileUrl],
           ["preview_path", previewPath],
           ["preview_file_url", previewFileUrl],
-          ["playwright_browser_bootstrap", PLAYWRIGHT_BROWSER_BOOTSTRAP_RULES],
+          ["browser_use_bootstrap", BROWSER_USE_BOOTSTRAP_RULES],
           [
             "instructions",
             [
-              "1. Probe for playwright-cli availability using the bootstrap rules above.",
-              `2. If available, run \`playwright-cli open ${specFileUrl}\`. If that reports a missing browser executable, install Chrome for Testing with the bootstrap command and retry once.`,
-              "3. Then run `playwright-cli show --annotate` so the user can capture any final notes.",
+              "1. Probe for browser-use availability using the bootstrap rules above.",
+              `2. If available, run \`browser-use open ${specFileUrl}\`. If that reports a missing browser executable, follow the bootstrap rules and retry once.`,
+              "3. Then run `browser-use show --annotate` so the user can capture any final notes.",
               `4. Always print, prominently, the absolute paths so the user can open them manually:\n   - Final spec: ${specPath}\n   - Approved preview: ${previewPath}`,
               "5. Do not block the workflow; return a structured summary even if no tooling worked.",
             ].join("\n"),

package/dist/builtin/workflows/builtin/ralph.ts

@@ -10,7 +10,8 @@
 import { mkdir, mkdtemp, writeFile } from "node:fs/promises";
 import { tmpdir } from "node:os";
 import { dirname, join, resolve } from "node:path";
-import { defineWorkflow } from "../src/index.js";
+import { defineWorkflow } from "../src/workflows/define-workflow.js";
+import { Type } from "typebox";
 import type {
   WorkflowRunContext,
   WorkflowTaskResult,
@@ -322,7 +323,6 @@ function reviewApproved(text: string): boolean {
 }
 
 function reviewerErrorResult(
-  iteration: number,
   error: string,
 ): WorkflowTaskResult {
   const decision: ReviewDecision = {
@@ -1041,7 +1041,7 @@ async function runRalphWorkflow(
       );
     } catch (err) {
       const message = err instanceof Error ? err.message : String(err);
-      reviews = [reviewerErrorResult(iteration, message)];
+      reviews = [reviewerErrorResult(message)];
     }
 
     approved =
@@ -1132,37 +1132,37 @@ export default defineWorkflow("ralph")
   .description(
     "Plan → orchestrate → simplify → parallel review loop with bounded iteration.",
   )
-  .input("prompt", {
-    type: "text",
-    required: true,
-    description: "The task or goal to plan, execute, and refine.",
-  })
-  .input("max_loops", {
-    type: "number",
+  .input("prompt", Type.String({ description: "The task or goal to plan, execute, and refine." }))
+  .input("max_loops", Type.Number({
     default: DEFAULT_MAX_LOOPS,
     description: `Maximum plan/orchestrate/review iterations (default ${DEFAULT_MAX_LOOPS}).`,
-  })
-  .input("base_branch", {
-    type: "string",
+  }))
+  .input("base_branch", Type.String({
     default: "origin/main",
-    description:
-      "Branch reviewers compare the current code delta against (default origin/main).",
-  })
-  .input("git_worktree_dir", {
-    type: "string",
+    description: "Branch reviewers compare the current code delta against (default origin/main).",
+  }))
+  .input("git_worktree_dir", Type.String({
     default: "",
     description:
       "Optional Git worktree path. Ralph must start inside a Git repo; absolute paths are used as-is, relative paths resolve from the repo root, existing Git worktrees from the invoking repository are reused/shared as-is, and missing paths are created from base_branch.",
-  })
+  }))
   .worktreeFromInputs({
     gitWorktreeDir: "git_worktree_dir",
     baseBranch: "base_branch",
   })
+  .output("result", Type.Optional(Type.String({ description: "Final implementation report from the orchestrator stage." })))
+  .output("plan", Type.Optional(Type.String({ description: "Latest RFC-style plan text." })))
+  .output("plan_path", Type.Optional(Type.String({ description: "Path to the latest generated spec under specs/." })))
+  .output("implementation_notes_path", Type.Optional(Type.String({ description: "OS-temp notes file containing decisions, deviations, blockers, and validation notes." })))
+  .output("pr_report", Type.Optional(Type.String({ description: "Pull-request preparation report with diff review, PR status, commands, and follow-up steps." })))
+  .output("approved", Type.Optional(Type.Boolean({ description: "Whether the reviewer loop approved before PR handoff." })))
+  .output("iterations_completed", Type.Optional(Type.Number({ description: "Number of plan/orchestrate/review loops completed." })))
+  .output("review_report", Type.Optional(Type.String({ description: "Markdown report containing the latest reviewer payloads." })))
   .run(async (ctx) => {
-    const workflowCtx = ctx as WorkflowRunContext<RalphInputs>;
+    const workflowCtx = ctx;
     const workflowStartCwd = workflowCtx.cwd ?? process.cwd();
     const inputs = workflowCtx.inputs;
-    const prompt = inputs.prompt ?? "";
+    const prompt = inputs.prompt;
     const maxLoops = positiveInteger(inputs.max_loops, DEFAULT_MAX_LOOPS);
     const comparisonBaseBranch = normalizeBranchInput(
       inputs.base_branch,

package/dist/builtin/workflows/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bastani/workflows",
-  "version": "0.8.21-0",
+  "version": "0.8.22-0",
   "private": true,
   "description": "Atomic extension for multi-stage workflow authoring and execution.",
   "contributors": [
@@ -21,12 +21,12 @@
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/flora131/atomic.git",
+    "url": "git+https://github.com/bastani-inc/atomic.git",
     "directory": "packages/workflows"
   },
-  "homepage": "https://github.com/flora131/atomic/tree/main/packages/workflows#readme",
+  "homepage": "https://github.com/bastani-inc/atomic/tree/main/packages/workflows#readme",
   "bugs": {
-    "url": "https://github.com/flora131/atomic/issues"
+    "url": "https://github.com/bastani-inc/atomic/issues"
   },
   "keywords": [
     "pi-package",
@@ -68,7 +68,8 @@
     "prompts": []
   },
   "dependencies": {
-    "jiti": "^2.7.0"
+    "jiti": "^2.7.0",
+    "typebox": "^1.1.24"
   },
   "peerDependencies": {
     "@bastani/atomic": "*",

package/dist/builtin/workflows/skills/research-codebase/SKILL.md

@@ -52,7 +52,7 @@ The user's research question/request is: **$ARGUMENTS**
 
     **For online search:**
     - VERY IMPORTANT: In case you discover external libraries as dependencies, use the **codebase-online-researcher** agent for external documentation and resources
-        - The agent fetches live web content using the **playwright-cli** skill (or `bunx @playwright/cli` / `curl`). Instruct it to apply the token-efficient fetch order: (1) try `curl https://<site>/llms.txt` for an AI-friendly index (see [llmstxt.org](https://llmstxt.org/llms.txt)), (2) try `curl <url> -H "Accept: text/markdown"` to get pre-converted Markdown (supported on Cloudflare-hosted docs via [Markdown for Agents](https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/)), (3) fall back to HTML parsing via `playwright-cli`
+        - The agent fetches live web content using the **browser-use** skill (or `bunx browser-use` / `curl`). Instruct it to apply the token-efficient fetch order: (1) try `curl https://<site>/llms.txt` for an AI-friendly index (see [llmstxt.org](https://llmstxt.org/llms.txt)), (2) try `curl <url> -H "Accept: text/markdown"` to get pre-converted Markdown (supported on Cloudflare-hosted docs via [Markdown for Agents](https://developers.cloudflare.com/fundamentals/reference/markdown-for-agents/)), (3) fall back to HTML parsing via `browser-use`
         - Instruct the agent to return LINKS with their findings and INCLUDE those links in the research document
         - The agent should persist reusable source documents under `research/web/<YYYY-MM-DD>-<kebab-case-topic>.md` (with frontmatter noting `source_url`, `fetched_at`, and `fetch_method`) so future research can reuse them without re-fetching
         - Output directory for the synthesized research artifact: `research/docs/`

package/dist/builtin/workflows/src/extension/background-ui-adapter.ts

@@ -87,7 +87,7 @@ function ask(
       reject(
         signal.reason instanceof Error
           ? signal.reason
-          : new Error("pi-workflows: HIL aborted"),
+          : new Error("atomic-workflows: HIL aborted"),
       );
     };
     signal.addEventListener("abort", onAbort, { once: true });
@@ -151,7 +151,7 @@ export function buildBackgroundUIAdapter(
       options: readonly T[],
     ): Promise<T> {
       if (options.length === 0) {
-        throw new Error("pi-workflows: ctx.ui.select requires at least one option");
+        throw new Error("atomic-workflows: ctx.ui.select requires at least one option");
       }
       const response = await ask(store, runId, {
         kind: "select",