@elpapi42/pi-fleet-cli 0.1.0 → 0.2.0

package/README.md

@@ -1,10 +1,15 @@
 # @elpapi42/pi-fleet-cli
 
-The pi-fleet command-line client. It uses `@elpapi42/pi-fleet-sdk` as its only product dependency.
+The `pif` command creates and discovers durable, host-local Pi agents.
 
 ```bash
 npm install --global @elpapi42/pi-fleet-cli
-pif --help
 ```
 
-Agent commands start in Slice 1.
+```bash
+pif create researcher --cwd "$PWD"
+pif list
+pif status researcher
+```
+
+Commands emit compact JSONL. Slice 1 supports Unix-like hosts with ZeroMQ `ipc://` support. It provides `create`, `list`, and `status`. Sending work, event streaming, recovery, retirement, compact, and destroy come in later slices.

package/dist/main.d.ts

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-export declare function run(args: readonly string[]): number;
+export {};
 //# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AAWA,wBAAgB,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAQnD"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":""}

package/dist/main.js

@@ -1,18 +1,63 @@
 #!/usr/bin/env node
-import { version } from "@elpapi42/pi-fleet-sdk";
+import { connectPiFleet, version } from "@elpapi42/pi-fleet-sdk";
 const usage = `pi-fleet CLI ${version}
 
 Usage:
-  pif --help
-
-Commands will be added with Slice 1.`;
-export function run(args) {
-    if (args.length === 0 || args.includes("--help") || args.includes("-h")) {
-        process.stdout.write(`${usage}\n`);
-        return 0;
+  pif create NAME [INSTRUCTIONS] [--cwd PATH] [-- PI_ARGS...]
+  pif status NAME
+  pif list
+  pif --help`;
+async function main(args) {
+    if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
+        console.log(usage);
+        return;
+    }
+    const client = await connectPiFleet();
+    try {
+        switch (args[0]) {
+            case "create": {
+                const [name, ...remaining] = args.slice(1);
+                if (!name)
+                    throw new Error("Usage: pif create NAME [INSTRUCTIONS] [--cwd PATH] [-- PI_ARGS...]");
+                const instructions = remaining[0] && !remaining[0].startsWith("--") ? remaining.shift() : undefined;
+                const separator = remaining.indexOf("--");
+                const options = separator < 0 ? remaining : remaining.slice(0, separator);
+                const piArgs = separator < 0 ? [] : remaining.slice(separator + 1);
+                const cwdIndex = options.indexOf("--cwd");
+                if (cwdIndex >= 0 && (cwdIndex + 1 >= options.length || options.length !== 2)) {
+                    throw new Error("Usage: pif create NAME [INSTRUCTIONS] [--cwd PATH] [-- PI_ARGS...]");
+                }
+                if (cwdIndex < 0 && options.length !== 0)
+                    throw new Error("Usage: pif create NAME [INSTRUCTIONS] [--cwd PATH] [-- PI_ARGS...]");
+                const cwd = cwdIndex < 0 ? process.cwd() : options[cwdIndex + 1];
+                const agent = await client.create({ name, instructions, cwd, piArgs });
+                console.log(JSON.stringify({ id: agent.id, name: agent.name }));
+                return;
+            }
+            case "status": {
+                const name = args[1];
+                if (!name || args.length !== 2)
+                    throw new Error("Usage: pif status NAME");
+                console.log(JSON.stringify(await (await client.get(name)).status()));
+                return;
+            }
+            case "list":
+                if (args.length !== 1)
+                    throw new Error("Usage: pif list");
+                for (const agent of await client.list())
+                    console.log(JSON.stringify(agent));
+                return;
+            default:
+                throw new Error(`Unknown command: ${args[0]}`);
+        }
+    }
+    finally {
+        await client.close();
     }
-    process.stderr.write(`Unknown argument: ${args[0]}\nRun pif --help for usage.\n`);
-    return 1;
 }
-process.exitCode = run(process.argv.slice(2));
+void main(process.argv.slice(2)).catch((error) => {
+    const message = error instanceof Error ? error.message : String(error);
+    process.stderr.write(`${JSON.stringify({ error: message })}\n`);
+    process.exitCode = 1;
+});
 //# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAEhD,MAAM,KAAK,GAAG,gBAAgB,OAAO;;;;;qCAKA,CAAA;AAErC,MAAM,UAAU,GAAG,CAAC,IAAuB;IACzC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACxE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC,CAAA;QAClC,OAAO,CAAC,CAAA;IACV,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,IAAI,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAA;IACjF,OAAO,CAAC,CAAA;AACV,CAAC;AAED,OAAO,CAAC,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA"}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAA;AAEhE,MAAM,KAAK,GAAG,gBAAgB,OAAO;;;;;;aAMxB,CAAA;AAEb,KAAK,UAAU,IAAI,CAAC,IAAc;IAChC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAClB,OAAM;IACR,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,cAAc,EAAE,CAAA;IACrC,IAAI,CAAC;QACH,QAAQ,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;YAChB,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,CAAC,IAAI,EAAE,GAAG,SAAS,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;gBAC1C,IAAI,CAAC,IAAI;oBAAE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAA;gBAChG,MAAM,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAA;gBACnG,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;gBACzC,MAAM,OAAO,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAA;gBACzE,MAAM,MAAM,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAA;gBAClE,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;gBACzC,IAAI,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;oBAC9E,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAA;gBACvF,CAAC;gBACD,IAAI,QAAQ,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,oEAAoE,CAAC,CAAA;gBAC/H,MAAM,GAAG,GAAG,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAA;gBAChE,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAA;gBACtE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;gBAC/D,OAAM;YACR,CAAC;YACD,KAAK,QAAQ,CAAC,CAAC,CAAC;gBACd,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAA;gBACpB,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;gBACzE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;gBACpE,OAAM;YACR,CAAC;YACD,KAAK,MAAM;gBACT,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;gBACzD,KAAK,MAAM,KAAK,IAAI,MAAM,MAAM,CAAC,IAAI,EAAE;oBAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;gBAC3E,OAAM;YACR;gBACE,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;QAClD,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;IACtB,CAAC;AACH,CAAC;AAED,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC/C,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACtE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,IAAI,CAAC,CAAA;IAC/D,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;AACtB,CAAC,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@elpapi42/pi-fleet-cli",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "CLI for durable, host-local Pi agents",
   "license": "MIT",
   "repository": {
@@ -24,6 +24,6 @@
     "test": "node --test test/*.test.mjs"
   },
   "dependencies": {
-    "@elpapi42/pi-fleet-sdk": "0.1.0"
+    "@elpapi42/pi-fleet-sdk": "0.2.0"
   }
 }