@polpo-ai/cli 0.15.71 → 0.15.73

package/dist/commands/cloud/channels.js

@@ -0,0 +1,234 @@
+/**
+ * Agent-native conversational Channel management.
+ *
+ * Credentials are intentionally absent from this command surface. Providers
+ * that need authorization return an expiring secure setup URL.
+ */
+import { randomUUID } from "node:crypto";
+import * as clack from "@clack/prompts";
+import pc from "picocolors";
+import { createApiClient } from "./api.js";
+import { loadProjectId } from "./project-context.js";
+import { requireAuth } from "../../util/auth.js";
+import { friendlyError } from "../../util/errors.js";
+class ChannelCliApiError extends Error {
+    code;
+    status;
+    constructor(message, code, status) {
+        super(message);
+        this.code = code;
+        this.status = status;
+        this.name = "ChannelCliApiError";
+    }
+}
+export function conversationChannelPath(...segments) {
+    return `/v1/channels${segments.length ? `/${segments.map(encodeURIComponent).join("/")}` : ""}`;
+}
+function parseJsonObject(value, label) {
+    if (!value)
+        return undefined;
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch {
+        throw new Error(`${label} must be valid JSON.`);
+    }
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error(`${label} must be a JSON object.`);
+    }
+    return parsed;
+}
+function dataFrom(response) {
+    if (response.status < 200 || response.status >= 300) {
+        throw new ChannelCliApiError(response.data?.error ?? `Channel API returned HTTP ${response.status}`, response.data?.code ?? "CHANNEL_API_ERROR", response.status);
+    }
+    return response.data?.data;
+}
+function printResult(value, json) {
+    if (json) {
+        process.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+        return;
+    }
+    if (Array.isArray(value)) {
+        if (value.length === 0) {
+            clack.log.info("No Channels found.");
+            return;
+        }
+        clack.log.info(value.map((item) => {
+            const detail = item.status ?? item.availability ?? item.agentName ?? "";
+            return `  ${pc.bold(item.name ?? item.label ?? item.id)}${detail ? pc.dim(`  ${detail}`) : ""}`;
+        }).join("\n"));
+        return;
+    }
+    const result = value;
+    if (result?.status === "setup_required" || result?.setup?.url) {
+        clack.log.info(`${pc.bold("Secure setup required")}\n${result.setup.url}\n${pc.dim(`Expires ${result.setup.expiresAt}`)}`);
+        return;
+    }
+    clack.log.info(JSON.stringify(value, null, 2));
+}
+async function withChannelClient(operation, options, action) {
+    try {
+        const creds = await requireAuth({ context: `${operation} requires an authenticated session.` });
+        const projectId = loadProjectId();
+        if (!projectId)
+            throw new Error("No project linked. Run polpo create or polpo link first.");
+        await action(createApiClient(creds, projectId));
+    }
+    catch (error) {
+        if (options.json) {
+            process.stderr.write(`${JSON.stringify({
+                ok: false,
+                code: error instanceof ChannelCliApiError ? error.code : "CLI_ERROR",
+                error: error instanceof Error ? error.message : String(error),
+                ...(error instanceof ChannelCliApiError ? { status: error.status } : {}),
+            })}\n`);
+            process.exitCode = 1;
+            return;
+        }
+        clack.log.error(pc.red(friendlyError(error instanceof Error ? error.message : String(error))));
+        process.exitCode = 1;
+    }
+}
+export function registerChannelsCommand(program) {
+    const channels = program
+        .command("channels")
+        .description("Configure conversational Channels and agent Routes");
+    channels.command("providers")
+        .description("List supported Channel providers")
+        .option("--json", "Print JSON")
+        .action((opts) => withChannelClient("Listing Channel providers", opts, async (client) => {
+        printResult(dataFrom(await client.get(conversationChannelPath("providers"))), Boolean(opts.json));
+    }));
+    channels.command("list")
+        .description("List project Channels")
+        .option("--provider <provider>", "Filter by provider")
+        .option("--status <status>", "Filter by status")
+        .option("--connection <id>", "Filter by Connection id")
+        .option("--json", "Print JSON")
+        .action((opts) => withChannelClient("Listing Channels", opts, async (client) => {
+        const query = new URLSearchParams();
+        if (opts.provider)
+            query.set("provider", opts.provider);
+        if (opts.status)
+            query.set("status", opts.status);
+        if (opts.connection)
+            query.set("connectionId", opts.connection);
+        const suffix = query.size ? `?${query.toString()}` : "";
+        printResult(dataFrom(await client.get(`${conversationChannelPath()}${suffix}`)), Boolean(opts.json));
+    }));
+    channels.command("get <channel-id>")
+        .description("Inspect a Channel without exposing credentials")
+        .option("--json", "Print JSON")
+        .action((channelId, opts) => withChannelClient("Getting a Channel", opts, async (client) => {
+        printResult(dataFrom(await client.get(conversationChannelPath(channelId))), Boolean(opts.json));
+    }));
+    channels.command("add <provider>")
+        .description("Configure a Channel and grant it to an agent")
+        .requiredOption("--agent <name>", "Agent receiving the Channel route")
+        .option("--connection <id>", "Existing project Connection id")
+        .option("--destination <id>", "Provider destination id, when known")
+        .option("--name <name>", "Channel display name")
+        .option("--priority <number>", "Route priority", "100")
+        .option("--settings <json>", "Channel settings as a JSON object")
+        .option("--idempotency-key <key>", "Stable retry key")
+        .option("--json", "Print JSON")
+        .action((provider, opts) => withChannelClient("Configuring a Channel", opts, async (client) => {
+        const priority = Number(opts.priority);
+        if (!Number.isSafeInteger(priority))
+            throw new Error("--priority must be an integer.");
+        const body = {
+            provider,
+            agentName: opts.agent,
+            connectionId: opts.connection,
+            externalChannelId: opts.destination,
+            idempotencyKey: opts.idempotencyKey ?? randomUUID(),
+            name: opts.name,
+            priority,
+            settings: parseJsonObject(opts.settings, "--settings"),
+        };
+        printResult(dataFrom(await client.post(conversationChannelPath("configure"), body)), Boolean(opts.json));
+    }));
+    channels.command("update <channel-id>")
+        .description("Update Channel name, settings, or status")
+        .option("--name <name>", "Channel display name")
+        .option("--status <status>", "active or disabled")
+        .option("--settings <json>", "Channel settings as a JSON object")
+        .option("--json", "Print JSON")
+        .action((channelId, opts) => withChannelClient("Updating a Channel", opts, async (client) => {
+        const body = {
+            ...(opts.name ? { name: opts.name } : {}),
+            ...(opts.status ? { status: opts.status } : {}),
+            ...(opts.settings ? { settings: parseJsonObject(opts.settings, "--settings") } : {}),
+        };
+        if (Object.keys(body).length === 0)
+            throw new Error("Provide --name, --status, or --settings.");
+        printResult(dataFrom(await client.patch(conversationChannelPath(channelId), body)), Boolean(opts.json));
+    }));
+    channels.command("test <channel-id>")
+        .description("Test an active Channel")
+        .option("--json", "Print JSON")
+        .action((channelId, opts) => withChannelClient("Testing a Channel", opts, async (client) => {
+        printResult(dataFrom(await client.post(conversationChannelPath(channelId, "test"))), Boolean(opts.json));
+    }));
+    channels.command("remove <channel-id>")
+        .alias("rm")
+        .description("Remove a Channel and its Routes, but keep its Connection")
+        .option("--yes", "Skip confirmation")
+        .option("--json", "Print JSON")
+        .action((channelId, opts) => withChannelClient("Removing a Channel", opts, async (client) => {
+        if (!opts.yes) {
+            if (!process.stdin.isTTY)
+                throw new Error("Use --yes in non-interactive environments.");
+            const confirmed = await clack.confirm({ message: `Remove Channel ${channelId}?` });
+            if (clack.isCancel(confirmed) || !confirmed)
+                return;
+        }
+        printResult(dataFrom(await client.delete(conversationChannelPath(channelId))), Boolean(opts.json));
+    }));
+    const routes = channels.command("routes").description("Manage agent Routes for a Channel");
+    routes.command("list <channel-id>")
+        .option("--json", "Print JSON")
+        .action((channelId, opts) => withChannelClient("Listing Channel Routes", opts, async (client) => {
+        printResult(dataFrom(await client.get(conversationChannelPath(channelId, "routes"))), Boolean(opts.json));
+    }));
+    routes.command("add <channel-id>")
+        .requiredOption("--agent <name>", "Agent name")
+        .option("--destination <id>", "Route-specific destination")
+        .option("--priority <number>", "Route priority", "100")
+        .option("--disabled", "Create the Route disabled")
+        .option("--json", "Print JSON")
+        .action((channelId, opts) => withChannelClient("Adding a Channel Route", opts, async (client) => {
+        const priority = Number(opts.priority);
+        if (!Number.isSafeInteger(priority))
+            throw new Error("--priority must be an integer.");
+        printResult(dataFrom(await client.post(conversationChannelPath(channelId, "routes"), {
+            agentName: opts.agent,
+            externalChannelId: opts.destination,
+            enabled: !opts.disabled,
+            priority,
+        })), Boolean(opts.json));
+    }));
+    routes.command("remove <channel-id> <route-id>")
+        .alias("rm")
+        .option("--yes", "Skip confirmation")
+        .option("--json", "Print JSON")
+        .action((channelId, routeId, opts) => withChannelClient("Removing a Channel Route", opts, async (client) => {
+        if (!opts.yes) {
+            if (!process.stdin.isTTY)
+                throw new Error("Use --yes in non-interactive environments.");
+            const confirmed = await clack.confirm({ message: `Remove Route ${routeId}?` });
+            if (clack.isCancel(confirmed) || !confirmed)
+                return;
+        }
+        printResult(dataFrom(await client.delete(conversationChannelPath(channelId, "routes", routeId))), Boolean(opts.json));
+    }));
+    channels.command("setup-status <setup-id>")
+        .description("Inspect a resumable secure setup")
+        .option("--json", "Print JSON")
+        .action((setupId, opts) => withChannelClient("Getting Channel setup status", opts, async (client) => {
+        printResult(dataFrom(await client.get(conversationChannelPath("setups", setupId))), Boolean(opts.json));
+    }));
+}
+//# sourceMappingURL=channels.js.map

package/dist/commands/cloud/channels.js.map

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

package/dist/commands/cloud/channels.test.js

@@ -0,0 +1,31 @@
+import { describe, expect, it } from "vitest";
+import { Command } from "commander";
+import { conversationChannelPath, registerChannelsCommand } from "./channels.js";
+describe("Channels CLI", () => {
+    it("encodes every resource path segment", () => {
+        expect(conversationChannelPath("channel/a", "routes", "route b"))
+            .toBe("/v1/channels/channel%2Fa/routes/route%20b");
+    });
+    it("exposes lifecycle and route commands without credential flags", () => {
+        const program = new Command();
+        program.exitOverride();
+        registerChannelsCommand(program);
+        const help = program.commands.find((command) => command.name() === "channels").helpInformation();
+        expect(help).toContain("providers");
+        expect(help).toContain("add");
+        expect(help).toContain("routes");
+        expect(help).toContain("setup-status");
+        expect(help).not.toMatch(/--(?:token|secret|password|api-key|verify-token)/i);
+        const channels = program.commands.find((command) => command.name() === "channels");
+        const add = channels.commands.find((command) => command.name() === "add");
+        expect(add.registeredArguments[0]?.required).toBe(true);
+        expect(add.options.map((option) => option.long)).not.toEqual(expect.arrayContaining([
+            "--token",
+            "--secret",
+            "--password",
+            "--api-key",
+            "--verify-token",
+        ]));
+    });
+});
+//# sourceMappingURL=channels.test.js.map

package/dist/commands/cloud/channels.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channels.test.js","sourceRoot":"","sources":["../../../src/commands/cloud/channels.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AAEjF,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;QAC7C,MAAM,CAAC,uBAAuB,CAAC,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;aAC9D,IAAI,CAAC,2CAA2C,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;QAC9B,OAAO,CAAC,YAAY,EAAE,CAAC;QACvB,uBAAuB,CAAC,OAAO,CAAC,CAAC;QACjC,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,UAAU,CAAE,CAAC,eAAe,EAAE,CAAC;QAElG,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;QACpC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;QACvC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,mDAAmD,CAAC,CAAC;QAE9E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,UAAU,CAAE,CAAC;QACpF,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,KAAK,CAAE,CAAC;QAC3E,MAAM,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC;YAClF,SAAS;YACT,UAAU;YACV,YAAY;YACZ,WAAW;YACX,gBAAgB;SACjB,CAAC,CAAC,CAAC;IACN,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commands/cloud/deploy.js

@@ -7,7 +7,7 @@
  *   - memory.md + memory/<agent>.md (knowledge base)
  *   - playbooks/ (mission templates)
  *   - missions/ (mission definitions)
- *   - skills/ (SKILL.md files)
+ *   - skills/ (complete Agent Skills bundles)
  *   - vault.enc (encrypted credentials)
  *
  * Opt-in (with flags):
@@ -33,6 +33,7 @@ import { listLoopSourceFiles, loadLoopDeployPayload } from "../../util/loops.js"
 import { prepareScheduleDeployments } from "../../util/schedules.js";
 import { readPolpoConfig, writePolpoConfig } from "../../util/polpo-config.js";
 import { collectCustomToolSourceArtifact, extractCustomToolName, } from "../../util/custom-tool-source.js";
+import { collectLocalSkillBundle } from "../../util/runtime-skill-bundle.js";
 function emptyResult() {
     return {
         created: 0,
@@ -448,84 +449,41 @@ async function deploySkills(client, polpoDir, opts) {
         const skillFile = path.join(skillsDir, entry.name, "SKILL.md");
         if (!fs.existsSync(skillFile))
             continue;
-        const raw = fs.readFileSync(skillFile, "utf-8");
-        const fmMatch = raw.match(/^---\n([\s\S]*?)\n---/);
-        let name = entry.name;
-        let description = "";
-        let allowedTools;
-        if (fmMatch) {
-            const lines = fmMatch[1].split("\n");
-            let currentArray = null;
-            for (const line of lines) {
-                const arrayItem = line.match(/^\s+-\s+(.+)/);
-                if (arrayItem && currentArray) {
-                    currentArray.push(arrayItem[1].trim());
-                    continue;
-                }
-                currentArray = null;
-                const kv = line.match(/^(\w[\w-]*)\s*:\s*(.+)?/);
-                if (kv) {
-                    const key = kv[1];
-                    const val = kv[2]?.trim();
-                    if (key === "name" && val)
-                        name = val;
-                    if (key === "description" && val)
-                        description = val;
-                    if (key === "allowed-tools" || key === "allowedTools") {
-                        allowedTools = [];
-                        currentArray = allowedTools;
-                    }
-                }
-            }
+        let localBundle;
+        try {
+            localBundle = collectLocalSkillBundle(path.join(skillsDir, entry.name), entry.name);
         }
-        const bodyMatch = raw.match(/^---\n[\s\S]*?\n---\n?([\s\S]*)$/);
-        const content = bodyMatch ? bodyMatch[1].trim() : raw.trim();
-        const localSkill = { name, description, content };
+        catch (error) {
+            result.errors.push(`skill "${entry.name}": ${error instanceof Error ? error.message : String(error)}`);
+            result.failed++;
+            continue;
+        }
+        const name = localBundle.name;
         const remote = existingSkills[name];
-        const action = await resolveDeployConflict(localSkill, remote ? { name: remote.name, description: remote.description, content: remote.content } : null, `skill "${name}"`, opts);
+        let remoteBundle = null;
+        if (remote) {
+            const bundleRes = await client.get(`/v1/skills/${encodeURIComponent(name)}/bundle`);
+            if (bundleRes.status === 200)
+                remoteBundle = bundleRes.data?.data ?? bundleRes.data;
+        }
+        const action = await resolveDeployConflict(localBundle, remoteBundle, `skill "${name}"`, opts);
         if (action === "skip") {
             result.skipped++;
             continue;
         }
-        // The server doesn't expose `PUT /v1/skills/{name}` for in-place updates —
-        // only POST /v1/skills/create + DELETE /v1/skills/{name} exist. So
-        // "update existing skill" is implemented as delete-then-recreate. The
-        // DELETE failure is logged but we still try the create: if it succeeds
-        // the user ends up with a fresh copy, which is the intent.
-        if (remote) {
-            const delRes = await client.delete(`/v1/skills/${encodeURIComponent(name)}`);
-            if (delRes.status >= 400 && delRes.status !== 404) {
-                const msg = readErrorBody(delRes.data, delRes.status);
-                result.errors.push(`skill "${name}": delete-before-update failed — ${friendlyError(msg)}`);
-                result.failed++;
-                continue;
-            }
-            const res = await client.post("/v1/skills/create", {
-                name, description, content,
-                ...(allowedTools?.length ? { allowedTools } : {}),
-            });
-            if (res.status >= 200 && res.status < 300) {
+        const res = await client.put(`/v1/skills/${encodeURIComponent(name)}/bundle`, {
+            files: localBundle.files,
+        });
+        if (res.status >= 200 && res.status < 300) {
+            if (remote)
                 result.updated++;
-            }
-            else {
-                const msg = readErrorBody(res.data, res.status);
-                result.errors.push(`skill "${name}": recreate failed — ${friendlyError(msg)}`);
-                result.failed++;
-            }
+            else
+                result.created++;
         }
         else {
-            const res = await client.post("/v1/skills/create", {
-                name, description, content,
-                ...(allowedTools?.length ? { allowedTools } : {}),
-            });
-            if (res.status >= 200 && res.status < 300) {
-                result.created++;
-            }
-            else {
-                const msg = readErrorBody(res.data, res.status);
-                result.errors.push(`skill "${name}": ${friendlyError(msg)}`);
-                result.failed++;
-            }
+            const msg = readErrorBody(res.data, res.status);
+            result.errors.push(`skill "${name}": bundle deploy failed — ${friendlyError(msg)}`);
+            result.failed++;
         }
     }
     return result;