argsbarg 6.1.0 → 6.1.2

package/src/parse.ts

@@ -16,6 +16,7 @@ import {
   CliOptionKind,
   isCliLeaf,
   isCliRouter,
+  isJsonLeaf,
 } from "./types.ts";
 import { fullStringIsDouble } from "./utils.ts";
 
@@ -237,6 +238,48 @@ export function collectOptionDefs(root: CliNode, path: string[]): CliOption[] {
   return defs;
 }
 
+/** Fills `args` for a json leaf from `startIdx` (0 or 1 JSON string positional). */
+function finishJsonLeaf(
+  _node: CliLeaf,
+  startIdx: number,
+  argv: string[],
+  path: string[],
+  opts: Record<string, string>,
+): ParseResult {
+  let idx = startIdx;
+  const args: string[] = [];
+
+  if (idx < argv.length) {
+    const tok = argv[idx];
+    if (isHelpTok(tok)) {
+      return helpResult(path, true);
+    }
+    if (tok === "--") {
+      return errorResult("Unexpected extra arguments", path, []);
+    }
+    if (tok.startsWith("-")) {
+      return errorResult(`JSON commands do not accept options: ${tok}`, path, []);
+    }
+    args.push(tok);
+    idx += 1;
+  }
+
+  if (idx < argv.length) {
+    return errorResult("Unexpected extra arguments", path, []);
+  }
+
+  return {
+    kind: ParseKind.Ok,
+    path,
+    opts,
+    args,
+    helpExplicit: false,
+    helpPath: [],
+    errorMsg: "",
+    errorHelpPath: [],
+  };
+}
+
 /** Fills `args` for a leaf from `startIdx` according to `node.positionals`. */
 function finishLeaf(
   node: CliLeaf,
@@ -412,6 +455,9 @@ export function parse(root: CliNode, argv: string[]): ParseResult {
   let node: CliNode | undefined;
 
   if (isCliLeaf(root)) {
+    if (isJsonLeaf(root)) {
+      return finishJsonLeaf(root, i, argv, path, opts);
+    }
     return finishLeaf(root, i, argv, path, opts, root.options ?? [], forcePositionals);
   }
 
@@ -473,6 +519,10 @@ export function parse(root: CliNode, argv: string[]): ParseResult {
 
   // Walk the command tree
   while (true) {
+    if (isCliLeaf(current) && isJsonLeaf(current)) {
+      return finishJsonLeaf(current, i, argv, path, opts);
+    }
+
     if (!forcePositionals) {
       const orep = consumeOptions(collectOptionDefs(root, path), false, argv, i, opts);
       if (orep.report.err) {

package/src/types.ts

@@ -418,10 +418,18 @@ export interface CliNodeBase {
   options?: CliOption[];
 }
 
+/** Leaf input mode: `json` = pure JSON body (no CLI flags). */
+export type CliLeafKind = "json";
+
 /**
  * A leaf command node with a handler and optional positionals.
  */
 export type CliLeaf = CliNodeBase & {
+  /**
+   * When `"json"`, the leaf accepts a single JSON document (CLI positional or piped stdin;
+   * MCP/HTTP tool args = body). Requires `inputSchema`; forbids `options` and `positionals`.
+   */
+  kind?: CliLeafKind;
   /** Handler function for leaf commands. */
   handler: CliHandler;
   /** Positional argument definitions. */
@@ -482,6 +490,11 @@ export function isCliLeaf(node: CliNode): node is CliLeaf {
   return "handler" in node && typeof node.handler === "function";
 }
 
+/** True when the leaf accepts a pure JSON body (no CLI flags). */
+export function isJsonLeaf(leaf: CliLeaf): boolean {
+  return leaf.kind === "json";
+}
+
 /** True when the node is a router (has subcommands). */
 export function isCliRouter(node: CliNode): node is CliRouter {
   return "commands" in node && Array.isArray(node.commands);

package/src/validate.ts

@@ -19,6 +19,7 @@ import {
   type InstallTargetSpec,
   isCliLeaf,
   isCliRouter,
+  isJsonLeaf,
 } from "./types.ts";
 
 /** Validates `docs` configuration on the program root. */
@@ -238,6 +239,17 @@ function walkNode(node: CliNode, program: CliProgram, isRoot: boolean): void {
     if (isRoot && node.mcpTool !== undefined) {
       throw new CliSchemaValidationError("mcpTool is only supported on leaf commands");
     }
+    if (isJsonLeaf(node)) {
+      if (node.inputSchema === undefined) {
+        throw new CliSchemaValidationError(`kind: "json" requires inputSchema on ${node.key}`);
+      }
+      if ((node.options ?? []).length > 0) {
+        throw new CliSchemaValidationError(`kind: "json" forbids options on ${node.key}`);
+      }
+      if ((node.positionals ?? []).length > 0) {
+        throw new CliSchemaValidationError(`kind: "json" forbids positionals on ${node.key}`);
+      }
+    }
     const outputSchema = node.outputSchema;
     const legacyOutputSchema = node.mcpTool?.outputSchema;
     if (outputSchema !== undefined && legacyOutputSchema !== undefined) {