@outputai/cli 0.1.1 → 0.1.2

package/dist/utils/cost_formatter.js

@@ -1,218 +0,0 @@
-import Table from 'cli-table3';
-function formatNumber(num) {
-    return num.toLocaleString('en-US');
-}
-function roundGaussian(n, d = 2) {
-    if (!isFinite(n)) {
-        return NaN;
-    }
-    const m = Math.pow(10, d);
-    const num = +(n * m).toFixed(8);
-    const i = Math.floor(num);
-    const f = num - i;
-    const e = 1e-8;
-    const isHalf = f > 0.5 - e && f < 0.5 + e;
-    const evenRound = i % 2 === 0 ? i : i + 1;
-    const r = isHalf ? evenRound : Math.round(num);
-    return r / m;
-}
-function formatCurrency(amount) {
-    if (amount < 0.01) {
-        return `$${roundGaussian(amount, 4).toFixed(4)}`;
-    }
-    return `$${roundGaussian(amount, 2).toFixed(2)}`;
-}
-function pluralize(count, singular) {
-    return count === 1 ? `1 ${singular}` : `${count} ${singular}s`;
-}
-export function parseCostData(report) {
-    const byModel = {};
-    for (const r of report.llmCalls) {
-        if (!byModel[r.model]) {
-            byModel[r.model] = { count: 0, cost: 0 };
-        }
-        byModel[r.model].count++;
-        byModel[r.model].cost += r.cost;
-    }
-    const llmModels = Object.entries(byModel)
-        .sort((a, b) => b[1].cost - a[1].cost)
-        .map(([model, stats]) => ({ model, count: stats.count, cost: stats.cost }));
-    const services = [...report.services]
-        .sort((a, b) => b.totalCost - a.totalCost)
-        .map(s => ({ serviceName: s.serviceName, callCount: s.calls.length, cost: s.totalCost }));
-    const serviceTotalCalls = services.reduce((sum, s) => sum + s.callCount, 0);
-    return {
-        traceFile: report.traceFile,
-        workflowName: report.workflowName,
-        duration: report.durationMs ? `${(report.durationMs / 1000).toFixed(1)}s` : 'N/A',
-        llmModels,
-        llmTotalCalls: report.llmCalls.length,
-        llmTotalCost: report.llmTotalCost,
-        services,
-        serviceTotalCalls,
-        serviceTotalCost: report.serviceTotalCost,
-        verbose: {
-            hasReasoning: report.totalReasoningTokens > 0,
-            hasCached: report.totalCachedTokens > 0
-        },
-        llmCalls: report.llmCalls,
-        serviceDetails: report.services,
-        totalInputTokens: report.totalInputTokens,
-        totalOutputTokens: report.totalOutputTokens,
-        totalCachedTokens: report.totalCachedTokens,
-        totalReasoningTokens: report.totalReasoningTokens,
-        totalCost: report.totalCost,
-        unknownModels: report.unknownModels,
-        isEmpty: report.llmCalls.length === 0 && report.services.length === 0
-    };
-}
-function formatSummary(data) {
-    const lines = [];
-    if (data.llmModels.length > 0) {
-        const table = new Table({
-            head: ['Model', 'Calls', 'Cost'],
-            style: { head: ['cyan'] },
-            colAligns: ['left', 'right', 'right']
-        });
-        for (const m of data.llmModels) {
-            table.push([m.model, pluralize(m.count, 'call'), formatCurrency(m.cost)]);
-        }
-        table.push([
-            'Subtotal',
-            pluralize(data.llmTotalCalls, 'call'),
-            formatCurrency(data.llmTotalCost)
-        ]);
-        lines.push('LLM Costs:');
-        lines.push(table.toString());
-        lines.push('');
-    }
-    if (data.services.length > 0) {
-        const table = new Table({
-            head: ['Service', 'Calls', 'Cost'],
-            style: { head: ['cyan'] },
-            colAligns: ['left', 'right', 'right']
-        });
-        for (const s of data.services) {
-            table.push([s.serviceName, pluralize(s.callCount, 'call'), formatCurrency(s.cost)]);
-        }
-        table.push([
-            'Subtotal',
-            pluralize(data.serviceTotalCalls, 'call'),
-            formatCurrency(data.serviceTotalCost)
-        ]);
-        lines.push('API Costs:');
-        lines.push(table.toString());
-        lines.push('');
-    }
-    return lines.join('\n');
-}
-function formatVerbose(data) {
-    const lines = [];
-    if (data.llmCalls.length > 0) {
-        const head = ['Step', 'Model', 'Input', 'Output'];
-        const colAligns = ['left', 'left', 'right', 'right'];
-        if (data.verbose.hasCached) {
-            head.push('Cached');
-            colAligns.push('right');
-        }
-        if (data.verbose.hasReasoning) {
-            head.push('Reasoning');
-            colAligns.push('right');
-        }
-        head.push('Cost');
-        colAligns.push('right');
-        const table = new Table({
-            head,
-            style: { head: ['cyan'] },
-            colAligns
-        });
-        for (const r of data.llmCalls) {
-            const row = [
-                r.step,
-                r.model,
-                formatNumber(r.input),
-                formatNumber(r.output)
-            ];
-            if (data.verbose.hasCached) {
-                row.push(formatNumber(r.cached));
-            }
-            if (data.verbose.hasReasoning) {
-                row.push(formatNumber(r.reasoning));
-            }
-            row.push(formatCurrency(r.cost) + (r.warning ? ` (${r.warning})` : ''));
-            table.push(row);
-        }
-        const totalRow = [
-            'Subtotal',
-            '',
-            formatNumber(data.totalInputTokens),
-            formatNumber(data.totalOutputTokens)
-        ];
-        if (data.verbose.hasCached) {
-            totalRow.push(formatNumber(data.totalCachedTokens));
-        }
-        if (data.verbose.hasReasoning) {
-            totalRow.push(formatNumber(data.totalReasoningTokens));
-        }
-        totalRow.push(formatCurrency(data.llmTotalCost));
-        table.push(totalRow);
-        lines.push('LLM Calls:');
-        lines.push(table.toString());
-        lines.push('');
-    }
-    if (data.serviceDetails.length > 0) {
-        const table = new Table({
-            head: ['Service', 'Step', 'Usage', 'Cost'],
-            style: { head: ['cyan'] },
-            colAligns: ['left', 'left', 'right', 'right']
-        });
-        for (const service of data.serviceDetails) {
-            for (const call of service.calls) {
-                table.push([
-                    service.serviceName,
-                    call.step,
-                    call.usage,
-                    formatCurrency(call.cost)
-                ]);
-            }
-        }
-        table.push(['Subtotal', '', '', formatCurrency(data.serviceTotalCost)]);
-        lines.push('API Calls:');
-        lines.push(table.toString());
-        lines.push('');
-    }
-    return lines.join('\n');
-}
-export function formatCostReport(report, options = {}) {
-    const data = parseCostData(report);
-    const lines = [];
-    lines.push('');
-    lines.push(`Trace: ${data.traceFile}`);
-    lines.push(`Workflow: ${data.workflowName}`);
-    lines.push(`Duration: ${data.duration}`);
-    lines.push('');
-    if (options.verbose) {
-        lines.push(formatVerbose(data));
-    }
-    else {
-        lines.push(formatSummary(data));
-    }
-    if (!data.isEmpty) {
-        const totalTable = new Table({
-            style: { head: [] },
-            colAligns: ['left', 'right'],
-            colWidths: [36, 12]
-        });
-        totalTable.push(['TOTAL ESTIMATED COST', formatCurrency(data.totalCost)]);
-        lines.push(totalTable.toString());
-    }
-    if (data.unknownModels.length > 0) {
-        lines.push('');
-        lines.push(`Warning: Unknown models (add to config/costs.yml): ${data.unknownModels.join(', ')}`);
-    }
-    if (data.isEmpty) {
-        lines.push('No billable calls found in trace.');
-    }
-    lines.push('');
-    return lines.join('\n');
-}

package/dist/utils/date_formatter.d.ts

@@ -1,23 +0,0 @@
-/**
- * Format a duration in milliseconds to a human-readable string.
- * Uses date-fns for durations >= 1 minute, custom formatting for shorter durations.
- *
- * @param ms - Duration in milliseconds
- * @returns Formatted duration string (e.g., "150ms", "2.50s", "3 minutes 45 seconds")
- */
-export declare function formatDuration(ms: number): string;
-/**
- * Format an ISO date string to a human-readable format
- *
- * @param isoString - ISO 8601 date string
- * @returns Formatted date string (e.g., "Dec 3, 2025 10:30 AM")
- */
-export declare function formatDate(isoString: string | null | undefined): string;
-/**
- * Format a duration between two ISO timestamps
- *
- * @param startedAt - ISO 8601 start timestamp
- * @param completedAt - ISO 8601 end timestamp (or null if still running)
- * @returns Human-readable duration string (e.g., "5 seconds", "running")
- */
-export declare function formatDurationFromTimestamps(startedAt: string, completedAt: string | null | undefined): string;

package/dist/utils/date_formatter.js

@@ -1,49 +0,0 @@
-/**
- * Date and duration formatting utilities
- */
-import { format, formatDistanceStrict, formatDuration as formatDurationFns, intervalToDuration, parseISO } from 'date-fns';
-/**
- * Format a duration in milliseconds to a human-readable string.
- * Uses date-fns for durations >= 1 minute, custom formatting for shorter durations.
- *
- * @param ms - Duration in milliseconds
- * @returns Formatted duration string (e.g., "150ms", "2.50s", "3 minutes 45 seconds")
- */
-export function formatDuration(ms) {
-    const duration = intervalToDuration({ start: 0, end: ms });
-    if (ms < 1000) {
-        return `${ms}ms`;
-    }
-    if (ms < 60000) {
-        const seconds = ms / 1000;
-        return `${seconds.toFixed(2)}s`;
-    }
-    return formatDurationFns(duration, { format: ['minutes', 'seconds'] });
-}
-/**
- * Format an ISO date string to a human-readable format
- *
- * @param isoString - ISO 8601 date string
- * @returns Formatted date string (e.g., "Dec 3, 2025 10:30 AM")
- */
-export function formatDate(isoString) {
-    if (!isoString) {
-        return '-';
-    }
-    return format(parseISO(isoString), 'MMM d, yyyy h:mm a');
-}
-/**
- * Format a duration between two ISO timestamps
- *
- * @param startedAt - ISO 8601 start timestamp
- * @param completedAt - ISO 8601 end timestamp (or null if still running)
- * @returns Human-readable duration string (e.g., "5 seconds", "running")
- */
-export function formatDurationFromTimestamps(startedAt, completedAt) {
-    if (!completedAt) {
-        return 'running';
-    }
-    const start = parseISO(startedAt);
-    const end = parseISO(completedAt);
-    return formatDistanceStrict(start, end, { addSuffix: false });
-}

package/dist/utils/env_loader.d.ts

@@ -1 +0,0 @@
-export declare function loadEnvironment(): void;

package/dist/utils/env_loader.js

@@ -1,22 +0,0 @@
-/**
- * Environment loader utility
- * Loads .env file from the current working directory
- * Set OUTPUT_CLI_ENV to specify a custom env file path
- */
-import { existsSync } from 'node:fs';
-import { resolve } from 'node:path';
-import * as dotenv from 'dotenv';
-import debugFactory from 'debug';
-import { config } from '#config.js';
-const debug = debugFactory('output-cli:env-loader');
-export function loadEnvironment() {
-    const cwd = process.cwd();
-    const envFile = config.envFile;
-    const envPath = resolve(cwd, envFile);
-    if (!existsSync(envPath)) {
-        debug(`Warning: Env file not found: ${envPath}`);
-        return;
-    }
-    debug(`Loading env from: ${envPath}`);
-    dotenv.config({ path: envPath, quiet: true });
-}

package/dist/utils/env_loader.spec.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/utils/env_loader.spec.js

@@ -1,43 +0,0 @@
-/**
- * Tests for the env loader utility
- */
-import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
-import { existsSync } from 'node:fs';
-import { resolve } from 'node:path';
-import * as dotenv from 'dotenv';
-vi.mock('node:fs');
-vi.mock('dotenv');
-describe('loadEnvironment', () => {
-    const originalEnv = { ...process.env };
-    const mockCwd = '/mock/project';
-    beforeEach(() => {
-        vi.resetModules();
-        vi.clearAllMocks();
-        vi.spyOn(process, 'cwd').mockReturnValue(mockCwd);
-        vi.spyOn(console, 'log').mockImplementation(() => { });
-        vi.spyOn(console, 'warn').mockImplementation(() => { });
-    });
-    afterEach(() => {
-        process.env = { ...originalEnv };
-        vi.restoreAllMocks();
-    });
-    it('should load from OUTPUT_CLI_ENV when set and file exists', async () => {
-        process.env.OUTPUT_CLI_ENV = '.env.prod';
-        const expectedPath = resolve(mockCwd, '.env.prod');
-        vi.mocked(existsSync).mockReturnValue(true);
-        vi.mocked(dotenv.config).mockReturnValue({ parsed: { OUTPUT_API_URL: 'https://prod.api.com' } });
-        const { loadEnvironment } = await import('./env_loader.js');
-        loadEnvironment();
-        expect(dotenv.config).toHaveBeenCalledWith({ path: expectedPath, quiet: true });
-    });
-    it('should load .env by default and log', async () => {
-        delete process.env.OUTPUT_CLI_ENV;
-        const envPath = resolve(mockCwd, '.env');
-        vi.mocked(existsSync).mockImplementation(p => p === envPath);
-        vi.mocked(dotenv.config).mockReturnValue({ parsed: {} });
-        const { loadEnvironment } = await import('./env_loader.js');
-        loadEnvironment();
-        expect(dotenv.config).toHaveBeenCalledTimes(1);
-        expect(dotenv.config).toHaveBeenCalledWith({ path: envPath, quiet: true });
-    });
-});

package/dist/utils/error_handler.d.ts

@@ -1,8 +0,0 @@
-type ErrorOverrides = {
-    [statusCode: number]: string;
-    ECONNREFUSED?: string;
-};
-export declare function handleApiError(error: unknown, errorFn: (...args: [message: string, options: {
-    exit: number;
-}]) => never, overrides?: ErrorOverrides): never;
-export {};

package/dist/utils/error_handler.js

@@ -1,71 +0,0 @@
-import { config } from '#config.js';
-const DEFAULT_MESSAGES = {
-    ECONNREFUSED: `Connection refused to ${config.apiUrl}. Is the API server running?`,
-    401: 'Authentication failed. Check your OUTPUT_API_AUTH_TOKEN.',
-    404: 'Resource not found.',
-    500: 'Server error.',
-    UNKNOWN: 'An unknown error occurred.'
-};
-/**
- * Extract error type and message from API response data
- */
-function extractApiErrorDetails(data) {
-    const errorData = data;
-    if (!errorData?.error && !errorData?.message) {
-        return null;
-    }
-    const errorType = errorData.error || 'Error';
-    const baseMsg = errorData.message || 'Unknown error';
-    const rootCauseLine = errorData.rootCause ?
-        `\n${errorData.rootCause.error}: ${errorData.rootCause.message}` :
-        '';
-    return { errorType, errorMsg: `${baseMsg}.${rootCauseLine}` };
-}
-/**
- * Extract detailed error information from fetch errors and their causes
- */
-function getDetailedErrorMessage(error) {
-    const apiError = error;
-    const parts = [];
-    if (apiError.message) {
-        parts.push(apiError.message);
-    }
-    if (apiError.cause) {
-        const cause = apiError.cause;
-        if (cause.message && cause.message !== apiError.message) {
-            parts.push(`Cause: ${cause.message}`);
-        }
-        if (cause.code) {
-            parts.push(`Code: ${cause.code}`);
-        }
-        if (cause.hostname) {
-            parts.push(`Host: ${cause.hostname}${cause.port ? ':' + cause.port : ''}`);
-        }
-    }
-    if (apiError.response?.status) {
-        parts.push(`HTTP Status: ${apiError.response.status}`);
-    }
-    return parts.length > 0 ? parts.join(' | ') : 'Unknown error';
-}
-export function handleApiError(error, errorFn, overrides = {}) {
-    const apiError = error;
-    const errorMessages = { ...DEFAULT_MESSAGES, ...overrides };
-    if (apiError.code === 'ECONNREFUSED' || apiError.cause?.code === 'ECONNREFUSED') {
-        errorFn(errorMessages.ECONNREFUSED, { exit: 1 });
-    }
-    if (apiError.response?.status) {
-        const status = apiError.response.status;
-        // Extract error details from response body
-        const apiErrorDetails = extractApiErrorDetails(apiError.response.data);
-        if (apiErrorDetails) {
-            const { errorType, errorMsg } = apiErrorDetails;
-            errorFn(`${errorType}: ${errorMsg}`, { exit: 1 });
-        }
-        const message = errorMessages[status];
-        if (message) {
-            errorFn(message, { exit: 1 });
-        }
-    }
-    const detailedMessage = getDetailedErrorMessage(error);
-    errorFn(detailedMessage, { exit: 1 });
-}

package/dist/utils/error_utils.d.ts

@@ -1,24 +0,0 @@
-/**
- * Type guard to check if an unknown value is an Error object
- */
-export declare function isError(error: unknown): error is Error;
-/**
- * Type guard to check if an error is a Node.js system error
- */
-export declare function isNodeError(error: unknown): error is NodeJS.ErrnoException;
-/**
- * Safely extract an error message from an unknown error type
- */
-export declare function getErrorMessage(error: unknown): string;
-/**
- * Safely extract an error code from a Node.js error
- */
-export declare function getErrorCode(error: unknown): string | undefined;
-/**
- * Convert an unknown error to a proper Error object
- */
-export declare function toError(error: unknown): Error;
-/**
- * Create a formatted error message with optional context
- */
-export declare function formatError(error: unknown, context?: string): string;

package/dist/utils/error_utils.js

@@ -1,87 +0,0 @@
-/**
- * Type guard to check if an unknown value is an Error object
- */
-export function isError(error) {
-    return (error instanceof Error ||
-        (typeof error === 'object' &&
-            error !== null &&
-            'message' in error &&
-            typeof error.message === 'string'));
-}
-/**
- * Type guard to check if an error is a Node.js system error
- */
-export function isNodeError(error) {
-    return isError(error) && 'code' in error;
-}
-/**
- * Safely extract an error message from an unknown error type
- */
-export function getErrorMessage(error) {
-    if (isError(error)) {
-        return error.message;
-    }
-    if (typeof error === 'string') {
-        return error;
-    }
-    // Handle objects with a code property (like Node.js errors)
-    if (error && typeof error === 'object' && 'code' in error) {
-        const errorObj = error;
-        if (errorObj.message) {
-            return errorObj.message;
-        }
-        if (errorObj.code) {
-            return `Error: ${errorObj.code}`;
-        }
-    }
-    // Handle objects with a custom toString
-    if (error && typeof error === 'object' && 'toString' in error) {
-        const str = String(error);
-        // Avoid returning '[object Object]'
-        if (str !== '[object Object]') {
-            return str;
-        }
-    }
-    // Try to extract any useful information from the object
-    if (error && typeof error === 'object') {
-        try {
-            const json = JSON.stringify(error);
-            if (json && json !== '{}') {
-                return `Error: ${json}`;
-            }
-        }
-        catch {
-            // Ignore circular reference errors
-        }
-    }
-    return 'An unknown error occurred';
-}
-/**
- * Safely extract an error code from a Node.js error
- */
-export function getErrorCode(error) {
-    // Check if it's a proper Node.js error with a code
-    if (isNodeError(error)) {
-        return error.code;
-    }
-    // Also handle plain objects with a code property (like mocked errors in tests)
-    return error && typeof error === 'object' && 'code' in error ?
-        error.code :
-        undefined;
-}
-/**
- * Convert an unknown error to a proper Error object
- */
-export function toError(error) {
-    if (isError(error)) {
-        return error;
-    }
-    return new Error(getErrorMessage(error));
-}
-/**
- * Create a formatted error message with optional context
- */
-export function formatError(error, context) {
-    const message = getErrorMessage(error);
-    return context ? `${context}: ${message}` : message;
-}

package/dist/utils/file_system.d.ts

@@ -1,3 +0,0 @@
-export declare function directoryExists(dirPath: string): boolean;
-export declare function createDirectory(dirPath: string): void;
-export declare function removeDirectory(dirPath: string, onError?: (message: string) => void): void;

package/dist/utils/file_system.js

@@ -1,33 +0,0 @@
-import fs from 'node:fs';
-import { FolderAlreadyExistsError } from '#types/errors.js';
-import { getErrorCode, getErrorMessage } from './error_utils.js';
-export function directoryExists(dirPath) {
-    try {
-        fs.accessSync(dirPath);
-        return true;
-    }
-    catch (error) {
-        if (getErrorCode(error) === 'ENOENT') {
-            return false;
-        }
-        throw error;
-    }
-}
-export function createDirectory(dirPath) {
-    const exists = directoryExists(dirPath);
-    if (exists) {
-        throw new FolderAlreadyExistsError(dirPath);
-    }
-    fs.mkdirSync(dirPath, { recursive: true });
-}
-export function removeDirectory(dirPath, onError) {
-    try {
-        fs.rmSync(dirPath, { recursive: true, force: true });
-    }
-    catch (error) {
-        const message = getErrorMessage(error);
-        if (onError) {
-            onError(`Failed to cleanup folder: ${message}`);
-        }
-    }
-}

package/dist/utils/format_workflow_result.d.ts

@@ -1,5 +0,0 @@
-import type { GetWorkflowIdResult200, GetWorkflowIdResult200Status } from '../api/generated/api.js';
-type WorkflowResult = Pick<GetWorkflowIdResult200, 'workflowId' | 'output' | 'status' | 'error'>;
-export declare const ERROR_STATUSES: ReadonlySet<GetWorkflowIdResult200Status | undefined>;
-export declare function formatWorkflowResult(result: WorkflowResult): string;
-export {};

package/dist/utils/format_workflow_result.js

@@ -1,18 +0,0 @@
-export const ERROR_STATUSES = new Set(['failed', 'canceled', 'terminated', 'timed_out']);
-export function formatWorkflowResult(result) {
-    const lines = [
-        `Workflow ID: ${result.workflowId || 'unknown'}`,
-        ''
-    ];
-    if (result.status === 'completed') {
-        lines.push('Output:');
-        lines.push(JSON.stringify(result.output, null, 2));
-    }
-    else {
-        lines.push(`Status: ${result.status || 'unknown'}`);
-        if (result.error) {
-            lines.push(`Error: ${result.error}`);
-        }
-    }
-    return lines.join('\n');
-}

package/dist/utils/format_workflow_result.spec.d.ts

@@ -1 +0,0 @@
-export {};