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

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './src/index.js';

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './src/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/src/config/storage.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export declare const LLXPRT_DIR = ".llxprt";
+export declare const PROVIDER_ACCOUNTS_FILENAME = "provider_accounts.json";
+export declare const OAUTH_FILE = "oauth_creds.json";
+export declare class Storage {
+    private readonly targetDir;
+    constructor(targetDir: string);
+    static getGlobalLlxprtDir(): string;
+    static getMcpOAuthTokensPath(): string;
+    static getGlobalSettingsPath(): string;
+    static getInstallationIdPath(): string;
+    static getProviderAccountsPath(): string;
+    static getGoogleAccountsPath(): string;
+    static getUserCommandsDir(): string;
+    static getUserSkillsDir(): string;
+    static getGlobalMemoryFilePath(): string;
+    static getUserPoliciesDir(): string;
+    static getSystemSettingsPath(): string;
+    static getSystemPoliciesDir(): string;
+    static getGlobalTempDir(): string;
+    getLlxprtDir(): string;
+    getProjectTempDir(): string;
+    ensureProjectTempDirExists(): void;
+    static getOAuthCredsPath(): string;
+    getProjectRoot(): string;
+    private getFilePathHash;
+    getHistoryDir(): string;
+    getWorkspaceSettingsPath(): string;
+    getProjectCommandsDir(): string;
+    getProjectSkillsDir(): string;
+    getProjectTempCheckpointsDir(): string;
+    getExtensionsDir(): string;
+    getExtensionsConfigPath(): string;
+    getHistoryFilePath(): string;
+}

package/dist/src/config/storage.js

@@ -0,0 +1,118 @@
+/**
+ * @license
+ * Copyright 2025 Google LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as path from 'node:path';
+import * as os from 'os';
+import * as crypto from 'crypto';
+import * as fs from 'fs';
+export const LLXPRT_DIR = '.llxprt';
+export const PROVIDER_ACCOUNTS_FILENAME = 'provider_accounts.json';
+export const OAUTH_FILE = 'oauth_creds.json';
+const TMP_DIR_NAME = 'tmp';
+export class Storage {
+    targetDir;
+    constructor(targetDir) {
+        this.targetDir = targetDir;
+    }
+    static getGlobalLlxprtDir() {
+        const homeDir = os.homedir();
+        if (!homeDir) {
+            return path.join(os.tmpdir(), '.llxprt');
+        }
+        return path.join(homeDir, LLXPRT_DIR);
+    }
+    static getMcpOAuthTokensPath() {
+        return path.join(Storage.getGlobalLlxprtDir(), 'mcp-oauth-tokens.json');
+    }
+    static getGlobalSettingsPath() {
+        return path.join(Storage.getGlobalLlxprtDir(), 'settings.json');
+    }
+    static getInstallationIdPath() {
+        return path.join(Storage.getGlobalLlxprtDir(), 'installation_id');
+    }
+    static getProviderAccountsPath() {
+        return path.join(Storage.getGlobalLlxprtDir(), PROVIDER_ACCOUNTS_FILENAME);
+    }
+    static getGoogleAccountsPath() {
+        return path.join(Storage.getGlobalLlxprtDir(), 'google_accounts.json');
+    }
+    static getUserCommandsDir() {
+        return path.join(Storage.getGlobalLlxprtDir(), 'commands');
+    }
+    static getUserSkillsDir() {
+        return path.join(Storage.getGlobalTempDir(), 'skills');
+    }
+    static getGlobalMemoryFilePath() {
+        return path.join(Storage.getGlobalLlxprtDir(), 'memory.md');
+    }
+    static getUserPoliciesDir() {
+        return path.join(Storage.getGlobalLlxprtDir(), 'policies');
+    }
+    static getSystemSettingsPath() {
+        if (process.env['LLXPRT_SYSTEM_SETTINGS_PATH']) {
+            return process.env['LLXPRT_SYSTEM_SETTINGS_PATH'];
+        }
+        if (os.platform() === 'darwin') {
+            return '/Library/Application Support/LlxprtCode/settings.json';
+        }
+        else if (os.platform() === 'win32') {
+            return 'C:\\ProgramData\\llxprt-code\\settings.json';
+        }
+        return '/etc/llxprt-code/settings.json';
+    }
+    static getSystemPoliciesDir() {
+        return path.join(path.dirname(Storage.getSystemSettingsPath()), 'policies');
+    }
+    static getGlobalTempDir() {
+        return path.join(Storage.getGlobalLlxprtDir(), TMP_DIR_NAME);
+    }
+    getLlxprtDir() {
+        return path.join(this.targetDir, LLXPRT_DIR);
+    }
+    getProjectTempDir() {
+        const hash = this.getFilePathHash(this.getProjectRoot());
+        const tempDir = Storage.getGlobalTempDir();
+        return path.join(tempDir, hash);
+    }
+    ensureProjectTempDirExists() {
+        fs.mkdirSync(this.getProjectTempDir(), { recursive: true });
+    }
+    static getOAuthCredsPath() {
+        return path.join(Storage.getGlobalLlxprtDir(), OAUTH_FILE);
+    }
+    getProjectRoot() {
+        return this.targetDir;
+    }
+    getFilePathHash(filePath) {
+        return crypto.createHash('sha256').update(filePath).digest('hex');
+    }
+    getHistoryDir() {
+        const hash = this.getFilePathHash(this.getProjectRoot());
+        const historyDir = path.join(Storage.getGlobalLlxprtDir(), 'history');
+        return path.join(historyDir, hash);
+    }
+    getWorkspaceSettingsPath() {
+        return path.join(this.getLlxprtDir(), 'settings.json');
+    }
+    getProjectCommandsDir() {
+        return path.join(this.getLlxprtDir(), 'commands');
+    }
+    getProjectSkillsDir() {
+        return path.join(this.getLlxprtDir(), 'skills');
+    }
+    getProjectTempCheckpointsDir() {
+        return path.join(this.getProjectTempDir(), 'checkpoints');
+    }
+    getExtensionsDir() {
+        return path.join(this.getLlxprtDir(), 'extensions');
+    }
+    getExtensionsConfigPath() {
+        return path.join(this.getExtensionsDir(), 'llxprt-extension.json');
+    }
+    getHistoryFilePath() {
+        return path.join(this.getProjectTempDir(), 'shell_history');
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/src/config/storage.js.map

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

package/dist/src/conversation/ConversationFileWriter.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { StorageLogger } from '../types/logger.js';
+export declare class ConversationFileWriter {
+    private logPath;
+    private currentLogFile;
+    private logger;
+    constructor(logPath?: string, logger?: StorageLogger);
+    writeEntry(entry: Record<string, unknown>): void;
+    writeRequest(provider: string, messages: unknown[], context?: Record<string, unknown>): void;
+    writeResponse(provider: string, response: unknown, metadata?: Record<string, unknown>): void;
+    writeToolCall(provider: string, toolName: string, context?: Record<string, unknown>): void;
+}
+/**
+ * Returns the process-wide ConversationFileWriter singleton.
+ *
+ * First-call-wins: the `logPath` provided on the first invocation determines
+ * the writer's output directory for the lifetime of the process. Subsequent
+ * calls return the same instance and IGNORE any `logPath` argument. To target
+ * a different path (e.g. in tests), call
+ * {@link resetConversationFileWriterForTesting} first.
+ */
+export declare function getConversationFileWriter(logPath?: string): ConversationFileWriter;
+export declare function resetConversationFileWriterForTesting(): void;

package/dist/src/conversation/ConversationFileWriter.js

@@ -0,0 +1,78 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import { NullStorageLoggerImpl } from '../types/logger.js';
+export class ConversationFileWriter {
+    logPath;
+    currentLogFile;
+    logger;
+    constructor(logPath, logger) {
+        this.logPath =
+            // eslint-disable-next-line @typescript-eslint/prefer-nullish-coalescing -- intentional falsy coalescing: empty logPath string should fall through to default path
+            logPath || path.join(os.homedir(), '.llxprt', 'conversations');
+        this.currentLogFile = path.join(this.logPath, `conversation-${new Date().toISOString().split('T')[0]}.jsonl`);
+        this.logger = logger ?? new NullStorageLoggerImpl();
+    }
+    writeEntry(entry) {
+        try {
+            const logEntry = {
+                timestamp: new Date().toISOString(),
+                ...entry,
+            };
+            const line = JSON.stringify(logEntry) + '\n';
+            fs.mkdirSync(this.logPath, { recursive: true });
+            fs.appendFileSync(this.currentLogFile, line);
+        }
+        catch (error) {
+            this.logger.error('Failed to write log entry:', error);
+        }
+    }
+    writeRequest(provider, messages, context) {
+        this.writeEntry({
+            type: 'request',
+            provider,
+            messages,
+            context,
+        });
+    }
+    writeResponse(provider, response, metadata) {
+        this.writeEntry({
+            type: 'response',
+            provider,
+            response,
+            metadata,
+        });
+    }
+    writeToolCall(provider, toolName, context) {
+        this.writeEntry({
+            type: 'tool_call',
+            provider,
+            tool: toolName,
+            ...context,
+        });
+    }
+}
+// Singleton instance
+let fileWriter = null;
+/**
+ * Returns the process-wide ConversationFileWriter singleton.
+ *
+ * First-call-wins: the `logPath` provided on the first invocation determines
+ * the writer's output directory for the lifetime of the process. Subsequent
+ * calls return the same instance and IGNORE any `logPath` argument. To target
+ * a different path (e.g. in tests), call
+ * {@link resetConversationFileWriterForTesting} first.
+ */
+export function getConversationFileWriter(logPath) {
+    fileWriter ??= new ConversationFileWriter(logPath);
+    return fileWriter;
+}
+export function resetConversationFileWriterForTesting() {
+    fileWriter = null;
+}
+//# sourceMappingURL=ConversationFileWriter.js.map

package/dist/src/conversation/ConversationFileWriter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ConversationFileWriter.js","sourceRoot":"","sources":["../../../src/conversation/ConversationFileWriter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAEzB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAE3D,MAAM,OAAO,sBAAsB;IACzB,OAAO,CAAS;IAChB,cAAc,CAAS;IACvB,MAAM,CAAgB;IAE9B,YAAY,OAAgB,EAAE,MAAsB;QAClD,IAAI,CAAC,OAAO;YACV,kKAAkK;YAClK,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,eAAe,CAAC,CAAC;QACjE,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,IAAI,CAC7B,IAAI,CAAC,OAAO,EACZ,gBAAgB,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAC/D,CAAC;QACF,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,IAAI,qBAAqB,EAAE,CAAC;IACtD,CAAC;IAED,UAAU,CAAC,KAA8B;QACvC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG;gBACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACnC,GAAG,KAAK;aACT,CAAC;YACF,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;YAC7C,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAChD,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,4BAA4B,EAAE,KAAK,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAED,YAAY,CACV,QAAgB,EAChB,QAAmB,EACnB,OAAiC;QAEjC,IAAI,CAAC,UAAU,CAAC;YACd,IAAI,EAAE,SAAS;YACf,QAAQ;YACR,QAAQ;YACR,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IAED,aAAa,CACX,QAAgB,EAChB,QAAiB,EACjB,QAAkC;QAElC,IAAI,CAAC,UAAU,CAAC;YACd,IAAI,EAAE,UAAU;YAChB,QAAQ;YACR,QAAQ;YACR,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IAED,aAAa,CACX,QAAgB,EAChB,QAAgB,EAChB,OAAiC;QAEjC,IAAI,CAAC,UAAU,CAAC;YACd,IAAI,EAAE,WAAW;YACjB,QAAQ;YACR,IAAI,EAAE,QAAQ;YACd,GAAG,OAAO;SACX,CAAC,CAAC;IACL,CAAC;CACF;AAED,qBAAqB;AACrB,IAAI,UAAU,GAAkC,IAAI,CAAC;AAErD;;;;;;;;GAQG;AACH,MAAM,UAAU,yBAAyB,CACvC,OAAgB;IAEhB,UAAU,KAAK,IAAI,sBAAsB,CAAC,OAAO,CAAC,CAAC;IACnD,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,UAAU,qCAAqC;IACnD,UAAU,GAAG,IAAI,CAAC;AACpB,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,12 @@
+export type { StorageLogger, NullStorageLogger } from './types/logger.js';
+export { NullStorageLoggerImpl } from './types/logger.js';
+export { Storage, LLXPRT_DIR, PROVIDER_ACCOUNTS_FILENAME, OAUTH_FILE, } from './config/storage.js';
+export { FileSystemService, StandardFileSystemService, } from './services/fileSystemService.js';
+export { FileDiscoveryService } from './services/fileDiscoveryService.js';
+export type { FilterFilesOptions, FilterReport, } from './services/fileDiscoveryService.js';
+export { SecureStore, SecureStoreError, createDefaultKeyringAdapter, } from './secure-store/secure-store.js';
+export type { KeyringAdapter, SecureStoreErrorCode, SecureStoreOptions, } from './secure-store/secure-store.js';
+export { ProviderKeyStorage, KEY_NAME_REGEX, getProviderKeyStorage, resetProviderKeyStorage, validateKeyName, } from './secure-store/provider-key-storage.js';
+export { SESSION_FILE_PREFIX } from './session/sessionTypes.js';
+export type { ConversationRecord, BaseMessageRecord, ToolCallRecord, } from './session/sessionTypes.js';
+export { ConversationFileWriter, getConversationFileWriter, } from './conversation/ConversationFileWriter.js';

package/dist/src/index.js

@@ -0,0 +1,14 @@
+export { NullStorageLoggerImpl } from './types/logger.js';
+// Storage paths and constants
+export { Storage, LLXPRT_DIR, PROVIDER_ACCOUNTS_FILENAME, OAUTH_FILE, } from './config/storage.js';
+// File services
+export { FileSystemService, StandardFileSystemService, } from './services/fileSystemService.js';
+export { FileDiscoveryService } from './services/fileDiscoveryService.js';
+// Secure storage
+export { SecureStore, SecureStoreError, createDefaultKeyringAdapter, } from './secure-store/secure-store.js';
+export { ProviderKeyStorage, KEY_NAME_REGEX, getProviderKeyStorage, resetProviderKeyStorage, validateKeyName, } from './secure-store/provider-key-storage.js';
+// Session types and constants
+export { SESSION_FILE_PREFIX } from './session/sessionTypes.js';
+// Conversation file writer
+export { ConversationFileWriter, getConversationFileWriter, } from './conversation/ConversationFileWriter.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,8BAA8B;AAC9B,OAAO,EACL,OAAO,EACP,UAAU,EACV,0BAA0B,EAC1B,UAAU,GACX,MAAM,qBAAqB,CAAC;AAE7B,gBAAgB;AAChB,OAAO,EACL,iBAAiB,EACjB,yBAAyB,GAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAM1E,iBAAiB;AACjB,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,2BAA2B,GAC5B,MAAM,gCAAgC,CAAC;AAMxC,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,GAChB,MAAM,wCAAwC,CAAC;AAEhD,8BAA8B;AAC9B,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAOhE,2BAA2B;AAC3B,OAAO,EACL,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,0CAA0C,CAAC"}

package/dist/src/secure-store/provider-key-storage.d.ts

@@ -0,0 +1,53 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { SecureStore } from './secure-store.js';
+/** @pseudocode line 1 */
+export declare const KEY_NAME_REGEX: RegExp;
+/**
+ * Validates a key name against the allowed pattern.
+ * @throws {Error} if the name does not match KEY_NAME_REGEX
+ *
+ * @plan PLAN-20260211-SECURESTORE.P12
+ * @pseudocode lines 3-9
+ * @requirement R10.1, R10.2
+ */
+export declare function validateKeyName(name: string): void;
+/**
+ * @plan PLAN-20260211-SECURESTORE.P12
+ * @pseudocode lines 11-65
+ * @requirement R9.1
+ */
+export declare class ProviderKeyStorage {
+    private readonly secureStore;
+    /** @pseudocode lines 16-24 */
+    constructor(options?: {
+        secureStore?: SecureStore;
+    });
+    /** @pseudocode lines 26-39 */
+    saveKey(name: string, apiKey: string): Promise<void>;
+    /** @pseudocode lines 41-46 */
+    getKey(name: string): Promise<string | null>;
+    /** @pseudocode lines 48-53 */
+    deleteKey(name: string): Promise<boolean>;
+    /** @pseudocode lines 55-57 */
+    listKeys(): Promise<string[]>;
+    /** @pseudocode lines 59-64 */
+    hasKey(name: string): Promise<boolean>;
+}
+/**
+ * Returns the singleton ProviderKeyStorage instance for direct host access.
+ *
+ * @internal **DO NOT call directly in consumer code.**
+ * Use `createProviderKeyStorage()` from `credential-store-factory.ts` instead.
+ * This ensures proper environment detection (sandbox vs. direct mode)
+ * and consistent behavior across the application.
+ *
+ * @pseudocode lines 70-74
+ * @plan PLAN-20250214-CREDPROXY.P36
+ */
+export declare function getProviderKeyStorage(): ProviderKeyStorage;
+/** @pseudocode lines 77-79 */
+export declare function resetProviderKeyStorage(): void;

package/dist/src/secure-store/provider-key-storage.js

@@ -0,0 +1,117 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+/**
+ * Named API key management backed by SecureStore.
+ *
+ * Provides CRUD operations for named provider API keys with validation,
+ * trimming, and singleton access. All storage is delegated to SecureStore.
+ *
+ * @plan PLAN-20260211-SECURESTORE.P12
+ * @requirement R9.1, R10.1
+ */
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { SecureStore } from './secure-store.js';
+// ─── Constants ───────────────────────────────────────────────────────────────
+/** @pseudocode line 1 */
+export const KEY_NAME_REGEX = /^[a-zA-Z0-9._-]{1,64}$/;
+/** @pseudocode line 13 */
+const SERVICE_NAME = 'llxprt-code-provider-keys';
+/** @pseudocode line 14 */
+const DEFAULT_FALLBACK_DIR = () => {
+    const homeDir = os.homedir();
+    if (typeof homeDir === 'string' && homeDir.length > 0) {
+        return path.join(homeDir, '.llxprt', 'provider-keys');
+    }
+    const tmpDir = os.tmpdir();
+    return path.join(tmpDir, 'llxprt-provider-keys');
+};
+// ─── Validation ──────────────────────────────────────────────────────────────
+/**
+ * Validates a key name against the allowed pattern.
+ * @throws {Error} if the name does not match KEY_NAME_REGEX
+ *
+ * @plan PLAN-20260211-SECURESTORE.P12
+ * @pseudocode lines 3-9
+ * @requirement R10.1, R10.2
+ */
+export function validateKeyName(name) {
+    if (!KEY_NAME_REGEX.test(name)) {
+        throw new Error(`Key name '${name}' is invalid. Use only letters, numbers, dashes, underscores, and dots (1-64 chars).`);
+    }
+}
+// ─── ProviderKeyStorage Class ────────────────────────────────────────────────
+/**
+ * @plan PLAN-20260211-SECURESTORE.P12
+ * @pseudocode lines 11-65
+ * @requirement R9.1
+ */
+export class ProviderKeyStorage {
+    secureStore;
+    /** @pseudocode lines 16-24 */
+    constructor(options) {
+        this.secureStore =
+            options?.secureStore ??
+                new SecureStore(SERVICE_NAME, {
+                    fallbackDir: DEFAULT_FALLBACK_DIR(),
+                    fallbackPolicy: 'allow',
+                });
+    }
+    /** @pseudocode lines 26-39 */
+    async saveKey(name, apiKey) {
+        validateKeyName(name);
+        let trimmed = apiKey.trim();
+        while (trimmed.endsWith('\n') || trimmed.endsWith('\r')) {
+            trimmed = trimmed.slice(0, -1);
+        }
+        if (trimmed.length === 0) {
+            throw new Error('API key value cannot be empty.');
+        }
+        await this.secureStore.set(name, trimmed);
+    }
+    /** @pseudocode lines 41-46 */
+    async getKey(name) {
+        validateKeyName(name);
+        return this.secureStore.get(name);
+    }
+    /** @pseudocode lines 48-53 */
+    async deleteKey(name) {
+        validateKeyName(name);
+        return this.secureStore.delete(name);
+    }
+    /** @pseudocode lines 55-57 */
+    async listKeys() {
+        return this.secureStore.list();
+    }
+    /** @pseudocode lines 59-64 */
+    async hasKey(name) {
+        validateKeyName(name);
+        return this.secureStore.has(name);
+    }
+}
+// ─── Singleton ───────────────────────────────────────────────────────────────
+/** @pseudocode line 68 */
+let providerKeyStorageInstance = null;
+/**
+ * Returns the singleton ProviderKeyStorage instance for direct host access.
+ *
+ * @internal **DO NOT call directly in consumer code.**
+ * Use `createProviderKeyStorage()` from `credential-store-factory.ts` instead.
+ * This ensures proper environment detection (sandbox vs. direct mode)
+ * and consistent behavior across the application.
+ *
+ * @pseudocode lines 70-74
+ * @plan PLAN-20250214-CREDPROXY.P36
+ */
+export function getProviderKeyStorage() {
+    providerKeyStorageInstance ??= new ProviderKeyStorage();
+    return providerKeyStorageInstance;
+}
+/** @pseudocode lines 77-79 */
+export function resetProviderKeyStorage() {
+    providerKeyStorageInstance = null;
+}
+//# sourceMappingURL=provider-key-storage.js.map

package/dist/src/secure-store/provider-key-storage.js.map

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

package/dist/src/secure-store/secure-store.d.ts

@@ -0,0 +1,69 @@
+/**
+ * @license
+ * Copyright 2025 Vybestack LLC
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import type { StorageLogger } from '../types/logger.js';
+export type SecureStoreErrorCode = 'UNAVAILABLE' | 'LOCKED' | 'DENIED' | 'CORRUPT' | 'TIMEOUT' | 'NOT_FOUND';
+export declare class SecureStoreError extends Error {
+    readonly code: SecureStoreErrorCode;
+    readonly remediation: string;
+    constructor(message: string, code: SecureStoreErrorCode, remediation: string);
+}
+export interface KeyringAdapter {
+    getPassword(service: string, account: string): Promise<string | null>;
+    setPassword(service: string, account: string, password: string): Promise<void>;
+    deletePassword(service: string, account: string): Promise<boolean>;
+    findCredentials?(service: string): Promise<Array<{
+        account: string;
+        password: string;
+    }>>;
+}
+export interface SecureStoreOptions {
+    fallbackDir?: string;
+    fallbackPolicy?: 'allow' | 'deny';
+    keyringLoader?: () => Promise<KeyringAdapter | null>;
+    logger?: StorageLogger;
+}
+/**
+ * Creates a default KeyringAdapter by loading @napi-rs/keyring.
+ * Exported so that other modules can reuse this without duplicating
+ * the @napi-rs/keyring import.
+ *
+ * @plan PLAN-20260211-SECURESTORE.P08
+ */
+export declare function createDefaultKeyringAdapter(): Promise<KeyringAdapter | null>;
+/**
+ * Stores and retrieves secrets via the OS keychain or encrypted file fallback.
+ *
+ * @plan PLAN-20260211-SECURESTORE.P06
+ * @requirement R1.1, R1.3
+ */
+export declare class SecureStore {
+    private readonly serviceName;
+    private readonly fallbackPolicy;
+    private readonly keyringLoaderFn;
+    private readonly fallbackDir;
+    private readonly logger;
+    private keyringInstance;
+    private keyringLoadAttempted;
+    private probeCache;
+    private readonly PROBE_TTL_MS;
+    private consecutiveKeyringFailures;
+    private readonly KEYRING_FAILURE_THRESHOLD;
+    constructor(serviceName: string, options?: SecureStoreOptions);
+    private getKeyring;
+    private validateKey;
+    private getFallbackFilePath;
+    private recordKeyringSuccess;
+    private recordKeyringFailure;
+    isKeychainAvailable(): Promise<boolean>;
+    private writeFallbackAfterKeyringSuccess;
+    set(key: string, value: string): Promise<void>;
+    get(key: string): Promise<string | null>;
+    delete(key: string): Promise<boolean>;
+    list(): Promise<string[]>;
+    has(key: string): Promise<boolean>;
+    private writeFallbackFile;
+    private readFallbackFile;
+}