@georgedong32/ccs 7.66.0

package/dist/errors/error-types.js

@@ -0,0 +1,170 @@
+"use strict";
+/**
+ * Custom error types for CCS CLI
+ *
+ * All custom errors extend CCSError which provides:
+ * - Standardized exit codes
+ * - Recoverable flag for retry logic
+ * - Consistent error formatting
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRecoverableError = exports.isCCSError = exports.ValidationError = exports.UserAbortError = exports.MigrationError = exports.ProxyError = exports.ProfileError = exports.ProviderError = exports.BinaryError = exports.AuthError = exports.NetworkError = exports.ConfigError = exports.CCSError = void 0;
+const exit_codes_1 = require("./exit-codes");
+/**
+ * Base error class for all CCS errors
+ * Extends standard Error with exit code and recovery information
+ */
+class CCSError extends Error {
+    constructor(message, code = exit_codes_1.ExitCode.GENERAL_ERROR, recoverable = false) {
+        super(message);
+        this.code = code;
+        this.recoverable = recoverable;
+        this.name = 'CCSError';
+        // Maintain proper stack trace in V8 environments
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+}
+exports.CCSError = CCSError;
+/**
+ * Configuration-related errors
+ * Examples: missing config file, invalid JSON, corrupt settings
+ */
+class ConfigError extends CCSError {
+    constructor(message, configPath) {
+        super(message, exit_codes_1.ExitCode.CONFIG_ERROR, false);
+        this.configPath = configPath;
+        this.name = 'ConfigError';
+    }
+}
+exports.ConfigError = ConfigError;
+/**
+ * Network-related errors
+ * Examples: connection refused, timeout, DNS resolution failure
+ */
+class NetworkError extends CCSError {
+    constructor(message, url, statusCode) {
+        super(message, exit_codes_1.ExitCode.NETWORK_ERROR, true); // Network errors are typically recoverable
+        this.url = url;
+        this.statusCode = statusCode;
+        this.name = 'NetworkError';
+    }
+}
+exports.NetworkError = NetworkError;
+/**
+ * Authentication/authorization errors
+ * Examples: invalid API key, expired token, insufficient permissions
+ */
+class AuthError extends CCSError {
+    constructor(message, provider) {
+        super(message, exit_codes_1.ExitCode.AUTH_ERROR, false);
+        this.provider = provider;
+        this.name = 'AuthError';
+    }
+}
+exports.AuthError = AuthError;
+/**
+ * Binary/executable errors
+ * Examples: Claude CLI not found, corrupted binary, permission denied
+ */
+class BinaryError extends CCSError {
+    constructor(message, binaryPath) {
+        super(message, exit_codes_1.ExitCode.BINARY_ERROR, false);
+        this.binaryPath = binaryPath;
+        this.name = 'BinaryError';
+    }
+}
+exports.BinaryError = BinaryError;
+/**
+ * Provider-specific errors
+ * Examples: API rate limit, service unavailable, invalid model
+ */
+class ProviderError extends CCSError {
+    constructor(message, provider, details) {
+        super(message, exit_codes_1.ExitCode.PROVIDER_ERROR, true); // Provider errors may be recoverable
+        this.provider = provider;
+        this.details = details;
+        this.name = 'ProviderError';
+    }
+}
+exports.ProviderError = ProviderError;
+/**
+ * Profile-related errors
+ * Examples: profile not found, invalid profile name, duplicate profile
+ */
+class ProfileError extends CCSError {
+    constructor(message, profileName, availableProfiles) {
+        super(message, exit_codes_1.ExitCode.PROFILE_ERROR, false);
+        this.profileName = profileName;
+        this.availableProfiles = availableProfiles;
+        this.name = 'ProfileError';
+    }
+}
+exports.ProfileError = ProfileError;
+/**
+ * Proxy-related errors
+ * Examples: proxy startup failure, port conflict, proxy timeout
+ */
+class ProxyError extends CCSError {
+    constructor(message, port) {
+        super(message, exit_codes_1.ExitCode.PROXY_ERROR, false);
+        this.port = port;
+        this.name = 'ProxyError';
+    }
+}
+exports.ProxyError = ProxyError;
+/**
+ * Migration-related errors
+ * Examples: failed to migrate config, backup creation failed
+ */
+class MigrationError extends CCSError {
+    constructor(message, fromVersion, toVersion) {
+        super(message, exit_codes_1.ExitCode.MIGRATION_ERROR, false);
+        this.fromVersion = fromVersion;
+        this.toVersion = toVersion;
+        this.name = 'MigrationError';
+    }
+}
+exports.MigrationError = MigrationError;
+/**
+ * User abort error (Ctrl+C, SIGINT)
+ * Used when user explicitly cancels an operation
+ */
+class UserAbortError extends CCSError {
+    constructor(message = 'Operation cancelled by user') {
+        super(message, exit_codes_1.ExitCode.USER_ABORT, false);
+        this.name = 'UserAbortError';
+    }
+}
+exports.UserAbortError = UserAbortError;
+/**
+ * Input validation errors (model denylist, invalid format, length limits)
+ * Distinguishes user-input validation failures from system errors
+ */
+class ValidationError extends CCSError {
+    constructor(message, field) {
+        super(message, exit_codes_1.ExitCode.GENERAL_ERROR, false);
+        this.field = field;
+        this.name = 'ValidationError';
+    }
+}
+exports.ValidationError = ValidationError;
+/**
+ * Type guard to check if an error is a CCSError
+ */
+function isCCSError(error) {
+    return error instanceof CCSError;
+}
+exports.isCCSError = isCCSError;
+/**
+ * Type guard to check if an error is recoverable
+ */
+function isRecoverableError(error) {
+    if (isCCSError(error)) {
+        return error.recoverable;
+    }
+    return false;
+}
+exports.isRecoverableError = isRecoverableError;
+//# sourceMappingURL=error-types.js.map

package/dist/errors/error-types.js.map

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

package/dist/errors/exit-codes.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Standardized exit codes for CCS CLI
+ *
+ * Exit codes follow Unix conventions:
+ * - 0: Success
+ * - 1-125: Application errors
+ * - 126-127: Command execution errors (reserved by shell)
+ * - 128+N: Signal termination (128 + signal number)
+ * - 130: SIGINT (Ctrl+C) - 128 + 2
+ */
+export declare enum ExitCode {
+    /** Successful execution */
+    SUCCESS = 0,
+    /** General/unspecified error */
+    GENERAL_ERROR = 1,
+    /** Configuration file errors (missing, invalid, corrupt) */
+    CONFIG_ERROR = 2,
+    /** Network-related errors (connection, timeout, DNS) */
+    NETWORK_ERROR = 3,
+    /** Authentication/authorization errors (invalid token, expired, forbidden) */
+    AUTH_ERROR = 4,
+    /** Binary/executable errors (missing Claude CLI, corrupted binary) */
+    BINARY_ERROR = 5,
+    /** Provider-specific errors (API errors, rate limits, service unavailable) */
+    PROVIDER_ERROR = 6,
+    /** Profile not found or invalid */
+    PROFILE_ERROR = 7,
+    /** Proxy-related errors (startup failure, port conflict) */
+    PROXY_ERROR = 8,
+    /** Migration errors (failed to migrate config) */
+    MIGRATION_ERROR = 9,
+    /** User aborted operation (Ctrl+C, SIGINT) */
+    USER_ABORT = 130
+}
+/**
+ * Human-readable descriptions for exit codes
+ * Used in error messages and documentation
+ */
+export declare const EXIT_CODE_DESCRIPTIONS: Record<ExitCode, string>;
+/**
+ * Check if an exit code indicates success
+ */
+export declare function isSuccess(code: ExitCode | number): boolean;
+/**
+ * Check if an exit code indicates a recoverable error
+ * (errors that might succeed on retry)
+ */
+export declare function isRecoverable(code: ExitCode | number): boolean;
+//# sourceMappingURL=exit-codes.d.ts.map

package/dist/errors/exit-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.d.ts","sourceRoot":"","sources":["../../src/errors/exit-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,oBAAY,QAAQ;IAClB,2BAA2B;IAC3B,OAAO,IAAI;IAEX,gCAAgC;IAChC,aAAa,IAAI;IAEjB,4DAA4D;IAC5D,YAAY,IAAI;IAEhB,wDAAwD;IACxD,aAAa,IAAI;IAEjB,8EAA8E;IAC9E,UAAU,IAAI;IAEd,sEAAsE;IACtE,YAAY,IAAI;IAEhB,8EAA8E;IAC9E,cAAc,IAAI;IAElB,mCAAmC;IACnC,aAAa,IAAI;IAEjB,4DAA4D;IAC5D,WAAW,IAAI;IAEf,kDAAkD;IAClD,eAAe,IAAI;IAEnB,8CAA8C;IAC9C,UAAU,MAAM;CACjB;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,CAY3D,CAAC;AAEF;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAE1D;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAG9D"}

package/dist/errors/exit-codes.js

@@ -0,0 +1,72 @@
+"use strict";
+/**
+ * Standardized exit codes for CCS CLI
+ *
+ * Exit codes follow Unix conventions:
+ * - 0: Success
+ * - 1-125: Application errors
+ * - 126-127: Command execution errors (reserved by shell)
+ * - 128+N: Signal termination (128 + signal number)
+ * - 130: SIGINT (Ctrl+C) - 128 + 2
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isRecoverable = exports.isSuccess = exports.EXIT_CODE_DESCRIPTIONS = exports.ExitCode = void 0;
+var ExitCode;
+(function (ExitCode) {
+    /** Successful execution */
+    ExitCode[ExitCode["SUCCESS"] = 0] = "SUCCESS";
+    /** General/unspecified error */
+    ExitCode[ExitCode["GENERAL_ERROR"] = 1] = "GENERAL_ERROR";
+    /** Configuration file errors (missing, invalid, corrupt) */
+    ExitCode[ExitCode["CONFIG_ERROR"] = 2] = "CONFIG_ERROR";
+    /** Network-related errors (connection, timeout, DNS) */
+    ExitCode[ExitCode["NETWORK_ERROR"] = 3] = "NETWORK_ERROR";
+    /** Authentication/authorization errors (invalid token, expired, forbidden) */
+    ExitCode[ExitCode["AUTH_ERROR"] = 4] = "AUTH_ERROR";
+    /** Binary/executable errors (missing Claude CLI, corrupted binary) */
+    ExitCode[ExitCode["BINARY_ERROR"] = 5] = "BINARY_ERROR";
+    /** Provider-specific errors (API errors, rate limits, service unavailable) */
+    ExitCode[ExitCode["PROVIDER_ERROR"] = 6] = "PROVIDER_ERROR";
+    /** Profile not found or invalid */
+    ExitCode[ExitCode["PROFILE_ERROR"] = 7] = "PROFILE_ERROR";
+    /** Proxy-related errors (startup failure, port conflict) */
+    ExitCode[ExitCode["PROXY_ERROR"] = 8] = "PROXY_ERROR";
+    /** Migration errors (failed to migrate config) */
+    ExitCode[ExitCode["MIGRATION_ERROR"] = 9] = "MIGRATION_ERROR";
+    /** User aborted operation (Ctrl+C, SIGINT) */
+    ExitCode[ExitCode["USER_ABORT"] = 130] = "USER_ABORT";
+})(ExitCode || (exports.ExitCode = ExitCode = {}));
+/**
+ * Human-readable descriptions for exit codes
+ * Used in error messages and documentation
+ */
+exports.EXIT_CODE_DESCRIPTIONS = {
+    [ExitCode.SUCCESS]: 'Success',
+    [ExitCode.GENERAL_ERROR]: 'General error',
+    [ExitCode.CONFIG_ERROR]: 'Configuration error',
+    [ExitCode.NETWORK_ERROR]: 'Network error',
+    [ExitCode.AUTH_ERROR]: 'Authentication error',
+    [ExitCode.BINARY_ERROR]: 'Binary/executable error',
+    [ExitCode.PROVIDER_ERROR]: 'Provider error',
+    [ExitCode.PROFILE_ERROR]: 'Profile error',
+    [ExitCode.PROXY_ERROR]: 'Proxy error',
+    [ExitCode.MIGRATION_ERROR]: 'Migration error',
+    [ExitCode.USER_ABORT]: 'User abort (Ctrl+C)',
+};
+/**
+ * Check if an exit code indicates success
+ */
+function isSuccess(code) {
+    return code === ExitCode.SUCCESS;
+}
+exports.isSuccess = isSuccess;
+/**
+ * Check if an exit code indicates a recoverable error
+ * (errors that might succeed on retry)
+ */
+function isRecoverable(code) {
+    const recoverableCodes = [ExitCode.NETWORK_ERROR, ExitCode.PROVIDER_ERROR];
+    return recoverableCodes.includes(code);
+}
+exports.isRecoverable = isRecoverable;
+//# sourceMappingURL=exit-codes.js.map

package/dist/errors/exit-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exit-codes.js","sourceRoot":"","sources":["../../src/errors/exit-codes.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAEH,IAAY,QAiCX;AAjCD,WAAY,QAAQ;IAClB,2BAA2B;IAC3B,6CAAW,CAAA;IAEX,gCAAgC;IAChC,yDAAiB,CAAA;IAEjB,4DAA4D;IAC5D,uDAAgB,CAAA;IAEhB,wDAAwD;IACxD,yDAAiB,CAAA;IAEjB,8EAA8E;IAC9E,mDAAc,CAAA;IAEd,sEAAsE;IACtE,uDAAgB,CAAA;IAEhB,8EAA8E;IAC9E,2DAAkB,CAAA;IAElB,mCAAmC;IACnC,yDAAiB,CAAA;IAEjB,4DAA4D;IAC5D,qDAAe,CAAA;IAEf,kDAAkD;IAClD,6DAAmB,CAAA;IAEnB,8CAA8C;IAC9C,qDAAgB,CAAA;AAClB,CAAC,EAjCW,QAAQ,wBAAR,QAAQ,QAiCnB;AAED;;;GAGG;AACU,QAAA,sBAAsB,GAA6B;IAC9D,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS;IAC7B,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,eAAe;IACzC,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,qBAAqB;IAC9C,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,eAAe;IACzC,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,sBAAsB;IAC7C,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,yBAAyB;IAClD,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,gBAAgB;IAC3C,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,eAAe;IACzC,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,aAAa;IACrC,CAAC,QAAQ,CAAC,eAAe,CAAC,EAAE,iBAAiB;IAC7C,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,qBAAqB;CAC7C,CAAC;AAEF;;GAEG;AACH,SAAgB,SAAS,CAAC,IAAuB;IAC/C,OAAO,IAAI,KAAK,QAAQ,CAAC,OAAO,CAAC;AACnC,CAAC;AAFD,8BAEC;AAED;;;GAGG;AACH,SAAgB,aAAa,CAAC,IAAuB;IACnD,MAAM,gBAAgB,GAAG,CAAC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IAC3E,OAAO,gBAAgB,CAAC,QAAQ,CAAC,IAAgB,CAAC,CAAC;AACrD,CAAC;AAHD,sCAGC"}

package/dist/errors/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CCS Error Handling Module
+ *
+ * Centralized error handling system for CCS CLI providing:
+ * - Standardized exit codes
+ * - Custom error types with exit code mapping
+ * - Centralized error handler with cleanup
+ * - Cleanup callback registry
+ *
+ * @example
+ * ```typescript
+ * import { handleError, ConfigError, ExitCode, registerCleanup } from './errors';
+ *
+ * // Register cleanup for spawned process
+ * registerCleanup(() => proxy.kill());
+ *
+ * // Throw typed error
+ * throw new ConfigError('Invalid config file', '~/.ccs/config.json');
+ *
+ * // Or handle directly
+ * handleError(new NetworkError('Connection refused'));
+ * ```
+ */
+export { ExitCode, EXIT_CODE_DESCRIPTIONS, isSuccess, isRecoverable } from './exit-codes';
+export { CCSError, ConfigError, NetworkError, AuthError, BinaryError, ProviderError, ProfileError, ProxyError, MigrationError, UserAbortError, isCCSError, isRecoverableError, } from './error-types';
+export { handleError, exitWithError, exitWithSuccess, withErrorHandling, assertOrExit, } from './error-handler';
+export { registerCleanup, runCleanup, clearCleanup, getCleanupCount, hasCleanupRun, createCleanupScope, } from './cleanup-registry';
+export type { CleanupCallback } from './cleanup-registry';
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,QAAQ,EAAE,sBAAsB,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG1F,OAAO,EACL,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,SAAS,EACT,WAAW,EACX,aAAa,EACb,YAAY,EACZ,UAAU,EACV,cAAc,EACd,cAAc,EACd,UAAU,EACV,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,WAAW,EACX,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,YAAY,GACb,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,eAAe,EACf,UAAU,EACV,YAAY,EACZ,eAAe,EACf,aAAa,EACb,kBAAkB,GACnB,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * CCS Error Handling Module
+ *
+ * Centralized error handling system for CCS CLI providing:
+ * - Standardized exit codes
+ * - Custom error types with exit code mapping
+ * - Centralized error handler with cleanup
+ * - Cleanup callback registry
+ *
+ * @example
+ * ```typescript
+ * import { handleError, ConfigError, ExitCode, registerCleanup } from './errors';
+ *
+ * // Register cleanup for spawned process
+ * registerCleanup(() => proxy.kill());
+ *
+ * // Throw typed error
+ * throw new ConfigError('Invalid config file', '~/.ccs/config.json');
+ *
+ * // Or handle directly
+ * handleError(new NetworkError('Connection refused'));
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCleanupScope = exports.hasCleanupRun = exports.getCleanupCount = exports.clearCleanup = exports.runCleanup = exports.registerCleanup = exports.assertOrExit = exports.withErrorHandling = exports.exitWithSuccess = exports.exitWithError = exports.handleError = exports.isRecoverableError = exports.isCCSError = exports.UserAbortError = exports.MigrationError = exports.ProxyError = exports.ProfileError = exports.ProviderError = exports.BinaryError = exports.AuthError = exports.NetworkError = exports.ConfigError = exports.CCSError = exports.isRecoverable = exports.isSuccess = exports.EXIT_CODE_DESCRIPTIONS = exports.ExitCode = void 0;
+// Exit codes
+var exit_codes_1 = require("./exit-codes");
+Object.defineProperty(exports, "ExitCode", { enumerable: true, get: function () { return exit_codes_1.ExitCode; } });
+Object.defineProperty(exports, "EXIT_CODE_DESCRIPTIONS", { enumerable: true, get: function () { return exit_codes_1.EXIT_CODE_DESCRIPTIONS; } });
+Object.defineProperty(exports, "isSuccess", { enumerable: true, get: function () { return exit_codes_1.isSuccess; } });
+Object.defineProperty(exports, "isRecoverable", { enumerable: true, get: function () { return exit_codes_1.isRecoverable; } });
+// Error types
+var error_types_1 = require("./error-types");
+Object.defineProperty(exports, "CCSError", { enumerable: true, get: function () { return error_types_1.CCSError; } });
+Object.defineProperty(exports, "ConfigError", { enumerable: true, get: function () { return error_types_1.ConfigError; } });
+Object.defineProperty(exports, "NetworkError", { enumerable: true, get: function () { return error_types_1.NetworkError; } });
+Object.defineProperty(exports, "AuthError", { enumerable: true, get: function () { return error_types_1.AuthError; } });
+Object.defineProperty(exports, "BinaryError", { enumerable: true, get: function () { return error_types_1.BinaryError; } });
+Object.defineProperty(exports, "ProviderError", { enumerable: true, get: function () { return error_types_1.ProviderError; } });
+Object.defineProperty(exports, "ProfileError", { enumerable: true, get: function () { return error_types_1.ProfileError; } });
+Object.defineProperty(exports, "ProxyError", { enumerable: true, get: function () { return error_types_1.ProxyError; } });
+Object.defineProperty(exports, "MigrationError", { enumerable: true, get: function () { return error_types_1.MigrationError; } });
+Object.defineProperty(exports, "UserAbortError", { enumerable: true, get: function () { return error_types_1.UserAbortError; } });
+Object.defineProperty(exports, "isCCSError", { enumerable: true, get: function () { return error_types_1.isCCSError; } });
+Object.defineProperty(exports, "isRecoverableError", { enumerable: true, get: function () { return error_types_1.isRecoverableError; } });
+// Error handler
+var error_handler_1 = require("./error-handler");
+Object.defineProperty(exports, "handleError", { enumerable: true, get: function () { return error_handler_1.handleError; } });
+Object.defineProperty(exports, "exitWithError", { enumerable: true, get: function () { return error_handler_1.exitWithError; } });
+Object.defineProperty(exports, "exitWithSuccess", { enumerable: true, get: function () { return error_handler_1.exitWithSuccess; } });
+Object.defineProperty(exports, "withErrorHandling", { enumerable: true, get: function () { return error_handler_1.withErrorHandling; } });
+Object.defineProperty(exports, "assertOrExit", { enumerable: true, get: function () { return error_handler_1.assertOrExit; } });
+// Cleanup registry
+var cleanup_registry_1 = require("./cleanup-registry");
+Object.defineProperty(exports, "registerCleanup", { enumerable: true, get: function () { return cleanup_registry_1.registerCleanup; } });
+Object.defineProperty(exports, "runCleanup", { enumerable: true, get: function () { return cleanup_registry_1.runCleanup; } });
+Object.defineProperty(exports, "clearCleanup", { enumerable: true, get: function () { return cleanup_registry_1.clearCleanup; } });
+Object.defineProperty(exports, "getCleanupCount", { enumerable: true, get: function () { return cleanup_registry_1.getCleanupCount; } });
+Object.defineProperty(exports, "hasCleanupRun", { enumerable: true, get: function () { return cleanup_registry_1.hasCleanupRun; } });
+Object.defineProperty(exports, "createCleanupScope", { enumerable: true, get: function () { return cleanup_registry_1.createCleanupScope; } });
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;;;AAEH,aAAa;AACb,2CAA0F;AAAjF,sGAAA,QAAQ,OAAA;AAAE,oHAAA,sBAAsB,OAAA;AAAE,uGAAA,SAAS,OAAA;AAAE,2GAAA,aAAa,OAAA;AAEnE,cAAc;AACd,6CAauB;AAZrB,uGAAA,QAAQ,OAAA;AACR,0GAAA,WAAW,OAAA;AACX,2GAAA,YAAY,OAAA;AACZ,wGAAA,SAAS,OAAA;AACT,0GAAA,WAAW,OAAA;AACX,4GAAA,aAAa,OAAA;AACb,2GAAA,YAAY,OAAA;AACZ,yGAAA,UAAU,OAAA;AACV,6GAAA,cAAc,OAAA;AACd,6GAAA,cAAc,OAAA;AACd,yGAAA,UAAU,OAAA;AACV,iHAAA,kBAAkB,OAAA;AAGpB,gBAAgB;AAChB,iDAMyB;AALvB,4GAAA,WAAW,OAAA;AACX,8GAAA,aAAa,OAAA;AACb,gHAAA,eAAe,OAAA;AACf,kHAAA,iBAAiB,OAAA;AACjB,6GAAA,YAAY,OAAA;AAGd,mBAAmB;AACnB,uDAO4B;AAN1B,mHAAA,eAAe,OAAA;AACf,8GAAA,UAAU,OAAA;AACV,gHAAA,YAAY,OAAA;AACZ,mHAAA,eAAe,OAAA;AACf,iHAAA,aAAa,OAAA;AACb,sHAAA,kBAAkB,OAAA"}

package/dist/glmt/delta-accumulator.d.ts

@@ -0,0 +1,210 @@
+#!/usr/bin/env node
+/**
+ * DeltaAccumulator - Maintain state across streaming deltas
+ *
+ * Tracks:
+ * - Message metadata (id, model, role)
+ * - Content blocks (thinking, text)
+ * - Current block index
+ * - Accumulated content
+ *
+ * Usage:
+ *   const acc = new DeltaAccumulator(thinkingConfig);
+ *   const events = transformer.transformDelta(openaiEvent, acc);
+ */
+interface ThinkingConfig {
+    [key: string]: unknown;
+}
+interface DeltaAccumulatorOptions {
+    maxBlocks?: number;
+    maxBufferSize?: number;
+    loopDetectionThreshold?: number;
+}
+interface ContentBlock {
+    index: number;
+    type: string;
+    content: string;
+    started: boolean;
+    stopped: boolean;
+}
+interface ToolCall {
+    index: number;
+    id: string;
+    type: string;
+    function: {
+        name: string;
+        arguments: string;
+    };
+}
+interface ToolCallDelta {
+    index: number;
+    id?: string;
+    type?: string;
+    function?: {
+        name?: string;
+        arguments?: string;
+    };
+}
+interface UsageStats {
+    prompt_tokens?: number;
+    input_tokens?: number;
+    completion_tokens?: number;
+    output_tokens?: number;
+}
+interface AccumulatorSummary {
+    messageId: string;
+    model: string | null;
+    role: string;
+    blockCount: number;
+    currentIndex: number;
+    toolCallCount: number;
+    messageStarted: boolean;
+    finalized: boolean;
+    loopDetected: boolean;
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+    };
+}
+export declare class DeltaAccumulator {
+    private messageId;
+    private model;
+    private role;
+    private contentBlocks;
+    private currentBlockIndex;
+    private toolCalls;
+    private toolCallsIndex;
+    private thinkingBuffer;
+    private textBuffer;
+    private maxBlocks;
+    private maxBufferSize;
+    private loopDetectionThreshold;
+    private loopDetected;
+    private messageStarted;
+    private finalized;
+    private inputTokens;
+    private outputTokens;
+    constructor(_thinkingConfig?: ThinkingConfig, options?: DeltaAccumulatorOptions);
+    /**
+     * Get current content block
+     * @returns Current block or null
+     */
+    getCurrentBlock(): ContentBlock | null;
+    /**
+     * Start new content block
+     * @param type - Block type ('thinking', 'text', or 'tool_use')
+     * @returns New block
+     */
+    startBlock(type: string): ContentBlock;
+    /**
+     * Add delta to current block
+     * @param delta - Content delta
+     */
+    addDelta(delta: string): void;
+    /**
+     * Mark current block as stopped
+     */
+    stopCurrentBlock(): void;
+    /**
+     * Update usage statistics
+     * @param usage - Usage object from OpenAI
+     */
+    updateUsage(usage: UsageStats): void;
+    /**
+     * Add or update tool call delta
+     * @param toolCallDelta - Tool call delta from OpenAI
+     */
+    addToolCallDelta(toolCallDelta: ToolCallDelta): void;
+    /**
+     * Get all tool calls
+     * @returns Tool calls array
+     */
+    getToolCalls(): ToolCall[];
+    /**
+     * Check for planning loop pattern
+     * Loop = N consecutive thinking blocks with no tool calls
+     * @returns True if loop detected
+     */
+    checkForLoop(): boolean;
+    /**
+     * Reset loop detection state (for testing)
+     */
+    resetLoopDetection(): void;
+    /**
+     * Get summary of accumulated state
+     * @returns Summary
+     */
+    getSummary(): AccumulatorSummary;
+    /**
+     * Check if message has been finalized
+     */
+    isFinalized(): boolean;
+    /**
+     * Check if message has started
+     */
+    isMessageStarted(): boolean;
+    /**
+     * Get message ID
+     */
+    getMessageId(): string;
+    /**
+     * Get model name
+     */
+    getModel(): string | null;
+    /**
+     * Get role
+     */
+    getRole(): string;
+    /**
+     * Get input tokens
+     */
+    getInputTokens(): number;
+    /**
+     * Get output tokens
+     */
+    getOutputTokens(): number;
+    /**
+     * Set model name
+     */
+    setModel(model: string): void;
+    /**
+     * Set message started flag
+     */
+    setMessageStarted(started: boolean): void;
+    /**
+     * Set role
+     */
+    setRole(role: string): void;
+    /**
+     * Set finalized flag
+     */
+    setFinalized(finalized: boolean): void;
+    private finishReason;
+    private usageReceived;
+    /**
+     * Set finish reason
+     */
+    setFinishReason(reason: string): void;
+    /**
+     * Get finish reason
+     */
+    getFinishReason(): string | null;
+    /**
+     * Check if usage stats have been received
+     */
+    hasUsageReceived(): boolean;
+    /**
+     * Mark usage as received
+     */
+    setUsageReceived(received: boolean): void;
+    /**
+     * Check if there are any tool calls, or check if a specific index exists
+     */
+    hasToolCall(index?: number): boolean;
+    /**
+     * Get tool call by index
+     */
+    getToolCall(index: number): ToolCall | undefined;
+}
+export {};
+//# sourceMappingURL=delta-accumulator.d.ts.map

package/dist/glmt/delta-accumulator.d.ts.map

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