@oxygen-agent/cli 1.836.2 → 1.837.5

package/README.md

@@ -34,4 +34,4 @@ oxygen update
 
 For product documentation, visit https://oxygen-agent.com/docs. For support, visit https://oxygen-agent.com.
 
-Version: 1.836.2
+Version: 1.837.5

package/dist/command-manifest.js

@@ -39,6 +39,9 @@ const MUTATING_VERBS = new Set([
     "bind", "buy", "call", "cancel", "chat-action", "claim", "clear",
     "comment", "configure", "connect", "create", "decide", "delete", "delist", "disable",
     "disconnect", "dispatch", "done", "draft", "duplicate", "edit", "emit", "enable", "enroll",
+    // Exact leaf, not a `field` prefix: `support admin field-set` writes a Plain
+    // Thread field, while a future `field-get` would be a read.
+    "field-set",
     "file", "forward", "grant", "harvest", "history", "import", "insert", "interrupt", "invite",
     "label-add", "label-remove", "launch", "log", "login", "logout", "mark-all-read", "mark-read", "materialize", "merge",
     "migrate",
@@ -47,8 +50,12 @@ const MUTATING_VERBS = new Set([
     "register", "reject", "relink", "remove", "rename", "reorder", "reply", "request",
     "replay", "rerun", "rescan", "resend", "reset", "resolve", "restore", "resume",
     "retry", "retype", "revoke", "rotate", "run", "save", "schedule",
-    "seed", "select", "send", "set", "setup", "share", "solve",
-    "start", "stop", "subscribe", "sync", "synthesize", "tag", "unarchive", "unpublish", "unshare",
+    "seed", "select", "send", "set", "setup", "share", "snooze", "solve",
+    "start", "stop", "subscribe", "sync", "synthesize", "tag",
+    // `support admin todo` moves a Plain Thread back into the queue. The noun
+    // reads like a state, but the command is the transition into it.
+    "todo",
+    "unarchive", "unpublish", "unshare",
     "unbind", "unsubscribe", "update", "upload", "upsert", "use", "warm-send", "warmup",
     "withdraw", "write",
 ]);
@@ -80,6 +87,8 @@ const PREVIEW_BY_DEFAULT_COMMANDS = new Set([
     "mailboxes delete",
     "support admin done",
     "support admin reply",
+    // A bare call reads the Plain workspace and prints the plan; --apply writes.
+    "support admin setup",
     "workflows webhooks rotate",
 ]);
 export function buildCommandManifest(program, binaryName) {

package/dist/index.js

@@ -2931,11 +2931,22 @@ export function createProgram() {
         }));
     }))
         .addCommand(new Command("start")
-        .description("Return a live Plain Thread to Todo / In progress when OXYGEN work remains after a reply, preserving its assignee (staff only).")
+        .description("Set a live Plain Thread to Plain TODO with the In progress detail when OXYGEN work remains after a reply, preserving its assignee (staff only).")
         .argument("<ticketId>", "Plain Thread ID (th_...).")
         .requiredOption("--agent", "Required safety declaration: reconcile this Thread's status as the Oxygen Support machine user.")
-        .requiredOption("--confirm-message <messageId>", "Apply only while this is still the exact latest customer-visible conversation-head message ID.")
+        .requiredOption("--confirm-message <messageId>", "Apply only while this is still the exact latest customer-visible conversation-head message ID. From support admin get --json, use the id of the data.messages[] entry with the greatest created_at.")
         .option("--json", "Print a JSON envelope.")
+        .addHelpText("after", `
+Safety: 0 credits, but this is a real Plain queue write. It preserves the current assignee and changes only the lifecycle to plain_status TODO with plain_status_detail ThreadStatusDetailInProgress (projected as ticket.status triaging).
+
+Safe sequence:
+  oxygen support admin get <thread-id> --json
+  # Select the data.messages[] entry with the greatest created_at and copy its id.
+  oxygen support admin start <thread-id> --agent --confirm-message <latest-message-id> --json
+  oxygen support admin get <thread-id> --json
+
+The final readback must show ticket.status triaging, plain_status TODO, the In progress detail, the same conversation head, and an unchanged assignee.
+`)
         .action(async (ticketId, options) => {
         await handleAsyncAction("support admin start", options, () => requestOxygen(`/api/cli/admin/support/tickets/${encodeURIComponent(ticketId)}/update`, {
             method: "POST",
@@ -2955,6 +2966,50 @@ export function createProgram() {
         await handleSupportAdminUpdateRequest("priority", ticketId, options, {
             priority: readOption(options.priority),
         });
+    }))
+        .addCommand(new Command("snooze")
+        .description("Park a live Thread until a named time, so work blocked on a release, a provider, or a scheduled retry stops reading as unanswered (staff only).")
+        .argument("<ticketId>", "Plain Thread ID (th_...).")
+        .option("--days <n>", "Snooze for this many days.")
+        .option("--hours <n>", "Snooze for this many hours. Combined with --days when both are given.")
+        .requiredOption("--confirm-message <messageId>", "Confirm the exact latest customer-visible message ID. A Thread whose customer just wrote must be answered, not snoozed past.")
+        .option("--json", "Print a JSON envelope.")
+        .action(async (ticketId, options) => {
+        await handleSupportAdminUpdateRequest("snooze", ticketId, options, {
+            duration_seconds: readSupportSnoozeSeconds(options),
+            confirm_message_id: readOption(options.confirmMessage),
+        });
+    }))
+        .addCommand(new Command("todo")
+        .description("Return a snoozed Thread to the queue when its blocker clears (staff only). Never reopens a Done Thread: Plain does that on real customer activity.")
+        .argument("<ticketId>", "Plain Thread ID (th_...).")
+        .option("--json", "Print a JSON envelope.")
+        .action(async (ticketId, options) => {
+        await handleSupportAdminUpdateRequest("todo", ticketId, options, {});
+    }))
+        .addCommand(new Command("assign")
+        .description("Hand a live Thread to a named human, for escalation past an agent's authority or judgment boundary (staff only).")
+        .argument("<ticketId>", "Plain Thread ID (th_...).")
+        .requiredOption("--user <email>", "The staff email to assign the Thread to.")
+        .option("--allow-takeover", "Required to move a Thread that already has an owner. Without it, an owned Thread is refused rather than silently reassigned.")
+        .option("--json", "Print a JSON envelope.")
+        .action(async (ticketId, options) => {
+        await handleSupportAdminUpdateRequest("assign", ticketId, options, {
+            assignee_email: readOption(options.user),
+            allow_takeover: options.allowTakeover === true,
+        });
+    }))
+        .addCommand(new Command("field-set")
+        .description("Record OXYGEN workflow state on a live Thread as structured, filterable Plain data — which version and commit carry a fix, and the PR that shipped it (staff only).")
+        .argument("<ticketId>", "Plain Thread ID (th_...).")
+        .requiredOption("--field <key>", "oxygen_fix_version | oxygen_fix_sha | oxygen_fix_pr. Customer-intake fields are read-only evidence and cannot be written here.")
+        .requiredOption("--value <value>", "The value to record.")
+        .option("--json", "Print a JSON envelope.")
+        .action(async (ticketId, options) => {
+        await handleSupportAdminUpdateRequest("field_set", ticketId, options, {
+            field_key: readOption(options.field),
+            field_value: readOption(options.value),
+        });
     }))
         .addCommand(new Command("label-add")
         .description("Add an active Plain label by external ID (staff only).")
@@ -3074,6 +3129,21 @@ export function createProgram() {
             },
         }));
     }), { hidden: true })
+        .addCommand(new Command("setup")
+        .description("Reconcile the shared Plain workspace against the taxonomy OXYGEN declares in code: request-type labels and intake fields, plus the workflow-state labels and release fields the support loop writes. Previews by default and never sends anything to a customer (staff only).")
+        .option("--apply", "Apply the previewed plan. Requires --confirm-plan with the exact plan_hash you just read.")
+        .option("--confirm-plan <hash>", "The plan_hash from the immediately preceding preview. A workspace that drifted in between fails closed.")
+        .option("--json", "Print a JSON envelope.")
+        .action(async (options) => {
+        if (options.apply !== true) {
+            await handleAsyncAction("support admin setup", options, () => requestOxygen("/api/cli/admin/support/setup"));
+            return;
+        }
+        await handleAsyncAction("support admin setup", options, () => requestOxygen("/api/cli/admin/support/setup", {
+            method: "POST",
+            body: { confirm_plan_hash: readOption(options.confirmPlan) },
+        }));
+    }))
         .addCommand(new Command("events")
         .description("Read-only poll of legacy OXYGEN archive events for cutover compatibility; never use it as the live queue (staff only).")
         .option("--after <cursor>", "If has_more=true, pass next_cursor to continue that scan. If false, persist the non-null watermark_cursor for later polls. A watermark poll intentionally replays the settled 24h window, not only unseen events; dedupe every page by (ticket_ref, version).")
@@ -21887,6 +21957,28 @@ async function handleSupportAdminUpdateRequest(action, ticketId, options, fields
         body: { action, ...fields },
     }));
 }
+/**
+ * Plain snoozes by duration, but humans and agents think in days and hours.
+ * Requiring at least one keeps `snooze` from silently meaning "five minutes".
+ */
+function readSupportSnoozeSeconds(options) {
+    const days = readSupportSnoozeUnit(options.days, "--days");
+    const hours = readSupportSnoozeUnit(options.hours, "--hours");
+    const seconds = days * 24 * 60 * 60 + hours * 60 * 60;
+    if (seconds <= 0) {
+        throw new OxygenError("invalid_request", "Pass --days and/or --hours to say how long the Thread should stay parked.", { exitCode: 1 });
+    }
+    return seconds;
+}
+function readSupportSnoozeUnit(raw, flag) {
+    if (raw === undefined)
+        return 0;
+    const value = Number(raw.trim());
+    if (!Number.isInteger(value) || value < 0) {
+        throw new OxygenError("invalid_request", `${flag} must be a whole, non-negative number.`, { exitCode: 1 });
+    }
+    return value;
+}
 async function handleSupportAdminWorkflowAction(ticketId, options) {
     try {
         const body = buildSupportAdminWorkflowBody(options);

package/node_modules/@oxygen/shared/dist/version.d.ts

@@ -1,4 +1,4 @@
-export declare const OXYGEN_VERSION = "1.836.2";
+export declare const OXYGEN_VERSION = "1.837.5";
 export declare const OXYGEN_MINIMUM_CLI_VERSION = "1.181.0";
 export declare const MANAGED_INBOX_MINIMUM_CLI_VERSION = "1.326.2";
 export declare const SUPPORT_AGENT_REPLY_MINIMUM_CLI_VERSION = "1.747.0";

package/node_modules/@oxygen/shared/dist/version.js

@@ -1,4 +1,4 @@
-export const OXYGEN_VERSION = "1.836.2";
+export const OXYGEN_VERSION = "1.837.5";
 // The GLOBAL CLI compatibility floor: the oldest CLI allowed to call any
 // operational route. Raising it hard-rejects every older CLI from the entire
 // product, so it obeys one law, enforced by scripts/ci/cli-min-version-gate.mjs:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxygen-agent/cli",
-  "version": "1.836.2",
+  "version": "1.837.5",
   "private": false,
   "license": "UNLICENSED",
   "type": "module",