@a5c-ai/adapters-codecs 5.1.1-staging.52898ebfc24f

package/dist/remote-adapter-base.js

@@ -0,0 +1,100 @@
+/**
+ * BaseRemoteAdapter — abstract base class for remote (HTTP/WebSocket/Unix) adapters.
+ *
+ * Provides shared utilities for connection management, server lifecycle,
+ * and common remote adapter functionality.
+ */
+/**
+ * Abstract base class for remote adapters. Provides shared utilities
+ * and sensible defaults for HTTP, WebSocket, and Unix socket adapters.
+ */
+export class BaseRemoteAdapter {
+    // ── Adapter Type ──────────────────────────────────────────────────
+    adapterType = 'remote';
+    // ── Legacy Compatibility (for validation with old interface) ────────
+    cliCommand = '[remote]'; // Stub for legacy validation
+    buildSpawnArgs(_options) {
+        throw new Error('buildSpawnArgs not supported on remote adapters');
+    }
+    parseEvent(_line, _context) {
+        throw new Error('parseEvent not supported on remote adapters');
+    }
+    // ── Optional members ──────────────────────────────────────────────
+    hostEnvSignals;
+    // ── Protected utilities ───────────────────────────────────────────
+    /**
+     * Tracks active connections for cleanup.
+     */
+    activeConnections = new Map();
+    /**
+     * Tracks managed servers for cleanup.
+     */
+    managedServers = new Map();
+    /**
+     * Register an active connection for tracking.
+     */
+    registerConnection(connection) {
+        this.activeConnections.set(connection.connectionId, connection);
+    }
+    /**
+     * Unregister a connection (called on disconnect).
+     */
+    unregisterConnection(connectionId) {
+        this.activeConnections.delete(connectionId);
+    }
+    /**
+     * Register a managed server for tracking.
+     */
+    registerServer(serverInfo) {
+        this.managedServers.set(serverInfo.serverId, serverInfo);
+    }
+    /**
+     * Unregister a server (called on stop).
+     */
+    unregisterServer(serverId) {
+        this.managedServers.delete(serverId);
+    }
+    /**
+     * Cleanup all active connections and servers.
+     * Should be called during adapter shutdown.
+     */
+    async cleanup() {
+        // Close all active connections
+        const connectionPromises = Array.from(this.activeConnections.values()).map(connection => connection.close().catch((e) => { process.stderr.write(`[adapters] adapter connection cleanup failed: ${e instanceof Error ? e.message : String(e)}\n`); }));
+        // Stop all managed servers
+        const serverPromises = Array.from(this.managedServers.values()).map(server => this.stopServer?.(server).catch((e) => { process.stderr.write(`[adapters] adapter server cleanup failed: ${e instanceof Error ? e.message : String(e)}\n`); }));
+        await Promise.all([...connectionPromises, ...serverPromises]);
+        this.activeConnections.clear();
+        this.managedServers.clear();
+    }
+    /**
+     * Generate a unique connection ID.
+     */
+    generateConnectionId() {
+        return `${this.agent}-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    }
+    /**
+     * Generate a unique server ID.
+     */
+    generateServerId() {
+        return `${this.agent}-server-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    }
+    /**
+     * Find an available port for server startup.
+     */
+    async findAvailablePort(startPort = 3000) {
+        const net = await import('node:net');
+        return new Promise((resolve, reject) => {
+            const server = net.createServer();
+            server.listen(startPort, () => {
+                const port = server.address()?.port;
+                server.close(() => resolve(port));
+            });
+            server.on('error', () => {
+                // Port is busy, try next one
+                this.findAvailablePort(startPort + 1).then(resolve).catch(reject);
+            });
+        });
+    }
+}
+//# sourceMappingURL=remote-adapter-base.js.map

package/dist/remote-adapter-base.js.map

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

package/dist/session-fs.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Shared filesystem helpers for adapter session and config I/O.
+ *
+ * Kept intentionally dependency-free — only uses `node:fs/promises`
+ * and `node:path` with forward-slash-safe joins.
+ */
+import type { CostRecord, SessionMessage } from '@a5c-ai/comm-adapter';
+export declare function findProjectRootSync(startDir?: string): string;
+export declare function listFilesRecursive(dir: string, predicate: (entryName: string, fullPath: string) => boolean): Promise<string[]>;
+/** List *.jsonl files recursively under `dir`. */
+export declare function listJsonlFiles(dir: string): Promise<string[]>;
+/** List *.json files recursively under `dir`. */
+export declare function listJsonFiles(dir: string): Promise<string[]>;
+/**
+ * Parse a JSONL file into an array of record objects (ignores blank lines
+ * and lines that fail to parse). Returns empty array if file missing.
+ */
+export declare function parseJsonlFile(filePath: string): Promise<Record<string, unknown>[]>;
+/** Read + parse a JSON file. Returns null if missing or invalid. */
+export declare function readJsonFile<T = unknown>(filePath: string): Promise<T | null>;
+/**
+ * Atomically write JSON via the unified core helper (tmp + fsync + rename
+ * with advisory lockfile). Creates parent directories as needed.
+ */
+export declare function writeJsonFileAtomic(filePath: string, data: unknown): Promise<void>;
+/**
+ * Minimal flat-YAML parser for simple `key: value` files.
+ * Supports:
+ *  - comments (# ...)
+ *  - scalar values (strings, numbers, booleans, null)
+ *  - quoted strings ("..." or '...')
+ *  - simple nested blocks via two-space indentation (one level deep)
+ * Does NOT support lists, anchors, multi-line strings.
+ */
+export declare function parseFlatYaml(text: string): Record<string, unknown>;
+/** Serialize a flat object to simple YAML (top-level + one level of nesting). */
+export declare function stringifyFlatYaml(obj: Record<string, unknown>): string;
+/** Atomically write arbitrary text via the unified core helper. */
+export declare function writeTextFileAtomic(filePath: string, text: string): Promise<void>;
+/** fs.stat safely: returns null on ENOENT. */
+export declare function statSafe(filePath: string): Promise<{
+    mtimeMs: number;
+    birthtimeMs: number;
+    size: number;
+} | null>;
+/**
+ * Normalize a path to forward slashes (Windows-safe, cross-platform).
+ */
+export declare function toPosix(p: string): string;
+/**
+ * Home-directory-relative join with forward slashes.
+ */
+export declare function homeJoin(...segments: string[]): string;
+/**
+ * Shared `parseSessionFile` logic: read JSONL, derive createdAt from
+ * file stat birthtime, updatedAt from mtime, and build SessionMessage[]
+ * from rows via `rowToMessage` heuristics.
+ * The caller supplies the agent name.
+ */
+export declare function parseJsonlSessionFile(filePath: string, agent: string): Promise<{
+    sessionId: string;
+    agent: string;
+    turnCount: number;
+    createdAt: string;
+    updatedAt: string;
+    messages: SessionMessage[];
+    raw: unknown;
+}>;
+export declare function parseCodexSessionFile(filePath: string, agent: string): Promise<{
+    sessionId: string;
+    agent: string;
+    turnCount: number;
+    createdAt: string;
+    updatedAt: string;
+    title?: string;
+    model?: string;
+    cost?: CostRecord;
+    cwd?: string;
+    messages: SessionMessage[];
+    raw: unknown;
+}>;
+/**
+ * Derive a SessionMessage-like representation from an arbitrary JSONL row.
+ * Used by adapters that don't have a more precise schema.
+ */
+export declare function rowToMessage(row: Record<string, unknown>): {
+    role: 'user' | 'assistant' | 'system' | 'tool';
+    content: string;
+} | null;

package/dist/session-fs.d.ts.map

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