@sixb/cli-core 0.1.7 → 0.1.9

package/src/commands/workflows.ts

@@ -1,6 +1,7 @@
+import { randomUUID } from "node:crypto"
 import type { ApiClient } from "../api-client"
 import { isHelp, parseCommandArgs, requestsHelp } from "../arguments"
-import { fail, writeJson, writeText } from "../output"
+import { fail, writeJson, writeRequestResult, writeText } from "../output"
 import { GROUP_HELP } from "./metadata"
 import { readJson } from "./shared"
 
@@ -21,13 +22,18 @@ export async function workflows(api: ApiClient, args: readonly string[]): Promis
     const {
       positionals: [workflowId],
       options,
-    } = parseCommandArgs(rest, { "--file": "string" }, "workflows start", 1)
+    } = parseCommandArgs(rest, { "--file": "string", "--run-id": "string" }, "workflows start", 1)
     const input: unknown = options["--file"] ? await readJson(options["--file"]) : {}
     if (Array.isArray(input) || typeof input !== "object" || input === null) {
       fail("Workflow input must be a JSON object.")
     }
-    return writeJson(
-      await api.post(`/api/workflows/${encodeURIComponent(workflowId ?? "")}/runs`, { input })
+    // Every start names its run, so a repeated request returns the same run instead of another.
+    const runId = options["--run-id"] ?? `run_${randomUUID()}`
+    return writeRequestResult(
+      await api.post(`/api/workflows/${encodeURIComponent(workflowId ?? "")}/runs`, {
+        input,
+        runId,
+      })
     )
   }
   fail(`Unknown workflows command '${sub}'.`)

package/src/output.ts

@@ -2,6 +2,8 @@
 export const INSTANCE_CLI_VERSION = "1"
 export const EXIT_USAGE = 2
 export const EXIT_API = 3
+/** The request waits for its user's approval: it did not run. */
+export const EXIT_AWAITING_APPROVAL = 4
 
 export interface CliErrorBody {
   readonly code: string
@@ -31,11 +33,30 @@ export function writeJson(value: unknown): void {
   process.stdout.write(`${JSON.stringify(value)}\n`)
 }
 
+/** Ends a command that already wrote its output, with an exit code that is not a success. */
+export class CliExit extends Error {
+  constructor(readonly exitCode: number) {
+    super(`The Sixb CLI exited with code ${exitCode}.`)
+    this.name = "CliExit"
+  }
+}
+
+/**
+ * Print what a request that changes state answered. A request held for the user's approval prints
+ * as the API answered it, and exits with {@link EXIT_AWAITING_APPROVAL}: `a && b` does not run `b`.
+ */
+export function writeRequestResult(value: unknown): void {
+  writeJson(value)
+  const status = typeof value === "object" && value !== null ? Reflect.get(value, "status") : null
+  if (status === "awaiting_approval") throw new CliExit(EXIT_AWAITING_APPROVAL)
+}
+
 export function writeText(value: string): void {
   process.stdout.write(value.endsWith("\n") ? value : `${value}\n`)
 }
 
 export function reportError(error: unknown): number {
+  if (error instanceof CliExit) return error.exitCode
   const cliError =
     error instanceof CliError
       ? error

package/src/policies.ts

@@ -6,6 +6,8 @@ export const CLI_LIMITS = {
   vectorSearchText: { maximum: 8_000 },
   telemetryHistory: { default: 100, maximum: 1_000 },
   linkPage: { default: 100, maximum: 1_000 },
+  /** The server lists at most 200 members per page. */
+  users: { default: 20, maximum: 200 },
   inspect: {
     depth: { default: 2, maximum: 3 },
     objects: { default: 20, maximum: 100 },