ai.matey.cli 0.2.0

package/dist/types/utils/output-formatter.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Output Formatter Utility
+ *
+ * Formats output for terminal display.
+ * Handles colors, tables, and streaming output.
+ *
+ * @module cli/utils/output-formatter
+ */
+/**
+ * ANSI color codes.
+ */
+export declare const colors: {
+    reset: string;
+    bold: string;
+    dim: string;
+    black: string;
+    red: string;
+    green: string;
+    yellow: string;
+    blue: string;
+    magenta: string;
+    cyan: string;
+    white: string;
+    gray: string;
+    bgBlack: string;
+    bgRed: string;
+    bgGreen: string;
+    bgYellow: string;
+    bgBlue: string;
+    bgMagenta: string;
+    bgCyan: string;
+    bgWhite: string;
+};
+/**
+ * Enable or disable colored output.
+ */
+export declare function setColorsEnabled(enabled: boolean): void;
+/**
+ * Check if colors are enabled.
+ */
+export declare function areColorsEnabled(): boolean;
+/**
+ * Apply color to text.
+ */
+export declare function colorize(text: string, color: keyof typeof colors): string;
+/**
+ * Format text with multiple styles.
+ */
+export declare function style(text: string, ...styles: Array<keyof typeof colors>): string;
+/**
+ * Print success message.
+ */
+export declare function success(message: string): void;
+/**
+ * Print error message.
+ */
+export declare function error(message: string): void;
+/**
+ * Print warning message.
+ */
+export declare function warn(message: string): void;
+/**
+ * Print info message.
+ */
+export declare function info(message: string): void;
+/**
+ * Format a table.
+ */
+export interface TableColumn {
+    key: string;
+    header: string;
+    width?: number;
+    align?: 'left' | 'right';
+}
+export interface TableOptions {
+    columns: TableColumn[];
+    rows: Record<string, any>[];
+}
+export declare function formatTable(options: TableOptions): string;
+/**
+ * Format file size in human-readable format.
+ */
+export declare function formatSize(bytes: number): string;
+/**
+ * Format duration in human-readable format.
+ */
+export declare function formatDuration(ms: number): string;
+/**
+ * Format relative time (e.g., "2 minutes ago").
+ */
+export declare function formatRelativeTime(timestamp: number): string;
+/**
+ * Create a spinner for long-running operations.
+ */
+export declare class Spinner {
+    private frames;
+    private currentFrame;
+    private interval?;
+    private text;
+    constructor(text: string);
+    start(): void;
+    stop(finalMessage?: string): void;
+    succeed(message?: string): void;
+    fail(message?: string): void;
+}
+/**
+ * Print a box around text.
+ */
+export declare function printBox(text: string, options?: {
+    title?: string;
+    padding?: number;
+}): void;
+//# sourceMappingURL=output-formatter.d.ts.map

package/dist/types/utils/output-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output-formatter.d.ts","sourceRoot":"","sources":["../../../src/utils/output-formatter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;CAyBlB,CAAC;AAIF;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAE1C;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,OAAO,MAAM,GAAG,MAAM,CAKzE;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,KAAK,CAAC,MAAM,OAAO,MAAM,CAAC,GAAG,MAAM,CAMjF;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7C;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE3C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAE1C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,CAAC;CAC7B;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CA6BzD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAWhD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAajD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAiB5D;AAED;;GAEG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,MAAM,CAAsD;IACpE,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,QAAQ,CAAC,CAAiB;IAClC,OAAO,CAAC,IAAI,CAAS;gBAET,IAAI,EAAE,MAAM;IAIxB,KAAK,IAAI,IAAI;IAYb,IAAI,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI;IAcjC,OAAO,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAI/B,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;CAG7B;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,IAAI,CAkB/F"}

package/dist/types/utils/pipeline-inspector.d.ts

@@ -0,0 +1,50 @@
+/**
+ * CLI Pipeline Inspector - visualize pipeline execution
+ */
+export type DebugLevel = 'off' | 'error' | 'warn' | 'info' | 'debug' | 'trace';
+export type DebugEventType = 'pipeline_start' | 'pipeline_end' | 'middleware_start' | 'middleware_end' | 'adapter_call' | 'adapter_response' | 'adapter_stream_chunk' | 'error' | 'warning';
+export interface TraceStep {
+    readonly name: string;
+    readonly type: 'middleware' | 'adapter' | 'router';
+    readonly startTime: number;
+    readonly endTime?: number;
+    readonly duration?: number;
+    readonly input?: unknown;
+    readonly output?: unknown;
+    readonly error?: Error;
+    readonly metadata?: Record<string, unknown>;
+}
+export interface PipelineTrace {
+    readonly requestId: string;
+    readonly startTime: number;
+    readonly endTime?: number;
+    readonly duration?: number;
+    readonly events: readonly unknown[];
+    readonly steps: readonly TraceStep[];
+    readonly error?: Error;
+}
+export interface DebugStats {
+    readonly totalRequests: number;
+    readonly totalEvents: number;
+    readonly eventsByType: Record<DebugEventType, number>;
+    readonly averageDuration: number;
+    readonly errorCount: number;
+    readonly warningCount: number;
+}
+/**
+ * Format a trace for CLI display
+ */
+export declare function formatTrace(trace: PipelineTrace): string;
+/**
+ * Format multiple traces
+ */
+export declare function formatTraces(traces: readonly PipelineTrace[]): string;
+/**
+ * Format debug statistics
+ */
+export declare function formatStats(stats: DebugStats): string;
+/**
+ * Create a simple visualization of pipeline flow
+ */
+export declare function visualizePipeline(trace: PipelineTrace): string;
+//# sourceMappingURL=pipeline-inspector.d.ts.map

package/dist/types/utils/pipeline-inspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-inspector.d.ts","sourceRoot":"","sources":["../../../src/utils/pipeline-inspector.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAC/E,MAAM,MAAM,cAAc,GACtB,gBAAgB,GAChB,cAAc,GACd,kBAAkB,GAClB,gBAAgB,GAChB,cAAc,GACd,kBAAkB,GAClB,sBAAsB,GACtB,OAAO,GACP,SAAS,CAAC;AAEd,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,SAAS,GAAG,QAAQ,CAAC;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,OAAO,EAAE,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IACtD,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CA8BxD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,MAAM,CAMrE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAuBrD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,CAyB9D"}

package/dist/types/utils/state-manager.d.ts

@@ -0,0 +1,91 @@
+/**
+ * State Manager Utility
+ *
+ * Tracks running models and backend state for CLI.
+ * Used by `ps` command to show active models.
+ *
+ * @module cli/utils/state-manager
+ */
+export interface RunningModel {
+    /**
+     * Model name.
+     */
+    name: string;
+    /**
+     * Backend name/identifier.
+     */
+    backend: string;
+    /**
+     * Process ID (for model runners).
+     */
+    pid?: number;
+    /**
+     * Model size in bytes (if known).
+     */
+    size?: number;
+    /**
+     * When the model was started.
+     */
+    startTime: number;
+    /**
+     * Last activity timestamp.
+     */
+    lastActivity: number;
+    /**
+     * TTL in milliseconds (when to auto-stop).
+     */
+    ttl?: number;
+    /**
+     * Additional metadata.
+     */
+    metadata?: Record<string, any>;
+}
+/**
+ * Global state manager for running models.
+ */
+declare class StateManager {
+    private models;
+    private cleanupTimers;
+    /**
+     * Add a running model.
+     */
+    add(model: RunningModel): void;
+    /**
+     * Update last activity time.
+     */
+    touch(backend: string, modelName: string): void;
+    /**
+     * Remove a running model.
+     */
+    remove(backend: string, modelName: string): void;
+    /**
+     * Get a running model.
+     */
+    get(backend: string, modelName: string): RunningModel | undefined;
+    /**
+     * Get all running models.
+     */
+    getAll(): RunningModel[];
+    /**
+     * Get models by backend.
+     */
+    getByBackend(backend: string): RunningModel[];
+    /**
+     * Check if model is running.
+     */
+    isRunning(backend: string, modelName: string): boolean;
+    /**
+     * Clear all models.
+     */
+    clear(): void;
+    /**
+     * Schedule cleanup after TTL.
+     */
+    private scheduleCleanup;
+}
+/**
+ * Global state manager instance.
+ */
+export declare const stateManager: StateManager;
+export {};
+//# sourceMappingURL=state-manager.d.ts.map

package/dist/types/utils/state-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-manager.d.ts","sourceRoot":"","sources":["../../../src/utils/state-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED;;GAEG;AACH,cAAM,YAAY;IAChB,OAAO,CAAC,MAAM,CAAmC;IACjD,OAAO,CAAC,aAAa,CAAqC;IAE1D;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAU9B;;OAEG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAc/C;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI;IAYhD;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAKjE;;OAEG;IACH,MAAM,IAAI,YAAY,EAAE;IAIxB;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,EAAE;IAI7C;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAKtD;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;OAEG;IACH,OAAO,CAAC,eAAe;CAexB;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,cAAqB,CAAC"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "ai.matey.cli",
+  "version": "0.2.0",
+  "description": "CLI tools for AI Matey - proxy server, format converters, Ollama emulation",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    }
+  },
+  "bin": {
+    "ai-matey": "./dist/esm/main.js"
+  },
+  "files": [
+    "dist",
+    "readme.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "npm run build:esm && npm run build:cjs && npm run build:types",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:types": "tsc -p tsconfig.types.json",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "ai.matey.types": "*",
+    "ai.matey.core": "*",
+    "ai.matey.errors": "*",
+    "ai.matey.utils": "*",
+    "ai.matey.backend": "*",
+    "ai.matey.frontend": "*"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "keywords": [
+    "ai",
+    "llm",
+    "cli",
+    "proxy",
+    "ollama",
+    "converter",
+    "ai-matey"
+  ],
+  "author": "AI Matey",
+  "license": "MIT",
+  "homepage": "https://github.com/johnhenry/ai.matey#readme",
+  "bugs": {
+    "url": "https://github.com/johnhenry/ai.matey/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/johnhenry/ai.matey.git",
+    "directory": "packages/cli"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/readme.md

@@ -0,0 +1,32 @@
+# ai.matey.cli
+
+Command-line interface and conversion utilities
+
+Part of the [ai.matey](https://github.com/johnhenry/ai.matey) monorepo.
+
+## Installation
+
+```bash
+npm install ai.matey.cli
+```
+
+## Exports
+
+- `toOpenAIRequest`
+- `toAnthropicRequest`
+- `toOpenAI`
+- `toAnthropic`
+
+## Usage
+
+```typescript
+import { toOpenAIRequest, toAnthropicRequest, toOpenAI, toAnthropic } from 'ai.matey.cli';
+```
+
+## API Reference
+
+See the TypeScript definitions for detailed API documentation.
+
+## License
+
+MIT - see [LICENSE](./LICENSE) for details.