@vybestack/llxprt-code-auth 0.10.0-nightly.260613.1adad3b34

package/dist/src/precedence.js

@@ -0,0 +1,278 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export const runtimeScopedStates = new Map();
+let legacyRuntimeScopeWarningEmitted = false;
+function maskToken(token) {
+    if (!token) {
+        return '[redacted]';
+    }
+    const trimmed = token.replace(/\s+/g, '');
+    if (trimmed.length <= 4) {
+        return '*'.repeat(trimmed.length);
+    }
+    if (trimmed.length <= 8) {
+        return `${trimmed.slice(0, 2)}***${trimmed.slice(-2)}`;
+    }
+    return `${trimmed.slice(0, 4)}…${trimmed.slice(-4)}`;
+}
+function normalizeExpiry(expiry) {
+    if (expiry == null || expiry === 0 || Number.isNaN(expiry)) {
+        return undefined;
+    }
+    return expiry > 1_000_000_000_000 ? expiry : expiry * 1000;
+}
+export function resolveProfileId(settingsService) {
+    const maybeGetName = settingsService.getCurrentProfileName;
+    if (typeof maybeGetName === 'function') {
+        const profileName = maybeGetName.call(settingsService);
+        if (profileName?.trim()) {
+            return profileName.trim();
+        }
+    }
+    const currentProfile = settingsService.get('currentProfile');
+    if (typeof currentProfile === 'string' && currentProfile.trim()) {
+        return currentProfile.trim();
+    }
+    return null;
+}
+export function buildCacheKey(runtimeId, providerId, profileId) {
+    return `${runtimeId}::${providerId}::${profileId}`;
+}
+function toPublicEntry(entry, overrides) {
+    const summary = {
+        key: entry.key,
+        providerId: entry.providerId,
+        profileId: entry.profileId,
+        runtimeAuthScopeId: entry.runtimeAuthScopeId,
+        createdAt: entry.createdAt,
+        expiresAt: entry.expiresAt,
+        preview: maskToken(entry.token),
+        stale: entry.stale,
+    };
+    return overrides ? { ...summary, ...overrides } : summary;
+}
+function updateMetadataEntry(state, entry, summary) {
+    const snapshot = summary ?? toPublicEntry(entry);
+    const existingIndex = state.metadata.cacheEntries.findIndex((item) => item.key === snapshot.key);
+    if (existingIndex >= 0) {
+        state.metadata.cacheEntries[existingIndex] = snapshot;
+    }
+    else {
+        state.metadata.cacheEntries.push(snapshot);
+    }
+    state.metadata.metrics.lastUpdated = Date.now();
+}
+export function ensureRuntimeState(context, logger) {
+    const runtimeId = context.runtimeId ?? 'legacy-singleton';
+    let state = runtimeScopedStates.get(runtimeId);
+    if (!state) {
+        const metadata = {
+            runtimeAuthScopeId: runtimeId,
+            cacheEntries: [],
+            cancellationHooks: [],
+            revokedTokens: [],
+            metrics: {
+                hits: 0,
+                misses: 0,
+                lastUpdated: Date.now(),
+            },
+        };
+        state = {
+            runtimeAuthScopeId: runtimeId,
+            entries: new Map(),
+            metadata,
+            settingsSubscriptions: [],
+        };
+        runtimeScopedStates.set(runtimeId, state);
+    }
+    context.metadata ??= {};
+    context.metadata.runtimeAuthScope = state.metadata;
+    if (runtimeId === 'legacy-singleton' &&
+        !legacyRuntimeScopeWarningEmitted &&
+        process.env.DEBUG &&
+        logger) {
+        logger.warn('AuthPrecedenceResolver invoked without runtimeId; using legacy singleton auth cache.');
+        legacyRuntimeScopeWarningEmitted = true;
+    }
+    return state;
+}
+export function recordCacheHit(state) {
+    state.metadata.metrics.hits += 1;
+    state.metadata.metrics.lastUpdated = Date.now();
+}
+export function recordCacheMiss(state) {
+    state.metadata.metrics.misses += 1;
+    state.metadata.metrics.lastUpdated = Date.now();
+}
+export function getValidCachedEntry(state, providerId, profileId) {
+    const cacheKey = buildCacheKey(state.runtimeAuthScopeId, providerId, profileId);
+    const entry = state.entries.get(cacheKey);
+    if (!entry) {
+        return null;
+    }
+    if (entry.stale === true) {
+        return null;
+    }
+    if (entry.expiresAt != null && entry.expiresAt <= Date.now()) {
+        invalidateEntry(state, cacheKey, 'expired');
+        return null;
+    }
+    entry.updatedAt = Date.now();
+    updateMetadataEntry(state, entry);
+    return entry;
+}
+export function registerSettingsSubscriptions(state, settingsService, providerId, logger) {
+    if (state.settingsService === settingsService) {
+        return;
+    }
+    for (const unsubscribe of state.settingsSubscriptions) {
+        try {
+            unsubscribe();
+        }
+        catch (error) {
+            if (process.env.DEBUG && logger) {
+                logger.debug('Failed to remove runtime auth scope subscription:', error);
+            }
+        }
+    }
+    state.settingsSubscriptions = [];
+    state.settingsService = settingsService;
+    const handleProviderChange = (...args) => {
+        const [event] = args;
+        const payload = (event ?? {});
+        if (payload.provider === providerId) {
+            invalidateMatchingEntries(state, (entry) => entry.providerId === providerId, 'provider-change');
+        }
+    };
+    settingsService.on('provider-change', handleProviderChange);
+    state.settingsSubscriptions.push(() => settingsService.off('provider-change', handleProviderChange));
+    const handleProfileChange = (...args) => {
+        const [event] = args;
+        const payload = (event ?? {});
+        if (payload.key === 'currentProfile') {
+            invalidateMatchingEntries(state, () => true, 'profile-change');
+        }
+    };
+    settingsService.on('change', handleProfileChange);
+    state.settingsSubscriptions.push(() => settingsService.off('change', handleProfileChange));
+    const handleCleared = (..._args) => {
+        invalidateMatchingEntries(state, () => true, 'settings-cleared');
+    };
+    settingsService.on('cleared', handleCleared);
+    state.settingsSubscriptions.push(() => settingsService.off('cleared', handleCleared));
+}
+export function invalidateMatchingEntries(state, predicate, reason) {
+    const summaries = [];
+    for (const entry of [...state.entries.values()]) {
+        if (predicate(entry)) {
+            summaries.push(invalidateEntry(state, entry.key, reason));
+        }
+    }
+    return summaries;
+}
+export function storeRuntimeScopedToken(state, providerId, profileId, token, oauthToken) {
+    const cacheKey = buildCacheKey(state.runtimeAuthScopeId, providerId, profileId);
+    const expiresAt = normalizeExpiry(oauthToken?.expiry ?? null);
+    const now = Date.now();
+    let entry = state.entries.get(cacheKey);
+    if (!entry) {
+        entry = {
+            key: cacheKey,
+            providerId,
+            profileId,
+            runtimeAuthScopeId: state.runtimeAuthScopeId,
+            token,
+            createdAt: now,
+            updatedAt: now,
+            expiresAt,
+            stale: false,
+        };
+        state.entries.set(cacheKey, entry);
+    }
+    else {
+        entry.token = token;
+        entry.updatedAt = now;
+        entry.expiresAt = expiresAt;
+        entry.stale = false;
+    }
+    if (entry.cancellationHook) {
+        state.metadata.cancellationHooks = state.metadata.cancellationHooks.filter((hook) => hook !== entry.cancellationHook);
+    }
+    const cancellationHook = () => {
+        invalidateEntry(state, cacheKey, 'cancellation-hook');
+    };
+    entry.cancellationHook = cancellationHook;
+    state.metadata.cancellationHooks.push(cancellationHook);
+    updateMetadataEntry(state, entry, toPublicEntry(entry));
+}
+export function invalidateEntry(state, cacheKey, reason) {
+    const entry = state.entries.get(cacheKey);
+    if (!entry) {
+        const summary = {
+            key: cacheKey,
+            providerId: 'unknown',
+            profileId: 'default',
+            runtimeAuthScopeId: state.runtimeAuthScopeId,
+            preview: '[revoked]',
+            createdAt: Date.now(),
+            expiresAt: undefined,
+            stale: true,
+            reason,
+        };
+        state.metadata.revokedTokens.push(summary);
+        state.metadata.metrics.lastUpdated = Date.now();
+        return summary;
+    }
+    entry.stale = true;
+    entry.updatedAt = Date.now();
+    const summary = toPublicEntry(entry, { stale: true, reason });
+    state.entries.delete(cacheKey);
+    updateMetadataEntry(state, entry, summary);
+    if (entry.cancellationHook) {
+        state.metadata.cancellationHooks = state.metadata.cancellationHooks.filter((hook) => hook !== entry.cancellationHook);
+    }
+    state.metadata.revokedTokens.push(summary);
+    state.metadata.metrics.lastUpdated = Date.now();
+    entry.token = '';
+    entry.expiresAt = undefined;
+    entry.cancellationHook = undefined;
+    return summary;
+}
+/**
+ * Flush scoped credentials for a runtime and return revocation metadata.
+ * @plan PLAN-20251018-STATELESSPROVIDER2.P18, PLAN-20260608-ISSUE1586.P09
+ * @requirement REQ-SP2-004, REQ-API-001.4
+ */
+export function flushRuntimeAuthScope(runtimeId) {
+    const state = runtimeScopedStates.get(runtimeId);
+    if (!state) {
+        return { runtimeId, revokedTokens: [] };
+    }
+    const revokedTokens = [];
+    for (const key of [...state.entries.keys()]) {
+        revokedTokens.push(invalidateEntry(state, key, 'runtime-dispose'));
+    }
+    for (const unsubscribe of state.settingsSubscriptions) {
+        try {
+            unsubscribe();
+        }
+        catch {
+            // Best-effort cleanup
+        }
+    }
+    state.settingsSubscriptions = [];
+    state.settingsService = undefined;
+    state.metadata.cancellationHooks = [];
+    state.metadata.cacheEntries = state.metadata.cacheEntries.map((entry) => ({
+        ...entry,
+        stale: true,
+    }));
+    state.metadata.metrics.lastUpdated = Date.now();
+    runtimeScopedStates.delete(runtimeId);
+    return { runtimeId, revokedTokens };
+}
+export { AuthPrecedenceResolver } from './auth-precedence-resolver.js';
+//# sourceMappingURL=precedence.js.map

package/dist/src/precedence.js.map

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

package/dist/src/proxy/framing.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Length-prefixed framing protocol for credential proxy IPC.
+ *
+ * @plan PLAN-20250214-CREDPROXY.P03
+ * @requirement R5.1, R5.2, R5.3
+ * @pseudocode analysis/pseudocode/001-framing-protocol.md
+ */
+export declare const MAX_FRAME_SIZE = 65536;
+export declare const PARTIAL_FRAME_TIMEOUT_MS = 5000;
+export declare class FrameError extends Error {
+    constructor(message: string);
+}
+export declare function encodeFrame(payload: Record<string, unknown>): Buffer;
+export interface FrameDecoderOptions {
+    /**
+     * Called when a partial frame times out. The buffer is reset after this
+     * callback returns. Use this to close the connection or log the error.
+     */
+    onPartialFrameTimeout?: () => void;
+}
+export declare class FrameDecoder {
+    private buffer;
+    private partialFrameTimer;
+    private readonly onPartialFrameTimeout?;
+    constructor(options?: FrameDecoderOptions);
+    feed(chunk: Buffer): Array<Record<string, unknown>>;
+    reset(): void;
+    private startPartialFrameTimer;
+    private cancelPartialFrameTimer;
+}

package/dist/src/proxy/framing.js

@@ -0,0 +1,86 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Length-prefixed framing protocol for credential proxy IPC.
+ *
+ * @plan PLAN-20250214-CREDPROXY.P03
+ * @requirement R5.1, R5.2, R5.3
+ * @pseudocode analysis/pseudocode/001-framing-protocol.md
+ */
+// ─── Constants ───────────────────────────────────────────────────────────────
+export const MAX_FRAME_SIZE = 65536;
+export const PARTIAL_FRAME_TIMEOUT_MS = 5000;
+// ─── Errors ──────────────────────────────────────────────────────────────────
+export class FrameError extends Error {
+    constructor(message) {
+        super(message);
+    }
+}
+// ─── Functions ───────────────────────────────────────────────────────────────
+export function encodeFrame(payload) {
+    const json = JSON.stringify(payload);
+    const jsonBytes = Buffer.from(json, 'utf8');
+    if (jsonBytes.length > MAX_FRAME_SIZE) {
+        throw new FrameError('Frame exceeds maximum size');
+    }
+    const header = Buffer.alloc(4);
+    header.writeUInt32BE(jsonBytes.length, 0);
+    return Buffer.concat([header, jsonBytes]);
+}
+export class FrameDecoder {
+    buffer = Buffer.alloc(0);
+    partialFrameTimer = null;
+    onPartialFrameTimeout;
+    constructor(options = {}) {
+        this.onPartialFrameTimeout = options.onPartialFrameTimeout;
+    }
+    feed(chunk) {
+        this.buffer = Buffer.concat([this.buffer, chunk]);
+        const frames = [];
+        while (this.buffer.length >= 4) {
+            const payloadLength = this.buffer.readUInt32BE(0);
+            if (payloadLength > MAX_FRAME_SIZE) {
+                throw new FrameError('Frame exceeds maximum size');
+            }
+            if (this.buffer.length < 4 + payloadLength) {
+                this.startPartialFrameTimer();
+                break;
+            }
+            this.cancelPartialFrameTimer();
+            const jsonBytes = this.buffer.subarray(4, 4 + payloadLength);
+            this.buffer = this.buffer.subarray(4 + payloadLength);
+            let parsed;
+            try {
+                parsed = JSON.parse(jsonBytes.toString('utf8'));
+            }
+            catch (e) {
+                throw new FrameError(`Invalid JSON in frame: ${e.message}`);
+            }
+            frames.push(parsed);
+        }
+        return frames;
+    }
+    reset() {
+        this.buffer = Buffer.alloc(0);
+        this.cancelPartialFrameTimer();
+    }
+    startPartialFrameTimer() {
+        if (this.partialFrameTimer !== null)
+            return;
+        this.partialFrameTimer = setTimeout(() => {
+            this.partialFrameTimer = null;
+            this.onPartialFrameTimeout?.();
+            this.buffer = Buffer.alloc(0);
+        }, PARTIAL_FRAME_TIMEOUT_MS);
+    }
+    cancelPartialFrameTimer() {
+        if (this.partialFrameTimer !== null) {
+            clearTimeout(this.partialFrameTimer);
+            this.partialFrameTimer = null;
+        }
+    }
+}
+//# sourceMappingURL=framing.js.map

package/dist/src/proxy/framing.js.map

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

package/dist/src/proxy/proxy-provider-key-storage.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Read-only provider key storage that proxies read operations through
+ * the credential proxy Unix socket. Write operations are blocked.
+ *
+ * @plan PLAN-20250214-CREDPROXY.P12
+ * @requirement R9
+ * @pseudocode analysis/pseudocode/004-proxy-provider-key-storage.md
+ */
+import type { ProxySocketClient } from './proxy-socket-client.js';
+export declare class ProxyProviderKeyStorage {
+    private readonly client;
+    constructor(client: ProxySocketClient);
+    getKey(name: string): Promise<string | null>;
+    listKeys(): Promise<string[]>;
+    hasKey(name: string): Promise<boolean>;
+    saveKey(_name: string, _apiKey: string): Promise<void>;
+    deleteKey(_name: string): Promise<boolean>;
+}

package/dist/src/proxy/proxy-provider-key-storage.js

@@ -0,0 +1,41 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export class ProxyProviderKeyStorage {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async getKey(name) {
+        const response = await this.client.request('get_api_key', { name });
+        if (!response.ok) {
+            if (response.code === 'NOT_FOUND')
+                return null;
+            throw new Error(response.error ?? 'proxy error');
+        }
+        return response.data.key;
+    }
+    async listKeys() {
+        const response = await this.client.request('list_api_keys', {});
+        if (!response.ok) {
+            throw new Error(response.error ?? 'proxy error');
+        }
+        return response.data.keys;
+    }
+    async hasKey(name) {
+        const response = await this.client.request('has_api_key', { name });
+        if (!response.ok) {
+            throw new Error(response.error ?? 'proxy error');
+        }
+        return response.data.exists;
+    }
+    async saveKey(_name, _apiKey) {
+        throw new Error('API key management is not available in sandbox mode');
+    }
+    async deleteKey(_name) {
+        throw new Error('API key management is not available in sandbox mode');
+    }
+}
+//# sourceMappingURL=proxy-provider-key-storage.js.map

package/dist/src/proxy/proxy-provider-key-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy-provider-key-storage.js","sourceRoot":"","sources":["../../../src/proxy/proxy-provider-key-storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,MAAM,OAAO,uBAAuB;IACjB,MAAM,CAAoB;IAE3C,YAAY,MAAyB;QACnC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,IAAI,QAAQ,CAAC,IAAI,KAAK,WAAW;gBAAE,OAAO,IAAI,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,aAAa,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,QAAQ,CAAC,IAAK,CAAC,GAAa,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC;QAChE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,aAAa,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,QAAQ,CAAC,IAAK,CAAC,IAAgB,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACpE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,aAAa,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,QAAQ,CAAC,IAAK,CAAC,MAAiB,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,KAAa,EAAE,OAAe;QAC1C,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAa;QAC3B,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;IACzE,CAAC;CACF"}

package/dist/src/proxy/proxy-socket-client.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const REQUEST_TIMEOUT_MS = 30000;
+export declare const IDLE_TIMEOUT_MS = 300000;
+export declare const PROTOCOL_VERSION = 1;
+export type ProxyResponse = {
+    ok: boolean;
+    data?: Record<string, unknown>;
+    error?: string;
+    code?: string;
+    retryAfter?: number;
+};
+export declare class ProxySocketClient {
+    private readonly socketPath;
+    private socket;
+    private decoder;
+    private pendingRequests;
+    private handshakeComplete;
+    private idleTimer;
+    private connectingPromise;
+    private handshakeResolver;
+    constructor(socketPath: string);
+    ensureConnected(): Promise<void>;
+    private isConnected;
+    request(op: string, payload: Record<string, unknown>): Promise<ProxyResponse>;
+    private sendRequest;
+    close(): void;
+    gracefulClose(): void;
+    private connectAndHandshake;
+    private connect;
+    private handshake;
+    private onData;
+    private resolvePendingRequest;
+    private onError;
+    private onClose;
+    private handlePartialFrameTimeout;
+    private destroy;
+    private resetIdleTimer;
+    private cancelIdleTimer;
+}