@piewf/cli 5.8.0 → 5.10.0

package/dist/src/cli.d.ts

@@ -15,6 +15,15 @@ export interface CliOptions extends DoctorOptions {
 }
 export declare function formatWorkflowCliHelp(fn: WorkflowCatalogFunction, command?: string): string;
 export declare function parseWorkflowCliArgs(schema: JsonSchema, rawArgs: readonly string[]): Record<string, JsonValue>;
+type ScriptWorkflowCliArgs = {
+    help: true;
+} | {
+    help: false;
+    scriptPath: string;
+    name: string;
+    args: JsonValue;
+};
+export declare function parseScriptWorkflowCliArgs(rawArgs: readonly string[]): ScriptWorkflowCliArgs;
 export declare function parseDoctorArgs(rawArgs: readonly string[]): {
     role?: string;
     prompt?: string;
@@ -22,3 +31,4 @@ export declare function parseDoctorArgs(rawArgs: readonly string[]): {
 };
 export declare function parseDoctorCleanupArgs(rawArgs: readonly string[]): Required<Pick<DoctorCleanupOptions, "olderThanDays" | "yes">>;
 export declare function runCli(args: readonly string[], options?: CliOptions, write?: (text: string) => void): Promise<number>;
+export {};

package/dist/src/cli.js

@@ -2,7 +2,7 @@
 import { randomUUID } from "node:crypto";
 import { chmodSync, linkSync, mkdirSync, mkdtempSync, realpathSync, renameSync, rmSync, writeFileSync } from "node:fs";
 import { homedir } from "node:os";
-import { dirname, join } from "node:path";
+import { basename, dirname, extname, join } from "node:path";
 import { pathToFileURL } from "node:url";
 import { ProjectTrustStore, SessionManager, SettingsManager, createAgentSessionFromServices, createAgentSessionServices, getAgentDir, hasTrustRequiringProjectResources } from "@earendil-works/pi-coding-agent";
 import { Value } from "typebox/value";
@@ -11,7 +11,8 @@ import { doctorCleanup, doctorCleanupExitCode, formatDoctorCleanupReport } from
 import workflowExtension, { errorText, formatWorkflowProgress, isNodeError, jsonValue, loadAgentDefinitions, registeredWorkflowFunctions, truncateWorkflowProgress, workflowCatalog, workflowSettingsPath } from "pi-extensible-workflows";
 import { portableEngineVersion, portablePiVersion, writePortableWorkflowBundle } from "./bundles.js";
 import { runSessionInspector, transcriptFileLines } from "./session-inspector.js";
-import { isPersistedRun } from "pi-extensible-workflows/persistence";
+import { isPersistedRun, listPersistedSessionIds, listRunIds } from "pi-extensible-workflows/persistence";
+import { shareTrajectoryRun } from "pi-extensible-workflows/trajectory";
 function object(value) { return typeof value === "object" && value !== null && !Array.isArray(value); }
 function has(value, key) { return Object.prototype.hasOwnProperty.call(value, key); }
 function requiredArg(args, index) {
@@ -213,7 +214,53 @@ function launcherHelpLines() {
         "  --".padEnd(28) + "End launcher option parsing; pass later tokens to workflow input",
     ];
 }
-function workflowUsage() { return [`Usage: piewf run <workflow-name> [workflow arguments] | export <workflow-name> [--name <command>] [--output <path>] [--force]`, "", "Launcher options:", ...launcherHelpLines()].join("\n") + "\n"; }
+function workflowUsage() { return [`Usage: piewf run <workflow-name> [workflow arguments] | run --script <path> [--name <workflow-name>] [--input <json>] | export <workflow-name> [--name <command>] [--output <path>] [--force]`, "", "Launcher options:", ...launcherHelpLines()].join("\n") + "\n"; }
+function scriptWorkflowUsage() { return [`Usage: piewf run --script <path> [--name <workflow-name>] [--input <json>]`, "", "Options:", ...launcherHelpLines().slice(0, 2), "  -h, --help".padEnd(28) + "Show this help"].join("\n") + "\n"; }
+function scriptWorkflowName(scriptPath) {
+    const filename = basename(scriptPath);
+    const extension = extname(filename);
+    return extension ? filename.slice(0, -extension.length) : filename;
+}
+export function parseScriptWorkflowCliArgs(rawArgs) {
+    let scriptPath;
+    let name;
+    let input;
+    for (let index = 0; index < rawArgs.length; index += 1) {
+        const token = requiredArg(rawArgs, index);
+        if (token === "--help" || token === "-h")
+            return { help: true };
+        const equals = token.indexOf("=");
+        const option = equals >= 0 ? token.slice(0, equals) : token;
+        if (option === "--script" || option === "--name" || option === "--input") {
+            const value = equals >= 0 ? token.slice(equals + 1) : rawArgs[++index];
+            if (!value?.trim())
+                throw new Error(`Missing value for ${option}`);
+            if (option === "--script") {
+                if (scriptPath !== undefined)
+                    throw new Error("--script may only be provided once");
+                scriptPath = value;
+            }
+            else if (option === "--name") {
+                if (name !== undefined)
+                    throw new Error("--name may only be provided once");
+                name = value;
+            }
+            else {
+                if (input !== undefined)
+                    throw new Error("--input may only be provided once");
+                input = parseJsonInput(value);
+            }
+            continue;
+        }
+        throw new Error(`Unknown option: ${token}`);
+    }
+    if (scriptPath === undefined)
+        throw new Error("Missing required option: --script");
+    const workflowName = name === undefined ? scriptWorkflowName(scriptPath) : name.trim();
+    if (!workflowName)
+        throw new Error("Workflow name must be non-empty");
+    return { help: false, scriptPath, name: workflowName, args: input ?? null };
+}
 function exportUsage() { return [`Usage: piewf export <workflow-name> [--name <command>] [--output <path>] [--force] [--bundle]`, "", "Launcher options:", ...launcherHelpLines()].join("\n") + "\n"; }
 function bundleUsage() { return [`Usage: piewf bundle <workflow-name> [--name <command>] [--output <directory>] [--force]`, "", "The bundle contains a launcher, manifest, workflow payload, and external-runtime setup instructions.", "Repeat --role, --alias, --tool, --command, or --environment to declare recipient requirements.", "Use --extension, --skill, --resource, and --dependency to copy selected payload resources."].join("\n") + "\n"; }
 function parseInspectArgs(rawArgs) {
@@ -523,15 +570,20 @@ class CliProgress {
         this.#run = undefined;
     }
 }
-async function invokeWorkflow(fn, args, runtime, options, context) {
-    if (!Value.Check(fn.input, args))
-        throw new Error(`Invalid input for ${fn.name}`);
+async function invokeWorkflow(launch, runtime, options, context) {
+    if (launch.fn && (!object(launch.args) || !Value.Check(launch.fn.input, launch.args)))
+        throw new Error(`Invalid input for ${launch.fn.name}`);
+    if (!launch.fn && launch.scriptPath === undefined)
+        throw new Error("Workflow launch has no source");
     let announcedRunId;
     const announceRunId = (runId) => { if (announcedRunId === runId)
         return; announcedRunId = runId; options.stderr(`Run ID: ${runId}\n`); };
     const progress = new CliProgress(options.stderr, options.isTTY ?? process.stderr.isTTY, announceRunId);
     try {
-        const result = await runtime.workflowTool.execute(randomUUID(), { name: fn.name, script: `return await ${fn.name}(args);`, args, foreground: true }, options.signal, (update) => { if (object(update) && object(update.details) && isPersistedRun(update.details.run))
+        const params = launch.scriptPath === undefined
+            ? { name: launch.name, script: `return await ${launch.fn?.name ?? launch.name}(args);`, args: launch.args, foreground: true }
+            : { name: launch.name, scriptPath: launch.scriptPath, args: launch.args, foreground: true };
+        const result = await runtime.workflowTool.execute(randomUUID(), params, options.signal, (update) => { if (object(update) && object(update.details) && isPersistedRun(update.details.run))
             progress.update(update.details.run); }, context);
         if (!isHeadlessWorkflowResult(result))
             throw new Error("Workflow returned an invalid result");
@@ -588,8 +640,22 @@ async function runWorkflowCli(rawArgs, options) {
         options.write(workflowUsage());
         return args.length ? 0 : 1;
     }
+    const runtimeOptions = { ...options, ...(parsed.trustOverride !== undefined ? { trustOverride: parsed.trustOverride } : {}) };
+    const scriptMode = args[0] === "--script" || args[0]?.startsWith("--script=") || args[0]?.startsWith("--") && args.some((arg) => arg === "--script" || arg.startsWith("--script="));
+    if (scriptMode) {
+        const script = parseScriptWorkflowCliArgs(args);
+        if (script.help) {
+            options.write(scriptWorkflowUsage());
+            return 0;
+        }
+        return withWorkflowRuntime(runtimeOptions, async (runtime, context) => {
+            const result = await invokeWorkflow({ name: script.name, scriptPath: script.scriptPath, args: script.args }, runtime, options, context);
+            options.write(`${JSON.stringify(result.value)}\n`);
+            return 0;
+        });
+    }
     const name = requiredArg(args, 0);
-    return withWorkflowRuntime({ ...options, ...(parsed.trustOverride !== undefined ? { trustOverride: parsed.trustOverride } : {}) }, async (runtime, context) => {
+    return withWorkflowRuntime(runtimeOptions, async (runtime, context) => {
         const help = args.slice(1).some((arg) => arg === "--help" || arg === "-h");
         const fn = runtime.catalog.functions.find((candidate) => candidate.name === name);
         if (!fn)
@@ -599,7 +665,7 @@ async function runWorkflowCli(rawArgs, options) {
             return 0;
         }
         const input = parseWorkflowCliArgs(fn.input, args.slice(1));
-        const result = await invokeWorkflow(fn, input, runtime, options, context);
+        const result = await invokeWorkflow({ name: fn.name, fn, args: input }, runtime, options, context);
         options.write(`${JSON.stringify(result.value)}\n`);
         return 0;
     });
@@ -801,6 +867,34 @@ export async function runCli(args, options = {}, write = (text) => { process.std
             return 1;
         }
     }
+    if (args[0] === "share") {
+        if (args.length !== 2 || args[1] === "--help" || args[1] === "-h") {
+            write("Usage: piewf share <run-id>\n\nExports the run as a static Trajectory report and uploads it as a secret GitHub gist via the gh CLI.\nSecret gists are unlisted, not private: anyone with the link can read the full report.\n");
+            return args.some((arg) => arg === "--help" || arg === "-h") ? 0 : 1;
+        }
+        try {
+            const runId = requiredArg(args, 1);
+            const cwd = options.cwd ?? process.cwd();
+            let sessionId;
+            for (const candidate of await listPersistedSessionIds(cwd)) {
+                if ((await listRunIds(cwd, candidate, homedir(), false)).includes(runId)) {
+                    sessionId = candidate;
+                    break;
+                }
+            }
+            if (!sessionId) {
+                stderr(`Error: workflow run ${runId} was not found under ${cwd}\n`);
+                return 1;
+            }
+            const result = await shareTrajectoryRun({ cwd, sessionId, runId });
+            write(`Share URL: ${result.shareUrl}\nGist: ${result.gistUrl}\nSecret gist: anyone with the link can read the full report.\n`);
+            return 0;
+        }
+        catch (error) {
+            stderr(`Error: ${errorText(error)}\n`);
+            return 1;
+        }
+    }
     if (args[0] === "bundle" || args[0] === "run" || args[0] === "export") {
         try {
             const workflowOptions = { write, stderr, ...(options.cwd !== undefined ? { cwd: options.cwd } : {}), ...(options.agentDir !== undefined ? { agentDir: options.agentDir } : {}), ...(options.signal ? { signal: options.signal } : {}), ...(options.trustOverride !== undefined ? { trustOverride: options.trustOverride } : {}), ...(options.isTTY !== undefined ? { isTTY: options.isTTY } : {}), ...(options.skillPaths?.length ? { skillPaths: [...options.skillPaths] } : {}) };
@@ -813,7 +907,7 @@ export async function runCli(args, options = {}, write = (text) => { process.std
             return 1;
         }
     }
-    write("Usage: piewf doctor [role] [--role <role>] [--prompt <text>] [--json] | inspect [session-id] [--json|--summary] [--failed] | transcript <session-file> | bundle <workflow-name> [--name <command>] [--output <path>] [--force] | run <workflow-name> [workflow arguments] | export <workflow-name> [--name <command>] [--output <path>] [--force] [--bundle]\n");
+    write("Usage: piewf doctor [role] [--role <role>] [--prompt <text>] [--json] | inspect [session-id] [--json|--summary] [--failed] | transcript <session-file> | share <run-id> | bundle <workflow-name> [--name <command>] [--output <path>] [--force] | run <workflow-name> [workflow arguments] | run --script <path> [--name <workflow-name>] [--input <json>] | export <workflow-name> [--name <command>] [--output <path>] [--force] [--bundle]\n");
     return 1;
 }
 if (process.argv[1] && import.meta.url === pathToFileURL(realpathSync(process.argv[1])).href) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@piewf/cli",
-  "version": "5.8.0",
+  "version": "5.10.0",
   "description": "CLI for pi-extensible-workflows",
   "homepage": "https://vekexasia.github.io/pi-extensible-workflows/",
   "repository": {
@@ -46,7 +46,7 @@
   },
   "license": "MIT",
   "dependencies": {
-    "pi-extensible-workflows": "5.8.0"
+    "pi-extensible-workflows": "5.10.0"
   },
   "publishConfig": {
     "access": "public"