@jonnyhoo/ccs 1.0.0

package/dist/cliproxy/management-api-client.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Management API Client for CLIProxyAPI
+ *
+ * HTTP client for CLIProxy Management API endpoints.
+ * Handles authentication, error mapping, and provides typed methods for CRUD operations.
+ */
+import type { ManagementClientConfig, ManagementHealthStatus, ClaudeKey, ClaudeKeyPatch } from './management-api-types';
+/**
+ * Management API Client for CLIProxyAPI.
+ * Provides typed methods for CRUD operations on claude-api-key configuration.
+ */
+export declare class ManagementApiClient {
+    private readonly config;
+    private readonly timeout;
+    constructor(config: ManagementClientConfig);
+    /**
+     * Build base URL for display purposes.
+     */
+    getBaseUrl(): string;
+    /**
+     * Check health of Management API.
+     * Uses GET /v0/management/claude-api-key as health check.
+     */
+    health(): Promise<ManagementHealthStatus>;
+    /**
+     * Get all claude-api-key entries from remote CLIProxy.
+     */
+    getClaudeKeys(): Promise<ClaudeKey[]>;
+    /**
+     * Replace all claude-api-key entries on remote CLIProxy.
+     * This is an atomic operation - all entries are replaced at once.
+     */
+    putClaudeKeys(keys: ClaudeKey[]): Promise<void>;
+    /**
+     * Update a single claude-api-key entry by index or api-key match.
+     */
+    patchClaudeKey(patch: ClaudeKeyPatch): Promise<void>;
+    /**
+     * Delete a claude-api-key entry by api-key value.
+     */
+    deleteClaudeKey(apiKey: string): Promise<void>;
+    /**
+     * Make an HTTP request to the Management API.
+     */
+    private request;
+    /**
+     * Make request using native fetch API.
+     */
+    private requestWithFetch;
+    /**
+     * Make request using native https module for self-signed cert support.
+     */
+    private requestWithHttps;
+}
+/**
+ * Create a ManagementApiClient from CCS config.
+ * Uses cliproxy_server.remote settings.
+ */
+export declare function createManagementClient(remoteConfig: {
+    host: string;
+    port?: number;
+    protocol: 'http' | 'https';
+    management_key?: string;
+    auth_token?: string;
+    timeout?: number;
+}, allowSelfSigned?: boolean): ManagementApiClient;
+//# sourceMappingURL=management-api-client.d.ts.map

package/dist/cliproxy/management-api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"management-api-client.d.ts","sourceRoot":"","sources":["../../src/cliproxy/management-api-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,sBAAsB,EACtB,sBAAsB,EAEtB,SAAS,EAET,cAAc,EACf,MAAM,wBAAwB,CAAC;AA2GhC;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAyB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,sBAAsB;IAK1C;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,sBAAsB,CAAC;IAsB/C;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;IAQ3C;;;OAGG;IACG,aAAa,CAAC,IAAI,EAAE,SAAS,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrD;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpD;;OAEG;YACW,OAAO;IAwBrB;;OAEG;YACW,gBAAgB;IA4D9B;;OAEG;YACW,gBAAgB;CAoF/B;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,EACD,eAAe,UAAO,GACrB,mBAAmB,CASrB"}

package/dist/cliproxy/management-api-client.js

@@ -0,0 +1,347 @@
+"use strict";
+/**
+ * Management API Client for CLIProxyAPI
+ *
+ * HTTP client for CLIProxy Management API endpoints.
+ * Handles authentication, error mapping, and provides typed methods for CRUD operations.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createManagementClient = exports.ManagementApiClient = void 0;
+const https = __importStar(require("https"));
+/** Default timeout for management operations (longer than health check) */
+const DEFAULT_TIMEOUT_MS = 5000;
+/** Default port for HTTP protocol */
+const DEFAULT_HTTP_PORT = 8317;
+/** Default port for HTTPS protocol */
+const DEFAULT_HTTPS_PORT = 443;
+/**
+ * Get effective port based on config and protocol.
+ */
+function getEffectivePort(port, protocol) {
+    if (port !== undefined && Number.isInteger(port) && port > 0 && port <= 65535) {
+        return port;
+    }
+    return protocol === 'https' ? DEFAULT_HTTPS_PORT : DEFAULT_HTTP_PORT;
+}
+/**
+ * Build URL for Management API endpoint.
+ */
+function buildUrl(config, path) {
+    const port = getEffectivePort(config.port, config.protocol);
+    // Only omit port if it matches standard web ports
+    if ((config.protocol === 'https' && port === 443) ||
+        (config.protocol === 'http' && port === 80)) {
+        return `${config.protocol}://${config.host}${path}`;
+    }
+    return `${config.protocol}://${config.host}:${port}${path}`;
+}
+/**
+ * Map error to ManagementApiErrorCode.
+ */
+function mapErrorToCode(error, statusCode) {
+    const message = error.message.toLowerCase();
+    const rawCode = error.code;
+    const code = typeof rawCode === 'string' ? rawCode.toLowerCase() : undefined;
+    // DNS resolution failed
+    if (code === 'enotfound' || code === 'eai_again' || message.includes('dns')) {
+        return 'DNS_FAILED';
+    }
+    // Network unreachable
+    if (code === 'enetunreach' || code === 'ehostunreach' || message.includes('unreachable')) {
+        return 'NETWORK_UNREACHABLE';
+    }
+    // Connection refused
+    if (code === 'econnrefused' || message.includes('connection refused')) {
+        return 'CONNECTION_REFUSED';
+    }
+    // Timeout
+    if (code === 'etimedout' || message.includes('timeout') || message.includes('aborted')) {
+        return 'TIMEOUT';
+    }
+    // HTTP status codes
+    if (statusCode === 401 || statusCode === 403) {
+        return 'AUTH_FAILED';
+    }
+    if (statusCode === 404) {
+        return 'NOT_FOUND';
+    }
+    if (statusCode === 400) {
+        return 'BAD_REQUEST';
+    }
+    if (statusCode && statusCode >= 500) {
+        return 'SERVER_ERROR';
+    }
+    return 'UNKNOWN';
+}
+/**
+ * Get human-readable error message from error code.
+ */
+function getErrorMessage(errorCode, rawError) {
+    switch (errorCode) {
+        case 'CONNECTION_REFUSED':
+            return 'Connection refused - is CLIProxy running?';
+        case 'TIMEOUT':
+            return 'Request timed out - server may be slow or unreachable';
+        case 'AUTH_FAILED':
+            return 'Authentication failed - check management key';
+        case 'DNS_FAILED':
+            return 'DNS lookup failed - check hostname';
+        case 'NETWORK_UNREACHABLE':
+            return 'Network unreachable - check if host is accessible';
+        case 'NOT_FOUND':
+            return 'Endpoint not found - check CLIProxy version';
+        case 'BAD_REQUEST':
+            return 'Invalid request - check payload format';
+        case 'SERVER_ERROR':
+            return 'Server error - check CLIProxy logs';
+        default:
+            return rawError || 'Request failed';
+    }
+}
+/**
+ * Management API Client for CLIProxyAPI.
+ * Provides typed methods for CRUD operations on claude-api-key configuration.
+ */
+class ManagementApiClient {
+    constructor(config) {
+        this.config = config;
+        this.timeout = config.timeout ?? DEFAULT_TIMEOUT_MS;
+    }
+    /**
+     * Build base URL for display purposes.
+     */
+    getBaseUrl() {
+        return buildUrl(this.config, '');
+    }
+    /**
+     * Check health of Management API.
+     * Uses GET /v0/management/claude-api-key as health check.
+     */
+    async health() {
+        const startTime = Date.now();
+        try {
+            const response = await this.request('GET', '/v0/management/claude-api-key');
+            const latencyMs = Date.now() - startTime;
+            return {
+                healthy: true,
+                latencyMs,
+                version: response.headers?.['x-cpa-version'],
+                commit: response.headers?.['x-cpa-commit'],
+            };
+        }
+        catch (error) {
+            const err = error;
+            return {
+                healthy: false,
+                error: err.message,
+                errorCode: err.errorCode ?? 'UNKNOWN',
+            };
+        }
+    }
+    /**
+     * Get all claude-api-key entries from remote CLIProxy.
+     */
+    async getClaudeKeys() {
+        const response = await this.request('GET', '/v0/management/claude-api-key');
+        return response.data?.['claude-api-key'] ?? [];
+    }
+    /**
+     * Replace all claude-api-key entries on remote CLIProxy.
+     * This is an atomic operation - all entries are replaced at once.
+     */
+    async putClaudeKeys(keys) {
+        await this.request('PUT', '/v0/management/claude-api-key', keys);
+    }
+    /**
+     * Update a single claude-api-key entry by index or api-key match.
+     */
+    async patchClaudeKey(patch) {
+        await this.request('PATCH', '/v0/management/claude-api-key', patch);
+    }
+    /**
+     * Delete a claude-api-key entry by api-key value.
+     */
+    async deleteClaudeKey(apiKey) {
+        const encodedKey = encodeURIComponent(apiKey);
+        await this.request('DELETE', `/v0/management/claude-api-key?api-key=${encodedKey}`);
+    }
+    /**
+     * Make an HTTP request to the Management API.
+     */
+    async request(method, path, body) {
+        const url = buildUrl(this.config, path);
+        const headers = {
+            Accept: 'application/json',
+            Authorization: `Bearer ${this.config.managementKey}`,
+        };
+        if (body !== undefined) {
+            headers['Content-Type'] = 'application/json';
+        }
+        // Use native https for self-signed cert support
+        if (this.config.protocol === 'https' && this.config.allowSelfSigned) {
+            return this.requestWithHttps(method, url, headers, body);
+        }
+        return this.requestWithFetch(method, url, headers, body);
+    }
+    /**
+     * Make request using native fetch API.
+     */
+    async requestWithFetch(method, url, headers, body) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.timeout);
+        try {
+            const response = await fetch(url, {
+                method,
+                headers,
+                body: body !== undefined ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            if (!response.ok) {
+                const errorCode = mapErrorToCode(new Error(response.statusText), response.status);
+                const error = new Error(getErrorMessage(errorCode));
+                error.statusCode = response.status;
+                error.errorCode = errorCode;
+                throw error;
+            }
+            // Extract headers we care about
+            const responseHeaders = {};
+            const version = response.headers.get('x-cpa-version');
+            const commit = response.headers.get('x-cpa-commit');
+            if (version)
+                responseHeaders['x-cpa-version'] = version;
+            if (commit)
+                responseHeaders['x-cpa-commit'] = commit;
+            // Parse JSON response if present
+            const text = await response.text();
+            let data;
+            if (text) {
+                try {
+                    data = JSON.parse(text);
+                }
+                catch {
+                    // Non-JSON response is ok for PUT/DELETE
+                }
+            }
+            return { data, headers: responseHeaders };
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            const err = error;
+            if (!err.errorCode) {
+                err.errorCode = mapErrorToCode(err, err.statusCode);
+                err.message = getErrorMessage(err.errorCode, err.message);
+            }
+            throw err;
+        }
+    }
+    /**
+     * Make request using native https module for self-signed cert support.
+     */
+    async requestWithHttps(method, url, headers, body) {
+        return new Promise((resolve, reject) => {
+            const agent = new https.Agent({ rejectUnauthorized: false });
+            const bodyStr = body !== undefined ? JSON.stringify(body) : undefined;
+            if (bodyStr) {
+                headers['Content-Length'] = Buffer.byteLength(bodyStr).toString();
+            }
+            const reqTimeout = setTimeout(() => {
+                reject(new Error('Request timeout'));
+            }, this.timeout);
+            const req = https.request(url, {
+                method,
+                headers,
+                agent,
+                timeout: this.timeout,
+            }, (res) => {
+                clearTimeout(reqTimeout);
+                let data = '';
+                res.on('data', (chunk) => (data += chunk));
+                res.on('end', () => {
+                    if (res.statusCode && (res.statusCode < 200 || res.statusCode >= 300)) {
+                        const errorCode = mapErrorToCode(new Error(res.statusMessage || ''), res.statusCode);
+                        const error = new Error(getErrorMessage(errorCode));
+                        error.statusCode = res.statusCode;
+                        error.errorCode = errorCode;
+                        reject(error);
+                        return;
+                    }
+                    const responseHeaders = {};
+                    const version = res.headers['x-cpa-version'];
+                    const commit = res.headers['x-cpa-commit'];
+                    if (typeof version === 'string')
+                        responseHeaders['x-cpa-version'] = version;
+                    if (typeof commit === 'string')
+                        responseHeaders['x-cpa-commit'] = commit;
+                    let parsed;
+                    if (data) {
+                        try {
+                            parsed = JSON.parse(data);
+                        }
+                        catch {
+                            // Non-JSON response is ok
+                        }
+                    }
+                    resolve({ data: parsed, headers: responseHeaders });
+                });
+            });
+            req.on('error', (err) => {
+                clearTimeout(reqTimeout);
+                const error = err;
+                error.errorCode = mapErrorToCode(err);
+                error.message = getErrorMessage(error.errorCode, err.message);
+                reject(error);
+            });
+            req.on('timeout', () => {
+                req.destroy();
+                const error = new Error('Request timeout');
+                error.errorCode = 'TIMEOUT';
+                reject(error);
+            });
+            if (bodyStr) {
+                req.write(bodyStr);
+            }
+            req.end();
+        });
+    }
+}
+exports.ManagementApiClient = ManagementApiClient;
+/**
+ * Create a ManagementApiClient from CCS config.
+ * Uses cliproxy_server.remote settings.
+ */
+function createManagementClient(remoteConfig, allowSelfSigned = true) {
+    return new ManagementApiClient({
+        host: remoteConfig.host,
+        port: remoteConfig.port,
+        protocol: remoteConfig.protocol,
+        managementKey: remoteConfig.management_key || remoteConfig.auth_token || '',
+        timeout: remoteConfig.timeout,
+        allowSelfSigned,
+    });
+}
+exports.createManagementClient = createManagementClient;
+//# sourceMappingURL=management-api-client.js.map

package/dist/cliproxy/management-api-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"management-api-client.js","sourceRoot":"","sources":["../../src/cliproxy/management-api-client.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,6CAA+B;AAU/B,2EAA2E;AAC3E,MAAM,kBAAkB,GAAG,IAAI,CAAC;AAEhC,qCAAqC;AACrC,MAAM,iBAAiB,GAAG,IAAI,CAAC;AAE/B,sCAAsC;AACtC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B;;GAEG;AACH,SAAS,gBAAgB,CAAC,IAAwB,EAAE,QAA0B;IAC5E,IAAI,IAAI,KAAK,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,IAAI,KAAK,EAAE,CAAC;QAC9E,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,iBAAiB,CAAC;AACvE,CAAC;AAED;;GAEG;AACH,SAAS,QAAQ,CAAC,MAA8B,EAAE,IAAY;IAC5D,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC5D,kDAAkD;IAClD,IACE,CAAC,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,IAAI,KAAK,GAAG,CAAC;QAC7C,CAAC,MAAM,CAAC,QAAQ,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC,EAC3C,CAAC;QACD,OAAO,GAAG,MAAM,CAAC,QAAQ,MAAM,MAAM,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC;IACtD,CAAC;IACD,OAAO,GAAG,MAAM,CAAC,QAAQ,MAAM,MAAM,CAAC,IAAI,IAAI,IAAI,GAAG,IAAI,EAAE,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,KAAY,EAAE,UAAmB;IACvD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAI,KAA+B,CAAC,IAAI,CAAC;IACtD,MAAM,IAAI,GAAG,OAAO,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAE7E,wBAAwB;IACxB,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5E,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,sBAAsB;IACtB,IAAI,IAAI,KAAK,aAAa,IAAI,IAAI,KAAK,cAAc,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QACzF,OAAO,qBAAqB,CAAC;IAC/B,CAAC;IAED,qBAAqB;IACrB,IAAI,IAAI,KAAK,cAAc,IAAI,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;QACtE,OAAO,oBAAoB,CAAC;IAC9B,CAAC;IAED,UAAU;IACV,IAAI,IAAI,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACvF,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,oBAAoB;IACpB,IAAI,UAAU,KAAK,GAAG,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;QAC7C,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;QACvB,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;QACvB,OAAO,aAAa,CAAC;IACvB,CAAC;IACD,IAAI,UAAU,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;QACpC,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,SAAiC,EAAE,QAAiB;IAC3E,QAAQ,SAAS,EAAE,CAAC;QAClB,KAAK,oBAAoB;YACvB,OAAO,2CAA2C,CAAC;QACrD,KAAK,SAAS;YACZ,OAAO,uDAAuD,CAAC;QACjE,KAAK,aAAa;YAChB,OAAO,8CAA8C,CAAC;QACxD,KAAK,YAAY;YACf,OAAO,oCAAoC,CAAC;QAC9C,KAAK,qBAAqB;YACxB,OAAO,mDAAmD,CAAC;QAC7D,KAAK,WAAW;YACd,OAAO,6CAA6C,CAAC;QACvD,KAAK,aAAa;YAChB,OAAO,wCAAwC,CAAC;QAClD,KAAK,cAAc;YACjB,OAAO,oCAAoC,CAAC;QAC9C;YACE,OAAO,QAAQ,IAAI,gBAAgB,CAAC;IACxC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAa,mBAAmB;IAI9B,YAAY,MAA8B;QACxC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,OAAO,IAAI,kBAAkB,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,UAAU;QACR,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,MAAM;QACV,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,+BAA+B,CAAC,CAAC;YAC5E,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;YAEzC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,SAAS;gBACT,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,eAAe,CAAC;gBAC5C,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,cAAc,CAAC;aAC3C,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG,GAAG,KAA4E,CAAC;YACzF,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,GAAG,CAAC,OAAO;gBAClB,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,SAAS;aACtC,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa;QACjB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CACjC,KAAK,EACL,+BAA+B,CAChC,CAAC;QACF,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC;IACjD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa,CAAC,IAAiB;QACnC,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,+BAA+B,EAAE,IAAI,CAAC,CAAC;IACnE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,KAAqB;QACxC,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,+BAA+B,EAAE,KAAK,CAAC,CAAC;IACtE,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,MAAc;QAClC,MAAM,UAAU,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,yCAAyC,UAAU,EAAE,CAAC,CAAC;IACtF,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,OAAO,CACnB,MAAc,EACd,IAAY,EACZ,IAAc;QAEd,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAExC,MAAM,OAAO,GAA2B;YACtC,MAAM,EAAE,kBAAkB;YAC1B,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE;SACrD,CAAC;QAEF,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvB,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;QAC/C,CAAC;QAED,gDAAgD;QAChD,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,eAAe,EAAE,CAAC;YACpE,OAAO,IAAI,CAAC,gBAAgB,CAAI,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO,IAAI,CAAC,gBAAgB,CAAI,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB,CAC5B,MAAc,EACd,GAAW,EACX,OAA+B,EAC/B,IAAc;QAEd,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAErE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;gBAChC,MAAM;gBACN,OAAO;gBACP,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC3D,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;YAEH,YAAY,CAAC,SAAS,CAAC,CAAC;YAExB,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;gBAClF,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,eAAe,CAAC,SAAS,CAAC,CAGjD,CAAC;gBACF,KAAK,CAAC,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC;gBACnC,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;gBAC5B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,gCAAgC;YAChC,MAAM,eAAe,GAA2B,EAAE,CAAC;YACnD,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YACtD,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YACpD,IAAI,OAAO;gBAAE,eAAe,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC;YACxD,IAAI,MAAM;gBAAE,eAAe,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC;YAErD,iCAAiC;YACjC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,IAAmB,CAAC;YACxB,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,CAAC;oBACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;gBAC/B,CAAC;gBAAC,MAAM,CAAC;oBACP,yCAAyC;gBAC3C,CAAC;YACH,CAAC;YAED,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,SAAS,CAAC,CAAC;YACxB,MAAM,GAAG,GAAG,KAA4E,CAAC;YACzF,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;gBACnB,GAAG,CAAC,SAAS,GAAG,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;gBACpD,GAAG,CAAC,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;YAC5D,CAAC;YACD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB,CAC5B,MAAc,EACd,GAAW,EACX,OAA+B,EAC/B,IAAc;QAEd,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,KAAK,CAAC,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC,CAAC;YAC7D,MAAM,OAAO,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAEtE,IAAI,OAAO,EAAE,CAAC;gBACZ,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,CAAC;YACpE,CAAC;YAED,MAAM,UAAU,GAAG,UAAU,CAAC,GAAG,EAAE;gBACjC,MAAM,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;YACvC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAEjB,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CACvB,GAAG,EACH;gBACE,MAAM;gBACN,OAAO;gBACP,KAAK;gBACL,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,EACD,CAAC,GAAG,EAAE,EAAE;gBACN,YAAY,CAAC,UAAU,CAAC,CAAC;gBACzB,IAAI,IAAI,GAAG,EAAE,CAAC;gBACd,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC;gBAC3C,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;oBACjB,IAAI,GAAG,CAAC,UAAU,IAAI,CAAC,GAAG,CAAC,UAAU,GAAG,GAAG,IAAI,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,EAAE,CAAC;wBACtE,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;wBACrF,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,eAAe,CAAC,SAAS,CAAC,CAGjD,CAAC;wBACF,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC;wBAClC,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;wBAC5B,MAAM,CAAC,KAAK,CAAC,CAAC;wBACd,OAAO;oBACT,CAAC;oBAED,MAAM,eAAe,GAA2B,EAAE,CAAC;oBACnD,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;oBAC7C,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;oBAC3C,IAAI,OAAO,OAAO,KAAK,QAAQ;wBAAE,eAAe,CAAC,eAAe,CAAC,GAAG,OAAO,CAAC;oBAC5E,IAAI,OAAO,MAAM,KAAK,QAAQ;wBAAE,eAAe,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC;oBAEzE,IAAI,MAAqB,CAAC;oBAC1B,IAAI,IAAI,EAAE,CAAC;wBACT,IAAI,CAAC;4BACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAM,CAAC;wBACjC,CAAC;wBAAC,MAAM,CAAC;4BACP,0BAA0B;wBAC5B,CAAC;oBACH,CAAC;oBAED,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAAC;gBACtD,CAAC,CAAC,CAAC;YACL,CAAC,CACF,CAAC;YAEF,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACtB,YAAY,CAAC,UAAU,CAAC,CAAC;gBACzB,MAAM,KAAK,GAAG,GAAqD,CAAC;gBACpE,KAAK,CAAC,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;gBACtC,KAAK,CAAC,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;gBAC9D,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;YAEH,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;gBACrB,GAAG,CAAC,OAAO,EAAE,CAAC;gBACd,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,iBAAiB,CAAkD,CAAC;gBAC5F,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;gBAC5B,MAAM,CAAC,KAAK,CAAC,CAAC;YAChB,CAAC,CAAC,CAAC;YAEH,IAAI,OAAO,EAAE,CAAC;gBACZ,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACrB,CAAC;YACD,GAAG,CAAC,GAAG,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AA7PD,kDA6PC;AAED;;;GAGG;AACH,SAAgB,sBAAsB,CACpC,YAOC,EACD,eAAe,GAAG,IAAI;IAEtB,OAAO,IAAI,mBAAmB,CAAC;QAC7B,IAAI,EAAE,YAAY,CAAC,IAAI;QACvB,IAAI,EAAE,YAAY,CAAC,IAAI;QACvB,QAAQ,EAAE,YAAY,CAAC,QAAQ;QAC/B,aAAa,EAAE,YAAY,CAAC,cAAc,IAAI,YAAY,CAAC,UAAU,IAAI,EAAE;QAC3E,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,eAAe;KAChB,CAAC,CAAC;AACL,CAAC;AAnBD,wDAmBC"}

package/dist/cliproxy/management-api-types.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Management API Types for CLIProxyAPI
+ *
+ * Type definitions matching CLIProxyAPI Go structs for Management API CRUD operations.
+ * Used for syncing CCS API profiles to remote CLIProxy instance.
+ */
+/**
+ * Model alias within a ClaudeKey entry.
+ * Maps Claude model names to provider-specific models.
+ */
+export interface ClaudeModel {
+    /** Claude model name to match (e.g., "claude-3-5-sonnet") */
+    name: string;
+    /** Target model to use instead (e.g., "glm-4.7-airx-thinking") */
+    alias: string;
+}
+/**
+ * ClaudeKey configuration for CLIProxy.
+ * Maps to config.ClaudeKey in CLIProxyAPI Go code.
+ */
+export interface ClaudeKey {
+    /** API key for the provider */
+    'api-key': string;
+    /** Prefix for model name matching (e.g., "glm-" matches "glm-*" requests) */
+    prefix?: string;
+    /** Base URL for the provider API */
+    'base-url'?: string;
+    /** Optional proxy URL for requests */
+    'proxy-url'?: string;
+    /** Additional headers to include in requests */
+    headers?: Record<string, string>;
+    /** Models to exclude from this key */
+    'excluded-models'?: string[];
+    /** Model name to alias mappings */
+    models?: ClaudeModel[];
+}
+/**
+ * Configuration for the Management API client.
+ */
+export interface ManagementClientConfig {
+    /** Remote proxy host (IP or hostname) */
+    host: string;
+    /** Remote proxy port (default: 8317 for HTTP, 443 for HTTPS) */
+    port?: number;
+    /** Protocol to use (http or https) */
+    protocol: 'http' | 'https';
+    /** Management key for authentication (sent as Bearer token) */
+    managementKey: string;
+    /** Request timeout in milliseconds (default: 5000) */
+    timeout?: number;
+    /** Allow self-signed certificates for HTTPS (default: false) */
+    allowSelfSigned?: boolean;
+}
+/**
+ * Health check result from Management API.
+ */
+export interface ManagementHealthStatus {
+    /** Whether the Management API is reachable */
+    healthy: boolean;
+    /** Version of CLIProxyAPI (from X-CPA-VERSION header) */
+    version?: string;
+    /** Commit hash (from X-CPA-COMMIT header) */
+    commit?: string;
+    /** Latency in milliseconds */
+    latencyMs?: number;
+    /** Error message if not healthy */
+    error?: string;
+    /** Error code for programmatic handling */
+    errorCode?: ManagementApiErrorCode;
+}
+/**
+ * Error codes for Management API operations.
+ */
+export type ManagementApiErrorCode = 'CONNECTION_REFUSED' | 'TIMEOUT' | 'AUTH_FAILED' | 'DNS_FAILED' | 'NETWORK_UNREACHABLE' | 'NOT_FOUND' | 'BAD_REQUEST' | 'SERVER_ERROR' | 'UNKNOWN';
+/**
+ * Response from GET /v0/management/claude-api-key
+ */
+export interface GetClaudeKeysResponse {
+    'claude-api-key': ClaudeKey[];
+}
+/**
+ * Patch request body for updating a single ClaudeKey.
+ */
+export interface ClaudeKeyPatch {
+    /** Index of the key to update (0-based) */
+    index?: number;
+    /** Match by api-key value */
+    match?: string;
+    /** Fields to update */
+    value: Partial<ClaudeKey>;
+}
+/**
+ * Sync status for tracking sync operations.
+ */
+export interface SyncStatus {
+    /** Last sync timestamp (ISO 8601) */
+    lastSyncAt?: string;
+    /** Number of profiles synced */
+    profileCount: number;
+    /** Whether sync was successful */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** Remote CLIProxy URL */
+    remoteUrl?: string;
+}
+//# sourceMappingURL=management-api-types.d.ts.map

package/dist/cliproxy/management-api-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"management-api-types.d.ts","sourceRoot":"","sources":["../../src/cliproxy/management-api-types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;GAGG;AACH,MAAM,WAAW,SAAS;IACxB,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,mCAAmC;IACnC,MAAM,CAAC,EAAE,WAAW,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6CAA6C;IAC7C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,SAAS,CAAC,EAAE,sBAAsB,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAC9B,oBAAoB,GACpB,SAAS,GACT,aAAa,GACb,YAAY,GACZ,qBAAqB,GACrB,WAAW,GACX,aAAa,GACb,cAAc,GACd,SAAS,CAAC;AAEd;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,gBAAgB,EAAE,SAAS,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6BAA6B;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/cliproxy/management-api-types.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Management API Types for CLIProxyAPI
+ *
+ * Type definitions matching CLIProxyAPI Go structs for Management API CRUD operations.
+ * Used for syncing CCS API profiles to remote CLIProxy instance.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=management-api-types.js.map

package/dist/cliproxy/management-api-types.js.map

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

package/dist/cliproxy/model-catalog.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Model Catalog - Available models for CLI Proxy providers
+ *
+ * Ships with CCS to provide users with interactive model selection.
+ * Models are mapped to their internal names used by the proxy backend.
+ */
+import { CLIProxyProvider } from './types';
+/**
+ * Thinking support configuration for a model.
+ * Defines how thinking/reasoning budget can be controlled.
+ */
+export interface ThinkingSupport {
+    /** Type of thinking control: 'budget' (token count), 'levels' (named levels), 'none' */
+    type: 'budget' | 'levels' | 'none';
+    /** Minimum budget tokens (for budget type) */
+    min?: number;
+    /** Maximum budget tokens (for budget type) */
+    max?: number;
+    /** Valid level names (for levels type) */
+    levels?: string[];
+    /** Maximum reasoning effort level (caps effort at this level for levels type) */
+    maxLevel?: 'minimal' | 'low' | 'medium' | 'high' | 'xhigh';
+    /** Whether zero/disabled thinking is allowed */
+    zeroAllowed?: boolean;
+    /** Whether dynamic/auto thinking is allowed */
+    dynamicAllowed?: boolean;
+}
+/**
+ * Model entry definition
+ */
+export interface ModelEntry {
+    /** Literal model name to put in settings.json */
+    id: string;
+    /** Human-readable name for display */
+    name: string;
+    /** Access tier indicator - 'ultra' for Claude, 'pro' for premium Gemini, 'free' for basic */
+    tier?: 'free' | 'pro' | 'ultra';
+    /** Optional description for the model */
+    description?: string;
+    /** Model has known issues - show warning when selected */
+    broken?: boolean;
+    /** Issue URL for broken models */
+    issueUrl?: string;
+    /** Model is deprecated - show warning when selected */
+    deprecated?: boolean;
+    /** Deprecation reason/message */
+    deprecationReason?: string;
+    /** Thinking/reasoning support configuration */
+    thinking?: ThinkingSupport;
+}
+/**
+ * Provider catalog definition
+ */
+export interface ProviderCatalog {
+    provider: CLIProxyProvider;
+    displayName: string;
+    models: ModelEntry[];
+    defaultModel: string;
+}
+/**
+ * Model catalog for providers that support interactive configuration
+ *
+ * Models listed in order of recommendation (top = best)
+ */
+export declare const MODEL_CATALOG: Partial<Record<CLIProxyProvider, ProviderCatalog>>;
+/**
+ * Check if provider supports interactive model configuration
+ */
+export declare function supportsModelConfig(provider: CLIProxyProvider): boolean;
+/**
+ * Get catalog for provider
+ */
+export declare function getProviderCatalog(provider: CLIProxyProvider): ProviderCatalog | undefined;
+/**
+ * Find model entry by ID
+ * Note: Model IDs are normalized to lowercase for case-insensitive comparison
+ */
+export declare function findModel(provider: CLIProxyProvider, modelId: string): ModelEntry | undefined;
+/**
+ * Check if model has known issues
+ */
+export declare function isModelBroken(provider: CLIProxyProvider, modelId: string): boolean;
+/**
+ * Get issue URL for broken model
+ */
+export declare function getModelIssueUrl(provider: CLIProxyProvider, modelId: string): string | undefined;
+/**
+ * Check if model is deprecated
+ */
+export declare function isModelDeprecated(provider: CLIProxyProvider, modelId: string): boolean;
+/**
+ * Get deprecation reason for deprecated model
+ */
+export declare function getModelDeprecationReason(provider: CLIProxyProvider, modelId: string): string | undefined;
+/**
+ * Get thinking support configuration for a model
+ */
+export declare function getModelThinkingSupport(provider: CLIProxyProvider, modelId: string): ThinkingSupport | undefined;
+/**
+ * Get the maximum reasoning effort level for a model.
+ * Returns undefined if model has no cap or is not in catalog.
+ */
+export declare function getModelMaxLevel(provider: CLIProxyProvider, modelId: string): ThinkingSupport['maxLevel'] | undefined;
+/**
+ * Check if model supports thinking/reasoning
+ */
+export declare function supportsThinking(provider: CLIProxyProvider, modelId: string): boolean;
+//# sourceMappingURL=model-catalog.d.ts.map