@itssimplereally/opencode-kimicode-auth 0.1.0

package/dist/src/plugin/debug.d.ts

@@ -0,0 +1,92 @@
+import type { KimicodeConfig } from "./config";
+export declare const DEBUG_MESSAGE_PREFIX = "[opencode-kimicode-auth debug]";
+/**
+ * Initialize or reinitialize debug state with the given config.
+ * Call this once at plugin startup after loading config.
+ */
+export declare function initializeDebug(config: KimicodeConfig): void;
+export declare function isDebugEnabled(): boolean;
+export declare function isVerboseEnabled(): boolean;
+export declare function getLogFilePath(): string | undefined;
+export interface KimicodeDebugContext {
+    id: string;
+    streaming: boolean;
+    startedAt: number;
+}
+interface KimicodeDebugRequestMeta {
+    originalUrl: string;
+    resolvedUrl: string;
+    method?: string;
+    headers?: HeadersInit;
+    body?: BodyInit | null;
+    streaming: boolean;
+    projectId?: string;
+}
+interface KimicodeDebugResponseMeta {
+    body?: string;
+    note?: string;
+    error?: unknown;
+    headersOverride?: HeadersInit;
+}
+/**
+ * Begins a debug trace for an Kimicode request.
+ */
+export declare function startKimicodeDebugRequest(meta: KimicodeDebugRequestMeta): KimicodeDebugContext | null;
+/**
+ * Logs response details for a previously started debug trace.
+ */
+export declare function logKimicodeDebugResponse(context: KimicodeDebugContext | null | undefined, response: Response, meta?: KimicodeDebugResponseMeta): void;
+export interface AccountDebugInfo {
+    index: number;
+    email?: string;
+    family: string;
+    totalAccounts: number;
+    rateLimitState?: {
+        kimi?: number;
+    };
+}
+export declare function logAccountContext(label: string, info: AccountDebugInfo): void;
+export declare function logRateLimitEvent(accountIndex: number, email: string | undefined, family: string, status: number, retryAfterMs: number, bodyInfo: {
+    message?: string;
+    quotaResetTime?: string;
+    retryDelayMs?: number | null;
+    reason?: string;
+}): void;
+export declare function logRateLimitSnapshot(family: string, accounts: Array<{
+    index: number;
+    email?: string;
+    rateLimitResetTimes?: {
+        kimi?: number;
+    };
+}>): void;
+export declare function logResponseBody(context: KimicodeDebugContext | null | undefined, response: Response, status: number): Promise<string | undefined>;
+export declare function logModelFamily(url: string, extractedModel: string | null, family: string): void;
+export declare function debugLogToFile(message: string): void;
+/**
+ * Logs a toast message to the debug file.
+ * This helps correlate what the user saw with debug events.
+ */
+export declare function logToast(message: string, variant: "info" | "warning" | "success" | "error"): void;
+/**
+ * Logs retry attempt information.
+ * @param maxAttempts - Use -1 for unlimited retries
+ */
+export declare function logRetryAttempt(attempt: number, maxAttempts: number, reason: string, delayMs?: number): void;
+/**
+ * Logs cache hit/miss information from response usage metadata.
+ */
+export declare function logCacheStats(model: string, cacheReadTokens: number, cacheWriteTokens: number, totalInputTokens: number): void;
+/**
+ * Logs quota status for an account.
+ */
+export declare function logQuotaStatus(accountEmail: string | undefined, accountIndex: number, quotaPercent: number, family?: string): void;
+/**
+ * Logs background quota fetch events.
+ */
+export declare function logQuotaFetch(event: "start" | "complete" | "error", accountCount?: number, details?: string): void;
+/**
+ * Logs which model is being used for a request.
+ */
+export declare function logModelUsed(requestedModel: string, actualModel: string, accountEmail?: string): void;
+export {};
+//# sourceMappingURL=debug.d.ts.map

package/dist/src/plugin/debug.d.ts.map

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

package/dist/src/plugin/debug.js

@@ -0,0 +1,406 @@
+import { createWriteStream, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { env } from "node:process";
+import { ensureGitignoreSync } from "./storage";
+const MAX_BODY_PREVIEW_CHARS = 12000;
+const MAX_BODY_VERBOSE_CHARS = 50000;
+export const DEBUG_MESSAGE_PREFIX = "[opencode-kimicode-auth debug]";
+let debugState = null;
+/**
+ * Parse debug level from a flag string.
+ * 0 = off, 1 = basic, 2 = verbose (full bodies)
+ */
+function parseDebugLevel(flag) {
+    const trimmed = flag.trim();
+    if (trimmed === "2" || trimmed === "verbose")
+        return 2;
+    if (trimmed === "1" || trimmed === "true")
+        return 1;
+    return 0;
+}
+/**
+ * Get the OS-specific config directory.
+ */
+function getConfigDir() {
+    const platform = process.platform;
+    if (platform === "win32") {
+        return join(env.APPDATA || join(homedir(), "AppData", "Roaming"), "opencode");
+    }
+    const xdgConfig = env.XDG_CONFIG_HOME || join(homedir(), ".config");
+    return join(xdgConfig, "opencode");
+}
+/**
+ * Returns the logs directory, creating it if needed.
+ */
+function getLogsDir(customLogDir) {
+    const logsDir = customLogDir || join(getConfigDir(), "kimicode-logs");
+    try {
+        mkdirSync(logsDir, { recursive: true });
+    }
+    catch {
+        // Directory may already exist or we don't have permission
+    }
+    return logsDir;
+}
+/**
+ * Builds a timestamped log file path.
+ */
+function createLogFilePath(customLogDir) {
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+    return join(getLogsDir(customLogDir), `kimicode-debug-${timestamp}.log`);
+}
+/**
+ * Creates a log writer function that writes to a file.
+ */
+function createLogWriter(filePath) {
+    if (!filePath) {
+        return () => { };
+    }
+    try {
+        const stream = createWriteStream(filePath, { flags: "a" });
+        stream.on("error", () => { });
+        return (line) => {
+            const timestamp = new Date().toISOString();
+            const formatted = `[${timestamp}] ${line}`;
+            stream.write(`${formatted}\n`);
+        };
+    }
+    catch {
+        return () => { };
+    }
+}
+/**
+ * Initialize or reinitialize debug state with the given config.
+ * Call this once at plugin startup after loading config.
+ */
+export function initializeDebug(config) {
+    // Config takes precedence, but env var can force enable for debugging
+    const envDebugFlag = env.OPENCODE_KIMICODE_DEBUG ?? "";
+    const debugLevel = config.debug ? (envDebugFlag === "2" || envDebugFlag === "verbose" ? 2 : 1) : parseDebugLevel(envDebugFlag);
+    const debugEnabled = debugLevel >= 1;
+    const verboseEnabled = debugLevel >= 2;
+    const logFilePath = debugEnabled ? createLogFilePath(config.log_dir) : undefined;
+    const logWriter = createLogWriter(logFilePath);
+    if (debugEnabled) {
+        ensureGitignoreSync(getConfigDir());
+    }
+    debugState = {
+        debugLevel,
+        debugEnabled,
+        verboseEnabled,
+        logFilePath,
+        logWriter,
+    };
+}
+/**
+ * Get the current debug state, initializing with defaults if needed.
+ * This allows the module to work even before initializeDebug is called.
+ */
+function getDebugState() {
+    if (!debugState) {
+        // Fallback to env-based initialization for backward compatibility
+        const envDebugFlag = env.OPENCODE_KIMICODE_DEBUG ?? "";
+        const debugLevel = parseDebugLevel(envDebugFlag);
+        const debugEnabled = debugLevel >= 1;
+        const verboseEnabled = debugLevel >= 2;
+        const logFilePath = debugEnabled ? createLogFilePath() : undefined;
+        const logWriter = createLogWriter(logFilePath);
+        debugState = {
+            debugLevel,
+            debugEnabled,
+            verboseEnabled,
+            logFilePath,
+            logWriter,
+        };
+    }
+    return debugState;
+}
+// =============================================================================
+// Public API
+// =============================================================================
+export function isDebugEnabled() {
+    return getDebugState().debugEnabled;
+}
+export function isVerboseEnabled() {
+    return getDebugState().verboseEnabled;
+}
+export function getLogFilePath() {
+    return getDebugState().logFilePath;
+}
+let requestCounter = 0;
+/**
+ * Begins a debug trace for an Kimicode request.
+ */
+export function startKimicodeDebugRequest(meta) {
+    const state = getDebugState();
+    if (!state.debugEnabled) {
+        return null;
+    }
+    const id = `KIMICODE-${++requestCounter}`;
+    const method = meta.method ?? "GET";
+    logDebug(`[Kimicode Debug ${id}] pid=${process.pid} ${method} ${meta.resolvedUrl}`);
+    if (meta.originalUrl && meta.originalUrl !== meta.resolvedUrl) {
+        logDebug(`[Kimicode Debug ${id}] Original URL: ${meta.originalUrl}`);
+    }
+    if (meta.projectId) {
+        logDebug(`[Kimicode Debug ${id}] Project: ${meta.projectId}`);
+    }
+    logDebug(`[Kimicode Debug ${id}] Streaming: ${meta.streaming ? "yes" : "no"}`);
+    logDebug(`[Kimicode Debug ${id}] Headers: ${JSON.stringify(maskHeaders(meta.headers))}`);
+    const bodyPreview = formatBodyPreview(meta.body);
+    if (bodyPreview) {
+        logDebug(`[Kimicode Debug ${id}] Body Preview: ${bodyPreview}`);
+    }
+    return { id, streaming: meta.streaming, startedAt: Date.now() };
+}
+/**
+ * Logs response details for a previously started debug trace.
+ */
+export function logKimicodeDebugResponse(context, response, meta = {}) {
+    const state = getDebugState();
+    if (!state.debugEnabled || !context) {
+        return;
+    }
+    const durationMs = Date.now() - context.startedAt;
+    logDebug(`[Kimicode Debug ${context.id}] Response ${response.status} ${response.statusText} (${durationMs}ms)`);
+    logDebug(`[Kimicode Debug ${context.id}] Response Headers: ${JSON.stringify(maskHeaders(meta.headersOverride ?? response.headers))}`);
+    if (meta.note) {
+        logDebug(`[Kimicode Debug ${context.id}] Note: ${meta.note}`);
+    }
+    if (meta.error) {
+        logDebug(`[Kimicode Debug ${context.id}] Error: ${formatError(meta.error)}`);
+    }
+    if (meta.body) {
+        logDebug(`[Kimicode Debug ${context.id}] Response Body Preview: ${truncateForLog(meta.body)}`);
+    }
+}
+/**
+ * Obscures sensitive headers and returns a plain object for logging.
+ */
+function maskHeaders(headers) {
+    if (!headers) {
+        return {};
+    }
+    const result = {};
+    const parsed = headers instanceof Headers ? headers : new Headers(headers);
+    parsed.forEach((value, key) => {
+        if (key.toLowerCase() === "authorization") {
+            result[key] = "[redacted]";
+        }
+        else {
+            result[key] = value;
+        }
+    });
+    return result;
+}
+/**
+ * Produces a short, type-aware preview of a request/response body for logs.
+ */
+function formatBodyPreview(body) {
+    if (body == null) {
+        return undefined;
+    }
+    if (typeof body === "string") {
+        return truncateForLog(body);
+    }
+    if (body instanceof URLSearchParams) {
+        return truncateForLog(body.toString());
+    }
+    if (typeof Blob !== "undefined" && body instanceof Blob) {
+        return `[Blob size=${body.size}]`;
+    }
+    if (typeof FormData !== "undefined" && body instanceof FormData) {
+        return "[FormData payload omitted]";
+    }
+    return `[${body.constructor?.name ?? typeof body} payload omitted]`;
+}
+/**
+ * Truncates long strings to a fixed preview length for logging.
+ */
+function truncateForLog(text) {
+    if (text.length <= MAX_BODY_PREVIEW_CHARS) {
+        return text;
+    }
+    return `${text.slice(0, MAX_BODY_PREVIEW_CHARS)}... (truncated ${text.length - MAX_BODY_PREVIEW_CHARS} chars)`;
+}
+/**
+ * Writes a single debug line using the configured writer.
+ */
+function logDebug(line) {
+    getDebugState().logWriter(line);
+}
+/**
+ * Converts unknown error-like values into printable strings.
+ */
+function formatError(error) {
+    if (error instanceof Error) {
+        return error.stack ?? error.message;
+    }
+    try {
+        return JSON.stringify(error);
+    }
+    catch {
+        return String(error);
+    }
+}
+export function logAccountContext(label, info) {
+    if (!getDebugState().debugEnabled)
+        return;
+    const accountLabel = info.email
+        ? info.email
+        : info.index >= 0
+            ? `Account ${info.index + 1}`
+            : "All accounts";
+    const indexLabel = info.index >= 0 ? `${info.index + 1}/${info.totalAccounts}` : `-/${info.totalAccounts}`;
+    let rateLimitInfo = "";
+    if (info.rateLimitState && Object.keys(info.rateLimitState).length > 0) {
+        const now = Date.now();
+        const activeRateLimits = {};
+        for (const [key, resetTime] of Object.entries(info.rateLimitState)) {
+            if (typeof resetTime === "number" && resetTime > now) {
+                const remainingSec = Math.ceil((resetTime - now) / 1000);
+                activeRateLimits[key] = `${remainingSec}s`;
+            }
+        }
+        if (Object.keys(activeRateLimits).length > 0) {
+            rateLimitInfo = ` rateLimits=${JSON.stringify(activeRateLimits)}`;
+        }
+    }
+    logDebug(`[Account] ${label}: ${accountLabel} (${indexLabel}) family=${info.family}${rateLimitInfo}`);
+}
+export function logRateLimitEvent(accountIndex, email, family, status, retryAfterMs, bodyInfo) {
+    if (!getDebugState().debugEnabled)
+        return;
+    const accountLabel = email || `Account ${accountIndex + 1}`;
+    logDebug(`[RateLimit] ${status} on ${accountLabel} family=${family} retryAfterMs=${retryAfterMs}`);
+    if (bodyInfo.message) {
+        logDebug(`[RateLimit] message: ${bodyInfo.message}`);
+    }
+    if (bodyInfo.quotaResetTime) {
+        logDebug(`[RateLimit] quotaResetTime: ${bodyInfo.quotaResetTime}`);
+    }
+    if (bodyInfo.retryDelayMs !== undefined && bodyInfo.retryDelayMs !== null) {
+        logDebug(`[RateLimit] body retryDelayMs: ${bodyInfo.retryDelayMs}`);
+    }
+    if (bodyInfo.reason) {
+        logDebug(`[RateLimit] reason: ${bodyInfo.reason}`);
+    }
+}
+export function logRateLimitSnapshot(family, accounts) {
+    if (!getDebugState().debugEnabled)
+        return;
+    const now = Date.now();
+    const entries = accounts.map((account) => {
+        const label = account.email ? account.email : `Account ${account.index + 1}`;
+        const reset = account.rateLimitResetTimes?.[family];
+        if (typeof reset !== "number") {
+            return `${label}=ready`;
+        }
+        const remaining = Math.max(0, reset - now);
+        const seconds = Math.ceil(remaining / 1000);
+        return `${label}=wait ${seconds}s`;
+    });
+    logDebug(`[RateLimit] snapshot family=${family} ${entries.join(" | ")}`);
+}
+export async function logResponseBody(context, response, status) {
+    const state = getDebugState();
+    if (!state.debugEnabled || !context)
+        return undefined;
+    const isError = status >= 400;
+    const shouldLogBody = state.verboseEnabled || isError;
+    if (!shouldLogBody)
+        return undefined;
+    try {
+        const text = await response.clone().text();
+        const maxChars = state.verboseEnabled ? MAX_BODY_VERBOSE_CHARS : MAX_BODY_PREVIEW_CHARS;
+        const preview = text.length <= maxChars
+            ? text
+            : `${text.slice(0, maxChars)}... (truncated ${text.length - maxChars} chars)`;
+        logDebug(`[Kimicode Debug ${context.id}] Response Body (${status}): ${preview}`);
+        return text;
+    }
+    catch (e) {
+        logDebug(`[Kimicode Debug ${context.id}] Failed to read response body: ${formatError(e)}`);
+        return undefined;
+    }
+}
+export function logModelFamily(url, extractedModel, family) {
+    if (!getDebugState().debugEnabled)
+        return;
+    logDebug(`[ModelFamily] url=${url} model=${extractedModel ?? "unknown"} family=${family}`);
+}
+export function debugLogToFile(message) {
+    if (!getDebugState().debugEnabled)
+        return;
+    logDebug(message);
+}
+/**
+ * Logs a toast message to the debug file.
+ * This helps correlate what the user saw with debug events.
+ */
+export function logToast(message, variant) {
+    if (!getDebugState().debugEnabled)
+        return;
+    const variantLabel = variant.toUpperCase();
+    logDebug(`[Toast/${variantLabel}] ${message}`);
+}
+/**
+ * Logs retry attempt information.
+ * @param maxAttempts - Use -1 for unlimited retries
+ */
+export function logRetryAttempt(attempt, maxAttempts, reason, delayMs) {
+    if (!getDebugState().debugEnabled)
+        return;
+    const delayInfo = delayMs !== undefined ? ` delay=${delayMs}ms` : "";
+    const maxInfo = maxAttempts < 0 ? "∞" : maxAttempts.toString();
+    logDebug(`[Retry] Attempt ${attempt}/${maxInfo} reason=${reason}${delayInfo}`);
+}
+/**
+ * Logs cache hit/miss information from response usage metadata.
+ */
+export function logCacheStats(model, cacheReadTokens, cacheWriteTokens, totalInputTokens) {
+    if (!getDebugState().debugEnabled)
+        return;
+    const cacheHitRate = totalInputTokens > 0
+        ? Math.round((cacheReadTokens / totalInputTokens) * 100)
+        : 0;
+    const status = cacheReadTokens > 0 ? "HIT" : (cacheWriteTokens > 0 ? "WRITE" : "MISS");
+    logDebug(`[Cache] ${status} model=${model} read=${cacheReadTokens} write=${cacheWriteTokens} total=${totalInputTokens} hitRate=${cacheHitRate}%`);
+}
+/**
+ * Logs quota status for an account.
+ */
+export function logQuotaStatus(accountEmail, accountIndex, quotaPercent, family) {
+    if (!getDebugState().debugEnabled)
+        return;
+    const accountLabel = accountEmail || `Account ${accountIndex + 1}`;
+    const familyInfo = family ? ` family=${family}` : "";
+    const status = quotaPercent <= 0 ? "EXHAUSTED" : quotaPercent < 20 ? "LOW" : "OK";
+    logDebug(`[Quota] ${accountLabel} remaining=${quotaPercent.toFixed(1)}% status=${status}${familyInfo}`);
+}
+/**
+ * Logs background quota fetch events.
+ */
+export function logQuotaFetch(event, accountCount, details) {
+    if (!getDebugState().debugEnabled)
+        return;
+    const countInfo = accountCount !== undefined ? ` accounts=${accountCount}` : "";
+    const detailsInfo = details ? ` ${details}` : "";
+    logDebug(`[QuotaFetch] ${event.toUpperCase()}${countInfo}${detailsInfo}`);
+}
+/**
+ * Logs which model is being used for a request.
+ */
+export function logModelUsed(requestedModel, actualModel, accountEmail) {
+    if (!getDebugState().debugEnabled)
+        return;
+    const accountInfo = accountEmail ? ` account=${accountEmail}` : "";
+    if (requestedModel !== actualModel) {
+        logDebug(`[Model] requested=${requestedModel} actual=${actualModel}${accountInfo}`);
+    }
+    else {
+        logDebug(`[Model] ${actualModel}${accountInfo}`);
+    }
+}
+//# sourceMappingURL=debug.js.map

package/dist/src/plugin/debug.js.map

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

package/dist/src/plugin/errors.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Custom error types for opencode-kimicode-auth plugin.
+ *
+ * Ported from LLM-API-Key-Proxy for robust error handling.
+ */
+/**
+ * Error thrown when the provider returns an empty response after retry attempts.
+ *
+ * Empty responses can occur when:
+ * - The model has no candidates/choices
+ * - The response body is empty or malformed
+ * - A temporary service issue prevents generation
+ */
+export declare class EmptyResponseError extends Error {
+    readonly provider: string;
+    readonly model: string;
+    readonly attempts: number;
+    constructor(provider: string, model: string, attempts: number, message?: string);
+}
+/**
+ * Error thrown when tool ID matching fails and cannot be recovered.
+ */
+export declare class ToolIdMismatchError extends Error {
+    readonly expectedIds: string[];
+    readonly foundIds: string[];
+    constructor(expectedIds: string[], foundIds: string[], message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/src/plugin/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/plugin/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAGxB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM;CAYnB;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;gBAEhB,WAAW,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM;CASxE"}

package/dist/src/plugin/errors.js

@@ -0,0 +1,42 @@
+/**
+ * Custom error types for opencode-kimicode-auth plugin.
+ *
+ * Ported from LLM-API-Key-Proxy for robust error handling.
+ */
+/**
+ * Error thrown when the provider returns an empty response after retry attempts.
+ *
+ * Empty responses can occur when:
+ * - The model has no candidates/choices
+ * - The response body is empty or malformed
+ * - A temporary service issue prevents generation
+ */
+export class EmptyResponseError extends Error {
+    provider;
+    model;
+    attempts;
+    constructor(provider, model, attempts, message) {
+        super(message ??
+            `The model returned an empty response after ${attempts} attempts. ` +
+                `This may indicate a temporary service issue. Please try again.`);
+        this.name = "EmptyResponseError";
+        this.provider = provider;
+        this.model = model;
+        this.attempts = attempts;
+    }
+}
+/**
+ * Error thrown when tool ID matching fails and cannot be recovered.
+ */
+export class ToolIdMismatchError extends Error {
+    expectedIds;
+    foundIds;
+    constructor(expectedIds, foundIds, message) {
+        super(message ??
+            `Tool ID mismatch: expected [${expectedIds.join(", ")}] but found [${foundIds.join(", ")}]`);
+        this.name = "ToolIdMismatchError";
+        this.expectedIds = expectedIds;
+        this.foundIds = foundIds;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/plugin/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/plugin/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,QAAQ,CAAS;IACjB,KAAK,CAAS;IACd,QAAQ,CAAS;IAE1B,YACE,QAAgB,EAChB,KAAa,EACb,QAAgB,EAChB,OAAgB;QAEhB,KAAK,CACH,OAAO;YACL,8CAA8C,QAAQ,aAAa;gBACnE,gEAAgE,CACnE,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,WAAW,CAAW;IACtB,QAAQ,CAAW;IAE5B,YAAY,WAAqB,EAAE,QAAkB,EAAE,OAAgB;QACrE,KAAK,CACH,OAAO;YACL,+BAA+B,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC9F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF"}

package/dist/src/plugin/fingerprint.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Device Identity Module
+ *
+ * Generates unique device identifiers for Kimi Code API requests.
+ * Used for device fingerprinting in X-Msh-Device-Id headers.
+ */
+export interface Fingerprint {
+    deviceId: string;
+    createdAt: number;
+}
+/**
+ * Fingerprint version for history tracking.
+ * Stores a snapshot of a fingerprint with metadata about when/why it was saved.
+ */
+export interface FingerprintVersion {
+    fingerprint: Fingerprint;
+    timestamp: number;
+    reason: 'initial' | 'regenerated' | 'restored';
+}
+/** Maximum number of fingerprint versions to keep per account */
+export declare const MAX_FINGERPRINT_HISTORY = 5;
+/**
+ * Generate a device identity with a unique device ID.
+ */
+export declare function generateFingerprint(): Fingerprint;
+/**
+ * Best-effort coercion of stored fingerprints.
+ * Keeps existing device ids when valid, normalizes legacy UUIDs, and regenerates when missing/corrupt.
+ */
+export declare function coerceFingerprint(value: unknown): Fingerprint;
+/**
+ * Get or create the session fingerprint.
+ * Returns the same fingerprint for all calls within a session.
+ */
+export declare function getSessionFingerprint(): Fingerprint;
+/**
+ * Regenerate the session fingerprint.
+ * Call this to get a fresh identity (e.g., after rate limiting).
+ */
+export declare function regenerateSessionFingerprint(): Fingerprint;
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/src/plugin/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../../src/plugin/fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,WAAW,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,aAAa,GAAG,UAAU,CAAC;CAChD;AAED,iEAAiE;AACjE,eAAO,MAAM,uBAAuB,IAAI,CAAC;AAkCzC;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,WAAW,CAMjD;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,CAuB7D;AAQD;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,WAAW,CAKnD;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,WAAW,CAG1D"}