@1claw/cli 0.59.10 → 0.60.0

package/dist/src/commands/notify.js

@@ -0,0 +1,155 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import { api } from "../client.js";
+import { requireToken, handleError } from "../middleware.js";
+import { printTable, printSuccess, printInfo, printJson } from "../output.js";
+export const notifyCommand = new Command("notify").description("Manage where approvals reach you — SMS, webhook, email, push");
+notifyCommand
+    .command("list")
+    .alias("ls")
+    .description("List your notification targets")
+    .option("--json", "Output as JSON")
+    .action(async (opts) => {
+    try {
+        requireToken();
+        const result = await api("/notification-targets");
+        if (opts.json) {
+            printJson(result);
+            return;
+        }
+        if ((result.targets ?? []).length === 0) {
+            printInfo("No notification targets. Add one with `1claw notify add`.");
+            return;
+        }
+        printTable(result.targets.map((t) => ({
+            id: t.id,
+            type: t.target_type,
+            destination: destinationOf(t),
+            status: statusOf(t),
+            events: t.events.length === 0 ? chalk.dim("all") : t.events.join(", "),
+        })), [
+            { key: "id", header: "ID", width: 38 },
+            { key: "type", header: "Type", width: 10 },
+            { key: "destination", header: "Destination", width: 30 },
+            { key: "status", header: "Status", width: 22 },
+            { key: "events", header: "Events", width: 24 },
+        ]);
+    }
+    catch (e) {
+        handleError(e);
+    }
+});
+notifyCommand
+    .command("add <type> <destination>")
+    .description("Add a target: sms +14155550123 | webhook https://… | email a@b.co")
+    .option("--agent <agent-id>", "Agent whose SMS channel sends to this number")
+    .option("--events <events>", "Comma-separated event names (default: all)")
+    .option("--json", "Output as JSON")
+    .action(async (type, destination, opts) => {
+    try {
+        requireToken();
+        const config = {};
+        switch (type) {
+            case "sms":
+                config.phone_number = destination;
+                break;
+            case "webhook":
+                config.url = destination;
+                break;
+            case "email":
+                config.email = destination;
+                break;
+            case "expo":
+                config.push_token = destination;
+                break;
+            default:
+                console.error(chalk.red("Type must be one of: sms, webhook, email, expo"));
+                process.exit(1);
+        }
+        const body = { target_type: type, config };
+        if (opts.agent)
+            body.agent_id = opts.agent;
+        if (opts.events) {
+            body.events = String(opts.events)
+                .split(",")
+                .map((s) => s.trim())
+                .filter(Boolean);
+        }
+        const target = await api("/notification-targets", {
+            method: "POST",
+            body,
+        });
+        if (opts.json) {
+            printJson(target);
+            return;
+        }
+        printSuccess(`Added ${type} target ${target.id}`);
+        // Saying "added" and stopping would imply it can already approve
+        // things. It cannot until the number is proved.
+        if (type === "sms") {
+            console.log("");
+            printInfo("It will receive notifications now, but cannot approve anything until verified:");
+            console.log(chalk.cyan(`  1claw notify verify ${target.id}`));
+        }
+    }
+    catch (e) {
+        handleError(e);
+    }
+});
+notifyCommand
+    .command("verify <id>")
+    .description("Verify an SMS target (texts a code, then asks for it)")
+    .option("--code <code>", "Submit a code you already received")
+    .action(async (id, opts) => {
+    try {
+        requireToken();
+        if (opts.code) {
+            await api(`/notification-targets/${id}/verify`, {
+                method: "POST",
+                body: { code: String(opts.code).trim() },
+            });
+            printSuccess("Verified — this number can now approve tier-1 requests by reply.");
+            return;
+        }
+        const started = await api(`/notification-targets/${id}/verify/start`, { method: "POST", body: {} });
+        printSuccess(`Code sent. It expires in ${Math.round((started.expires_in_seconds ?? 600) / 60)} minutes.`);
+        console.log("");
+        printInfo("Then run:");
+        console.log(chalk.cyan(`  1claw notify verify ${id} --code 123456`));
+    }
+    catch (e) {
+        handleError(e);
+    }
+});
+notifyCommand
+    .command("remove <id>")
+    .alias("rm")
+    .description("Remove a notification target")
+    .action(async (id) => {
+    try {
+        requireToken();
+        await api(`/notification-targets/${id}`, { method: "DELETE" });
+        printSuccess(`Removed ${id}`);
+    }
+    catch (e) {
+        handleError(e);
+    }
+});
+function destinationOf(t) {
+    const c = t.config ?? {};
+    return String(c.phone_number ?? c.url ?? c.email ?? c.push_token ?? chalk.dim("—"));
+}
+/**
+ * Verified and unverified are genuinely different states for SMS, and the
+ * difference is what the number is allowed to do.
+ */
+function statusOf(t) {
+    if (!t.is_active)
+        return chalk.dim("inactive");
+    if (t.target_type !== "sms")
+        return chalk.green("active");
+    return t.verified
+        ? chalk.green("verified")
+        : chalk.yellow("unverified (cannot approve)");
+}
+//# sourceMappingURL=notify.js.map

package/dist/src/commands/notify.js.map

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

package/dist/src/commands/platform.js

@@ -1564,4 +1564,235 @@ platformCommand
         handleError(err);
     }
 });
+async function confirmOrExit(message, skip) {
+    if (skip)
+        return true;
+    const inquirer = await import("inquirer");
+    const { confirm } = await inquirer.default.prompt([
+        { type: "confirm", name: "confirm", message, default: false },
+    ]);
+    return confirm;
+}
+const fleetCommand = platformCommand
+    .command("fleet")
+    .description("Manage every agent a template provisioned, as one cohort");
+fleetCommand
+    .command("status <appId> <templateId>")
+    .description("Show version skew and drift for a template's fleet")
+    .option("--json", "Output as JSON")
+    .action(async (appId, templateId, opts) => {
+    try {
+        requireToken();
+        const f = await api(`/platform/apps/${appId}/fleets/${templateId}`);
+        if (opts.json) {
+            printJson(f);
+            return;
+        }
+        printKeyValue([
+            ["Template", `${f.template_name} (${f.template_id})`],
+            ["Current version", String(f.current_version)],
+            ["Spec hash", f.spec_hash ? f.spec_hash.slice(0, 16) : chalk.dim("(none)")],
+            ["Agents", String(f.total_agents)],
+            ["On current version", String(f.agents_on_current_version)],
+            [
+                "Behind",
+                f.agents_behind > 0
+                    ? chalk.yellow(String(f.agents_behind))
+                    : String(f.agents_behind),
+            ],
+            [
+                "Drifted",
+                f.drifted_agents > 0
+                    ? chalk.yellow(`${f.drifted_agents} (hand-edited, rollout skips these)`)
+                    : "0",
+            ],
+        ]);
+        if (f.version_skew.length) {
+            console.log("");
+            printTable(f.version_skew.map((b) => ({
+                version: b.template_version === null ? "(unstamped)" : String(b.template_version),
+                agents: String(b.agents),
+                current: b.template_version === f.current_version ? chalk.green("✓") : "",
+            })), [
+                { key: "version", header: "Provisioned from" },
+                { key: "agents", header: "Agents" },
+                { key: "current", header: "Current" },
+            ]);
+        }
+        console.log("");
+        console.log(chalk.dim(`Bulk-patchable: ${f.bulk_patchable_fields.join(", ")}`));
+        console.log(chalk.dim("Guardrails and capability flags are not on that list — they stay per-agent."));
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+fleetCommand
+    .command("agents <appId> <templateId>")
+    .description("List the agents in a fleet")
+    .option("--limit <n>", "Page size (max 500)", "50")
+    .option("--offset <n>", "Offset", "0")
+    .option("--drifted", "Show only agents a rollout has skipped")
+    .option("--json", "Output as JSON")
+    .action(async (appId, templateId, opts) => {
+    try {
+        requireToken();
+        const res = await api(`/platform/apps/${appId}/fleets/${templateId}/agents`, {
+            query: { limit: opts.limit, offset: opts.offset },
+        });
+        let agents = res.agents ?? [];
+        if (opts.drifted)
+            agents = agents.filter((a) => a.drift_fields.length > 0);
+        if (opts.json) {
+            printJson(agents);
+            return;
+        }
+        if (!agents.length) {
+            console.log(chalk.dim("No agents in this fleet."));
+            return;
+        }
+        printTable(agents.map((a) => ({
+            id: a.agent_id,
+            name: a.name,
+            version: a.provisioned_from_version === null
+                ? chalk.dim("—")
+                : String(a.provisioned_from_version),
+            current: a.is_current ? chalk.green("✓") : chalk.yellow("behind"),
+            drift: a.drift_fields.length ? chalk.yellow(a.drift_fields.join(",")) : "",
+            active: a.is_active ? "✓" : chalk.dim("paused"),
+        })), [
+            { key: "id", header: "Agent", width: 36 },
+            { key: "name", header: "Name", width: 20 },
+            { key: "version", header: "Ver" },
+            { key: "current", header: "State" },
+            { key: "drift", header: "Drift" },
+            { key: "active", header: "Active" },
+        ]);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+fleetCommand
+    .command("patch <appId> <templateId>")
+    .description("Set a field on every agent in the fleet")
+    .requiredOption("--set <key=value...>", "Field to set, repeatable. Guardrails and capability flags are refused.")
+    .option("-y, --yes", "Skip confirmation")
+    .option("--json", "Output as JSON")
+    .action(async (appId, templateId, opts) => {
+    try {
+        requireToken();
+        const patch = {};
+        for (const pair of opts.set) {
+            const eq = pair.indexOf("=");
+            if (eq < 1) {
+                console.error(chalk.red(`Not a key=value pair: ${pair}`));
+                process.exitCode = 1;
+                return;
+            }
+            const key = pair.slice(0, eq);
+            const raw = pair.slice(eq + 1);
+            // Only booleans are coerced; everything else stays a string so a
+            // prompt that happens to look like a number is not silently
+            // retyped on its way to a thousand agents.
+            patch[key] = raw === "true" ? true : raw === "false" ? false : raw;
+        }
+        // Say how many agents this touches before asking, not after.
+        const f = await api(`/platform/apps/${appId}/fleets/${templateId}`);
+        const ok = await confirmOrExit(`Set ${Object.keys(patch).join(", ")} on all ${f.total_agents} agent(s) in "${f.template_name}"?`, opts.yes);
+        if (!ok)
+            return;
+        const res = await api(`/platform/apps/${appId}/fleets/${templateId}/bulk-patch`, {
+            method: "POST",
+            body: { patch },
+        });
+        if (opts.json) {
+            printJson(res);
+            return;
+        }
+        printSuccess(`Set ${res.fields_applied.join(", ")} on ${res.agents_updated} of ${res.agents_matched} agent(s).`);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+fleetCommand
+    .command("rollout <appId> <templateId>")
+    .description("Bring the fleet up to the template's current version")
+    .option("--dry-run", "Report the plan without applying it")
+    .option("--force", "Overwrite hand edits. Still cannot carry a guardrail or capability flag.")
+    .option("-y, --yes", "Skip confirmation")
+    .option("--json", "Output as JSON")
+    .action(async (appId, templateId, opts) => {
+    try {
+        requireToken();
+        if (!opts.dryRun) {
+            const f = await api(`/platform/apps/${appId}/fleets/${templateId}`);
+            const forceNote = opts.force
+                ? ` This will OVERWRITE ${f.drifted_agents} hand-edited agent(s).`
+                : "";
+            const ok = await confirmOrExit(`Roll "${f.template_name}" v${f.current_version} out to ${f.total_agents} agent(s)?${forceNote}`, opts.yes);
+            if (!ok)
+                return;
+        }
+        const res = await api(`/platform/apps/${appId}/fleets/${templateId}/rollout`, {
+            method: "POST",
+            body: { force: !!opts.force, dry_run: !!opts.dryRun },
+        });
+        if (opts.json) {
+            printJson(res);
+            return;
+        }
+        if (res.dry_run) {
+            console.log(chalk.cyan("Dry run — nothing was changed."));
+        }
+        printKeyValue([
+            ["To version", String(res.to_version)],
+            ["Agents", String(res.total_agents)],
+            ["Synced", String(res.synced)],
+            ["Already current", String(res.already_current)],
+            [
+                "Skipped (drifted)",
+                res.skipped_drifted > 0
+                    ? chalk.yellow(String(res.skipped_drifted))
+                    : "0",
+            ],
+            ["Job", res.job_id ?? chalk.dim("(none — dry run)")],
+        ]);
+        const skipped = res.outcomes.filter((o) => o.outcome === "skipped_drifted");
+        if (skipped.length) {
+            console.log("");
+            console.log(chalk.yellow("Skipped because they were changed outside fleet control:"));
+            for (const s of skipped.slice(0, 20)) {
+                console.log(`  ${s.agent_id}  ${chalk.dim((s.drift_fields ?? []).join(", "))}`);
+            }
+            if (skipped.length > 20) {
+                console.log(chalk.dim(`  … and ${skipped.length - 20} more`));
+            }
+            console.log("");
+            console.log(chalk.dim("Re-run with --force to overwrite them."));
+        }
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
+fleetCommand
+    .command("pause <appId> <templateId>")
+    .description("Deactivate every agent in the fleet")
+    .option("-y, --yes", "Skip confirmation")
+    .action(async (appId, templateId, opts) => {
+    try {
+        requireToken();
+        const f = await api(`/platform/apps/${appId}/fleets/${templateId}`);
+        const ok = await confirmOrExit(`Deactivate all ${f.total_agents} agent(s) in "${f.template_name}"? They stop immediately.`, opts.yes);
+        if (!ok)
+            return;
+        const res = await api(`/platform/apps/${appId}/fleets/${templateId}/pause`, { method: "POST", body: {} });
+        printSuccess(`Paused ${res.agents_paused} agent(s).`);
+    }
+    catch (err) {
+        handleError(err);
+    }
+});
 //# sourceMappingURL=platform.js.map