pilotswarm 0.0.1 → 0.4.0

package/mcp/dist/src/util/command.d.ts

@@ -0,0 +1,52 @@
+import type { CommandResponse, PilotSwarmManagementClient } from "pilotswarm-sdk";
+type CommandResponseLike = CommandResponse & {
+    version?: number;
+    emittedAt?: number;
+};
+export declare class CommandRejectedError extends Error {
+    readonly cmd: string;
+    readonly cmdId: string;
+    readonly response: CommandResponseLike;
+    constructor(response: CommandResponseLike);
+}
+export declare class CommandTimeoutError extends Error {
+    readonly cmd: string;
+    readonly cmdId: string;
+    readonly timeoutMs: number;
+    constructor(cmd: string, cmdId: string, timeoutMs: number);
+}
+/**
+ * Send a command to a session's orchestration and wait for the orchestration's
+ * response.
+ *
+ * The bare `mgmt.sendCommand(...)` call is fire-and-forget — it returns once the
+ * command is enqueued, regardless of whether the orchestration ultimately
+ * accepts it. Unknown commands (e.g. anything other than the orchestration's
+ * recognized set: `set_model` / `list_models` / `get_info` / `done` /
+ * `cancel` / `delete`) are queued, processed, and rejected with
+ * `error: "Unknown command: ..."` written to KV — but the caller never sees
+ * that error if it doesn't poll.
+ *
+ * This helper closes the loop: enqueue with a fresh `cmdId`, poll the
+ * orchestration's KV-backed response channel until the response shows up,
+ * then return the response or throw `CommandRejectedError` /
+ * `CommandTimeoutError`.
+ *
+ * @param mgmt - PilotSwarmManagementClient instance
+ * @param sessionId - target session id
+ * @param cmd - command name (e.g. "set_model")
+ * @param args - command-specific arguments
+ * @param opts.timeoutMs - max time to wait for the orchestration's response
+ *   (default 15s)
+ * @param opts.pollIntervalMs - KV poll interval (default 200ms)
+ * @param opts.signal - optional abort signal
+ * @throws CommandRejectedError if the orchestration writes an `error` response
+ * @throws CommandTimeoutError if no response shows up within `timeoutMs`
+ */
+export declare function sendCommandAndWait(mgmt: PilotSwarmManagementClient, sessionId: string, cmd: string, args?: Record<string, unknown>, opts?: {
+    timeoutMs?: number;
+    pollIntervalMs?: number;
+    signal?: AbortSignal;
+}): Promise<CommandResponseLike>;
+export {};
+//# sourceMappingURL=command.d.ts.map

package/mcp/dist/src/util/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../../src/util/command.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AAKlF,KAAK,mBAAmB,GAAG,eAAe,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtF,qBAAa,oBAAqB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;gBAE3B,QAAQ,EAAE,mBAAmB;CAO5C;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAO5D;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,kBAAkB,CACpC,IAAI,EAAE,0BAA0B,EAChC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,CAAC,EAAE;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;CACxB,GACF,OAAO,CAAC,mBAAmB,CAAC,CAqB9B"}

package/mcp/dist/src/util/command.js

@@ -0,0 +1,78 @@
+import { randomUUID } from "node:crypto";
+export class CommandRejectedError extends Error {
+    cmd;
+    cmdId;
+    response;
+    constructor(response) {
+        super(response.error ?? `Command "${response.cmd}" was rejected with no error message`);
+        this.name = "CommandRejectedError";
+        this.cmd = response.cmd;
+        this.cmdId = response.id;
+        this.response = response;
+    }
+}
+export class CommandTimeoutError extends Error {
+    cmd;
+    cmdId;
+    timeoutMs;
+    constructor(cmd, cmdId, timeoutMs) {
+        super(`Timed out after ${timeoutMs}ms waiting for response to command "${cmd}" (id=${cmdId})`);
+        this.name = "CommandTimeoutError";
+        this.cmd = cmd;
+        this.cmdId = cmdId;
+        this.timeoutMs = timeoutMs;
+    }
+}
+const DEFAULT_TIMEOUT_MS = 15_000;
+const DEFAULT_POLL_INTERVAL_MS = 200;
+/**
+ * Send a command to a session's orchestration and wait for the orchestration's
+ * response.
+ *
+ * The bare `mgmt.sendCommand(...)` call is fire-and-forget — it returns once the
+ * command is enqueued, regardless of whether the orchestration ultimately
+ * accepts it. Unknown commands (e.g. anything other than the orchestration's
+ * recognized set: `set_model` / `list_models` / `get_info` / `done` /
+ * `cancel` / `delete`) are queued, processed, and rejected with
+ * `error: "Unknown command: ..."` written to KV — but the caller never sees
+ * that error if it doesn't poll.
+ *
+ * This helper closes the loop: enqueue with a fresh `cmdId`, poll the
+ * orchestration's KV-backed response channel until the response shows up,
+ * then return the response or throw `CommandRejectedError` /
+ * `CommandTimeoutError`.
+ *
+ * @param mgmt - PilotSwarmManagementClient instance
+ * @param sessionId - target session id
+ * @param cmd - command name (e.g. "set_model")
+ * @param args - command-specific arguments
+ * @param opts.timeoutMs - max time to wait for the orchestration's response
+ *   (default 15s)
+ * @param opts.pollIntervalMs - KV poll interval (default 200ms)
+ * @param opts.signal - optional abort signal
+ * @throws CommandRejectedError if the orchestration writes an `error` response
+ * @throws CommandTimeoutError if no response shows up within `timeoutMs`
+ */
+export async function sendCommandAndWait(mgmt, sessionId, cmd, args, opts) {
+    const cmdId = randomUUID();
+    const timeoutMs = opts?.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+    const pollIntervalMs = opts?.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    await mgmt.sendCommand(sessionId, { cmd, id: cmdId, ...(args ? { args } : {}) });
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (opts?.signal?.aborted)
+            throw opts.signal.reason ?? new Error("Aborted");
+        const response = await mgmt.getCommandResponse(sessionId, cmdId);
+        if (response) {
+            if (response.error)
+                throw new CommandRejectedError(response);
+            return response;
+        }
+        const remaining = deadline - Date.now();
+        if (remaining <= 0)
+            break;
+        await new Promise((resolve) => setTimeout(resolve, Math.min(pollIntervalMs, remaining)));
+    }
+    throw new CommandTimeoutError(cmd, cmdId, timeoutMs);
+}
+//# sourceMappingURL=command.js.map

package/mcp/dist/src/util/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../src/util/command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAQzC,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAClC,GAAG,CAAS;IACZ,KAAK,CAAS;IACd,QAAQ,CAAsB;IAEvC,YAAY,QAA6B;QACrC,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,YAAY,QAAQ,CAAC,GAAG,sCAAsC,CAAC,CAAC;QACxF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,QAAQ,CAAC,EAAE,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC7B,CAAC;CACJ;AAED,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACjC,GAAG,CAAS;IACZ,KAAK,CAAS;IACd,SAAS,CAAS;IAE3B,YAAY,GAAW,EAAE,KAAa,EAAE,SAAiB;QACrD,KAAK,CAAC,mBAAmB,SAAS,uCAAuC,GAAG,SAAS,KAAK,GAAG,CAAC,CAAC;QAC/F,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;CACJ;AAED,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAClC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACpC,IAAgC,EAChC,SAAiB,EACjB,GAAW,EACX,IAA8B,EAC9B,IAIC;IAED,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,kBAAkB,CAAC;IACxD,MAAM,cAAc,GAAG,IAAI,EAAE,cAAc,IAAI,wBAAwB,CAAC;IAExE,MAAM,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAEjF,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACxC,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,EAAE,CAAC;QAC3B,IAAI,IAAI,EAAE,MAAM,EAAE,OAAO;YAAE,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;QAC5E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QACjE,IAAI,QAAQ,EAAE,CAAC;YACX,IAAI,QAAQ,CAAC,KAAK;gBAAE,MAAM,IAAI,oBAAoB,CAAC,QAAQ,CAAC,CAAC;YAC7D,OAAO,QAAQ,CAAC;QACpB,CAAC;QACD,MAAM,SAAS,GAAG,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACxC,IAAI,SAAS,IAAI,CAAC;YAAE,MAAM;QAC1B,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC;IAC7F,CAAC;IAED,MAAM,IAAI,mBAAmB,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;AACzD,CAAC"}

package/package.json

@@ -1,12 +1,87 @@
 {
   "name": "pilotswarm",
-  "version": "0.0.1",
-  "description": "Placeholder for PilotSwarm. The real package is coming soon.",
-  "main": "index.js",
-  "author": "Affan Dar",
+  "version": "0.4.0",
+  "description": "PilotSwarm application package: terminal UI, browser portal + Web API server, and MCP server — one install, three bins.",
+  "type": "module",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/affandar/pilotswarm.git",
+    "directory": "packages/app"
+  },
+  "homepage": "https://github.com/affandar/pilotswarm#readme",
+  "bugs": {
+    "url": "https://github.com/affandar/pilotswarm/issues"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "bin": {
+    "pilotswarm": "./tui/bin/tui.js",
+    "pilotswarm-cli": "./tui/bin/tui.js",
+    "pilotswarm-web": "./web/bin/serve.js",
+    "pilotswarm-mcp": "./mcp/dist/bin/pilotswarm-mcp.js"
+  },
+  "exports": {
+    ".": "./tui/src/index.js",
+    "./host": "./tui/src/portal.js",
+    "./web": "./web/server.js",
+    "./ui-core": "./ui/core/src/index.js",
+    "./ui-react": "./ui/react/src/index.js",
+    "./package.json": "./package.json"
+  },
   "files": [
-    "index.js",
+    "tui/bin/**/*",
+    "tui/src/**/*",
+    "tui/plugins/**/*",
+    "tui/tui-splash.txt",
+    "web/auth.js",
+    "web/auth/**/*",
+    "web/api/**/*",
+    "web/bin/**/*",
+    "web/config.js",
+    "web/dist/**/*",
+    "web/runtime.js",
+    "web/server.js",
+    "mcp/dist/**/*",
+    "ui/core/src/**/*",
+    "ui/react/src/**/*",
     "README.md"
-  ]
+  ],
+  "scripts": {
+    "build": "npm run build:web && npm run build:mcp",
+    "build:web": "cd web && node ../node_modules/vite/bin/vite.js build",
+    "build:mcp": "cd mcp && tsc",
+    "prepack": "npm run build",
+    "start": "node ./tui/bin/tui.js local --env ../../.env.remote",
+    "start:remote": "node ./tui/bin/tui.js remote --env ../../.env.remote",
+    "web:start": "node web/server.js",
+    "web:dev": "cd web && node ../node_modules/vite/bin/vite.js --host 0.0.0.0",
+    "test": "npm run test:tui && npm run test:web && npm run test:ui && npm run test:mcp",
+    "test:tui": "node --test tui/test/*.test.mjs",
+    "test:web": "node --test web/test/*.test.mjs",
+    "test:ui": "node --test ui/core/test/*.test.mjs",
+    "test:mcp": "node mcp/test/unit/sendCommandAndWait.unit.mjs",
+    "test:mcp:integration": "node mcp/test/integration/smoke.live.mjs",
+    "test:mcp:integration:all": "node mcp/test/integration/smoke.live.mjs && node mcp/test/integration/tools.live.mjs && node mcp/test/integration/edge-cases.live.mjs && node mcp/test/integration/verify.live.mjs",
+    "clean": "rm -rf web/dist mcp/dist"
+  },
+  "dependencies": {
+    "@azure/msal-browser": "^4.26.1",
+    "@azure/msal-node": "^5.3.1",
+    "@hono/node-server": "^1.19.12",
+    "@modelcontextprotocol/sdk": "^1.28.0",
+    "express": "^5.1.0",
+    "hono": "^4.12.10",
+    "ink": "^6.8.0",
+    "jose": "^6.2.2",
+    "pilotswarm-sdk": "^0.4.0",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4",
+    "ws": "^8.18.2"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-react": "^5.1.0",
+    "vite": "^7.2.0"
+  }
 }

package/tui/README.md

@@ -0,0 +1,35 @@
+# pilotswarm-cli
+
+Terminal UI for PilotSwarm.
+
+Install:
+
+```bash
+npm install pilotswarm-cli
+```
+
+For app-specific worker modules or direct SDK imports, also add:
+
+```bash
+npm install pilotswarm-sdk
+```
+
+Run locally against a plugin directory:
+
+```bash
+npx pilotswarm local --env .env --plugin ./plugin --worker ./worker-module.js
+```
+
+`pilotswarm-cli` provides the shipped TUI. Your app customizes it with `plugin/plugin.json`, `plugin/agents/*.agent.md`, `plugin/skills/*/SKILL.md`, and optional worker-side tools.
+
+The shipped files inspector supports shared artifact browsing, download, local open, and delete flows. Binary artifacts download intact rather than being coerced through UTF-8 text previews.
+
+Portal/runtime helpers that are intentionally shared with `pilotswarm-web`
+are exported from `pilotswarm-cli/portal`.
+
+Common docs:
+
+- CLI apps: `https://github.com/affandar/PilotSwarm/blob/main/docs/developer/building/cli-apps.md`
+- CLI agents: `https://github.com/affandar/PilotSwarm/blob/main/docs/developer/building/cli-agents.md`
+- Keybindings: `https://github.com/affandar/PilotSwarm/blob/main/docs/user-guide/keybindings.md`
+- DevOps sample: `https://github.com/affandar/PilotSwarm/tree/main/examples/devops-command-center`

package/tui/bin/tui.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+
+// Force the shipped TUI onto production React/Ink unless the caller
+// explicitly opts into another environment for debugging.
+process.env.NODE_ENV ??= "production";
+
+const { syncBundledWorkspaceUiPackages } = await import("../src/sync-workspace-ui.js");
+syncBundledWorkspaceUiPackages({ linkWorkspacePackages: true });
+
+const argv = process.argv.slice(2);
+if (argv[0] === "auth") {
+    const { runAuthCommand } = await import("../src/auth/cli.js");
+    process.exitCode = await runAuthCommand(argv.slice(1)).catch((error) => {
+        console.error(`[pilotswarm] ${error?.message || error}`);
+        return 1;
+    });
+} else {
+    const { parseCliIntoEnv } = await import("../src/bootstrap-env.js");
+    const config = parseCliIntoEnv(argv);
+    const { startTuiApp } = await import("../src/index.js");
+    try {
+        // startTuiApp exits the process on normal quit; a thrown error here is
+        // a startup failure (e.g. Web API auth). Show it cleanly instead of an
+        // unhandled-rejection stack trace — the Ink screen is not up yet.
+        await startTuiApp(config);
+    } catch (error) {
+        console.error(`[pilotswarm] ${error?.message || error}`);
+        process.exitCode = 1;
+    }
+}

package/tui/plugins/.mcp.json

@@ -0,0 +1,7 @@
+{
+    "context7": {
+        "type": "http",
+        "url": "https://mcp.context7.com/mcp",
+        "tools": ["resolve-library-id", "query-docs"]
+    }
+}

package/tui/plugins/plugin.json

@@ -0,0 +1,13 @@
+{
+  "name": "pilotswarm",
+  "description": "Durable execution building blocks — skills, agents, and tools for long-running Copilot sessions with timers, dehydration, and worker migration.",
+  "version": "1.0.0",
+  "author": {
+    "name": "affandar",
+    "url": "https://github.com/affandar/pilotswarm"
+  },
+  "license": "MIT",
+  "keywords": ["pilotswarm", "durable", "copilot", "timers", "orchestration"],
+  "agents": "agents/",
+  "skills": "skills/"
+}

package/tui/plugins/session-policy.json

@@ -0,0 +1,8 @@
+{
+  "version": 1,
+  "creation": {
+    "mode": "open",
+    "allowGeneric": true,
+    "bundledAgents": ["generic-crawler"]
+  }
+}