@bli-cockpit/cli 0.2.241 → 0.2.242

package/dist/commands/local-args-tower-msg.js

@@ -1,6 +1,7 @@
 import { optionalNonEmpty, optionalPositiveInteger, optionalUrl, parseNamedArgs } from "./local-arg-values.js";
 const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-const MSG_ACTIONS = new Set(["channels", "read", "send", "thread", "create", "dm", "show", "unread", "edit", "delete", "outcome"]);
+const MSG_DRAFT_VERBS = new Set(["list", "show", "save", "discard", "restore", "send"]);
+const MSG_ACTIONS = new Set(["channels", "read", "send", "thread", "create", "dm", "show", "unread", "edit", "delete", "outcome", "draft"]);
 const MSG_ACTIONS_NEEDING_A_CHANNEL = new Set(["read", "send", "unread"]);
 /**
  * `--members a@x.test,b@y.test` — addresses only, split on commas, never
@@ -48,6 +49,8 @@ export function parseMsgArgs(args) {
         ],
     });
     const { action, rest } = parseMsgAction(values.positionals);
+    if (action === "draft")
+        return parseMsgDraftArgs(values, rest);
     if (values.flags.has("--before") && action !== "read" && action !== "thread") {
         throw new Error("--before belongs to msg read or msg thread.");
     }
@@ -58,6 +61,60 @@ export function parseMsgArgs(args) {
     const writeSafety = parseMsgWriteSafety(action, rest, values);
     return buildMsgCommand(values, action, channelRef, channelName, dmEmail, memberEmails, description, isPrivate, threadId, limit, markRead, unreadFrom, writeSafety);
 }
+/**
+ * `cockpit msg draft [list|show|save|discard|restore|send] <channel> [--thread <id>] [--expected-revision <n>]`
+ * (BLI-21414). `list` takes no channel; every other verb needs one. `--request-id` belongs to `send`.
+ */
+function parseMsgDraftArgs(values, rest) {
+    const first = rest[0];
+    let verb = "list";
+    let positional = rest;
+    if (first !== undefined) {
+        if (!MSG_DRAFT_VERBS.has(first)) {
+            throw new Error(`Unknown msg draft command: ${first}. Try list, show, save, discard, restore or send.`);
+        }
+        verb = first;
+        positional = rest.slice(1);
+    }
+    const stray = ["--limit", "--before", "--members", "--description", "--from", "--channel"].find((flag) => values.flags.has(flag));
+    if (stray || values.booleans.has("--private") || values.booleans.has("--mark-read")) {
+        throw new Error(`${stray ?? "That flag"} does not belong to \`cockpit msg draft\`. It takes a channel, --thread <id> and --expected-revision <n>.`);
+    }
+    let channelRef;
+    if (verb === "list") {
+        if (positional.length > 0 || values.flags.has("--thread"))
+            throw new Error("msg draft list takes no channel; it lists all your unsent drafts.");
+    }
+    else {
+        channelRef = optionalNonEmpty(positional[0]);
+        if (!channelRef)
+            throw new Error(`msg draft ${verb} needs a channel id or name, e.g. \`cockpit msg draft ${verb} general\`.`);
+        if (positional.length > 1)
+            throw new Error(`msg draft ${verb} takes one channel, not ${positional.length}.`);
+    }
+    const requestId = optionalNonEmpty(values.flags.get("--request-id"));
+    if (requestId && (verb !== "send" || !UUID_PATTERN.test(requestId))) {
+        throw new Error(verb === "send" ? "--request-id must be a UUID." : "--request-id belongs to `cockpit msg draft send`.");
+    }
+    const expectedRevision = optionalPositiveInteger(values.flags.get("--expected-revision"), "--expected-revision");
+    if (expectedRevision !== undefined && (verb === "list" || verb === "show")) {
+        throw new Error("--expected-revision belongs to `msg draft save`, `discard`, `restore` or `send`.");
+    }
+    const threadId = optionalNonEmpty(values.flags.get("--thread"));
+    return {
+        kind: "msg",
+        action: "draft",
+        draftVerb: verb,
+        homeDir: optionalNonEmpty(values.flags.get("--home")),
+        dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")),
+        ...(channelRef ? { channelRef } : {}),
+        ...(threadId ? { threadId } : {}),
+        isPrivate: false,
+        ...(requestId ? { requestId } : {}),
+        ...(expectedRevision === undefined ? {} : { expectedRevision }),
+        json: values.booleans.has("--json"),
+    };
+}
 /** `send|edit|delete --request-id`, `edit|delete --expected-revision`, and the id `edit`/`delete`/`outcome` name (BLI-21314). */
 function parseMsgWriteSafety(action, rest, values) {
     const requestId = optionalNonEmpty(values.flags.get("--request-id"));
@@ -102,7 +159,7 @@ function parseMsgAction(positionals) {
     const first = positionals[0];
     const action = (first === undefined ? "channels" : first);
     if (!MSG_ACTIONS.has(action)) {
-        throw new Error(`Unknown msg command: ${first}. Try channels, read, unread, send, thread, create, dm, or show; to change a message: edit, delete or outcome.`);
+        throw new Error(`Unknown msg command: ${first}. Try channels, read, unread, send, thread, create, dm, or show; to change a message: edit, delete or outcome; for unsent text: draft.`);
     }
     return { action, rest: positionals.slice(first === undefined ? 0 : 1) };
 }

package/dist/commands/local-args-tower.js

@@ -54,4 +54,5 @@ export { parseCareersArgs } from './local-args-tower-careers.js';
 export { parseRenameArgs } from './local-args-tower-rename.js';
 export { parseGlossaryArgs } from "./glossary.js";
 export { parseSpendArgs } from "./spend.js";
+export { parsePushArgs } from "./push.js";
 export { parseCiArgs } from "./ci.js";

package/dist/commands/local-args.js

@@ -17,6 +17,7 @@
  */
 import { parseGlossaryArgs } from "./glossary.js";
 import { parseSpendArgs } from "./spend.js";
+import { parsePushArgs } from "./push.js";
 import { parseRootsArgs } from "./roots.js";
 import { SURFACE_ALIASES } from "./local-help.js";
 import { parseAgentRulesArgs, parseAnalyzeArgs, parseAutostartArgs, parseBackfillArgs, parseCleanArgs, parseDoctorArgs, parseInstallArgs, parseLoginArgs, parseMemoryArgs, parseLogoutArgs, parseOnboardArgs, parseReleaseArgs, parseServeArgs, parseSessionsArgs, parseSourcesArgs, parseStartArgs, parseStatusArgs, parseSyncArgs, parseUpdateArgs, } from "./local-args-collector.js";
@@ -82,6 +83,7 @@ const COMMAND_PARSERS = new Map([
     ["sources", (_command, rest) => parseSourcesArgs(rest)],
     ["glossary", (_command, rest) => parseGlossaryArgs(rest)],
     ["spend", (_command, rest) => parseSpendArgs(rest)],
+    ["push", (_command, rest) => parsePushArgs(rest)],
     ["docs", (_command, rest) => parseDocsArgs(rest)],
     ["msg", (_command, rest) => parseMsgArgs(rest)],
     ["issue", (_command, rest) => parseIssueArgs(rest)],

package/dist/commands/local-help-commands-tower.js

@@ -81,7 +81,7 @@ export const TOWER_COMMAND_HELP = [
     [
         "msg",
         [
-            "Usage: cockpit msg [channels|create <name>|dm <email>|read <channel>|unread <channel> --from <message-id>|send <channel>|edit <message-id>|delete <message-id>|outcome <request-uuid>|thread <id> --channel <channel>|show <message-id>] [flags]",
+            "Usage: cockpit msg [channels|create <name>|dm <email>|read <channel>|unread <channel> --from <message-id>|send <channel>|edit <message-id>|delete <message-id>|outcome <request-uuid>|draft [list|show|save|discard|restore|send] <channel>|thread <id> --channel <channel>|show <message-id>] [flags]",
             "",
             "Channels and messages, typed. <channel> is a channel id, or its name with or without a leading #.",
             "channels — every channel you are a member of (or, as a super_admin, every channel).",
@@ -90,7 +90,7 @@ export const TOWER_COMMAND_HELP = [
             "read <channel> [--limit <n>] [--thread <id>] [--mark-read] — the channel's most recent top-level messages, oldest first; --thread <id> reads one thread's replies instead. The first page also says where the messages come from (for an imported Slack channel: how long ago the archive was checked, or that it is unknown) and where YOUR read line stands. Reading never moves the read line; --mark-read moves it to the newest message shown, and says plainly if that failed.",
             "unread <channel> --from <message-id> — marks that message and everything after it unread, so the web sidebar badge and the NEW MESSAGES line start there. Opening or reading a channel never clears unseen history.",
             "send <channel> [--thread <id>] [--request-id <uuid>] — posts a message. The content is never accepted on the command line: pipe it in, e.g. `echo \"hello\" | cockpit msg send general`. Every send carries a request id (minted when you give none); retry a send whose answer was lost with the SAME --request-id and the same text and it posts once. The same id with different text is refused request_id_reused, not applied as an edit.",
-            "edit <message-id> [--expected-revision <n>] [--request-id <uuid>] — replaces your own message's text (piped in). With --expected-revision, an edit of a message that has moved on is refused revision_conflict and nothing is saved over it; the current revision is printed. A message you did not write, or one that was deleted, is refused by name. delete <message-id> [--expected-revision <n>] [--request-id <uuid>] — deletes by tombstone: the text is cleared and every surface reads \"This message was deleted\", but the row stays so its thread, replies and reply count survive. Search and unread counts ignore it. A repeat answers already_deleted. outcome <request-uuid> — your own write receipt for a send, edit or delete: committed, not_committed (with the reason) or unknown_check_again. Run it after a timeout before retrying.",
+            "edit <message-id> [--expected-revision <n>] [--request-id <uuid>] — replaces your own message's text (piped in). With --expected-revision, an edit of a message that has moved on is refused revision_conflict and nothing is saved over it; the current revision is printed. A message you did not write, or one that was deleted, is refused by name. delete <message-id> [--expected-revision <n>] [--request-id <uuid>] — deletes by tombstone: the text is cleared and every surface reads \"This message was deleted\", but the row stays so its thread, replies and reply count survive. Search and unread counts ignore it. A repeat answers already_deleted. outcome <request-uuid> — your own write receipt for a send, edit or delete: committed, not_committed (with the reason) or unknown_check_again. Run it after a timeout before retrying. draft [list|show|save|discard|restore|send] <channel> [--thread <id>] [--expected-revision <n>] [--request-id <uuid>] — the text you have not sent yet, one draft per channel and thread, the same drafts the browser autosaves. list shows all your unsent drafts (newest first, with coverage); show prints one; save takes the body on stdin (`echo \"half a thought\" | cockpit msg draft save general`) and with --expected-revision refuses draft_revision_conflict, naming the stored revision, instead of overwriting; discard keeps the text (state discarded) and restore brings it back; send posts the stored draft with a fresh request id (--request-id to retry the same send) and its revision, prints the receipt, and marks the draft sent only if it did not change meanwhile. Only you can read or change your drafts.",
             "thread <id> --channel <channel> [--before <cursor>] [--limit <n>] — one thread's replies by the parent message's id.",
             "show <message-id> — exact message, thread root and bounded neighbors. read/thread --before takes the preceding nextCursor; repeat until hasMore is false.",
             "--json writes one machine-readable object to stdout; every reason and receipt line stays on stderr.",

package/dist/commands/local-help-commands.js

@@ -23,6 +23,7 @@ import { TOWER_OPS_COMMAND_HELP } from "./local-help-commands-tower-ops.js";
 /** One manual per collector command; the Tower nouns are spread in from their own file. */
 const COMMAND_HELP = new Map([
     ["glossary", ["Usage: cockpit glossary list|add <wrong> --to <name>|remove <wrong> [--json]", "Quote phrases. Removing a form prevents future corrections of it."]],
+    ["push", ["Usage: cockpit push status | test [--dashboard-url <url>] [--json]", "Phone notifications. status lists your saved devices and whether the server has its push keys; test sends a test push to every saved device. Turn a phone on from Settings on the phone."]],
     ["spend", ["Usage: cockpit spend memory [--days 1|7|30] [--dashboard-url <url>] [--json]", "Spend by memory operation (write, recall, dream, update_forget, backfill, label, exam, predictor, people, who, intentions, salience, chat, other), ranked top first with list and real dollars, share, trend against the previous window, and how much of the real OpenAI bill the ledger explains. What it does not explain is shown as untagged. A super_admin reads it."]],
     ["roots", ["Usage: cockpit roots add <dir> [--allow-home-root] [--json]", "Approves a work directory, saves an approval receipt, and adds it to collection. Run cockpit doctor afterward."]],
     // BLI-3709: the Tower nouns live next door, split along the same seam the

package/dist/commands/local-help.js

@@ -72,6 +72,7 @@ export const rootCommandNames = new Set([
     "sources",
     "glossary",
     "spend",
+    "push",
     "docs",
     "msg",
     "issue",
@@ -153,6 +154,7 @@ const COMMAND_SUMMARY_LINES = [
     "  cockpit careers [list|show <id>|rescreen <id>|send-takehome <id>|decide <id> --decision <passed_on|archived|reopen>|followup <id> [--record-sent-at <iso>]|interview <id> <--at <iso>|--clear>|grade <id> [--now]|resume <id> [--out <path>]|takehome show <role>|takehome set <role> --body-file <path>|settings show|settings set --enabled <true|false> --followup-enabled <true|false> --followup-after-days <n> --takehome-window-hours <n>] [--role <slug>] [--min-score <n>] [--since <date>] [--stage <s>] [--force] [--json]",
     "  cockpit glossary list|add <wrong> --to <name>|remove <wrong> [--dashboard-url <url>] [--json]",
     "  cockpit spend memory [--days 1|7|30] [--dashboard-url <url>] [--json]",
+    "  cockpit push status|test [--dashboard-url <url>] [--json]",
     "  cockpit rename [list|resolve <id> --scope <page|everywhere|undo>] [--dashboard-url <url>] [--json]",
     "  cockpit logs <collector|dashboard|railway|railway:<service>|-> [--since 15m|1h|2d|<iso>] [--raw <template-id> [--limit <n>]] [--all-levels] [--table <file>] [--json]",
     "  cockpit intentions [list [--status open|overdue|done|dropped|all] [--project <name>] [--limit <n>]|show <id>|done <id> --evidence <text>|drop <id> --evidence <text>|reopen <id>] [--dashboard-url <url>] [--json]",

package/dist/commands/local.js

@@ -1,6 +1,7 @@
 import { runOpsCommand } from "./local-run-ops.js";
 import { runGlossary } from "./glossary.js";
 import { runSpend } from "./spend.js";
+import { runPush } from "./push.js";
 import { defaultIo, writeLine } from "./cli-io.js";
 import { isLocalHelpRequest, localCommandHelp } from "./local-help.js";
 import { beginStage, endStage } from "../crash-guard.js";
@@ -196,6 +197,7 @@ async function runTowerCommand(command, io) {
         case "notes": return await runNotes(command, io);
         case "glossary": return await runGlossary(command, io);
         case "spend": return await runSpend(command, io);
+        case "push": return await runPush(command, io);
         case "docs": return await runDocs(command, io);
         case "msg": return await runMsg(command, io);
         case "issue": return await runIssue(command, io);

package/dist/commands/msg-draft.js

@@ -0,0 +1,193 @@
+/**
+ * `cockpit msg draft` (BLI-21414): the text you have not sent yet, per channel and thread, the same
+ * drafts the browser autosaves. `list`, `show`, `save` (body piped in), `discard`, `restore` and
+ * `send` (posts the stored draft with a fresh request id, then prints the receipt). Same doors the
+ * browser calls: `/api/msg/drafts`, `/api/msg/drafts/restore` and the channel post door.
+ *
+ * The channel arrives already resolved to an id by `msg.ts`. Draft text is never logged; stderr lines
+ * carry ids, counts and reason labels.
+ */
+import { randomUUID } from "node:crypto";
+import { askAgentDoor, emitAgentDoor, failAgentDoor } from "./agent-door.js";
+import { writeLine } from "./cli-io.js";
+import { readContent, refuseMsgWrite } from "./msg-write.js";
+const TAG = "[msg draft cli]";
+const DEADLINE_MS = 30_000;
+function placeQuery(channelId, command) {
+    const query = new URLSearchParams({ channel_id: channelId });
+    if (command.threadId)
+        query.set("thread_parent_id", command.threadId);
+    return query.toString();
+}
+/** A refusal keeps the door's reason. A conflict names the stored revision; the stored text goes to --json only, never to a log line. */
+function refuseDraft(door, answer) {
+    const stored = answer.body?.draft ?? null;
+    writeLine(door.io.stderr, `${TAG} refused ${JSON.stringify({ reason: answer.reason, stored_revision: stored?.revision ?? null })}`);
+    if (door.json) {
+        writeLine(door.io.stdout, JSON.stringify({ ok: false, error: answer.reason, detail: answer.detail, draft: stored }));
+    }
+    else {
+        writeLine(door.io.stderr, answer.detail);
+        if (answer.reason === "draft_revision_conflict" && stored) {
+            writeLine(door.io.stderr, `The stored draft is at revision ${stored.revision}. Read it with \`cockpit msg draft show\`, then save again with --expected-revision ${stored.revision}.`);
+        }
+    }
+    return 1;
+}
+export async function runMsgDraft(command, door, channelId) {
+    switch (command.draftVerb ?? "list") {
+        case "list":
+            return listDrafts(door);
+        case "show":
+            return showDraft(command, door, channelId ?? "");
+        case "save":
+            return saveDraft(command, door, channelId ?? "");
+        case "discard":
+            return discardDraft(command, door, channelId ?? "");
+        case "restore":
+            return restoreDraft(command, door, channelId ?? "");
+        case "send":
+            return sendDraft(command, door, channelId ?? "");
+    }
+}
+async function listDrafts(door) {
+    const answer = await askAgentDoor(door, { path: "/api/msg/drafts", method: "GET", label: "msg draft list", timeoutMs: DEADLINE_MS });
+    if (!answer.ok)
+        return refuseDraft(door, answer);
+    const body = answer.body;
+    const drafts = body.drafts ?? [];
+    writeLine(door.io.stderr, `${TAG} listed ${JSON.stringify({ returned: drafts.length, coverage: body.coverage ?? "unknown" })}`);
+    if (door.json)
+        return emitAgentDoor(door, { ok: true, drafts, coverage: body.coverage, limit: body.limit, returned: body.returned ?? drafts.length });
+    if (drafts.length === 0) {
+        writeLine(door.io.stdout, "No unsent drafts.");
+        return 0;
+    }
+    for (const draft of drafts) {
+        writeLine(door.io.stdout, `${draft.channel_id}${draft.thread_parent_id ? ` thread ${draft.thread_parent_id}` : ""}  revision ${draft.revision}  ${draft.content.length} chars  ${draft.updated_at}`);
+    }
+    if (body.coverage === "capped")
+        writeLine(door.io.stdout, `Showing the newest ${body.limit ?? drafts.length}; there are more.`);
+    return 0;
+}
+async function showDraft(command, door, channelId) {
+    const answer = await askAgentDoor(door, { path: `/api/msg/drafts?${placeQuery(channelId, command)}`, method: "GET", label: "msg draft show", timeoutMs: DEADLINE_MS });
+    if (!answer.ok)
+        return refuseDraft(door, answer);
+    const draft = answer.body.draft ?? null;
+    writeLine(door.io.stderr, `${TAG} shown ${JSON.stringify({ channel_id: channelId, found: draft !== null, state: draft?.state ?? "none", revision: draft?.revision ?? null })}`);
+    if (door.json)
+        return emitAgentDoor(door, { ok: true, draft });
+    if (!draft) {
+        writeLine(door.io.stdout, "No draft here.");
+        return 0;
+    }
+    writeLine(door.io.stderr, `revision ${draft.revision}, ${draft.state}`);
+    writeLine(door.io.stdout, draft.content);
+    return 0;
+}
+async function saveDraft(command, door, channelId) {
+    const content = await readContent(door.io);
+    if (!content.ok)
+        return failAgentDoor(door, TAG, content.reason, content.detail);
+    if (content.text === "") {
+        return failAgentDoor(door, TAG, "invalid_body", "There was nothing to save. Use `cockpit msg draft discard` to drop a draft. Nothing was changed.");
+    }
+    const answer = await askAgentDoor(door, {
+        path: "/api/msg/drafts",
+        method: "PUT",
+        label: "msg draft save",
+        timeoutMs: DEADLINE_MS,
+        body: {
+            channel_id: channelId,
+            thread_parent_id: command.threadId ?? null,
+            content: content.text,
+            ...(command.expectedRevision === undefined ? {} : { expected_revision: command.expectedRevision }),
+        },
+    });
+    if (!answer.ok)
+        return refuseDraft(door, answer);
+    const result = answer.body;
+    writeLine(door.io.stderr, `${TAG} saved ${JSON.stringify({ channel_id: channelId, outcome: result.outcome ?? null, revision: result.draft?.revision ?? null, chars: content.text.length })}`);
+    if (door.json)
+        return emitAgentDoor(door, { ok: true, ...result });
+    writeLine(door.io.stdout, `Saved draft, revision ${result.draft?.revision ?? "?"}.`);
+    return 0;
+}
+async function discardDraft(command, door, channelId) {
+    const query = placeQuery(channelId, command) + (command.expectedRevision === undefined ? "" : `&expected_revision=${command.expectedRevision}`);
+    const answer = await askAgentDoor(door, { path: `/api/msg/drafts?${query}`, method: "DELETE", label: "msg draft discard", timeoutMs: DEADLINE_MS });
+    if (!answer.ok)
+        return refuseDraft(door, answer);
+    const result = answer.body;
+    writeLine(door.io.stderr, `${TAG} discarded ${JSON.stringify({ channel_id: channelId, changed: result.changed ?? null, revision: result.draft?.revision ?? null })}`);
+    if (door.json)
+        return emitAgentDoor(door, { ok: true, ...result });
+    writeLine(door.io.stdout, `Discarded the draft (revision ${result.draft?.revision ?? "?"}). Its text is kept; \`cockpit msg draft restore\` brings it back.`);
+    return 0;
+}
+async function restoreDraft(command, door, channelId) {
+    const answer = await askAgentDoor(door, {
+        path: "/api/msg/drafts/restore",
+        method: "POST",
+        label: "msg draft restore",
+        timeoutMs: DEADLINE_MS,
+        body: {
+            channel_id: channelId,
+            thread_parent_id: command.threadId ?? null,
+            ...(command.expectedRevision === undefined ? {} : { expected_revision: command.expectedRevision }),
+        },
+    });
+    if (!answer.ok)
+        return refuseDraft(door, answer);
+    const result = answer.body;
+    writeLine(door.io.stderr, `${TAG} restored ${JSON.stringify({ channel_id: channelId, changed: result.changed ?? null, revision: result.draft?.revision ?? null })}`);
+    if (door.json)
+        return emitAgentDoor(door, { ok: true, ...result });
+    writeLine(door.io.stdout, `Restored the draft, revision ${result.draft?.revision ?? "?"}.`);
+    return 0;
+}
+/** Posts the stored draft with a fresh request id and the draft's revision, then prints the receipt. */
+async function sendDraft(command, door, channelId) {
+    const read = await askAgentDoor(door, { path: `/api/msg/drafts?${placeQuery(channelId, command)}`, method: "GET", label: "msg draft send read", timeoutMs: DEADLINE_MS });
+    if (!read.ok)
+        return refuseDraft(door, read);
+    const draft = read.body.draft ?? null;
+    if (!draft || draft.state !== "active") {
+        return failAgentDoor(door, TAG, "draft_not_found", "There is no unsent draft here to send.", { state: draft?.state ?? "none" });
+    }
+    if (command.expectedRevision !== undefined && command.expectedRevision !== draft.revision) {
+        return refuseDraft(door, {
+            reason: "draft_revision_conflict",
+            detail: "This draft changed since you read it. Nothing was sent.",
+            body: { draft },
+        });
+    }
+    const requestId = command.requestId ?? randomUUID();
+    const answer = await askAgentDoor(door, {
+        path: `/api/msg/channels/${encodeURIComponent(channelId)}/messages`,
+        method: "POST",
+        label: "msg draft send",
+        timeoutMs: DEADLINE_MS,
+        body: {
+            content: draft.content,
+            request_id: requestId,
+            draft_revision: draft.revision,
+            ...(command.threadId ? { thread_parent_id: command.threadId } : {}),
+        },
+    });
+    if (!answer.ok)
+        return refuseMsgWrite(door, answer, requestId, "send");
+    const { message = null, mutation = null, draft: settled = null } = answer.body;
+    writeLine(door.io.stderr, `${TAG} sent ${JSON.stringify({
+        channel_id: channelId, message_id: message?.id ?? null, request_id: requestId, draft_revision: draft.revision,
+        draft_marked: settled?.marked ?? null, draft_reason: settled?.reason ?? null,
+    })}`);
+    if (door.json)
+        return emitAgentDoor(door, { ok: true, message, mutation, draft: settled });
+    writeLine(door.io.stdout, `Sent the draft as ${message?.id ?? "?"} (request ${requestId}, ${String(mutation?.["outcome"] ?? "committed")}).`);
+    if (settled && settled.marked === false) {
+        writeLine(door.io.stdout, `The draft was not marked sent (${settled.reason ?? "unknown"}); it is still saved.`);
+    }
+    return 0;
+}

package/dist/commands/msg.js

@@ -20,6 +20,7 @@ import { askAgentDoor, emitAgentDoor, failAgentDoor, openAgentDoor, } from "./ag
 import { writeLine } from "./cli-io.js";
 import { cacheAgeLabel, cacheCoverage, readThroughCache } from "./read-cache.js";
 import { markReadThrough } from "./msg-read-line.js";
+import { runMsgDraft } from "./msg-draft.js";
 import { deleteMessage, editMessage, messageOutcome, messageText, readContent, refuseMsgWrite } from "./msg-write.js";
 const TAG = "[msg cli]";
 const READ_DEADLINE_MS = 30_000;
@@ -43,6 +44,8 @@ export async function runMsg(command, io) {
             return deleteMessage(command, door);
         case "outcome":
             return messageOutcome(command, door);
+        case "draft":
+            return draftVerb(command, door);
         case "thread":
             return readThread(command, door);
         case "create":
@@ -51,6 +54,18 @@ export async function runMsg(command, io) {
             return openDm(command, door);
     }
 }
+/** `msg draft`: `list` needs no channel; every other verb resolves the channel the same way read and send do. */
+async function draftVerb(command, door) {
+    if ((command.draftVerb ?? "list") === "list")
+        return runMsgDraft(command, door, null);
+    const ref = command.channelRef ?? "";
+    const resolved = await resolveChannelId(door, ref);
+    if (resolved.status === "list_failed")
+        return failAgentDoor(door, TAG, resolved.reason, resolved.detail);
+    if (resolved.status === "not_found")
+        return channelNotFound(door, ref);
+    return runMsgDraft(command, door, resolved.id);
+}
 async function fetchChannels(door) {
     const answer = await readThroughCache({
         io: door.io,

package/dist/commands/public-root.js

@@ -21,7 +21,7 @@ export async function runCockpitCli(argv, io) {
   }
 
   if (command === "--version" || command === "-V" || command === "version") {
-    writeLine(io?.stdout ?? process.stdout, "0.2.241");
+    writeLine(io?.stdout ?? process.stdout, "0.2.242");
     return 0;
   }
 

package/dist/commands/push.js

@@ -0,0 +1,50 @@
+/**
+ * `cockpit push status` and `cockpit push test`: phone notifications from the terminal (BLI-21497).
+ *
+ * `status` reads `GET /api/push/subscriptions` (the caller's own saved devices, and whether the server has its VAPID
+ * keys); `test` posts `POST /api/push/test` (a test push to every saved device). The same doors the Settings page and the
+ * `push_status` and `push_test` MCP tools use. Turning a phone on is the browser's own permission prompt, so there is no
+ * terminal verb for it. `--json` prints the door's body untouched.
+ */
+import { askAgentDoor, emitAgentDoor, failAgentDoor, openAgentDoor } from "./agent-door.js";
+import { writeLine } from "./cli-io.js";
+import { optionalNonEmpty, optionalUrl, parseNamedArgs } from "./local-arg-values.js";
+const USAGE = "Usage: cockpit push status | test [--dashboard-url <url>] [--json]";
+export function parsePushArgs(args) {
+    const values = parseNamedArgs(args, { allowedFlags: ["--json", "--home", "--dashboard-url"], valueFlags: ["--home", "--dashboard-url"] });
+    const [action, ...rest] = values.positionals;
+    if ((action !== "status" && action !== "test") || rest.length > 0)
+        throw new Error(USAGE);
+    return { kind: "push", action, json: values.booleans.has("--json"), homeDir: optionalNonEmpty(values.flags.get("--home")), dashboardUrl: optionalUrl(values.flags.get("--dashboard-url")) };
+}
+export function renderPushStatus(body) {
+    const devices = body.devices ?? [];
+    const lines = [`Server push keys: ${body.configured ? "set" : "not set (nothing can be sent yet)"}.`, `Saved devices: ${devices.length}.`];
+    for (const device of devices)
+        lines.push(`  ${device.created_at.slice(0, 16).replace("T", " ")}Z  ${device.user_agent ?? "unknown browser"}`);
+    if (devices.length === 0)
+        lines.push("Turn notifications on from Settings, on the phone (add TOWER to the Home Screen first on iPhone).");
+    return lines;
+}
+export function renderPushTest(body) {
+    if (body.skipped === "push_not_configured")
+        return ["Nothing sent: the server has no VAPID keys yet."];
+    if (body.skipped === "no_devices")
+        return ["Nothing sent: no device is saved. Turn notifications on from Settings on the phone."];
+    if (body.skipped)
+        return [`Nothing sent: ${body.skipped}.`];
+    const reasons = Object.entries(body.reasons ?? {}).map(([reason, count]) => `${reason} x${count}`).join(", ");
+    return [`Test push: ${body.accepted ?? 0} of ${body.devices ?? 0} devices accepted, ${body.failed ?? 0} failed${reasons ? ` (${reasons})` : ""}.`];
+}
+export async function runPush(command, io) {
+    const door = await openAgentDoor("push", command, io);
+    const status = command.action === "status";
+    const answer = await askAgentDoor(door, { path: status ? "/api/push/subscriptions" : "/api/push/test", method: status ? "GET" : "POST", label: `push ${command.action}`, timeoutMs: 60_000, ...(status ? {} : { body: {} }) });
+    if (!answer.ok)
+        return failAgentDoor(door, "[push cli]", answer.reason, answer.detail);
+    if (door.json)
+        return emitAgentDoor(door, answer.body);
+    for (const line of status ? renderPushStatus(answer.body) : renderPushTest(answer.body))
+        writeLine(door.io.stdout, line);
+    return 0;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bli-cockpit/cli",
-  "version": "0.2.241",
+  "version": "0.2.242",
   "private": false,
   "type": "module",
   "bin": {
@@ -28,7 +28,7 @@
   },
   "dependencies": {
     "@bli-cockpit/memory-mcp": "0.1.70",
-    "@bli-cockpit/mcp": "0.1.146",
+    "@bli-cockpit/mcp": "0.1.147",
     "@bli-cockpit/telemetry-core": "0.1.77"
   },
   "repository": {