@getpaseo/cli 0.1.2

package/dist/output/render.js

@@ -0,0 +1,80 @@
+/**
+ * Main render dispatcher for CLI output.
+ *
+ * Selects the appropriate renderer based on output options.
+ */
+import chalk from 'chalk';
+import YAML from 'yaml';
+import { renderTable } from './table.js';
+import { renderJson } from './json.js';
+import { renderYaml } from './yaml.js';
+import { renderQuiet } from './quiet.js';
+/** Default output options */
+export const defaultOutputOptions = {
+    format: 'table',
+    quiet: false,
+    noHeaders: false,
+    noColor: false,
+};
+/** Render command result to string based on output options */
+export function render(result, options = {}) {
+    const opts = { ...defaultOutputOptions, ...options };
+    // Quiet mode takes precedence
+    if (opts.quiet) {
+        return renderQuiet(result, opts);
+    }
+    // Dispatch to format-specific renderer
+    switch (opts.format) {
+        case 'json':
+            return renderJson(result, opts);
+        case 'yaml':
+            return renderYaml(result, opts);
+        case 'table':
+        default:
+            return renderTable(result, opts);
+    }
+}
+/** Convert an unknown error to a CommandError */
+export function toCommandError(error) {
+    if (isCommandError(error)) {
+        return error;
+    }
+    if (error instanceof Error) {
+        return {
+            code: 'UNKNOWN_ERROR',
+            message: error.message,
+            details: error.stack,
+        };
+    }
+    return {
+        code: 'UNKNOWN_ERROR',
+        message: String(error),
+    };
+}
+/** Type guard for CommandError */
+function isCommandError(error) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'code' in error &&
+        'message' in error &&
+        typeof error.code === 'string' &&
+        typeof error.message === 'string');
+}
+/** Render an error to string based on output options */
+export function renderError(error, options = {}) {
+    const opts = { ...defaultOutputOptions, ...options };
+    if (opts.format === 'json') {
+        return JSON.stringify({ error }, null, 2);
+    }
+    if (opts.format === 'yaml') {
+        return YAML.stringify({ error });
+    }
+    // Table/default format: human-readable error
+    const prefix = opts.noColor ? 'Error: ' : chalk.red('Error: ');
+    const message = error.message;
+    if (error.details && typeof error.details === 'string') {
+        return `${prefix}${message}\n${error.details}`;
+    }
+    return `${prefix}${message}`;
+}
+//# sourceMappingURL=render.js.map

package/dist/output/render.js.map

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

package/dist/output/table.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Table renderer for CLI output.
+ *
+ * Renders structured data as aligned ASCII tables with optional color support.
+ */
+import type { AnyCommandResult, OutputOptions, OutputSchema } from './types.js';
+/** Render a list result as a table */
+export declare function renderTable<T>(result: AnyCommandResult<T>, options: OutputOptions): string;
+/** Render just a table header (for streaming) */
+export declare function renderTableHeader<T>(schema: OutputSchema<T>, options: OutputOptions, widths?: number[]): string;
+/** Render just a table row (for streaming) */
+export declare function renderTableRow<T>(item: T, schema: OutputSchema<T>, options: OutputOptions, widths?: number[]): string;
+//# sourceMappingURL=table.d.ts.map

package/dist/output/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/output/table.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EACV,gBAAgB,EAEhB,aAAa,EACb,YAAY,EACb,MAAM,YAAY,CAAA;AAmInB,sCAAsC;AACtC,wBAAgB,WAAW,CAAC,CAAC,EAC3B,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC3B,OAAO,EAAE,aAAa,GACrB,MAAM,CAyBR;AAED,iDAAiD;AACjD,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,OAAO,EAAE,aAAa,EACtB,MAAM,CAAC,EAAE,MAAM,EAAE,GAChB,MAAM,CAIR;AAED,8CAA8C;AAC9C,wBAAgB,cAAc,CAAC,CAAC,EAC9B,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,EACvB,OAAO,EAAE,aAAa,EACtB,MAAM,CAAC,EAAE,MAAM,EAAE,GAChB,MAAM,CAIR"}

package/dist/output/table.js

@@ -0,0 +1,135 @@
+/**
+ * Table renderer for CLI output.
+ *
+ * Renders structured data as aligned ASCII tables with optional color support.
+ */
+import chalk from 'chalk';
+// ANSI escape code regex for stripping colors when measuring width
+const ANSI_REGEX = 
+// eslint-disable-next-line no-control-regex
+/[\u001b\u009b][[()#;?]*(?:[0-9]{1,4}(?:;[0-9]{0,4})*)?[0-9A-ORZcf-nqry=><]/g;
+/** Strip ANSI escape codes from a string */
+function stripAnsi(str) {
+    return str.replace(ANSI_REGEX, '');
+}
+/** Get visible string length (excluding ANSI codes) */
+function visibleLength(str) {
+    return stripAnsi(str).length;
+}
+/** Pad a cell to the specified width with alignment */
+function padCell(cell, width, align) {
+    const visible = visibleLength(cell);
+    const padding = Math.max(0, width - visible);
+    switch (align) {
+        case 'right':
+            return ' '.repeat(padding) + cell;
+        case 'center': {
+            const left = Math.floor(padding / 2);
+            const right = padding - left;
+            return ' '.repeat(left) + cell + ' '.repeat(right);
+        }
+        case 'left':
+        default:
+            return cell + ' '.repeat(padding);
+    }
+}
+/** Apply a chalk color to a string */
+function applyColor(str, colorName) {
+    // Map color names to chalk methods
+    const colorMap = {
+        red: chalk.red,
+        green: chalk.green,
+        blue: chalk.blue,
+        yellow: chalk.yellow,
+        cyan: chalk.cyan,
+        magenta: chalk.magenta,
+        white: chalk.white,
+        gray: chalk.gray,
+        grey: chalk.grey,
+        dim: chalk.dim,
+        bold: chalk.bold,
+    };
+    const colorFn = colorMap[colorName];
+    return colorFn ? colorFn(str) : str;
+}
+/** Extract value from item using field definition */
+function getValue(item, field) {
+    return typeof field === 'function' ? field(item) : item[field];
+}
+/** Render a single table row */
+function renderRow(item, columns, widths, options) {
+    return columns
+        .map((col, colIndex) => {
+        const value = getValue(item, col.field);
+        let cell = String(value ?? '');
+        const width = widths[colIndex];
+        // Apply color if enabled
+        if (col.color && !options.noColor) {
+            const colorName = col.color(value, item);
+            if (colorName) {
+                cell = applyColor(cell, colorName);
+            }
+        }
+        return padCell(cell, width ?? 0, col.align ?? 'left');
+    })
+        .join('  ');
+}
+/** Render header row */
+function renderHeader(columns, widths, options) {
+    const headerRow = columns
+        .map((col, i) => padCell(col.header, widths[i] ?? 0, col.align ?? 'left'))
+        .join('  ');
+    return options.noColor ? headerRow : chalk.bold(headerRow);
+}
+/** Calculate column widths based on content and hints */
+function calculateWidths(data, columns, includeHeaders) {
+    return columns.map((col) => {
+        // Start with header width if including headers
+        let maxWidth = includeHeaders ? col.header.length : 0;
+        // Check all data values
+        for (const item of data) {
+            const value = getValue(item, col.field);
+            const str = String(value ?? '');
+            maxWidth = Math.max(maxWidth, visibleLength(str));
+        }
+        // Apply width hint if specified (minimum width)
+        if (col.width) {
+            maxWidth = Math.max(maxWidth, col.width);
+        }
+        return maxWidth;
+    });
+}
+/** Render a list result as a table */
+export function renderTable(result, options) {
+    const { schema } = result;
+    const data = result.type === 'list' ? result.data : [result.data];
+    if (data.length === 0) {
+        return '';
+    }
+    const columns = schema.columns;
+    const includeHeaders = !options.noHeaders;
+    const widths = calculateWidths(data, columns, includeHeaders);
+    const lines = [];
+    // Add header row
+    if (includeHeaders) {
+        lines.push(renderHeader(columns, widths, options));
+    }
+    // Add data rows
+    for (const item of data) {
+        lines.push(renderRow(item, columns, widths, options));
+    }
+    return lines.join('\n');
+}
+/** Render just a table header (for streaming) */
+export function renderTableHeader(schema, options, widths) {
+    const columns = schema.columns;
+    const actualWidths = widths ?? columns.map((col) => col.width ?? col.header.length);
+    return renderHeader(columns, actualWidths, options);
+}
+/** Render just a table row (for streaming) */
+export function renderTableRow(item, schema, options, widths) {
+    const columns = schema.columns;
+    const actualWidths = widths ?? columns.map((col) => col.width ?? col.header.length);
+    return renderRow(item, columns, actualWidths, options);
+}
+//# sourceMappingURL=table.js.map

package/dist/output/table.js.map

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

package/dist/output/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Output format types for the Paseo CLI.
+ *
+ * This module defines the structured data types used by the output abstraction layer.
+ * Commands return CommandResult<T> which contains both data and rendering metadata.
+ */
+/** Supported output formats */
+export type OutputFormat = 'table' | 'json' | 'yaml';
+/** Options controlling output rendering */
+export interface OutputOptions {
+    /** Output format (table, json, yaml) */
+    format: OutputFormat;
+    /** Minimal output - IDs only */
+    quiet: boolean;
+    /** Omit table headers */
+    noHeaders: boolean;
+    /** Disable color output */
+    noColor: boolean;
+}
+/** Column definition for table output */
+export interface ColumnDef<T> {
+    /** Header text for the column */
+    header: string;
+    /** Field key or accessor function */
+    field: keyof T | ((item: T) => unknown);
+    /** Optional width hint (characters) */
+    width?: number;
+    /** Optional alignment */
+    align?: 'left' | 'right' | 'center';
+    /** Optional color function - returns chalk color name */
+    color?: (value: unknown, item: T) => string | undefined;
+}
+/** Schema describing how to render command output */
+export interface OutputSchema<T> {
+    /** Field to use for quiet mode (--quiet outputs just this) */
+    idField: keyof T | ((item: T) => string);
+    /** Column definitions for table output */
+    columns: ColumnDef<T>[];
+    /** Optional: transform data before JSON/YAML output */
+    serialize?: (data: T) => unknown;
+}
+/** Result type for commands returning a single item */
+export interface SingleResult<T> {
+    type: 'single';
+    /** The structured data to render */
+    data: T;
+    /** Schema describing how to render this data (for item type T) */
+    schema: OutputSchema<T>;
+}
+/** Result type for commands returning a list */
+export interface ListResult<T> {
+    type: 'list';
+    /** The structured data to render */
+    data: T[];
+    /** Schema describing how to render this data (for item type T) */
+    schema: OutputSchema<T>;
+}
+/** Union type for all command results */
+export type AnyCommandResult<T> = SingleResult<T> | ListResult<T>;
+/** Base interface for command results (deprecated, use SingleResult or ListResult) */
+export type CommandResult<T> = SingleResult<T> | ListResult<T>;
+/** Structured error for command failures */
+export interface CommandError {
+    /** Machine-readable error code */
+    code: string;
+    /** Human-readable message */
+    message: string;
+    /** Additional context */
+    details?: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/output/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/output/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,+BAA+B;AAC/B,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,CAAA;AAEpD,2CAA2C;AAC3C,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,MAAM,EAAE,YAAY,CAAA;IACpB,gCAAgC;IAChC,KAAK,EAAE,OAAO,CAAA;IACd,yBAAyB;IACzB,SAAS,EAAE,OAAO,CAAA;IAClB,2BAA2B;IAC3B,OAAO,EAAE,OAAO,CAAA;CACjB;AAED,yCAAyC;AACzC,MAAM,WAAW,SAAS,CAAC,CAAC;IAC1B,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAA;IACd,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAA;IACvC,uCAAuC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,yBAAyB;IACzB,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAA;IACnC,yDAAyD;IACzD,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,SAAS,CAAA;CACxD;AAED,qDAAqD;AACrD,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAC,CAAA;IACxC,0CAA0C;IAC1C,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,CAAA;IACvB,uDAAuD;IACvD,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAA;CACjC;AAED,uDAAuD;AACvD,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,IAAI,EAAE,QAAQ,CAAA;IACd,oCAAoC;IACpC,IAAI,EAAE,CAAC,CAAA;IACP,kEAAkE;IAClE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;CACxB;AAED,gDAAgD;AAChD,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,oCAAoC;IACpC,IAAI,EAAE,CAAC,EAAE,CAAA;IACT,kEAAkE;IAClE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;CACxB;AAED,yCAAyC;AACzC,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;AAEjE,sFAAsF;AACtF,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,YAAY,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;AAE9D,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,kCAAkC;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAA;IACf,yBAAyB;IACzB,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB"}

package/dist/output/types.js

@@ -0,0 +1,8 @@
+/**
+ * Output format types for the Paseo CLI.
+ *
+ * This module defines the structured data types used by the output abstraction layer.
+ * Commands return CommandResult<T> which contains both data and rendering metadata.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/output/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/output/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/output/with-output.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Command wrapper for automatic output rendering.
+ *
+ * Wraps command handlers to automatically render results and handle errors.
+ */
+import type { Command } from 'commander';
+import type { AnyCommandResult, OutputOptions } from './types.js';
+/** Options that include output settings from global options */
+export interface CommandOptions extends Partial<OutputOptions> {
+    [key: string]: unknown;
+}
+/**
+ * Wrap a command handler to automatically render output.
+ *
+ * The wrapped handler should return a CommandResult. The wrapper will:
+ * 1. Call the handler
+ * 2. Render the result using the appropriate format
+ * 3. Write to stdout
+ * 4. Handle errors by rendering to stderr and exiting with code 1
+ *
+ * @example
+ * ```typescript
+ * program
+ *   .command('list')
+ *   .action(withOutput(async (options) => {
+ *     const data = await fetchData()
+ *     return { type: 'list', data, schema }
+ *   }))
+ * ```
+ */
+export declare function withOutput<T, Args extends unknown[]>(handler: (...args: [...Args, CommandOptions, Command]) => Promise<AnyCommandResult<T>>): (...args: [...Args, CommandOptions, Command]) => Promise<void>;
+/**
+ * Helper to create output options from partial input.
+ * Useful for testing or manual rendering.
+ */
+export declare function createOutputOptions(partial?: Partial<OutputOptions>): OutputOptions;
+//# sourceMappingURL=with-output.d.ts.map

package/dist/output/with-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-output.d.ts","sourceRoot":"","sources":["../../src/output/with-output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACxC,OAAO,KAAK,EAAE,gBAAgB,EAAgB,aAAa,EAAE,MAAM,YAAY,CAAA;AAG/E,+DAA+D;AAC/D,MAAM,WAAW,cAAe,SAAQ,OAAO,CAAC,aAAa,CAAC;IAC5D,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB;AA4BD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,IAAI,SAAS,OAAO,EAAE,EAClD,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,GACrF,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAsBhE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,GAAE,OAAO,CAAC,aAAa,CAAM,GACnC,aAAa,CAEf"}

package/dist/output/with-output.js

@@ -0,0 +1,78 @@
+/**
+ * Command wrapper for automatic output rendering.
+ *
+ * Wraps command handlers to automatically render results and handle errors.
+ */
+import { render, renderError, toCommandError, defaultOutputOptions } from './render.js';
+function normalizeFormat(raw) {
+    const value = typeof raw === 'string' ? raw.trim().toLowerCase() : '';
+    // Common user expectation: "cli" means "table/human"
+    if (value === 'cli')
+        return 'table';
+    if (value === 'table' || value === 'json' || value === 'yaml')
+        return value;
+    const error = {
+        code: 'INVALID_FORMAT',
+        message: `Unsupported output format: ${String(raw)}`,
+        details: 'Supported formats: table, json, yaml',
+    };
+    throw error;
+}
+/** Extract output options from command options */
+function extractOutputOptions(options) {
+    return {
+        format: options.json ? 'json' : normalizeFormat(options.format ?? defaultOutputOptions.format),
+        quiet: options.quiet ?? defaultOutputOptions.quiet,
+        noHeaders: options.headers === false, // Commander uses --no-headers -> headers: false
+        noColor: options.color === false, // Commander uses --no-color -> color: false
+    };
+}
+/**
+ * Wrap a command handler to automatically render output.
+ *
+ * The wrapped handler should return a CommandResult. The wrapper will:
+ * 1. Call the handler
+ * 2. Render the result using the appropriate format
+ * 3. Write to stdout
+ * 4. Handle errors by rendering to stderr and exiting with code 1
+ *
+ * @example
+ * ```typescript
+ * program
+ *   .command('list')
+ *   .action(withOutput(async (options) => {
+ *     const data = await fetchData()
+ *     return { type: 'list', data, schema }
+ *   }))
+ * ```
+ */
+export function withOutput(handler) {
+    return async (...args) => {
+        // Last two args are options and command
+        const command = args[args.length - 1];
+        // Use optsWithGlobals() to get both local and global options
+        const options = command.optsWithGlobals();
+        const outputOptions = extractOutputOptions(options);
+        try {
+            const result = await handler(...args);
+            const output = render(result, outputOptions);
+            if (output) {
+                process.stdout.write(output + '\n');
+            }
+        }
+        catch (error) {
+            const commandError = toCommandError(error);
+            const errorOutput = renderError(commandError, outputOptions);
+            process.stderr.write(errorOutput + '\n');
+            process.exit(1);
+        }
+    };
+}
+/**
+ * Helper to create output options from partial input.
+ * Useful for testing or manual rendering.
+ */
+export function createOutputOptions(partial = {}) {
+    return { ...defaultOutputOptions, ...partial };
+}
+//# sourceMappingURL=with-output.js.map

package/dist/output/with-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-output.js","sourceRoot":"","sources":["../../src/output/with-output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAOvF,SAAS,eAAe,CAAC,GAAY;IACnC,MAAM,KAAK,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAErE,qDAAqD;IACrD,IAAI,KAAK,KAAK,KAAK;QAAE,OAAO,OAAO,CAAA;IAEnC,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,KAAK,CAAA;IAE3E,MAAM,KAAK,GAAiB;QAC1B,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,8BAA8B,MAAM,CAAC,GAAG,CAAC,EAAE;QACpD,OAAO,EAAE,sCAAsC;KAChD,CAAA;IACD,MAAM,KAAK,CAAA;AACb,CAAC;AAED,kDAAkD;AAClD,SAAS,oBAAoB,CAAC,OAAuB;IACnD,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,MAAM,IAAI,oBAAoB,CAAC,MAAM,CAAC;QAC9F,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,oBAAoB,CAAC,KAAK;QAClD,SAAS,EAAE,OAAO,CAAC,OAAO,KAAK,KAAK,EAAE,gDAAgD;QACtF,OAAO,EAAE,OAAO,CAAC,KAAK,KAAK,KAAK,EAAE,4CAA4C;KAC/E,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,UAAU,CACxB,OAAsF;IAEtF,OAAO,KAAK,EAAE,GAAG,IAAI,EAAE,EAAE;QACvB,wCAAwC;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAY,CAAA;QAChD,6DAA6D;QAC7D,MAAM,OAAO,GAAG,OAAO,CAAC,eAAe,EAAoB,CAAA;QAC3D,MAAM,aAAa,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAA;QAEnD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,GAAG,IAAI,CAAC,CAAA;YACrC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;YAE5C,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;YACrC,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,cAAc,CAAC,KAAK,CAAC,CAAA;YAC1C,MAAM,WAAW,GAAG,WAAW,CAAC,YAAY,EAAE,aAAa,CAAC,CAAA;YAC5D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;YACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;IACH,CAAC,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,UAAkC,EAAE;IAEpC,OAAO,EAAE,GAAG,oBAAoB,EAAE,GAAG,OAAO,EAAE,CAAA;AAChD,CAAC"}

package/dist/output/yaml.d.ts

@@ -0,0 +1,11 @@
+/**
+ * YAML renderer for CLI output.
+ *
+ * Renders structured data as YAML for machine consumption and human readability.
+ */
+import type { AnyCommandResult, OutputOptions } from './types.js';
+/** Render command result as YAML */
+export declare function renderYaml<T>(result: AnyCommandResult<T>, _options: OutputOptions): string;
+/** Render a single item as YAML document (for streaming) */
+export declare function renderYamlDoc<T>(item: T, serialize?: (data: T) => unknown): string;
+//# sourceMappingURL=yaml.d.ts.map

package/dist/output/yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../../src/output/yaml.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAEjE,oCAAoC;AACpC,wBAAgB,UAAU,CAAC,CAAC,EAC1B,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC3B,QAAQ,EAAE,aAAa,GACtB,MAAM,CAyBR;AAED,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,MAAM,CAGlF"}

package/dist/output/yaml.js

@@ -0,0 +1,38 @@
+/**
+ * YAML renderer for CLI output.
+ *
+ * Renders structured data as YAML for machine consumption and human readability.
+ */
+import YAML from 'yaml';
+/** Render command result as YAML */
+export function renderYaml(result, _options) {
+    const { schema } = result;
+    // Apply custom serializer if provided
+    if (schema.serialize) {
+        if (result.type === 'list') {
+            // If all items serialize to the same object, return just one
+            // This handles the case where a list of key-value rows should serialize
+            // to a single structured object
+            const serialized = result.data.map((item) => schema.serialize(item));
+            if (serialized.length > 0) {
+                const first = JSON.stringify(serialized[0]);
+                const allSame = serialized.every((s) => JSON.stringify(s) === first);
+                if (allSame) {
+                    return YAML.stringify(serialized[0]);
+                }
+            }
+            return YAML.stringify(serialized);
+        }
+        else {
+            const serialized = schema.serialize(result.data);
+            return YAML.stringify(serialized);
+        }
+    }
+    return YAML.stringify(result.data);
+}
+/** Render a single item as YAML document (for streaming) */
+export function renderYamlDoc(item, serialize) {
+    const output = serialize ? serialize(item) : item;
+    return YAML.stringify(output);
+}
+//# sourceMappingURL=yaml.js.map

package/dist/output/yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.js","sourceRoot":"","sources":["../../src/output/yaml.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAA;AAGvB,oCAAoC;AACpC,MAAM,UAAU,UAAU,CACxB,MAA2B,EAC3B,QAAuB;IAEvB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAA;IAEzB,sCAAsC;IACtC,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC3B,6DAA6D;YAC7D,wEAAwE;YACxE,gCAAgC;YAChC,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,SAAU,CAAC,IAAI,CAAC,CAAC,CAAA;YACrE,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC1B,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;gBAC3C,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAA;gBACpE,IAAI,OAAO,EAAE,CAAC;oBACZ,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAA;gBACtC,CAAC;YACH,CAAC;YACD,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;QACnC,CAAC;aAAM,CAAC;YACN,MAAM,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;YAChD,OAAO,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAA;QACnC,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;AACpC,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,aAAa,CAAI,IAAO,EAAE,SAAgC;IACxE,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;IACjD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;AAC/B,CAAC"}

package/dist/utils/client.d.ts

@@ -0,0 +1,35 @@
+import { DaemonClient } from '@getpaseo/server';
+export interface ConnectOptions {
+    host?: string;
+    timeout?: number;
+}
+/**
+ * Get the daemon host from environment or options
+ */
+export declare function getDaemonHost(options?: ConnectOptions): string;
+/**
+ * Create and connect a daemon client
+ * Returns the connected client or throws if connection fails
+ */
+export declare function connectToDaemon(options?: ConnectOptions): Promise<DaemonClient>;
+/**
+ * Try to connect to the daemon, returns null if connection fails
+ */
+export declare function tryConnectToDaemon(options?: ConnectOptions): Promise<DaemonClient | null>;
+/** Minimal agent type for ID resolution */
+interface AgentLike {
+    id: string;
+    title?: string | null;
+}
+/**
+ * Resolve an agent ID from a partial ID or name.
+ * Supports:
+ * - Full ID match
+ * - Prefix match (first N characters)
+ * - Title/name match (case-insensitive)
+ *
+ * Returns the full agent ID if found, null otherwise.
+ */
+export declare function resolveAgentId(idOrName: string, agents: AgentLike[]): string | null;
+export {};
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/utils/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAG/C,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAKD;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,MAAM,CAE9D;AAiBD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAoCrF;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAM/F;AAED,2CAA2C;AAC3C,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,GAAG,IAAI,CAsCnF"}