@ank1015/llm-sdk-adapters 0.0.1

package/dist/file-sessions.js

@@ -0,0 +1,376 @@
+/**
+ * File-based Sessions Adapter
+ *
+ * Stores sessions as JSONL files in ~/.llm/sessions/<projectName>/<path>/<sessionId>.jsonl
+ * Sessions are tree structures with branching support.
+ */
+import { appendFileSync, existsSync, mkdirSync, readdirSync, readFileSync, statSync, unlinkSync, writeFileSync, } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { generateUUID } from '@ank1015/llm-core';
+import { InvalidParentError, PathTraversalError, SessionNotFoundError } from '@ank1015/llm-types';
+/** Default base directory for all sessions */
+const DEFAULT_SESSIONS_BASE_DIR = join(homedir(), '.llm', 'sessions');
+/**
+ * Validate a path component against directory traversal attacks.
+ */
+function sanitizePath(component) {
+    if (component.includes('..') || component.startsWith('/') || component.startsWith('\\')) {
+        throw new PathTraversalError(component);
+    }
+    return component.trim().replace(/\\/g, '/');
+}
+/**
+ * Generate an ISO 8601 timestamp.
+ */
+function timestamp() {
+    return new Date().toISOString();
+}
+/**
+ * Parse a JSONL file into an array of nodes.
+ */
+function parseJsonl(filePath) {
+    if (!existsSync(filePath)) {
+        return [];
+    }
+    const content = readFileSync(filePath, 'utf8');
+    const lines = content.trim().split('\n').filter(Boolean);
+    return lines.map((line, index) => {
+        try {
+            return JSON.parse(line);
+        }
+        catch {
+            throw new Error(`Failed to parse line ${index + 1} in ${filePath}`);
+        }
+    });
+}
+/**
+ * Serialize nodes to JSONL format.
+ */
+function toJsonl(nodes) {
+    return nodes.map((node) => JSON.stringify(node)).join('\n') + '\n';
+}
+/**
+ * Append a single node to a session file.
+ */
+function appendNode(filePath, node) {
+    appendFileSync(filePath, JSON.stringify(node) + '\n', 'utf8');
+}
+/**
+ * File-based implementation of SessionsAdapter.
+ */
+export class FileSessionsAdapter {
+    baseDir;
+    constructor(baseDir = DEFAULT_SESSIONS_BASE_DIR) {
+        this.baseDir = baseDir;
+    }
+    /**
+     * Get the full directory path for a project/path combination.
+     */
+    getSessionDir(projectName, path = '') {
+        sanitizePath(projectName);
+        if (path)
+            sanitizePath(path);
+        return join(this.baseDir, projectName, path);
+    }
+    /**
+     * Get the full file path for a session.
+     */
+    getSessionFilePath(projectName, path = '', sessionId) {
+        sanitizePath(sessionId);
+        return join(this.getSessionDir(projectName, path), `${sessionId}.jsonl`);
+    }
+    /**
+     * Ensure a directory exists.
+     */
+    ensureDir(dirPath) {
+        if (!existsSync(dirPath)) {
+            mkdirSync(dirPath, { recursive: true });
+        }
+    }
+    async createSession(input) {
+        const { projectName, path = '', sessionName } = input;
+        const sessionId = generateUUID();
+        const dirPath = this.getSessionDir(projectName, path);
+        const filePath = this.getSessionFilePath(projectName, path, sessionId);
+        this.ensureDir(dirPath);
+        const header = {
+            type: 'session',
+            id: sessionId,
+            parentId: null,
+            branch: 'main',
+            timestamp: timestamp(),
+            sessionName: sessionName ?? `Session ${new Date().toLocaleDateString()}`,
+        };
+        writeFileSync(filePath, JSON.stringify(header) + '\n', 'utf8');
+        return { sessionId, header };
+    }
+    async getSession(location) {
+        const { projectName, path = '', sessionId } = location;
+        const filePath = this.getSessionFilePath(projectName, path, sessionId);
+        if (!existsSync(filePath)) {
+            return undefined;
+        }
+        const nodes = parseJsonl(filePath);
+        if (nodes.length === 0) {
+            return undefined;
+        }
+        const header = nodes[0];
+        if (header?.type !== 'session') {
+            throw new Error(`Invalid session file: first node is not a session header`);
+        }
+        return {
+            location: { projectName, path, sessionId },
+            header: header,
+            nodes,
+        };
+    }
+    async deleteSession(location) {
+        const { projectName, path = '', sessionId } = location;
+        const filePath = this.getSessionFilePath(projectName, path, sessionId);
+        if (!existsSync(filePath)) {
+            return false;
+        }
+        unlinkSync(filePath);
+        return true;
+    }
+    async updateSessionName(location, sessionName) {
+        const { projectName, path = '', sessionId } = location;
+        const filePath = this.getSessionFilePath(projectName, path, sessionId);
+        if (!existsSync(filePath)) {
+            return undefined;
+        }
+        const nodes = parseJsonl(filePath);
+        if (nodes.length === 0 || nodes[0]?.type !== 'session') {
+            throw new Error(`Invalid session file: first node is not a session header`);
+        }
+        const header = nodes[0];
+        const updatedHeader = {
+            ...header,
+            sessionName,
+        };
+        nodes[0] = updatedHeader;
+        // Rewrite the entire file with updated header
+        writeFileSync(filePath, toJsonl(nodes), 'utf8');
+        return updatedHeader;
+    }
+    async listSessions(projectName, path = '') {
+        const dirPath = this.getSessionDir(projectName, path);
+        if (!existsSync(dirPath)) {
+            return [];
+        }
+        const files = readdirSync(dirPath).filter((f) => f.endsWith('.jsonl'));
+        const summaries = [];
+        for (const file of files) {
+            const filePath = join(dirPath, file);
+            const sessionId = file.replace('.jsonl', '');
+            try {
+                const nodes = parseJsonl(filePath);
+                if (nodes.length === 0 || nodes[0]?.type !== 'session') {
+                    continue;
+                }
+                const header = nodes[0];
+                const stat = statSync(filePath);
+                // Collect unique branch names
+                const branches = [...new Set(nodes.map((n) => n.branch))];
+                summaries.push({
+                    sessionId,
+                    sessionName: header.sessionName,
+                    filePath,
+                    createdAt: header.timestamp,
+                    updatedAt: stat.mtime.toISOString(),
+                    nodeCount: nodes.length,
+                    branches,
+                });
+            }
+            catch {
+                // Skip invalid files
+                continue;
+            }
+        }
+        // Sort by updatedAt descending (most recent first)
+        summaries.sort((a, b) => new Date(b.updatedAt).getTime() - new Date(a.updatedAt).getTime());
+        return summaries;
+    }
+    async listProjects() {
+        if (!existsSync(this.baseDir)) {
+            return [];
+        }
+        return readdirSync(this.baseDir, { withFileTypes: true })
+            .filter((d) => d.isDirectory())
+            .map((d) => d.name);
+    }
+    async appendMessage(input) {
+        const { projectName, path = '', sessionId, parentId: inputParentId, branch, message, api, modelId, providerOptions = {}, } = input;
+        let actualSessionId = sessionId;
+        let parentId = inputParentId;
+        let filePath;
+        if (!actualSessionId) {
+            // No sessionId provided — auto-create, use header as parent
+            const { sessionId: newId, header } = await this.createSession({ projectName, path });
+            actualSessionId = newId;
+            parentId = header.id;
+            filePath = this.getSessionFilePath(projectName, path, actualSessionId);
+        }
+        else {
+            filePath = this.getSessionFilePath(projectName, path, actualSessionId);
+            if (!existsSync(filePath)) {
+                throw new SessionNotFoundError(actualSessionId);
+            }
+        }
+        // Validate parentId exists in the session
+        const nodes = parseJsonl(filePath);
+        if (!nodes.some((n) => n.id === parentId)) {
+            throw new InvalidParentError(parentId, actualSessionId);
+        }
+        const node = {
+            type: 'message',
+            id: generateUUID(),
+            parentId,
+            branch,
+            timestamp: timestamp(),
+            message,
+            api,
+            modelId,
+            providerOptions,
+        };
+        appendNode(filePath, node);
+        return { sessionId: actualSessionId, node };
+    }
+    async appendCustom(input) {
+        const { projectName, path = '', sessionId, parentId, branch, payload } = input;
+        const filePath = this.getSessionFilePath(projectName, path, sessionId);
+        if (!existsSync(filePath)) {
+            return undefined;
+        }
+        // Validate parentId exists in the session
+        const nodes = parseJsonl(filePath);
+        if (!nodes.some((n) => n.id === parentId)) {
+            throw new InvalidParentError(parentId, sessionId);
+        }
+        const node = {
+            type: 'custom',
+            id: generateUUID(),
+            parentId,
+            branch,
+            timestamp: timestamp(),
+            payload,
+        };
+        appendNode(filePath, node);
+        return node;
+    }
+    async getBranches(location) {
+        const session = await this.getSession(location);
+        if (!session) {
+            return undefined;
+        }
+        const branchMap = new Map();
+        // Group nodes by branch
+        for (const node of session.nodes) {
+            if (!branchMap.has(node.branch)) {
+                branchMap.set(node.branch, { nodes: [], branchPointId: null });
+            }
+            branchMap.get(node.branch).nodes.push(node);
+        }
+        // Find branch points
+        for (const [branchName, data] of branchMap) {
+            if (branchName === 'main') {
+                continue;
+            }
+            const firstNode = data.nodes[0];
+            if (firstNode && firstNode.parentId) {
+                const parent = session.nodes.find((n) => n.id === firstNode.parentId);
+                if (parent && parent.branch !== branchName) {
+                    data.branchPointId = firstNode.parentId;
+                }
+            }
+        }
+        const branches = [];
+        for (const [name, data] of branchMap) {
+            const latestNode = data.nodes[data.nodes.length - 1];
+            branches.push({
+                name,
+                branchPointId: data.branchPointId,
+                nodeCount: data.nodes.length,
+                latestNodeId: latestNode?.id ?? '',
+            });
+        }
+        return branches;
+    }
+    async getBranchHistory(location, branch) {
+        const session = await this.getSession(location);
+        if (!session) {
+            return undefined;
+        }
+        // Build parent-child map
+        const childMap = new Map();
+        for (const node of session.nodes) {
+            const children = childMap.get(node.parentId) ?? [];
+            children.push(node);
+            childMap.set(node.parentId, children);
+        }
+        // Traverse from header following the specified branch
+        const history = [];
+        let currentId = null;
+        while (true) {
+            const children = childMap.get(currentId) ?? [];
+            let next = children.find((c) => c.branch === branch);
+            if (!next && currentId === null) {
+                next = children[0];
+            }
+            if (!next) {
+                break;
+            }
+            history.push(next);
+            currentId = next.id;
+        }
+        return history;
+    }
+    async getNode(location, nodeId) {
+        const session = await this.getSession(location);
+        if (!session) {
+            return undefined;
+        }
+        return session.nodes.find((n) => n.id === nodeId);
+    }
+    async getLatestNode(location, branch) {
+        const session = await this.getSession(location);
+        if (!session || session.nodes.length === 0) {
+            return undefined;
+        }
+        if (branch) {
+            const branchNodes = session.nodes.filter((n) => n.branch === branch);
+            return branchNodes[branchNodes.length - 1];
+        }
+        return session.nodes[session.nodes.length - 1];
+    }
+    async getMessages(location, branch) {
+        const session = await this.getSession(location);
+        if (!session) {
+            return undefined;
+        }
+        let nodes = session.nodes.filter((n) => n.type === 'message');
+        if (branch) {
+            nodes = nodes.filter((n) => n.branch === branch);
+        }
+        return nodes;
+    }
+    async searchSessions(projectName, query, path = '') {
+        const sessions = await this.listSessions(projectName, path);
+        const lowerQuery = query.toLowerCase();
+        return sessions.filter((s) => s.sessionName.toLowerCase().includes(lowerQuery));
+    }
+    /**
+     * Get the base directory for sessions.
+     */
+    getSessionsBaseDir() {
+        return this.baseDir;
+    }
+}
+/**
+ * Create a FileSessionsAdapter with the default base directory.
+ */
+export function createFileSessionsAdapter(baseDir) {
+    return new FileSessionsAdapter(baseDir);
+}
+//# sourceMappingURL=file-sessions.js.map

package/dist/file-sessions.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @ank1015/llm-sdk-adapters
+ *
+ * Node.js adapter implementations for @ank1015/llm-sdk.
+ *
+ * This package provides:
+ * - File-based encrypted API key storage (FileKeysAdapter)
+ * - SQLite-based usage tracking (SqliteUsageAdapter)
+ * - JSONL file-based session storage (FileSessionsAdapter)
+ * - In-memory adapters for testing (InMemoryKeysAdapter, InMemoryUsageAdapter, InMemorySessionsAdapter)
+ */
+export { FileKeysAdapter, createFileKeysAdapter } from './file-keys.js';
+export { SqliteUsageAdapter, createSqliteUsageAdapter } from './sqlite-usage.js';
+export { FileSessionsAdapter, createFileSessionsAdapter } from './file-sessions.js';
+export { InMemoryKeysAdapter } from './memory-keys.js';
+export { InMemoryUsageAdapter } from './memory-usage.js';
+export { InMemorySessionsAdapter } from './memory-sessions.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAGpF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * @ank1015/llm-sdk-adapters
+ *
+ * Node.js adapter implementations for @ank1015/llm-sdk.
+ *
+ * This package provides:
+ * - File-based encrypted API key storage (FileKeysAdapter)
+ * - SQLite-based usage tracking (SqliteUsageAdapter)
+ * - JSONL file-based session storage (FileSessionsAdapter)
+ * - In-memory adapters for testing (InMemoryKeysAdapter, InMemoryUsageAdapter, InMemorySessionsAdapter)
+ */
+// File-based adapters (Node.js specific)
+export { FileKeysAdapter, createFileKeysAdapter } from './file-keys.js';
+export { SqliteUsageAdapter, createSqliteUsageAdapter } from './sqlite-usage.js';
+export { FileSessionsAdapter, createFileSessionsAdapter } from './file-sessions.js';
+// In-memory adapters (zero deps, for testing)
+export { InMemoryKeysAdapter } from './memory-keys.js';
+export { InMemoryUsageAdapter } from './memory-usage.js';
+export { InMemorySessionsAdapter } from './memory-sessions.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,yCAAyC;AACzC,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAEpF,8CAA8C;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/keys-ui.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Keys UI — A basic HTML interface for managing API keys.
+ *
+ * Starts a local HTTP server that serves a single-page UI and exposes
+ * a small REST API backed by FileKeysAdapter.
+ *
+ * Usage:
+ *   import { startKeysUI } from './keys-ui.js';
+ *   startKeysUI({ port: 7700 });
+ *
+ * Or run directly:
+ *   node dist/keys-ui.js
+ */
+import { createServer } from 'node:http';
+export interface KeysUIOptions {
+    /** Port to listen on (default: 7700) */
+    port?: number | undefined;
+    /** Custom keys directory (default: ~/.llm/global/keys/) */
+    keysDir?: string | undefined;
+}
+/**
+ * Start the Keys UI server.
+ *
+ * @returns A handle with the HTTP server and URL.
+ */
+export declare function startKeysUI(options?: KeysUIOptions): {
+    server: ReturnType<typeof createServer>;
+    url: string;
+};
+//# sourceMappingURL=keys-ui.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keys-ui.d.ts","sourceRoot":"","sources":["../src/keys-ui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,EAAE,YAAY,EAA6C,MAAM,WAAW,CAAC;AAonBpF,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,2DAA2D;IAC3D,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,OAAO,GAAE,aAAkB,GAAG;IACxD,MAAM,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;IACxC,GAAG,EAAE,MAAM,CAAC;CACb,CAiBA"}