@ank1015/llm-sdk-adapters 0.0.1

package/dist/file-keys.d.ts

@@ -0,0 +1,68 @@
+/**
+ * File-based Keys Adapter
+ *
+ * Stores encrypted API keys in ~/.llm/global/keys/
+ * Uses AES-256-GCM encryption with machine-specific key derivation.
+ */
+import type { KeysAdapter, Api } from '@ank1015/llm-types';
+/**
+ * File-based implementation of KeysAdapter.
+ * Stores encrypted API keys in the filesystem.
+ */
+export declare class FileKeysAdapter implements KeysAdapter {
+    private keysDir;
+    private saltFile;
+    constructor(keysDir?: string);
+    /**
+     * Ensure the keys directory exists.
+     */
+    private ensureKeysDir;
+    /**
+     * Get or create the encryption salt.
+     */
+    private getSalt;
+    /**
+     * Derive encryption key from machine-specific data.
+     */
+    private deriveKey;
+    /**
+     * Encrypt a string value.
+     */
+    private encrypt;
+    /**
+     * Decrypt a string value.
+     */
+    private decrypt;
+    /**
+     * Get the file path for a provider's key.
+     */
+    private getKeyPath;
+    /**
+     * Get the file path for a provider's credential bundle.
+     */
+    private getCredentialsPath;
+    /**
+     * Read an encrypted string file and decrypt it.
+     */
+    private readDecryptedFile;
+    /**
+     * Write encrypted string data to disk.
+     */
+    private writeEncryptedFile;
+    get(api: Api): Promise<string | undefined>;
+    getCredentials(api: Api): Promise<Record<string, string> | undefined>;
+    set(api: Api, key: string): Promise<void>;
+    setCredentials(api: Api, credentials: Record<string, string>): Promise<void>;
+    delete(api: Api): Promise<boolean>;
+    deleteCredentials(api: Api): Promise<boolean>;
+    list(): Promise<Api[]>;
+    /**
+     * Get the keys directory path.
+     */
+    getKeysDir(): string;
+}
+/**
+ * Create a FileKeysAdapter with the default directory.
+ */
+export declare function createFileKeysAdapter(keysDir?: string): FileKeysAdapter;
+//# sourceMappingURL=file-keys.d.ts.map

package/dist/file-keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-keys.d.ts","sourceRoot":"","sources":["../src/file-keys.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAuC3D;;;GAGG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,GAAE,MAAyB;IAK9C;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,OAAO,CAAC,OAAO;IAUf;;OAEG;IACH,OAAO,CAAC,SAAS;IAMjB;;OAEG;IACH,OAAO,CAAC,OAAO;IAcf;;OAEG;IACH,OAAO,CAAC,OAAO;IAqBf;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAWzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAMpB,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAY1C,cAAc,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IA0BrE,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUzC,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5E,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IAiBlC,iBAAiB,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7C,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAa5B;;OAEG;IACH,UAAU,IAAI,MAAM;CAGrB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,eAAe,CAEvE"}

package/dist/file-keys.js

@@ -0,0 +1,243 @@
+/**
+ * File-based Keys Adapter
+ *
+ * Stores encrypted API keys in ~/.llm/global/keys/
+ * Uses AES-256-GCM encryption with machine-specific key derivation.
+ */
+import { createCipheriv, createDecipheriv, randomBytes, scryptSync } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { KnownApis, PathTraversalError } from '@ank1015/llm-types';
+/** Directory for storing encrypted keys */
+const DEFAULT_KEYS_DIR = join(homedir(), '.llm', 'global', 'keys');
+/** Encryption algorithm */
+const ALGORITHM = 'aes-256-gcm';
+function normalizeCredentials(api, credentials) {
+    const normalized = { ...credentials };
+    if (api === 'codex') {
+        const accountId = normalized['chatgpt-account-id'] ??
+            normalized.chatgptAccountId ??
+            normalized.accountId ??
+            normalized.account_id;
+        if (accountId) {
+            normalized['chatgpt-account-id'] = accountId;
+        }
+        const apiKey = normalized.apiKey ?? normalized.access_token ?? normalized.accessToken;
+        if (apiKey) {
+            normalized.apiKey = apiKey;
+        }
+        delete normalized.chatgptAccountId;
+        delete normalized.accountId;
+        delete normalized.account_id;
+        delete normalized.access_token;
+        delete normalized.accessToken;
+    }
+    return normalized;
+}
+/**
+ * File-based implementation of KeysAdapter.
+ * Stores encrypted API keys in the filesystem.
+ */
+export class FileKeysAdapter {
+    keysDir;
+    saltFile;
+    constructor(keysDir = DEFAULT_KEYS_DIR) {
+        this.keysDir = keysDir;
+        this.saltFile = join(keysDir, '.salt');
+    }
+    /**
+     * Ensure the keys directory exists.
+     */
+    ensureKeysDir() {
+        if (!existsSync(this.keysDir)) {
+            mkdirSync(this.keysDir, { recursive: true });
+        }
+    }
+    /**
+     * Get or create the encryption salt.
+     */
+    getSalt() {
+        this.ensureKeysDir();
+        if (existsSync(this.saltFile)) {
+            return readFileSync(this.saltFile);
+        }
+        const salt = randomBytes(32);
+        writeFileSync(this.saltFile, salt);
+        return salt;
+    }
+    /**
+     * Derive encryption key from machine-specific data.
+     */
+    deriveKey() {
+        const salt = this.getSalt();
+        const machineId = `${homedir()}-llm-keys`;
+        return scryptSync(machineId, salt, 32);
+    }
+    /**
+     * Encrypt a string value.
+     */
+    encrypt(plaintext) {
+        const key = this.deriveKey();
+        const iv = randomBytes(16);
+        const cipher = createCipheriv(ALGORITHM, key, iv);
+        let encrypted = cipher.update(plaintext, 'utf8', 'hex');
+        encrypted += cipher.final('hex');
+        const authTag = cipher.getAuthTag();
+        // Format: iv:authTag:encrypted
+        return `${iv.toString('hex')}:${authTag.toString('hex')}:${encrypted}`;
+    }
+    /**
+     * Decrypt a string value.
+     */
+    decrypt(ciphertext) {
+        const key = this.deriveKey();
+        const parts = ciphertext.split(':');
+        if (parts.length !== 3) {
+            throw new Error('Invalid encrypted data format');
+        }
+        const [ivHex, authTagHex, encrypted] = parts;
+        const iv = Buffer.from(ivHex, 'hex');
+        const authTag = Buffer.from(authTagHex, 'hex');
+        const decipher = createDecipheriv(ALGORITHM, key, iv);
+        decipher.setAuthTag(authTag);
+        let decrypted = decipher.update(encrypted, 'hex', 'utf8');
+        decrypted += decipher.final('utf8');
+        return decrypted;
+    }
+    /**
+     * Get the file path for a provider's key.
+     */
+    getKeyPath(api) {
+        const apiStr = String(api);
+        if (apiStr.includes('..') || apiStr.includes('/') || apiStr.includes('\\')) {
+            throw new PathTraversalError(apiStr);
+        }
+        return join(this.keysDir, `${apiStr}.key`);
+    }
+    /**
+     * Get the file path for a provider's credential bundle.
+     */
+    getCredentialsPath(api) {
+        const apiStr = String(api);
+        if (apiStr.includes('..') || apiStr.includes('/') || apiStr.includes('\\')) {
+            throw new PathTraversalError(apiStr);
+        }
+        return join(this.keysDir, `${apiStr}.credentials`);
+    }
+    /**
+     * Read an encrypted string file and decrypt it.
+     */
+    readDecryptedFile(path) {
+        if (!existsSync(path))
+            return undefined;
+        try {
+            const encrypted = readFileSync(path, 'utf8');
+            return this.decrypt(encrypted);
+        }
+        catch {
+            return undefined;
+        }
+    }
+    /**
+     * Write encrypted string data to disk.
+     */
+    writeEncryptedFile(path, plaintext) {
+        this.ensureKeysDir();
+        const encrypted = this.encrypt(plaintext);
+        writeFileSync(path, encrypted, 'utf8');
+    }
+    async get(api) {
+        // Prefer apiKey from credentials bundle when present.
+        const credentials = await this.getCredentials(api);
+        const bundledApiKey = credentials?.apiKey;
+        if (bundledApiKey) {
+            return bundledApiKey;
+        }
+        // Fallback to legacy single-key storage.
+        return this.readDecryptedFile(this.getKeyPath(api));
+    }
+    async getCredentials(api) {
+        const credentialsRaw = this.readDecryptedFile(this.getCredentialsPath(api));
+        if (credentialsRaw) {
+            try {
+                const parsed = JSON.parse(credentialsRaw);
+                if (!parsed || typeof parsed !== 'object')
+                    return undefined;
+                const credentials = {};
+                for (const [key, value] of Object.entries(parsed)) {
+                    if (typeof value === 'string' && value) {
+                        credentials[key] = value;
+                    }
+                }
+                const normalized = normalizeCredentials(api, credentials);
+                return Object.keys(normalized).length > 0 ? normalized : undefined;
+            }
+            catch {
+                // Corrupted credentials bundle
+                return undefined;
+            }
+        }
+        // Backwards-compatible fallback for legacy single-key storage.
+        const apiKey = this.readDecryptedFile(this.getKeyPath(api));
+        if (!apiKey)
+            return undefined;
+        return { apiKey };
+    }
+    async set(api, key) {
+        // Keep legacy path for compatibility with existing consumers/tools.
+        this.writeEncryptedFile(this.getKeyPath(api), key);
+        // Keep credentials bundle in sync when present.
+        const existing = (await this.getCredentials(api)) ?? {};
+        const updated = { ...existing, apiKey: key };
+        this.writeEncryptedFile(this.getCredentialsPath(api), JSON.stringify(updated));
+    }
+    async setCredentials(api, credentials) {
+        const normalized = normalizeCredentials(api, credentials);
+        this.writeEncryptedFile(this.getCredentialsPath(api), JSON.stringify(normalized));
+        // Keep legacy single-key path in sync when apiKey is provided.
+        if (normalized.apiKey !== undefined) {
+            this.writeEncryptedFile(this.getKeyPath(api), normalized.apiKey);
+        }
+    }
+    async delete(api) {
+        const keyPath = this.getKeyPath(api);
+        const credentialsPath = this.getCredentialsPath(api);
+        let deleted = false;
+        if (existsSync(keyPath)) {
+            unlinkSync(keyPath);
+            deleted = true;
+        }
+        if (existsSync(credentialsPath)) {
+            unlinkSync(credentialsPath);
+            deleted = true;
+        }
+        return deleted;
+    }
+    async deleteCredentials(api) {
+        return this.delete(api);
+    }
+    async list() {
+        this.ensureKeysDir();
+        const providers = [];
+        for (const api of KnownApis) {
+            if (existsSync(this.getKeyPath(api)) || existsSync(this.getCredentialsPath(api))) {
+                providers.push(api);
+            }
+        }
+        return providers;
+    }
+    /**
+     * Get the keys directory path.
+     */
+    getKeysDir() {
+        return this.keysDir;
+    }
+}
+/**
+ * Create a FileKeysAdapter with the default directory.
+ */
+export function createFileKeysAdapter(keysDir) {
+    return new FileKeysAdapter(keysDir);
+}
+//# sourceMappingURL=file-keys.js.map

package/dist/file-keys.js.map

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

package/dist/file-sessions.d.ts

@@ -0,0 +1,55 @@
+/**
+ * File-based Sessions Adapter
+ *
+ * Stores sessions as JSONL files in ~/.llm/sessions/<projectName>/<path>/<sessionId>.jsonl
+ * Sessions are tree structures with branching support.
+ */
+import type { AppendCustomInput, AppendMessageInput, CreateSessionInput, SessionLocation, SessionsAdapter, BranchInfo, CustomNode, MessageNode, Session, SessionHeader, SessionNode, SessionSummary } from '@ank1015/llm-types';
+/**
+ * File-based implementation of SessionsAdapter.
+ */
+export declare class FileSessionsAdapter implements SessionsAdapter {
+    private baseDir;
+    constructor(baseDir?: string);
+    /**
+     * Get the full directory path for a project/path combination.
+     */
+    private getSessionDir;
+    /**
+     * Get the full file path for a session.
+     */
+    private getSessionFilePath;
+    /**
+     * Ensure a directory exists.
+     */
+    private ensureDir;
+    createSession(input: CreateSessionInput): Promise<{
+        sessionId: string;
+        header: SessionHeader;
+    }>;
+    getSession(location: SessionLocation): Promise<Session | undefined>;
+    deleteSession(location: SessionLocation): Promise<boolean>;
+    updateSessionName(location: SessionLocation, sessionName: string): Promise<SessionHeader | undefined>;
+    listSessions(projectName: string, path?: string): Promise<SessionSummary[]>;
+    listProjects(): Promise<string[]>;
+    appendMessage(input: AppendMessageInput): Promise<{
+        sessionId: string;
+        node: MessageNode;
+    }>;
+    appendCustom(input: AppendCustomInput): Promise<CustomNode | undefined>;
+    getBranches(location: SessionLocation): Promise<BranchInfo[] | undefined>;
+    getBranchHistory(location: SessionLocation, branch: string): Promise<SessionNode[] | undefined>;
+    getNode(location: SessionLocation, nodeId: string): Promise<SessionNode | undefined>;
+    getLatestNode(location: SessionLocation, branch?: string): Promise<SessionNode | undefined>;
+    getMessages(location: SessionLocation, branch?: string): Promise<MessageNode[] | undefined>;
+    searchSessions(projectName: string, query: string, path?: string): Promise<SessionSummary[]>;
+    /**
+     * Get the base directory for sessions.
+     */
+    getSessionsBaseDir(): string;
+}
+/**
+ * Create a FileSessionsAdapter with the default base directory.
+ */
+export declare function createFileSessionsAdapter(baseDir?: string): FileSessionsAdapter;
+//# sourceMappingURL=file-sessions.d.ts.map

package/dist/file-sessions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-sessions.d.ts","sourceRoot":"","sources":["../src/file-sessions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,UAAU,EACV,UAAU,EACV,WAAW,EACX,OAAO,EACP,aAAa,EACb,WAAW,EACX,cAAc,EACf,MAAM,oBAAoB,CAAC;AAwD5B;;GAEG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IACzD,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,GAAE,MAAkC;IAIvD;;OAEG;IACH,OAAO,CAAC,aAAa;IAMrB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAK1B;;OAEG;IACH,OAAO,CAAC,SAAS;IAMX,aAAa,CACjB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,aAAa,CAAA;KAAE,CAAC;IAsBlD,UAAU,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC;IA0BnE,aAAa,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;IAY1D,iBAAiB,CACrB,QAAQ,EAAE,eAAe,EACzB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IA4B/B,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,GAAE,MAAW,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAgD/E,YAAY,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAUjC,aAAa,CACjB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,WAAW,CAAA;KAAE,CAAC;IAsD9C,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC;IA4BvE,WAAW,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,SAAS,CAAC;IA+CzE,gBAAgB,CACpB,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC;IAuC/B,OAAO,CAAC,QAAQ,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAUpF,aAAa,CACjB,QAAQ,EAAE,eAAe,EACzB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;IAe7B,WAAW,CACf,QAAQ,EAAE,eAAe,EACzB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC;IAgB/B,cAAc,CAClB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,MAAW,GAChB,OAAO,CAAC,cAAc,EAAE,CAAC;IAO5B;;OAEG;IACH,kBAAkB,IAAI,MAAM;CAG7B;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAE/E"}