@polpo-ai/cli 0.6.0

package/dist/util/device-code.js

@@ -0,0 +1,103 @@
+/**
+ * Device-code browser login flow.
+ *
+ * Used by both `polpo login` and the smart `requireAuth()` helper to
+ * trigger an interactive OAuth-style login when creds are missing.
+ *
+ * Flow:
+ *   1. POST /v1/cli-auth/request  → returns { code, expiresAt }
+ *   2. Open `{dashboard}/cli-auth?code=<code>` in the user's browser
+ *   3. Poll /v1/cli-auth/poll/{code} until approved or expired
+ *   4. Save creds to ~/.polpo/credentials.json on success
+ *
+ * Does NOT retry automatically. Callers (requireAuth) can wrap in a
+ * retry loop if they want the user to try again on failure.
+ */
+import pc from "picocolors";
+import { openBrowser } from "./browser.js";
+import { saveCredentials } from "../commands/cloud/config.js";
+const DEFAULT_API_URL = "https://api.polpo.sh";
+const DEFAULT_DASHBOARD_URL = "https://polpo.sh";
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export class DeviceCodeError extends Error {
+    reason;
+    constructor(message, reason) {
+        super(message);
+        this.reason = reason;
+        this.name = "DeviceCodeError";
+    }
+}
+/**
+ * Run the device-code login flow end-to-end.
+ *
+ * Resolves with the saved credentials on success.
+ * Throws `DeviceCodeError` on failure (network, expired, timeout).
+ */
+export async function performDeviceCodeLogin(opts = {}) {
+    const baseUrl = opts.apiUrl ?? DEFAULT_API_URL;
+    const dashboardUrl = opts.dashboardUrl ?? DEFAULT_DASHBOARD_URL;
+    // 1. Request a code
+    let code;
+    let expiresAt;
+    try {
+        const res = await fetch(`${baseUrl}/v1/cli-auth/request`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+        });
+        if (!res.ok) {
+            throw new DeviceCodeError(`Server returned ${res.status}. Is ${baseUrl} reachable?`, "server");
+        }
+        const data = (await res.json());
+        code = data.code;
+        expiresAt = data.expiresAt;
+    }
+    catch (err) {
+        if (err instanceof DeviceCodeError)
+            throw err;
+        throw new DeviceCodeError(`Could not reach the API at ${baseUrl}: ${err.message}`, "network");
+    }
+    // 2. Prompt + open browser
+    console.log(`\n  Authorization code: ${pc.bold(code)}\n`);
+    const authUrl = `${dashboardUrl}/cli-auth?code=${code}`;
+    if (opts.noBrowser) {
+        console.log(`  Open this URL to authorize:\n  ${authUrl}\n`);
+    }
+    else {
+        console.log("  Opening browser...");
+        console.log(pc.dim(`  If it doesn't open, visit: ${authUrl}\n`));
+        await openBrowser(authUrl);
+    }
+    process.stdout.write("  Waiting for authorization...");
+    // 3. Poll
+    const expiry = new Date(expiresAt).getTime();
+    const POLL_MS = 2000;
+    while (Date.now() < expiry) {
+        await sleep(POLL_MS);
+        try {
+            const res = await fetch(`${baseUrl}/v1/cli-auth/poll/${code}`);
+            if (res.status === 404) {
+                throw new DeviceCodeError("Code expired.", "expired");
+            }
+            const data = (await res.json());
+            if (data.status === "approved" && data.token) {
+                saveCredentials(data.token, baseUrl);
+                console.log(pc.green("\n\n  Logged in successfully."));
+                console.log(pc.dim(`  Base URL: ${baseUrl}\n`));
+                return { apiKey: data.token, baseUrl };
+            }
+            if (data.status === "expired") {
+                throw new DeviceCodeError("Code expired.", "expired");
+            }
+            process.stdout.write(".");
+        }
+        catch (err) {
+            if (err instanceof DeviceCodeError)
+                throw err;
+            // Network blip — retry silently
+        }
+    }
+    throw new DeviceCodeError("Timed out waiting for authorization.", "timeout");
+}
+//# sourceMappingURL=device-code.js.map

package/dist/util/device-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-code.js","sourceRoot":"","sources":["../../src/util/device-code.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAoB,MAAM,6BAA6B,CAAC;AAEhF,MAAM,eAAe,GAAG,sBAAsB,CAAC;AAC/C,MAAM,qBAAqB,GAAG,kBAAkB,CAAC;AAEjD,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAWD,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAG/B;IAFT,YACE,OAAe,EACR,MAAoD;QAE3D,KAAK,CAAC,OAAO,CAAC,CAAC;QAFR,WAAM,GAAN,MAAM,CAA8C;QAG3D,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAA0B,EAAE;IAE5B,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,IAAI,eAAe,CAAC;IAC/C,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,IAAI,qBAAqB,CAAC;IAEhE,oBAAoB;IACpB,IAAI,IAAY,CAAC;IACjB,IAAI,SAAiB,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,sBAAsB,EAAE;YACxD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;SAChD,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,eAAe,CACvB,mBAAmB,GAAG,CAAC,MAAM,QAAQ,OAAO,aAAa,EACzD,QAAQ,CACT,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAwC,CAAC;QACvE,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACjB,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,eAAe;YAAE,MAAM,GAAG,CAAC;QAC9C,MAAM,IAAI,eAAe,CACvB,8BAA8B,OAAO,KAAM,GAAa,CAAC,OAAO,EAAE,EAClE,SAAS,CACV,CAAC;IACJ,CAAC;IAED,2BAA2B;IAC3B,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE1D,MAAM,OAAO,GAAG,GAAG,YAAY,kBAAkB,IAAI,EAAE,CAAC;IACxD,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,OAAO,CAAC,GAAG,CAAC,oCAAoC,OAAO,IAAI,CAAC,CAAC;IAC/D,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;QACpC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,gCAAgC,OAAO,IAAI,CAAC,CAAC,CAAC;QACjE,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,CAAC,CAAC;IAEvD,UAAU;IACV,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC;IAErB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;QAErB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,qBAAqB,IAAI,EAAE,CAAC,CAAC;YAE/D,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBACvB,MAAM,IAAI,eAAe,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;YACxD,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAuC,CAAC;YAEtE,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC7C,eAAe,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;gBACrC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;gBACvD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,eAAe,OAAO,IAAI,CAAC,CAAC,CAAC;gBAChD,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;YACzC,CAAC;YAED,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC9B,MAAM,IAAI,eAAe,CAAC,eAAe,EAAE,SAAS,CAAC,CAAC;YACxD,CAAC;YAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,GAAG,YAAY,eAAe;gBAAE,MAAM,GAAG,CAAC;YAC9C,gCAAgC;QAClC,CAAC;IACH,CAAC;IAED,MAAM,IAAI,eAAe,CAAC,sCAAsC,EAAE,SAAS,CAAC,CAAC;AAC/E,CAAC"}

package/dist/util/errors.js

@@ -0,0 +1,13 @@
+/**
+ * Translate raw API error messages to actionable CLI hints.
+ */
+export function friendlyError(msg) {
+    if (msg.includes("Multiple projects found"))
+        return "Multiple projects found. Run: polpo projects set";
+    if (/HTTP 401|Unauthorized/i.test(msg))
+        return "Session expired or invalid. Run: polpo login";
+    if (/HTTP 403|Forbidden/i.test(msg))
+        return "Access denied. Check your credentials or project permissions.";
+    return msg;
+}
+//# sourceMappingURL=errors.js.map

package/dist/util/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/util/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,IAAI,GAAG,CAAC,QAAQ,CAAC,yBAAyB,CAAC;QAAE,OAAO,kDAAkD,CAAC;IACvG,IAAI,wBAAwB,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,8CAA8C,CAAC;IAC9F,IAAI,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,+DAA+D,CAAC;IAC5G,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/util/install-cli.js

@@ -0,0 +1,68 @@
+/**
+ * Detect + install the `@polpo-ai/cli` package globally.
+ *
+ * Called at the end of `polpo create`: if the user ran via
+ * `npx @polpo-ai/cli create` they DON'T have the `polpo` bin on PATH
+ * after the wizard ends — they'd have to keep using `npx`. Offering a
+ * one-shot global install saves them from that.
+ *
+ * Skipped when `polpo` is already on PATH (user already installed it).
+ */
+import { exec, execSync } from "node:child_process";
+import { promisify } from "node:util";
+const execAsync = promisify(exec);
+export const CLI_PACKAGE = "@polpo-ai/cli";
+/** `true` when the `polpo` bin is already on PATH globally. */
+export function isPolpoOnPath() {
+    try {
+        const cmd = process.platform === "win32" ? "where polpo" : "which polpo";
+        execSync(cmd, { stdio: "ignore" });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Detect the user's preferred package manager from `npm_config_user_agent`
+ * so we install via the same tool they launched the wizard with.
+ * Falls back to `npm`.
+ */
+export function detectPackageManager() {
+    const ua = process.env.npm_config_user_agent ?? "";
+    if (ua.includes("pnpm"))
+        return "pnpm";
+    if (ua.includes("yarn"))
+        return "yarn";
+    if (ua.includes("bun"))
+        return "bun";
+    return "npm";
+}
+function globalInstallCommand(pm) {
+    switch (pm) {
+        case "pnpm": return `pnpm add -g ${CLI_PACKAGE}`;
+        case "yarn": return `yarn global add ${CLI_PACKAGE}`;
+        case "bun": return `bun add -g ${CLI_PACKAGE}`;
+        default: return `npm install -g ${CLI_PACKAGE}`;
+    }
+}
+/**
+ * Run the global install. Never throws — returns `false` on any failure
+ * (permissions, offline, pkg manager not on PATH). Callers should log
+ * the failure + show the manual command as fallback.
+ */
+export async function installPolpoGlobally() {
+    const pm = detectPackageManager();
+    const command = globalInstallCommand(pm);
+    try {
+        await execAsync(command, { timeout: 120_000, maxBuffer: 10 * 1024 * 1024 });
+        return { ok: true, pm, command };
+    }
+    catch {
+        return { ok: false, pm, command };
+    }
+}
+export function globalInstallHint() {
+    return globalInstallCommand(detectPackageManager());
+}
+//# sourceMappingURL=install-cli.js.map

package/dist/util/install-cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-cli.js","sourceRoot":"","sources":["../../src/util/install-cli.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC;AAE3C,+DAA+D;AAC/D,MAAM,UAAU,aAAa;IAC3B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC;QACzE,QAAQ,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB;IAClC,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,IAAI,EAAE,CAAC;IACnD,IAAI,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrC,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,oBAAoB,CAAC,EAA2C;IACvE,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,MAAM,CAAC,CAAC,OAAO,eAAe,WAAW,EAAE,CAAC;QACjD,KAAK,MAAM,CAAC,CAAC,OAAO,mBAAmB,WAAW,EAAE,CAAC;QACrD,KAAK,KAAK,CAAC,CAAE,OAAO,cAAc,WAAW,EAAE,CAAC;QAChD,OAAO,CAAC,CAAK,OAAO,kBAAkB,WAAW,EAAE,CAAC;IACtD,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB;IACxC,MAAM,EAAE,GAAG,oBAAoB,EAAE,CAAC;IAClC,MAAM,OAAO,GAAG,oBAAoB,CAAC,EAAE,CAAC,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC;QAC5E,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;IACpC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,oBAAoB,CAAC,oBAAoB,EAAE,CAAC,CAAC;AACtD,CAAC"}

package/dist/util/org.js

@@ -0,0 +1,53 @@
+/**
+ * Organization resolution helpers.
+ *
+ * `resolveDefaultOrg()` fetches the user's orgs from the control plane
+ * and returns the first one (used by `deploy` today where only one is
+ * expected). `pickOrg()` is the interactive variant for `create` where
+ * the user may belong to multiple orgs.
+ */
+import * as clack from "@clack/prompts";
+async function listOrgs(client) {
+    const res = await client.get("/v1/orgs");
+    return Array.isArray(res.data) ? res.data : [];
+}
+/**
+ * Return the first (and typically only) org.
+ * Throws when the user has no orgs — onboarding should have seeded one.
+ */
+export async function resolveDefaultOrg(client) {
+    const orgs = await listOrgs(client);
+    if (orgs.length === 0) {
+        throw new Error("No organization found. Complete onboarding at polpo.sh first.");
+    }
+    return orgs[0];
+}
+/**
+ * Interactive org picker.
+ * - 0 orgs → throws
+ * - 1 org → returns it without prompting
+ * - >1   → clack.select picker
+ */
+export async function pickOrg(client) {
+    const orgs = await listOrgs(client);
+    if (orgs.length === 0) {
+        throw new Error("No organization found. Complete onboarding at polpo.sh first.");
+    }
+    if (orgs.length === 1) {
+        clack.log.info(`Organization: ${orgs[0].name}`);
+        return orgs[0];
+    }
+    const choice = await clack.select({
+        message: "Select an organization:",
+        options: orgs.map((o) => ({ value: o.id, label: o.name })),
+    });
+    if (clack.isCancel(choice)) {
+        clack.cancel("Cancelled.");
+        process.exit(0);
+    }
+    const selected = orgs.find((o) => o.id === choice);
+    if (!selected)
+        throw new Error("Invalid org selection");
+    return selected;
+}
+//# sourceMappingURL=org.js.map

package/dist/util/org.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"org.js","sourceRoot":"","sources":["../../src/util/org.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AASxC,KAAK,UAAU,QAAQ,CAAC,MAAiB;IACvC,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,GAAG,CAAQ,UAAU,CAAC,CAAC;IAChD,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;AACjD,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAAiB;IACvD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAiB;IAC7C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;IACnF,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,MAAM,CAAS;QACxC,OAAO,EAAE,yBAAyB;QAClC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;KAC3D,CAAC,CAAC;IACH,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;IACnD,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IACxD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/util/polpo-config.js

@@ -0,0 +1,39 @@
+/**
+ * Read/write helpers for `.polpo/polpo.json` — the per-project config file
+ * that links a directory to a cloud project.
+ *
+ * Schema kept minimal on purpose — whatever fields exist already are
+ * preserved on partial updates.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+export function polpoDirPath(cwd) {
+    return path.resolve(cwd, ".polpo");
+}
+export function polpoConfigPath(cwd) {
+    return path.join(polpoDirPath(cwd), "polpo.json");
+}
+export function readPolpoConfig(cwd) {
+    const file = polpoConfigPath(cwd);
+    if (!fs.existsSync(file))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(file, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Merge `patch` into the existing `.polpo/polpo.json`, creating the file
+ * (and the `.polpo/` dir) if it doesn't exist yet.
+ */
+export function writePolpoConfig(cwd, patch) {
+    const dir = polpoDirPath(cwd);
+    if (!fs.existsSync(dir))
+        fs.mkdirSync(dir, { recursive: true });
+    const existing = readPolpoConfig(cwd) ?? {};
+    const merged = { ...existing, ...patch };
+    fs.writeFileSync(polpoConfigPath(cwd), JSON.stringify(merged, null, 2) + "\n", "utf-8");
+}
+//# sourceMappingURL=polpo-config.js.map

package/dist/util/polpo-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"polpo-config.js","sourceRoot":"","sources":["../../src/util/polpo-config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AA0BlC,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,YAAY,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,IAAI,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IAClC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAuB,CAAC;IAC1E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,KAAyB;IACrE,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;IAC5C,MAAM,MAAM,GAAG,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,EAAE,CAAC;IACzC,EAAE,CAAC,aAAa,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AAC1F,CAAC"}

package/dist/util/project.js

@@ -0,0 +1,87 @@
+/**
+ * Project resolution + creation helpers.
+ *
+ * Centralises the "list projects → pick one, or create a new one" flow
+ * that both `polpo deploy` (today) and `polpo create` (incoming) need.
+ */
+import * as clack from "@clack/prompts";
+import { slugify } from "./slugify.js";
+export async function listProjects(client, orgId) {
+    const res = await client.get(`/v1/projects?orgId=${orgId}`);
+    return Array.isArray(res.data) ? res.data : [];
+}
+export async function getProject(client, projectId) {
+    const res = await client.get(`/v1/projects/${projectId}`);
+    if (res.status === 404)
+        return null;
+    return (res.data ?? null);
+}
+export async function createProject(client, opts) {
+    const slug = opts.slug ?? slugify(opts.name);
+    const res = await client.post("/v1/projects", {
+        name: opts.name,
+        slug,
+        orgId: opts.orgId,
+    });
+    if (!res.data?.id) {
+        throw new Error(`Failed to create project: ${res.data?.error ?? `HTTP ${res.status}`}`);
+    }
+    return res.data;
+}
+/**
+ * Poll `GET /v1/projects/{id}` until `status === "active"` (or timeout).
+ * Projects usually become active within 30–60s of creation.
+ */
+export async function waitForProjectActive(client, projectId, timeoutMs = 120_000) {
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+        const project = await getProject(client, projectId);
+        if (project?.status === "active")
+            return project;
+        await new Promise((r) => setTimeout(r, 3000));
+    }
+    throw new Error("Project creation timed out. Check the dashboard for status.");
+}
+/**
+ * Canonical flow used by `polpo deploy` when no projectId is set locally:
+ *   - 0 projects → create one (prompts unless `force`)
+ *   - 1 project  → auto-select, log, return
+ *   - >1         → picker if interactive; error if not
+ */
+export async function resolveOrCreateProject(opts) {
+    const { client, orgId, name, force, interactive } = opts;
+    const projects = await listProjects(client, orgId);
+    if (projects.length === 1) {
+        return projects[0];
+    }
+    if (projects.length > 1) {
+        if (!interactive) {
+            throw new Error("Multiple projects found. Set projectId in .polpo/polpo.json or run interactively.");
+        }
+        const choice = await clack.select({
+            message: "Select a project:",
+            options: projects.map((p) => ({ value: p.id, label: p.name })),
+        });
+        if (clack.isCancel(choice)) {
+            clack.cancel("Cancelled.");
+            process.exit(0);
+        }
+        const selected = projects.find((p) => p.id === choice);
+        if (!selected)
+            throw new Error("Invalid project selection");
+        return selected;
+    }
+    // Zero projects — create one.
+    if (!force && interactive) {
+        const ok = await clack.confirm({
+            message: `No projects found. Create "${name}"?`,
+            initialValue: true,
+        });
+        if (clack.isCancel(ok) || !ok) {
+            clack.cancel("Aborted.");
+            process.exit(0);
+        }
+    }
+    return await createProject(client, { name, orgId });
+}
+//# sourceMappingURL=project.js.map

package/dist/util/project.js.map

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

package/dist/util/skills.js

@@ -0,0 +1,53 @@
+/**
+ * Install the `lumea-labs/polpo-skills` rule pack for coding agents
+ * (Cursor, Claude Code, Windsurf, Codex, Roo, etc.) via the canonical
+ * `skills` CLI.
+ *
+ * Rule packs teach the user's coding agent how to work with Polpo
+ * (agents.json schema, `polpo deploy` flow, playbook YAML conventions,
+ * ...). They are additive: the `skills` tool merges into existing
+ * agent configs rather than replacing them.
+ *
+ * Scope:
+ *   - `global`  → user's machine (~/.claude, ~/.cursor, etc.)
+ *                 best when the user works on multiple Polpo projects
+ *   - `project` → current directory (.claude/, .cursor/, ...)
+ *                 best for repos that want self-contained agent rules
+ *   - `skip`    → do nothing, we just print the one-liner in the outro
+ */
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+const execAsync = promisify(exec);
+export const POLPO_SKILLS_REPO = "lumea-labs/polpo-skills";
+/**
+ * Shell out to `npx skills@latest add lumea-labs/polpo-skills [-g] -y`.
+ *
+ * Returns `true` on success, `false` on failure. We never throw — skills
+ * install is an enhancement, not a prerequisite. Callers should log
+ * the failure as a warning and continue.
+ */
+export async function installCodingAgentSkills(opts) {
+    if (opts.scope === "skip")
+        return false;
+    const flags = [
+        "--yes", // non-interactive across all prompts inside `skills`
+    ];
+    if (opts.scope === "global")
+        flags.push("--global");
+    const cmd = `npx --yes skills@latest add ${POLPO_SKILLS_REPO} ${flags.join(" ")}`;
+    try {
+        await execAsync(cmd, {
+            cwd: opts.cwd ?? process.cwd(),
+            timeout: opts.timeoutMs ?? 90_000,
+            maxBuffer: 10 * 1024 * 1024,
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function skillsInstallHint() {
+    return `npx skills@latest add ${POLPO_SKILLS_REPO} --global`;
+}
+//# sourceMappingURL=skills.js.map

package/dist/util/skills.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.js","sourceRoot":"","sources":["../../src/util/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC,MAAM,CAAC,MAAM,iBAAiB,GAAG,yBAAyB,CAAC;AAY3D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAA0B;IACvE,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IAExC,MAAM,KAAK,GAAG;QACZ,OAAO,EAAE,qDAAqD;KAC/D,CAAC;IACF,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAEpD,MAAM,GAAG,GAAG,+BAA+B,iBAAiB,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;IAElF,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,GAAG,EAAE;YACnB,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;YAC9B,OAAO,EAAE,IAAI,CAAC,SAAS,IAAI,MAAM;YACjC,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;SAC5B,CAAC,CAAC;QACH,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,yBAAyB,iBAAiB,WAAW,CAAC;AAC/D,CAAC"}

package/dist/util/slugify.js

@@ -0,0 +1,19 @@
+/**
+ * Convert a human-readable project name into a URL-safe slug.
+ * Shared between `polpo create` and `polpo deploy` auto-create so slugs
+ * produced from the same name are identical.
+ *
+ * Rules:
+ *   - lowercase
+ *   - any non a-z0-9 collapses to a single hyphen
+ *   - leading/trailing hyphens stripped
+ *   - empty result → "project"
+ */
+export function slugify(name) {
+    const slug = name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+    return slug || "project";
+}
+//# sourceMappingURL=slugify.js.map

package/dist/util/slugify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.js","sourceRoot":"","sources":["../../src/util/slugify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,MAAM,IAAI,GAAG,IAAI;SACd,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC3B,OAAO,IAAI,IAAI,SAAS,CAAC;AAC3B,CAAC"}

package/dist/util/template.js

@@ -0,0 +1,118 @@
+/**
+ * Template system for `polpo create`.
+ *
+ * Scaffolding is delegated to the separately-published `create-polpo-app`
+ * tool (maintained in the polpo-ui repo) — we shell out to it with flags
+ * so template logic + download strategy live in one place. Our CLI keeps
+ * only the metadata needed to render the wizard picker.
+ *
+ * For the `empty` option we scaffold a tiny `.polpo/` inline (no network,
+ * no external tool) because `create-polpo-app` targets full frontend
+ * templates, not blank projects.
+ */
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+const execAsync = promisify(exec);
+/**
+ * The picker list. Must be kept in sync manually with the `TEMPLATES`
+ * object in polpo-ui/packages/create-app/bin.mjs. If create-polpo-app
+ * adds a new template, users can still pass `--template <newname>` —
+ * we just won't list it in the interactive picker until updated here.
+ */
+export const TEMPLATES = [
+    {
+        id: "empty",
+        label: "Blank project",
+        hint: "just .polpo/ — plug into your existing codebase",
+        kind: "blank",
+    },
+    {
+        id: "chat",
+        label: "Chat",
+        hint: "full-page chat w/ sessions + dark mode (Next.js)",
+        kind: "remote",
+        installsDeps: true,
+    },
+    {
+        id: "chat-widget",
+        label: "Chat widget",
+        hint: "embeddable chat widget (Vite/React)",
+        kind: "remote",
+        installsDeps: true,
+    },
+    {
+        id: "multi-agent",
+        label: "Multi-agent",
+        hint: "multi-agent workspace (Next.js)",
+        kind: "remote",
+        installsDeps: true,
+    },
+];
+export function findTemplate(id) {
+    return TEMPLATES.find((t) => t.id === id);
+}
+/**
+ * Write a minimal .polpo/ scaffold into `targetDir` (blank template).
+ * Creates:
+ *   .polpo/polpo.json  — project config (projectId added later by create)
+ *   .polpo/teams.json  — single "default" team
+ *   .polpo/agents.json — array of wrapped agents: [{agent, teamName}]
+ *   .env.local.example
+ *   README.md
+ *
+ * Layout follows the canonical format read by FileAgentStore / FileTeamStore
+ * and validated by `polpo deploy`: agents live in a single agents.json array
+ * with each entry as `{ agent: AgentConfig, teamName: string }`.
+ */
+export function writeBlankScaffold(targetDir, projectName) {
+    fs.mkdirSync(path.join(targetDir, ".polpo"), { recursive: true });
+    fs.writeFileSync(path.join(targetDir, ".polpo", "polpo.json"), JSON.stringify({ project: projectName }, null, 2) + "\n");
+    fs.writeFileSync(path.join(targetDir, ".polpo", "teams.json"), JSON.stringify([{ name: "default", description: "Default team" }], null, 2) + "\n");
+    fs.writeFileSync(path.join(targetDir, ".polpo", "agents.json"), JSON.stringify([
+        {
+            agent: {
+                name: "agent-1",
+                role: "helpful assistant",
+                model: "xai/grok-4-fast",
+            },
+            teamName: "default",
+        },
+    ], null, 2) + "\n");
+    fs.writeFileSync(path.join(targetDir, ".env.local.example"), "# Cloud usage: POLPO_API_URL is set automatically by `polpo create` to your\n" +
+        "# project's subdomain (https://{slug}.polpo.cloud). Override here only for\n" +
+        "# self-hosted, custom domains, or local dev.\n" +
+        "POLPO_API_KEY=\n" +
+        "POLPO_API_URL=https://your-project-slug.polpo.cloud\n");
+    fs.writeFileSync(path.join(targetDir, "README.md"), `# ${projectName}\n\nBuilt with [Polpo](https://polpo.sh).\n\n` +
+        "## Commands\n\n" +
+        "```bash\n" +
+        "polpo deploy   # push .polpo/ to cloud\n" +
+        "polpo logs     # tail cloud logs\n" +
+        "```\n");
+}
+/**
+ * Shell out to `create-polpo-app` with the right flags to scaffold a
+ * remote template into `targetDir`.
+ *
+ * Uses `-y` (non-interactive) so our wizard owns prompts; `create-polpo-app`
+ * runs fully scripted.
+ */
+export async function scaffoldRemoteTemplate(opts) {
+    const parent = path.dirname(opts.targetDir);
+    const name = path.basename(opts.targetDir);
+    const flags = [
+        name,
+        `--template ${opts.templateId}`,
+        "-y",
+        opts.skipInstall ? "--skip-install" : null,
+    ]
+        .filter(Boolean)
+        .join(" ");
+    await execAsync(`npx --yes create-polpo-app@latest ${flags}`, {
+        cwd: parent,
+        maxBuffer: 10 * 1024 * 1024,
+    });
+}
+//# sourceMappingURL=template.js.map

package/dist/util/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/util/template.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAelC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,SAAS,GAAyB;IAC7C;QACE,EAAE,EAAE,OAAO;QACX,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,iDAAiD;QACvD,IAAI,EAAE,OAAO;KACd;IACD;QACE,EAAE,EAAE,MAAM;QACV,KAAK,EAAE,MAAM;QACb,IAAI,EAAE,kDAAkD;QACxD,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI;KACnB;IACD;QACE,EAAE,EAAE,aAAa;QACjB,KAAK,EAAE,aAAa;QACpB,IAAI,EAAE,qCAAqC;QAC3C,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI;KACnB;IACD;QACE,EAAE,EAAE,aAAa;QACjB,KAAK,EAAE,aAAa;QACpB,IAAI,EAAE,iCAAiC;QACvC,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,EAAU;IACrC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB,EAAE,WAAmB;IACvE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAElE,EAAE,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,EAC5C,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CACzD,CAAC;IAEF,EAAE,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,CAAC,EAC5C,IAAI,CAAC,SAAS,CACZ,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,CAAC,EAClD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,CACT,CAAC;IAEF,EAAE,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,aAAa,CAAC,EAC7C,IAAI,CAAC,SAAS,CACZ;QACE;YACE,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,IAAI,EAAE,mBAAmB;gBACzB,KAAK,EAAE,iBAAiB;aACzB;YACD,QAAQ,EAAE,SAAS;SACpB;KACF,EACD,IAAI,EACJ,CAAC,CACF,GAAG,IAAI,CACT,CAAC;IAEF,EAAE,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,EAC1C,+EAA+E;QAC7E,8EAA8E;QAC9E,gDAAgD;QAChD,kBAAkB;QAClB,uDAAuD,CAC1D,CAAC;IAEF,EAAE,CAAC,aAAa,CACd,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,EACjC,KAAK,WAAW,+CAA+C;QAC7D,iBAAiB;QACjB,WAAW;QACX,0CAA0C;QAC1C,oCAAoC;QACpC,OAAO,CACV,CAAC;AACJ,CAAC;AAWD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAA2B;IACtE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAE3C,MAAM,KAAK,GAAG;QACZ,IAAI;QACJ,cAAc,IAAI,CAAC,UAAU,EAAE;QAC/B,IAAI;QACJ,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI;KAC3C;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,MAAM,SAAS,CAAC,qCAAqC,KAAK,EAAE,EAAE;QAC5D,GAAG,EAAE,MAAM;QACX,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;KAC5B,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@polpo-ai/cli",
+  "version": "0.6.0",
+  "description": "Command-line client for Polpo — create/link/deploy cloud projects from your terminal.",
+  "license": "Apache-2.0",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "polpo": "dist/index.js",
+    "polpo-ai": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@clack/prompts": "^0.9.1",
+    "commander": "^13.1.0",
+    "picocolors": "^1.1.1",
+    "@polpo-ai/server": "0.6.0",
+    "@polpo-ai/vault-crypto": "0.6.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "typescript": "^5.7.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}