tinybeeai 0.0.0-stage → 0.16.1

package/dist/connections/manager.js

@@ -0,0 +1,223 @@
+import { createHash } from 'node:crypto';
+import { passthroughEnv, presetReadOnly } from './presets.js';
+import { getConnection, updateConnection } from './store.js';
+/** Same cap as OpenDots: a server with more tools than this is cut at the limit. */
+export const MAX_TOOLS = 100;
+export const CONNECT_TIMEOUT_MS = 20_000;
+export const DEFAULT_CALL_TIMEOUT_MS = 60_000;
+const MAX_RESULT_CHARS = 20_000;
+async function defaultTransport(conn, secrets) {
+    if (conn.transport === 'stdio') {
+        if (!conn.command)
+            throw new Error('A stdio connection needs a command.');
+        const { StdioClientTransport, getDefaultEnvironment } = await import('@modelcontextprotocol/sdk/client/stdio.js');
+        return new StdioClientTransport({
+            command: conn.command,
+            args: conn.args ?? [],
+            env: { ...getDefaultEnvironment(), ...(secrets ?? {}) },
+            stderr: 'ignore',
+        });
+    }
+    if (!conn.url)
+        throw new Error('An http connection needs a url.');
+    const { StreamableHTTPClientTransport } = await import('@modelcontextprotocol/sdk/client/streamableHttp.js');
+    return new StreamableHTTPClientTransport(new URL(conn.url), secrets ? { requestInit: { headers: secrets } } : undefined);
+}
+let transportFactory = defaultTransport;
+export function setTransportFactory(f) {
+    transportFactory = f ?? defaultTransport;
+}
+/** Reads the headers JSON from the env var named by headersSecretRef. Called on every connect, never stored. */
+export function readSecrets(conn) {
+    const ref = conn.headersSecretRef;
+    if (!ref)
+        return undefined;
+    const raw = process.env[ref];
+    if (raw === undefined || raw === '')
+        throw new Error(`Env var ${ref} is not set.`);
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error(`Env var ${ref} must hold a JSON object, e.g. {"Authorization":"Bearer ..."}.`);
+    }
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed))
+        throw new Error(`Env var ${ref} must hold a JSON object.`);
+    const out = {};
+    for (const [k, v] of Object.entries(parsed)) {
+        if (typeof v !== 'string')
+            throw new Error(`Env var ${ref}: value for "${k}" must be a string.`);
+        out[k] = v;
+    }
+    return out;
+}
+const clients = new Map();
+const connecting = new Map();
+function signature(conn, secrets) {
+    const body = JSON.stringify([conn.transport, conn.command, conn.args, conn.url, secrets ?? null]);
+    return createHash('sha256').update(body).digest('hex');
+}
+export function withTimeout(p, ms, what) {
+    let timer;
+    const t = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new Error(`${what} timed out after ${Math.round(ms / 1000)} s`)), ms);
+    });
+    return Promise.race([p, t]).finally(() => clearTimeout(timer));
+}
+async function closeQuietly(c) {
+    if (!c)
+        return;
+    try {
+        await c.client.close();
+    }
+    catch {
+        /* already closed */
+    }
+}
+/**
+ * Secrets for one connect: the headersSecretRef JSON, plus for a preset's stdio server the env vars
+ * the preset passes through. An explicit secret JSON wins over a passed-through var of the same name.
+ */
+function connectSecrets(conn) {
+    const own = readSecrets(conn);
+    const passed = passthroughEnv(conn);
+    return passed ? { ...passed, ...(own ?? {}) } : own;
+}
+/** Returns a connected client, reconnecting when the config or the secret value changed. */
+async function clientFor(conn) {
+    const secrets = connectSecrets(conn);
+    const sig = signature(conn, secrets);
+    const cached = clients.get(conn.id);
+    if (cached && cached.sig === sig)
+        return cached.client;
+    const inflight = connecting.get(conn.id);
+    if (inflight) {
+        const c = await inflight;
+        if (c.sig === sig)
+            return c.client;
+    }
+    if (cached) {
+        clients.delete(conn.id);
+        await closeQuietly(cached);
+    }
+    const p = (async () => {
+        const { Client: ClientCtor } = await import('@modelcontextprotocol/sdk/client/index.js');
+        const client = new ClientCtor({ name: 'localdost', version: '0.1.0' });
+        const transport = await transportFactory(conn, secrets);
+        try {
+            await withTimeout(client.connect(transport), CONNECT_TIMEOUT_MS, `Connecting to ${conn.name}`);
+        }
+        catch (err) {
+            await closeQuietly({ client, sig });
+            throw err;
+        }
+        const entry = { client, sig };
+        clients.set(conn.id, entry);
+        return entry;
+    })();
+    connecting.set(conn.id, p);
+    try {
+        return (await p).client;
+    }
+    finally {
+        connecting.delete(conn.id);
+    }
+}
+export async function disconnect(id) {
+    const c = clients.get(id);
+    clients.delete(id);
+    await closeQuietly(c);
+}
+export async function closeAllConnections() {
+    const all = [...clients.values()];
+    clients.clear();
+    await Promise.all(all.map(closeQuietly));
+}
+function errText(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+/** Connects, lists tools (paged, capped at MAX_TOOLS), and stores them with status. Keeps the user's per-tool on/off choices. */
+export async function refreshConnection(id) {
+    const conn = getConnection(id);
+    if (!conn)
+        throw new Error(`connection ${id} not found`);
+    if (!conn.enabled) {
+        await disconnect(id);
+        return updateConnection(id, { status: 'disabled', error: null });
+    }
+    try {
+        const client = await clientFor(conn);
+        const found = [];
+        let cursor;
+        do {
+            const page = await withTimeout(client.listTools(cursor ? { cursor } : undefined), CONNECT_TIMEOUT_MS, `Listing tools on ${conn.name}`);
+            for (const t of page.tools) {
+                if (found.length >= MAX_TOOLS)
+                    break;
+                const prev = conn.tools.find((x) => x.name === t.name);
+                const tool = {
+                    name: t.name,
+                    description: (t.description ?? '').slice(0, 1000),
+                    readOnly: t.annotations?.readOnlyHint === true || presetReadOnly(conn, t.name),
+                    enabled: prev ? prev.enabled : true,
+                    inputSchema: t.inputSchema ?? { type: 'object' },
+                };
+                const title = t.title ?? t.annotations?.title;
+                if (title)
+                    tool.title = title;
+                found.push(tool);
+            }
+            cursor = found.length < MAX_TOOLS ? page.nextCursor : undefined;
+        } while (cursor);
+        return updateConnection(id, { tools: found, status: 'connected', error: null });
+    }
+    catch (err) {
+        await disconnect(id);
+        return updateConnection(id, { status: 'error', error: errText(err) });
+    }
+}
+export function summarizeResult(res) {
+    const r = (res ?? {});
+    const parts = [];
+    for (const c of r.content ?? []) {
+        const item = c;
+        if (item.type === 'text' && typeof item.text === 'string')
+            parts.push(item.text);
+        else if (item.type === 'resource')
+            parts.push(item.resource?.text ?? `[resource ${item.resource?.uri ?? ''}]`);
+        else if (item.type === 'resource_link')
+            parts.push(`[link ${item.uri ?? ''}]`);
+        else if (item.type)
+            parts.push(`[${item.type}]`);
+    }
+    if (!parts.length && r.structuredContent !== undefined)
+        parts.push(JSON.stringify(r.structuredContent));
+    if (!parts.length && r.toolResult !== undefined)
+        parts.push(JSON.stringify(r.toolResult));
+    let text = parts.join('\n');
+    if (text.length > MAX_RESULT_CHARS)
+        text = `${text.slice(0, MAX_RESULT_CHARS)}\n[truncated]`;
+    const out = { isError: r.isError === true, text };
+    if (r.structuredContent !== undefined)
+        out.structured = r.structuredContent;
+    return out;
+}
+/** Calls one tool. A transport failure drops the cached client so the next call reconnects. */
+export async function callTool(connectionId, toolName, input, timeoutMs = DEFAULT_CALL_TIMEOUT_MS) {
+    const conn = getConnection(connectionId);
+    if (!conn)
+        throw new Error(`connection ${connectionId} not found`);
+    if (!conn.enabled)
+        throw new Error(`Connection ${conn.name} is disabled.`);
+    const client = await clientFor(conn);
+    try {
+        const res = await withTimeout(client.callTool({ name: toolName, arguments: input }, undefined, { timeout: timeoutMs }), timeoutMs + 1000, `${conn.name}/${toolName}`);
+        return summarizeResult(res);
+    }
+    catch (err) {
+        await disconnect(connectionId);
+        throw err;
+    }
+}
+//# sourceMappingURL=manager.js.map

package/dist/connections/manager.js.map

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

package/dist/connections/presets.js

@@ -0,0 +1,264 @@
+// Connection presets: ready-made MCP server configs a user adds with one pick in Settings.
+// A preset never carries a secret. It names the env vars localdost passes through to a stdio
+// server, and it can mark tools read-only when the server does not annotate them.
+import { existsSync } from 'node:fs';
+import { isAbsolute, join, normalize } from 'node:path';
+import { setting } from '../config.js';
+import { aivisionTokenFor, TOKEN_KEY } from '../connect/aivision-token.js';
+/** Port the AI-Vision MCP server talks to when neither VEESAN_ENGINE_URL nor AIVISION_PORT is set. */
+const DEFAULT_PORT = 5880;
+import { getConnection } from './store.js';
+const AIVISION_READ_ONLY = [
+    'veesan_tests_list',
+    'veesan_tests_read',
+    'veesan_tests_history',
+    'veesan_runs_list',
+    'veesan_runs_get',
+    'veesan_runs_status',
+    'veesan_runs_activity',
+    'veesan_runs_wait',
+    'veesan_runs_report',
+    'veesan_runs_evidence',
+    'veesan_series_list',
+    'veesan_series_read',
+    'veesan_history_list',
+    'veesan_heals_list',
+    'veesan_platform_read',
+    'veesan_devices_list',
+    'veesan_health_check',
+    'veesan_profiles_list',
+    'veesan_profiles_read',
+    'veesan_proposals_list',
+    'veesan_proposals_read',
+    'veesan_coverage_list',
+    'veesan_coverage_read',
+    'veesan_coverage_claims',
+    'veesan_coverage_gate',
+    'veesan_findings_list',
+    'veesan_bugs_list',
+    'veesan_kb_list',
+    'veesan_kb_read',
+    'veesan_sync_status',
+    'veesan_tools_list',
+    'veesan_usage_read',
+];
+/** The preset the onboarding Next steps row adds. */
+export const KATALON_PRESET_ID = 'katalon-true-platform';
+export const PRESETS = [
+    {
+        id: 'aivision',
+        name: 'AI-Vision (Veesan)',
+        description: 'Vision tests from an AI-Vision server: an AI model drives a real browser through YAML test cases. Starts the server MCP process from a local checkout; the AI-Vision server must be running.',
+        transport: 'stdio',
+        command: 'npx',
+        args: ['tsx', '{checkout}/apps/playground/demo/veesan-mcp.mts'],
+        params: [
+            {
+                key: 'checkout',
+                label: 'AI-Vision checkout',
+                hint: 'Absolute path of the AI-Vision repository on the localdost host.',
+                placeholder: '/home/me/code/aivision',
+                defaultEnv: 'AIVISION_CHECKOUT',
+                kind: 'path',
+                mustContain: 'apps/playground/demo/veesan-mcp.mts',
+            },
+        ],
+        envRefs: ['VEESAN_ENGINE_URL', 'AIVISION_PORT', 'VEESAN_TENANT', 'VEESAN_SESSION_COOKIE', 'AIVISION_INTERNAL_TOKEN'],
+        envAnyOf: [['VEESAN_ENGINE_URL', 'AIVISION_PORT', 'AIVISION_SERVER_URL']],
+        readOnlyTools: AIVISION_READ_ONLY,
+        blockedArgs: { veesan_runs_report: ['saveTo'] },
+        argCaps: { veesan_runs_wait: { timeoutSec: 50 } },
+        toolNotes: {
+            veesan_runs_start: 'After it returns, call veesan_runs_wait with the run id.',
+            veesan_runs_wait: 'Waits at most 50 s per call; call it again while settled is false.',
+            veesan_runs_report: 'Returns the report inline; saveTo is not available here.',
+        },
+        promptHint: 'An AI-Vision connection is attached: its tools end in veesan_*. To run vision tests, find cases with veesan_tests_list, start a run with veesan_runs_start (it waits for approval), then call veesan_runs_wait with the run id until settled is true. Read verdicts and the failing step with veesan_runs_get and look at its screenshot with veesan_runs_evidence. Reading tools run directly; anything that starts, stops, or changes something waits for approval.',
+    },
+    {
+        id: 'midscene-web-bridge',
+        name: 'Midscene MCP (web bridge)',
+        description: 'The open-source Midscene MCP server for web automation in bridge mode. It drives your Chrome through the Midscene extension, so the extension must be open in bridge mode.',
+        transport: 'stdio',
+        command: 'npx',
+        args: ['-y', '@midscene/web-bridge-mcp'],
+        params: [],
+        envRefs: ['MIDSCENE_MODEL_BASE_URL', 'MIDSCENE_MODEL_API_KEY', 'MIDSCENE_MODEL_NAME', 'MIDSCENE_MODEL_FAMILY'],
+        envAnyOf: [['MIDSCENE_MODEL_API_KEY'], ['MIDSCENE_MODEL_NAME']],
+        // The server's own readOnlyHint decides; every other tool drives the browser and goes through the rules.
+        readOnlyTools: [],
+        promptHint: 'A Midscene connection is attached: its tools drive a real Chrome tab from natural-language steps. Every tool that acts on the page waits for approval, so group the steps you need before you call them.',
+    },
+    {
+        id: KATALON_PRESET_ID,
+        name: 'Katalon True Platform',
+        description: 'The Katalon MCP server over HTTP: the dot reads the test cases, requirements, and executions of your True Platform workspace. You enter the server URL; no secret is stored here.',
+        transport: 'http',
+        urlParam: 'url',
+        headersEnv: 'KATALON_MCP_HEADERS',
+        params: [
+            {
+                key: 'url',
+                label: 'Server URL',
+                hint: 'The https address of the Katalon MCP server. If it needs a token, put the request headers as JSON in the KATALON_MCP_HEADERS env var of this server.',
+                placeholder: 'https://mcp.example.com/mcp',
+                kind: 'url',
+            },
+        ],
+        envRefs: [],
+        envAnyOf: [],
+        // The server's own readOnlyHint decides; a tool that creates or changes a test case goes through the mcp_tool rule (ask).
+        readOnlyTools: [],
+        promptHint: 'A Katalon True Platform connection is attached: its tools work on the test cases, requirements, and executions of the team workspace. Tools that only read run directly; anything that creates or changes a test case waits for approval.',
+    },
+];
+export function getPreset(id) {
+    return id ? PRESETS.find((p) => p.id === id) : undefined;
+}
+/** Preset of a stored connection, or undefined for a hand-made one. */
+export function presetOf(conn) {
+    return getPreset(conn?.preset);
+}
+/** API view: env var names with a set/unset flag only. */
+export function presetView(p) {
+    return {
+        id: p.id,
+        name: p.name,
+        description: p.description,
+        transport: p.transport,
+        ...(p.command ? { command: p.command } : {}),
+        ...(p.args ? { args: p.args } : {}),
+        params: p.params.map(({ defaultEnv, ...rest }) => {
+            const value = defaultEnv ? setting(defaultEnv)?.trim() : undefined;
+            return value ? { ...rest, defaultValue: value } : rest;
+        }),
+        // envAnyOf can name a Setup value (AIVISION_SERVER_URL) that is not passed on by name.
+        env: [...new Set([...p.envRefs, ...(p.envAnyOf ?? []).flat()])].map((name) => ({ name, set: Boolean(setting(name)) })),
+        envAnyOf: p.envAnyOf ?? [],
+        readOnlyTools: p.readOnlyTools,
+    };
+}
+export function listPresets() {
+    return PRESETS.map(presetView);
+}
+/** Builds a connection from a preset and the user's params. Returns an error message for bad params. */
+export function connectionFromPreset(id, params = {}, name) {
+    const p = getPreset(id);
+    if (!p)
+        return { error: `unknown preset ${id}` };
+    const values = {};
+    for (const param of p.params) {
+        const raw = params[param.key];
+        let v = typeof raw === 'string' && raw.trim() ? raw.trim() : param.defaultEnv ? setting(param.defaultEnv)?.trim() : undefined;
+        if (!v)
+            return { error: `${param.label} is required` };
+        if (param.kind === 'path') {
+            if (!isAbsolute(v))
+                return { error: `${param.label} must be an absolute path` };
+            v = normalize(v).replace(/\/+$/, '');
+            if (param.mustContain && !existsSync(join(v, param.mustContain)))
+                return { error: `${param.label}: ${param.mustContain} was not found under ${v}` };
+        }
+        if (param.kind === 'url') {
+            let u;
+            try {
+                u = new URL(v);
+            }
+            catch {
+                u = undefined;
+            }
+            if (!u || !['http:', 'https:'].includes(u.protocol))
+                return { error: `${param.label} must be an http or https URL` };
+            if (u.username || u.password)
+                return { error: `${param.label} must not hold a user name or password. Put request headers in an env var instead.` };
+            v = u.href;
+        }
+        values[param.key] = v;
+    }
+    const display = typeof name === 'string' && name.trim() ? name.trim().slice(0, 60) : p.name;
+    if (p.transport === 'http') {
+        const url = values[p.urlParam ?? 'url'];
+        if (!url)
+            return { error: 'The server URL is required' };
+        const headers = p.headersEnv && setting(p.headersEnv)?.trim() ? { headersSecretRef: p.headersEnv } : {};
+        return { input: { name: display, transport: 'http', url, ...headers, enabled: true, preset: p.id, envRefs: [...p.envRefs] } };
+    }
+    const args = (p.args ?? []).map((a) => a.replace(/\{(\w+)\}/g, (_, k) => values[k] ?? ''));
+    return {
+        input: { name: display, transport: p.transport, command: p.command, args, enabled: true, preset: p.id, envRefs: [...p.envRefs] },
+    };
+}
+/** Env vars a preset connection passes to its stdio server. Unset names are skipped. */
+export function passthroughEnv(conn) {
+    if (conn.transport !== 'stdio')
+        return undefined;
+    // Only names the preset declares: a stored row cannot widen what leaves this process.
+    const allowed = new Set(presetOf(conn)?.envRefs ?? []);
+    const out = {};
+    for (const name of conn.envRefs ?? []) {
+        const v = setting(name);
+        if (allowed.has(name) && name !== TOKEN_KEY && v !== undefined && v !== '')
+            out[name] = v;
+    }
+    // The AI-Vision server connected on the Setup page, when no engine URL is set by name.
+    if (allowed.has('VEESAN_ENGINE_URL') && !out.VEESAN_ENGINE_URL && !out.AIVISION_PORT) {
+        const url = setting('AIVISION_SERVER_URL');
+        if (url)
+            out.VEESAN_ENGINE_URL = url;
+    }
+    // The access token goes through the one gate, for the engine the MCP server talks to (its own
+    // default is 127.0.0.1 on AIVISION_PORT or 5880).
+    if (allowed.has(TOKEN_KEY) && (conn.envRefs ?? []).includes(TOKEN_KEY)) {
+        const engine = out.VEESAN_ENGINE_URL || `http://127.0.0.1:${out.AIVISION_PORT || DEFAULT_PORT}`;
+        const token = aivisionTokenFor(engine);
+        if (token)
+            out[TOKEN_KEY] = token;
+    }
+    return Object.keys(out).length ? out : undefined;
+}
+/** True when the preset marks this tool read-only. Adds to the server's own readOnlyHint, never removes it. */
+export function presetReadOnly(conn, toolName) {
+    return presetOf(conn)?.readOnlyTools.includes(toolName) ?? false;
+}
+/**
+ * Applies a preset's argument rules before a call. Returns the args to send,
+ * or an error when the call uses an argument the preset blocks.
+ */
+export function prepareArgs(conn, toolName, args) {
+    const p = presetOf(conn);
+    if (!p)
+        return { args };
+    const blocked = (p.blockedArgs?.[toolName] ?? []).filter((k) => args[k] !== undefined);
+    if (blocked.length)
+        return { args, error: `${toolName}: ${blocked.join(', ')} is not available through localdost. Call it without ${blocked.join(', ')}.` };
+    const caps = p.argCaps?.[toolName];
+    if (!caps)
+        return { args };
+    const out = { ...args };
+    for (const [k, max] of Object.entries(caps)) {
+        const n = Number(out[k]);
+        out[k] = Number.isFinite(n) && n > 0 ? Math.min(n, max) : max;
+    }
+    return { args: out };
+}
+export function toolNote(conn, toolName) {
+    return presetOf(conn)?.toolNotes?.[toolName] ?? '';
+}
+/**
+ * Context lines for the dot's chat and flows: one paragraph per preset that has a connected,
+ * enabled connection attached to the dot. Empty when none.
+ */
+export function presetHintsForWatch(watch) {
+    const seen = new Set();
+    const hints = [];
+    for (const id of watch.connections ?? []) {
+        const c = getConnection(id);
+        const p = c && c.enabled && c.status === 'connected' ? presetOf(c) : undefined;
+        if (!p || seen.has(p.id))
+            continue;
+        seen.add(p.id);
+        hints.push(p.promptHint);
+    }
+    return hints.join('\n');
+}
+//# sourceMappingURL=presets.js.map

package/dist/connections/presets.js.map

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

package/dist/connections/store.js

@@ -0,0 +1,132 @@
+// Connection store. One row per MCP server in the `connections` table.
+// Secrets never land here: headersSecretRef names an env var that is read at call time.
+import { db, get, insert, list, newId, remove, update } from '../db.js';
+import { publish } from '../events.js';
+const TABLE = 'connections';
+let useHelpers;
+/**
+ * Creates the table when core has not declared it. The layout matches what the db helpers
+ * create (id, createdAt, extra JSON), so rows stay readable if core adds the table to its schema later.
+ */
+export function initConnectionStore() {
+    db.exec(`CREATE TABLE IF NOT EXISTS ${TABLE} (id TEXT PRIMARY KEY, createdAt TEXT NOT NULL, extra TEXT)`);
+    try {
+        // update() resolves the table schema first, so it throws when core has not declared the table. No row matches the id.
+        update(TABLE, '__schema_probe__', { probe: 1 });
+        useHelpers = true;
+    }
+    catch {
+        useHelpers = false;
+    }
+}
+function helpers() {
+    if (useHelpers === undefined)
+        initConnectionStore();
+    return useHelpers === true;
+}
+function parseRow(row) {
+    if (!row)
+        return undefined;
+    let extra = {};
+    try {
+        extra = row.extra ? JSON.parse(row.extra) : {};
+    }
+    catch {
+        extra = {};
+    }
+    return { ...extra, id: row.id, createdAt: row.createdAt };
+}
+/** Drops nulls the store uses to clear optional fields, and fills defaults for older rows. */
+function clean(c) {
+    if (!c)
+        return undefined;
+    const out = { ...c };
+    for (const [k, v] of Object.entries(out))
+        if (v === null)
+            delete out[k];
+    const conn = out;
+    conn.tools = Array.isArray(conn.tools) ? conn.tools : [];
+    conn.enabled = conn.enabled !== false;
+    conn.status = conn.enabled ? (conn.status ?? 'error') : 'disabled';
+    return conn;
+}
+export function getConnection(id) {
+    if (helpers())
+        return clean(get(TABLE, id));
+    const row = db.prepare(`SELECT id, createdAt, extra FROM ${TABLE} WHERE id = ?`).get(id);
+    return clean(parseRow(row));
+}
+export function listConnections() {
+    if (helpers())
+        return list(TABLE).map((c) => clean(c));
+    const rows = db.prepare(`SELECT id, createdAt, extra FROM ${TABLE} ORDER BY id ASC`).all();
+    return rows.map((r) => clean(parseRow(r)));
+}
+export function createConnection(input) {
+    const row = {
+        ...input,
+        tools: input.tools ?? [],
+        status: input.enabled === false ? 'disabled' : (input.status ?? 'error'),
+        updatedAt: new Date().toISOString(),
+    };
+    if (row.status === 'error' && !row.error)
+        row.error = 'Not connected yet. Refresh to list tools.';
+    let id;
+    if (helpers())
+        id = insert(TABLE, row).id;
+    else {
+        id = newId();
+        db.prepare(`INSERT INTO ${TABLE} (id, createdAt, extra) VALUES (?, ?, ?)`).run(id, new Date().toISOString(), JSON.stringify(row));
+    }
+    const conn = getConnection(id);
+    announce(conn);
+    return conn;
+}
+/** Merges a patch. A null value clears an optional field. */
+export function updateConnection(id, patch) {
+    const cur = getConnection(id);
+    if (!cur)
+        return undefined;
+    const p = { ...patch, updatedAt: new Date().toISOString() };
+    delete p.id;
+    delete p.createdAt;
+    if (helpers())
+        update(TABLE, id, p);
+    else {
+        const row = db.prepare(`SELECT extra FROM ${TABLE} WHERE id = ?`).get(id);
+        let merged = {};
+        try {
+            merged = row?.extra ? JSON.parse(row.extra) : {};
+        }
+        catch {
+            merged = {};
+        }
+        Object.assign(merged, p);
+        db.prepare(`UPDATE ${TABLE} SET extra = ? WHERE id = ?`).run(JSON.stringify(merged), id);
+    }
+    const conn = getConnection(id);
+    announce(conn);
+    return conn;
+}
+export function deleteConnection(id) {
+    if (helpers())
+        return remove(TABLE, id);
+    const res = db.prepare(`DELETE FROM ${TABLE} WHERE id = ?`).run(id);
+    return Number(res.changes) > 0;
+}
+/** API view: no input schemas (they can be large), plus whether the referenced env var is set. */
+export function publicView(c) {
+    const view = {
+        ...c,
+        tools: c.tools.map(({ name, description, readOnly, enabled }) => ({ name, description, readOnly, enabled })),
+    };
+    if (c.headersSecretRef)
+        view.headersSecretSet = Boolean(process.env[c.headersSecretRef]);
+    return view;
+}
+export function announce(c) {
+    const e = { type: 'connection', connection: publicView(c) };
+    publish(e);
+}
+initConnectionStore();
+//# sourceMappingURL=store.js.map