ultracode-ai 1.3.0

package/dist/ui/StatusBar.js

@@ -0,0 +1,17 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+/**
+ * Bottom status bar: active agent, model, session id and token usage.
+ */
+import React from "react";
+import { Box, Text } from "ink";
+/** Shorten a session id for display (first 8 characters). */
+export function shortSessionId(id) {
+    if (id === undefined || id === "")
+        return "new";
+    return Array.from(id).slice(0, 8).join("");
+}
+/** Render the status bar. */
+export function StatusBar({ agent, model, sessionId, usage, theme, themeName, }) {
+    return (_jsx(Box, { children: _jsxs(Text, { color: theme.dim, children: [_jsx(Text, { color: theme.primary, bold: true, children: agent }), " · ", model, " · session:", shortSessionId(sessionId), " · tokens ", usage.input, "/", usage.output, " · theme:", themeName, " · shift+tab: agent · esc: cancel · ctrl+c ctrl+c: exit"] }) }));
+}
+//# sourceMappingURL=StatusBar.js.map

package/dist/ui/StatusBar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StatusBar.js","sourceRoot":"","sources":["../../src/ui/StatusBar.tsx"],"names":[],"mappings":";AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAahC,6DAA6D;AAC7D,MAAM,UAAU,cAAc,CAAC,EAAW;IACxC,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAChD,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED,6BAA6B;AAC7B,MAAM,UAAU,SAAS,CAAC,EACxB,KAAK,EACL,KAAK,EACL,SAAS,EACT,KAAK,EACL,KAAK,EACL,SAAS,GACM;IACf,OAAO,CACL,KAAC,GAAG,cACF,MAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,GAAG,aACpB,KAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,kBAC7B,KAAK,GACD,EACN,KAAK,EACL,KAAK,EACL,aAAa,EACb,cAAc,CAAC,SAAS,CAAC,EACzB,YAAY,EACZ,KAAK,CAAC,KAAK,OAAG,KAAK,CAAC,MAAM,EAC1B,WAAW,EACX,SAAS,EACT,yDAAyD,IACrD,GACH,CACP,CAAC;AACJ,CAAC"}

package/dist/ui/ToolOutput.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Compact display of recent `tool.executed` events from the facade event bus.
+ */
+import React from "react";
+import type { Theme } from "../themes/index.js";
+/** A condensed `tool.executed` event. */
+export interface ToolEventView {
+    toolName: string;
+    ok: boolean;
+    durationMs: number;
+}
+export interface ToolOutputProps {
+    events: ReadonlyArray<ToolEventView>;
+    theme: Theme;
+    /** Maximum number of events to show (most recent last). */
+    max?: number;
+}
+/** Render the recent tool executions, or nothing when there are none. */
+export declare function ToolOutput({ events, theme, max }: ToolOutputProps): React.JSX.Element | null;
+//# sourceMappingURL=ToolOutput.d.ts.map

package/dist/ui/ToolOutput.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolOutput.d.ts","sourceRoot":"","sources":["../../src/ui/ToolOutput.tsx"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEhD,yCAAyC;AACzC,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;IACrC,KAAK,EAAE,KAAK,CAAC;IACb,2DAA2D;IAC3D,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,yEAAyE;AACzE,wBAAgB,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAO,EAAE,EAAE,eAAe,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,CAYhG"}

package/dist/ui/ToolOutput.js

@@ -0,0 +1,14 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Compact display of recent `tool.executed` events from the facade event bus.
+ */
+import React from "react";
+import { Box, Text } from "ink";
+/** Render the recent tool executions, or nothing when there are none. */
+export function ToolOutput({ events, theme, max = 5 }) {
+    if (events.length === 0)
+        return null;
+    const shown = events.slice(-max);
+    return (_jsx(Box, { flexDirection: "column", children: shown.map((e, i) => (_jsxs(Text, { color: theme.tool, children: [e.ok ? "✓" : "✗", " ", e.toolName, " ", _jsxs(Text, { color: theme.dim, children: ["(", Math.round(e.durationMs), "ms)"] })] }, i))) }));
+}
+//# sourceMappingURL=ToolOutput.js.map

package/dist/ui/ToolOutput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolOutput.js","sourceRoot":"","sources":["../../src/ui/ToolOutput.tsx"],"names":[],"mappings":";AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,KAAK,CAAC;AAiBhC,yEAAyE;AACzE,MAAM,UAAU,UAAU,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,EAAmB;IACpE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,CACL,KAAC,GAAG,IAAC,aAAa,EAAC,QAAQ,YACxB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CACnB,MAAC,IAAI,IAAS,KAAK,EAAE,KAAK,CAAC,IAAI,aAC5B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,OAAG,CAAC,CAAC,QAAQ,OAAE,MAAC,IAAI,IAAC,KAAK,EAAE,KAAK,CAAC,GAAG,kBAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,KADpF,CAAC,CAEL,CACR,CAAC,GACE,CACP,CAAC;AACJ,CAAC"}

package/dist/ui/ctrl-c.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Double-press detection for the "press Ctrl+C twice to exit" behaviour.
+ * Pure and timer-free, so it is trivially unit-testable.
+ */
+export declare class DoublePress {
+    private readonly windowMs;
+    private last;
+    /**
+     * @param windowMs - maximum gap between two presses to count as a double
+     *   press (default 1500 ms).
+     */
+    constructor(windowMs?: number);
+    /**
+     * Record a press.
+     *
+     * @param now - timestamp in ms (defaults to `Date.now()`).
+     * @returns `true` when this press completes a double press.
+     */
+    press(now?: number): boolean;
+}
+//# sourceMappingURL=ctrl-c.d.ts.map

package/dist/ui/ctrl-c.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ctrl-c.d.ts","sourceRoot":"","sources":["../../src/ui/ctrl-c.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,WAAW;IAOV,OAAO,CAAC,QAAQ,CAAC,QAAQ;IANrC,OAAO,CAAC,IAAI,CAA4B;IAExC;;;OAGG;gBAC0B,QAAQ,GAAE,MAAa;IAEpD;;;;;OAKG;IACH,KAAK,CAAC,GAAG,GAAE,MAAmB,GAAG,OAAO;CAKzC"}

package/dist/ui/ctrl-c.js

@@ -0,0 +1,27 @@
+/**
+ * Double-press detection for the "press Ctrl+C twice to exit" behaviour.
+ * Pure and timer-free, so it is trivially unit-testable.
+ */
+export class DoublePress {
+    windowMs;
+    last = Number.NEGATIVE_INFINITY;
+    /**
+     * @param windowMs - maximum gap between two presses to count as a double
+     *   press (default 1500 ms).
+     */
+    constructor(windowMs = 1500) {
+        this.windowMs = windowMs;
+    }
+    /**
+     * Record a press.
+     *
+     * @param now - timestamp in ms (defaults to `Date.now()`).
+     * @returns `true` when this press completes a double press.
+     */
+    press(now = Date.now()) {
+        const isDouble = now - this.last <= this.windowMs;
+        this.last = now;
+        return isDouble;
+    }
+}
+//# sourceMappingURL=ctrl-c.js.map

package/dist/ui/ctrl-c.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ctrl-c.js","sourceRoot":"","sources":["../../src/ui/ctrl-c.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,WAAW;IAOO;IANrB,IAAI,GAAG,MAAM,CAAC,iBAAiB,CAAC;IAExC;;;OAGG;IACH,YAA6B,WAAmB,IAAI;QAAvB,aAAQ,GAAR,QAAQ,CAAe;IAAG,CAAC;IAExD;;;;;OAKG;IACH,KAAK,CAAC,MAAc,IAAI,CAAC,GAAG,EAAE;QAC5B,MAAM,QAAQ,GAAG,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF"}

package/dist/ui/start.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Bootstrap for the interactive Ink UI.
+ *
+ * Kept in its own module (and imported dynamically from `program.ts`) so that
+ * non-interactive commands never pay the cost of loading Ink/React.
+ */
+import type { CliContext } from "../context.js";
+/**
+ * Create the facade, render the {@link App} and block until the UI exits.
+ * `exitOnCtrlC` is disabled — the App implements double-Ctrl+C itself.
+ */
+export declare function startInteractive(ctx: CliContext): Promise<void>;
+//# sourceMappingURL=start.d.ts.map

package/dist/ui/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../../src/ui/start.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAWrE"}

package/dist/ui/start.js

@@ -0,0 +1,25 @@
+/**
+ * Bootstrap for the interactive Ink UI.
+ *
+ * Kept in its own module (and imported dynamically from `program.ts`) so that
+ * non-interactive commands never pay the cost of loading Ink/React.
+ */
+import React from "react";
+import { render } from "ink";
+import { safeDispose } from "../context.js";
+import { App } from "./App.js";
+/**
+ * Create the facade, render the {@link App} and block until the UI exits.
+ * `exitOnCtrlC` is disabled — the App implements double-Ctrl+C itself.
+ */
+export async function startInteractive(ctx) {
+    const facade = await ctx.createFacade({ cwd: ctx.cwd });
+    try {
+        const instance = render(React.createElement(App, { facade, initialTheme: facade.config.ui.theme }), { exitOnCtrlC: false });
+        await instance.waitUntilExit();
+    }
+    finally {
+        await safeDispose(facade);
+    }
+}
+//# sourceMappingURL=start.js.map

package/dist/ui/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../../src/ui/start.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,GAAe;IACpD,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;IACxD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,CACrB,KAAK,CAAC,aAAa,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAC1E,EAAE,WAAW,EAAE,KAAK,EAAE,CACvB,CAAC;QACF,MAAM,QAAQ,CAAC,aAAa,EAAE,CAAC;IACjC,CAAC;YAAS,CAAC;QACT,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC"}

package/dist/utils/cli-version.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Robust resolution of the CLI's own version for `--version`.
+ *
+ * Reads the package's `package.json` via `createRequire` (works from both
+ * `src/` during tests and `dist/` after the build) and falls back to the
+ * shared protocol {@link VERSION} constant if the file cannot be found.
+ */
+/**
+ * Resolve the version of the `ultracode` CLI package.
+ *
+ * @returns the `version` field of the nearest matching `package.json`,
+ *   or the shared `VERSION` constant as a last resort.
+ */
+export declare function getCliVersion(): string;
+//# sourceMappingURL=cli-version.d.ts.map

package/dist/utils/cli-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-version.d.ts","sourceRoot":"","sources":["../../src/utils/cli-version.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAetC"}

package/dist/utils/cli-version.js

@@ -0,0 +1,33 @@
+/**
+ * Robust resolution of the CLI's own version for `--version`.
+ *
+ * Reads the package's `package.json` via `createRequire` (works from both
+ * `src/` during tests and `dist/` after the build) and falls back to the
+ * shared protocol {@link VERSION} constant if the file cannot be found.
+ */
+import { createRequire } from "node:module";
+import { VERSION } from "ultracode-shared";
+/**
+ * Resolve the version of the `ultracode` CLI package.
+ *
+ * @returns the `version` field of the nearest matching `package.json`,
+ *   or the shared `VERSION` constant as a last resort.
+ */
+export function getCliVersion() {
+    const require = createRequire(import.meta.url);
+    // From src/utils or dist/utils the package root is two levels up; keep one
+    // level as well in case the file is ever flattened.
+    for (const rel of ["../../package.json", "../package.json"]) {
+        try {
+            const pkg = require(rel);
+            if (pkg.name === "ultracode-ai" && typeof pkg.version === "string") {
+                return pkg.version;
+            }
+        }
+        catch {
+            // try next candidate
+        }
+    }
+    return VERSION;
+}
+//# sourceMappingURL=cli-version.js.map

package/dist/utils/cli-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli-version.js","sourceRoot":"","sources":["../../src/utils/cli-version.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAO3C;;;;;GAKG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,2EAA2E;IAC3E,oDAAoD;IACpD,KAAK,MAAM,GAAG,IAAI,CAAC,oBAAoB,EAAE,iBAAiB,CAAC,EAAE,CAAC;QAC5D,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAoB,CAAC;YAC5C,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACnE,OAAO,GAAG,CAAC,OAAO,CAAC;YACrB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,qBAAqB;QACvB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/utils/resolve-home.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Cross-platform `~` expansion.
+ *
+ * The shared constants (`USER_CONFIG_DIR`, `USER_ENV_FILE`, ...) are
+ * tilde-prefixed. `~` does not exist on Windows, so every consumer must expand
+ * it via this helper before touching the filesystem.
+ */
+/**
+ * Expand a leading `~` (or `~/`, `~\`) to the user's home directory.
+ *
+ * Paths without a leading tilde are returned unchanged. `~user` style paths
+ * are NOT expanded (not portable).
+ *
+ * @param p - the (possibly tilde-prefixed) path.
+ * @param homedir - home directory override, mainly for tests; defaults to
+ *   `os.homedir()`.
+ */
+export declare function resolveHome(p: string, homedir?: string): string;
+//# sourceMappingURL=resolve-home.d.ts.map

package/dist/utils/resolve-home.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-home.d.ts","sourceRoot":"","sources":["../../src/utils/resolve-home.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;;;;;;;GASG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,MAAqB,GAAG,MAAM,CAM7E"}

package/dist/utils/resolve-home.js

@@ -0,0 +1,28 @@
+/**
+ * Cross-platform `~` expansion.
+ *
+ * The shared constants (`USER_CONFIG_DIR`, `USER_ENV_FILE`, ...) are
+ * tilde-prefixed. `~` does not exist on Windows, so every consumer must expand
+ * it via this helper before touching the filesystem.
+ */
+import os from "node:os";
+import path from "node:path";
+/**
+ * Expand a leading `~` (or `~/`, `~\`) to the user's home directory.
+ *
+ * Paths without a leading tilde are returned unchanged. `~user` style paths
+ * are NOT expanded (not portable).
+ *
+ * @param p - the (possibly tilde-prefixed) path.
+ * @param homedir - home directory override, mainly for tests; defaults to
+ *   `os.homedir()`.
+ */
+export function resolveHome(p, homedir = os.homedir()) {
+    if (p === "~")
+        return homedir;
+    if (p.startsWith("~/") || p.startsWith("~\\")) {
+        return path.join(homedir, p.slice(2));
+    }
+    return p;
+}
+//# sourceMappingURL=resolve-home.js.map

package/dist/utils/resolve-home.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-home.js","sourceRoot":"","sources":["../../src/utils/resolve-home.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CAAC,CAAS,EAAE,UAAkB,EAAE,CAAC,OAAO,EAAE;IACnE,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,OAAO,CAAC;IAC9B,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/utils/text.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Small, dependency-free text/value helpers used across the CLI:
+ * CLI-value parsing, dotted-path access, secret masking, config redaction,
+ * plain-text tables and optional ANSI colouring.
+ */
+/** Maximum rendered width of a single table cell, in characters. */
+export declare const MAX_CELL_WIDTH = 60;
+/**
+ * Parse a CLI-supplied value string into a JSON-ish value.
+ *
+ * `"true"`/`"false"`/`"null"` and numeric literals are converted; strings
+ * starting with `[`, `{` or `"` are parsed as JSON (falling back to the raw
+ * string on parse failure); everything else stays a plain string.
+ */
+export declare function parseCliValue(raw: string): unknown;
+/**
+ * Read a value from a nested object via a dotted path (`"core.activeModel"`).
+ * Returns `undefined` for unknown paths or non-object intermediates.
+ */
+export declare function getAtPath(obj: unknown, dotted: string): unknown;
+/**
+ * Flatten a nested plain object into `[dottedPath, leafValue]` pairs.
+ * Arrays and non-plain objects are treated as leaves.
+ */
+export declare function flattenLeaves(obj: Record<string, unknown>, prefix?: string): Array<[string, unknown]>;
+/**
+ * Mask a secret for display: at most the first three characters survive,
+ * the rest becomes `***`. Unicode-safe (never splits surrogate pairs).
+ */
+export declare function maskSecret(value: string): string;
+/**
+ * Deep-copy a value, masking every string whose *key* looks secret
+ * (`key`/`token`/`secret`/`password`/`credential`). Used as the fallback
+ * redacted view for `config show` when core does not provide one.
+ */
+export declare function redactConfig<T>(value: T): T;
+/**
+ * Render a simple, ANSI-free, two-space-separated table with a header row and
+ * a dashed separator. Cells are flattened to one line and truncated to
+ * {@link MAX_CELL_WIDTH} characters (Unicode-safe).
+ */
+export declare function formatTable(headers: ReadonlyArray<string>, rows: ReadonlyArray<ReadonlyArray<string>>): string;
+/**
+ * Wrap `s` in an ANSI SGR sequence when `enabled` is true; otherwise return
+ * `s` untouched. The CLI only emits ANSI when the target stream is a TTY.
+ *
+ * @param code - SGR code, e.g. `"31"` for red.
+ */
+export declare function paint(s: string, code: string, enabled: boolean): string;
+//# sourceMappingURL=text.d.ts.map

package/dist/utils/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/utils/text.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,oEAAoE;AACpE,eAAO,MAAM,cAAc,KAAK,CAAC;AAKjC;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAclD;AAED;;;GAGG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAQ/D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,MAAM,SAAK,GACV,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAW1B;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAE3C;AAwBD;;;;GAIG;AACH,wBAAgB,WAAW,CACzB,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,EAC9B,IAAI,EAAE,aAAa,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,GACzC,MAAM,CAcR;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,MAAM,CAEvE"}

package/dist/utils/text.js

@@ -0,0 +1,133 @@
+/**
+ * Small, dependency-free text/value helpers used across the CLI:
+ * CLI-value parsing, dotted-path access, secret masking, config redaction,
+ * plain-text tables and optional ANSI colouring.
+ */
+import { isPlainObject, truncate } from "ultracode-shared";
+/** Maximum rendered width of a single table cell, in characters. */
+export const MAX_CELL_WIDTH = 60;
+/** Key names whose string values are considered secrets and get masked. */
+const SECRET_KEY_RE = /(api[-_]?key|key|token|secret|password|credential)/i;
+/**
+ * Parse a CLI-supplied value string into a JSON-ish value.
+ *
+ * `"true"`/`"false"`/`"null"` and numeric literals are converted; strings
+ * starting with `[`, `{` or `"` are parsed as JSON (falling back to the raw
+ * string on parse failure); everything else stays a plain string.
+ */
+export function parseCliValue(raw) {
+    const t = raw.trim();
+    if (t === "true")
+        return true;
+    if (t === "false")
+        return false;
+    if (t === "null")
+        return null;
+    if (t !== "" && /^-?\d+(\.\d+)?$/.test(t) && Number.isFinite(Number(t)))
+        return Number(t);
+    if (t.startsWith("[") || t.startsWith("{") || (t.startsWith('"') && t.endsWith('"') && t.length >= 2)) {
+        try {
+            return JSON.parse(t);
+        }
+        catch {
+            return raw;
+        }
+    }
+    return raw;
+}
+/**
+ * Read a value from a nested object via a dotted path (`"core.activeModel"`).
+ * Returns `undefined` for unknown paths or non-object intermediates.
+ */
+export function getAtPath(obj, dotted) {
+    if (dotted === "")
+        return undefined;
+    let cur = obj;
+    for (const part of dotted.split(".")) {
+        if (cur === null || typeof cur !== "object")
+            return undefined;
+        cur = cur[part];
+    }
+    return cur;
+}
+/**
+ * Flatten a nested plain object into `[dottedPath, leafValue]` pairs.
+ * Arrays and non-plain objects are treated as leaves.
+ */
+export function flattenLeaves(obj, prefix = "") {
+    const out = [];
+    for (const [key, value] of Object.entries(obj)) {
+        const p = prefix === "" ? key : `${prefix}.${key}`;
+        if (isPlainObject(value)) {
+            out.push(...flattenLeaves(value, p));
+        }
+        else {
+            out.push([p, value]);
+        }
+    }
+    return out;
+}
+/**
+ * Mask a secret for display: at most the first three characters survive,
+ * the rest becomes `***`. Unicode-safe (never splits surrogate pairs).
+ */
+export function maskSecret(value) {
+    if (value.length === 0)
+        return "(empty)";
+    if (value.length <= 6)
+        return "***";
+    return `${Array.from(value).slice(0, 3).join("")}***`;
+}
+/**
+ * Deep-copy a value, masking every string whose *key* looks secret
+ * (`key`/`token`/`secret`/`password`/`credential`). Used as the fallback
+ * redacted view for `config show` when core does not provide one.
+ */
+export function redactConfig(value) {
+    return redactInner(value, "");
+}
+function redactInner(value, key) {
+    if (typeof value === "string") {
+        return SECRET_KEY_RE.test(key) && value.length > 0 ? maskSecret(value) : value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((v) => redactInner(v, key));
+    }
+    if (isPlainObject(value)) {
+        const out = {};
+        for (const [k, v] of Object.entries(value)) {
+            out[k] = redactInner(v, k);
+        }
+        return out;
+    }
+    return value;
+}
+/** Unicode-aware character count (code points, not UTF-16 units). */
+function charLen(s) {
+    return Array.from(s).length;
+}
+/**
+ * Render a simple, ANSI-free, two-space-separated table with a header row and
+ * a dashed separator. Cells are flattened to one line and truncated to
+ * {@link MAX_CELL_WIDTH} characters (Unicode-safe).
+ */
+export function formatTable(headers, rows) {
+    const cols = headers.length;
+    const cell = (s) => truncate(String(s ?? "").replace(/\r?\n/g, " "), MAX_CELL_WIDTH);
+    const all = [headers, ...rows].map((r) => Array.from({ length: cols }, (_, i) => cell(r[i])));
+    const widths = Array.from({ length: cols }, (_, i) => Math.max(...all.map((r) => charLen(r[i] ?? ""))));
+    const pad = (s, w) => s + " ".repeat(Math.max(0, w - charLen(s)));
+    const lines = all.map((r) => r.map((c, i) => pad(c, widths[i] ?? 0)).join("  ").trimEnd());
+    lines.splice(1, 0, widths.map((w) => "-".repeat(Math.max(1, w))).join("  ").trimEnd());
+    return `${lines.join("\n")}\n`;
+}
+/**
+ * Wrap `s` in an ANSI SGR sequence when `enabled` is true; otherwise return
+ * `s` untouched. The CLI only emits ANSI when the target stream is a TTY.
+ *
+ * @param code - SGR code, e.g. `"31"` for red.
+ */
+export function paint(s, code, enabled) {
+    return enabled ? `\u001B[${code}m${s}\u001B[0m` : s;
+}
+//# sourceMappingURL=text.js.map

package/dist/utils/text.js.map

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

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "ultracode-ai",
+  "version": "1.3.0",
+  "type": "module",
+  "license": "MIT",
+  "description": "UltraCode CLI – interactive AI code assistant for the terminal",
+  "bin": {
+    "ultracode-ai": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AndreasSchwan-SIMO/UltraCode.git",
+    "directory": "packages/cli"
+  },
+  "homepage": "https://github.com/AndreasSchwan-SIMO/UltraCode#readme",
+  "bugs": {
+    "url": "https://github.com/AndreasSchwan-SIMO/UltraCode/issues"
+  },
+  "dependencies": {
+    "commander": "^12.1.0",
+    "ink": "^5.1.0",
+    "react": "^18.3.1",
+    "ultracode-core": "^1.3.0",
+    "ultracode-shared": "^1.3.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.0",
+    "ink-testing-library": "^4.0.0"
+  },
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "vitest run",
+    "dev": "node --enable-source-maps dist/index.js"
+  }
+}