@kashdao/cli 0.1.0

package/dist/help-footer-GTANVDNP.js

@@ -0,0 +1,43 @@
+#!/usr/bin/env node
+
+// src/utils/help-footer.ts
+var DOCS_BASE_URL = "https://kash.bot/docs/cli";
+function withDocsFooter(cmd, slug) {
+  const url = slug ? `${DOCS_BASE_URL}/${slug}` : DOCS_BASE_URL;
+  cmd.addHelpText("after", `
+More: ${url}
+`);
+  return cmd;
+}
+function attachDocsFooters(program) {
+  const slugByName = {
+    account: "account",
+    auth: "authentication",
+    markets: "markets",
+    quote: "quotes",
+    trade: "trades",
+    portfolio: "portfolio",
+    protocol: "direct-mode",
+    eoa: "eoa-mode",
+    webhooks: "webhooks",
+    config: "configuration",
+    health: "health",
+    version: "version",
+    explain: "errors",
+    schema: "schemas",
+    setup: "setup",
+    trace: "trace",
+    "with-retry": "with-retry",
+    docs: "introspection",
+    completion: "completion"
+  };
+  for (const cmd of program.commands) {
+    const slug = slugByName[cmd.name()] ?? "";
+    withDocsFooter(cmd, slug);
+  }
+}
+export {
+  attachDocsFooters,
+  withDocsFooter
+};
+//# sourceMappingURL=help-footer-GTANVDNP.js.map

package/dist/help-footer-GTANVDNP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/help-footer.ts"],"sourcesContent":["/**\n * Inline docs footers for `--help` output.\n *\n * Every top-level command registered with the CLI gets a footer line\n * pointing at the matching docs page. Keeps the help output skimmable\n * while still giving users (and AI agents reading `kash docs --json`)\n * a deep-link to the prose explanation.\n *\n * Footer text is appended via Commander's `addHelpText('after', ...)`,\n * which appears after `Examples:` (when present) but before Commander's\n * own boilerplate. Commands that already have an `addHelpText` block\n * stack with this one — order is registration order.\n */\n\nimport type { Command } from 'commander';\n\nconst DOCS_BASE_URL = 'https://kash.bot/docs/cli';\n\n/**\n * Append a one-line \"More: <url>\" footer to the command's `--help`\n * output. The URL is composed from `DOCS_BASE_URL` + the supplied\n * slug. Pass slug `''` to point at the CLI index page.\n *\n * Typical usage at the registration site:\n *\n * ```ts\n * import { withDocsFooter } from '../utils/help-footer.js';\n *\n * const marketsCommand = withDocsFooter(\n *   new Command('markets').description('…'),\n *   'markets'\n * );\n * ```\n *\n * The helper returns the same command instance so it can be chained\n * inline with the rest of the builder.\n */\nexport function withDocsFooter(cmd: Command, slug: string): Command {\n  const url = slug ? `${DOCS_BASE_URL}/${slug}` : DOCS_BASE_URL;\n  cmd.addHelpText('after', `\\nMore: ${url}\\n`);\n  return cmd;\n}\n\n/**\n * Apply a docs-footer line to every top-level command registered on\n * the root program. Maps known command names to their docs slug; any\n * command whose name isn't in the map gets the CLI-index footer.\n *\n * Call this AFTER all `program.addCommand(...)` calls so we walk the\n * fully-populated tree.\n */\nexport function attachDocsFooters(program: Command): void {\n  const slugByName: Record<string, string> = {\n    account: 'account',\n    auth: 'authentication',\n    markets: 'markets',\n    quote: 'quotes',\n    trade: 'trades',\n    portfolio: 'portfolio',\n    protocol: 'direct-mode',\n    eoa: 'eoa-mode',\n    webhooks: 'webhooks',\n    config: 'configuration',\n    health: 'health',\n    version: 'version',\n    explain: 'errors',\n    schema: 'schemas',\n    setup: 'setup',\n    trace: 'trace',\n    'with-retry': 'with-retry',\n    docs: 'introspection',\n    completion: 'completion',\n  };\n\n  for (const cmd of program.commands) {\n    const slug = slugByName[cmd.name()] ?? '';\n    withDocsFooter(cmd, slug);\n  }\n}\n"],"mappings":";;;AAgBA,IAAM,gBAAgB;AAqBf,SAAS,eAAe,KAAc,MAAuB;AAClE,QAAM,MAAM,OAAO,GAAG,aAAa,IAAI,IAAI,KAAK;AAChD,MAAI,YAAY,SAAS;AAAA,QAAW,GAAG;AAAA,CAAI;AAC3C,SAAO;AACT;AAUO,SAAS,kBAAkB,SAAwB;AACxD,QAAM,aAAqC;AAAA,IACzC,SAAS;AAAA,IACT,MAAM;AAAA,IACN,SAAS;AAAA,IACT,OAAO;AAAA,IACP,OAAO;AAAA,IACP,WAAW;AAAA,IACX,UAAU;AAAA,IACV,KAAK;AAAA,IACL,UAAU;AAAA,IACV,QAAQ;AAAA,IACR,QAAQ;AAAA,IACR,SAAS;AAAA,IACT,SAAS;AAAA,IACT,QAAQ;AAAA,IACR,OAAO;AAAA,IACP,OAAO;AAAA,IACP,cAAc;AAAA,IACd,MAAM;AAAA,IACN,YAAY;AAAA,EACd;AAEA,aAAW,OAAO,QAAQ,UAAU;AAClC,UAAM,OAAO,WAAW,IAAI,KAAK,CAAC,KAAK;AACvC,mBAAe,KAAK,IAAI;AAAA,EAC1B;AACF;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.js

@@ -0,0 +1,251 @@
+#!/usr/bin/env node
+import {
+  CLI_VERSION
+} from "./chunk-BN2CUM42.js";
+
+// src/utils/debug-hint.ts
+function isTruthyEnv(value) {
+  if (value === void 0) return false;
+  const v = value.trim().toLowerCase();
+  return v === "1" || v === "true" || v === "yes" || v === "on";
+}
+function isDebugOn(argv2 = process.argv, env = process.env) {
+  return argv2.slice(2).includes("--debug") || isTruthyEnv(env["KASH_DEBUG"]);
+}
+function shouldPromoteDebug(code) {
+  switch (code) {
+    case "INVALID_INPUT":
+    case "CONFIGURATION":
+    case "INVALID_USEROP":
+    case "INSUFFICIENT_FUNDS":
+    case "INSUFFICIENT_GAS":
+    case "INSUFFICIENT_SCOPE":
+      return false;
+    default:
+      return true;
+  }
+}
+
+// src/index.ts
+for (const stream of [process.stdout, process.stderr]) {
+  stream.on("error", (err) => {
+    if (err.code === "EPIPE" || err.code === "EIO") {
+      process.exit(0);
+    }
+    throw err;
+  });
+}
+process.on("uncaughtException", (err) => {
+  if (err.code === "EPIPE" || err.code === "EIO") {
+    process.exit(0);
+  }
+  throw err;
+});
+var argv = process.argv;
+if (argv[2] === "--version" || argv[2] === "-V") {
+  if (argv.slice(3).includes("--json")) {
+    const [{ buildVersionManifest }, { printJson: printJson2 }] = await Promise.all([
+      import("./version-JDK3PEP5.js"),
+      import("./output-VCBZ3FM7.js")
+    ]);
+    printJson2(buildVersionManifest());
+  } else {
+    process.stdout.write(`${CLI_VERSION}
+`);
+  }
+  process.exit(0);
+}
+{
+  const tail = argv.slice(2);
+  const helpIdx = tail.indexOf("--help");
+  const dashHIdx = tail.indexOf("-h");
+  const hasHelp = helpIdx !== -1 || dashHIdx !== -1;
+  const hasJson = tail.includes("--json");
+  const hasOther = tail.some(
+    (t) => t !== "--help" && t !== "-h" && t !== "--json" && t !== "--quiet"
+  );
+  if (hasHelp && hasJson && !hasOther) {
+    process.argv = [argv[0], argv[1], "docs", "--json"];
+    if (tail.includes("--quiet")) process.argv.push("--quiet");
+  }
+}
+var onlyArgs = argv.slice(2);
+var isBareInvocation = onlyArgs.length === 0 || onlyArgs.length === 1 && (onlyArgs[0] === "--json" || onlyArgs[0] === "--quiet");
+if (isBareInvocation) {
+  const wantsJson = onlyArgs.includes("--json");
+  const wantsQuiet = onlyArgs.includes("--quiet") || isTruthyEnv2(process.env["KASH_QUIET"]);
+  if (wantsQuiet && !wantsJson) {
+    process.exit(0);
+  }
+  const { buildIntroEnvelope, INTRO_SUGGESTIONS, DOCS_URL } = await import("./intro-PQQTYWR7.js");
+  if (wantsJson) {
+    const { printJson: printJson2 } = await import("./output-VCBZ3FM7.js");
+    printJson2(buildIntroEnvelope(CLI_VERSION));
+  } else {
+    const { print, style } = await import("./output-VCBZ3FM7.js");
+    print("");
+    print(`${style.bold("kash")} ${style.dim(`v${CLI_VERSION}`)} \u2014 Kash prediction markets CLI`);
+    print("");
+    for (const s of INTRO_SUGGESTIONS) {
+      print(`  ${style.bold(s.title)}`);
+      print(`    ${style.cyan(s.command)}`);
+      print(`    ${style.dim(s.description)}`);
+      print("");
+    }
+    print(
+      `${style.dim("Run")} ${style.cyan("kash --help")} ${style.dim("for the full command list.")}`
+    );
+    print(`${style.dim("Docs:")} ${DOCS_URL}`);
+    print("");
+  }
+  process.exit(0);
+}
+function isTruthyEnv2(value) {
+  if (value === void 0) return false;
+  const v = value.trim().toLowerCase();
+  return v === "1" || v === "true" || v === "yes" || v === "on";
+}
+var { Command } = await import("commander");
+var { authCommand } = await import("./auth-GUJCVKTD.js");
+var { configCommand } = await import("./config-XJL5TSYK.js");
+var { buildDocsCommand } = await import("./docs-MDKKSJDC.js");
+var { eoaCommand } = await import("./eoa-IQ72EIHR.js");
+var { explainCommand } = await import("./explain-H4EH3KH3.js");
+var { accountCommand } = await import("./account-AVFLEM5D.js");
+var { healthCommand } = await import("./health-VZEIII74.js");
+var { marketsCommand } = await import("./markets-C37JZDPE.js");
+var { portfolioCommand } = await import("./portfolio-2AEPIJIG.js");
+var { protocolCommand } = await import("./protocol-XEQXF2GW.js");
+var { quoteCommand } = await import("./quote-I4DVJ7ZB.js");
+var { schemaCommand } = await import("./schema-PIFQ65TS.js");
+var { setupCommand } = await import("./setup-USZ6IODD.js");
+var { traceCommand } = await import("./trace-IZBYTUFO.js");
+var { tradeCommand } = await import("./trade-IIZSEXEI.js");
+var { withRetryCommand } = await import("./with-retry-4FIZG3A7.js");
+var { versionCommand } = await import("./version-JDK3PEP5.js");
+var { webhooksCommand } = await import("./webhooks-PTVRKICZ.js");
+var { createCompletionCommand, initCompletion } = await import("./completion-ZZGX5BQC.js");
+var { EXIT_CODES, toCliError } = await import("./errors-WMZIEGQI.js");
+var { readGlobals } = await import("./global-options-XOLJUPTT.js");
+var { configureOutput, log, printJson } = await import("./output-VCBZ3FM7.js");
+var program = new Command();
+program.name("kash").description("Official command-line interface for the Kash public API.").version(CLI_VERSION, "-V, --version", "output the CLI version").option("--json", "emit machine-readable JSON instead of human-formatted output", false).option(
+  "--quiet",
+  "suppress spinners, progress, informational logs, AND human-mode tables (pair with --json \u2014 bare --quiet on a list/get command produces no stdout at all by design)",
+  false
+).option("--no-color", "disable ANSI color in human-mode output").option(
+  "--debug",
+  "emit SDK request/response/retry/error traces to stderr; pairs with --json for NDJSON traces",
+  false
+).option(
+  "-p, --profile <name>",
+  "pick a named profile from ~/.kash/config.json (overrides KASH_PROFILE)"
+).option(
+  "--config <path>",
+  "use an explicit config file path instead of ~/.kash/config.json (overrides KASH_CONFIG)"
+).option("--base-url <url>", "override the API base URL for this invocation only").option("--max-retries <n>", "override the SDK retry budget for this invocation only").option("--timeout-ms <n>", "override the SDK request timeout (ms) for this invocation only").option(
+  "--api-version <date>",
+  "pin against a public-API contract date (sent as 'X-Kash-Api-Version: <date>'). Omit to let the server use its canonical default."
+).option(
+  "--fields <list>",
+  "comma-separated dot-paths to project on JSON output (e.g. id,title,outcomes.label)"
+).option(
+  "--filter <expr>",
+  "boolean predicate on JSON entries (e.g. 'status==ACTIVE && outcomeCount>2')"
+).hook("preAction", (thisCommand) => {
+  const globals = readGlobals(thisCommand);
+  configureOutput({
+    quiet: globals.quiet,
+    noColor: globals.noColor,
+    fields: globals.fields,
+    filter: globals.filter
+  });
+}).addHelpText(
+  "after",
+  `
+Common workflows:
+  First-time setup          kash setup
+  Switch / inspect profile  kash su <name>
+  Browse markets            kash markets list --status ACTIVE
+  Place a trade and wait    kash trade buy <id> --outcome 0 --amount 10 --wait
+  Inspect portfolio         kash portfolio show && kash portfolio positions
+
+For AI agents:
+  Universal agent mode      kash <any-command> --json --quiet
+  Discover all commands     kash docs --json --quiet
+  Get a request schema      kash schema CreateTradeBody --json
+  Recover from an error     kash explain RATE_LIMITED --json
+  Stream paginated reads    kash markets list --ndjson
+
+Exit codes:
+  0  success
+  1  generic error (validation, server, network, \u2026)
+  2  auth failure (missing or invalid API key, missing scope)
+
+Run \`kash <command> --help\` for command-specific help and examples.
+Docs: https://kash.bot/docs/cli
+`
+);
+program.exitOverride();
+program.addCommand(authCommand);
+program.addCommand(accountCommand);
+program.addCommand(marketsCommand);
+program.addCommand(quoteCommand);
+program.addCommand(tradeCommand);
+program.addCommand(portfolioCommand);
+program.addCommand(protocolCommand);
+program.addCommand(eoaCommand);
+program.addCommand(webhooksCommand);
+program.addCommand(configCommand);
+program.addCommand(healthCommand);
+program.addCommand(versionCommand);
+program.addCommand(explainCommand);
+program.addCommand(schemaCommand);
+program.addCommand(setupCommand);
+program.addCommand(traceCommand);
+program.addCommand(withRetryCommand);
+program.addCommand(buildDocsCommand(() => program));
+program.addCommand(createCompletionCommand());
+var { attachDocsFooters } = await import("./help-footer-GTANVDNP.js");
+attachDocsFooters(program);
+await initCompletion();
+try {
+  await program.parseAsync(process.argv);
+} catch (rawError) {
+  const error = toCliError(rawError);
+  if (error.code === "NOOP" && error.exitCode === EXIT_CODES.OK) {
+    process.exit(0);
+  }
+  emitError(error);
+  process.exit(error.exitCode);
+}
+function emitError(error) {
+  const json = safeReadJsonFlag();
+  if (json) {
+    printJson(error.toEnvelope());
+    return;
+  }
+  log.error(`[${error.code}] ${error.message}`);
+  if (error.suggestion) {
+    log.detail("Suggestion", error.suggestion);
+  }
+  if (error.retryAfterMs !== void 0) {
+    log.detail("Retry after", `${String(Math.round(error.retryAfterMs / 1e3))}s`);
+  }
+  if (error.docsUrl) {
+    log.detail("Docs", error.docsUrl);
+  }
+  if (error.requestId) {
+    log.detail("Request ID", error.requestId);
+  }
+  if (error.code !== "UNEXPECTED") {
+    log.detail("More", `kash explain ${error.code}`);
+  }
+  if (!isDebugOn(process.argv, process.env) && shouldPromoteDebug(error.code)) {
+    log.detail("Debug", "Re-run with --debug for verbose HTTP logs.");
+  }
+}
+function safeReadJsonFlag() {
+  return process.argv.slice(2).includes("--json");
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/debug-hint.ts","../src/index.ts"],"sourcesContent":["/**\n * Helpers for the \"Re-run with --debug for verbose HTTP logs\" hint\n * emitted on the error path in `src/index.ts`.\n *\n * Factored out of `src/index.ts` so the helpers are unit-testable —\n * `index.ts` is the CLI entry point and runs Commander at module load,\n * so importing it from a test triggers `process.exit`.\n */\n\n/**\n * Recognise truthy env values the way every other tool does: `1`,\n * `true`, `yes`, `on` (case-insensitive). Empty string and `0` are\n * falsy. Anything else is a no-op rather than an error — env\n * pollution is common and shouldn't fail builds.\n *\n * Local copy of the same helper that lives in `utils/global-options.ts`\n * — kept in sync intentionally; the two MUST agree on what counts as\n * \"debug on\" or the UX gets confusing (readGlobals decides \"is\n * --debug active?\" via isTruthyEnv, and the error path's hint decides\n * \"should I suggest --debug?\" via the same rule).\n */\nfunction isTruthyEnv(value: string | undefined): boolean {\n  if (value === undefined) return false;\n  const v = value.trim().toLowerCase();\n  return v === '1' || v === 'true' || v === 'yes' || v === 'on';\n}\n\n/**\n * \"Is debug already on?\" — used on the error path to decide whether to\n * promote `--debug` as a next-step hint. Mirrors readGlobals'\n * resolution: either the `--debug` flag is in argv, or `KASH_DEBUG`\n * is a *truthy* value per the shared `isTruthyEnv` rule.\n *\n * Critical: a bare presence check on `KASH_DEBUG` would mistakenly\n * skip the hint when the user has `KASH_DEBUG=0` / `=false` / `=no`\n * set — those env values do NOT enable debug mode in readGlobals,\n * so the hint should still fire. The two resolution paths must\n * agree or the UX gets confused.\n *\n * Pure inputs → pure output; safe to invoke with synthetic argv/env\n * in unit tests without touching `process`.\n */\nexport function isDebugOn(\n  argv: readonly string[] = process.argv,\n  env: NodeJS.ProcessEnv = process.env\n): boolean {\n  return argv.slice(2).includes('--debug') || isTruthyEnv(env['KASH_DEBUG']);\n}\n\n/**\n * Promote `--debug` for codes where verbose HTTP logs help — anything\n * the operator can't fix by changing input. Validation / config /\n * input errors don't benefit from more logs (the cause is right there\n * in the message).\n */\nexport function shouldPromoteDebug(code: string): boolean {\n  switch (code) {\n    case 'INVALID_INPUT':\n    case 'CONFIGURATION':\n    case 'INVALID_USEROP':\n    case 'INSUFFICIENT_FUNDS':\n    case 'INSUFFICIENT_GAS':\n    case 'INSUFFICIENT_SCOPE':\n      return false;\n    default:\n      return true;\n  }\n}\n","/**\n * `kash` — official command-line interface for the Kash public API.\n *\n * The binary is a thin wrapper over `@kashdao/sdk`. Every command\n * resolves its config (file → env), constructs a KashClient, and\n * defers to the SDK for the actual work. This file is only the\n * Commander wiring: registration, global flags, and the top-level\n * error boundary.\n *\n * **Cold-start strategy.** Plain `kash --version` and `kash -V` are the\n * single hottest invocation in CI/agent contexts (every health probe,\n * every doctor script). We short-circuit them before any of the\n * subcommand modules load — they pull `@kashdao/sdk`, `chalk`, `ora`,\n * etc., none of which `--version` needs. The full Commander tree is\n * built only when the user actually asks for a real command.\n */\n\nimport { isDebugOn, shouldPromoteDebug } from './utils/debug-hint.js';\nimport { CLI_VERSION } from './version.js';\n\n// ── SIGPIPE-safe stdout/stderr ──────────────────────────────────────\n//\n// `kash <cmd> | head` is a common shell pattern; without this guard,\n// when `head` closes the pipe early Node throws `EPIPE` from the next\n// `process.stdout.write`, which surfaces as exit code 1 — surprising\n// for users piping output into `head`/`less`/`column`. We treat\n// EPIPE / EIO as a clean exit (0): downstream told us to stop, we\n// stop. Any other write error still propagates so real I/O failures\n// aren't masked.\n//\n// Two listeners are needed:\n//   1. `'error'` on the streams catches EPIPE delivered as an event\n//      (async writes / future flushes).\n//   2. `'uncaughtException'` catches EPIPE thrown synchronously by a\n//      `process.stdout.write` call when the pipe is already closed —\n//      this is what `head -c 5` triggers and the stream listener\n//      doesn't see.\nfor (const stream of [process.stdout, process.stderr]) {\n  stream.on('error', (err: NodeJS.ErrnoException) => {\n    if (err.code === 'EPIPE' || err.code === 'EIO') {\n      process.exit(0);\n    }\n    throw err;\n  });\n}\nprocess.on('uncaughtException', (err: NodeJS.ErrnoException) => {\n  if (err.code === 'EPIPE' || err.code === 'EIO') {\n    process.exit(0);\n  }\n  // Re-throw so Node's default handler logs and exits with 1.\n  throw err;\n});\n\n// ── Fast path: plain `--version` / `-V` ─────────────────────────────\n//\n// Short-circuits before commander, the SDK, and every command module\n// are imported. The structured `--version --json` path still needs\n// `buildVersionManifest` (which reads `os` info) and `printJson`, but\n// even those load lazily so the simpler `kash --version` only pays\n// for `version.js`.\nconst argv = process.argv;\nif (argv[2] === '--version' || argv[2] === '-V') {\n  if (argv.slice(3).includes('--json')) {\n    const [{ buildVersionManifest }, { printJson }] = await Promise.all([\n      import('./commands/version.js'),\n      import('./utils/output.js'),\n    ]);\n    printJson(buildVersionManifest());\n  } else {\n    process.stdout.write(`${CLI_VERSION}\\n`);\n  }\n  process.exit(0);\n}\n\n// ── Fast path: `kash --help --json` / `kash --json --help` ──────────\n//\n// Commander's default `--help` renderer emits human-formatted text —\n// useful for operators, useless for AI agents probing the surface.\n// When `--help` is paired with `--json` (any order, no other args),\n// route to the structured `kash docs --json --quiet` envelope. That's\n// the canonical machine-readable help and pinning to it keeps the\n// agent contract clean.\n//\n// We don't try to handle `kash <subcommand> --help --json` — those\n// fall through to Commander's text help, and the right answer for\n// agents is to fetch the full tree once via `kash docs --json` and\n// drill down.\n{\n  const tail = argv.slice(2);\n  const helpIdx = tail.indexOf('--help');\n  const dashHIdx = tail.indexOf('-h');\n  const hasHelp = helpIdx !== -1 || dashHIdx !== -1;\n  const hasJson = tail.includes('--json');\n  const hasOther = tail.some(\n    (t) => t !== '--help' && t !== '-h' && t !== '--json' && t !== '--quiet'\n  );\n  if (hasHelp && hasJson && !hasOther) {\n    // Use the existing docs command via its describeCommand walker.\n    // We need a fully-built program to walk, so we let the eager\n    // imports below run and handle this in the docs command's own\n    // action. Mark it with the flag and let it fall through.\n    process.argv = [argv[0]!, argv[1]!, 'docs', '--json'];\n    if (tail.includes('--quiet')) process.argv.push('--quiet');\n  }\n}\n\n// ── Friendly intro: `kash` (no args, optionally with --json) ─────────\n//\n// Default Commander behaviour for a no-args invocation is to dump\n// `--help`, which is overwhelming on first contact. Show a curated\n// landing instead. Detected by argv length: pure `kash`, `kash --json`,\n// or `kash --quiet` (with no other tokens) trip this path.\n//\n// **Quiet contracts.** CI environments and orchestrators that spawn\n// `kash` with no extra args shouldn't see decorative output. Honour\n// `--quiet`, `KASH_QUIET=1` (env mirror — same truthy parser as\n// `KASH_DEBUG`), and the de-facto-standard `NO_COLOR`/`CI` are\n// deliberately NOT included because they have unrelated semantics.\n// In quiet mode we exit 0 with no output at all — no JSON envelope\n// either, since a script triggering this path didn't ask for it.\n//\n// Anything else (`kash foo`, `kash --help`, `kash markets …`) falls\n// through to Commander as before.\nconst onlyArgs = argv.slice(2);\nconst isBareInvocation =\n  onlyArgs.length === 0 ||\n  (onlyArgs.length === 1 && (onlyArgs[0] === '--json' || onlyArgs[0] === '--quiet'));\nif (isBareInvocation) {\n  const wantsJson = onlyArgs.includes('--json');\n  const wantsQuiet = onlyArgs.includes('--quiet') || isTruthyEnv(process.env['KASH_QUIET']);\n\n  // Quiet mode: emit nothing — neither the human banner nor the JSON\n  // envelope. CI scripts that bare-invoke `kash` to test the binary\n  // works don't need decorative output. (`--json` still wins if the\n  // user is explicit about wanting structured output.)\n  if (wantsQuiet && !wantsJson) {\n    process.exit(0);\n  }\n\n  const { buildIntroEnvelope, INTRO_SUGGESTIONS, DOCS_URL } = await import('./utils/intro.js');\n  if (wantsJson) {\n    const { printJson } = await import('./utils/output.js');\n    printJson(buildIntroEnvelope(CLI_VERSION));\n  } else {\n    const { print, style } = await import('./utils/output.js');\n    print('');\n    print(`${style.bold('kash')} ${style.dim(`v${CLI_VERSION}`)} — Kash prediction markets CLI`);\n    print('');\n    for (const s of INTRO_SUGGESTIONS) {\n      print(`  ${style.bold(s.title)}`);\n      print(`    ${style.cyan(s.command)}`);\n      print(`    ${style.dim(s.description)}`);\n      print('');\n    }\n    print(\n      `${style.dim('Run')} ${style.cyan('kash --help')} ${style.dim('for the full command list.')}`\n    );\n    print(`${style.dim('Docs:')} ${DOCS_URL}`);\n    print('');\n  }\n  process.exit(0);\n}\n\n/**\n * Mirror of the `isTruthyEnv` helper in `utils/global-options.ts`.\n * Inlined here so the bare-invocation fast path doesn't pay for the\n * full import. Same truth values: `1`, `true`, `yes`, `on`\n * (case-insensitive). Empty string and `0` are falsy.\n */\nfunction isTruthyEnv(value: string | undefined): boolean {\n  if (value === undefined) return false;\n  const v = value.trim().toLowerCase();\n  return v === '1' || v === 'true' || v === 'yes' || v === 'on';\n}\n\n// Eager imports below run only for invocations that actually need a\n// command. The SDK-heavy modules still load — Commander needs every\n// subcommand registered up-front to render `--help` correctly — but\n// individual commands lazy-load their own dependencies (`omelette`,\n// `zod-to-json-schema`, `@kashdao/protocol-sdk`, `viem`) inside their\n// action handlers.\nconst { Command } = await import('commander');\nconst { authCommand } = await import('./commands/auth/index.js');\nconst { configCommand } = await import('./commands/config/index.js');\nconst { buildDocsCommand } = await import('./commands/docs.js');\nconst { eoaCommand } = await import('./commands/eoa/index.js');\nconst { explainCommand } = await import('./commands/explain.js');\nconst { accountCommand } = await import('./commands/account/index.js');\nconst { healthCommand } = await import('./commands/health.js');\nconst { marketsCommand } = await import('./commands/markets/index.js');\nconst { portfolioCommand } = await import('./commands/portfolio/index.js');\nconst { protocolCommand } = await import('./commands/protocol/index.js');\nconst { quoteCommand } = await import('./commands/quote/index.js');\nconst { schemaCommand } = await import('./commands/schema.js');\nconst { setupCommand } = await import('./commands/setup.js');\nconst { traceCommand } = await import('./commands/trace.js');\nconst { tradeCommand } = await import('./commands/trade/index.js');\nconst { withRetryCommand } = await import('./commands/with-retry.js');\nconst { versionCommand } = await import('./commands/version.js');\nconst { webhooksCommand } = await import('./commands/webhooks/index.js');\nconst { createCompletionCommand, initCompletion } = await import('./completion.js');\nconst { EXIT_CODES, toCliError } = await import('./errors.js');\nconst { readGlobals } = await import('./utils/global-options.js');\nconst { configureOutput, log, printJson } = await import('./utils/output.js');\n\nimport type { CliError } from './errors.js';\n\nconst program = new Command();\n\nprogram\n  .name('kash')\n  .description('Official command-line interface for the Kash public API.')\n  .version(CLI_VERSION, '-V, --version', 'output the CLI version')\n  // Output controls\n  .option('--json', 'emit machine-readable JSON instead of human-formatted output', false)\n  .option(\n    '--quiet',\n    'suppress spinners, progress, informational logs, AND human-mode tables (pair with --json — bare --quiet on a list/get command produces no stdout at all by design)',\n    false\n  )\n  .option('--no-color', 'disable ANSI color in human-mode output')\n  .option(\n    '--debug',\n    'emit SDK request/response/retry/error traces to stderr; pairs with --json for NDJSON traces',\n    false\n  )\n  // Config selection\n  .option(\n    '-p, --profile <name>',\n    'pick a named profile from ~/.kash/config.json (overrides KASH_PROFILE)'\n  )\n  .option(\n    '--config <path>',\n    'use an explicit config file path instead of ~/.kash/config.json (overrides KASH_CONFIG)'\n  )\n  // SDK overrides — useful for staging tests, CI matrix builds, agent retry tuning\n  .option('--base-url <url>', 'override the API base URL for this invocation only')\n  .option('--max-retries <n>', 'override the SDK retry budget for this invocation only')\n  .option('--timeout-ms <n>', 'override the SDK request timeout (ms) for this invocation only')\n  .option(\n    '--api-version <date>',\n    \"pin against a public-API contract date (sent as 'X-Kash-Api-Version: <date>'). \" +\n      'Omit to let the server use its canonical default.'\n  )\n  // Output projection — applied only on --json/--ndjson output\n  .option(\n    '--fields <list>',\n    'comma-separated dot-paths to project on JSON output (e.g. id,title,outcomes.label)'\n  )\n  .option(\n    '--filter <expr>',\n    \"boolean predicate on JSON entries (e.g. 'status==ACTIVE && outcomeCount>2')\"\n  )\n  .hook('preAction', (thisCommand) => {\n    const globals = readGlobals(thisCommand);\n    configureOutput({\n      quiet: globals.quiet,\n      noColor: globals.noColor,\n      fields: globals.fields,\n      filter: globals.filter,\n    });\n  })\n  .addHelpText(\n    'after',\n    `\nCommon workflows:\n  First-time setup          kash setup\n  Switch / inspect profile  kash su <name>\n  Browse markets            kash markets list --status ACTIVE\n  Place a trade and wait    kash trade buy <id> --outcome 0 --amount 10 --wait\n  Inspect portfolio         kash portfolio show && kash portfolio positions\n\nFor AI agents:\n  Universal agent mode      kash <any-command> --json --quiet\n  Discover all commands     kash docs --json --quiet\n  Get a request schema      kash schema CreateTradeBody --json\n  Recover from an error     kash explain RATE_LIMITED --json\n  Stream paginated reads    kash markets list --ndjson\n\nExit codes:\n  0  success\n  1  generic error (validation, server, network, …)\n  2  auth failure (missing or invalid API key, missing scope)\n\nRun \\`kash <command> --help\\` for command-specific help and examples.\nDocs: https://kash.bot/docs/cli\n`\n  );\n\n// Hand control of Commander's exit behaviour to our top-level error\n// boundary. Without this, Commander calls `process.exit(1)` directly\n// on unknown commands / unknown options, skipping our structured\n// error envelope. With `exitOverride`, Commander throws a\n// `CommanderError` we can map to a `CliError` (see `toCliError` in\n// errors.ts).\n//\n// Help and version short-circuits still get filtered there — they\n// surface as `commander.help`/`commander.helpDisplayed`/`commander.version`\n// codes which the mapper detects and treats as clean exits.\nprogram.exitOverride();\n\n// Register top-level command groups.\nprogram.addCommand(authCommand);\nprogram.addCommand(accountCommand);\nprogram.addCommand(marketsCommand);\nprogram.addCommand(quoteCommand);\nprogram.addCommand(tradeCommand);\nprogram.addCommand(portfolioCommand);\nprogram.addCommand(protocolCommand);\nprogram.addCommand(eoaCommand);\nprogram.addCommand(webhooksCommand);\nprogram.addCommand(configCommand);\nprogram.addCommand(healthCommand);\nprogram.addCommand(versionCommand);\nprogram.addCommand(explainCommand);\nprogram.addCommand(schemaCommand);\nprogram.addCommand(setupCommand);\nprogram.addCommand(traceCommand);\nprogram.addCommand(withRetryCommand);\nprogram.addCommand(buildDocsCommand(() => program));\nprogram.addCommand(createCompletionCommand());\n\n// Append a per-command \"More: <docs-url>\" footer to every top-level\n// `--help` page. Done after every command is registered so we walk\n// the fully-populated tree once.\nconst { attachDocsFooters } = await import('./utils/help-footer.js');\nattachDocsFooters(program);\n\n// Initialize shell completion before parseAsync — omelette needs to\n// see the args first to detect a completion request. Now async because\n// `initCompletion` lazy-imports omelette only when the args look like\n// a completion handshake.\nawait initCompletion();\n\ntry {\n  await program.parseAsync(process.argv);\n  // Let Node exit naturally on success so any buffered stdout writes\n  // (NDJSON streams, large `--all` exports through a pipe) flush\n  // cleanly. Calling `process.exit` here would truncate the buffer\n  // when stdout is connected to a slow consumer. The error path\n  // still calls `process.exit` because we want a deterministic exit\n  // code; data loss isn't a concern when we already failed.\n} catch (rawError) {\n  const error = toCliError(rawError);\n  // Clean exits (e.g. `--help` and `--version` short-circuits surfaced\n  // via Commander's `exitOverride`) bypass the error renderer — they\n  // already wrote their output to stdout and there's nothing to add.\n  if (error.code === 'NOOP' && error.exitCode === EXIT_CODES.OK) {\n    process.exit(0);\n  }\n  emitError(error);\n  process.exit(error.exitCode);\n}\n\n/**\n * Render the error using whichever output mode is currently active.\n * In JSON mode we stay machine-readable so an AI agent can branch on\n * `code` without parsing prose; in human mode we surface the\n * suggestion (when available) and the request id (when available).\n *\n * `readGlobals` itself can throw when a flag value is malformed\n * (`--base-url not-a-url`, `--max-retries 99`). On the error path\n * we shouldn't double-throw — fall back to a minimal mode (sniff the\n * raw argv for `--json` / `--quiet`) so the original error is still\n * surfaced cleanly.\n */\nfunction emitError(error: CliError): void {\n  const json = safeReadJsonFlag();\n  if (json) {\n    printJson(error.toEnvelope());\n    return;\n  }\n  log.error(`[${error.code}] ${error.message}`);\n  if (error.suggestion) {\n    log.detail('Suggestion', error.suggestion);\n  }\n  if (error.retryAfterMs !== undefined) {\n    log.detail('Retry after', `${String(Math.round(error.retryAfterMs / 1000))}s`);\n  }\n  if (error.docsUrl) {\n    log.detail('Docs', error.docsUrl);\n  }\n  if (error.requestId) {\n    log.detail('Request ID', error.requestId);\n  }\n  // Always promote the explainer for the structured-actions catalog —\n  // it's the deepest source of recovery info the CLI ships with and\n  // every catalog entry has a `kash explain CODE` payload. Skipped\n  // when the code itself isn't in the catalog (UNEXPECTED, etc.) to\n  // avoid pointing the user at an empty page.\n  if (error.code !== 'UNEXPECTED') {\n    log.detail('More', `kash explain ${error.code}`);\n  }\n  // For non-trivial failures, surface --debug as the next-step lever.\n  // It enables verbose request/response logging on the SDK's HTTP\n  // path — the natural diagnostic when an error keeps recurring.\n  // Skipped when --debug is already on (don't suggest what they're\n  // already doing) and on plain validation errors (the user needs to\n  // fix input, not log more bytes).\n  if (!isDebugOn(process.argv, process.env) && shouldPromoteDebug(error.code)) {\n    log.detail('Debug', 'Re-run with --debug for verbose HTTP logs.');\n  }\n}\n\n/**\n * Inspect the raw argv for `--json` without re-running validation —\n * used on the error path so a malformed flag value (which is what\n * triggered the error in the first place) doesn't double-throw and\n * obscure the original failure.\n */\nfunction safeReadJsonFlag(): boolean {\n  return process.argv.slice(2).includes('--json');\n}\n"],"mappings":"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","names":["argv","printJson","isTruthyEnv"]}

package/dist/intro-PQQTYWR7.js

@@ -0,0 +1,41 @@
+#!/usr/bin/env node
+
+// src/utils/intro.ts
+var INTRO_SUGGESTIONS = [
+  {
+    title: "Authenticate",
+    command: "kash setup",
+    description: "Interactive first-run wizard."
+  },
+  {
+    title: "Browse markets",
+    command: "kash markets list --status ACTIVE",
+    description: "List active prediction markets."
+  },
+  {
+    title: "Place a trade and wait",
+    command: "kash trade buy <market-id> --outcome 0 --amount 10 --wait",
+    description: "Buy outcome tokens, block on settlement."
+  },
+  {
+    title: "For agents",
+    command: "kash docs --json --quiet",
+    description: "Full machine-readable command surface. `--json --quiet` is the universal agent mode \u2014 every command emits a stable JSON envelope on stdout."
+  }
+];
+var DOCS_URL = "https://kash.bot/docs/cli";
+function buildIntroEnvelope(version) {
+  return {
+    name: "kash",
+    version,
+    docsUrl: DOCS_URL,
+    suggestions: INTRO_SUGGESTIONS,
+    hint: "Run `kash --help` for the full command list, or `kash docs --json --quiet` for the machine-readable surface (matches the agent suggestion above)."
+  };
+}
+export {
+  DOCS_URL,
+  INTRO_SUGGESTIONS,
+  buildIntroEnvelope
+};
+//# sourceMappingURL=intro-PQQTYWR7.js.map

package/dist/intro-PQQTYWR7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/intro.ts"],"sourcesContent":["/**\n * Friendly-intro suggestions for the bare `kash` invocation.\n *\n * Hoisted out of `index.ts` so:\n *   1. The list is testable in isolation (without spinning up the\n *      full bare-invocation pipeline).\n *   2. Adding/removing curated suggestions doesn't churn the entry\n *      point.\n *   3. Both the human and `--json` renderers consume the same source\n *      of truth.\n */\n\nexport type IntroSuggestion = {\n  /** Short label for human mode. */\n  readonly title: string;\n  /** Concrete command line a user can copy + run. */\n  readonly command: string;\n  /** One-sentence description of the suggestion. */\n  readonly description: string;\n};\n\n/**\n * Curated 4-suggestion landing for the bare `kash` invocation. Tuned\n * for first-contact users and AI agents — covers (auth → discover →\n * trade → introspection).\n */\nexport const INTRO_SUGGESTIONS: readonly IntroSuggestion[] = [\n  {\n    title: 'Authenticate',\n    command: 'kash setup',\n    description: 'Interactive first-run wizard.',\n  },\n  {\n    title: 'Browse markets',\n    command: 'kash markets list --status ACTIVE',\n    description: 'List active prediction markets.',\n  },\n  {\n    title: 'Place a trade and wait',\n    command: 'kash trade buy <market-id> --outcome 0 --amount 10 --wait',\n    description: 'Buy outcome tokens, block on settlement.',\n  },\n  {\n    title: 'For agents',\n    command: 'kash docs --json --quiet',\n    description:\n      'Full machine-readable command surface. `--json --quiet` is the universal agent mode — every command emits a stable JSON envelope on stdout.',\n  },\n];\n\n/** Dashboard URL surfaced alongside the suggestions. */\nexport const DOCS_URL = 'https://kash.bot/docs/cli';\n\nexport type IntroEnvelope = {\n  readonly name: 'kash';\n  readonly version: string;\n  readonly docsUrl: string;\n  readonly suggestions: readonly IntroSuggestion[];\n  readonly hint: string;\n};\n\n/**\n * Compose the JSON-mode intro envelope. Pure function so callers\n * (and tests) can pin to the contract shape.\n */\nexport function buildIntroEnvelope(version: string): IntroEnvelope {\n  return {\n    name: 'kash',\n    version,\n    docsUrl: DOCS_URL,\n    suggestions: INTRO_SUGGESTIONS,\n    hint: 'Run `kash --help` for the full command list, or `kash docs --json --quiet` for the machine-readable surface (matches the agent suggestion above).',\n  };\n}\n"],"mappings":";;;AA0BO,IAAM,oBAAgD;AAAA,EAC3D;AAAA,IACE,OAAO;AAAA,IACP,SAAS;AAAA,IACT,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS;AAAA,IACT,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS;AAAA,IACT,aAAa;AAAA,EACf;AAAA,EACA;AAAA,IACE,OAAO;AAAA,IACP,SAAS;AAAA,IACT,aACE;AAAA,EACJ;AACF;AAGO,IAAM,WAAW;AAcjB,SAAS,mBAAmB,SAAgC;AACjE,SAAO;AAAA,IACL,MAAM;AAAA,IACN;AAAA,IACA,SAAS;AAAA,IACT,aAAa;AAAA,IACb,MAAM;AAAA,EACR;AACF;","names":[]}