@warlock.js/ai-cli 0.0.0-stage → 5.31.0

package/esm/stream/event-log.mjs

@@ -0,0 +1,52 @@
+//#region ../../packages/ai-cli/src/stream/event-log.ts
+/**
+* An append-only event log that any number of async iterators can read.
+* Each iterator starts at the first event and ends once the log is closed
+* and drained, so a late consumer still sees the whole session.
+*/
+var EventLog = class {
+	constructor() {
+		this.items = [];
+		this.closed = false;
+		this.waiters = [];
+	}
+	push(item) {
+		if (this.closed) return;
+		this.items.push(item);
+		this.wake();
+	}
+	close() {
+		this.closed = true;
+		this.wake();
+	}
+	get size() {
+		return this.items.length;
+	}
+	[Symbol.asyncIterator]() {
+		let index = 0;
+		return { next: async () => {
+			while (index >= this.items.length && !this.closed) await new Promise((resolve) => this.waiters.push(resolve));
+			if (index < this.items.length) {
+				const value = this.items[index];
+				index += 1;
+				return {
+					value,
+					done: false
+				};
+			}
+			return {
+				value: void 0,
+				done: true
+			};
+		} };
+	}
+	wake() {
+		const waiters = this.waiters;
+		this.waiters = [];
+		for (const waiter of waiters) waiter();
+	}
+};
+
+//#endregion
+export { EventLog };
+//# sourceMappingURL=event-log.mjs.map

package/esm/stream/event-log.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-log.mjs","names":[],"sources":["../../../../../../../../packages/ai-cli/src/stream/event-log.ts"],"sourcesContent":["/**\n * An append-only event log that any number of async iterators can read.\n * Each iterator starts at the first event and ends once the log is closed\n * and drained, so a late consumer still sees the whole session.\n */\nexport class EventLog<T> implements AsyncIterable<T> {\n  private readonly items: T[] = [];\n  private closed = false;\n  private waiters: Array<() => void> = [];\n\n  public push(item: T): void {\n    if (this.closed) {\n      return;\n    }\n\n    this.items.push(item);\n    this.wake();\n  }\n\n  public close(): void {\n    this.closed = true;\n    this.wake();\n  }\n\n  public get size(): number {\n    return this.items.length;\n  }\n\n  public [Symbol.asyncIterator](): AsyncIterator<T> {\n    let index = 0;\n\n    return {\n      next: async (): Promise<IteratorResult<T>> => {\n        while (index >= this.items.length && !this.closed) {\n          await new Promise<void>((resolve) => this.waiters.push(resolve));\n        }\n\n        if (index < this.items.length) {\n          const value = this.items[index] as T;\n\n          index += 1;\n\n          return { value, done: false };\n        }\n\n        return { value: undefined, done: true };\n      },\n    };\n  }\n\n  private wake(): void {\n    const waiters = this.waiters;\n\n    this.waiters = [];\n\n    for (const waiter of waiters) {\n      waiter();\n    }\n  }\n}\n"],"mappings":";;;;;;AAKA,IAAa,WAAb,MAAqD;;eACrB,CAAC;gBACd;iBACoB,CAAC;;CAEtC,AAAO,KAAK,MAAe;EACzB,IAAI,KAAK,QACP;EAGF,KAAK,MAAM,KAAK,IAAI;EACpB,KAAK,KAAK;CACZ;CAEA,AAAO,QAAc;EACnB,KAAK,SAAS;EACd,KAAK,KAAK;CACZ;CAEA,IAAW,OAAe;EACxB,OAAO,KAAK,MAAM;CACpB;CAEA,CAAQ,OAAO,iBAAmC;EAChD,IAAI,QAAQ;EAEZ,OAAO,EACL,MAAM,YAAwC;GAC5C,OAAO,SAAS,KAAK,MAAM,UAAU,CAAC,KAAK,QACzC,MAAM,IAAI,SAAe,YAAY,KAAK,QAAQ,KAAK,OAAO,CAAC;GAGjE,IAAI,QAAQ,KAAK,MAAM,QAAQ;IAC7B,MAAM,QAAQ,KAAK,MAAM;IAEzB,SAAS;IAET,OAAO;KAAE;KAAO,MAAM;IAAM;GAC9B;GAEA,OAAO;IAAE,OAAO;IAAW,MAAM;GAAK;EACxC,EACF;CACF;CAEA,AAAQ,OAAa;EACnB,MAAM,UAAU,KAAK;EAErB,KAAK,UAAU,CAAC;EAEhB,KAAK,MAAM,UAAU,SACnB,OAAO;CAEX;AACF"}

package/esm/stream/json-lines.d.mts

@@ -0,0 +1,33 @@
+import { CliParsedEvent } from "../contracts/events.type.mjs";
+import { CliStreamParser } from "../contracts/adapter.contract.mjs";
+//#region ../../packages/ai-cli/src/stream/json-lines.d.ts
+/** A plain JSON object. */
+type JsonRecord = Record<string, unknown>;
+/** `value` as a JSON object, or `undefined`. */
+declare function asRecord(value: unknown): JsonRecord | undefined;
+/** `value` as an array, or an empty array. */
+declare function asArray(value: unknown): unknown[];
+/** A string field, or `undefined`. */
+declare function stringField(record: JsonRecord | undefined, key: string): string | undefined;
+/** A finite number field, or `undefined`. */
+declare function numberField(record: JsonRecord | undefined, key: string): number | undefined;
+/** A nested object field, or `undefined`. */
+declare function recordField(record: JsonRecord | undefined, key: string): JsonRecord | undefined;
+/** Tool output as text: strings verbatim, text-block arrays joined, anything else as JSON. */
+declare function outputText(value: unknown): string;
+/** Parse one line as a JSON object; anything else (banners, blank lines) is `undefined`. */
+declare function parseJsonLine(line: string): JsonRecord | undefined;
+/**
+ * Build a parser for a JSONL/NDJSON stream. Non-JSON lines (progress
+ * banners, warnings) are skipped; each JSON object goes to `onRecord`.
+ * `onEnd` may flush buffered state when stdout closes.
+ *
+ * @example
+ * const parser = jsonLinesParser((record) =>
+ *   record.type === "text" ? [{ type: "message", text: String(record.text), delta: false }] : [],
+ * );
+ */
+declare function jsonLinesParser(onRecord: (record: JsonRecord) => CliParsedEvent[], onEnd?: () => CliParsedEvent[]): CliStreamParser;
+//#endregion
+export { JsonRecord, asArray, asRecord, jsonLinesParser, numberField, outputText, parseJsonLine, recordField, stringField };
+//# sourceMappingURL=json-lines.d.mts.map

package/esm/stream/json-lines.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-lines.d.mts","names":[],"sources":["../../../../../../../../packages/ai-cli/src/stream/json-lines.ts"],"mappings":";;;;KAGY,UAAA,GAAa,MAAM;;iBAGf,QAAA,CAAS,KAAA,YAAiB,UAAU;AAHpD;AAAA,iBAUgB,OAAA,CAAQ,KAAc;;iBAKtB,WAAA,CAAY,MAAA,EAAQ,UAAU,cAAc,GAAA;AAf7B;AAAA,iBAsBf,WAAA,CAAY,MAAA,EAAQ,UAAU,cAAc,GAAA;;iBAO5C,WAAA,CAAY,MAAA,EAAQ,UAAA,cAAwB,GAAA,WAAc,UAAU;;iBAKpE,UAAA,CAAW,KAAc;AAxBzC;AAAA,iBAgDgB,aAAA,CAAc,IAAA,WAAe,UAAU;;;AAhDjB;AAKtC;;;;;;;iBAmEgB,eAAA,CACd,QAAA,GAAW,MAAA,EAAQ,UAAA,KAAe,cAAA,IAClC,KAAA,SAAa,cAAA,KACZ,eAAA"}

package/esm/stream/json-lines.mjs

@@ -0,0 +1,65 @@
+//#region ../../packages/ai-cli/src/stream/json-lines.ts
+/** `value` as a JSON object, or `undefined`. */
+function asRecord(value) {
+	return typeof value === "object" && value !== null && !Array.isArray(value) ? value : void 0;
+}
+/** `value` as an array, or an empty array. */
+function asArray(value) {
+	return Array.isArray(value) ? value : [];
+}
+/** A string field, or `undefined`. */
+function stringField(record, key) {
+	const value = record?.[key];
+	return typeof value === "string" ? value : void 0;
+}
+/** A finite number field, or `undefined`. */
+function numberField(record, key) {
+	const value = record?.[key];
+	return typeof value === "number" && Number.isFinite(value) ? value : void 0;
+}
+/** A nested object field, or `undefined`. */
+function recordField(record, key) {
+	return asRecord(record?.[key]);
+}
+/** Tool output as text: strings verbatim, text-block arrays joined, anything else as JSON. */
+function outputText(value) {
+	if (typeof value === "string") return value;
+	if (value === void 0 || value === null) return "";
+	if (Array.isArray(value)) return value.map((item) => {
+		return stringField(asRecord(item), "text") ?? (typeof item === "string" ? item : JSON.stringify(item));
+	}).join("\n");
+	return JSON.stringify(value);
+}
+/** Parse one line as a JSON object; anything else (banners, blank lines) is `undefined`. */
+function parseJsonLine(line) {
+	const trimmed = line.trim();
+	if (!trimmed.startsWith("{")) return;
+	try {
+		return asRecord(JSON.parse(trimmed));
+	} catch {
+		return;
+	}
+}
+/**
+* Build a parser for a JSONL/NDJSON stream. Non-JSON lines (progress
+* banners, warnings) are skipped; each JSON object goes to `onRecord`.
+* `onEnd` may flush buffered state when stdout closes.
+*
+* @example
+* const parser = jsonLinesParser((record) =>
+*   record.type === "text" ? [{ type: "message", text: String(record.text), delta: false }] : [],
+* );
+*/
+function jsonLinesParser(onRecord, onEnd = () => []) {
+	return {
+		line(line) {
+			const record = parseJsonLine(line);
+			return record === void 0 ? [] : onRecord(record);
+		},
+		end: onEnd
+	};
+}
+
+//#endregion
+export { asArray, asRecord, jsonLinesParser, numberField, outputText, parseJsonLine, recordField, stringField };
+//# sourceMappingURL=json-lines.mjs.map

package/esm/stream/json-lines.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-lines.mjs","names":[],"sources":["../../../../../../../../packages/ai-cli/src/stream/json-lines.ts"],"sourcesContent":["import type { CliParsedEvent, CliStreamParser } from \"../contracts\";\n\n/** A plain JSON object. */\nexport type JsonRecord = Record<string, unknown>;\n\n/** `value` as a JSON object, or `undefined`. */\nexport function asRecord(value: unknown): JsonRecord | undefined {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value)\n    ? (value as JsonRecord)\n    : undefined;\n}\n\n/** `value` as an array, or an empty array. */\nexport function asArray(value: unknown): unknown[] {\n  return Array.isArray(value) ? value : [];\n}\n\n/** A string field, or `undefined`. */\nexport function stringField(record: JsonRecord | undefined, key: string): string | undefined {\n  const value = record?.[key];\n\n  return typeof value === \"string\" ? value : undefined;\n}\n\n/** A finite number field, or `undefined`. */\nexport function numberField(record: JsonRecord | undefined, key: string): number | undefined {\n  const value = record?.[key];\n\n  return typeof value === \"number\" && Number.isFinite(value) ? value : undefined;\n}\n\n/** A nested object field, or `undefined`. */\nexport function recordField(record: JsonRecord | undefined, key: string): JsonRecord | undefined {\n  return asRecord(record?.[key]);\n}\n\n/** Tool output as text: strings verbatim, text-block arrays joined, anything else as JSON. */\nexport function outputText(value: unknown): string {\n  if (typeof value === \"string\") {\n    return value;\n  }\n\n  if (value === undefined || value === null) {\n    return \"\";\n  }\n\n  if (Array.isArray(value)) {\n    const texts = value.map((item) => {\n      const block = asRecord(item);\n      const text = stringField(block, \"text\");\n\n      return text ?? (typeof item === \"string\" ? item : JSON.stringify(item));\n    });\n\n    return texts.join(\"\\n\");\n  }\n\n  return JSON.stringify(value);\n}\n\n/** Parse one line as a JSON object; anything else (banners, blank lines) is `undefined`. */\nexport function parseJsonLine(line: string): JsonRecord | undefined {\n  const trimmed = line.trim();\n\n  if (!trimmed.startsWith(\"{\")) {\n    return undefined;\n  }\n\n  try {\n    return asRecord(JSON.parse(trimmed));\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * Build a parser for a JSONL/NDJSON stream. Non-JSON lines (progress\n * banners, warnings) are skipped; each JSON object goes to `onRecord`.\n * `onEnd` may flush buffered state when stdout closes.\n *\n * @example\n * const parser = jsonLinesParser((record) =>\n *   record.type === \"text\" ? [{ type: \"message\", text: String(record.text), delta: false }] : [],\n * );\n */\nexport function jsonLinesParser(\n  onRecord: (record: JsonRecord) => CliParsedEvent[],\n  onEnd: () => CliParsedEvent[] = () => [],\n): CliStreamParser {\n  return {\n    line(line: string): CliParsedEvent[] {\n      const record = parseJsonLine(line);\n\n      return record === undefined ? [] : onRecord(record);\n    },\n    end: onEnd,\n  };\n}\n"],"mappings":";;AAMA,SAAgB,SAAS,OAAwC;CAC/D,OAAO,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK,IACrE,QACD;AACN;;AAGA,SAAgB,QAAQ,OAA2B;CACjD,OAAO,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC;AACzC;;AAGA,SAAgB,YAAY,QAAgC,KAAiC;CAC3F,MAAM,QAAQ,SAAS;CAEvB,OAAO,OAAO,UAAU,WAAW,QAAQ;AAC7C;;AAGA,SAAgB,YAAY,QAAgC,KAAiC;CAC3F,MAAM,QAAQ,SAAS;CAEvB,OAAO,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK,IAAI,QAAQ;AACvE;;AAGA,SAAgB,YAAY,QAAgC,KAAqC;CAC/F,OAAO,SAAS,SAAS,IAAI;AAC/B;;AAGA,SAAgB,WAAW,OAAwB;CACjD,IAAI,OAAO,UAAU,UACnB,OAAO;CAGT,IAAI,UAAU,UAAa,UAAU,MACnC,OAAO;CAGT,IAAI,MAAM,QAAQ,KAAK,GAQrB,OAPc,MAAM,KAAK,SAAS;EAIhC,OAFa,YADC,SAAS,IACM,GAAG,MAEtB,MAAM,OAAO,SAAS,WAAW,OAAO,KAAK,UAAU,IAAI;CACvE,CAEW,CAAC,CAAC,KAAK,IAAI;CAGxB,OAAO,KAAK,UAAU,KAAK;AAC7B;;AAGA,SAAgB,cAAc,MAAsC;CAClE,MAAM,UAAU,KAAK,KAAK;CAE1B,IAAI,CAAC,QAAQ,WAAW,GAAG,GACzB;CAGF,IAAI;EACF,OAAO,SAAS,KAAK,MAAM,OAAO,CAAC;CACrC,QAAQ;EACN;CACF;AACF;;;;;;;;;;;AAYA,SAAgB,gBACd,UACA,cAAsC,CAAC,GACtB;CACjB,OAAO;EACL,KAAK,MAAgC;GACnC,MAAM,SAAS,cAAc,IAAI;GAEjC,OAAO,WAAW,SAAY,CAAC,IAAI,SAAS,MAAM;EACpD;EACA,KAAK;CACP;AACF"}

package/esm/stream/line-splitter.mjs

@@ -0,0 +1,53 @@
+import { StringDecoder } from "node:string_decoder";
+
+//#region ../../packages/ai-cli/src/stream/line-splitter.ts
+/** Longest line kept in memory; a longer one is dropped (reported via `onOverflow`). */
+const MAX_LINE_BYTES = 32 * 1024 * 1024;
+/**
+* Split a byte stream into lines. Multi-byte UTF-8 characters split across
+* chunks are decoded correctly, `\r\n` and `\n` both end a line, and a final
+* line without a newline is flushed by `end()`.
+*
+* @example
+* const splitter = createLineSplitter((line) => console.log(line));
+* splitter.write(Buffer.from('{"a":1}\n{"b"'));
+* splitter.write(Buffer.from(":2}\n"));
+* splitter.end();
+*/
+function createLineSplitter(onLine, onOverflow = () => void 0) {
+	const decoder = new StringDecoder("utf8");
+	let pending = "";
+	let overflowed = false;
+	const consume = (text) => {
+		pending += text;
+		let newline = pending.indexOf("\n");
+		while (newline !== -1) {
+			const line = pending.slice(0, newline).replace(/\r$/, "");
+			pending = pending.slice(newline + 1);
+			if (overflowed) overflowed = false;
+			else onLine(line);
+			newline = pending.indexOf("\n");
+		}
+		if (pending.length > 33554432) {
+			pending = "";
+			if (!overflowed) {
+				overflowed = true;
+				onOverflow();
+			}
+		}
+	};
+	return {
+		write(chunk) {
+			consume(decoder.write(chunk));
+		},
+		end() {
+			consume(decoder.end());
+			if (pending.length > 0 && !overflowed) onLine(pending.replace(/\r$/, ""));
+			pending = "";
+		}
+	};
+}
+
+//#endregion
+export { createLineSplitter };
+//# sourceMappingURL=line-splitter.mjs.map

package/esm/stream/line-splitter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"line-splitter.mjs","names":[],"sources":["../../../../../../../../packages/ai-cli/src/stream/line-splitter.ts"],"sourcesContent":["import { StringDecoder } from \"node:string_decoder\";\n\n/** Longest line kept in memory; a longer one is dropped (reported via `onOverflow`). */\nexport const MAX_LINE_BYTES = 32 * 1024 * 1024;\n\n/**\n * Split a byte stream into lines. Multi-byte UTF-8 characters split across\n * chunks are decoded correctly, `\\r\\n` and `\\n` both end a line, and a final\n * line without a newline is flushed by `end()`.\n *\n * @example\n * const splitter = createLineSplitter((line) => console.log(line));\n * splitter.write(Buffer.from('{\"a\":1}\\n{\"b\"'));\n * splitter.write(Buffer.from(\":2}\\n\"));\n * splitter.end();\n */\nexport function createLineSplitter(\n  onLine: (line: string) => void,\n  onOverflow: () => void = () => undefined,\n): { write(chunk: Buffer): void; end(): void } {\n  const decoder = new StringDecoder(\"utf8\");\n  let pending = \"\";\n  let overflowed = false;\n\n  const consume = (text: string): void => {\n    pending += text;\n\n    let newline = pending.indexOf(\"\\n\");\n\n    while (newline !== -1) {\n      const line = pending.slice(0, newline).replace(/\\r$/, \"\");\n\n      pending = pending.slice(newline + 1);\n\n      if (overflowed) {\n        overflowed = false;\n      } else {\n        onLine(line);\n      }\n\n      newline = pending.indexOf(\"\\n\");\n    }\n\n    if (pending.length > MAX_LINE_BYTES) {\n      pending = \"\";\n\n      if (!overflowed) {\n        overflowed = true;\n        onOverflow();\n      }\n    }\n  };\n\n  return {\n    write(chunk: Buffer): void {\n      consume(decoder.write(chunk));\n    },\n    end(): void {\n      consume(decoder.end());\n\n      if (pending.length > 0 && !overflowed) {\n        onLine(pending.replace(/\\r$/, \"\"));\n      }\n\n      pending = \"\";\n    },\n  };\n}\n"],"mappings":";;;;AAGA,MAAa,iBAAiB,KAAK,OAAO;;;;;;;;;;;;AAa1C,SAAgB,mBACd,QACA,mBAA+B,QACc;CAC7C,MAAM,UAAU,IAAI,cAAc,MAAM;CACxC,IAAI,UAAU;CACd,IAAI,aAAa;CAEjB,MAAM,WAAW,SAAuB;EACtC,WAAW;EAEX,IAAI,UAAU,QAAQ,QAAQ,IAAI;EAElC,OAAO,YAAY,IAAI;GACrB,MAAM,OAAO,QAAQ,MAAM,GAAG,OAAO,CAAC,CAAC,QAAQ,OAAO,EAAE;GAExD,UAAU,QAAQ,MAAM,UAAU,CAAC;GAEnC,IAAI,YACF,aAAa;QAEb,OAAO,IAAI;GAGb,UAAU,QAAQ,QAAQ,IAAI;EAChC;EAEA,IAAI,QAAQ,mBAAyB;GACnC,UAAU;GAEV,IAAI,CAAC,YAAY;IACf,aAAa;IACb,WAAW;GACb;EACF;CACF;CAEA,OAAO;EACL,MAAM,OAAqB;GACzB,QAAQ,QAAQ,MAAM,KAAK,CAAC;EAC9B;EACA,MAAY;GACV,QAAQ,QAAQ,IAAI,CAAC;GAErB,IAAI,QAAQ,SAAS,KAAK,CAAC,YACzB,OAAO,QAAQ,QAAQ,OAAO,EAAE,CAAC;GAGnC,UAAU;EACZ;CACF;AACF"}

package/esm/utils/toml.d.mts

@@ -0,0 +1,22 @@
+//#region ../../packages/ai-cli/src/utils/toml.d.ts
+/** A TOML value this writer supports. */
+type TomlValue = string | number | boolean | TomlValue[] | TomlTable;
+/** A TOML table. */
+type TomlTable = {
+  [key: string]: TomlValue | undefined;
+};
+/**
+ * Serialize a table to TOML: scalars and arrays first, then each nested
+ * table as a `[dotted.header]` section. Enough for the CLI config files
+ * this package writes (Codex and Mistral Vibe MCP sections).
+ *
+ * @example
+ * toToml({ mcp_servers: { docs: { command: "npx", args: ["-y", "docs-mcp"] } } });
+ * // [mcp_servers.docs]
+ * // command = "npx"
+ * // args = ["-y", "docs-mcp"]
+ */
+declare function toToml(table: TomlTable, prefix?: string[]): string;
+//#endregion
+export { TomlTable, TomlValue, toToml };
+//# sourceMappingURL=toml.d.mts.map

package/esm/utils/toml.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toml.d.mts","names":[],"sources":["../../../../../../../../packages/ai-cli/src/utils/toml.ts"],"mappings":";;KACY,SAAA,+BAAwC,SAAA,KAAc,SAAS;;KAG/D,SAAA;EAAA,CAAe,GAAA,WAAc,SAAS;AAAA;;;AAAA;AAmDlD;;;;;;;;iBAAgB,MAAA,CAAO,KAAA,EAAO,SAAS,EAAE,MAAA"}

package/esm/utils/toml.mjs

@@ -0,0 +1,53 @@
+//#region ../../packages/ai-cli/src/utils/toml.ts
+function isTable(value) {
+	return typeof value === "object" && !Array.isArray(value);
+}
+/** A bare key when possible, else a quoted one. */
+function tomlKey(key) {
+	return /^[A-Za-z0-9_-]+$/.test(key) ? key : JSON.stringify(key);
+}
+/** A TOML scalar or inline value. JSON string escapes are valid TOML basic-string escapes. */
+function inlineValue(value) {
+	if (typeof value === "string") return JSON.stringify(value);
+	if (typeof value === "number") {
+		if (!Number.isFinite(value)) throw new Error("TOML cannot encode a non-finite number");
+		return String(value);
+	}
+	if (typeof value === "boolean") return value ? "true" : "false";
+	if (Array.isArray(value)) return `[${value.map(inlineValue).join(", ")}]`;
+	return `{ ${Object.entries(value).filter((entry) => entry[1] !== void 0).map(([key, item]) => `${tomlKey(key)} = ${inlineValue(item)}`).join(", ")} }`;
+}
+/**
+* Serialize a table to TOML: scalars and arrays first, then each nested
+* table as a `[dotted.header]` section. Enough for the CLI config files
+* this package writes (Codex and Mistral Vibe MCP sections).
+*
+* @example
+* toToml({ mcp_servers: { docs: { command: "npx", args: ["-y", "docs-mcp"] } } });
+* // [mcp_servers.docs]
+* // command = "npx"
+* // args = ["-y", "docs-mcp"]
+*/
+function toToml(table, prefix = []) {
+	const lines = [];
+	const nested = [];
+	for (const [key, value] of Object.entries(table)) {
+		if (value === void 0) continue;
+		if (isTable(value)) {
+			nested.push([key, value]);
+			continue;
+		}
+		lines.push(`${tomlKey(key)} = ${inlineValue(value)}`);
+	}
+	const sections = [];
+	if (lines.length > 0) sections.push((prefix.length > 0 ? `[${prefix.map(tomlKey).join(".")}]\n` : "") + lines.join("\n"));
+	for (const [key, value] of nested) {
+		const section = toToml(value, [...prefix, key]);
+		if (section.length > 0) sections.push(section.trimEnd());
+	}
+	return sections.length > 0 ? `${sections.join("\n\n")}\n` : "";
+}
+
+//#endregion
+export { toToml, tomlKey };
+//# sourceMappingURL=toml.mjs.map

package/esm/utils/toml.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"toml.mjs","names":[],"sources":["../../../../../../../../packages/ai-cli/src/utils/toml.ts"],"sourcesContent":["/** A TOML value this writer supports. */\nexport type TomlValue = string | number | boolean | TomlValue[] | TomlTable;\n\n/** A TOML table. */\nexport type TomlTable = { [key: string]: TomlValue | undefined };\n\nfunction isTable(value: TomlValue): value is TomlTable {\n  return typeof value === \"object\" && !Array.isArray(value);\n}\n\n/** A bare key when possible, else a quoted one. */\nexport function tomlKey(key: string): string {\n  return /^[A-Za-z0-9_-]+$/.test(key) ? key : JSON.stringify(key);\n}\n\n/** A TOML scalar or inline value. JSON string escapes are valid TOML basic-string escapes. */\nfunction inlineValue(value: TomlValue): string {\n  if (typeof value === \"string\") {\n    return JSON.stringify(value);\n  }\n\n  if (typeof value === \"number\") {\n    if (!Number.isFinite(value)) {\n      throw new Error(\"TOML cannot encode a non-finite number\");\n    }\n\n    return String(value);\n  }\n\n  if (typeof value === \"boolean\") {\n    return value ? \"true\" : \"false\";\n  }\n\n  if (Array.isArray(value)) {\n    return `[${value.map(inlineValue).join(\", \")}]`;\n  }\n\n  const entries = Object.entries(value).filter(\n    (entry): entry is [string, TomlValue] => entry[1] !== undefined,\n  );\n\n  return `{ ${entries.map(([key, item]) => `${tomlKey(key)} = ${inlineValue(item)}`).join(\", \")} }`;\n}\n\n/**\n * Serialize a table to TOML: scalars and arrays first, then each nested\n * table as a `[dotted.header]` section. Enough for the CLI config files\n * this package writes (Codex and Mistral Vibe MCP sections).\n *\n * @example\n * toToml({ mcp_servers: { docs: { command: \"npx\", args: [\"-y\", \"docs-mcp\"] } } });\n * // [mcp_servers.docs]\n * // command = \"npx\"\n * // args = [\"-y\", \"docs-mcp\"]\n */\nexport function toToml(table: TomlTable, prefix: string[] = []): string {\n  const lines: string[] = [];\n  const nested: Array<[string, TomlTable]> = [];\n\n  for (const [key, value] of Object.entries(table)) {\n    if (value === undefined) {\n      continue;\n    }\n\n    if (isTable(value)) {\n      nested.push([key, value]);\n      continue;\n    }\n\n    lines.push(`${tomlKey(key)} = ${inlineValue(value)}`);\n  }\n\n  const sections: string[] = [];\n\n  if (lines.length > 0) {\n    sections.push(\n      (prefix.length > 0 ? `[${prefix.map(tomlKey).join(\".\")}]\\n` : \"\") + lines.join(\"\\n\"),\n    );\n  }\n\n  for (const [key, value] of nested) {\n    const section = toToml(value, [...prefix, key]);\n\n    if (section.length > 0) {\n      sections.push(section.trimEnd());\n    }\n  }\n\n  return sections.length > 0 ? `${sections.join(\"\\n\\n\")}\\n` : \"\";\n}\n"],"mappings":";AAMA,SAAS,QAAQ,OAAsC;CACrD,OAAO,OAAO,UAAU,YAAY,CAAC,MAAM,QAAQ,KAAK;AAC1D;;AAGA,SAAgB,QAAQ,KAAqB;CAC3C,OAAO,mBAAmB,KAAK,GAAG,IAAI,MAAM,KAAK,UAAU,GAAG;AAChE;;AAGA,SAAS,YAAY,OAA0B;CAC7C,IAAI,OAAO,UAAU,UACnB,OAAO,KAAK,UAAU,KAAK;CAG7B,IAAI,OAAO,UAAU,UAAU;EAC7B,IAAI,CAAC,OAAO,SAAS,KAAK,GACxB,MAAM,IAAI,MAAM,wCAAwC;EAG1D,OAAO,OAAO,KAAK;CACrB;CAEA,IAAI,OAAO,UAAU,WACnB,OAAO,QAAQ,SAAS;CAG1B,IAAI,MAAM,QAAQ,KAAK,GACrB,OAAO,IAAI,MAAM,IAAI,WAAW,CAAC,CAAC,KAAK,IAAI,EAAE;CAO/C,OAAO,KAJS,OAAO,QAAQ,KAAK,CAAC,CAAC,QACnC,UAAwC,MAAM,OAAO,MAGtC,CAAC,CAAC,KAAK,CAAC,KAAK,UAAU,GAAG,QAAQ,GAAG,EAAE,KAAK,YAAY,IAAI,GAAG,CAAC,CAAC,KAAK,IAAI,EAAE;AAChG;;;;;;;;;;;;AAaA,SAAgB,OAAO,OAAkB,SAAmB,CAAC,GAAW;CACtE,MAAM,QAAkB,CAAC;CACzB,MAAM,SAAqC,CAAC;CAE5C,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,KAAK,GAAG;EAChD,IAAI,UAAU,QACZ;EAGF,IAAI,QAAQ,KAAK,GAAG;GAClB,OAAO,KAAK,CAAC,KAAK,KAAK,CAAC;GACxB;EACF;EAEA,MAAM,KAAK,GAAG,QAAQ,GAAG,EAAE,KAAK,YAAY,KAAK,GAAG;CACtD;CAEA,MAAM,WAAqB,CAAC;CAE5B,IAAI,MAAM,SAAS,GACjB,SAAS,MACN,OAAO,SAAS,IAAI,IAAI,OAAO,IAAI,OAAO,CAAC,CAAC,KAAK,GAAG,EAAE,OAAO,MAAM,MAAM,KAAK,IAAI,CACrF;CAGF,KAAK,MAAM,CAAC,KAAK,UAAU,QAAQ;EACjC,MAAM,UAAU,OAAO,OAAO,CAAC,GAAG,QAAQ,GAAG,CAAC;EAE9C,IAAI,QAAQ,SAAS,GACnB,SAAS,KAAK,QAAQ,QAAQ,CAAC;CAEnC;CAEA,OAAO,SAAS,SAAS,IAAI,GAAG,SAAS,KAAK,MAAM,EAAE,MAAM;AAC9D"}