@elpapi42/pi-fleet-sdk 0.2.0-beta.0 → 0.2.0

package/README.md

@@ -1,3 +1,27 @@
 # @elpapi42/pi-fleet-sdk
 
-This version only reserves the official package name for pi-fleet trusted publishing. It contains no SDK implementation. Use `0.2.0-beta.1` or later.
+Create and discover durable, host-local Pi agents.
+
+```bash
+npm install @elpapi42/pi-fleet-sdk
+```
+
+```ts
+import { connectPiFleet } from "@elpapi42/pi-fleet-sdk"
+
+const client = await connectPiFleet()
+const agent = await client.create({
+  name: "researcher",
+  cwd: process.cwd(),
+  instructions: "Give concise answers.",
+})
+
+console.log(await agent.status())
+await client.close()
+```
+
+`instructions` adds durable system instructions. It does not send initial work.
+
+`client.get(name)` and `client.list()` discover agents created by another local client. `client.close()` only closes this SDK client. It does not stop an agent worker.
+
+Slice 1 supports Unix-like hosts with ZeroMQ `ipc://` support. It provides create, get, list, and status. Sending work, event streaming, recovery, retirement, compact, and destroy come in later slices.

package/dist/agent.d.ts

@@ -0,0 +1,13 @@
+import type { Agent, AgentStatus } from "./types.js";
+type AgentClient = {
+    status(id: string, name: string): Promise<AgentStatus>;
+};
+export declare class AgentHandle implements Agent {
+    #private;
+    constructor(client: AgentClient, id: string, name: string);
+    get id(): string;
+    get name(): string;
+    status(): Promise<AgentStatus>;
+}
+export {};
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAEpD,KAAK,WAAW,GAAG;IACjB,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;CACvD,CAAA;AAED,qBAAa,WAAY,YAAW,KAAK;;gBAK3B,MAAM,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAMzD,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC;CAG/B"}

package/dist/agent.js

@@ -0,0 +1,20 @@
+export class AgentHandle {
+    #client;
+    #id;
+    #name;
+    constructor(client, id, name) {
+        this.#client = client;
+        this.#id = id;
+        this.#name = name;
+    }
+    get id() {
+        return this.#id;
+    }
+    get name() {
+        return this.#name;
+    }
+    status() {
+        return this.#client.status(this.#id, this.#name);
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,WAAW;IACb,OAAO,CAAa;IACpB,GAAG,CAAQ;IACX,KAAK,CAAQ;IAEtB,YAAY,MAAmB,EAAE,EAAU,EAAE,IAAY;QACvD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;QACrB,IAAI,CAAC,GAAG,GAAG,EAAE,CAAA;QACb,IAAI,CAAC,KAAK,GAAG,IAAI,CAAA;IACnB,CAAC;IAED,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,GAAG,CAAA;IACjB,CAAC;IAED,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAA;IACnB,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;IAClD,CAAC;CACF"}

package/dist/client.d.ts

@@ -0,0 +1,3 @@
+import { type ConnectOptions, type PiFleetClient } from "./types.js";
+export declare function connectPiFleet(options?: ConnectOptions): Promise<PiFleetClient>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAMA,OAAO,EAAuE,KAAK,cAAc,EAA2B,KAAK,aAAa,EAAE,MAAM,YAAY,CAAA;AAsFlK,wBAAsB,cAAc,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,aAAa,CAAC,CAIzF"}

package/dist/client.js

@@ -0,0 +1,163 @@
+import { randomUUID } from "node:crypto";
+import { capability } from "zeromq";
+import { stat } from "node:fs/promises";
+import { resolve } from "node:path";
+import { AgentHandle } from "./agent.js";
+import { AgentNotFoundError } from "./types.js";
+import { resolveStateDir, workerEndpoint } from "./internal/paths.js";
+import { openRegistry } from "./internal/registry.js";
+import { launchWorker } from "./internal/worker-launcher.js";
+import { requestStatus } from "./internal/worker-client.js";
+const STARTUP_TIMEOUT_MS = 10_000;
+const OWNED_PI_OPTIONS = new Set(["--mode", "--session", "--session-id", "--no-session"]);
+class PiFleetClientImpl {
+    #registry;
+    #stateDir;
+    #closed = false;
+    constructor(registry, stateDir) {
+        this.#registry = registry;
+        this.#stateDir = stateDir;
+    }
+    async create(options) {
+        this.assertOpen();
+        const input = await validateCreateOptions(options);
+        const id = randomUUID();
+        const generation = randomUUID();
+        const now = Date.now();
+        const record = {
+            id,
+            name: input.name,
+            cwd: input.cwd,
+            instructions: input.instructions,
+            piArgs: input.piArgs,
+            state: "starting",
+            runtime: {
+                generation,
+                state: "starting",
+                endpoint: workerEndpoint(this.#stateDir, id, generation),
+            },
+            lastEventSeq: 0,
+            createdAt: now,
+            updatedAt: now,
+        };
+        await this.#registry.create(record);
+        let worker;
+        try {
+            worker = launchWorker(this.#stateDir, id, generation);
+            await waitForWorkerReady(record, worker, STARTUP_TIMEOUT_MS);
+            return new AgentHandle(this, id, input.name);
+        }
+        catch (error) {
+            await stopWorker(worker);
+            await this.#registry.rollbackCreation(id, input.name, generation);
+            throw error;
+        }
+    }
+    async get(name) {
+        this.assertOpen();
+        const record = this.#registry.getByName(name);
+        if (!record)
+            throw new AgentNotFoundError(name);
+        return new AgentHandle(this, record.id, record.name);
+    }
+    async list() {
+        this.assertOpen();
+        return this.#registry.list();
+    }
+    async status(id, name) {
+        this.assertOpen();
+        const record = this.#registry.getById(id);
+        if (!record || record.name !== name)
+            throw new AgentNotFoundError(name);
+        const status = await requestStatus(record);
+        return { id: status.id, name: status.name, state: status.state };
+    }
+    close() {
+        if (this.#closed)
+            return Promise.resolve();
+        this.#closed = true;
+        return this.#registry.close();
+    }
+    assertOpen() {
+        if (this.#closed)
+            throw new Error("The pi-fleet client is closed");
+    }
+}
+export async function connectPiFleet(options = {}) {
+    if (!capability.ipc)
+        throw new Error("pi-fleet requires ZeroMQ ipc:// support on this host");
+    const stateDir = resolveStateDir(options);
+    return new PiFleetClientImpl(await openRegistry(stateDir), stateDir);
+}
+async function validateCreateOptions(options) {
+    const name = options.name?.trim();
+    if (!name)
+        throw new TypeError("Agent name must not be empty");
+    if (name.includes("\0"))
+        throw new TypeError("Agent name must not contain a null byte");
+    if (!options.cwd)
+        throw new TypeError("Agent cwd is required");
+    const cwd = resolve(options.cwd);
+    if (!(await stat(cwd)).isDirectory())
+        throw new TypeError(`Agent cwd is not a directory: ${cwd}`);
+    const piArgs = options.piArgs ? [...options.piArgs] : [];
+    for (const arg of piArgs) {
+        if (OWNED_PI_OPTIONS.has(arg) || [...OWNED_PI_OPTIONS].some((option) => arg.startsWith(`${option}=`))) {
+            throw new TypeError(`Pi argument ${JSON.stringify(arg)} is managed by pi-fleet`);
+        }
+    }
+    return { name, cwd, instructions: options.instructions, piArgs };
+}
+async function waitForWorkerReady(record, worker, timeoutMs) {
+    let onExit = () => { };
+    const exited = new Promise((_, reject) => {
+        onExit = (code, signal) => reject(new Error(`Worker exited before readiness (${signal ?? code ?? "unknown"})`));
+        worker.once("exit", onExit);
+    });
+    try {
+        await Promise.race([waitForStatus(record, timeoutMs), exited]);
+    }
+    finally {
+        worker.off("exit", onExit);
+    }
+}
+async function stopWorker(worker) {
+    if (!worker || worker.exitCode !== null || worker.signalCode !== null)
+        return;
+    worker.kill("SIGTERM");
+    if (await waitForExit(worker, 1_000))
+        return;
+    worker.kill("SIGKILL");
+    await waitForExit(worker, 1_000);
+}
+async function waitForExit(worker, timeoutMs) {
+    if (worker.exitCode !== null || worker.signalCode !== null)
+        return true;
+    return new Promise((resolve) => {
+        const timeout = setTimeout(() => {
+            worker.off("exit", onExit);
+            resolve(false);
+        }, timeoutMs);
+        const onExit = () => {
+            clearTimeout(timeout);
+            resolve(true);
+        };
+        worker.once("exit", onExit);
+    });
+}
+async function waitForStatus(record, timeoutMs) {
+    const end = Date.now() + timeoutMs;
+    let lastError;
+    while (Date.now() < end) {
+        try {
+            await requestStatus(record, Math.min(500, end - Date.now()));
+            return;
+        }
+        catch (error) {
+            lastError = error;
+            await new Promise((resolve) => setTimeout(resolve, 100));
+        }
+    }
+    throw lastError instanceof Error ? lastError : new Error("Worker did not become ready");
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export declare const version = "0.2.0";
+export { connectPiFleet } from "./client.js";
+export { AgentNameTakenError, AgentNotFoundError, AgentUnavailableError, } from "./types.js";
+export type { Agent, AgentState, AgentStatus, AgentSummary, ConnectOptions, CreateAgentOptions, PiFleetClient, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,OAAO,UAAU,CAAA;AAE9B,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,YAAY,CAAA;AAEnB,YAAY,EACV,KAAK,EACL,UAAU,EACV,WAAW,EACX,YAAY,EACZ,cAAc,EACd,kBAAkB,EAClB,aAAa,GACd,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export const version = "0.2.0";
+export { connectPiFleet } from "./client.js";
+export { AgentNameTakenError, AgentNotFoundError, AgentUnavailableError, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAA;AAE9B,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,YAAY,CAAA"}

package/dist/internal/paths.d.ts

@@ -0,0 +1,6 @@
+import type { ConnectOptions } from "../types.js";
+export declare function resolveStateDir(options?: ConnectOptions): string;
+export declare function workerEndpoint(stateDir: string, agentId: string, generation: string): string;
+export declare function prepareStateDir(stateDir: string): Promise<string>;
+export declare function createStateDirectories(stateDir: string): Promise<void>;
+//# sourceMappingURL=paths.d.ts.map

package/dist/internal/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/internal/paths.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,wBAAgB,eAAe,CAAC,OAAO,GAAE,cAAmB,GAAG,MAAM,CAIpE;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAG5F;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAIvE;AAED,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAK5E"}

package/dist/internal/paths.js

@@ -0,0 +1,26 @@
+import { createHash } from "node:crypto";
+import { chmod, mkdir, realpath } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+export function resolveStateDir(options = {}) {
+    if (options.stateDir)
+        return resolve(options.stateDir);
+    const stateHome = process.env.XDG_STATE_HOME ?? resolve(homedir(), ".local", "state");
+    return resolve(stateHome, "pi-fleet");
+}
+export function workerEndpoint(stateDir, agentId, generation) {
+    const identity = createHash("sha256").update(`${stateDir}\0${agentId}\0${generation}`).digest("hex").slice(0, 24);
+    return `ipc://${join(stateDir, "ipc", `${identity}.sock`)}`;
+}
+export async function prepareStateDir(stateDir) {
+    await mkdir(stateDir, { recursive: true, mode: 0o700 });
+    await chmod(stateDir, 0o700);
+    return realpath(stateDir);
+}
+export async function createStateDirectories(stateDir) {
+    const canonicalStateDir = await prepareStateDir(stateDir);
+    const ipcDir = join(canonicalStateDir, "ipc");
+    await mkdir(ipcDir, { recursive: true, mode: 0o700 });
+    await chmod(ipcDir, 0o700);
+}
+//# sourceMappingURL=paths.js.map

package/dist/internal/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/internal/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGzC,MAAM,UAAU,eAAe,CAAC,UAA0B,EAAE;IAC1D,IAAI,OAAO,CAAC,QAAQ;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;IACtD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAA;IACrF,OAAO,OAAO,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;AACvC,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,QAAgB,EAAE,OAAe,EAAE,UAAkB;IAClF,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,QAAQ,KAAK,OAAO,KAAK,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IACjH,OAAO,SAAS,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,GAAG,QAAQ,OAAO,CAAC,EAAE,CAAA;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB;IACpD,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IACvD,MAAM,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAA;IAC5B,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAA;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,QAAgB;IAC3D,MAAM,iBAAiB,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAA;IACzD,MAAM,MAAM,GAAG,IAAI,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAA;IAC7C,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;IACrD,MAAM,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;AAC5B,CAAC"}

package/dist/internal/pi-rpc.d.ts

@@ -0,0 +1,13 @@
+import { type ChildProcessWithoutNullStreams } from "node:child_process";
+import type { AgentRecord } from "./registry.js";
+export type PiState = {
+    sessionFile: string;
+    sessionId: string;
+};
+export declare class PiStartupError extends Error {
+}
+export declare function startPi(record: AgentRecord, timeoutMs?: number): Promise<{
+    process: ChildProcessWithoutNullStreams;
+    state: PiState;
+}>;
+//# sourceMappingURL=pi-rpc.d.ts.map

package/dist/internal/pi-rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-rpc.d.ts","sourceRoot":"","sources":["../../src/internal/pi-rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,8BAA8B,EAAE,MAAM,oBAAoB,CAAA;AAE/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAEhD,MAAM,MAAM,OAAO,GAAG;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,qBAAa,cAAe,SAAQ,KAAK;CAAG;AAE5C,wBAAsB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,SAAS,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,8BAA8B,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CAqB3I"}

package/dist/internal/pi-rpc.js

@@ -0,0 +1,105 @@
+import { spawn } from "node:child_process";
+import { StringDecoder } from "node:string_decoder";
+export class PiStartupError extends Error {
+}
+export async function startPi(record, timeoutMs = 10_000) {
+    const command = process.env.PI_FLEET_PI_COMMAND ?? "pi";
+    const args = ["--mode", "rpc", ...record.piArgs];
+    if (record.instructions)
+        args.push("--append-system-prompt", record.instructions);
+    if (record.sessionPath)
+        args.push("--session", record.sessionPath);
+    const child = spawn(command, args, { cwd: record.cwd, stdio: "pipe" });
+    let stderr = "";
+    child.stderr.on("data", (chunk) => {
+        stderr = `${stderr}${chunk.toString("utf8")}`.slice(-4_096);
+    });
+    try {
+        const state = await getState(child, timeoutMs);
+        child.stdout.resume();
+        return { process: child, state };
+    }
+    catch (error) {
+        await terminate(child);
+        const detail = stderr.trim();
+        if (error instanceof PiStartupError && detail)
+            throw new PiStartupError(`${error.message}: ${detail}`);
+        throw error;
+    }
+}
+async function terminate(child) {
+    if (child.exitCode !== null || child.signalCode !== null)
+        return;
+    child.kill("SIGTERM");
+    if (await waitForExit(child, 1_000))
+        return;
+    child.kill("SIGKILL");
+    await waitForExit(child, 1_000);
+}
+async function waitForExit(child, timeoutMs) {
+    if (child.exitCode !== null || child.signalCode !== null)
+        return true;
+    return new Promise((resolve) => {
+        const timeout = setTimeout(() => {
+            child.off("exit", onExit);
+            resolve(false);
+        }, timeoutMs);
+        const onExit = () => {
+            clearTimeout(timeout);
+            resolve(true);
+        };
+        child.once("exit", onExit);
+    });
+}
+async function getState(child, timeoutMs) {
+    const id = "ready";
+    const decoder = new StringDecoder("utf8");
+    let pending = "";
+    return new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => fail(new PiStartupError("Pi did not answer get_state before the startup deadline")), timeoutMs);
+        const onError = (error) => fail(new PiStartupError(`Pi failed to start: ${error.message}`));
+        const onExit = (code) => fail(new PiStartupError(`Pi exited before readiness (code ${code ?? "signal"})`));
+        const onData = (chunk) => {
+            pending += decoder.write(chunk);
+            while (true) {
+                const newline = pending.indexOf("\n");
+                if (newline < 0)
+                    return;
+                const line = pending.slice(0, newline).replace(/\r$/, "");
+                pending = pending.slice(newline + 1);
+                if (!line)
+                    continue;
+                try {
+                    const message = JSON.parse(line);
+                    if (message.type === "response" && message.id === id) {
+                        if (!message.success)
+                            return fail(new PiStartupError("Pi rejected get_state"));
+                        const { sessionFile, sessionId } = message.data ?? {};
+                        if (typeof sessionFile !== "string" || typeof sessionId !== "string")
+                            return fail(new PiStartupError("Pi returned an invalid get_state response"));
+                        cleanup();
+                        resolve({ sessionFile, sessionId });
+                    }
+                }
+                catch {
+                    // Pi events and diagnostics may share stdout. Only a matching response matters here.
+                }
+            }
+        };
+        const cleanup = () => {
+            clearTimeout(timeout);
+            child.stdout.off("data", onData);
+            child.off("error", onError);
+            child.off("exit", onExit);
+        };
+        const fail = (error) => {
+            cleanup();
+            reject(error);
+        };
+        child.stdout.on("data", onData);
+        child.once("error", onError);
+        child.once("exit", onExit);
+        child.stdin.write(`${JSON.stringify({ id, type: "get_state" })}\n`);
+    });
+}
+//# sourceMappingURL=pi-rpc.js.map

package/dist/internal/pi-rpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pi-rpc.js","sourceRoot":"","sources":["../../src/internal/pi-rpc.ts"],"names":[],"mappings":"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"}

package/dist/internal/protocol.d.ts

@@ -0,0 +1,23 @@
+import type { AgentState } from "../types.js";
+export type StatusRequest = {
+    version: 1;
+    requestId: string;
+    command: "status";
+    agentId: string;
+    runtimeGeneration: string;
+};
+export type StatusResponse = {
+    version: 1;
+    requestId: string;
+    ok: boolean;
+    status?: {
+        id: string;
+        name: string;
+        runtimeGeneration: string;
+        state: AgentState;
+    };
+    error?: string;
+};
+export declare function encode(message: StatusRequest | StatusResponse): string;
+export declare function decode(text: Buffer): unknown;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/internal/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/internal/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,CAAC,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,QAAQ,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;IACf,iBAAiB,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,CAAC,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,EAAE,EAAE,OAAO,CAAA;IACX,MAAM,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE,CAAA;IACnF,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,CAAA;AAED,wBAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,cAAc,GAAG,MAAM,CAEtE;AAED,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE5C"}

package/dist/internal/protocol.js

@@ -0,0 +1,7 @@
+export function encode(message) {
+    return JSON.stringify(message);
+}
+export function decode(text) {
+    return JSON.parse(text.toString("utf8"));
+}
+//# sourceMappingURL=protocol.js.map

package/dist/internal/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/internal/protocol.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,MAAM,CAAC,OAAuC;IAC5D,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;AAChC,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAA;AAC1C,CAAC"}

package/dist/internal/registry.d.ts

@@ -0,0 +1,46 @@
+import { type Database, type RootDatabase } from "lmdb";
+import type { AgentState, AgentSummary } from "../types.js";
+export type AgentRecord = {
+    id: string;
+    name: string;
+    cwd: string;
+    instructions?: string;
+    piArgs: string[];
+    sessionPath?: string;
+    sessionId?: string;
+    state: AgentState;
+    runtime?: {
+        generation: string;
+        state: "starting" | "ready";
+        workerPid?: number;
+        endpoint?: string;
+        claimId?: string;
+        claimedAt?: number;
+    };
+    lastEventSeq: number;
+    createdAt: number;
+    updatedAt: number;
+};
+type Environment = RootDatabase;
+type SharedEnvironment = {
+    root: Environment;
+    agents: Database<AgentRecord, string>;
+    names: Database<string, string>;
+    references: number;
+    closing?: Promise<void>;
+};
+export declare class Registry {
+    #private;
+    constructor(stateDir: string, shared: SharedEnvironment);
+    create(record: AgentRecord): Promise<void>;
+    getById(id: string): AgentRecord | undefined;
+    getByName(name: string): AgentRecord | undefined;
+    list(): AgentSummary[];
+    markReady(id: string, runtimeGeneration: string, ready: Pick<NonNullable<AgentRecord["runtime"]>, "workerPid" | "endpoint"> & Pick<AgentRecord, "sessionPath" | "sessionId">): Promise<boolean>;
+    rollbackCreation(id: string, name: string, runtimeGeneration: string): Promise<void>;
+    close(): Promise<void>;
+    private assertOpen;
+}
+export declare function openRegistry(stateDir: string): Promise<Registry>;
+export {};
+//# sourceMappingURL=registry.d.ts.map

package/dist/internal/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/internal/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,QAAQ,EAAE,KAAK,YAAY,EAAE,MAAM,MAAM,CAAA;AAE7D,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAG3D,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,UAAU,CAAA;IACjB,OAAO,CAAC,EAAE;QACR,UAAU,EAAE,MAAM,CAAA;QAClB,KAAK,EAAE,UAAU,GAAG,OAAO,CAAA;QAC3B,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,SAAS,CAAC,EAAE,MAAM,CAAA;KACnB,CAAA;IACD,YAAY,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,KAAK,WAAW,GAAG,YAAY,CAAA;AAC/B,KAAK,iBAAiB,GAAG;IACvB,IAAI,EAAE,WAAW,CAAA;IACjB,MAAM,EAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC,CAAA;IACrC,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;CACxB,CAAA;AAID,qBAAa,QAAQ;;gBAOP,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB;IAOjD,MAAM,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAUhD,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAK5C,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAMhD,IAAI,IAAI,YAAY,EAAE;IAUhB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,aAAa,GAAG,WAAW,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAuB/L,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUpF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B,OAAO,CAAC,UAAU;CAGnB;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAmBtE"}

package/dist/internal/registry.js

@@ -0,0 +1,118 @@
+import { open } from "lmdb";
+import { prepareStateDir } from "./paths.js";
+import { AgentNameTakenError } from "../types.js";
+const environments = new Map();
+export class Registry {
+    #stateDir;
+    #shared;
+    #agents;
+    #names;
+    #closed = false;
+    constructor(stateDir, shared) {
+        this.#stateDir = stateDir;
+        this.#shared = shared;
+        this.#agents = shared.agents;
+        this.#names = shared.names;
+    }
+    async create(record) {
+        this.assertOpen();
+        const created = await this.#names.ifNoExists(record.name, () => {
+            this.#agents.put(record.id, record, 1);
+            this.#names.put(record.name, record.id);
+        });
+        if (!created)
+            throw new AgentNameTakenError(record.name);
+    }
+    getById(id) {
+        this.assertOpen();
+        return this.#agents.get(id);
+    }
+    getByName(name) {
+        this.assertOpen();
+        const id = this.#names.get(name);
+        return id === undefined ? undefined : this.#agents.get(id);
+    }
+    list() {
+        this.assertOpen();
+        return [...this.#agents.getRange({})].map(({ value }) => ({
+            id: value.id,
+            name: value.name,
+            cwd: value.cwd,
+            state: value.state,
+        }));
+    }
+    async markReady(id, runtimeGeneration, ready) {
+        this.assertOpen();
+        const entry = this.#agents.getEntry(id);
+        if (!entry || entry.value.runtime?.generation !== runtimeGeneration)
+            return false;
+        const { endpoint, workerPid, sessionId, sessionPath } = ready;
+        const record = {
+            ...entry.value,
+            sessionId,
+            sessionPath,
+            state: "idle",
+            runtime: {
+                ...entry.value.runtime,
+                endpoint,
+                workerPid,
+                state: "ready",
+            },
+            updatedAt: Date.now(),
+        };
+        const version = entry.version ?? 0;
+        return this.#agents.put(id, record, version + 1, version);
+    }
+    async rollbackCreation(id, name, runtimeGeneration) {
+        this.assertOpen();
+        await this.#names.transaction(() => {
+            const record = this.#agents.get(id);
+            if (this.#names.get(name) !== id || record?.runtime?.generation !== runtimeGeneration)
+                return;
+            this.#agents.remove(id);
+            this.#names.remove(name);
+        });
+    }
+    async close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        this.#shared.references -= 1;
+        if (this.#shared.references > 0)
+            return;
+        const closing = this.#shared.root.close();
+        this.#shared.closing = closing;
+        try {
+            await closing;
+        }
+        finally {
+            if (environments.get(this.#stateDir) === this.#shared)
+                environments.delete(this.#stateDir);
+        }
+    }
+    assertOpen() {
+        if (this.#closed)
+            throw new Error("The pi-fleet client is closed");
+    }
+}
+export async function openRegistry(stateDir) {
+    const canonicalStateDir = await prepareStateDir(stateDir);
+    let shared = environments.get(canonicalStateDir);
+    if (shared?.closing) {
+        await shared.closing;
+        shared = environments.get(canonicalStateDir);
+    }
+    if (!shared) {
+        const root = open({ path: canonicalStateDir, maxDbs: 3 });
+        shared = {
+            root,
+            agents: root.openDB("agents", { encoding: "json", useVersions: true }),
+            names: root.openDB("names", { encoding: "string" }),
+            references: 0,
+        };
+        environments.set(canonicalStateDir, shared);
+    }
+    shared.references += 1;
+    return new Registry(canonicalStateDir, shared);
+}
+//# sourceMappingURL=registry.js.map

package/dist/internal/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/internal/registry.ts"],"names":[],"mappings":"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"}

package/dist/internal/worker-client.d.ts

@@ -0,0 +1,4 @@
+import { type StatusResponse } from "./protocol.js";
+import type { AgentRecord } from "./registry.js";
+export declare function requestStatus(record: AgentRecord, timeoutMs?: number): Promise<NonNullable<StatusResponse["status"]>>;
+//# sourceMappingURL=worker-client.d.ts.map

package/dist/internal/worker-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-client.d.ts","sourceRoot":"","sources":["../../src/internal/worker-client.ts"],"names":[],"mappings":"AAGA,OAAO,EAAsC,KAAK,cAAc,EAAE,MAAM,eAAe,CAAA;AACvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAIhD,wBAAsB,aAAa,CAAC,MAAM,EAAE,WAAW,EAAE,SAAS,SAAQ,GAAG,OAAO,CAAC,WAAW,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAqC1H"}

package/dist/internal/worker-client.js

@@ -0,0 +1,60 @@
+import { Dealer } from "zeromq";
+import { randomUUID } from "node:crypto";
+import { AgentUnavailableError } from "../types.js";
+import { decode, encode } from "./protocol.js";
+const AGENT_STATES = new Set(["starting", "idle", "working", "stopped", "failed"]);
+export async function requestStatus(record, timeoutMs = 1_000) {
+    const runtime = record.runtime;
+    if (!runtime?.endpoint)
+        throw new AgentUnavailableError(record.name);
+    const socket = new Dealer({ routingId: randomUUID(), immediate: true, linger: 0, sendTimeout: timeoutMs });
+    try {
+        socket.connect(runtime.endpoint);
+        const request = {
+            version: 1,
+            requestId: randomUUID(),
+            command: "status",
+            agentId: record.id,
+            runtimeGeneration: runtime.generation,
+        };
+        await socket.send(encode(request));
+        const frames = await withTimeout(socket.receive(), timeoutMs, record.name);
+        const response = decode(frames[0]);
+        if (!response ||
+            response.version !== 1 ||
+            response.requestId !== request.requestId ||
+            !response.ok ||
+            !response.status ||
+            response.status.id !== record.id ||
+            response.status.name !== record.name ||
+            response.status.runtimeGeneration !== runtime.generation ||
+            !AGENT_STATES.has(response.status.state)) {
+            throw new AgentUnavailableError(record.name);
+        }
+        return response.status;
+    }
+    catch (error) {
+        if (error instanceof AgentUnavailableError)
+            throw error;
+        throw new AgentUnavailableError(record.name);
+    }
+    finally {
+        socket.close();
+    }
+}
+async function withTimeout(promise, timeoutMs, name) {
+    let timeout;
+    try {
+        return await Promise.race([
+            promise,
+            new Promise((_, reject) => {
+                timeout = setTimeout(() => reject(new AgentUnavailableError(name)), timeoutMs);
+            }),
+        ]);
+    }
+    finally {
+        if (timeout)
+            clearTimeout(timeout);
+    }
+}
+//# sourceMappingURL=worker-client.js.map

package/dist/internal/worker-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-client.js","sourceRoot":"","sources":["../../src/internal/worker-client.ts"],"names":[],"mappings":"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"}

package/dist/internal/worker-launcher.d.ts

@@ -0,0 +1,3 @@
+import { type ChildProcess } from "node:child_process";
+export declare function launchWorker(stateDir: string, agentId: string, generation: string): ChildProcess;
+//# sourceMappingURL=worker-launcher.d.ts.map

package/dist/internal/worker-launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-launcher.d.ts","sourceRoot":"","sources":["../../src/internal/worker-launcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAG7D,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,CAShG"}

package/dist/internal/worker-launcher.js

@@ -0,0 +1,13 @@
+import { spawn } from "node:child_process";
+import { fileURLToPath } from "node:url";
+export function launchWorker(stateDir, agentId, generation) {
+    const workerPath = fileURLToPath(new URL("./worker.js", import.meta.url));
+    const child = spawn(process.execPath, [workerPath, "--state-dir", stateDir, "--agent", agentId, "--generation", generation], {
+        detached: true,
+        stdio: "ignore",
+        env: process.env,
+    });
+    child.unref();
+    return child;
+}
+//# sourceMappingURL=worker-launcher.js.map

package/dist/internal/worker-launcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-launcher.js","sourceRoot":"","sources":["../../src/internal/worker-launcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAA;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,OAAe,EAAE,UAAkB;IAChF,MAAM,UAAU,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAA;IACzE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,aAAa,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,cAAc,EAAE,UAAU,CAAC,EAAE;QAC3H,QAAQ,EAAE,IAAI;QACd,KAAK,EAAE,QAAQ;QACf,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC,CAAA;IACF,KAAK,CAAC,KAAK,EAAE,CAAA;IACb,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/internal/worker.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=worker.d.ts.map

package/dist/internal/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/internal/worker.ts"],"names":[],"mappings":""}

package/dist/internal/worker.js

@@ -0,0 +1,114 @@
+import { Router, capability } from "zeromq";
+import { createStateDirectories } from "./paths.js";
+import { decode, encode } from "./protocol.js";
+import { startPi } from "./pi-rpc.js";
+import { openRegistry } from "./registry.js";
+async function main() {
+    const { stateDir, agentId, generation } = parseArguments(process.argv.slice(2));
+    if (!capability.ipc)
+        throw new Error("pi-fleet requires ZeroMQ ipc:// support on this host");
+    const registry = await openRegistry(stateDir);
+    const record = registry.getById(agentId);
+    if (!record || record.runtime?.generation !== generation || !record.runtime.endpoint)
+        throw new Error("Worker claim is no longer current");
+    await createStateDirectories(stateDir);
+    const router = new Router({ mandatory: true, immediate: true, linger: 0, sendTimeout: 1_000 });
+    let routerClosed = false;
+    const closeRouter = () => {
+        if (routerClosed)
+            return;
+        routerClosed = true;
+        router.close();
+    };
+    let pi;
+    const stop = () => closeRouter();
+    process.once("SIGTERM", stop);
+    process.once("SIGINT", stop);
+    try {
+        await router.bind(record.runtime.endpoint);
+        pi = await startPi(record);
+        pi.process.once("exit", closeRouter);
+        const markedReady = await registry.markReady(agentId, generation, {
+            workerPid: process.pid,
+            endpoint: record.runtime.endpoint,
+            sessionPath: pi.state.sessionFile,
+            sessionId: pi.state.sessionId,
+        });
+        if (!markedReady)
+            throw new Error("Worker claim is no longer current");
+        for await (const [route, frame] of router) {
+            const response = statusResponse(frame, agentId, generation, record.name);
+            try {
+                await router.send([route, encode(response)]);
+            }
+            catch (error) {
+                if (!isUnreachablePeer(error))
+                    throw error;
+            }
+        }
+    }
+    finally {
+        process.off("SIGTERM", stop);
+        process.off("SIGINT", stop);
+        pi?.process.off("exit", closeRouter);
+        closeRouter();
+        await stopPi(pi?.process);
+        await registry.close();
+    }
+}
+async function stopPi(pi) {
+    if (!pi || pi.exitCode !== null || pi.signalCode !== null)
+        return;
+    pi.kill("SIGTERM");
+    if (await waitForExit(pi, 1_000))
+        return;
+    pi.kill("SIGKILL");
+    await waitForExit(pi, 1_000);
+}
+async function waitForExit(pi, timeoutMs) {
+    if (pi.exitCode !== null || pi.signalCode !== null)
+        return true;
+    return new Promise((resolve) => {
+        const timeout = setTimeout(() => {
+            pi.off("exit", onExit);
+            resolve(false);
+        }, timeoutMs);
+        const onExit = () => {
+            clearTimeout(timeout);
+            resolve(true);
+        };
+        pi.once("exit", onExit);
+    });
+}
+function statusResponse(frame, agentId, generation, name) {
+    try {
+        const request = decode(frame);
+        if (request.version !== 1 || request.command !== "status" || request.agentId !== agentId || request.runtimeGeneration !== generation) {
+            return { version: 1, requestId: request?.requestId ?? "", ok: false, error: "Worker identity does not match the request" };
+        }
+        return { version: 1, requestId: request.requestId, ok: true, status: { id: agentId, name, runtimeGeneration: generation, state: "idle" } };
+    }
+    catch {
+        return { version: 1, requestId: "", ok: false, error: "Invalid request" };
+    }
+}
+function isUnreachablePeer(error) {
+    return typeof error === "object" && error !== null && "code" in error &&
+        (error.code === "EHOSTUNREACH" || error.code === "EAGAIN");
+}
+function parseArguments(args) {
+    const values = new Map();
+    for (let index = 0; index < args.length; index += 2)
+        values.set(args[index], args[index + 1]);
+    const stateDir = values.get("--state-dir");
+    const agentId = values.get("--agent");
+    const generation = values.get("--generation");
+    if (!stateDir || !agentId || !generation)
+        throw new Error("Worker requires --state-dir, --agent, and --generation");
+    return { stateDir, agentId, generation };
+}
+void main().catch((error) => {
+    process.stderr.write(`${error instanceof Error ? error.stack : String(error)}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=worker.js.map

package/dist/internal/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../src/internal/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAA;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,MAAM,EAAE,MAAM,EAA2C,MAAM,eAAe,CAAA;AACvF,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAA;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAI5C,KAAK,UAAU,IAAI;IACjB,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;IAC/E,IAAI,CAAC,UAAU,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAA;IAE5F,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,QAAQ,CAAC,CAAA;IAC7C,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IACxC,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,UAAU,KAAK,UAAU,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;IAE1I,MAAM,sBAAsB,CAAC,QAAQ,CAAC,CAAA;IACtC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAA;IAC9F,IAAI,YAAY,GAAG,KAAK,CAAA;IACxB,MAAM,WAAW,GAAG,GAAG,EAAE;QACvB,IAAI,YAAY;YAAE,OAAM;QACxB,YAAY,GAAG,IAAI,CAAA;QACnB,MAAM,CAAC,KAAK,EAAE,CAAA;IAChB,CAAC,CAAA;IACD,IAAI,EAAmD,CAAA;IACvD,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,WAAW,EAAE,CAAA;IAChC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;IAC7B,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;IAC5B,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QAC1C,EAAE,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;QAC1B,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;QACpC,MAAM,WAAW,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,OAAO,EAAE,UAAU,EAAE;YAChE,SAAS,EAAE,OAAO,CAAC,GAAG;YACtB,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ;YACjC,WAAW,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW;YACjC,SAAS,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS;SAC9B,CAAC,CAAA;QACF,IAAI,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAA;QAEtE,IAAI,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,MAAM,EAAE,CAAC;YAC1C,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,CAAA;YACxE,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;YAC9C,CAAC;YAAC,OAAO,KAAc,EAAE,CAAC;gBACxB,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC;oBAAE,MAAM,KAAK,CAAA;YAC5C,CAAC;QACH,CAAC;IACH,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QAC5B,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAA;QAC3B,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;QACpC,WAAW,EAAE,CAAA;QACb,MAAM,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,CAAA;QACzB,MAAM,QAAQ,CAAC,KAAK,EAAE,CAAA;IACxB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,EAA8D;IAClF,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,QAAQ,KAAK,IAAI,IAAI,EAAE,CAAC,UAAU,KAAK,IAAI;QAAE,OAAM;IACjE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAClB,IAAI,MAAM,WAAW,CAAC,EAAE,EAAE,KAAK,CAAC;QAAE,OAAM;IACxC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAClB,MAAM,WAAW,CAAC,EAAE,EAAE,KAAK,CAAC,CAAA;AAC9B,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,EAAkD,EAAE,SAAiB;IAC9F,IAAI,EAAE,CAAC,QAAQ,KAAK,IAAI,IAAI,EAAE,CAAC,UAAU,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAC/D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;YACtB,OAAO,CAAC,KAAK,CAAC,CAAA;QAChB,CAAC,EAAE,SAAS,CAAC,CAAA;QACb,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,YAAY,CAAC,OAAO,CAAC,CAAA;YACrB,OAAO,CAAC,IAAI,CAAC,CAAA;QACf,CAAC,CAAA;QACD,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACzB,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAa,EAAE,OAAe,EAAE,UAAkB,EAAE,IAAY;IACtF,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAkB,CAAA;QAC9C,IAAI,OAAO,CAAC,OAAO,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,OAAO,KAAK,OAAO,IAAI,OAAO,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;YACrI,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,IAAI,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAA;QAC5H,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,iBAAiB,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,CAAA;IAC5I,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAA;IAC3E,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAc;IACvC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK;QACnE,CAAE,KAA2B,CAAC,IAAI,KAAK,cAAc,IAAK,KAA2B,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAA;AAC5G,CAAC;AAED,SAAS,cAAc,CAAC,IAAc;IACpC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAA;IACxC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC;QAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAA;IAC7F,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;IAC1C,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACrC,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,cAAc,CAAC,CAAA;IAC7C,IAAI,CAAC,QAAQ,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU;QAAE,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAA;IACnH,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,EAAE,CAAA;AAC1C,CAAC;AAED,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IACjF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;AACtB,CAAC,CAAC,CAAA"}

package/dist/types.d.ts

@@ -0,0 +1,43 @@
+export type AgentState = "starting" | "idle" | "working" | "stopped" | "failed";
+export type ConnectOptions = {
+    /** A private state directory. Intended for isolated tests and advanced local setups. */
+    stateDir?: string;
+};
+export type CreateAgentOptions = {
+    name: string;
+    cwd: string;
+    instructions?: string;
+    piArgs?: string[];
+};
+export type AgentSummary = {
+    id: string;
+    name: string;
+    cwd: string;
+    state: AgentState;
+};
+export type AgentStatus = {
+    id: string;
+    name: string;
+    state: AgentState;
+};
+export interface Agent {
+    readonly id: string;
+    readonly name: string;
+    status(): Promise<AgentStatus>;
+}
+export interface PiFleetClient {
+    create(options: CreateAgentOptions): Promise<Agent>;
+    get(name: string): Promise<Agent>;
+    list(): Promise<AgentSummary[]>;
+    close(): Promise<void>;
+}
+export declare class AgentNameTakenError extends Error {
+    constructor(name: string);
+}
+export declare class AgentNotFoundError extends Error {
+    constructor(name: string);
+}
+export declare class AgentUnavailableError extends Error {
+    constructor(name: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAA;AAE/E,MAAM,MAAM,cAAc,GAAG;IAC3B,wFAAwF;IACxF,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,UAAU,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,UAAU,CAAA;CAClB,CAAA;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,MAAM,IAAI,OAAO,CAAC,WAAW,CAAC,CAAA;CAC/B;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IACnD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAA;IACjC,IAAI,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAAA;IAC/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAED,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,IAAI,EAAE,MAAM;CAIzB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,IAAI,EAAE,MAAM;CAIzB;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,IAAI,EAAE,MAAM;CAIzB"}

package/dist/types.js

@@ -0,0 +1,19 @@
+export class AgentNameTakenError extends Error {
+    constructor(name) {
+        super(`An agent named ${JSON.stringify(name)} already exists`);
+        this.name = "AgentNameTakenError";
+    }
+}
+export class AgentNotFoundError extends Error {
+    constructor(name) {
+        super(`No agent named ${JSON.stringify(name)} exists`);
+        this.name = "AgentNotFoundError";
+    }
+}
+export class AgentUnavailableError extends Error {
+    constructor(name) {
+        super(`Agent ${JSON.stringify(name)} is unavailable`);
+        this.name = "AgentUnavailableError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAwCA,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,IAAY;QACtB,KAAK,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;QAC9D,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;IACnC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC3C,YAAY,IAAY;QACtB,KAAK,CAAC,kBAAkB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACtD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAA;IAClC,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,IAAY;QACtB,KAAK,CAAC,SAAS,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAA;QACrD,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAA;IACrC,CAAC;CACF"}

package/package.json

@@ -1,17 +1,34 @@
 {
   "name": "@elpapi42/pi-fleet-sdk",
-  "version": "0.2.0-beta.0",
-  "description": "Reserved bootstrap version for the official pi-fleet SDK package",
+  "version": "0.2.0",
+  "description": "SDK for durable, host-local Pi agents",
   "license": "MIT",
-  "private": false,
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/elpapi42/pi-fleet.git",
+    "url": "https://github.com/elpapi42/pi-fleet-v2.git",
     "directory": "packages/sdk"
   },
-  "publishConfig": {
-    "access": "public",
-    "tag": "bootstrap"
+  "type": "module",
+  "engines": {
+    "node": ">=22"
   },
-  "files": ["README.md", "LICENSE"]
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc --project tsconfig.json",
+    "test": "node --test test/*.test.mjs"
+  },
+  "dependencies": {
+    "lmdb": "3.5.6",
+    "zeromq": "6.6.0"
+  }
 }

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 elpapi42
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.