@kaitranntt/ccs 8.1.4 → 8.2.0-dev.10

package/dist/cliproxy/routing/routing-strategy-http.js

@@ -50,6 +50,7 @@ async function fetchCliproxyRoutingResponse(target, method, body) {
             clearTimeout(timeoutId);
         }
     }
+    const requestUrl = new URL(url);
     return new Promise((resolve, reject) => {
         const agent = new https.Agent({ rejectUnauthorized: false });
         let settled = false;
@@ -60,44 +61,52 @@ async function fetchCliproxyRoutingResponse(target, method, body) {
             clearTimeout(timeoutId);
             callback();
         };
+        let req;
         const timeoutId = setTimeout(() => {
             const error = new Error('Request timeout');
-            req.destroy(error);
+            req?.destroy(error);
             settle(() => reject(error));
         }, ROUTING_TIMEOUT_MS);
-        const req = https.request(url, {
-            method,
-            headers,
-            agent,
-            timeout: ROUTING_TIMEOUT_MS,
-        }, (res) => {
-            let payload = '';
-            res.setEncoding('utf8');
-            res.on('data', (chunk) => {
-                payload += chunk;
-            });
-            res.on('end', () => {
-                settle(() => resolve(new Response(payload, {
-                    status: res.statusCode || 500,
-                    statusText: res.statusMessage ?? '',
-                    headers: typeof res.headers['content-type'] === 'string'
-                        ? { 'Content-Type': res.headers['content-type'] }
-                        : undefined,
-                })));
+        try {
+            req = https.request(requestUrl, {
+                method,
+                headers,
+                agent,
+                timeout: ROUTING_TIMEOUT_MS,
+            }, (res) => {
+                let payload = '';
+                res.setEncoding('utf8');
+                res.on('data', (chunk) => {
+                    payload += chunk;
+                });
+                res.on('end', () => {
+                    settle(() => resolve(new Response(payload, {
+                        status: res.statusCode || 500,
+                        statusText: res.statusMessage ?? '',
+                        headers: typeof res.headers['content-type'] === 'string'
+                            ? { 'Content-Type': res.headers['content-type'] }
+                            : undefined,
+                    })));
+                });
             });
-        });
-        req.on('error', (error) => {
+        }
+        catch (error) {
+            settle(() => reject(error));
+            return;
+        }
+        const request = req;
+        request.on('error', (error) => {
             settle(() => reject(error));
         });
-        req.on('timeout', () => {
+        request.on('timeout', () => {
             const error = new Error('Request timeout');
-            req.destroy(error);
+            request.destroy(error);
             settle(() => reject(error));
         });
         if (body) {
-            req.write(JSON.stringify(body));
+            request.write(JSON.stringify(body));
         }
-        req.end();
+        request.end();
     });
 }
 exports.fetchCliproxyRoutingResponse = fetchCliproxyRoutingResponse;

package/dist/cliproxy/routing/routing-strategy-http.js.map

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

package/dist/cliproxy/routing/routing-strategy.d.ts

@@ -2,12 +2,138 @@ import type { CliproxyRoutingStrategy } from '../types';
 export declare const DEFAULT_CLIPROXY_ROUTING_STRATEGY: CliproxyRoutingStrategy;
 export declare const DEFAULT_CLIPROXY_SESSION_AFFINITY_ENABLED = false;
 export declare const DEFAULT_CLIPROXY_SESSION_AFFINITY_TTL = "1h";
+/**
+ * Pool routing defaults written to config when pool routing is enabled.
+ * fill-first + session affinity drains one account before using another,
+ * maximising per-account context depth while honouring cooldown windows.
+ */
+export declare const POOL_ROUTING_STRATEGY: CliproxyRoutingStrategy;
+export declare const POOL_SESSION_AFFINITY_ENABLED = true;
+export declare const POOL_SESSION_AFFINITY_TTL = "1h";
+export declare const POOL_MAX_RETRY_CREDENTIALS = 3;
+/**
+ * Providers for which pool routing is available and the opt-in prompt
+ * shows the full cooling/routing disclosure.  Others (codex, gemini)
+ * have failover behaviour that is unverified for pool routing; they get
+ * a softened prompt variant or no prompt until spike Test D confirms.
+ */
+export declare const POOL_ROUTING_VERIFIED_PROVIDERS: Set<string>;
+/**
+ * Minimum CLIProxy version that supports pool routing keys:
+ * max-retry-credentials and the cooling flip.
+ * Older binaries silently ignore unknown keys — pool rails would appear active
+ * but have no effect.  Warn the user at enable time if below this version.
+ *
+ * NOTE: Update this constant when upstream first ships these keys.
+ * Current best estimate based on spec; adjust after spike Test D confirms.
+ */
+export declare const POOL_ROUTING_MIN_VERSION = "6.9.45";
+export interface EnablePoolRoutingResult {
+    /** Whether the pool routing state actually changed */
+    changed: boolean;
+    /** Whether an existing explicit user routing setting was preserved */
+    preservedExplicitSetting: boolean;
+    /**
+     * True when the config could not be regenerated and the pool flag was rolled
+     * back.  Pool routing is NOT active; the message carries recovery guidance.
+     */
+    failed?: boolean;
+    message: string;
+}
+export interface DisablePoolRoutingResult {
+    changed: boolean;
+    /** True when the config could not be regenerated and the flag was rolled back. */
+    failed?: boolean;
+    message: string;
+}
+/**
+ * Detect whether the user has set a routing strategy that differs from the
+ * injected default (round-robin).
+ *
+ * Background: loadOrCreateUnifiedConfig persists injected defaults to disk on
+ * first load, so `strategy: round-robin` may appear in the raw YAML even on a
+ * pristine config — it was injected by CCS, not written by the user.  A stored
+ * value EQUAL to the default is therefore treated as NOT explicit so that
+ * enablePoolRouting does not falsely claim to be "preserving a custom strategy".
+ *
+ * A value that DIFFERS from the default (e.g. fill-first) is treated as
+ * user-managed: preserve it and warn.
+ */
+export declare function hasExplicitRoutingStrategy(): boolean;
+/**
+ * Detect whether the user has set session-affinity to a value that differs
+ * from the injected default (false).
+ *
+ * Same rationale as hasExplicitRoutingStrategy: loadOrCreateUnifiedConfig may
+ * persist `session_affinity: false` as a default, so presence alone is not
+ * sufficient — only a value that differs from the default counts as explicit.
+ */
+export declare function hasExplicitSessionAffinity(): boolean;
+/**
+ * Enable pool routing: write pool_routing.enabled = true and the canonical
+ * pool defaults (fill-first, session affinity 1h, max-retry-credentials: 3)
+ * to the CCS unified config.  Regenerates the CLIProxy config.yaml so the
+ * cooling flip and routing block take effect immediately (CLIProxy hot-reloads).
+ *
+ * Explicit user routing settings are preserved and a warning is emitted.
+ * The pool flag is written regardless — the generator uses fill-first/affinity
+ * from the pool defaults when pool is enabled, bypassing any stored routing.
+ *
+ * Idempotent: calling when already enabled is a no-op.
+ */
+export declare function enablePoolRouting(port: number, options?: {
+    configPath?: string;
+    authDir?: string;
+}): EnablePoolRoutingResult;
+/**
+ * Disable pool routing: clear pool_routing.enabled and restore the non-pool
+ * config defaults (disable-cooling: true, round-robin, no affinity).
+ * Regenerates the CLIProxy config.yaml.
+ *
+ * IMPORTANT: disablePoolRouting MUST explicitly restore routing to round-robin
+ * and session_affinity to false.  Simply clearing pool_routing.enabled is not
+ * sufficient because the upstream CLIProxy default for disable-cooling is false
+ * (cooling ON) when the key is absent.  Leaving cooling ON for a user who has
+ * disabled pool routing would reintroduce the single-account blackout that v5
+ * (commit fb77d72a) fixed.
+ *
+ * Idempotent: calling when already disabled is a no-op.
+ */
+export declare function disablePoolRouting(port: number, options?: {
+    configPath?: string;
+    authDir?: string;
+}): DisablePoolRoutingResult;
+/**
+ * Pool routing mode summary surfaced alongside routing state for the dashboard.
+ * When pool routing is enabled the generator forces fill-first + session affinity
+ * + cooling, regardless of stored routing values.
+ */
+export interface CliproxyPoolRoutingState {
+    enabled: boolean;
+    maxRetryCredentials?: number;
+    /**
+     * Whether CCS can manage pool routing for this target.  enablePoolRouting only
+     * writes LOCAL config files, so a remote proxy is never affected by the local
+     * pool flag.  For remote targets this is false and `enabled` reflects the local
+     * config only (not the remote proxy's behaviour).  Omitted (treated as true)
+     * for local targets.  Mirrors CliproxySessionAffinityState.manageable.
+     */
+    manageable?: boolean;
+    /** Explanation surfaced when manageable is false (remote target). */
+    message?: string;
+}
 export interface CliproxyRoutingState {
     strategy: CliproxyRoutingStrategy;
     source: 'live' | 'config';
     target: 'local' | 'remote';
     reachable: boolean;
     message?: string;
+    /**
+     * Pool routing mode. For local targets `enabled` reflects the active proxy
+     * config. For remote targets `manageable` is false and `enabled` reflects only
+     * the local config (the remote proxy is not affected by it).
+     */
+    poolRouting?: CliproxyPoolRoutingState;
 }
 export interface CliproxyRoutingApplyResult extends CliproxyRoutingState {
     applied: 'live' | 'live-and-config' | 'config-only';
@@ -34,6 +160,12 @@ export declare function normalizeCliproxySessionAffinityTtl(value: unknown): str
 export declare function getConfiguredCliproxyRoutingStrategy(): CliproxyRoutingStrategy;
 export declare function getConfiguredCliproxySessionAffinitySettings(): Required<CliproxySessionAffinitySettings>;
 export declare function fetchLiveCliproxyRoutingStrategy(): Promise<CliproxyRoutingStrategy>;
+/**
+ * Read the pool routing mode from the unified config.
+ * Pool routing is proxy-wide opt-in; this reflects the persisted flag, not a
+ * live selector probe.
+ */
+export declare function getCliproxyPoolRoutingState(): CliproxyPoolRoutingState;
 export declare function readCliproxyRoutingState(): Promise<CliproxyRoutingState>;
 export declare function readCliproxySessionAffinityState(): Promise<CliproxySessionAffinityState>;
 export declare function applyCliproxyRoutingStrategy(strategy: CliproxyRoutingStrategy): Promise<CliproxyRoutingApplyResult>;

package/dist/cliproxy/routing/routing-strategy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routing-strategy.d.ts","sourceRoot":"","sources":["../../../src/cliproxy/routing/routing-strategy.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAGxD,eAAO,MAAM,iCAAiC,EAAE,uBAAuC,CAAC;AACxF,eAAO,MAAM,yCAAyC,QAAQ,CAAC;AAC/D,eAAO,MAAM,qCAAqC,OAAO,CAAC;AAK1D,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,uBAAuB,CAAC;IAClC,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B,MAAM,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,0BAA2B,SAAQ,oBAAoB;IACtE,OAAO,EAAE,MAAM,GAAG,iBAAiB,GAAG,aAAa,CAAC;CACrD;AAED,MAAM,WAAW,+BAA+B;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,GAAG,aAAa,CAAC;IACjC,MAAM,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC3B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kCAAmC,SAAQ,4BAA4B;IACtF,OAAO,EAAE,aAAa,GAAG,aAAa,CAAC;CACxC;AAED,wBAAgB,gCAAgC,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,GAAG,IAAI,CAiB/F;AAED,wBAAgB,uCAAuC,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,GAAG,IAAI,CA0BtF;AAED,wBAAgB,mCAAmC,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAWjF;AAED,wBAAgB,oCAAoC,IAAI,uBAAuB,CAK9E;AAED,wBAAgB,4CAA4C,IAAI,QAAQ,CAAC,+BAA+B,CAAC,CAUxG;AAED,wBAAsB,gCAAgC,IAAI,OAAO,CAAC,uBAAuB,CAAC,CAezF;AAED,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,oBAAoB,CAAC,CA4B9E;AAED,wBAAsB,gCAAgC,IAAI,OAAO,CAAC,4BAA4B,CAAC,CA8B9F;AAED,wBAAsB,4BAA4B,CAChD,QAAQ,EAAE,uBAAuB,GAChC,OAAO,CAAC,0BAA0B,CAAC,CA4CrC;AAED,wBAAsB,oCAAoC,CACxD,QAAQ,EAAE,+BAA+B,GACxC,OAAO,CAAC,kCAAkC,CAAC,CAgD7C"}
+{"version":3,"file":"routing-strategy.d.ts","sourceRoot":"","sources":["../../../src/cliproxy/routing/routing-strategy.ts"],"names":[],"mappings":"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"}