@typeship-ax/cli 0.10.0 → 0.20.0

package/dist/cli-agent.d.ts

@@ -94,8 +94,8 @@ export declare function upsertAgentBlock(file: string, marker: string, body: str
     file: string;
     updated: boolean;
 };
-/** AGENTS.md by default; CLAUDE.md when only it exists, or when running under Claude Code and AGENTS.md is absent. */
-export declare function agentInstructionsFile(cwd: string, harness: string | null): string;
+/** AGENTS.md for every harness; preserve an existing CLAUDE.md when AGENTS.md is absent. */
+export declare function agentInstructionsFile(cwd: string): string;
 export interface CommandFlagSummary {
     flag: string;
     /** string | number | boolean | array | object | json | file */
@@ -164,8 +164,8 @@ export declare function installSkills(repo: string | null, options?: {
 }): SkillsInstallResult;
 /**
  * A response that carries files: an array property whose items have string
- * `path` and `content`. typeship's own generate call is one; any API that
- * returns generated or exported files is another. `--out <dir>` writes them.
+ * `path` and `content`, as an API that returns generated or exported files
+ * does. `--out <dir>` writes them.
  */
 export declare function bundleProperty(outputSchema: Record<string, unknown> | undefined): string | null;
 /** A non-page response whose result is a collection wrapped in one array
@@ -182,7 +182,7 @@ export declare function writeBundle(dir: string, files: {
 };
 /**
  * A response that carries a claim: an object property `claim` with a string
- * `url` (typeship's anonymous generate is one). The CLI tells the person
+ * `url`, as an anonymous run that can later be saved has. The CLI tells the person
  * where to claim and leaves a breadcrumb in the working directory so a
  * later session (or `doctor`) can list what is still unclaimed.
  */

package/dist/cli-agent.d.ts.map

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

package/dist/cli-agent.js

@@ -43,7 +43,12 @@ export function classifyApiError(error, context) {
     // (no such account)" said one thing three times.
     const base = e.message ? e.message : String(error);
     if (e.violations !== undefined) {
-        return { code: "VALIDATION_FAILED", message: base, detail: { ...(e.name ? { error: e.name } : {}), violations: e.violations }, nextSteps: ["Fix the fields named in detail.violations, or drop --validate to send the body as is."] };
+        const nextStep = e.direction === "response"
+            ? "The API response does not match its schema. Check detail.violations and the API specification."
+            : e.target === "parameters"
+                ? "Correct the parameter values named in detail.violations to match their constraints, then run the command again."
+                : "Correct the body fields named in detail.violations to match their constraints, then run the command again.";
+        return { code: "VALIDATION_FAILED", message: base, detail: { ...(e.name ? { error: e.name } : {}), violations: e.violations }, nextSteps: [nextStep] };
     }
     if (e.name === "TransportError" || (typeof e.status !== "number" && /fetch|ECONN|ENOTFOUND|timed out|TLS|abort/i.test(base))) {
         return {
@@ -280,7 +285,6 @@ export const MCP_CLIENTS = [
         file: (cwd) => join(cwd, ".cursor", "mcp.json"),
         detect: () => existsSync(join(home(), ".cursor")),
         write: (existing, name, entry) => jsonMerge(existing, ["mcpServers"], name, standardEntry(entry)),
-        incompatible: "Cursor does not yet speak MCP 2026-07-28, which is the only version this server serves; the entry is written but Cursor will not connect until it does.",
     },
 ];
 export function findMcpClient(id) {
@@ -332,15 +336,15 @@ export function upsertAgentBlock(file, marker, body) {
 function escapeRegExp(text) {
     return text.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
-/** AGENTS.md by default; CLAUDE.md when only it exists, or when running under Claude Code and AGENTS.md is absent. */
-export function agentInstructionsFile(cwd, harness) {
+/** AGENTS.md for every harness; preserve an existing CLAUDE.md when AGENTS.md is absent. */
+export function agentInstructionsFile(cwd) {
     const agents = join(cwd, "AGENTS.md");
     const claude = join(cwd, "CLAUDE.md");
     if (existsSync(agents))
         return agents;
     if (existsSync(claude))
         return claude;
-    return harness === "claude-code" ? claude : agents;
+    return agents;
 }
 /** One line per command, pipe-delimited: the compact index that goes into AGENTS.md. */
 /** string, number, usd|eur, string[], usd|eur[], object, json — the type as a reader expects it. */
@@ -365,7 +369,7 @@ export function agentBlock(ctx, commands) {
     return [
         "## " + ctx.bin + " CLI (" + ctx.apiTitle + ")",
         "",
-        "Generated by typeship. API commands write JSON on stdout; discovery commands take --json. Errors are JSON on stderr ({status, issues[{code,message}], next_steps}), exit 0/1/2. Non-interactive under an agent: no prompts, no browsers.",
+        "API commands write JSON on stdout; discovery commands take --json. Errors are JSON on stderr ({status, issues[{code,message}], next_steps}), exit 0/1/2. Non-interactive under an agent: no prompts, no browsers.",
         "",
         ...((ctx.omittedOperations?.length ?? 0) > 0 ? ["- Plan limit: generated " + (ctx.generatedOperationCount ?? commands.length) + " of " + ((ctx.generatedOperationCount ?? commands.length) + ctx.omittedOperations.length) + " operations. Omitted: " + ctx.omittedOperations.map((op) => "`" + op.tool + "` (" + op.method + " " + op.path + ")").join(", ") + ". These return `PLAN_LIMIT`; upgrade and regenerate before use."] : []),
         "- Auth: " + auth + " in the environment, or `" + ctx.bin + " login`. Never write a key into a file in this repo.",
@@ -442,8 +446,8 @@ export function installSkills(repo, options = {}) {
 // ---- file bundles ------------------------------------------------------------------
 /**
  * A response that carries files: an array property whose items have string
- * `path` and `content`. typeship's own generate call is one; any API that
- * returns generated or exported files is another. `--out <dir>` writes them.
+ * `path` and `content`, as an API that returns generated or exported files
+ * does. `--out <dir>` writes them.
  */
 export function bundleProperty(outputSchema) {
     const props = outputSchema?.properties;
@@ -462,7 +466,7 @@ export function bundleProperty(outputSchema) {
 export function collectionProperty(outputSchema) {
     const props = outputSchema?.properties;
     // Response metadata is not part of the collection's domain shape. APIs
-    // such as typeship put request_id beside the array on every JSON response.
+    // may put request_id beside the array on every JSON response.
     const names = props ? Object.keys(props).filter((name) => name !== "request_id" && name !== "requestId") : [];
     if (!props || names.length !== 1)
         return null;
@@ -486,7 +490,7 @@ export function writeBundle(dir, files) {
 // ---- claims ----------------------------------------------------------------------------
 /**
  * A response that carries a claim: an object property `claim` with a string
- * `url` (typeship's anonymous generate is one). The CLI tells the person
+ * `url`, as an anonymous run that can later be saved has. The CLI tells the person
  * where to claim and leaves a breadcrumb in the working directory so a
  * later session (or `doctor`) can list what is still unclaimed.
  */

package/dist/cli.js

@@ -20,6 +20,8 @@ import { homedir, hostname } from "node:os";
 import { basename, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { TypeshipClient, formatDebugEvent } from "./index.js";
+import { validateAgainstSchema, ValidationError } from "./core/http.js";
+import { SCHEMAS, DEFS } from "./schemas.js";
 import { GLOBALS, OMITTED_OPS, OPS, buildArgs, findOp, missingRequired } from "./ops.js";
 import { MCP_CLIENTS, agentGuide, agentBlock, agentInstructionsFile, agentMode, bundleProperty, claimProperty, classifyApiError, collectionProperty, detectHarness, envelope, exitCodeFor, findMcpClient, installSkills, mcpConfigured, pendingClaims, recordClaim, summarizeDoctor, upsertAgentBlock, writeBundle, writeMcpConfig, } from "./cli-agent.js";
 import { relativeDate } from "./dates.js";
@@ -33,7 +35,7 @@ const BASIC = null;
 const EXCLUDED_OPS = 0;
 /** Generated CLI operations that are intentionally unavailable to MCP. */
 const MCP_EXCLUDED_OPS = 0;
-const VERSION = "0.10.0";
+const VERSION = "0.20.0";
 const API_VERSION = "1.0.0";
 const SPEC_FORMAT = "openapi";
 const IDENTITY_POLICY = {};
@@ -43,7 +45,7 @@ const ENVIRONMENTS = {};
 const HAS_MCP = false;
 const PKG_NAME = "@typeship-ax/cli";
 const UPDATE_NOTICE = false;
-const API_DESCRIPTION = "Resolve an OpenAPI or GraphQL Definition, diagnose it, and keep every\nselected SDK, CLI, and MCP Target current.\n\nEvery operation but one requires a bearer credential: an organization\nAPI key from the console, or an OAuth access token carrying the operation's\nread, generate, or write capability and the organization selected during\nconsent. OAuth grants cannot switch organizations after consent. A browser\nsession is not a credential for this API. The exception is POST /generate,\nwhich works anonymously with the free plan's limits.\n";
+const API_DESCRIPTION = "Resolve an OpenAPI or GraphQL Definition, diagnose it, and keep every\nselected CLI, MCP, and SDK Target current.\n\nEvery operation but one requires a bearer credential: an organization\nAPI key from the console, or an OAuth access token carrying the operation's\nread, generate, or write capability and the organization selected during\nconsent. OAuth grants cannot switch organizations after consent. A browser\nsession is not a credential for this API. The exception is POST /generate,\nwhich works anonymously with the free plan's limits.\n\nExamples use Parcel, a fictional delivery service. Replace its domains,\nrepository names, and resource identifiers with your own. The hosted\npetstore Definition is a runnable sample.\n";
 const DOCS_URL_DEFAULT = "https://typeship.dev";
 const DOCS_INDEX_URL_DEFAULT = null;
 const RELAY = null;
@@ -136,7 +138,8 @@ function parseArgv(argv) {
             }
             else if (isBooleanFlag(arg.slice(2), positionals)) {
                 const next = argv[i + 1];
-                if (next === "true" || next === "false") {
+                const nullable = positionals.length >= 2 && findOp(positionals[0], positionals[1])?.params.some((p) => p.flag === arg.slice(2) && p.nullable);
+                if (next === "true" || next === "false" || (next === "null" && nullable)) {
                     setFlag(arg.slice(2), next);
                     i++;
                 }
@@ -215,33 +218,32 @@ function out(value) {
 /** --fields a,b.c: the dotted paths to keep in API results (null = everything). Set in main(). */
 let FIELDS = null;
 /** Keep only FIELDS of a result: arrays item by item, objects by dotted path; scalars untouched. */
-function project(value) {
-    if (FIELDS === null)
+function project(value, paths = FIELDS) {
+    if (paths === null)
         return value;
     if (Array.isArray(value))
-        return value.map(project);
+        return value.map((item) => project(item, paths));
     if (value === null || typeof value !== "object")
         return value;
+    const groups = new Map();
+    for (const [key, ...rest] of paths) {
+        if (key === undefined)
+            continue;
+        const group = groups.get(key);
+        if (group)
+            group.push(rest);
+        else
+            groups.set(key, [rest]);
+    }
     const out = {};
-    for (const path of FIELDS) {
-        let cursor = value;
-        for (const key of path) {
-            if (cursor === null || typeof cursor !== "object" || Array.isArray(cursor)) {
-                cursor = undefined;
-                break;
-            }
-            cursor = cursor[key];
-        }
-        if (cursor === undefined)
+    for (const [key, rests] of groups) {
+        const child = value[key];
+        if (child === undefined)
             continue;
-        let target = out;
-        for (const key of path.slice(0, -1)) {
-            const next = target[key];
-            if (next === undefined || next === null || typeof next !== "object" || Array.isArray(next))
-                target[key] = {};
-            target = target[key];
-        }
-        target[path[path.length - 1]] = cursor;
+        if (rests.some((rest) => rest.length === 0))
+            out[key] = child;
+        else if (child !== null && typeof child === "object")
+            out[key] = project(child, rests);
     }
     return out;
 }
@@ -292,12 +294,24 @@ function humanError(body, code) {
             lines.push("  " + paintErr("dim", (v.path ? v.path + ": " : "") + (v.message ?? "")));
     }
     else if (detail?.body !== undefined) {
-        // The API's own body, when the message above did not already come from
-        // it; the request id always, for support tickets.
-        const compact = typeof detail.body === "string" ? detail.body : JSON.stringify(detail.body);
-        const firstWords = (issue?.message ?? "").slice(0, 40);
-        if (compact && compact !== "{}" && !(firstWords && compact.includes(firstWords)))
-            lines.push("  " + paintErr("dim", "API said: " + (compact.length > 300 ? compact.slice(0, 297) + "…" : compact)));
+        // Keep every API error and its field visible, even when the headline
+        // already used the first message. Unstructured bodies retain a summary.
+        const apiErrors = typeof detail.body === "object" && detail.body !== null
+            ? detail.body.errors : undefined;
+        const entries = Array.isArray(apiErrors) ? apiErrors.filter((entry) => entry !== null && typeof entry === "object" && typeof entry.message === "string") : [];
+        if (entries.length > 0) {
+            for (const entry of entries) {
+                const field = typeof entry.field === "string" ? entry.field : "";
+                const location = typeof entry.in === "string" ? entry.in + " " : "";
+                lines.push("  " + paintErr("dim", (field ? location + field + ": " : "") + entry.message));
+            }
+        }
+        else {
+            const compact = typeof detail.body === "string" ? detail.body : JSON.stringify(detail.body);
+            const firstWords = (issue?.message ?? "").slice(0, 40);
+            if (compact && compact !== "{}" && !(firstWords && compact.includes(firstWords)))
+                lines.push("  " + paintErr("dim", "API said: " + (compact.length > 300 ? compact.slice(0, 297) + "…" : compact)));
+        }
         const requestId = detail.request_id ?? detail.body?.request_id ?? detail.body?.requestId;
         if (typeof requestId === "string")
             lines.push("  " + paintErr("dim", "request id: " + requestId));
@@ -668,7 +682,6 @@ async function cmdLogin(parsed) {
             ...AUTH_SCALARS.map((a) => "  " + BIN + " login --" + a.flag + " <value>"),
             ...(CLI_AUTH_URL ? ["  " + BIN + " login                        approve in the browser: a key is minted for you (add --no-browser to print the link instead of opening it)"] : []),
             "  " + BIN + " login --with-token           read the credential from stdin (CI)",
-            "  " + BIN + " login --console-check <file> test browser login for your Typeship Console without replacing saved logins",
             ...(HAS_OAUTH_LOGIN ? ["  " + BIN + " login --client-id <id>       OAuth " + OAUTH_LOGIN_METHOD + " login" + (OAUTH_CLIENT_ID ? " (a default id is built in)" : "")] : []),
             ...(HAS_OAUTH_LOGIN ? ["  " + BIN + " login --no-browser           print the approval URL instead of opening a browser", "  " + BIN + " login --device               use device authorization when your provider supports it"] : []),
             ...(BASIC ? ["  " + BIN + " login --username <u> --password <p>"] : []),
@@ -963,12 +976,11 @@ async function cmdMcp(parsed) {
             "  " + BIN + " mcp install --codex          Codex CLI (~/.codex/config.toml)",
             "  " + BIN + " mcp install --vscode         VS Code (./.vscode/mcp.json)",
             "  " + BIN + " mcp install --windsurf | --gemini | --opencode | --zed | --claude-desktop",
-            "  " + BIN + " mcp install --cursor         Cursor (./.cursor/mcp.json; see note below)",
+            "  " + BIN + " mcp install --cursor         Cursor (./.cursor/mcp.json)",
             "  " + BIN + " mcp --url <https://...>      use a remote MCP endpoint instead of the local server",
             "  " + BIN + " mcp install --claude --read-only   register a read-only server (writes are not callable)",
             "",
             (MCP_URL ? "Default entry: the hosted endpoint " + MCP_URL + " with the auth env var as a reference (never a literal key)." : "Default entry: this package's local stdio server, which reads credentials saved by '" + BIN + " login' or the CLI's auth env vars."),
-            "--all skips Cursor until it speaks MCP 2026-07-28.",
         ];
         process.stdout.write(lines.join("\n") + "\n");
         await flushExit(0);
@@ -1066,7 +1078,7 @@ function commandSummaries() {
         paginated: op.paginated,
         destructive: op.safety === "destructive",
         auth: op.auth,
-        flags: op.params.filter((p) => p.kind !== "path").map((p) => ({ flag: p.flag, type: p.type, ...(p.items ? { items: p.items } : {}), ...(p.enum ? { enum: p.enum } : {}), required: p.required, ...(p.description ? { description: p.description.split("\n")[0] } : {}) })),
+        flags: op.params.filter((p) => p.kind !== "path").map((p) => ({ flag: p.flag, type: p.type, ...(p.nullable ? { nullable: true } : {}), ...(p.items ? { items: p.items } : {}), ...(p.enum ? { enum: p.enum } : {}), required: p.required, ...(p.description ? { description: p.description.split("\n")[0] } : {}) })),
     }));
 }
 /**
@@ -1215,7 +1227,7 @@ async function cmdDoctor(parsed) {
     }
     const checks = [];
     const nodeMajor = Number(process.versions.node.split(".")[0]);
-    checks.push({ name: "node", ok: nodeMajor >= 18, detail: process.version, ...(nodeMajor >= 18 ? {} : { fix: "Install Node 18 or newer." }) });
+    checks.push({ name: "node", ok: nodeMajor >= 20, detail: process.version, ...(nodeMajor >= 20 ? {} : { fix: "Install Node 20 or newer." }) });
     checks.push({ name: "cli", ok: true, detail: BIN + " " + VERSION + " (" + PKG_NAME + ")" });
     let source = null;
     let storageProblem;
@@ -1276,7 +1288,7 @@ async function cmdDoctor(parsed) {
  * init: the one command that connects a machine (or a repo) to this API.
  * Stores a credential when given one, installs the skills repository, writes
  * MCP config for every agent client found, and upserts a marked block into
- * AGENTS.md (CLAUDE.md under Claude Code). Idempotent; --all takes the
+ * AGENTS.md (or an existing CLAUDE.md when AGENTS.md is absent). Idempotent; --all takes the
  * defaults without asking; every part reports and none of them fails init.
  */
 async function cmdInit(parsed) {
@@ -1288,7 +1300,7 @@ async function cmdInit(parsed) {
             "  --all                    do everything without prompting (implied under an agent)",
             "  --no-skills | --no-mcp | --no-agents-md   skip a part",
             "",
-            "Writes: " + credsPath() + " (credential), the skills directory of each agent on this machine" + (SKILLS_REPO ? " (npx skills add " + SKILLS_REPO + ")" : " (no skills repository configured)") + ", MCP config for detected clients, and a '" + BIN + "' block in ./AGENTS.md.",
+            "Writes: " + credsPath() + " (credential), the skills directory of each agent on this machine" + (SKILLS_REPO ? " (npx skills add " + SKILLS_REPO + ")" : " (no skills repository configured)") + ", MCP config for detected clients, and a '" + BIN + "' block in ./AGENTS.md (or an existing ./CLAUDE.md when AGENTS.md is absent).",
         ].join("\n") + "\n");
         await flushExit(0);
     }
@@ -1361,7 +1373,7 @@ async function cmdInit(parsed) {
         report.agents_md = { status: "skipped" };
     }
     else {
-        const file = agentInstructionsFile(cwd, harness);
+        const file = agentInstructionsFile(cwd);
         const result = upsertAgentBlock(file, BIN + " agent-contract", agentBlock(agentContext(), commandSummaries()));
         report.agents_md = { status: result.updated ? "updated" : "written", file: result.file };
     }
@@ -1928,6 +1940,8 @@ function helpSentence(description) {
 }
 /** Type column text for a param: string, number, string[], a|b|c, enum, object, json, path. */
 function typeLabel(p) {
+    if (p.nullable)
+        return typeLabel({ ...p, nullable: false }) + "|null";
     if (p.type === "file")
         return "path (uploaded)";
     if (p.format && p.type === "string")
@@ -2008,7 +2022,7 @@ function printRoot(stream = process.stdout) {
     }
     const width = termWidth();
     const lines = [];
-    lines.push(paintOut("bold", BIN) + ": " + "typeship API" + " (v" + "1.0.0" + "), package " + "0.10.0");
+    lines.push(paintOut("bold", BIN) + ": " + "typeship API" + " (v" + "1.0.0" + "), package " + "0.20.0");
     lines.push("");
     lines.push(paintOut("bold", "Usage:") + " " + BIN + " <resource> <command> [args] [--flags]");
     lines.push("");
@@ -2033,7 +2047,7 @@ function printRoot(stream = process.stdout) {
         lines.push(...labeled("Upgrade: ", "https://typeship.dev/pricing, then regenerate without the operation cap", width, 14));
     }
     lines.push("");
-    const flagsText = "-v/--version, -h/--help, --debug, --non-interactive, --color on|off|auto, --base-url <url>, --profile <name>, --credentials @<file>|-, --data '<json>', --fields <a,b.c>, --all (paginated lists), --validate (schema-check bodies)" +
+    const flagsText = "-v/--version, -h/--help, --debug, --non-interactive, --color on|off|auto, --base-url <url>, --profile <name>, --credentials @<file>|-, --data '<json>', --fields <a,b.c>, --all (paginated lists), --validate (schema-check parameters and JSON bodies)" +
         (AUTH_SCALARS.length > 0 ? ", " + AUTH_SCALARS.map((a) => "--" + a.flag + " <value>").join(", ") : "");
     lines.push(...labeled(paintOut("bold", "Global flags:") + " ", flagsText, width, 14).map((l, i) => (i === 0 ? l : l)));
     lines.push(...labeled("Credential env vars: ", [
@@ -2094,17 +2108,18 @@ function commandExtras(op) {
         extras.push(["--all", "stream every item from every page (NDJSON)"]);
     const collectionField = collectionProperty(op.outputSchema);
     extras.push(["--fields <a,b.c>", "keep only these fields of the result" + (op.paginated ? " (per item)" : collectionField ? " (per item in " + collectionField + ")" : "")]);
-    if (bundleProperty(op.outputSchema) !== null)
+    if ((op.fileBundleProperty ?? bundleProperty(op.outputSchema)) !== null)
         extras.push(["--out <dir>", "write the response's files ({path, content}) into a directory"]);
     if (op.safety === "destructive")
         extras.push(["--force, -y", "destructive: required without a terminal, skips the prompt with one"]);
     return extras;
 }
-/** One runnable example built from the required inputs. */
+/** One runnable example from required inputs and authored optional values. */
 function exampleLine(op) {
     const parts = [BIN, op.command[0], op.command[1]];
     for (const p of op.params) {
-        if (!p.required)
+        const hasExample = p.type !== "file" && Object.hasOwn(op.exampleArguments, p.name);
+        if (!p.required && !hasExample)
             continue;
         const generated = p.type === "file" ? undefined : op.exampleArguments[p.name];
         const values = p.type === "array" ? p.items?.enum : p.enum;
@@ -2115,7 +2130,7 @@ function exampleLine(op) {
                         : p.type === "object" ? {}
                             : p.type === "array" ? [p.items?.type === "number" ? 1 : "value"]
                                 : "value";
-        const value = generated ?? fallback;
+        const value = hasExample ? generated : fallback;
         const sample = typeof value === "string" ? shellQuote(value)
             : typeof value === "object" ? shellQuote(JSON.stringify(value))
                 : String(value);
@@ -2124,10 +2139,11 @@ function exampleLine(op) {
         else
             parts.push("--" + p.flag, sample);
     }
-    const required = op.bodyStyle === "data" && (op.inputSchema.required ?? []).includes("body");
-    if (required) {
-        const body = op.exampleArguments.body;
-        parts.push(op.bodyKind === "binary" ? "--file ./file" : "--data " + shellQuote(JSON.stringify(body ?? {})));
+    const showBody = op.bodyStyle === "data" && (Object.hasOwn(op.exampleArguments, "body")
+        || (op.inputSchema.required ?? []).includes("body"));
+    if (showBody) {
+        const body = Object.hasOwn(op.exampleArguments, "body") ? op.exampleArguments.body : {};
+        parts.push(op.bodyKind === "binary" ? "--file ./file" : "--data " + shellQuote(JSON.stringify(body)));
     }
     if (op.safety === "destructive")
         parts.push("--force");
@@ -2158,6 +2174,9 @@ function printOp(op) {
     if (op.paginated)
         lines.push("  " + usageLine(op) + " --all | jq -r '.id'");
     const arrayFlag = rows.find((p) => p.type === "array");
+    if (rows.some((p) => p.nullable)) {
+        lines.push("", "Nullable body flags accept null for JSON null. Use --data to send the literal string null.");
+    }
     if (arrayFlag) {
         const sample = arrayFlag.items?.enum ? arrayFlag.items.enum.slice(0, 2).join(",") : arrayFlag.items?.type === "number" ? "1,2" : "a,b";
         lines.push("", "Array flags take a comma list (--" + arrayFlag.flag + " " + sample + "), the flag repeated, or a JSON array.");
@@ -2246,6 +2265,8 @@ function coerceScalar(flag, type, enumValues, text) {
  * Objects must be JSON. Enum values are checked locally.
  */
 function coerce(spec, raw, repeated) {
+    if (spec.nullable && raw === "null" && repeated === undefined)
+        return null;
     if (spec.type === "file") {
         if (raw === true)
             fail(2, "--" + spec.flag + " expects a file path");
@@ -2310,8 +2331,66 @@ function coerce(spec, raw, repeated) {
     }
     return coerceScalar(spec.flag, spec.type === "json" ? "json" : spec.type === "number" ? "number" : "string", spec.enum, text);
 }
+/** Use validation schemas, not the shortened agent-facing schemas: every union
+ * branch and referenced definition must remain valid input. */
+function validateParameters(op, values, flags) {
+    if (flags.get("validate") !== true)
+        return;
+    const schemas = SCHEMAS[op.resource + "." + op.method]?.params;
+    if (!schemas)
+        return;
+    const violations = [];
+    for (const parameter of op.params) {
+        if (parameter.kind === "body")
+            continue;
+        let value = values[parameter.name];
+        if (value === undefined && parameter.global) {
+            const global = GLOBALS.find((entry) => entry.name === parameter.name);
+            const raw = global ? process.env["TYPESHIP_" + global.envSuffix] : undefined;
+            if (raw !== undefined)
+                value = coerce(parameter, raw);
+        }
+        if (value === undefined)
+            continue;
+        if (parameter.kind === "path")
+            value = coerce(parameter, String(value));
+        const key = parameter.kind + "." + parameter.name;
+        validateAgainstSchema(value, schemas[key], key, violations, DEFS);
+    }
+    if (violations.length)
+        failApi(new ValidationError("request", violations, "parameters"), false);
+}
 /** Whether the last client built carried any credential; failApi tells NO_AUTH from AUTH_INVALID with it. */
 let LAST_CLIENT_HAD_CREDENTIAL = false;
+/** Check the same complete alternatives the request runtime can select, after
+ * per-scheme flag, environment, profile, and OAuth resolution. */
+function requireOperationCredentials(op, options) {
+    if (op.auth !== "required")
+        return;
+    const supplied = (value) => typeof value === "function" || (typeof value === "string" && value.length > 0)
+        || (value !== null && typeof value === "object" && "username" in value && "password" in value && typeof value.username === "string" && value.username.length > 0 && typeof value.password === "string" && value.password.length > 0);
+    const named = Object.fromEntries(Object.entries(options.credentials ?? {}).filter(([, value]) => supplied(value)));
+    const available = namedCredentialAvailability(NAMED_SCHEMES, new Set(Object.keys(options).filter((key) => supplied(options[key]))), named);
+    if (op.credentialOptions?.some((alternative) => alternative.length > 0 && alternative.every((option) => available.has(option))))
+        return;
+    const alternatives = (op.credentialOptions ?? []).filter((alternative) => alternative.length > 0 && alternative.every((option) => option.startsWith("credentials.")));
+    const missing = alternatives.map((alternative) => alternative.filter((option) => !available.has(option)).map((option) => option.slice("credentials.".length)));
+    const names = new Set(missing.flat());
+    const relevant = AUTH_SCALARS.filter((scalar) => [...names].some((name) => NAMED_SCHEMES[name]?.options.includes(scalar.option)));
+    const needsBasic = [...names].some((name) => NAMED_SCHEMES[name]?.options.includes("basicAuth"));
+    failWith({
+        status: "action_required",
+        code: "NO_AUTH",
+        message: op.command.join(" ") + " needs one complete credential alternative (" + wireOf(op) + "). " + (missing.length
+            ? "Missing security schemes: " + missing.map((names) => names.join(" + ")).join(" OR ") + "."
+            : "The declared security requirements have no supported, compatible alternative in this CLI."),
+        nextSteps: alternatives.length ? [
+            ...relevant.map((a) => "Set " + a.env + " in the environment, pass --" + a.flag + " <value>, or run '" + BIN + " login'."),
+            ...(needsBasic && BASIC ? ["Set " + BASIC.envUser + " and " + BASIC.envPass + ", or pass --username and --password."] : []),
+            "Supply all schemes in one alternative through " + "TYPESHIP_CREDENTIALS" + " or --credentials @<JSON-file>: " + alternatives.map((alternative) => alternative.map((option) => option.slice("credentials.".length)).join(" + ")).join(" OR ") + ".",
+        ] : ["Check the operation's security schemes in the API definition and regenerate with a supported, compatible alternative."],
+    });
+}
 function validateCredentialsInput(flags) {
     const input = flags.get("credentials");
     if (BASIC && flags.has("username") !== flags.has("password"))
@@ -2444,18 +2523,17 @@ async function makeClient(flags, op, candidate, forIdentity = false) {
             options[g.option] = value;
     }
     LAST_CLIENT_HAD_CREDENTIAL = Object.keys(options.credentials ?? {}).length > 0 || AUTH_SCALARS.some((a) => options[a.option] !== undefined) || options.basicAuth !== undefined || options.bearerToken !== undefined;
-    // Who is calling: the CLI, under which agent harness, and whether an
-    // agent is driving. "agent" means a harness was detected or the caller
-    // said so (--mode agent / env); a bare non-TTY run (CI, a pipeline) is
-    // "non-interactive", so usage by surface does not count CI as agents.
-    // The API can read it back; it carries no secrets.
+    requireOperationCredentials(op, options);
+    // Identify the package and version. Optional harness and caller details
+    // let the API distinguish agent traffic from other non-interactive use.
     const harness = detectHarness();
     const explicitAgent = flags.get("mode") === "agent" || process.env["TYPESHIP_MODE"] === "agent";
     const behaving = agentMode({ flagMode: flags.get("mode"), envMode: process.env["TYPESHIP_MODE"], stdoutIsTTY: process.stdout.isTTY === true, stdinIsTTY: process.stdin.isTTY === true });
-    const caller = harness || explicitAgent ? "; agent" : behaving ? "; non-interactive" : "";
+    const caller = harness || explicitAgent ? "agent" : behaving ? "non-interactive" : null;
+    const details = [harness ? "harness=" + harness : null, caller].filter(Boolean).join("; ");
     options.defaultHeaders = {
         ...options.defaultHeaders,
-        "User-Agent": PKG_NAME + "-cli/" + VERSION + " (typeship" + (harness ? "; harness=" + harness : "") + caller + ")",
+        "User-Agent": PKG_NAME + "-cli/" + VERSION + (details ? " (" + details + ")" : ""),
     };
     if (forIdentity) {
         options.fetch = identityFetch(baseUrl);
@@ -2528,8 +2606,8 @@ async function main() {
         fail(2, "--format json is the only format; output is always JSON.");
     }
     if (parsed.flags.has("version") || parsed.positionals[0] === "version") {
-        // "typeship 1.0.0 (typeship 1.0.0, ...)" said the name three times; when
-        // the API's title is the bin, name the API version as such.
+        // "acme 1.0.0 (acme 1.0.0)" would say the name twice; when the API's
+        // title is the bin, name the API version as such.
         const apiLabel = API_TITLE.toLowerCase().replace(/[^a-z0-9]/g, "") === BIN.toLowerCase().replace(/[^a-z0-9]/g, "") ? "API " + API_VERSION : API_TITLE + " " + API_VERSION;
         process.stdout.write(BIN + " " + VERSION + " (" + apiLabel + ", generated by typeship)\n");
         await flushExit(0);
@@ -2697,27 +2775,14 @@ async function main() {
             fail(2, "--fields expects at least one field path");
     }
     // --out <dir> materializes a file-shaped response (see cli-agent.ts bundleProperty).
-    const bundleField = bundleProperty(op.outputSchema);
+    const bundleField = op.fileBundleProperty ?? bundleProperty(op.outputSchema);
     const collectionField = collectionProperty(op.outputSchema);
     const outDir = typeof parsed.flags.get("out") === "string" ? parsed.flags.get("out") : undefined;
     if (outDir !== undefined && bundleField === null) {
         fail(2, "--out applies to commands whose response carries files ({path, content}); " + op.command.join(" ") + " does not.");
     }
-    // The spec says this operation needs a credential and none resolved:
-    // say so now, locally, instead of sending a request to learn it.
-    if (op.auth === "required" && (AUTH_SCALARS.length > 0 || BASIC || HAS_OAUTH_LOGIN) && credentialSource(parsed.flags) === null) {
-        failWith({
-            status: "action_required",
-            code: "NO_AUTH",
-            message: op.command.join(" ") + " needs a credential (" + wireOf(op) + " is authenticated) and none was found.",
-            nextSteps: [
-                ...AUTH_SCALARS.map((a) => "Set " + a.env + " in the environment, pass --" + a.flag + " <value>, or run '" + BIN + " login'."),
-                ...(BASIC ? ["Set " + BASIC.envUser + " and " + BASIC.envPass + ", or pass --username and --password."] : []),
-                ...(AUTH_SCALARS.length === 0 && !BASIC ? ["Run '" + BIN + " login'."] : []),
-                "'" + BIN + " auth check' shows what the CLI would send.",
-            ],
-        });
-    }
+    validateParameters(op, values, parsed.flags);
+    const client = await makeClient(parsed.flags, op);
     // Destructive commands need --force. A person gets asked; an agent gets
     // an action_required envelope with the exact command to run, so nothing
     // is deleted on a guess.
@@ -2736,7 +2801,6 @@ async function main() {
         if (answer !== "y" && answer !== "yes")
             failWith({ status: "action_required", code: "CONFIRMATION_REQUIRED", message: "Cancelled.", nextSteps: ["Run again with --force to skip the prompt: " + rerun] });
     }
-    const client = await makeClient(parsed.flags, op);
     const selectValue = typeof parsed.flags.get("select") === "string" ? parsed.flags.get("select") : undefined;
     const args = buildArgs(op, values, dataBody, selectValue);
     const target = client[op.resource];
@@ -2752,7 +2816,19 @@ async function main() {
             failApi(e, LAST_CLIENT_HAD_CREDENTIAL);
         }
     }
-    const result = await callResult;
+    let result = await callResult;
+    if (result.ok && op.httpMethod === "POST" && op.path === "/projects/{project_id}/generations") {
+        const batch = result.data;
+        const generations = client.generations;
+        const completed = [];
+        for (const generation of batch.data) {
+            const waited = await generations.wait(generation.id);
+            if (!waited.ok)
+                failApi(waited.error, LAST_CLIENT_HAD_CREDENTIAL);
+            completed.push(waited.data);
+        }
+        result = { ...result, data: { ...batch, data: completed } };
+    }
     if (result.ok) {
         if (op.sse) {
             // Server-sent events as NDJSON, one line per event, until the stream ends.

package/dist/core/http.d.ts

@@ -1,6 +1,6 @@
 /**
  * Runtime core. Generated by typeship — https://typeship.dev
- * Zero dependencies: built on the platform fetch API (Node 18+, browsers, edge).
+ * Zero dependencies: built on the platform fetch API (Node 20+, browsers, edge).
  */
 export interface RequestOptions {
     /** Abort the request (composed with the per-attempt timeout). */
@@ -81,8 +81,9 @@ export interface Violation {
  * ApiResult, like every other failure. */
 export declare class ValidationError extends Error {
     readonly direction: "request" | "response";
+    readonly target: "body" | "parameters";
     readonly violations: Violation[];
-    constructor(direction: "request" | "response", violations: Violation[]);
+    constructor(direction: "request" | "response", violations: Violation[], target?: "body" | "parameters");
 }
 /**
  * Validates against the depth-capped JSON Schema subset emitted in