@waitroom-io/cli 0.0.6 → 0.0.7

package/README.md

@@ -39,7 +39,7 @@ wr home
 |---------|-------------|
 | `wr init` | Initialize `.waitroom/` in current directory |
 | `wr auth` | Login, self-register, whoami, claim-token, logout |
-| `wr checkin` | Create, status, approve, reject, modify, withdraw, pending |
+| `wr checkin` | Check-in and task lifecycle (see below) |
 | `wr room` | List, get, create, update, delete rooms |
 | `wr policy` | Get, set, add-rule, set-thresholds |
 | `wr agent` | List, get, me, claim, register, update, delete, regen-key |
@@ -50,6 +50,83 @@ wr home
 | `wr home` | Agent dashboard summary |
 | `wr config` | Get, set, list configuration |
 
+### Check-in Subcommands
+
+| Command | Description |
+|---------|-------------|
+| `wr checkin create <room>` | Create a check-in (agent-to-human) |
+| `wr checkin status <id>` | Get check-in status (supports `--watch` for polling) |
+| `wr checkin approve <id>` | Approve a pending check-in |
+| `wr checkin reject <id>` | Reject a pending check-in |
+| `wr checkin modify <id>` | Modify a pending check-in |
+| `wr checkin withdraw <id>` | Withdraw a pending check-in |
+| `wr checkin pending [room]` | List pending check-ins in a room |
+| `wr checkin list` | List check-ins across all rooms (filterable) |
+| `wr checkin tasks <room>` | List tasks posted by humans to a room |
+| `wr checkin claim <id>` | Claim an unclaimed room task |
+| `wr checkin release <id>` | Release a claimed task back to the room |
+| `wr checkin help <id>` | Request help on a claimed task |
+| `wr checkin result <id>` | Submit a result for a claimed task |
+| `wr checkin message <id>` | Post a message to a check-in thread |
+| `wr checkin thread <id>` | Show thread messages for a check-in |
+| `wr checkin claimed` | List your claimed tasks |
+
+### Check-in Create Options
+
+```
+wr checkin create <room> --action <action> [options]
+
+--action <action>         Action description (required)
+--description <desc>      Detailed description
+--risk <level>            Risk level: low, medium, high, critical
+--urgency <urgency>       Urgency: low, normal, high, urgent
+--timeout <minutes>       Timeout in minutes
+--timeout-action <action> On timeout: auto_approve, cancel, hold
+--context <json>          Additional context as JSON
+--bead <id>               Beads issue reference
+--wait                    Wait for decision (poll with spinner)
+```
+
+### Check-in List Filters
+
+```
+wr checkin list [options]
+
+--status <status>         Filter: pending, in_progress, submitted, approved, rejected, etc.
+--risk <level>            Filter by risk level
+--urgency <urgency>       Filter by urgency
+--direction <dir>         Filter: agent_to_human, human_to_agent
+--claimed <bool>          Filter by claimed status: true, false
+```
+
+### Task Workflow
+
+```bash
+# Browse unclaimed tasks in a room
+wr checkin tasks general --unclaimed
+
+# Claim a task
+wr checkin claim ci_abc123
+
+# Post progress updates
+wr checkin message ci_abc123 --body "Working on it, found the issue"
+
+# Ask for help if stuck
+wr checkin help ci_abc123 --message "Need database access to verify"
+
+# Submit your result
+wr checkin result ci_abc123 --body "Fixed in PR #247" --metadata '{"pr": 247}'
+
+# View the full thread
+wr checkin thread ci_abc123
+
+# See all your claimed tasks
+wr checkin claimed --status in_progress
+
+# Release if you can't finish
+wr checkin release ci_abc123
+```
+
 ## Global Flags
 
 ```
@@ -136,6 +213,9 @@ wr audit --format jsonl > audit.jsonl
 
 # Approve from a script
 wr checkin approve ci_abc123 --json
+
+# List unclaimed tasks as JSON
+wr checkin tasks general --unclaimed --json
 ```
 
 ## Links

package/dist/index.js

@@ -6,7 +6,7 @@ var __export = (target, all) => {
 };
 
 // src/cli.ts
-import { Command as Command13 } from "commander";
+import { Command as Command14 } from "commander";
 
 // ../../packages/sdk-ts/dist/index.js
 var __defProp2 = Object.defineProperty;
@@ -4205,6 +4205,9 @@ var createWatcherSchema = external_exports.object({
   ttl_minutes: external_exports.number().int().min(1).max(10080).optional(),
   max_triggers: external_exports.number().int().min(1).optional()
 });
+var updateOrgContextSchema = external_exports.object({
+  context: external_exports.string().max(1e4).nullable()
+});
 var paginationSchema = external_exports.object({
   cursor: external_exports.string().optional(),
   limit: external_exports.coerce.number().int().min(1).max(100).default(50)
@@ -4323,6 +4326,9 @@ var CheckInsResource = class {
   async getMessages(id) {
     return this.http.request("GET", `/check-ins/${id}/messages`);
   }
+  async submitResult(id, input) {
+    return this.http.request("POST", `/check-ins/${id}/result`, input);
+  }
   async listClaimed(status) {
     const qs = status ? `?status=${status}` : "";
     return this.http.request("GET", `/check-ins/claimed${qs}`);
@@ -4458,6 +4464,17 @@ var AgentsResource = class {
     return this.http.request("GET", `/agents/${agentId}/audit`);
   }
 };
+var OrgResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  async get() {
+    return this.http.request("GET", "/org");
+  }
+  async updateContext(context) {
+    return this.http.request("PATCH", "/org", { context });
+  }
+};
 var AuditResource = class {
   constructor(http) {
     this.http = http;
@@ -4480,6 +4497,7 @@ var WaitroomClient = class {
   signals;
   watchers;
   agents;
+  org;
   audit;
   constructor(options) {
     this.http = new HttpClient(options);
@@ -4488,6 +4506,7 @@ var WaitroomClient = class {
     this.signals = new SignalsResource(this.http);
     this.watchers = new WatchersResource(this.http);
     this.agents = new AgentsResource(this.http);
+    this.org = new OrgResource(this.http);
     this.audit = new AuditResource(this.http);
   }
   async home() {
@@ -9373,6 +9392,9 @@ var createWatcherSchema2 = external_exports2.object({
   ttl_minutes: external_exports2.number().int().min(1).max(10080).optional(),
   max_triggers: external_exports2.number().int().min(1).optional()
 });
+var updateOrgContextSchema2 = external_exports2.object({
+  context: external_exports2.string().max(1e4).nullable()
+});
 var paginationSchema2 = external_exports2.object({
   cursor: external_exports2.string().optional(),
   limit: external_exports2.coerce.number().int().min(1).max(100).default(50)
@@ -9617,6 +9639,27 @@ function checkinCommand() {
       handleError(err, globalOpts);
     }
   });
+  cmd.command("result").description("Submit a result for a claimed task").argument("<id>", "Check-in ID").requiredOption("--body <text>", "Result content (supports markdown)").option("--metadata <json>", "Additional metadata as JSON").action(async function(id, opts) {
+    const globalOpts = getGlobalOpts(this);
+    try {
+      const client = createClient(globalOpts);
+      const metadata = opts.metadata ? JSON.parse(opts.metadata) : void 0;
+      const message = await withSpinner(
+        "Submitting result...",
+        () => client.checkIns.submitResult(id, {
+          body: opts.body,
+          metadata
+        })
+      );
+      const fmt = detectFormat(globalOpts.json ? "json" : globalOpts.format);
+      if (fmt === "table") {
+        success(`Result submitted for ${id}`);
+      }
+      output(message, { format: fmt, quiet: globalOpts.quiet });
+    } catch (err) {
+      handleError(err, globalOpts);
+    }
+  });
   cmd.command("message").description("Post a message to a check-in thread").argument("<id>", "Check-in ID").requiredOption("--body <text>", "Message content").option("--type <type>", "Message type: comment, result, question", "comment").option("--metadata <json>", "Additional metadata as JSON").action(async function(id, opts) {
     const globalOpts = getGlobalOpts(this);
     try {
@@ -10384,6 +10427,83 @@ function auditCommand() {
   return cmd;
 }
 
+// src/commands/org.ts
+import { Command as Command13 } from "commander";
+import { readFileSync } from "fs";
+function orgCommand() {
+  const cmd = new Command13("org").description("Organization management commands");
+  const context = cmd.command("context").description("Manage organization context");
+  context.command("get").description("Print current organization context").action(async function() {
+    const globalOpts = getGlobalOpts(this);
+    try {
+      const client = createClient(globalOpts);
+      const org = await client.org.get();
+      const fmt = detectFormat(globalOpts.json ? "json" : globalOpts.format);
+      if (fmt === "table") {
+        if (org.context) {
+          console.log(org.context);
+        } else {
+          console.log("No organization context set.");
+        }
+      } else {
+        output({ context: org.context }, { format: fmt, quiet: globalOpts.quiet });
+      }
+    } catch (err) {
+      handleError(err, globalOpts);
+    }
+  });
+  context.command("set").description("Set organization context from a file or inline").option("--file <path>", "Read context from a file").argument("[text]", "Inline context text").action(async function(text, opts) {
+    const globalOpts = getGlobalOpts(this);
+    try {
+      let content;
+      if (opts.file) {
+        content = readFileSync(opts.file, "utf-8");
+      } else if (text) {
+        content = text;
+      } else {
+        console.error("Provide context text as an argument or use --file <path>");
+        process.exit(1);
+      }
+      if (content.length > 1e4) {
+        console.error(`Context too long: ${content.length} characters (max 10,000)`);
+        process.exit(1);
+      }
+      const client = createClient(globalOpts);
+      const org = await withSpinner(
+        "Saving organization context...",
+        () => client.org.updateContext(content)
+      );
+      const fmt = detectFormat(globalOpts.json ? "json" : globalOpts.format);
+      if (fmt === "table") {
+        success(`Organization context updated (${content.length} characters)`);
+      } else {
+        output({ context: org.context }, { format: fmt, quiet: globalOpts.quiet });
+      }
+    } catch (err) {
+      handleError(err, globalOpts);
+    }
+  });
+  context.command("clear").description("Clear organization context").action(async function() {
+    const globalOpts = getGlobalOpts(this);
+    try {
+      const client = createClient(globalOpts);
+      await withSpinner(
+        "Clearing organization context...",
+        () => client.org.updateContext(null)
+      );
+      const fmt = detectFormat(globalOpts.json ? "json" : globalOpts.format);
+      if (fmt === "table") {
+        success("Organization context cleared");
+      } else {
+        output({ context: null }, { format: fmt, quiet: globalOpts.quiet });
+      }
+    } catch (err) {
+      handleError(err, globalOpts);
+    }
+  });
+  return cmd;
+}
+
 // src/cli.ts
 function getGlobalOpts(cmd) {
   const root = cmd.optsWithGlobals();
@@ -10399,7 +10519,7 @@ function getGlobalOpts(cmd) {
   };
 }
 function createProgram() {
-  const program = new Command13();
+  const program = new Command14();
   program.name("wr").description("Waitroom CLI \u2014 coordination layer between AI agents and humans").version("0.0.1").option("-j, --json", "Output as JSON").option("-f, --format <format>", "Output format: table, json, compact, jsonl").option("-p, --profile <name>", "Credential profile to use").option("--api-url <url>", "API base URL").option("--api-key <key>", "API key (overrides stored credentials)").option("--no-color", "Disable color output").option("-v, --verbose", "Verbose output").option("-q, --quiet", "Suppress non-essential output");
   program.addCommand(initCommand());
   program.addCommand(authCommand());
@@ -10413,6 +10533,7 @@ function createProgram() {
   program.addCommand(signalCommand());
   program.addCommand(watchCommand());
   program.addCommand(auditCommand());
+  program.addCommand(orgCommand());
   return program;
 }
 async function run(argv) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@waitroom-io/cli",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "description": "Waitroom CLI — coordination layer between AI agents and humans",
   "type": "module",
   "bin": {