@namzu/cli 27.0.0 → 28.1.0

package/dist/commands/{run-flags.d.ts → exec-flags.d.ts}

@@ -1,26 +1,24 @@
 /**
- * The input surface shared by the two headless one-shots, `run` and
- * `run-stream`.
+ * The input surface of `namzu exec`, the headless one-shot.
  *
- * They are the same command with different OUTPUT — `run` prints the reply for
- * a shell, `run-stream` emits one JSON event per line for a host UI — so they
- * have no business accepting different INPUT. They did: `run-stream` learned to
- * parse `--cwd`, `--model`, `--provider`, `--session` and `--skills`, while
- * `run` parsed nothing at all and joined every argument into the prompt. So
- * `namzu run --cwd /elsewhere "fix the test"` sent the model a prompt beginning
- * `--cwd /elsewhere` and ran in this directory, which is the defect that was
- * already fixed once, in the sibling command.
+ * `exec` prints its reply for a shell by default and, with `--json`, emits one
+ * JSON event per line for a host UI. Those used to be two commands with two
+ * inputs that drifted: one learned to parse `--cwd`, `--model`, `--provider`,
+ * `--session` and `--skills` while the other joined every argument into the
+ * prompt, so `--cwd /elsewhere "fix the test"` sent the model a prompt
+ * beginning `--cwd /elsewhere` and worked in this directory anyway.
  *
- * One parser, so the two cannot drift again.
+ * One parser, so the two output modes cannot drift again. `namzu resident`
+ * reads the same flags for the turns it starts.
  *
- * What they still differ on is how a bad argument is REPORTED, and that is
- * deliberate: `run` answers a shell, so it exits non-zero; `run-stream` answers
- * a line-scanning host, so it emits an error event and exits 0. Each is the
- * only signal its caller is listening for.
+ * What the modes still differ on is how a bad argument is REPORTED, and that is
+ * deliberate: the default mode answers a shell, so it exits non-zero; `--json`
+ * answers a line-scanning host, so it emits an error event and exits 0. Each is
+ * the only signal its caller is listening for.
  */
 import type { ReasoningEffort, ReviewAnswer } from '@namzu/sdk';
 import type { Preferences } from '../integrations/providers/index.js';
-export interface RunFlags {
+export interface ExecFlags {
     session: string | null;
     model: string | null;
     provider: string | null;
@@ -60,7 +58,7 @@ export interface RunFlags {
     waitForProviderMs: number | null;
     /**
      * `--gate '<command>'`, repeatable — commands that must pass before the
-     * run is allowed to settle.
+     * turn is allowed to settle.
      *
      * An ARRAY rather than a single value, and repeat-to-append rather than
      * last-wins, because "typecheck AND test" is the ordinary case and a
@@ -73,6 +71,16 @@ export interface RunFlags {
      * back before the turn stops with `answer_rejected`.
      */
     gateRetries: number | null;
+    /**
+     * `--json`: print the turn as one JSON event per line instead of the reply.
+     */
+    json: boolean;
+    /**
+     * `--output-schema <file>`: a JSON Schema file the final answer is bound
+     * to, through the provider's native structured output. The path as given;
+     * the command resolves it against the process's directory.
+     */
+    outputSchema: string | null;
     /**
      * `--flags` this parser does not know.
      *
@@ -84,7 +92,7 @@ export interface RunFlags {
     unknown: string[];
     rest: string[];
 }
-export declare function parseRunFlags(rawArgs: readonly string[]): RunFlags;
+export declare function parseExecFlags(rawArgs: readonly string[]): ExecFlags;
 /**
  * Absolute path for a `--cwd`, or an error naming what is wrong with it.
  *
@@ -126,7 +134,7 @@ export declare function loadSkillsContext(cwd: string, names: readonly string[])
  * stops after `maxAnswerReviews`, and a turn whose budget outlasts its gate
  * spends its remaining turns being told the same thing.
  */
-export declare function buildGate(flags: Pick<RunFlags, 'gates' | 'gateRetries'>, cwd: string): {
+export declare function buildGate(flags: Pick<ExecFlags, 'gates' | 'gateRetries'>, cwd: string): {
     reviewAnswer: ReviewAnswer;
     maxAnswerReviews: number;
 } | undefined;
@@ -153,5 +161,5 @@ export declare function unknownOptionMessage(unknown: readonly string[]): string
  * viable. Passed together with `--provider`, it models the single member that
  * replaced the chain.
  */
-export declare function applyProviderFlags(prefs: Preferences, flags: Pick<RunFlags, 'provider' | 'model'>): Preferences;
-//# sourceMappingURL=run-flags.d.ts.map
+export declare function applyProviderFlags(prefs: Preferences, flags: Pick<ExecFlags, 'provider' | 'model'>): Preferences;
+//# sourceMappingURL=exec-flags.d.ts.map

package/dist/commands/exec-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-flags.d.ts","sourceRoot":"","sources":["../../src/commands/exec-flags.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE/D,OAAO,KAAK,EAAE,WAAW,EAA8B,MAAM,oCAAoC,CAAA;AAWjG,MAAM,WAAW,SAAS;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,iEAAiE;IACjE,MAAM,EAAE,eAAe,GAAG,IAAI,CAAA;IAC9B,kFAAkF;IAClF,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,kFAAkF;IAClF,cAAc,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,yDAAyD;IACzD,eAAe,EAAE,OAAO,CAAA;IACxB;;;;;;;;;OASG;IACH,KAAK,EAAE,OAAO,CAAA;IACd,6DAA6D;IAC7D,YAAY,EAAE,OAAO,CAAA;IACrB,6DAA6D;IAC7D,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,oEAAoE;IACpE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,oEAAoE;IACpE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B;;;;OAIG;IACH,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC;;;;;;;;OAQG;IACH,KAAK,EAAE,MAAM,EAAE,CAAA;IACf;;;OAGG;IACH,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B;;OAEG;IACH,IAAI,EAAE,OAAO,CAAA;IACb;;;;OAIG;IACH,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B;;;;;;;OAOG;IACH,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,IAAI,EAAE,MAAM,EAAE,CAAA;CACd;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAuPpE;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAS/F;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CACtC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,SAAS,MAAM,EAAE,GACtB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAc7B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CACxB,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,GAAG,aAAa,CAAC,EAC/C,GAAG,EAAE,MAAM,GACT;IAAE,YAAY,EAAE,YAAY,CAAC;IAAC,gBAAgB,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAUtE;AAmBD,iFAAiF;AACjF,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAuBvE;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CACjC,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC,GAC1C,WAAW,CAiBb"}

package/dist/commands/{run-flags.js → exec-flags.js}

@@ -1,35 +1,33 @@
 /**
- * The input surface shared by the two headless one-shots, `run` and
- * `run-stream`.
+ * The input surface of `namzu exec`, the headless one-shot.
  *
- * They are the same command with different OUTPUT — `run` prints the reply for
- * a shell, `run-stream` emits one JSON event per line for a host UI — so they
- * have no business accepting different INPUT. They did: `run-stream` learned to
- * parse `--cwd`, `--model`, `--provider`, `--session` and `--skills`, while
- * `run` parsed nothing at all and joined every argument into the prompt. So
- * `namzu run --cwd /elsewhere "fix the test"` sent the model a prompt beginning
- * `--cwd /elsewhere` and ran in this directory, which is the defect that was
- * already fixed once, in the sibling command.
+ * `exec` prints its reply for a shell by default and, with `--json`, emits one
+ * JSON event per line for a host UI. Those used to be two commands with two
+ * inputs that drifted: one learned to parse `--cwd`, `--model`, `--provider`,
+ * `--session` and `--skills` while the other joined every argument into the
+ * prompt, so `--cwd /elsewhere "fix the test"` sent the model a prompt
+ * beginning `--cwd /elsewhere` and worked in this directory anyway.
  *
- * One parser, so the two cannot drift again.
+ * One parser, so the two output modes cannot drift again. `namzu resident`
+ * reads the same flags for the turns it starts.
  *
- * What they still differ on is how a bad argument is REPORTED, and that is
- * deliberate: `run` answers a shell, so it exits non-zero; `run-stream` answers
- * a line-scanning host, so it emits an error event and exits 0. Each is the
- * only signal its caller is listening for.
+ * What the modes still differ on is how a bad argument is REPORTED, and that is
+ * deliberate: the default mode answers a shell, so it exits non-zero; `--json`
+ * answers a line-scanning host, so it emits an error event and exits 0. Each is
+ * the only signal its caller is listening for.
  */
 import { statSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { DEFAULT_GATE_MAX_RETRIES, createCommandGate } from '@namzu/sdk';
 import { durationMs } from './provider-wait.js';
-/** A nonnegative safe integer; zero disables the corresponding run guard. */
-function runLimit(value, flag) {
+/** A nonnegative safe integer; zero disables the corresponding turn limit. */
+function turnLimit(value, flag) {
     const n = Number(value.trim());
     if (!value.trim() || !Number.isSafeInteger(n) || n < 0)
         throw new Error(`${flag} takes a safe whole number at least 0 (unlimited), got ${value}`);
     return n;
 }
-export function parseRunFlags(rawArgs) {
+export function parseExecFlags(rawArgs) {
     const out = {
         session: null,
         model: null,
@@ -47,6 +45,8 @@ export function parseRunFlags(rawArgs) {
         waitForProviderMs: null,
         gates: [],
         gateRetries: null,
+        json: false,
+        outputSchema: null,
         unknown: [],
         rest: [],
     };
@@ -97,11 +97,11 @@ export function parseRunFlags(rawArgs) {
         }), idx))
             continue;
         if (take(a, 'max-iterations', (v) => {
-            out.maxIterations = runLimit(v, '--max-iterations');
+            out.maxIterations = turnLimit(v, '--max-iterations');
         }, idx))
             continue;
         if (take(a, 'token-budget', (v) => {
-            out.tokenBudget = runLimit(v, '--token-budget');
+            out.tokenBudget = turnLimit(v, '--token-budget');
         }, idx))
             continue;
         if (take(a, 'wait-for-provider', (v) => {
@@ -116,6 +116,14 @@ export function parseRunFlags(rawArgs) {
             out.trust = true;
             continue;
         }
+        if (a === '--json') {
+            out.json = true;
+            continue;
+        }
+        if (take(a, 'output-schema', trimmed((v) => {
+            out.outputSchema = v;
+        }), idx))
+            continue;
         if (take(a, 'resume', trimmed((v) => {
             out.resume = v;
         }), idx))
@@ -152,7 +160,7 @@ export function parseRunFlags(rawArgs) {
             out.gateRetries = Number(v);
         }, idx))
             continue;
-        // Was accepted and ignored, because a headless run never prompted and so
+        // Was accepted and ignored, because a headless turn never prompted and so
         // had nothing to bypass. Now that an operator can write rules, it means
         // something: `auto` for the calls no rule decided. It still cannot reopen
         // a `deny` or the dangerous-pattern floor, so it promises more than it
@@ -265,7 +273,7 @@ export function unknownOptionMessage(unknown) {
     // Two different mistakes reached the same sentence, and only one of them
     // was ever about a dash.
     //
-    // `namzu run "..." --verbose` is the order a person types, and the generic
+    // `namzu exec "..." --verbose` is the order a person types, and the generic
     // message answered it with "pass `--` before a prompt that starts with a
     // dash" — advice for a prompt beginning with `-`, which this is not. The
     // reader is then looking at the wrong half of their command line. The flag
@@ -320,4 +328,4 @@ export function applyProviderFlags(prefs, flags) {
     const remodelled = { id: head.id, model: flags.model };
     return { ...prefs, providers: [remodelled, ...rest] };
 }
-//# sourceMappingURL=run-flags.js.map
+//# sourceMappingURL=exec-flags.js.map

package/dist/commands/exec-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-flags.js","sourceRoot":"","sources":["../../src/commands/exec-flags.ts"],"names":[],"mappings":"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"}

package/dist/commands/{run-stream.d.ts → exec-json.d.ts}

@@ -1,7 +1,7 @@
 /**
- * `namzu run-stream [--session <key>] "<prompt>"` — headless STREAMING
- * one-shot. Same engine as `run`, but instead of buffering the final text it
- * emits one compact NDJSON line per `AgentEvent` to stdout
+ * `namzu exec --json [--session <key>] "<prompt>"` — the headless one-shot as
+ * a STREAM. Same engine as the default mode, but instead of buffering the
+ * final text it emits one compact NDJSON line per `AgentEvent` to stdout
  * (`{"kind":"delta","text":…}`, `{"kind":"tool-start",…}`,
  * `{"kind":"error","message":…}`, `{"kind":"done"}`). A host process — a
  * desktop app embedding namzu, say — line-scans stdout and renders the turn
@@ -15,8 +15,8 @@
  * reasoning and complete tool turns included. That's what lets a reopened
  * session show and replay its past messages (`namzu history --session
  * <key>`). Without `--session`, prior history may be supplied on stdin as a
- * JSON `Message[]` and the turn runs in an in-memory log: nothing is persisted
- * (stateless one-shot).
+ * JSON `Message[]` and the turn works in an in-memory log: nothing is
+ * persisted (a stateless one-shot).
  *
  * Status lines go to stderr as NDJSON (LOG-05), never stdout, so every
  * stdout line is a valid JSON event, and EVERY failure is reported in band,
@@ -53,17 +53,23 @@
  *   credential or driver the session needs, a declared tool server that is not
  *   there, a command file that will not parse.
  *
- * `1` rather than a new code because `namzu run` — the same one-shot, differing
- * only in how it prints — already exits `1` for these conditions and `77` for
- * trust. A host that shells to one for a script and the other for a UI must not
+ * `1` rather than a new code because the default mode of `namzu exec` — the
+ * same one-shot, differing only in how it prints — already exits `1` for these
+ * conditions and `77` for trust. A host that shells to one for a script and the other for a UI must not
  * be handed two tables for one fact.
  *
  * Dropping `--session` is NOT "the caller fixing it": it abandons what was
  * asked for rather than achieving it.
  */
-import type { CommandDef } from './types.js';
-export declare const runStreamCommand: CommandDef;
-export declare const historyCommand: CommandDef;
-export declare const skillsJSONCommand: CommandDef;
-export declare const providersJSONCommand: CommandDef;
-//# sourceMappingURL=run-stream.d.ts.map
+import { type StructuredOutputConfig } from '@namzu/sdk';
+import type { TerminationHandling } from '../termination.js';
+import { type ExecFlags } from './exec-flags.js';
+import type { CommandHandlerArgs } from './types.js';
+/**
+ * `exec --json`. `flags` are already parsed; `structuredOutput` is the loaded
+ * `--output-schema`, or an error loading it that is reported in band.
+ */
+export declare function execJson({ ctx: bootstrapCtx }: CommandHandlerArgs, termination: TerminationHandling, flags: ExecFlags, structuredOutput: StructuredOutputConfig | {
+    readonly error: string;
+} | undefined): Promise<number>;
+//# sourceMappingURL=exec-json.d.ts.map

package/dist/commands/exec-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec-json.d.ts","sourceRoot":"","sources":["../../src/commands/exec-json.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8DG;AAEH,OAAO,EAGN,KAAK,sBAAsB,EAI3B,MAAM,YAAY,CAAA;AAkBnB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AAI5D,OAAO,EACN,KAAK,SAAS,EAMd,MAAM,iBAAiB,CAAA;AAGxB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AAapD;;;GAGG;AACH,wBAAsB,QAAQ,CAC7B,EAAE,GAAG,EAAE,YAAY,EAAE,EAAE,kBAAkB,EACzC,WAAW,EAAE,mBAAmB,EAChC,KAAK,EAAE,SAAS,EAChB,gBAAgB,EAAE,sBAAsB,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAC/E,OAAO,CAAC,MAAM,CAAC,CA+XjB"}