nomoreide 0.1.26 → 0.1.28

package/dist/core/db-peek.d.ts

@@ -0,0 +1,49 @@
+import type { ConfigStore } from "./config-store.js";
+import type { DatabaseEngine } from "./types.js";
+import type { RowSample, TableRef } from "./db/driver.js";
+export interface MaskedConnection {
+    name: string;
+    engine: DatabaseEngine;
+    /** Connection URL with any password redacted (path left intact for SQLite). */
+    url: string;
+}
+/** A DB connection string discovered in a service's `.env` file. */
+export interface DetectedConnection {
+    service: string;
+    key: string;
+    engine: DatabaseEngine;
+    url: string;
+    maskedUrl: string;
+}
+export interface DbPeekOptions {
+    configStore: ConfigStore;
+}
+/**
+ * DB Peek: a read-only table browser. Owns its own bundled drivers (Postgres,
+ * MySQL, SQLite) — it never borrows the agent's MCP database tooling. Drivers
+ * are cached per connection URL and reused across requests.
+ */
+export declare class DbPeek {
+    private readonly configStore;
+    private readonly drivers;
+    constructor(options: DbPeekOptions);
+    listConnections(): Promise<MaskedConnection[]>;
+    listTables(name: string): Promise<TableRef[]>;
+    sampleRows(name: string, qualifiedName: string, limit: number): Promise<{
+        engine: DatabaseEngine;
+        table: TableRef;
+    } & RowSample>;
+    /** Test an unsaved connection without caching it. */
+    test(engine: DatabaseEngine, url: string): Promise<void>;
+    /** Scan registered services' `.env` files for usable connection strings. */
+    detectFromEnv(): Promise<DetectedConnection[]>;
+    closeAll(): Promise<void>;
+    private resolve;
+    private driverFor;
+    /** Only browse tables that actually exist — blocks identifier injection. */
+    private resolveTable;
+}
+/** Guess an engine from a connection string or file path; null if unrecognized. */
+export declare function engineFromUrl(value: string): DatabaseEngine | null;
+/** Redact the password from a URL; SQLite paths are returned unchanged. */
+export declare function maskConnectionUrl(engine: DatabaseEngine, url: string): string;

package/dist/core/db-peek.js

@@ -0,0 +1,150 @@
+import { join } from "node:path";
+import { readEnvFile, entriesFromLines } from "./env-file.js";
+import { MysqlDriver } from "./db/mysql-driver.js";
+import { PostgresDriver } from "./db/postgres-driver.js";
+import { SqliteDriver } from "./db/sqlite-driver.js";
+/**
+ * DB Peek: a read-only table browser. Owns its own bundled drivers (Postgres,
+ * MySQL, SQLite) — it never borrows the agent's MCP database tooling. Drivers
+ * are cached per connection URL and reused across requests.
+ */
+export class DbPeek {
+    configStore;
+    drivers = new Map();
+    constructor(options) {
+        this.configStore = options.configStore;
+    }
+    async listConnections() {
+        const config = await this.configStore.load();
+        return config.databases.map((connection) => ({
+            name: connection.name,
+            engine: connection.engine,
+            url: maskConnectionUrl(connection.engine, connection.url),
+        }));
+    }
+    async listTables(name) {
+        const driver = await this.driverFor(await this.resolve(name));
+        return driver.listTables();
+    }
+    async sampleRows(name, qualifiedName, limit) {
+        const connection = await this.resolve(name);
+        const driver = await this.driverFor(connection);
+        const table = await this.resolveTable(driver, qualifiedName);
+        const sample = await driver.sampleRows(table, limit);
+        return { engine: connection.engine, table, ...sample };
+    }
+    /** Test an unsaved connection without caching it. */
+    async test(engine, url) {
+        const driver = createDriver(engine, url);
+        try {
+            await driver.testConnection();
+        }
+        finally {
+            await driver.close().catch(() => { });
+        }
+    }
+    /** Scan registered services' `.env` files for usable connection strings. */
+    async detectFromEnv() {
+        const config = await this.configStore.load();
+        const found = [];
+        const seen = new Set();
+        for (const service of config.services) {
+            if (!service.cwd)
+                continue;
+            const { exists, lines } = await readEnvFile(join(service.cwd, ".env"));
+            if (!exists)
+                continue;
+            for (const { key, value } of entriesFromLines(lines)) {
+                const engine = engineFromUrl(value);
+                if (!engine)
+                    continue;
+                const dedupe = `${engine}:${value}`;
+                if (seen.has(dedupe))
+                    continue;
+                seen.add(dedupe);
+                found.push({
+                    service: service.name,
+                    key,
+                    engine,
+                    url: value,
+                    maskedUrl: maskConnectionUrl(engine, value),
+                });
+            }
+        }
+        return found;
+    }
+    async closeAll() {
+        await Promise.all([...this.drivers.values()].map((driver) => driver.close().catch(() => { })));
+        this.drivers.clear();
+    }
+    async resolve(name) {
+        const config = await this.configStore.load();
+        const connection = config.databases.find((item) => item.name === name);
+        if (!connection) {
+            throw new Error(`Database connection "${name}" is not registered.`);
+        }
+        return connection;
+    }
+    async driverFor(connection) {
+        const key = `${connection.engine}::${connection.url}`;
+        let driver = this.drivers.get(key);
+        if (!driver) {
+            driver = createDriver(connection.engine, connection.url);
+            this.drivers.set(key, driver);
+        }
+        return driver;
+    }
+    /** Only browse tables that actually exist — blocks identifier injection. */
+    async resolveTable(driver, qualifiedName) {
+        const tables = await driver.listTables();
+        const table = tables.find((item) => item.qualifiedName === qualifiedName);
+        if (!table) {
+            throw new Error(`Table "${qualifiedName}" not found.`);
+        }
+        return table;
+    }
+}
+function createDriver(engine, url) {
+    switch (engine) {
+        case "postgres":
+            return new PostgresDriver(url);
+        case "mysql":
+            return new MysqlDriver(url);
+        case "sqlite":
+            return new SqliteDriver(url);
+        default:
+            throw new Error(`Unsupported database engine: ${engine}`);
+    }
+}
+/** Guess an engine from a connection string or file path; null if unrecognized. */
+export function engineFromUrl(value) {
+    const v = value.trim();
+    if (/^postgres(ql)?:\/\//i.test(v))
+        return "postgres";
+    if (/^mysql:\/\//i.test(v) || /^mariadb:\/\//i.test(v))
+        return "mysql";
+    if (/^sqlite:\/\//i.test(v) || /^file:.+\.(db|sqlite|sqlite3)/i.test(v)) {
+        return "sqlite";
+    }
+    if (/\.(db|sqlite|sqlite3)$/i.test(v))
+        return "sqlite";
+    return null;
+}
+/** Redact the password from a URL; SQLite paths are returned unchanged. */
+export function maskConnectionUrl(engine, url) {
+    if (engine === "sqlite")
+        return url;
+    try {
+        const parsed = new URL(url);
+        if (parsed.password)
+            parsed.password = "****";
+        return parsed.toString();
+    }
+    catch {
+        // Not a parseable URL — mask the middle defensively.
+        if (url.length <= 8)
+            return "****";
+        return `${url.slice(0, 4)}****${url.slice(-4)}`;
+    }
+}
+//# sourceMappingURL=db-peek.js.map

package/dist/core/db-peek.js.map

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

package/dist/core/log-sources.d.ts

@@ -0,0 +1,21 @@
+import type { LogEntry, LogQuery, LogSourceDefinition } from "./types.js";
+export declare class LogSourceError extends Error {
+}
+/**
+ * Reads a slice of a log source on demand. Never spawns a long-lived process —
+ * each call is a one-shot read, so it works for files written out-of-band
+ * (UAT/PROD) rather than streamed through a managed service.
+ *
+ * When the source has a `driver`, the query (time range, text, level) is pushed
+ * down to the host; otherwise it tails and filters client-side.
+ */
+export declare function readLogSource(source: LogSourceDefinition, query?: LogQuery): Promise<LogEntry[]>;
+/**
+ * Builds the journalctl argv for a unit + query. JSON output carries real
+ * timestamps, priority, and cursors so we don't have to guess severity.
+ */
+export declare function buildJournaldArgs(unit: string, query: LogQuery, count: number): string[];
+/** Builds the `docker logs` argv for a container + query (time window only). */
+export declare function buildDockerArgs(container: string, query: LogQuery, count: number): string[];
+/** Applies `grep`/`level` to already-fetched entries (for non-journald sources). */
+export declare function applyClientFilters(entries: LogEntry[], query: LogQuery): LogEntry[];

package/dist/core/log-sources.js

@@ -0,0 +1,219 @@
+import { execFile } from "node:child_process";
+import { readFile } from "node:fs/promises";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+const DEFAULT_LINES = 500;
+const MAX_LINES = 5000;
+const MAX_BUFFER = 8 * 1024 * 1024; // 8 MB ceiling on a single read
+const READ_TIMEOUT_MS = 15_000;
+/** Heuristic: lines that look like errors render red and survive the "errors only" filter. */
+const ERROR_PATTERN = /\b(error|fatal|exception|panic|traceback|fail(?:ed|ure)?)\b/i;
+const WARN_PATTERN = /\b(warn|warning|deprecated)\b/i;
+export class LogSourceError extends Error {
+}
+/**
+ * Reads a slice of a log source on demand. Never spawns a long-lived process —
+ * each call is a one-shot read, so it works for files written out-of-band
+ * (UAT/PROD) rather than streamed through a managed service.
+ *
+ * When the source has a `driver`, the query (time range, text, level) is pushed
+ * down to the host; otherwise it tails and filters client-side.
+ */
+export async function readLogSource(source, query = {}) {
+    const count = clampLines(query.lines ?? DEFAULT_LINES);
+    if (source.driver === "journald") {
+        if (!source.unit)
+            throw new LogSourceError("journald log source is missing a unit.");
+        const argv = buildJournaldArgs(source.unit, query, count);
+        const { stdout } = await runInvocation(argv, source.host);
+        // journald filtered server-side already; just parse structured output.
+        let entries = parseJournaldJson(source.name, stdout);
+        if (query.before) {
+            // `--reverse` returned newest-first and includes the boundary cursor;
+            // restore chronological order and drop the (inclusive) boundary entry.
+            entries = entries.reverse().filter((entry) => entry.cursor !== query.before);
+        }
+        return entries;
+    }
+    if (source.driver === "docker") {
+        if (!source.container)
+            throw new LogSourceError("docker log source is missing a container.");
+        const argv = buildDockerArgs(source.container, query, count);
+        const { stdout, stderr } = await runInvocation(argv, source.host);
+        // docker logs has no native text/level filter, so apply those client-side.
+        const entries = [
+            ...toEntries(source.name, stdout, "stdout"),
+            ...toEntries(source.name, stderr, "stderr"),
+        ];
+        return applyClientFilters(entries, query).slice(-count);
+    }
+    if (source.kind === "file") {
+        if (!source.path)
+            throw new LogSourceError("File log source is missing a path.");
+        return applyClientFilters(await tailLocalFile(source.name, source.path, count), query);
+    }
+    if (source.kind === "ssh") {
+        if (!source.host || !source.path) {
+            throw new LogSourceError("SSH log source is missing host or path.");
+        }
+        const { stdout } = await execFileAsync("ssh", [source.host, "tail", "-n", String(count), source.path], { maxBuffer: MAX_BUFFER, timeout: READ_TIMEOUT_MS });
+        return applyClientFilters(toEntries(source.name, stdout, "stdout"), query);
+    }
+    // command
+    if (!source.command)
+        throw new LogSourceError("Command log source is missing a command.");
+    const { stdout, stderr } = await execFileAsync("sh", ["-c", source.command], {
+        cwd: source.cwd,
+        maxBuffer: MAX_BUFFER,
+        timeout: READ_TIMEOUT_MS,
+    });
+    const entries = [
+        ...toEntries(source.name, stdout, "stdout"),
+        ...toEntries(source.name, stderr, "stderr"),
+    ];
+    return applyClientFilters(entries, query).slice(-count);
+}
+/**
+ * Builds the journalctl argv for a unit + query. JSON output carries real
+ * timestamps, priority, and cursors so we don't have to guess severity.
+ */
+export function buildJournaldArgs(unit, query, count) {
+    const args = ["journalctl", "-u", unit, "--no-pager", "-o", "json"];
+    if (query.since)
+        args.push("--since", query.since);
+    if (query.until)
+        args.push("--until", query.until);
+    if (query.grep)
+        args.push("--grep", query.grep);
+    if (query.level === "error")
+        args.push("-p", "err");
+    else if (query.level === "warn")
+        args.push("-p", "warning");
+    if (query.before) {
+        // Page older: start at the cursor and walk backwards `count` lines.
+        args.push("--cursor", query.before, "--reverse", "-n", String(count));
+    }
+    else if (query.cursor) {
+        // Page newer: everything after the cursor.
+        args.push("--after-cursor", query.cursor, "-n", String(count));
+    }
+    else {
+        args.push("-n", String(count));
+    }
+    return args;
+}
+/** Builds the `docker logs` argv for a container + query (time window only). */
+export function buildDockerArgs(container, query, count) {
+    const args = ["docker", "logs", "--tail", String(count), "--timestamps"];
+    if (query.since)
+        args.push("--since", query.since);
+    if (query.until)
+        args.push("--until", query.until);
+    args.push(container);
+    return args;
+}
+/**
+ * Runs an argv locally, or over ssh when `host` is set. For ssh the argv is
+ * escaped and joined into a single remote command so values with spaces
+ * (e.g. --since "1 hour ago") survive the remote shell.
+ */
+function runInvocation(argv, host) {
+    const [file, args] = host
+        ? ["ssh", [host, argv.map(shellEscape).join(" ")]]
+        : [argv[0], argv.slice(1)];
+    return execFileAsync(file, args, { maxBuffer: MAX_BUFFER, timeout: READ_TIMEOUT_MS });
+}
+function shellEscape(value) {
+    return `'${value.replace(/'/g, "'\\''")}'`;
+}
+/** Parses journalctl `-o json` lines into entries with real timestamps + levels. */
+function parseJournaldJson(service, stdout) {
+    const entries = [];
+    for (const line of stdout.split("\n")) {
+        if (!line.trim())
+            continue;
+        let record;
+        try {
+            record = JSON.parse(line);
+        }
+        catch {
+            continue; // tolerate the occasional non-JSON line
+        }
+        const text = decodeJournaldMessage(record.MESSAGE);
+        const priority = Number(record.PRIORITY);
+        // syslog priority: 0-3 = err/crit/alert/emerg → render as error (red).
+        const stream = Number.isFinite(priority) && priority <= 3 ? "stderr" : "stdout";
+        const micros = Number(record.__REALTIME_TIMESTAMP);
+        const timestamp = Number.isFinite(micros) ? new Date(micros / 1000).toISOString() : "";
+        const cursor = typeof record.__CURSOR === "string" ? record.__CURSOR : undefined;
+        entries.push({ service, stream, text, timestamp, cursor });
+    }
+    return entries;
+}
+/** journald MESSAGE is usually a string, but a byte array for non-UTF8 payloads. */
+function decodeJournaldMessage(message) {
+    if (typeof message === "string")
+        return message;
+    if (Array.isArray(message)) {
+        return String.fromCharCode(...message.filter((b) => typeof b === "number"));
+    }
+    return message == null ? "" : String(message);
+}
+/** Applies `grep`/`level` to already-fetched entries (for non-journald sources). */
+export function applyClientFilters(entries, query) {
+    let result = entries;
+    if (query.grep) {
+        const matcher = compileGrep(query.grep);
+        result = result.filter((entry) => matcher.test(entry.text));
+    }
+    if (query.level === "error") {
+        result = result.filter((entry) => entry.stream === "stderr" || ERROR_PATTERN.test(entry.text));
+    }
+    else if (query.level === "warn") {
+        result = result.filter((entry) => entry.stream === "stderr" || ERROR_PATTERN.test(entry.text) || WARN_PATTERN.test(entry.text));
+    }
+    return result;
+}
+/** Treats the term as a regex, falling back to a literal match if it's invalid. */
+function compileGrep(term) {
+    try {
+        return new RegExp(term, "i");
+    }
+    catch {
+        return new RegExp(term.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), "i");
+    }
+}
+async function tailLocalFile(name, path, count) {
+    let contents;
+    try {
+        contents = await readFile(path, "utf8");
+    }
+    catch (error) {
+        const code = error.code;
+        if (code === "ENOENT")
+            throw new LogSourceError(`File not found: ${path}`);
+        if (code === "EACCES")
+            throw new LogSourceError(`Permission denied: ${path}`);
+        throw error;
+    }
+    return toEntries(name, contents, "stdout").slice(-count);
+}
+function toEntries(service, output, defaultStream) {
+    const text = output.replace(/\n$/, "");
+    if (!text)
+        return [];
+    return text.split("\n").map((line) => ({
+        service,
+        // File/ssh tails arrive as one stream; flag error-looking lines so they
+        // still render red and survive the "errors only" filter.
+        stream: defaultStream === "stdout" && ERROR_PATTERN.test(line) ? "stderr" : defaultStream,
+        text: line,
+        timestamp: "",
+    }));
+}
+function clampLines(lines) {
+    if (!Number.isFinite(lines) || lines <= 0)
+        return DEFAULT_LINES;
+    return Math.min(Math.floor(lines), MAX_LINES);
+}
+//# sourceMappingURL=log-sources.js.map

package/dist/core/log-sources.js.map

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

package/dist/core/service-log-source.d.ts

@@ -0,0 +1,9 @@
+import type { LogSourceDefinition, ServiceDefinition } from "./types.js";
+/**
+ * Derives a queryable log source from a service that streams its logs over ssh
+ * (journald or docker). This lets a managed service's log view re-query the host
+ * for full history — search, time range, paging — instead of being limited to
+ * its live in-memory buffer. Returns null when the service has no remote,
+ * queryable backend (e.g. a local `npm run dev`).
+ */
+export declare function deriveServiceLogSource(service: ServiceDefinition): LogSourceDefinition | null;

package/dist/core/service-log-source.js

@@ -0,0 +1,49 @@
+/**
+ * Derives a queryable log source from a service that streams its logs over ssh
+ * (journald or docker). This lets a managed service's log view re-query the host
+ * for full history — search, time range, paging — instead of being limited to
+ * its live in-memory buffer. Returns null when the service has no remote,
+ * queryable backend (e.g. a local `npm run dev`).
+ */
+export function deriveServiceLogSource(service) {
+    if (service.kind !== "ssh" || !service.host || !service.command)
+        return null;
+    const unit = matchJournaldUnit(service.command);
+    if (unit) {
+        return { name: service.name, kind: "command", driver: "journald", unit, host: service.host };
+    }
+    const container = matchDockerContainer(service.command);
+    if (container) {
+        return { name: service.name, kind: "command", driver: "docker", container, host: service.host };
+    }
+    return null;
+}
+/** Pulls the unit out of a `journalctl … -u <unit>` / `--unit <unit>` command. */
+function matchJournaldUnit(command) {
+    if (!/\bjournalctl\b/.test(command))
+        return null;
+    const match = command.match(/(?:-u|--unit)[=\s]+(\S+)/);
+    return match ? stripQuotes(match[1]) : null;
+}
+/** Pulls the container out of a `docker logs [flags] <container>` command. */
+function matchDockerContainer(command) {
+    const parts = command.split(/\bdocker\s+logs\b/);
+    if (parts.length < 2)
+        return null;
+    const tokens = parts[1].trim().split(/\s+/).filter(Boolean);
+    const flagsTakingValue = new Set(["--tail", "--since", "--until", "-n"]);
+    for (let i = 0; i < tokens.length; i++) {
+        const token = tokens[i];
+        if (token.startsWith("-")) {
+            if (flagsTakingValue.has(token))
+                i++; // skip the flag's value
+            continue;
+        }
+        return stripQuotes(token); // first bare token is the container
+    }
+    return null;
+}
+function stripQuotes(value) {
+    return value.replace(/^['"]|['"]$/g, "");
+}
+//# sourceMappingURL=service-log-source.js.map

package/dist/core/service-log-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-log-source.js","sourceRoot":"","sources":["../../src/core/service-log-source.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAA0B;IAC/D,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAE7E,MAAM,IAAI,GAAG,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;IAC/F,CAAC;IACD,MAAM,SAAS,GAAG,oBAAoB,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;IAClG,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,kFAAkF;AAClF,SAAS,iBAAiB,CAAC,OAAe;IACxC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACjD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACxD,OAAO,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9C,CAAC;AAED,8EAA8E;AAC9E,SAAS,oBAAoB,CAAC,OAAe;IAC3C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IACjD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5D,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;IACzE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,IAAI,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC;gBAAE,CAAC,EAAE,CAAC,CAAC,wBAAwB;YAC9D,SAAS;QACX,CAAC;QACD,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,oCAAoC;IACjE,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC"}

package/dist/core/terminal-manager.d.ts

@@ -0,0 +1,40 @@
+import { type PtyAdapter, type TerminalSessionLike, type TerminalSize, type TerminalSnapshot } from "./terminal-session.js";
+/** A session's snapshot plus the id the manager tracks it under. */
+export interface TerminalSessionInfo extends TerminalSnapshot {
+    id: string;
+}
+/** The subset of the manager the web layer depends on (so tests can fake it). */
+export interface TerminalSessionManagerLike {
+    list(): TerminalSessionInfo[];
+    create(size?: Partial<TerminalSize>): TerminalSessionInfo;
+    get(id: string): TerminalSessionLike | undefined;
+    ensure(id: string, size?: Partial<TerminalSize>): TerminalSessionLike;
+    close(id: string): boolean;
+    disposeAll(): void;
+}
+export interface TerminalSessionManagerOptions {
+    cwd: string;
+    env?: NodeJS.ProcessEnv;
+    shell?: string;
+    /** Injectable per-session adapter factory; defaults to the real node-pty adapter. */
+    adapterFactory?: () => PtyAdapter | undefined;
+}
+/**
+ * Owns the live terminal sessions keyed by id so the web UI can run several
+ * tabs at once. The PTY lifecycle stays in {@link TerminalSession}; this layer
+ * only adds the keyed map, id generation, and fan-out helpers.
+ */
+export declare class TerminalSessionManager implements TerminalSessionManagerLike {
+    private readonly options;
+    private readonly sessions;
+    private counter;
+    constructor(options: TerminalSessionManagerOptions);
+    list(): TerminalSessionInfo[];
+    create(size?: Partial<TerminalSize>): TerminalSessionInfo;
+    get(id: string): TerminalSessionLike | undefined;
+    /** Returns the session for `id`, creating and starting one if it is unknown. */
+    ensure(id: string, size?: Partial<TerminalSize>): TerminalSessionLike;
+    close(id: string): boolean;
+    disposeAll(): void;
+    private spawn;
+}

package/dist/core/terminal-manager.js

@@ -0,0 +1,64 @@
+import { TerminalSession, } from "./terminal-session.js";
+/**
+ * Owns the live terminal sessions keyed by id so the web UI can run several
+ * tabs at once. The PTY lifecycle stays in {@link TerminalSession}; this layer
+ * only adds the keyed map, id generation, and fan-out helpers.
+ */
+export class TerminalSessionManager {
+    options;
+    sessions = new Map();
+    counter = 0;
+    constructor(options) {
+        this.options = options;
+    }
+    list() {
+        return [...this.sessions.entries()].map(([id, session]) => ({
+            id,
+            ...session.snapshot(),
+        }));
+    }
+    create(size = {}) {
+        const id = `term_${++this.counter}`;
+        const session = this.spawn(size);
+        this.sessions.set(id, session);
+        return { id, ...session.snapshot() };
+    }
+    get(id) {
+        return this.sessions.get(id);
+    }
+    /** Returns the session for `id`, creating and starting one if it is unknown. */
+    ensure(id, size = {}) {
+        const existing = this.sessions.get(id);
+        if (existing) {
+            existing.start(size);
+            return existing;
+        }
+        const session = this.spawn(size);
+        this.sessions.set(id, session);
+        return session;
+    }
+    close(id) {
+        const session = this.sessions.get(id);
+        if (!session)
+            return false;
+        session.dispose();
+        this.sessions.delete(id);
+        return true;
+    }
+    disposeAll() {
+        for (const session of this.sessions.values())
+            session.dispose();
+        this.sessions.clear();
+    }
+    spawn(size) {
+        const session = new TerminalSession({
+            adapter: this.options.adapterFactory?.(),
+            cwd: this.options.cwd,
+            env: this.options.env,
+            shell: this.options.shell,
+        });
+        session.start(size);
+        return session;
+    }
+}
+//# sourceMappingURL=terminal-manager.js.map

package/dist/core/terminal-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-manager.js","sourceRoot":"","sources":["../../src/core/terminal-manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,eAAe,GAIhB,MAAM,uBAAuB,CAAC;AAyB/B;;;;GAIG;AACH,MAAM,OAAO,sBAAsB;IAChB,OAAO,CAAgC;IACvC,QAAQ,GAAG,IAAI,GAAG,EAA+B,CAAC;IAC3D,OAAO,GAAG,CAAC,CAAC;IAEpB,YAAY,OAAsC;QAChD,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,IAAI;QACF,OAAO,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1D,EAAE;YACF,GAAG,OAAO,CAAC,QAAQ,EAAE;SACtB,CAAC,CAAC,CAAC;IACN,CAAC;IAED,MAAM,CAAC,OAA8B,EAAE;QACrC,MAAM,EAAE,GAAG,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;IACvC,CAAC;IAED,GAAG,CAAC,EAAU;QACZ,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/B,CAAC;IAED,gFAAgF;IAChF,MAAM,CAAC,EAAU,EAAE,OAA8B,EAAE;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YACrB,OAAO,QAAQ,CAAC;QAClB,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,EAAU;QACd,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,OAAO;YAAE,OAAO,KAAK,CAAC;QAC3B,OAAO,CAAC,OAAO,EAAE,CAAC;QAClB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,UAAU;QACR,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE;YAAE,OAAO,CAAC,OAAO,EAAE,CAAC;QAChE,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAEO,KAAK,CAAC,IAA2B;QACvC,MAAM,OAAO,GAAG,IAAI,eAAe,CAAC;YAClC,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE;YACxC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG;YACrB,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG;YACrB,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK;SAC1B,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpB,OAAO,OAAO,CAAC;IACjB,CAAC;CACF"}