agent-first-data 0.17.3 → 0.19.0

package/dist/format.js

@@ -2,10 +2,20 @@
  * AFDATA output formatting and protocol templates.
  *
  * Public APIs include protocol event builders, redactedValue (covers _secret
- * and _url fields), output formatters, redactUrlSecrets,
- * normalizeUtcOffset, isValidRfc3339Date, isValidRfc3339Time, isValidRfc3339, isValidBcp47,
- * RedactionPolicy, OutputStyle, and OutputOptions.
+ * and _url fields), redactUrlSecrets, normalizeUtcOffset, isValidRfc3339Date,
+ * isValidRfc3339Time, isValidRfc3339, isValidBcp47, RedactionPolicy,
+ * PlainStyle, and OutputOptions. The single render entry point (`render`)
+ * lives in cli.ts and calls this module's internal JSON/YAML/plain formatters.
+ *
+ * Number literal fidelity: decodeProtocolEvent parses with `lossless-json`
+ * instead of JSON.parse, so a number's exact source literal (arbitrary
+ * precision integers, high-precision floats, exponent forms, "-0") survives
+ * decode. Parsed numbers become LosslessNumber internally; every JSON/YAML
+ * rendering path here treats it as an opaque scalar leaf (never destructured
+ * as a plain object) and re-emits its exact literal text. This is internal —
+ * LosslessNumber is never part of the public JsonValue type or exports.
  */
+import { parse as losslessParse, stringify as losslessStringify, isLosslessNumber } from "lossless-json";
 // ═══════════════════════════════════════════
 // Event type: opaque branded wrapper
 // ═══════════════════════════════════════════
@@ -46,25 +56,17 @@ export class EventBuildError extends Error {
 export class JsonResultBuilder {
     payload;
     traceValue = {};
-    issues = [];
     constructor(payload) {
         this.payload = payload;
     }
     trace(value) {
         if (value !== undefined) {
-            if (!isObject(value)) {
-                this.issues.push("trace must be a JSON object");
-            }
-            else {
-                this.traceValue = value;
-            }
+            this.traceValue = value;
         }
         return this;
     }
+    /** Build the event. This builder cannot fail. */
     build() {
-        if (this.issues.length > 0) {
-            throw new EventBuildError(`Failed to build result event: ${this.issues.join("; ")}`, this.issues);
-        }
         const m = { kind: "result", result: this.payload, trace: this.traceValue };
         return new Event(m);
     }
@@ -178,25 +180,17 @@ export class JsonErrorBuilder {
 export class JsonProgressBuilder {
     payload;
     traceValue = {};
-    issues = [];
     constructor(payload) {
         this.payload = payload;
     }
     trace(value) {
         if (value !== undefined) {
-            if (!isObject(value)) {
-                this.issues.push("trace must be a JSON object");
-            }
-            else {
-                this.traceValue = value;
-            }
+            this.traceValue = value;
         }
         return this;
     }
+    /** Build the event. This builder cannot fail. */
     build() {
-        if (this.issues.length > 0) {
-            throw new EventBuildError(`Failed to build progress event: ${this.issues.join("; ")}`, this.issues);
-        }
         const m = { kind: "progress", progress: this.payload, trace: this.traceValue };
         return new Event(m);
     }
@@ -204,25 +198,17 @@ export class JsonProgressBuilder {
 export class JsonLogBuilder {
     payload;
     traceValue = {};
-    issues = [];
     constructor(payload) {
         this.payload = payload;
     }
     trace(value) {
         if (value !== undefined) {
-            if (!isObject(value)) {
-                this.issues.push("trace must be a JSON object");
-            }
-            else {
-                this.traceValue = value;
-            }
+            this.traceValue = value;
         }
         return this;
     }
+    /** Build the event. This builder cannot fail. */
     build() {
-        if (this.issues.length > 0) {
-            throw new EventBuildError(`Failed to build log event: ${this.issues.join("; ")}`, this.issues);
-        }
         const m = { kind: "log", log: this.payload, trace: this.traceValue };
         return new Event(m);
     }
@@ -343,7 +329,11 @@ const ERROR_RESERVED_FIELDS = new Set(["code", "message", "hint", "retryable"]);
 export function decodeProtocolEvent(text) {
     let parsed;
     try {
-        parsed = JSON.parse(text);
+        // lossless-json instead of JSON.parse: preserves each number's exact
+        // source literal (see module-level fidelity note) instead of collapsing
+        // it through float64. isSyntaxError-compatible: throws the same
+        // SyntaxError shape JSON.parse would.
+        parsed = losslessParse(text);
     }
     catch (e) {
         throw new EventDecodeError(`invalid JSON: ${e.message}`);
@@ -388,46 +378,71 @@ export function decodeProtocolEvent(text) {
     }
 }
 // ═══════════════════════════════════════════
-// Public API: Output Formatters
+// Internal: Output Formatters (called by render() in cli.ts)
 // ═══════════════════════════════════════════
+/** Which fields a redaction pass scrubs. The default is `All`. */
 export var RedactionPolicy;
 (function (RedactionPolicy) {
-    RedactionPolicy["RedactionTraceOnly"] = "RedactionTraceOnly";
-    RedactionPolicy["RedactionNone"] = "RedactionNone";
+    RedactionPolicy["All"] = "All";
+    RedactionPolicy["TraceOnly"] = "TraceOnly";
+    RedactionPolicy["Off"] = "Off";
 })(RedactionPolicy || (RedactionPolicy = {}));
-export var OutputStyle;
-(function (OutputStyle) {
-    OutputStyle["Readable"] = "Readable";
-    OutputStyle["Raw"] = "Raw";
-})(OutputStyle || (OutputStyle = {}));
+export var PlainStyle;
+(function (PlainStyle) {
+    PlainStyle["Readable"] = "Readable";
+    PlainStyle["Raw"] = "Raw";
+})(PlainStyle || (PlainStyle = {}));
 /** Convenience: build OutputOptions scoped to a RedactionPolicy. */
 export function outputOptionsForPolicy(policy) {
     return { redaction: { policy } };
 }
-/** Format as single-line JSON. Secrets redacted, original keys, raw values. */
-export function outputJson(value, options = {}) {
+/**
+ * Format as single-line JSON. Secrets redacted, original keys, raw values.
+ * Internal: called by `render` in cli.ts, which is the single public render
+ * entry point. Not re-exported from index.ts.
+ */
+export function formatJsonValue(value, options = {}) {
     const unwrapped = value instanceof Event ? value.toJSON() : value;
-    return JSON.stringify(redactedValue(unwrapped, options.redaction ?? {}));
+    return canonicalJsonString(redactedValue(unwrapped, options.redaction ?? {}));
+}
+/**
+ * Compact JSON serialization, byte-identical to `JSON.stringify(value)` for
+ * every value that contains no LosslessNumber, and additionally correct for
+ * values that do: `JSON.stringify` cannot serialize a LosslessNumber (it has
+ * no `toJSON` and isn't a boxed Number, so it would fall back to serializing
+ * its internal `{value, isLosslessNumber}` fields as if they were user data).
+ * lossless-json's `stringify` recognizes LosslessNumber and re-emits its
+ * exact literal text unquoted, and matches native JSON.stringify's escaping
+ * and formatting for everything else.
+ */
+function canonicalJsonString(value) {
+    return losslessStringify(value) ?? "null";
 }
-/** Format as multi-line YAML. Keys stripped, values formatted, secrets redacted. */
-export function outputYaml(value, options = {}) {
+/**
+ * Format as multi-line YAML. Structure-preserving: like JSON, original keys,
+ * scalar types, and numeric semantics are kept after redaction; secrets are
+ * still redacted. `options.style` is ignored — YAML output does not vary by
+ * PlainStyle.
+ * Internal: called by `render` in cli.ts, which is the single public render
+ * entry point. Not re-exported from index.ts.
+ */
+export function formatYamlValue(value, options = {}) {
     const unwrapped = value instanceof Event ? value.toJSON() : value;
     const redacted = redactedValue(unwrapped, options.redaction ?? {});
     const lines = ["---"];
-    if (options.style === OutputStyle.Raw) {
-        renderYamlRaw(redacted, 0, lines);
-    }
-    else {
-        renderYamlProcessed(redacted, 0, lines);
-    }
+    renderYamlRaw(redacted, 0, lines);
     return lines.join("\n");
 }
-/** Format as single-line logfmt. Keys stripped, values formatted, secrets redacted. */
-export function outputPlain(value, options = {}) {
+/**
+ * Format as single-line logfmt. Keys stripped, values formatted, secrets redacted.
+ * Internal: called by `render` in cli.ts, which is the single public render
+ * entry point. Not re-exported from index.ts.
+ */
+export function formatPlainValue(value, options = {}) {
     const unwrapped = value instanceof Event ? value.toJSON() : value;
     const redacted = redactedValue(unwrapped, options.redaction ?? {});
     const pairs = [];
-    if (options.style === OutputStyle.Raw) {
+    if (options.style === PlainStyle.Raw) {
         collectPlainPairsRaw(redacted, "", pairs);
     }
     else {
@@ -668,15 +683,15 @@ function applyRedactionOptions(value, redactionOptions) {
 }
 function applyRedactionPolicyWithContext(value, redactionPolicy, context) {
     switch (redactionPolicy) {
-        case RedactionPolicy.RedactionTraceOnly:
+        case RedactionPolicy.TraceOnly:
             if (isObject(value) && value.trace !== undefined) {
                 redactSecrets(value.trace, context);
             }
             break;
-        case RedactionPolicy.RedactionNone:
+        case RedactionPolicy.Off:
             break;
         default:
-            // Empty/unknown policy falls back to default full redaction.
+            // undefined or RedactionPolicy.All = full redaction (default).
             redactSecrets(value, context);
             break;
     }
@@ -876,6 +891,10 @@ function decimalIntText(value) {
         return value;
     if (isInt(value))
         return String(value);
+    if (isLosslessNumber(value)) {
+        const text = value.toString();
+        return /^-?\d+$/.test(text) ? text : null;
+    }
     return null;
 }
 function epochNsToMs(value) {
@@ -902,11 +921,24 @@ function isNum(value) {
 }
 function tryProcessField(key, value) {
     let stripped;
+    // Plain-format suffix processing below does real arithmetic (division,
+    // modulo, Math.floor/abs) that only works on a native JS number. A decoded
+    // LosslessNumber is normalized to one here via Number() \u2014 which never
+    // throws, unlike LosslessNumber's own valueOf() (documented to throw for
+    // values it can't safely represent as number/bigint) \u2014 so an ordinary
+    // decoded value (e.g. duration_ms: 42) keeps formatting exactly as before,
+    // and an exotic decoded value degrades gracefully (loses precision here,
+    // same as it always would for a >2^53 native number) rather than crashing.
+    // This is Plain's documented lossy/human path; JSON/YAML stay exact via
+    // yamlScalar/plainScalar/canonicalJsonString, and decimalIntText below
+    // (msats/sats/epoch_ns) keeps exactness by reading `value` directly instead
+    // of `numeric`.
+    const numeric = isLosslessNumber(value) ? Number(value.toString()) : value;
     // Group 1: compound timestamp suffixes
     stripped = stripSuffixCI(key, "_epoch_ms");
     if (stripped !== null) {
-        if (isInt(value)) {
-            const formatted = formatRfc3339Ms(value);
+        if (isInt(numeric)) {
+            const formatted = formatRfc3339Ms(numeric);
             if (formatted !== null)
                 return [stripped, formatted];
         }
@@ -914,8 +946,8 @@ function tryProcessField(key, value) {
     }
     stripped = stripSuffixCI(key, "_epoch_s");
     if (stripped !== null) {
-        if (isInt(value)) {
-            const formatted = formatRfc3339Ms(value * 1000);
+        if (isInt(numeric)) {
+            const formatted = formatRfc3339Ms(numeric * 1000);
             if (formatted !== null)
                 return [stripped, formatted];
         }
@@ -934,28 +966,28 @@ function tryProcessField(key, value) {
     // Group 2: compound currency suffixes
     stripped = stripSuffixCI(key, "_usd_cents");
     if (stripped !== null) {
-        if (isInt(value) && value >= 0)
-            return [stripped, `$${Math.floor(value / 100)}.${String(value % 100).padStart(2, "0")}`];
+        if (isInt(numeric) && numeric >= 0)
+            return [stripped, `$${Math.floor(numeric / 100)}.${String(numeric % 100).padStart(2, "0")}`];
         return null;
     }
     stripped = stripSuffixCI(key, "_eur_cents");
     if (stripped !== null) {
-        if (isInt(value) && value >= 0)
-            return [stripped, `\u20ac${Math.floor(value / 100)}.${String(value % 100).padStart(2, "0")}`];
+        if (isInt(numeric) && numeric >= 0)
+            return [stripped, `\u20ac${Math.floor(numeric / 100)}.${String(numeric % 100).padStart(2, "0")}`];
         return null;
     }
     const gc = tryStripGenericCents(key);
     if (gc !== null) {
         const [gcStripped, code] = gc;
-        if (isInt(value) && value >= 0)
-            return [gcStripped, `${Math.floor(value / 100)}.${String(value % 100).padStart(2, "0")} ${code.toUpperCase()}`];
+        if (isInt(numeric) && numeric >= 0)
+            return [gcStripped, `${Math.floor(numeric / 100)}.${String(numeric % 100).padStart(2, "0")} ${code.toUpperCase()}`];
         return null;
     }
     const gm = tryStripGenericMicro(key);
     if (gm !== null) {
         const [gmStripped, code] = gm;
-        if (isInt(value) && value >= 0)
-            return [gmStripped, `${Math.floor(value / 1_000_000)}.${String(value % 1_000_000).padStart(6, "0")} ${code.toUpperCase()}`];
+        if (isInt(numeric) && numeric >= 0)
+            return [gmStripped, `${Math.floor(numeric / 1_000_000)}.${String(numeric % 1_000_000).padStart(6, "0")} ${code.toUpperCase()}`];
         return null;
     }
     // Group 3: multi-char suffixes
@@ -967,20 +999,20 @@ function tryProcessField(key, value) {
     }
     stripped = stripSuffixCI(key, "_minutes");
     if (stripped !== null) {
-        if (isNum(value))
-            return [stripped, `${plainScalar(value)} minutes`];
+        if (isNum(numeric))
+            return [stripped, `${plainScalar(numeric)} minutes`];
         return null;
     }
     stripped = stripSuffixCI(key, "_hours");
     if (stripped !== null) {
-        if (isNum(value))
-            return [stripped, `${plainScalar(value)} hours`];
+        if (isNum(numeric))
+            return [stripped, `${plainScalar(numeric)} hours`];
         return null;
     }
     stripped = stripSuffixCI(key, "_days");
     if (stripped !== null) {
-        if (isNum(value))
-            return [stripped, `${plainScalar(value)} days`];
+        if (isNum(numeric))
+            return [stripped, `${plainScalar(numeric)} days`];
         return null;
     }
     // Group 4: single-unit suffixes
@@ -1000,46 +1032,46 @@ function tryProcessField(key, value) {
     }
     stripped = stripSuffixCI(key, "_bytes");
     if (stripped !== null) {
-        if (isInt(value) && value >= 0)
-            return [stripped, formatBytesHuman(value)];
+        if (isInt(numeric) && numeric >= 0)
+            return [stripped, formatBytesHuman(numeric)];
         return null;
     }
     stripped = stripSuffixCI(key, "_percent");
     if (stripped !== null) {
-        if (isNum(value))
-            return [stripped, `${plainScalar(value)}%`];
+        if (isNum(numeric))
+            return [stripped, `${plainScalar(numeric)}%`];
         return null;
     }
     // Group 5: short suffixes (last to avoid false positives)
     stripped = stripSuffixCI(key, "_jpy");
     if (stripped !== null) {
-        if (isInt(value) && value >= 0)
-            return [stripped, `\u00a5${formatWithCommas(value)}`];
+        if (isInt(numeric) && numeric >= 0)
+            return [stripped, `\u00a5${formatWithCommas(numeric)}`];
         return null;
     }
     stripped = stripSuffixCI(key, "_ns");
     if (stripped !== null) {
-        if (isNum(value))
-            return [stripped, `${plainScalar(value)}ns`];
+        if (isNum(numeric))
+            return [stripped, `${plainScalar(numeric)}ns`];
         return null;
     }
     stripped = stripSuffixCI(key, "_us");
     if (stripped !== null) {
-        if (isNum(value))
-            return [stripped, `${plainScalar(value)}\u03bcs`];
+        if (isNum(numeric))
+            return [stripped, `${plainScalar(numeric)}\u03bcs`];
         return null;
     }
     stripped = stripSuffixCI(key, "_ms");
     if (stripped !== null) {
-        const fv = formatMsValue(value);
+        const fv = formatMsValue(numeric);
         if (fv !== null)
             return [stripped, fv];
         return null;
     }
     stripped = stripSuffixCI(key, "_s");
     if (stripped !== null) {
-        if (isNum(value))
-            return [stripped, `${plainScalar(value)}s`];
+        if (isNum(numeric))
+            return [stripped, `${plainScalar(numeric)}s`];
         return null;
     }
     return null;
@@ -1184,47 +1216,6 @@ function extractCurrencyCodeFromStem(stem) {
 // ═══════════════════════════════════════════
 // YAML Rendering
 // ═══════════════════════════════════════════
-function renderYamlProcessed(value, indent, lines) {
-    const prefix = "  ".repeat(indent);
-    if (!isObject(value)) {
-        lines.push(`${prefix}${yamlScalar(value)}`);
-        return;
-    }
-    for (const pf of processObjectFields(value)) {
-        if (pf.formatted !== null) {
-            lines.push(`${prefix}${yamlKey(pf.key)}: "${escapeYamlStr(pf.formatted)}"`);
-        }
-        else if (isObject(pf.value)) {
-            if (Object.keys(pf.value).length > 0) {
-                lines.push(`${prefix}${yamlKey(pf.key)}:`);
-                renderYamlProcessed(pf.value, indent + 1, lines);
-            }
-            else {
-                lines.push(`${prefix}${yamlKey(pf.key)}: {}`);
-            }
-        }
-        else if (Array.isArray(pf.value)) {
-            if (pf.value.length === 0) {
-                lines.push(`${prefix}${yamlKey(pf.key)}: []`);
-            }
-            else {
-                lines.push(`${prefix}${yamlKey(pf.key)}:`);
-                for (const item of pf.value) {
-                    if (isObject(item)) {
-                        lines.push(`${prefix}  -`);
-                        renderYamlProcessed(item, indent + 2, lines);
-                    }
-                    else {
-                        lines.push(`${prefix}  - ${yamlScalar(item)}`);
-                    }
-                }
-            }
-        }
-        else {
-            lines.push(`${prefix}${yamlKey(pf.key)}: ${yamlScalar(pf.value)}`);
-        }
-    }
-}
 function renderYamlRaw(value, indent, lines) {
     const prefix = "  ".repeat(indent);
     if (isObject(value)) {
@@ -1310,7 +1301,11 @@ function yamlScalar(value) {
         return value.toString();
     if (typeof value === "number")
         return value.toString();
-    return `"${escapeYamlStr(JSON.stringify(sortJsonValue(value)))}"`;
+    // Decoded number: emit the exact source literal unquoted, matching JSON's
+    // structure-preserving fidelity contract for YAML too.
+    if (isLosslessNumber(value))
+        return value.toString();
+    return `"${escapeYamlStr(canonicalJsonString(sortJsonValue(value)))}"`;
 }
 // ═══════════════════════════════════════════
 // Plain Rendering (logfmt)
@@ -1366,11 +1361,16 @@ function plainScalar(value) {
         return value.toString();
     if (typeof value === "number")
         return value.toString();
-    return JSON.stringify(sortJsonValue(value));
+    // Decoded number: emit the exact source literal (Plain is documented lossy
+    // for arithmetic-derived formatting, but a bare pass-through scalar still
+    // gets its exact digits, not a mangled float64 round-trip).
+    if (isLosslessNumber(value))
+        return value.toString();
+    return canonicalJsonString(sortJsonValue(value));
 }
 function plainScalarRaw(value) {
     if (isObject(value) || Array.isArray(value)) {
-        return JSON.stringify(sortJsonValue(value));
+        return canonicalJsonString(sortJsonValue(value));
     }
     return plainScalar(value);
 }
@@ -1417,6 +1417,11 @@ function sanitizeForJson(value, stack = new WeakSet(), depth = 0) {
         return "<unsupported:function>";
     if (t === "symbol")
         return "<unsupported:symbol>";
+    // A LosslessNumber (from decodeProtocolEvent) is typeof "object" but must
+    // stay opaque: the generic object branch below would otherwise flatten it
+    // into its internal {value, isLosslessNumber} fields via Object.entries.
+    if (isLosslessNumber(value))
+        return value;
     if (value instanceof Error)
         return value.message;
     if (value instanceof Date)
@@ -1444,7 +1449,13 @@ function sanitizeForJson(value, stack = new WeakSet(), depth = 0) {
     return "<unsupported:unknown>";
 }
 function isObject(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
+    // isLosslessNumber excludes decoded numbers: a LosslessNumber is
+    // typeof "object" but is an opaque scalar leaf, never a plain JSON object —
+    // every object-walking function below (redaction, YAML/plain rendering,
+    // sortJsonValue, validation) funnels through this check, so excluding it
+    // here is the single choke point that keeps LosslessNumber from being
+    // destructured into its internal {value, isLosslessNumber} fields.
+    return typeof value === "object" && value !== null && !Array.isArray(value) && !isLosslessNumber(value);
 }
 function sortedObjectKeys(obj) {
     return Object.keys(obj).sort(jcsCompare);

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 /**
  * Agent-First Data (AFDATA) — suffix-driven output formatting and protocol templates.
  */
-export { jsonResult, jsonError, jsonProgress, jsonLog, Event, EventBuildError, JsonResultBuilder, JsonErrorBuilder, JsonProgressBuilder, JsonLogBuilder, type LogLevel, validateProtocolEvent, validateProtocolStream, decodeProtocolEvent, type DecodedEvent, type DecodedResult, type DecodedError, type DecodedProgress, type DecodedLog, EventDecodeError, type JsonValue, RedactionPolicy, OutputStyle, type OutputOptions, outputOptionsForPolicy, outputJson, outputYaml, outputPlain, redactedValue, redactUrlSecrets, normalizeUtcOffset, isValidRfc3339Date, isValidRfc3339Time, isValidRfc3339, isValidBcp47, } from "./format.js";
-export { type OutputFormat, type CliEventWriter, CliEmitter, LogFilters, cliParseOutput, cliParseLogFilters, cliOutput, buildCliError, buildCliVersion, cliRenderVersion, cliHandleVersionOrContinue, } from "./cli.js";
+export { jsonResult, jsonError, jsonProgress, jsonLog, Event, EventBuildError, JsonResultBuilder, JsonErrorBuilder, JsonProgressBuilder, JsonLogBuilder, type LogLevel, validateProtocolEvent, validateProtocolStream, decodeProtocolEvent, type DecodedEvent, type DecodedResult, type DecodedError, type DecodedProgress, type DecodedLog, EventDecodeError, type JsonValue, RedactionPolicy, PlainStyle, type OutputOptions, outputOptionsForPolicy, redactedValue, redactUrlSecrets, normalizeUtcOffset, isValidRfc3339Date, isValidRfc3339Time, isValidRfc3339, isValidBcp47, } from "./format.js";
+export { type OutputFormat, type OutputTo, type CliEventWriter, CliEmitter, LogFilters, cliParseOutput, parseOutputTo, cliParseLogFilters, render, buildCliError, buildCliVersion, cliRenderVersion, cliHandleVersionOrContinue, } from "./cli.js";

package/dist/index.js

@@ -1,5 +1,5 @@
 /**
  * Agent-First Data (AFDATA) — suffix-driven output formatting and protocol templates.
  */
-export { jsonResult, jsonError, jsonProgress, jsonLog, Event, EventBuildError, JsonResultBuilder, JsonErrorBuilder, JsonProgressBuilder, JsonLogBuilder, validateProtocolEvent, validateProtocolStream, decodeProtocolEvent, EventDecodeError, RedactionPolicy, OutputStyle, outputOptionsForPolicy, outputJson, outputYaml, outputPlain, redactedValue, redactUrlSecrets, normalizeUtcOffset, isValidRfc3339Date, isValidRfc3339Time, isValidRfc3339, isValidBcp47, } from "./format.js";
-export { CliEmitter, LogFilters, cliParseOutput, cliParseLogFilters, cliOutput, buildCliError, buildCliVersion, cliRenderVersion, cliHandleVersionOrContinue, } from "./cli.js";
+export { jsonResult, jsonError, jsonProgress, jsonLog, Event, EventBuildError, JsonResultBuilder, JsonErrorBuilder, JsonProgressBuilder, JsonLogBuilder, validateProtocolEvent, validateProtocolStream, decodeProtocolEvent, EventDecodeError, RedactionPolicy, PlainStyle, outputOptionsForPolicy, redactedValue, redactUrlSecrets, normalizeUtcOffset, isValidRfc3339Date, isValidRfc3339Time, isValidRfc3339, isValidBcp47, } from "./format.js";
+export { CliEmitter, LogFilters, cliParseOutput, parseOutputTo, cliParseLogFilters, render, buildCliError, buildCliVersion, cliRenderVersion, cliHandleVersionOrContinue, } from "./cli.js";

package/dist/skill.d.ts

@@ -6,7 +6,7 @@
  * supported coding agents (Codex, Claude Code, opencode, Hermes).
  *
  * The function performs the filesystem work and returns the protocol value (rendered by
- * the caller with `cliOutput`) or throws a {@link SkillError}. It never writes to
+ * the caller with `render`) or throws a {@link SkillError}. It never writes to
  * stdout/stderr itself.
  */
 /**
@@ -67,7 +67,7 @@ export interface SkillUninstallStatus {
 }
 /**
  * The result of a skill action. Read fields off the discriminated union (narrow on
- * `code`), or pass it to `cliOutput` to serialize — every field is already JSON-shaped.
+ * `code`), or pass it to `render` to serialize — every field is already JSON-shaped.
  */
 export type SkillReport = {
     code: "skill_status";
@@ -90,7 +90,7 @@ export type SkillReport = {
 };
 /**
  * Install, uninstall, or report status of `spec`'s skill across the selected agent
- * target(s). Returns the protocol value (caller renders with `cliOutput`) or throws a
+ * target(s). Returns the protocol value (caller renders with `render`) or throws a
  * {@link SkillError}. Does not touch stdout/stderr.
  */
 export declare function runSkillAdmin(spec: SkillSpec, action: SkillAction, options: SkillOptions): SkillReport;

package/dist/skill.js

@@ -6,7 +6,7 @@
  * supported coding agents (Codex, Claude Code, opencode, Hermes).
  *
  * The function performs the filesystem work and returns the protocol value (rendered by
- * the caller with `cliOutput`) or throws a {@link SkillError}. It never writes to
+ * the caller with `render`) or throws a {@link SkillError}. It never writes to
  * stdout/stderr itself.
  */
 import * as fs from "node:fs";
@@ -26,7 +26,7 @@ export class SkillError extends Error {
 }
 /**
  * Install, uninstall, or report status of `spec`'s skill across the selected agent
- * target(s). Returns the protocol value (caller renders with `cliOutput`) or throws a
+ * target(s). Returns the protocol value (caller renders with `render`) or throws a
  * {@link SkillError}. Does not touch stdout/stderr.
  */
 export function runSkillAdmin(spec, action, options) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agent-first-data",
-  "version": "0.17.3",
-  "description": "A naming convention that lets AI agents understand your data without being told what it means.",
+  "version": "0.19.0",
+  "description": "A naming convention that lets AI agents understand your data without being told what it means, plus a CLI and library for reading and safely editing structured JSON, TOML, YAML, dotenv, and INI documents.",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -38,5 +38,8 @@
     "@types/node": "^26.1.1",
     "tsx": "^4.23.1",
     "typescript": "^7.0.2"
+  },
+  "dependencies": {
+    "lossless-json": "^4.3.0"
   }
 }