@nicknisi/pi-workflows 0.3.1 → 0.3.2

package/dist/index.js

@@ -261,48 +261,30 @@ export default function workflows(pi) {
         name: 'workflow',
         label: 'Workflow',
         description: [
-            'Run a JavaScript workflow script that orchestrates subagents over the first-party runtime,',
-            "or manage runs. Actions: 'run' (compile a script in a vm and execute it with injected",
-            'globals), "list" (saved workflow files), "status" (a run record by runId), "stop" (cancel a',
-            'run by runId), "pause"/"resume" (hold active runs before their next agent step, then',
-            "continue them). For 'run', pass EITHER `script` (inline JS) OR `name` (a saved workflow file",
-            'stem from ~/.pi/agent/workflows/*.js or .pi/workflows/*.js). Optional `args` (any JSON value)',
-            "is passed in as the script's `args` global.",
-            '',
-            'Script contract — injected globals: agent(prompt, opts), parallel(thunks),',
-            'pipeline(items, ...stages), phase(name), log(...args), args, budget ({total, spent,',
-            "remaining}), cwd, checkpoint(label?), ask(question, options?). The script's FIRST statement",
-            'SHOULD be `export const meta = { name, description }` (rewritten so the vm compiles;',
-            'meta.name/description surface in the result).',
-            '',
-            'checkpoint(label?) gates the run on a human confirm (dismiss/reject throws and stops the',
-            'run); ask(question, options?) asks the human mid-run — select when options are given,',
-            'yes/no confirm otherwise, undefined when dismissed. Use them before destructive or',
-            'expensive steps.',
-            'The script returns a value via a trailing expression or a top-level `return` (the body is',
-            'wrapped in an async function).',
-            '',
-            'agent() opts: model, tools (default read-only [read, grep, find, ls]), label, systemPrompt,',
-            'schema (validated; lands in result.data), effort (thinking level), timeoutMs, maxTurns,',
-            'agentType (accepted but ignored — no agent-type registry; resolve systemPrompt in the',
-            'script). agent() throws `${kind}: ${error}` on failure — wrap with a safeAgent that returns',
-            '{ ok, value, error } so a failure inside parallel() does not collapse the wave.',
-            '',
-            'Runs are visible: every agent() spawn is a child in the subagent fleet (use the `fleet`',
-            'tool / `/fleet` from @nicknisi/pi-subagents, or `status`/`stop` here). The script itself',
-            'executes in the host process with full Node access — the same trust boundary as the bash',
-            'tool. Keep the returned value small: summaries, counts, key findings — never raw file dumps.',
+            'Run a JavaScript workflow script that orchestrates subagents, or manage runs. Actions: run,',
+            'list (saved workflow files), status (run record by runId), stop, pause, resume (hold active',
+            'runs before their next agent step). For run, pass EITHER script (inline JS) OR name (a saved',
+            'file stem from ~/.pi/agent/workflows/*.js or .pi/workflows/*.js), plus optional args (any JSON,',
+            'exposed as the `args` global). Prefer a saved workflow when one fits.',
+            'Script contract: the body is wrapped in an async function, so return the result with a',
+            'top-level `return`. Keep it small (summaries, counts, findings; never raw file contents). The',
+            'FIRST statement should be `export const meta = { name, description }`. Injected globals:',
+            'agent(prompt, opts), parallel(thunks), pipeline(items, ...stages), phase(name) (logging marker',
+            'only), log(...args), args, budget ({ total, spent, remaining }), cwd, checkpoint(label?),',
+            'ask(question, options?).',
+            'agent() opts: model, tools (default read-only [read, grep, find, ls]; pass tools explicitly for',
+            'builders), label, systemPrompt, schema (validated; agent() returns parsed data, otherwise text),',
+            'effort (thinking level), timeoutMs, maxTurns, worktree (when a patch is produced, agent() returns',
+            '{ value, patchPath, runId }). agent() throws `${kind}: ${error}` on failure, so wrap',
+            'it in a safeAgent() returning { ok, value, error } inside parallel(), or one failure collapses',
+            'the wave. parallel(thunks) takes zero-arg thunks: pass () => agent(...), not agent(...).',
+            'checkpoint(label?) gates the run on a human confirm (dismiss or reject throws and stops the',
+            'run). ask(question, options?) asks the human mid-run: select when options are given, yes/no',
+            'otherwise, undefined when dismissed. Use them before destructive or expensive steps.',
+            'Every agent() spawn is a child in the subagent fleet (fleet tool, or status/stop here). The',
+            'script runs in the host process with full Node access, the same trust boundary as bash.',
         ].join(' '),
         promptSnippet: 'Run a JS workflow script orchestrating subagents',
-        promptGuidelines: [
-            'The script body is wrapped in an async function — a top-level `return value` is the contract for the result.',
-            'Lead with `export const meta = { name, description }` so the run is labeled in the result.',
-            'agent() throws on failure; wrap it in a safeAgent() that returns { ok, value, error } so a failure inside parallel() reports which stage died instead of collapsing the wave to null.',
-            'parallel(thunks) awaits Promise.all over zero-arg thunks — pass `() => agent(...)`, not `agent(...)`.',
-            'Children default to read-only tools (read, grep, find, ls); pass `tools` explicitly for builders.',
-            'Use log(...) for progress notes; they come back in the result details. phase(name) is a logging marker only.',
-            'Keep the returned value small — summaries, counts, key findings — never raw file contents.',
-        ],
         parameters: Type.Object({
             action: Type.Union([
                 Type.Literal('run'),

package/index.ts

@@ -337,48 +337,30 @@ export default function workflows(pi: ExtensionAPI): void {
     name: 'workflow',
     label: 'Workflow',
     description: [
-      'Run a JavaScript workflow script that orchestrates subagents over the first-party runtime,',
-      "or manage runs. Actions: 'run' (compile a script in a vm and execute it with injected",
-      'globals), "list" (saved workflow files), "status" (a run record by runId), "stop" (cancel a',
-      'run by runId), "pause"/"resume" (hold active runs before their next agent step, then',
-      "continue them). For 'run', pass EITHER `script` (inline JS) OR `name` (a saved workflow file",
-      'stem from ~/.pi/agent/workflows/*.js or .pi/workflows/*.js). Optional `args` (any JSON value)',
-      "is passed in as the script's `args` global.",
-      '',
-      'Script contract — injected globals: agent(prompt, opts), parallel(thunks),',
-      'pipeline(items, ...stages), phase(name), log(...args), args, budget ({total, spent,',
-      "remaining}), cwd, checkpoint(label?), ask(question, options?). The script's FIRST statement",
-      'SHOULD be `export const meta = { name, description }` (rewritten so the vm compiles;',
-      'meta.name/description surface in the result).',
-      '',
-      'checkpoint(label?) gates the run on a human confirm (dismiss/reject throws and stops the',
-      'run); ask(question, options?) asks the human mid-run — select when options are given,',
-      'yes/no confirm otherwise, undefined when dismissed. Use them before destructive or',
-      'expensive steps.',
-      'The script returns a value via a trailing expression or a top-level `return` (the body is',
-      'wrapped in an async function).',
-      '',
-      'agent() opts: model, tools (default read-only [read, grep, find, ls]), label, systemPrompt,',
-      'schema (validated; lands in result.data), effort (thinking level), timeoutMs, maxTurns,',
-      'agentType (accepted but ignored — no agent-type registry; resolve systemPrompt in the',
-      'script). agent() throws `${kind}: ${error}` on failure — wrap with a safeAgent that returns',
-      '{ ok, value, error } so a failure inside parallel() does not collapse the wave.',
-      '',
-      'Runs are visible: every agent() spawn is a child in the subagent fleet (use the `fleet`',
-      'tool / `/fleet` from @nicknisi/pi-subagents, or `status`/`stop` here). The script itself',
-      'executes in the host process with full Node access — the same trust boundary as the bash',
-      'tool. Keep the returned value small: summaries, counts, key findings — never raw file dumps.',
+      'Run a JavaScript workflow script that orchestrates subagents, or manage runs. Actions: run,',
+      'list (saved workflow files), status (run record by runId), stop, pause, resume (hold active',
+      'runs before their next agent step). For run, pass EITHER script (inline JS) OR name (a saved',
+      'file stem from ~/.pi/agent/workflows/*.js or .pi/workflows/*.js), plus optional args (any JSON,',
+      'exposed as the `args` global). Prefer a saved workflow when one fits.',
+      'Script contract: the body is wrapped in an async function, so return the result with a',
+      'top-level `return`. Keep it small (summaries, counts, findings; never raw file contents). The',
+      'FIRST statement should be `export const meta = { name, description }`. Injected globals:',
+      'agent(prompt, opts), parallel(thunks), pipeline(items, ...stages), phase(name) (logging marker',
+      'only), log(...args), args, budget ({ total, spent, remaining }), cwd, checkpoint(label?),',
+      'ask(question, options?).',
+      'agent() opts: model, tools (default read-only [read, grep, find, ls]; pass tools explicitly for',
+      'builders), label, systemPrompt, schema (validated; agent() returns parsed data, otherwise text),',
+      'effort (thinking level), timeoutMs, maxTurns, worktree (when a patch is produced, agent() returns',
+      '{ value, patchPath, runId }). agent() throws `${kind}: ${error}` on failure, so wrap',
+      'it in a safeAgent() returning { ok, value, error } inside parallel(), or one failure collapses',
+      'the wave. parallel(thunks) takes zero-arg thunks: pass () => agent(...), not agent(...).',
+      'checkpoint(label?) gates the run on a human confirm (dismiss or reject throws and stops the',
+      'run). ask(question, options?) asks the human mid-run: select when options are given, yes/no',
+      'otherwise, undefined when dismissed. Use them before destructive or expensive steps.',
+      'Every agent() spawn is a child in the subagent fleet (fleet tool, or status/stop here). The',
+      'script runs in the host process with full Node access, the same trust boundary as bash.',
     ].join(' '),
     promptSnippet: 'Run a JS workflow script orchestrating subagents',
-    promptGuidelines: [
-      'The script body is wrapped in an async function — a top-level `return value` is the contract for the result.',
-      'Lead with `export const meta = { name, description }` so the run is labeled in the result.',
-      'agent() throws on failure; wrap it in a safeAgent() that returns { ok, value, error } so a failure inside parallel() reports which stage died instead of collapsing the wave to null.',
-      'parallel(thunks) awaits Promise.all over zero-arg thunks — pass `() => agent(...)`, not `agent(...)`.',
-      'Children default to read-only tools (read, grep, find, ls); pass `tools` explicitly for builders.',
-      'Use log(...) for progress notes; they come back in the result details. phase(name) is a logging marker only.',
-      'Keep the returned value small — summaries, counts, key findings — never raw file contents.',
-    ],
     parameters: Type.Object({
       action: Type.Union(
         [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nicknisi/pi-workflows",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "Model-facing front door to the first-party workflow engine — run JS workflow scripts over the subagent runtime, replacing the third-party @quintinshaw/pi-dynamic-workflows extension",
   "keywords": [
     "pi",