@stigmer/cli 3.0.8

package/output/command-result.js

@@ -0,0 +1,134 @@
+// Structured command output. Instead of ad-hoc console writes, mutating
+// commands build a CommandResult (status + message + sections + hints), then a
+// renderer formats it for human, JSON, or quiet output. Mirrors the Go CLI's
+// pkg/clioutput.
+//
+// Stream discipline: JSON data goes to stdout (so pipes capture only the
+// payload); human and quiet status lines go to stderr.
+import { shouldColorize, styler } from "./style.js";
+/** A group of related fields/items under an optional title. */
+export class Section {
+    title;
+    fields = [];
+    items = [];
+    constructor(title) {
+        this.title = title;
+    }
+    field(key, value) {
+        this.fields.push({ key, value });
+        return this;
+    }
+    item(text) {
+        this.items.push(text);
+        return this;
+    }
+}
+/** The structured outcome of a command. Build via the static factories. */
+export class CommandResult {
+    status;
+    message;
+    sections = [];
+    hints = [];
+    constructor(status, message) {
+        this.status = status;
+        this.message = message;
+    }
+    static success(message) {
+        return new CommandResult("success", message);
+    }
+    static warning(message) {
+        return new CommandResult("warning", message);
+    }
+    static error(message) {
+        return new CommandResult("error", message);
+    }
+    addSection(title = "") {
+        const section = new Section(title);
+        this.sections.push(section);
+        return section;
+    }
+    hint(text) {
+        this.hints.push(text);
+        return this;
+    }
+}
+const ICONS = {
+    success: "✓",
+    warning: "⚠",
+    error: "✗",
+};
+/** JSON form of a CommandResult (omits empty sections/hints), newline-terminated. */
+export function resultToJson(result) {
+    const out = { status: result.status, message: result.message };
+    if (result.sections.length > 0) {
+        out.sections = result.sections.map((section) => {
+            const jsonSection = {};
+            if (section.title !== "")
+                jsonSection.title = section.title;
+            if (section.fields.length > 0) {
+                jsonSection.fields = section.fields.map((field) => ({ key: field.key, value: field.value }));
+            }
+            if (section.items.length > 0)
+                jsonSection.items = [...section.items];
+            return jsonSection;
+        });
+    }
+    if (result.hints.length > 0)
+        out.hints = [...result.hints];
+    return JSON.stringify(out, null, 2) + "\n";
+}
+/** Colored, structured human form, newline-terminated. */
+export function resultToHuman(result, colorize) {
+    const style = styler(colorize);
+    const lines = [statusLine(result, colorize)];
+    for (const section of result.sections) {
+        lines.push("");
+        if (section.title !== "")
+            lines.push(style.bold(`${section.title}:`));
+        if (section.fields.length > 0) {
+            const widestKey = Math.max(...section.fields.map((field) => field.key.length));
+            for (const field of section.fields) {
+                const padding = " ".repeat(widestKey - field.key.length + 4);
+                lines.push(`  ${style.dim(field.key)}${padding}${field.value}`);
+            }
+        }
+        for (const item of section.items)
+            lines.push(`  - ${item}`);
+    }
+    if (result.hints.length > 0) {
+        lines.push("");
+        for (const hint of result.hints)
+            lines.push(`  ${style.dim(hint)}`);
+    }
+    return lines.join("\n") + "\n";
+}
+/** Status line only — for scripting where pass/fail is all that matters. */
+export function resultToQuiet(result, colorize) {
+    return statusLine(result, colorize) + "\n";
+}
+function statusLine(result, colorize) {
+    const style = styler(colorize);
+    const text = `${ICONS[result.status]} ${result.message}`;
+    switch (result.status) {
+        case "success":
+            return style.green(text);
+        case "warning":
+            return style.yellow(text);
+        case "error":
+            return style.red(text);
+    }
+}
+const DEFAULT_STREAMS = { stdout: process.stdout, stderr: process.stderr };
+/** Render a CommandResult to the appropriate stream for the resolved format. */
+export function renderResult(result, format, streams = DEFAULT_STREAMS) {
+    if (format === "json") {
+        streams.stdout.write(resultToJson(result));
+        return;
+    }
+    if (format === "quiet") {
+        streams.stderr.write(resultToQuiet(result, shouldColorize(streams.stderr)));
+        return;
+    }
+    streams.stderr.write(resultToHuman(result, shouldColorize(streams.stderr)));
+}
+//# sourceMappingURL=command-result.js.map

package/output/command-result.js.map

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

package/output/confirm.d.ts

@@ -0,0 +1,22 @@
+export interface ConfirmOptions {
+    /** When true, skip the prompt and return true immediately (`--force`). */
+    readonly force?: boolean;
+    /** Input stream to read the answer from. Defaults to process.stdin. */
+    readonly input?: NodeJS.ReadStream;
+    /** Output stream the prompt is written to. Defaults to process.stderr. */
+    readonly output?: NodeJS.WritableStream;
+}
+/**
+ * Ask the user to confirm a destructive action. Returns true to proceed.
+ *
+ * Resolution order:
+ *   - `--force`            → true (no prompt)
+ *   - non-interactive TTY  → false (refuse rather than block a pipe/CI run)
+ *   - interactive          → true only for an explicit yes ("y"/"yes")
+ *
+ * The default-no posture matches the "[y/N]" prompt: anything that is not an
+ * affirmative answer aborts, which is the safe outcome for an irreversible
+ * operation.
+ */
+export declare function confirm(prompt: string, options?: ConfirmOptions): Promise<boolean>;
+//# sourceMappingURL=confirm.d.ts.map

package/output/confirm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm.d.ts","sourceRoot":"","sources":["../../src/output/confirm.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,cAAc;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,uEAAuE;IACvE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACnC,0EAA0E;IAC1E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;CACzC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,OAAO,CAAC,CAiB5F"}

package/output/confirm.js

@@ -0,0 +1,42 @@
+// Interactive yes/no confirmation for destructive commands. Mirrors the Go
+// CLI's clioutput.Confirmer: a `--force` flag (or a non-interactive stderr)
+// auto-confirms, so scripts, pipes, and CI never hang waiting on a TTY prompt.
+//
+// Lives in `output/` to match Go's pkg/clioutput placement — the prompt is part
+// of the human output contract (it writes to stderr, alongside warning panels),
+// not part of any resource's transport logic.
+import { createInterface } from "node:readline";
+/**
+ * Ask the user to confirm a destructive action. Returns true to proceed.
+ *
+ * Resolution order:
+ *   - `--force`            → true (no prompt)
+ *   - non-interactive TTY  → false (refuse rather than block a pipe/CI run)
+ *   - interactive          → true only for an explicit yes ("y"/"yes")
+ *
+ * The default-no posture matches the "[y/N]" prompt: anything that is not an
+ * affirmative answer aborts, which is the safe outcome for an irreversible
+ * operation.
+ */
+export async function confirm(prompt, options = {}) {
+    if (options.force === true)
+        return true;
+    const input = options.input ?? process.stdin;
+    const output = options.output ?? process.stderr;
+    // Without a TTY there is no one to answer; refuse rather than hang. Callers
+    // that need unattended deletes pass `--force`.
+    if (input.isTTY !== true)
+        return false;
+    const rl = createInterface({ input, output });
+    try {
+        const answer = await new Promise((resolve) => rl.question(`${prompt} `, resolve));
+        return isAffirmative(answer);
+    }
+    finally {
+        rl.close();
+    }
+}
+function isAffirmative(answer) {
+    return /^y(es)?$/i.test(answer.trim());
+}
+//# sourceMappingURL=confirm.js.map

package/output/confirm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirm.js","sourceRoot":"","sources":["../../src/output/confirm.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,4EAA4E;AAC5E,+EAA+E;AAC/E,EAAE;AACF,gFAAgF;AAChF,gFAAgF;AAChF,8CAA8C;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAWhD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,MAAc,EAAE,UAA0B,EAAE;IACxE,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAExC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC;IAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC;IAEhD,4EAA4E;IAC5E,+CAA+C;IAC/C,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAEvC,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE,CAAC,EAAE,CAAC,QAAQ,CAAC,GAAG,MAAM,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;QAC1F,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;YAAS,CAAC;QACT,EAAE,CAAC,KAAK,EAAE,CAAC;IACb,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,MAAc;IACnC,OAAO,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;AACzC,CAAC"}

package/output/format.d.ts

@@ -0,0 +1,22 @@
+/** Internal format the renderers consume, after class-aware resolution. */
+export type OutputFormat = "table" | "json" | "yaml" | "human" | "quiet" | "ndjson" | "inline";
+/** Output behavior class a command belongs to. */
+export type CommandClass = "read" | "mutating" | "streaming";
+/** Raw output-selection flags as parsed from the command line. */
+export interface OutputFlags {
+    readonly output?: string;
+    readonly json?: boolean;
+    readonly quiet?: boolean;
+}
+declare const UNIVERSAL_FORMATS: readonly ["table", "json", "yaml", "ndjson"];
+type UniversalFormat = (typeof UNIVERSAL_FORMATS)[number];
+/**
+ * Resolve the explicit/alias output flags into a single renderer format,
+ * honoring the command class's defaults and supported values. Throws a
+ * UsageError (exit code 2) on conflicting or unsupported selections.
+ */
+export declare function resolveFormat(flags: OutputFlags, commandClass: CommandClass): OutputFormat;
+/** The universal output values a given command class supports, for help/errors. */
+export declare function supportedFormats(commandClass: CommandClass): UniversalFormat[];
+export {};
+//# sourceMappingURL=format.d.ts.map

package/output/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/output/format.ts"],"names":[],"mappings":"AAsBA,2EAA2E;AAC3E,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE/F,kDAAkD;AAClD,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC;AAE7D,kEAAkE;AAClE,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,QAAA,MAAM,iBAAiB,8CAA+C,CAAC;AACvE,KAAK,eAAe,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAgB1D;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,GAAG,YAAY,CAkB1F;AAkBD,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,YAAY,GAAG,eAAe,EAAE,CAE9E"}

package/output/format.js

@@ -0,0 +1,72 @@
+// Unified output-format resolution.
+//
+// The Go CLI grew three inconsistent output conventions (D-CLI-2): reads used
+// `-o table|json|yaml`, mutations used `--json`/`--quiet`, and streaming used
+// `--json` for NDJSON. The TS CLI unifies the *surface* on a single
+// `-o/--output` flag with one universal vocabulary — table | json | yaml |
+// ndjson — and keeps `--json`/`--quiet` as back-compat aliases.
+//
+// The *meaning* of each universal value adapts to the command's class so a
+// single mental model ("json = machine-readable") works everywhere:
+//
+//   universal | read   | mutating | streaming
+//   ----------|--------|----------|----------
+//   table     | table  | human    | inline
+//   json      | json   | json     | ndjson
+//   yaml      | yaml   | —        | —
+//   ndjson    | —      | —        | ndjson
+//   --json    | json   | json     | ndjson
+//   --quiet   | —      | quiet    | —
+import { UsageError } from "../errors/usage-error.js";
+const UNIVERSAL_FORMATS = ["table", "json", "yaml", "ndjson"];
+// Maps the universal vocabulary onto each class's internal renderer format.
+// A missing entry means that universal value is not supported by the class.
+const CLASS_FORMAT_MAP = {
+    read: { table: "table", json: "json", yaml: "yaml" },
+    mutating: { table: "human", json: "json" },
+    streaming: { table: "inline", json: "ndjson", ndjson: "ndjson" },
+};
+const DEFAULT_FORMAT = {
+    read: "table",
+    mutating: "human",
+    streaming: "inline",
+};
+/**
+ * Resolve the explicit/alias output flags into a single renderer format,
+ * honoring the command class's defaults and supported values. Throws a
+ * UsageError (exit code 2) on conflicting or unsupported selections.
+ */
+export function resolveFormat(flags, commandClass) {
+    if (flags.json === true && flags.quiet === true) {
+        throw new UsageError("--json and --quiet cannot be used together");
+    }
+    if (flags.output !== undefined && flags.output !== "") {
+        return resolveExplicit(flags.output, commandClass);
+    }
+    if (flags.quiet === true) {
+        return "quiet";
+    }
+    if (flags.json === true) {
+        return CLASS_FORMAT_MAP[commandClass].json ?? "json";
+    }
+    return DEFAULT_FORMAT[commandClass];
+}
+function resolveExplicit(raw, commandClass) {
+    const value = raw.toLowerCase();
+    if (!isUniversalFormat(value)) {
+        throw new UsageError(`invalid --output value "${raw}" (expected one of: ${UNIVERSAL_FORMATS.join(", ")})`);
+    }
+    const mapped = CLASS_FORMAT_MAP[commandClass][value];
+    if (mapped === undefined) {
+        throw new UsageError(`--output ${value} is not supported by this command (supported: ${supportedFormats(commandClass).join(", ")})`);
+    }
+    return mapped;
+}
+/** The universal output values a given command class supports, for help/errors. */
+export function supportedFormats(commandClass) {
+    return UNIVERSAL_FORMATS.filter((value) => CLASS_FORMAT_MAP[commandClass][value] !== undefined);
+}
+function isUniversalFormat(value) {
+    return UNIVERSAL_FORMATS.includes(value);
+}
+//# sourceMappingURL=format.js.map

package/output/format.js.map

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

package/output/index.d.ts

@@ -0,0 +1,7 @@
+export { type CommandClass, type OutputFlags, type OutputFormat, resolveFormat, supportedFormats, } from "./format.js";
+export { protoToJsonValue, renderProtoJson, renderProtoListJson, renderProtoListYaml, renderProtoYaml, } from "./proto.js";
+export { renderEmpty, renderTable } from "./table.js";
+export { CommandResult, type KeyValue, renderResult, type ResultStatus, type ResultStreams, resultToHuman, resultToJson, resultToQuiet, Section, } from "./command-result.js";
+export { type NdjsonEvent, ndjsonLine, writeNdjson } from "./ndjson.js";
+export { shouldColorize, type Styler, styler } from "./style.js";
+//# sourceMappingURL=index.d.ts.map

package/output/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/output/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,aAAa,EACb,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EACL,aAAa,EACb,KAAK,QAAQ,EACb,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,aAAa,EACb,YAAY,EACZ,aAAa,EACb,OAAO,GACR,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,KAAK,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC"}

package/output/index.js

@@ -0,0 +1,8 @@
+// Public surface of the CLI output module.
+export { resolveFormat, supportedFormats, } from "./format.js";
+export { protoToJsonValue, renderProtoJson, renderProtoListJson, renderProtoListYaml, renderProtoYaml, } from "./proto.js";
+export { renderEmpty, renderTable } from "./table.js";
+export { CommandResult, renderResult, resultToHuman, resultToJson, resultToQuiet, Section, } from "./command-result.js";
+export { ndjsonLine, writeNdjson } from "./ndjson.js";
+export { shouldColorize, styler } from "./style.js";
+//# sourceMappingURL=index.js.map

package/output/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/output/index.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAE3C,OAAO,EAIL,aAAa,EACb,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EACL,aAAa,EAEb,YAAY,EAGZ,aAAa,EACb,YAAY,EACZ,aAAa,EACb,OAAO,GACR,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAoB,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,cAAc,EAAe,MAAM,EAAE,MAAM,YAAY,CAAC"}

package/output/ndjson.d.ts

@@ -0,0 +1,24 @@
+export interface NdjsonEvent {
+    readonly type: string;
+    readonly [key: string]: unknown;
+}
+/** The Go-parity envelope: a typed event with a timestamp and cleaned payload. */
+export interface NdjsonEnvelope extends NdjsonEvent {
+    readonly ts: string;
+    readonly payload: Record<string, unknown>;
+}
+/** Serialize a single NDJSON event (one compact JSON object + newline). */
+export declare function ndjsonLine(event: NdjsonEvent): string;
+/** Write a single NDJSON event to the given stream. */
+export declare function writeNdjson(out: {
+    write(chunk: string): unknown;
+}, event: NdjsonEvent): void;
+/**
+ * Build a `{type, ts, payload}` envelope, cleaning the payload exactly like Go's
+ * writeJSONEvent: drop `undefined`/`null` and empty-string fields, but keep
+ * `false` and `0`. `now` is injectable for deterministic tests.
+ */
+export declare function ndjsonEnvelope(type: string, payload: Record<string, unknown>, now?: () => string): NdjsonEnvelope;
+/** Drop nil and empty-string entries from a payload (booleans/numbers survive). */
+export declare function cleanNdjsonPayload(payload: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=ndjson.d.ts.map

package/output/ndjson.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ndjson.d.ts","sourceRoot":"","sources":["../../src/output/ndjson.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,kFAAkF;AAClF,MAAM,WAAW,cAAe,SAAQ,WAAW;IACjD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC3C;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAErD;AAED,uDAAuD;AACvD,wBAAgB,WAAW,CAAC,GAAG,EAAE;IAAE,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,EAAE,KAAK,EAAE,WAAW,GAAG,IAAI,CAE5F;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,GAAG,GAAE,MAAM,MAAyB,GACnC,cAAc,CAEhB;AAED,mFAAmF;AACnF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQ5F"}

package/output/ndjson.js

@@ -0,0 +1,38 @@
+// NDJSON envelope + writer for streaming commands (run/resume/draft).
+//
+// The wire shape mirrors the Go CLI's run --json output (run_stream_json.go):
+// every line is a `{type, ts, payload}` object, and the payload is cleaned of
+// nil/empty-string fields before encoding. This module owns the *formatting*;
+// the Event→{type, payload} mapping lives in resources/stream/render-ndjson.ts.
+/** Serialize a single NDJSON event (one compact JSON object + newline). */
+export function ndjsonLine(event) {
+    return JSON.stringify(event) + "\n";
+}
+/** Write a single NDJSON event to the given stream. */
+export function writeNdjson(out, event) {
+    out.write(ndjsonLine(event));
+}
+/**
+ * Build a `{type, ts, payload}` envelope, cleaning the payload exactly like Go's
+ * writeJSONEvent: drop `undefined`/`null` and empty-string fields, but keep
+ * `false` and `0`. `now` is injectable for deterministic tests.
+ */
+export function ndjsonEnvelope(type, payload, now = defaultTimestamp) {
+    return { type, ts: now(), payload: cleanNdjsonPayload(payload) };
+}
+/** Drop nil and empty-string entries from a payload (booleans/numbers survive). */
+export function cleanNdjsonPayload(payload) {
+    const out = {};
+    for (const [key, value] of Object.entries(payload)) {
+        if (value === undefined || value === null)
+            continue;
+        if (typeof value === "string" && value === "")
+            continue;
+        out[key] = value;
+    }
+    return out;
+}
+function defaultTimestamp() {
+    return new Date().toISOString();
+}
+//# sourceMappingURL=ndjson.js.map

package/output/ndjson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ndjson.js","sourceRoot":"","sources":["../../src/output/ndjson.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,EAAE;AACF,8EAA8E;AAC9E,8EAA8E;AAC9E,8EAA8E;AAC9E,gFAAgF;AAahF,2EAA2E;AAC3E,MAAM,UAAU,UAAU,CAAC,KAAkB;IAC3C,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC;AACtC,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,WAAW,CAAC,GAAsC,EAAE,KAAkB;IACpF,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;AAC/B,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,OAAgC,EAChC,MAAoB,gBAAgB;IAEpC,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;AACnE,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,kBAAkB,CAAC,OAAgC;IACjE,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QACpD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE;YAAE,SAAS;QACxD,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IACnB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,gBAAgB;IACvB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC"}

package/output/proto.d.ts

@@ -0,0 +1,12 @@
+import { type DescMessage, type JsonValue, type MessageShape } from "@bufbuild/protobuf";
+/** Proto -> protojson JsonValue (snake_case fields, omitted defaults). */
+export declare function protoToJsonValue<Desc extends DescMessage>(schema: Desc, message: MessageShape<Desc>): JsonValue;
+/** Render a single proto message as pretty JSON, newline-terminated. */
+export declare function renderProtoJson<Desc extends DescMessage>(schema: Desc, message: MessageShape<Desc>): string;
+/** Render a single proto message as YAML. */
+export declare function renderProtoYaml<Desc extends DescMessage>(schema: Desc, message: MessageShape<Desc>): string;
+/** Render a list of proto messages as a pretty JSON array, newline-terminated. */
+export declare function renderProtoListJson<Desc extends DescMessage>(schema: Desc, messages: readonly MessageShape<Desc>[]): string;
+/** Render a list of proto messages as a YAML array. */
+export declare function renderProtoListYaml<Desc extends DescMessage>(schema: Desc, messages: readonly MessageShape<Desc>[]): string;
+//# sourceMappingURL=proto.d.ts.map

package/output/proto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proto.d.ts","sourceRoot":"","sources":["../../src/output/proto.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAU,MAAM,oBAAoB,CAAC;AAKjG,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,WAAW,EACvD,MAAM,EAAE,IAAI,EACZ,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,GAC1B,SAAS,CAEX;AAED,wEAAwE;AACxE,wBAAgB,eAAe,CAAC,IAAI,SAAS,WAAW,EACtD,MAAM,EAAE,IAAI,EACZ,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,GAC1B,MAAM,CAER;AAED,6CAA6C;AAC7C,wBAAgB,eAAe,CAAC,IAAI,SAAS,WAAW,EACtD,MAAM,EAAE,IAAI,EACZ,OAAO,EAAE,YAAY,CAAC,IAAI,CAAC,GAC1B,MAAM,CAER;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,IAAI,SAAS,WAAW,EAC1D,MAAM,EAAE,IAAI,EACZ,QAAQ,EAAE,SAAS,YAAY,CAAC,IAAI,CAAC,EAAE,GACtC,MAAM,CAGR;AAED,uDAAuD;AACvD,wBAAgB,mBAAmB,CAAC,IAAI,SAAS,WAAW,EAC1D,MAAM,EAAE,IAAI,EACZ,QAAQ,EAAE,SAAS,YAAY,CAAC,IAAI,CAAC,EAAE,GACtC,MAAM,CAGR"}

package/output/proto.js

@@ -0,0 +1,34 @@
+// Canonical protobuf -> JSON/YAML rendering for read verbs.
+//
+// Parity contract (mirrors Go pkg/display/proto.go and mcp-server marshal.ts):
+// the Go CLI emits protojson with UseProtoNames=true and EmitUnpopulated=false,
+// 2-space indented. protobuf-es `toJson` with { useProtoFieldName: true }
+// reproduces that exactly — snake_case fields, omitted defaults, base64 bytes,
+// string enums, RFC-3339 timestamps — and the YAML path round-trips through the
+// same JSON value so field naming stays identical.
+import { toJson } from "@bufbuild/protobuf";
+import { stringify as toYaml } from "yaml";
+const JSON_WRITE_OPTIONS = { useProtoFieldName: true };
+/** Proto -> protojson JsonValue (snake_case fields, omitted defaults). */
+export function protoToJsonValue(schema, message) {
+    return toJson(schema, message, JSON_WRITE_OPTIONS);
+}
+/** Render a single proto message as pretty JSON, newline-terminated. */
+export function renderProtoJson(schema, message) {
+    return JSON.stringify(protoToJsonValue(schema, message), null, 2) + "\n";
+}
+/** Render a single proto message as YAML. */
+export function renderProtoYaml(schema, message) {
+    return toYaml(protoToJsonValue(schema, message));
+}
+/** Render a list of proto messages as a pretty JSON array, newline-terminated. */
+export function renderProtoListJson(schema, messages) {
+    const array = messages.map((message) => protoToJsonValue(schema, message));
+    return JSON.stringify(array, null, 2) + "\n";
+}
+/** Render a list of proto messages as a YAML array. */
+export function renderProtoListYaml(schema, messages) {
+    const array = messages.map((message) => protoToJsonValue(schema, message));
+    return toYaml(array);
+}
+//# sourceMappingURL=proto.js.map

package/output/proto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proto.js","sourceRoot":"","sources":["../../src/output/proto.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,EAAE;AACF,+EAA+E;AAC/E,gFAAgF;AAChF,0EAA0E;AAC1E,+EAA+E;AAC/E,gFAAgF;AAChF,mDAAmD;AAEnD,OAAO,EAAuD,MAAM,EAAE,MAAM,oBAAoB,CAAC;AACjG,OAAO,EAAE,SAAS,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAE3C,MAAM,kBAAkB,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAW,CAAC;AAEhE,0EAA0E;AAC1E,MAAM,UAAU,gBAAgB,CAC9B,MAAY,EACZ,OAA2B;IAE3B,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,kBAAkB,CAAC,CAAC;AACrD,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,eAAe,CAC7B,MAAY,EACZ,OAA2B;IAE3B,OAAO,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAC3E,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,eAAe,CAC7B,MAAY,EACZ,OAA2B;IAE3B,OAAO,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,mBAAmB,CACjC,MAAY,EACZ,QAAuC;IAEvC,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3E,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAC/C,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,mBAAmB,CACjC,MAAY,EACZ,QAAuC;IAEvC,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3E,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC"}

package/output/style.d.ts

@@ -0,0 +1,19 @@
+/** A styler whose methods either wrap text in ANSI codes or pass it through. */
+export interface Styler {
+    green(text: string): string;
+    yellow(text: string): string;
+    red(text: string): string;
+    cyan(text: string): string;
+    bold(text: string): string;
+    dim(text: string): string;
+}
+/** Pick a styler: colored only when explicitly enabled. */
+export declare function styler(colorize: boolean): Styler;
+/**
+ * Whether color should be enabled for a stream. Disabled when NO_COLOR is set
+ * (any value) or the stream is not an interactive TTY.
+ */
+export declare function shouldColorize(stream: {
+    isTTY?: boolean;
+}): boolean;
+//# sourceMappingURL=style.d.ts.map

package/output/style.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.d.ts","sourceRoot":"","sources":["../../src/output/style.ts"],"names":[],"mappings":"AAgBA,gFAAgF;AAChF,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC7B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAC3B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAC3B;AAoBD,2DAA2D;AAC3D,wBAAgB,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAEhD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAGnE"}

package/output/style.js

@@ -0,0 +1,44 @@
+// Minimal ANSI styling for human-facing output.
+//
+// Mirrors the Go CLI's reliance on fatih/color, which auto-disables when the
+// target stream is not a TTY and honors NO_COLOR. Keeping this tiny avoids a
+// dependency for what is a handful of escape codes.
+const ANSI = {
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+    faint: "\x1b[2m",
+    red: "\x1b[31m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    cyan: "\x1b[36m",
+};
+const PLAIN = {
+    green: (t) => t,
+    yellow: (t) => t,
+    red: (t) => t,
+    cyan: (t) => t,
+    bold: (t) => t,
+    dim: (t) => t,
+};
+const COLORED = {
+    green: (t) => `${ANSI.green}${ANSI.bold}${t}${ANSI.reset}`,
+    yellow: (t) => `${ANSI.yellow}${ANSI.bold}${t}${ANSI.reset}`,
+    red: (t) => `${ANSI.red}${ANSI.bold}${t}${ANSI.reset}`,
+    cyan: (t) => `${ANSI.cyan}${t}${ANSI.reset}`,
+    bold: (t) => `${ANSI.bold}${t}${ANSI.reset}`,
+    dim: (t) => `${ANSI.faint}${t}${ANSI.reset}`,
+};
+/** Pick a styler: colored only when explicitly enabled. */
+export function styler(colorize) {
+    return colorize ? COLORED : PLAIN;
+}
+/**
+ * Whether color should be enabled for a stream. Disabled when NO_COLOR is set
+ * (any value) or the stream is not an interactive TTY.
+ */
+export function shouldColorize(stream) {
+    if (process.env.NO_COLOR !== undefined && process.env.NO_COLOR !== "")
+        return false;
+    return stream.isTTY === true;
+}
+//# sourceMappingURL=style.js.map

package/output/style.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"style.js","sourceRoot":"","sources":["../../src/output/style.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,oDAAoD;AAEpD,MAAM,IAAI,GAAG;IACX,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,GAAG,EAAE,UAAU;IACf,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,IAAI,EAAE,UAAU;CACR,CAAC;AAYX,MAAM,KAAK,GAAW;IACpB,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACf,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACb,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACd,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACd,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;CACd,CAAC;AAEF,MAAM,OAAO,GAAW;IACtB,KAAK,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE;IAC1D,MAAM,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE;IAC5D,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE;IACtD,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE;IAC5C,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE;IAC5C,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE;CAC7C,CAAC;AAEF,2DAA2D;AAC3D,MAAM,UAAU,MAAM,CAAC,QAAiB;IACtC,OAAO,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAA2B;IACxD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACpF,OAAO,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC;AAC/B,CAAC"}

package/output/table.d.ts

@@ -0,0 +1,5 @@
+/** Render a table from headers and rows. Returns "" when there are no rows. */
+export declare function renderTable(headers: readonly string[], rows: readonly (readonly string[])[]): string;
+/** Standardized empty-state message for list commands. */
+export declare function renderEmpty(resourceName: string, query?: string): string;
+//# sourceMappingURL=table.d.ts.map

package/output/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/output/table.ts"],"names":[],"mappings":"AASA,+EAA+E;AAC/E,wBAAgB,WAAW,CACzB,OAAO,EAAE,SAAS,MAAM,EAAE,EAC1B,IAAI,EAAE,SAAS,CAAC,SAAS,MAAM,EAAE,CAAC,EAAE,GACnC,MAAM,CAyBR;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAMxE"}

package/output/table.js

@@ -0,0 +1,43 @@
+// Shared table renderer for list/collection views. Mirrors the column model of
+// the Go CLI's pkg/display table (dynamic widths, dash separator, 3-space gap).
+//
+// Wave 1 implements the non-adaptive path: columns size to their widest cell.
+// Terminal-width adaptation and ANSI-aware measurement can be layered on later
+// without changing the call sites.
+const COLUMN_GAP = "   ";
+/** Render a table from headers and rows. Returns "" when there are no rows. */
+export function renderTable(headers, rows) {
+    if (rows.length === 0)
+        return "";
+    const widths = headers.map((header, column) => {
+        let width = header.length;
+        for (const row of rows) {
+            const cell = row[column] ?? "";
+            if (cell.length > width)
+                width = cell.length;
+        }
+        return width;
+    });
+    const renderRow = (cells) => headers
+        .map((_, column) => padRight(cells[column] ?? "", widths[column]))
+        .join(COLUMN_GAP)
+        .replace(/ +$/, "");
+    const lines = [];
+    lines.push(renderRow(headers));
+    lines.push(widths.map((width) => "-".repeat(width)).join(COLUMN_GAP));
+    for (const row of rows) {
+        lines.push(renderRow(row));
+    }
+    return lines.join("\n") + "\n";
+}
+/** Standardized empty-state message for list commands. */
+export function renderEmpty(resourceName, query) {
+    const middle = query !== undefined && query !== ""
+        ? `No ${resourceName} found matching '${query}'`
+        : `No ${resourceName} found`;
+    return `\n${middle}\n\n`;
+}
+function padRight(text, width) {
+    return text + " ".repeat(Math.max(0, width - text.length));
+}
+//# sourceMappingURL=table.js.map

package/output/table.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.js","sourceRoot":"","sources":["../../src/output/table.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,gFAAgF;AAChF,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,mCAAmC;AAEnC,MAAM,UAAU,GAAG,KAAK,CAAC;AAEzB,+EAA+E;AAC/E,MAAM,UAAU,WAAW,CACzB,OAA0B,EAC1B,IAAoC;IAEpC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;QAC5C,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;QAC1B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC/B,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK;gBAAE,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC;QAC/C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,CAAC,KAAwB,EAAU,EAAE,CACrD,OAAO;SACJ,GAAG,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;SACjE,IAAI,CAAC,UAAU,CAAC;SAChB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAExB,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IACtE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACjC,CAAC;AAED,0DAA0D;AAC1D,MAAM,UAAU,WAAW,CAAC,YAAoB,EAAE,KAAc;IAC9D,MAAM,MAAM,GACV,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QACjC,CAAC,CAAC,MAAM,YAAY,oBAAoB,KAAK,GAAG;QAChD,CAAC,CAAC,MAAM,YAAY,QAAQ,CAAC;IACjC,OAAO,KAAK,MAAM,MAAM,CAAC;AAC3B,CAAC;AAED,SAAS,QAAQ,CAAC,IAAY,EAAE,KAAa;IAC3C,OAAO,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC;AAC7D,CAAC"}