stitchkit 0.90.3 → 0.90.4

package/dist/{index-j7q0xj6d.js → index-8crm1srv.js}

@@ -24,7 +24,7 @@ import {
 } from "./index-scs3f1eg.js";
 import {
   defineRuntimeTool
-} from "./index-kc6h6hg0.js";
+} from "./index-8z9we758.js";
 
 // src/agent-runtime/coding-tool-contract.ts
 import { z } from "zod";

package/dist/{index-kc6h6hg0.js → index-8z9we758.js}

@@ -1,6 +1,6 @@
 import {
   projectRuntimeTool
-} from "./index-r159gjwy.js";
+} from "./index-fenaekmk.js";
 
 // src/tools/runtime-tool.ts
 function defineRuntimeTool(definition) {

package/dist/{index-r159gjwy.js → index-fenaekmk.js}

@@ -667,6 +667,40 @@ function assertUniqueToolName(name, taken, surface) {
 
 // src/tools/presentation.ts
 import { z as z2 } from "zod";
+
+// src/tools/json-schema-dialect.ts
+var DRAFT_07_MARKER = "draft-07";
+var DRAFT_07_KEYWORD = "definitions";
+var DEFS_KEYWORD = "$defs";
+function declaresDraft07(dialect) {
+  return typeof dialect === "string" && dialect.includes(DRAFT_07_MARKER);
+}
+function rewriteDefinitionPointers(value) {
+  if (Array.isArray(value))
+    return value.map(rewriteDefinitionPointers);
+  if (!isRecord(value))
+    return value;
+  const rewritten = {};
+  for (const [key, child] of Object.entries(value)) {
+    rewritten[key] = key === "$ref" && typeof child === "string" && child.startsWith(`#/${DRAFT_07_KEYWORD}/`) ? `#/${DEFS_KEYWORD}/${child.slice(`#/${DRAFT_07_KEYWORD}/`.length)}` : rewriteDefinitionPointers(child);
+  }
+  return rewritten;
+}
+function withDefsDialect(schema) {
+  const definitions = schema[DRAFT_07_KEYWORD];
+  if (!isRecord(definitions) || DEFS_KEYWORD in schema)
+    return schema;
+  const rewritten = {};
+  for (const [key, value] of Object.entries(schema)) {
+    if (key === DRAFT_07_KEYWORD)
+      continue;
+    rewritten[key] = rewriteDefinitionPointers(value);
+  }
+  rewritten[DEFS_KEYWORD] = rewriteDefinitionPointers(definitions);
+  return rewritten;
+}
+
+// src/tools/presentation.ts
 function withoutDialect(schema) {
   const result = {};
   for (const [key, value] of Object.entries(schema)) {
@@ -684,25 +718,59 @@ function hasLocalReference(value) {
     return true;
   return Object.values(value).some(hasLocalReference);
 }
-function rewriteLocalReferences(value, namespace) {
+var NAMESPACE_SEPARATOR = "__";
+var DEFINITION_KEYWORDS = ["definitions", "$defs"];
+function rewriteReference(reference, namespace, targets) {
+  if (reference === "#" || reference === "#/") {
+    targets.rootReferenced = true;
+    return `#/definitions/${namespace}`;
+  }
+  const segments = reference.slice(2).split("/");
+  const [keyword, name, ...rest] = segments;
+  if (keyword !== undefined && name !== undefined && DEFINITION_KEYWORDS.includes(keyword)) {
+    const renamed = `${namespace}${NAMESPACE_SEPARATOR}${name}`;
+    return ["#", "definitions", renamed, ...rest].join("/");
+  }
+  targets.rootReferenced = true;
+  return `#/definitions/${namespace}/${segments.join("/")}`;
+}
+function rewriteLocalReferences(value, namespace, targets) {
   if (Array.isArray(value)) {
-    return value.map((child) => rewriteLocalReferences(child, namespace));
+    return value.map((child) => rewriteLocalReferences(child, namespace, targets));
   }
   if (!isRecord(value))
     return value;
   const rewritten = {};
   for (const [key, child] of Object.entries(value)) {
-    rewritten[key] = key === "$ref" && typeof child === "string" && child.startsWith("#") ? `#/definitions/${namespace}${child.slice(1)}` : rewriteLocalReferences(child, namespace);
+    rewritten[key] = key === "$ref" && typeof child === "string" && child.startsWith("#") ? rewriteReference(child, namespace, targets) : rewriteLocalReferences(child, namespace, targets);
   }
   return rewritten;
 }
 function namespaceLocalReferences(schema, namespace) {
   if (!schema || !hasLocalReference(schema))
     return schema;
-  const rewritten = rewriteLocalReferences(schema, namespace);
+  const targets = { rootReferenced: false };
+  const rewritten = rewriteLocalReferences(schema, namespace, targets);
   if (!isRecord(rewritten))
     return schema;
-  return { ...rewritten, definitions: { [namespace]: rewritten } };
+  const definitions = {};
+  const body = {};
+  for (const [key, value] of Object.entries(rewritten)) {
+    if (DEFINITION_KEYWORDS.includes(key)) {
+      if (isRecord(value)) {
+        for (const [name, definition] of Object.entries(value)) {
+          definitions[`${namespace}${NAMESPACE_SEPARATOR}${name}`] = definition;
+        }
+      }
+      continue;
+    }
+    body[key] = value;
+  }
+  if (targets.rootReferenced)
+    definitions[namespace] = withoutDialect(body);
+  if (Object.keys(definitions).length === 0)
+    return body;
+  return { ...body, definitions };
 }
 function objectProperties(schema) {
   return schema.type === "object" && isRecord(schema.properties) ? schema.properties : null;
@@ -710,11 +778,29 @@ function objectProperties(schema) {
 function requiredKeys2(schema) {
   return Array.isArray(schema.required) ? schema.required.filter((key) => typeof key === "string") : [];
 }
+function hoistDefinitions(schema) {
+  const branches = Array.isArray(schema.allOf) ? schema.allOf : [];
+  const definitions = {};
+  const lifted = branches.map((branch) => {
+    if (!isRecord(branch) || !isRecord(branch.definitions))
+      return branch;
+    Object.assign(definitions, branch.definitions);
+    const rest = {};
+    for (const [key, value] of Object.entries(branch)) {
+      if (key !== "definitions")
+        rest[key] = value;
+    }
+    return rest;
+  });
+  if (Object.keys(definitions).length === 0)
+    return schema;
+  return { ...schema, allOf: lifted, definitions };
+}
 function mergeObjectSchemas(left, right, rightOwnsUnknownKeys) {
   const leftProperties = objectProperties(left);
   const rightProperties = objectProperties(right);
   if (!leftProperties || !rightProperties)
-    return { allOf: [left, right] };
+    return hoistDefinitions({ allOf: [left, right] });
   const conflicts = Object.keys(leftProperties).filter((key) => (key in rightProperties));
   if (conflicts.length > 0) {
     throw new Error(`Schema merge conflict: ${conflicts.join(", ")} appear in both params and input`);
@@ -777,7 +863,7 @@ function isObjectPresentationSchema(schema) {
   return schema.type === "object" && isRecord(schema.properties);
 }
 function presentationMetadata(schema) {
-  return withoutDialect(schema);
+  return withDefsDialect(withoutDialect(schema));
 }
 
 // src/tools/internal/surface-projector.ts
@@ -1027,4 +1113,4 @@ function prepareProjectedMcpTools(tools, config = {}) {
   return prepared;
 }
 
-export { objectShapeKeys, rebuildObject, mergeSchemas, validateMcpRoundPolicy, assertToolName, assertUniqueToolName, PORTABLE_JSON_SCHEMA_FORMATS, findNonPortableFormats, flattenToolJsonSchema, buildToolPresentationSchema, presentationMetadata, findUntypedProperties, assertToolExtensionCompatible, projectRuntimeTool, projectToolSurface, mcpProjectionCandidate, prepareProjectedMcpTools };
+export { objectShapeKeys, rebuildObject, mergeSchemas, validateMcpRoundPolicy, assertToolName, assertUniqueToolName, PORTABLE_JSON_SCHEMA_FORMATS, findNonPortableFormats, flattenToolJsonSchema, declaresDraft07, withDefsDialect, buildToolPresentationSchema, presentationMetadata, findUntypedProperties, assertToolExtensionCompatible, projectRuntimeTool, projectToolSurface, mcpProjectionCandidate, prepareProjectedMcpTools };

package/dist/{index-wb15909q.js → index-kzxpsf8y.js}

@@ -1,12 +1,12 @@
 import {
   contractToolMountable
-} from "./index-2hrfpw2c.js";
+} from "./index-32vjke6q.js";
 import {
   runtimeToolMountable
-} from "./index-kc6h6hg0.js";
+} from "./index-8z9we758.js";
 import {
   projectToolSurface
-} from "./index-r159gjwy.js";
+} from "./index-fenaekmk.js";
 
 // src/tools/surface.ts
 function collectToolSurface({

package/dist/{index-44ht2790.js → index-vcnfwrtr.js}

@@ -20,7 +20,7 @@ import {
 } from "./index-kzfs85xp.js";
 import {
   objectShapeKeys
-} from "./index-r159gjwy.js";
+} from "./index-fenaekmk.js";
 import {
   isRecord
 } from "./index-77fekveh.js";

package/dist/{index-1923shw9.js → index-y47z614h.js}

@@ -3,15 +3,15 @@ import {
 } from "./index-sbdmyz75.js";
 import {
   collectToolSurface
-} from "./index-wb15909q.js";
+} from "./index-kzxpsf8y.js";
 import {
   createToolRunner,
   formatToolError
-} from "./index-2hrfpw2c.js";
+} from "./index-32vjke6q.js";
 import {
   toolErrorFromResult,
   toolResultFromError
-} from "./index-44ht2790.js";
+} from "./index-vcnfwrtr.js";
 import {
   formatZodError,
   validateDeclaredOutput
@@ -27,7 +27,7 @@ import {
   assertUniqueToolName,
   buildToolPresentationSchema,
   objectShapeKeys
-} from "./index-r159gjwy.js";
+} from "./index-fenaekmk.js";
 import {
   jsonSchemaFields
 } from "./index-cby4ar3v.js";
@@ -39,7 +39,8 @@ import {
 import { z } from "zod";
 var NUMERIC_VALUE = /^-(\d+\.?\d*|\.\d+)$/;
 var BOOL_OPTIONS = new Set(["json", "wait", "quiet", "dry-run", "help"]);
-var VALUE_OPTIONS = new Set(["wait-timeout", "output-dir"]);
+var VIEW_OPTIONS = new Set(["count-by", "sum", "by", "top", "table"]);
+var VALUE_OPTIONS = new Set(["wait-timeout", "output-dir", ...VIEW_OPTIONS]);
 var RESERVED_CLI_OPTIONS = new Set([...BOOL_OPTIONS, ...VALUE_OPTIONS]);
 function classifyLongOptionToken(token) {
   if (!token.startsWith("--") || token === "--")
@@ -315,6 +316,7 @@ function parseCliArgs(argv, schema, config = {}) {
   }
   const flags = new Map;
   const boolFlags = new Map;
+  const viewFlags = new Map;
   const positionals = [];
   const pushFlag = (name, value) => {
     const existing = flags.get(name);
@@ -400,6 +402,10 @@ function parseCliArgs(argv, schema, config = {}) {
           throw new CliArgumentError("--wait-timeout must be a positive number");
         }
         options.waitTimeout = timeout;
+      } else if (VIEW_OPTIONS.has(name)) {
+        if (viewFlags.has(name))
+          throw new CliArgumentError(`--${name} was given twice`);
+        viewFlags.set(name, value);
       } else {
         options.outputDir = value;
       }
@@ -433,6 +439,9 @@ function parseCliArgs(argv, schema, config = {}) {
     }
     pushFlag(name, value);
   }
+  const view = resolveCliView(viewFlags);
+  if (view)
+    options.view = view;
   const toolArgs = {};
   const fillable = config.positionals === undefined ? [...fields.entries()].filter(([, info]) => info.kind !== "boolean").map(([name]) => name) : [...config.positionals];
   const variadicTail = config.positionals !== undefined && fields.get(fillable[fillable.length - 1] ?? "")?.kind === "array" ? fillable[fillable.length - 1] : undefined;
@@ -536,6 +545,63 @@ function extractCliGlobalOptions(argv, schema) {
   }
   return { argv: rest, globals: parsed.data };
 }
+function resolveCliView(flags) {
+  if (flags.size === 0)
+    return;
+  const countBy = flags.get("count-by");
+  const sum = flags.get("sum");
+  const table = flags.get("table");
+  const by = flags.get("by");
+  const rawTop = flags.get("top");
+  const named = [
+    ["--count-by", countBy],
+    ["--sum", sum],
+    ["--table", table]
+  ].filter(([, value]) => value !== undefined);
+  if (named.length > 1) {
+    throw new CliArgumentError(`${named.map(([flag]) => flag).join(" and ")} ask for different shapes — pass one`);
+  }
+  let top;
+  if (rawTop !== undefined) {
+    top = Number(rawTop);
+    if (!Number.isInteger(top) || top <= 0) {
+      throw new CliArgumentError("--top must be a positive whole number");
+    }
+  }
+  if (table !== undefined) {
+    if (by !== undefined || top !== undefined) {
+      throw new CliArgumentError("--table lists records; it takes neither --by nor --top");
+    }
+    const fields = table.split(",").map((field) => field.trim()).filter(Boolean);
+    if (fields.length === 0)
+      throw new CliArgumentError("--table needs at least one field");
+    return { kind: "table", fields };
+  }
+  if (sum !== undefined) {
+    if (top !== undefined && by === undefined) {
+      throw new CliArgumentError("--top needs --by: a single sum has nothing to rank");
+    }
+    return {
+      kind: "sum",
+      field: sum,
+      ...by !== undefined && { by },
+      ...top !== undefined && { top }
+    };
+  }
+  if (countBy !== undefined) {
+    if (by !== undefined) {
+      throw new CliArgumentError("--count-by already names the grouping field; drop --by");
+    }
+    return { kind: "count", field: countBy, ...top !== undefined && { top } };
+  }
+  if (by !== undefined) {
+    if (top === undefined) {
+      throw new CliArgumentError("--by groups a view; pass --count-by, --sum or --top with it");
+    }
+    return { kind: "count", field: by, top };
+  }
+  throw new CliArgumentError("--top needs --by, --count-by or --sum to rank");
+}
 
 // src/tools/cli-command.ts
 function defineCliCommand(definition) {
@@ -633,6 +699,126 @@ function emitResult(result, writers, opts) {
   return codes[result.code] ?? 1;
 }
 
+// src/tools/cli-view.ts
+var ABSENT = "(absent)";
+function selectRecords(data) {
+  if (Array.isArray(data))
+    return data;
+  if (isRecord(data)) {
+    const arrays = Object.entries(data).filter(([, value]) => Array.isArray(value));
+    const only = arrays[0];
+    if (arrays.length === 1 && only && Array.isArray(only[1]))
+      return only[1];
+    if (arrays.length > 1) {
+      throw new CliArgumentError(`an aggregate needs one collection, but the result carries several: ${arrays.map(([key]) => key).join(", ")} — name the shape you want with jq instead`);
+    }
+  }
+  throw new CliArgumentError("an aggregate needs a collection; this result is not one");
+}
+function readField(record, path) {
+  let current = record;
+  for (const segment of path) {
+    if (!isRecord(current))
+      return;
+    current = current[segment];
+  }
+  return current;
+}
+function fieldPath(field) {
+  const path = field.split(".");
+  if (path.some((segment) => segment.length === 0 || isUnsafeKey(segment))) {
+    throw new CliArgumentError(`"${field}" is not a readable field path`);
+  }
+  return path;
+}
+function availableFields(records) {
+  const keys = new Set;
+  for (const record of records) {
+    if (isRecord(record))
+      for (const key of Object.keys(record))
+        keys.add(key);
+  }
+  return [...keys].sort();
+}
+function assertFieldPresent(records, field) {
+  const path = fieldPath(field);
+  const present = records.some((record) => readField(record, path) !== undefined);
+  if (!present) {
+    const available = availableFields(records);
+    throw new CliArgumentError(`no record carries the field "${field}"${available.length > 0 ? ` — available: ${available.join(", ")}` : ""}`);
+  }
+  return path;
+}
+function groupKey(value) {
+  if (value === undefined)
+    return ABSENT;
+  if (value === null)
+    return "null";
+  if (typeof value === "object")
+    return JSON.stringify(value);
+  return String(value);
+}
+function ordered(totals, top) {
+  const entries = [...totals].sort(([leftKey, left], [rightKey, right]) => right === left ? leftKey.localeCompare(rightKey) : right - left);
+  const sliced = top === undefined ? entries : entries.slice(0, top);
+  return Object.fromEntries(sliced);
+}
+function numericValue(value, field) {
+  if (value === undefined || value === null)
+    return;
+  if (typeof value === "number" && Number.isFinite(value))
+    return value;
+  if (typeof value === "bigint")
+    return Number(value);
+  throw new CliArgumentError(`--sum ${field}: "${groupKey(value)}" is not a number`);
+}
+function renderTable(records, fields) {
+  const paths = fields.map((field) => assertFieldPresent(records, field));
+  const cell = (value) => {
+    if (value === undefined)
+      return "";
+    if (value === null)
+      return "null";
+    if (typeof value === "object")
+      return JSON.stringify(value);
+    return String(value);
+  };
+  const rows = records.map((record) => paths.map((path) => cell(readField(record, path))));
+  const widths = fields.map((field, column) => Math.max(field.length, ...rows.map((row) => row[column]?.length ?? 0)));
+  const line = (cells) => cells.map((value, column) => value.padEnd(widths[column] ?? value.length)).join("  ").trimEnd();
+  return `${[line(fields), line(widths.map((width) => "-".repeat(width))), ...rows.map(line)].join(`
+`)}
+`;
+}
+function renderCliView(data, view) {
+  const records = selectRecords(data);
+  if (view.kind === "table")
+    return { kind: "text", text: renderTable(records, view.fields) };
+  if (view.kind === "count") {
+    const path2 = assertFieldPresent(records, view.field);
+    const totals2 = new Map;
+    for (const record of records) {
+      const key = groupKey(readField(record, path2));
+      totals2.set(key, (totals2.get(key) ?? 0) + 1);
+    }
+    return { kind: "json", data: ordered(totals2, view.top) };
+  }
+  const path = assertFieldPresent(records, view.field);
+  if (view.by === undefined) {
+    let total = 0;
+    for (const record of records)
+      total += numericValue(readField(record, path), view.field) ?? 0;
+    return { kind: "json", data: total };
+  }
+  const byPath = assertFieldPresent(records, view.by);
+  const totals = new Map;
+  for (const record of records) {
+    const key = groupKey(readField(record, byPath));
+    totals.set(key, (totals.get(key) ?? 0) + (numericValue(readField(record, path), view.field) ?? 0));
+  }
+  return { kind: "json", data: ordered(totals, view.top) };
+}
+
 // src/tools/wait-core.ts
 var DEFAULT_BACKOFF = [2, 3, 5, 5, 8, 10];
 var DEFAULT_TIMEOUT = 600;
@@ -1181,7 +1367,11 @@ var GLOBAL_OPTIONS = [
   ["--output-dir <dir>", "Download result media into a directory"],
   ["--quiet", "Suppress non-essential stderr output"],
   ["--dry-run", "Print the resolved call without executing it"],
-  ["--help, -h", "Show help for a command"]
+  ["--help, -h", "Show help for a command"],
+  ["--count-by <field>", "Count records per distinct value of a field"],
+  ["--sum <field>", "Total a numeric field, optionally grouped by --by"],
+  ["--top <n> --by <f>", "Keep only the n largest groups"],
+  ["--table <a,b>", "Render the named fields as an aligned table"]
 ];
 async function readPipedStdin() {
   if (process.stdin.isTTY)
@@ -1708,6 +1898,23 @@ async function createCli(config) {
   if (options.outputDir && result.ok && config.download) {
     downloadsOk = await downloadResults(config.download(result.data), options.outputDir, stderr, options.quiet, config.allowPrivateDownloadHosts ?? false, config.maxDownloadBytes ?? DEFAULT_DOWNLOAD_MAX_BYTES, config.downloadTimeoutMs);
   }
+  if (options.view && result.ok) {
+    let viewed;
+    try {
+      viewed = renderCliView(result.data, options.view);
+    } catch (error) {
+      if (!(error instanceof CliArgumentError))
+        throw error;
+      stderr(`${error.message}
+`);
+      return exit(2);
+    }
+    if (viewed.kind === "text") {
+      stdout(viewed.text);
+      return exit(downloadsOk ? 0 : 1);
+    }
+    result = { ...result, data: viewed.data };
+  }
   const exitCode = emitResult(result, { stdout, stderr }, {
     json: options.json,
     toolName: command,
@@ -1717,4 +1924,4 @@ async function createCli(config) {
   return exit(downloadsOk ? exitCode : 1);
 }
 
-export { WaitTimeoutError, runWaitOperation, fetchGuarded, fetchPinnedDocument, readCapped, parseCliArgs, defineCliCommand, DEFAULT_EXIT_CODES, emitResult, pollUntilDone, createCli };
+export { WaitTimeoutError, runWaitOperation, fetchGuarded, fetchPinnedDocument, readCapped, routeCliArgv, CliArgumentError, parseCliArgs, extractCliGlobalOptions, defineCliCommand, DEFAULT_EXIT_CODES, emitResult, renderCliView, pollUntilDone, createCli };

package/dist/testing.js

@@ -48,7 +48,7 @@ import {
   mcpProjectionCandidate,
   prepareProjectedMcpTools,
   projectToolSurface
-} from "./index-r159gjwy.js";
+} from "./index-fenaekmk.js";
 import {
   toJsonSchema
 } from "./index-cby4ar3v.js";

package/dist/tool-invoker.js

@@ -1,8 +1,8 @@
 import {
   createToolInvoker
-} from "./index-79hb1wyh.js";
-import"./index-2hrfpw2c.js";
-import"./index-44ht2790.js";
+} from "./index-7t0wq6j5.js";
+import"./index-32vjke6q.js";
+import"./index-vcnfwrtr.js";
 import"./index-vsbzgd7b.js";
 import"./index-f9mb610r.js";
 import"./index-2hryh65w.js";
@@ -12,7 +12,7 @@ import"./index-scs3f1eg.js";
 import"./index-zcgf3gqf.js";
 import"./index-7zbps32p.js";
 import"./index-kzfs85xp.js";
-import"./index-r159gjwy.js";
+import"./index-fenaekmk.js";
 import"./index-cby4ar3v.js";
 import"./index-77fekveh.js";
 export {

package/dist/tools/cli-args.d.ts

@@ -18,6 +18,26 @@
  * call does (ADR 0014 parity).
  */
 import { z } from 'zod';
+/**
+ * A requested aggregate view over the result.
+ *
+ * `--by` always names the grouping field, in every form it appears in, so the
+ * grammar has one meaning rather than two: `--top 5 --by status` is the five
+ * largest groups of `status`, exactly as `--count-by status --top 5` is.
+ */
+export type CliResultView = {
+    kind: 'count';
+    field: string;
+    top?: number;
+} | {
+    kind: 'sum';
+    field: string;
+    by?: string;
+    top?: number;
+} | {
+    kind: 'table';
+    fields: readonly string[];
+};
 /** CLI-behaviour flags, parsed out of argv before the tool arguments. */
 export interface CliRunOptions {
     /** `--json` — emit compact success/error JSON records for scripts. */
@@ -34,6 +54,8 @@ export interface CliRunOptions {
     dryRun: boolean;
     /** `--help` / `-h` — print usage for the command. */
     help: boolean;
+    /** `--count-by` / `--sum` / `--top` / `--table` — aggregate instead of the collection. */
+    view?: CliResultView;
 }
 export interface ParsedCliArgs {
     /** The flat tool-argument object handed to `executeToolMethod`. */

package/dist/tools/cli-args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-args.d.ts","sourceRoot":"","sources":["../../src/tools/cli-args.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,yEAAyE;AACzE,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,IAAI,EAAE,OAAO,CAAC;IACd,iEAAiE;IACjE,IAAI,EAAE,OAAO,CAAC;IACd,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wEAAwE;IACxE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,KAAK,EAAE,OAAO,CAAC;IACf,qEAAqE;IACrE,MAAM,EAAE,OAAO,CAAC;IAChB,qDAAqD;IACrD,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,+BAA+B;IAC/B,OAAO,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,KAAK,SAAS,GACV,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,QAAQ,GACR,MAAM,GACN,OAAO,GACP,QAAQ,GACR,OAAO,CAAC;AAEZ,UAAU,SAAS;IACjB,IAAI,EAAE,SAAS,CAAC;IAChB,uEAAuE;IACvE,WAAW,CAAC,EAAE,SAAS,CAAC;CACzB;AAOD,eAAO,MAAM,oBAAoB,aAA+C,CAAC;AA0BjF;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,YAAY,CAsFlF;AAED,qBAAa,gBAAiB,SAAQ,KAAK;IAChC,IAAI,SAAsB;CACpC;AAuED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,SAAS,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CAI1F;AA8FD;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EAAE,EACd,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,SAAS,EAC7B,MAAM,GAAE;IACN,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,aAAa,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5B,GACL,aAAa,CA+Nf;AAED,iFAAiF;AACjF,MAAM,WAAW,qBAAqB;IACpC,0EAA0E;IAC1E,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,wEAAwE;IACxE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,MAAM,EAAE,CAAC,CAAC,SAAS,GAAG,SAAS,GAC9B,qBAAqB,CA8CvB"}
+{"version":3,"file":"cli-args.d.ts","sourceRoot":"","sources":["../../src/tools/cli-args.ts"],"names":[],"mappings":"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"}

package/dist/tools/cli-installer.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Generate the one-line installer, from the manifest, on the server.
+ *
+ * A `curl … | sh` runs on a machine where nothing is installed yet — including
+ * `jq`. An installer that fetches the manifest and parses it therefore fails on
+ * exactly the machines it exists for. Generating the script *from* the manifest,
+ * with the URL and the digest already substituted, removes the dependency: the
+ * script downloads one file, checks one digest and renames it into place.
+ */
+import type { CliBuildAsset, CliBuildManifest } from './cli-manifest.js';
+export interface CliInstallerConfig {
+    manifest: CliBuildManifest;
+    /** The asset this script installs — one script per target. */
+    asset: CliBuildAsset;
+    /** The name the binary takes on the PATH; defaults to the manifest name. */
+    binaryName?: string;
+    /** Default install directory; overridable by `INSTALL_DIR` at run time. */
+    installDir?: string;
+}
+/**
+ * Render the installer for one asset.
+ *
+ * The three properties that matter, in the script rather than in a comment:
+ * no JSON parsing, the digest is checked against the **decompressed** bytes, and
+ * the final step is a rename — an interrupted download leaves a temporary file,
+ * never a half-written executable on someone's PATH.
+ */
+export declare function renderCliInstaller(config: CliInstallerConfig): string;
+//# sourceMappingURL=cli-installer.d.ts.map

package/dist/tools/cli-installer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-installer.d.ts","sourceRoot":"","sources":["../../src/tools/cli-installer.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEtE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,8DAA8D;IAC9D,KAAK,EAAE,aAAa,CAAC;IACrB,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAOD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,CAuErE"}