@creativeintelligence/abbie 0.1.0

package/dist/lib/config-sync/adapters/codex.js

@@ -0,0 +1,117 @@
+/**
+ * Codex config adapter.
+ *
+ * Config: ~/.codex/config.toml
+ * Format: [mcp_servers.name] with command/args or url keys.
+ *
+ * Managed entries use [mcp_servers.abbie-{name}] sections.
+ *
+ * Uses a simple line-based TOML merge to avoid needing a full TOML
+ * parser as a dependency. Reads TOML with regex, writes TOML sections
+ * as string blocks.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+const MCP_SECTION_RE = /^\[mcp_servers\.([^\]]+)\]/;
+export class CodexConfigAdapter {
+    agent = "codex";
+    configPath() {
+        return join(homedir(), ".codex", "config.toml");
+    }
+    configExists() {
+        return existsSync(this.configPath());
+    }
+    read() {
+        if (!this.configExists())
+            return {};
+        try {
+            const content = readFileSync(this.configPath(), "utf-8");
+            return { _raw: content };
+        }
+        catch {
+            return {};
+        }
+    }
+    merge(current, managed, previousManagedKeys) {
+        const raw = current._raw ?? "";
+        const lines = raw.split("\n");
+        // Parse into: non-mcp lines, user mcp sections, managed mcp sections
+        const nonMcpLines = [];
+        const userMcpSections = [];
+        const managedKeySet = new Set([
+            ...previousManagedKeys,
+            ...managed.map((e) => e.key),
+        ]);
+        let currentSection = null;
+        for (const line of lines) {
+            const match = MCP_SECTION_RE.exec(line);
+            if (match) {
+                // Flush previous section
+                if (currentSection) {
+                    if (managedKeySet.has(currentSection.name)) {
+                        // Drop — will be regenerated
+                    }
+                    else {
+                        userMcpSections.push(currentSection.lines.join("\n"));
+                    }
+                }
+                currentSection = { name: match[1], lines: [line] };
+            }
+            else if (currentSection) {
+                // Check if this line starts a new top-level section (not mcp_servers)
+                if (/^\[(?!mcp_servers\.)/.test(line)) {
+                    // Flush current section
+                    if (!managedKeySet.has(currentSection.name)) {
+                        userMcpSections.push(currentSection.lines.join("\n"));
+                    }
+                    currentSection = null;
+                    nonMcpLines.push(line);
+                }
+                else {
+                    currentSection.lines.push(line);
+                }
+            }
+            else {
+                nonMcpLines.push(line);
+            }
+        }
+        // Flush last section
+        if (currentSection && !managedKeySet.has(currentSection.name)) {
+            userMcpSections.push(currentSection.lines.join("\n"));
+        }
+        // Generate managed sections
+        const managedSections = managed.map((entry) => this.toTomlSection(entry));
+        // Reassemble: non-mcp lines, then user mcp sections, then managed sections
+        const parts = [
+            nonMcpLines.join("\n").replace(/\n{3,}/g, "\n\n").trim(),
+            ...userMcpSections,
+            ...managedSections,
+        ].filter(Boolean);
+        return { _raw: parts.join("\n\n") + "\n" };
+    }
+    serialize(config) {
+        return config._raw ?? "";
+    }
+    toTomlSection(entry) {
+        const lines = [`[mcp_servers.${entry.key}]`];
+        if (entry.transport === "stdio" && entry.command) {
+            lines.push(`command = ${toTomlString(entry.command)}`);
+            if (entry.commandArgs?.length) {
+                const args = entry.commandArgs.map(toTomlString).join(", ");
+                lines.push(`args = [${args}]`);
+            }
+        }
+        else if (entry.serverUrl) {
+            lines.push(`url = ${toTomlString(entry.serverUrl)}`);
+        }
+        if (entry.apiKey) {
+            lines.push(`api_key = ${toTomlString(entry.apiKey)}`);
+        }
+        return lines.join("\n");
+    }
+}
+function toTomlString(value) {
+    // Escape backslashes and quotes for TOML basic strings
+    return `"${value.replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}

package/dist/lib/config-sync/adapters/copilot.d.ts

@@ -0,0 +1,37 @@
+/**
+ * GitHub Copilot CLI config adapter.
+ *
+ * Config: ~/.copilot/mcp-config.json
+ * Format: { mcpServers: { "name": { type, command, args } | { type, url } } }
+ *
+ * Managed entries use "abbie-{name}" keys.
+ */
+import type { ConfigAdapter, ManagedEntry } from "../types.js";
+type CopilotMcpEntry = {
+    type: "stdio";
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+} | {
+    type: "sse";
+    url: string;
+} | {
+    type: "http";
+    url: string;
+    tools?: string[];
+};
+type CopilotMcpConfig = {
+    mcpServers?: Record<string, CopilotMcpEntry>;
+    [key: string]: unknown;
+};
+export declare class CopilotConfigAdapter implements ConfigAdapter {
+    readonly agent: "copilot";
+    configPath(): string;
+    configExists(): boolean;
+    read(): CopilotMcpConfig;
+    merge(current: Record<string, unknown>, managed: ManagedEntry[], previousManagedKeys: string[]): CopilotMcpConfig;
+    serialize(config: Record<string, unknown>): string;
+    private toCopilotEntry;
+}
+export {};
+//# sourceMappingURL=copilot.d.ts.map

package/dist/lib/config-sync/adapters/copilot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copilot.d.ts","sourceRoot":"","sources":["../../../../src/lib/config-sync/adapters/copilot.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,KAAK,eAAe,GAChB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GACjF;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAEpD,KAAK,gBAAgB,GAAG;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAC7C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,qBAAa,oBAAqB,YAAW,aAAa;IACxD,QAAQ,CAAC,KAAK,EAAG,SAAS,CAAU;IAEpC,UAAU,IAAI,MAAM;IAIpB,YAAY,IAAI,OAAO;IAIvB,IAAI,IAAI,gBAAgB;IASxB,KAAK,CACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,YAAY,EAAE,EACvB,mBAAmB,EAAE,MAAM,EAAE,GAC5B,gBAAgB;IAiBnB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAIlD,OAAO,CAAC,cAAc;CA4BvB"}

package/dist/lib/config-sync/adapters/copilot.js

@@ -0,0 +1,72 @@
+/**
+ * GitHub Copilot CLI config adapter.
+ *
+ * Config: ~/.copilot/mcp-config.json
+ * Format: { mcpServers: { "name": { type, command, args } | { type, url } } }
+ *
+ * Managed entries use "abbie-{name}" keys.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+export class CopilotConfigAdapter {
+    agent = "copilot";
+    configPath() {
+        return join(homedir(), ".copilot", "mcp-config.json");
+    }
+    configExists() {
+        return existsSync(this.configPath());
+    }
+    read() {
+        if (!this.configExists())
+            return {};
+        try {
+            return JSON.parse(readFileSync(this.configPath(), "utf-8"));
+        }
+        catch {
+            return {};
+        }
+    }
+    merge(current, managed, previousManagedKeys) {
+        const config = current;
+        const servers = { ...(config.mcpServers ?? {}) };
+        // Remove previously managed keys
+        for (const key of previousManagedKeys) {
+            delete servers[key];
+        }
+        // Add/update managed entries
+        for (const entry of managed) {
+            servers[entry.key] = this.toCopilotEntry(entry);
+        }
+        return { ...config, mcpServers: servers };
+    }
+    serialize(config) {
+        return JSON.stringify(config, null, 2) + "\n";
+    }
+    toCopilotEntry(entry) {
+        if (entry.transport === "stdio" && entry.command) {
+            const result = {
+                type: "stdio",
+                command: entry.command,
+            };
+            if (entry.commandArgs?.length) {
+                result.args = entry.commandArgs;
+            }
+            if (entry.apiKey) {
+                result.env = {
+                    API_KEY: entry.apiKey,
+                };
+            }
+            return result;
+        }
+        if (entry.transport === "sse" && entry.serverUrl) {
+            return { type: "sse", url: entry.serverUrl };
+        }
+        // Default: http
+        return {
+            type: "http",
+            url: entry.serverUrl ?? "",
+            tools: ["*"],
+        };
+    }
+}

package/dist/lib/config-sync/adapters/gemini.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Gemini CLI config adapter.
+ *
+ * Config: ~/.gemini/settings.json
+ * Format: { mcpServers: { "name": { ... } } } inside top-level settings
+ *
+ * Gemini only supports http transport. stdio/sse connections are skipped.
+ * Managed entries use "abbie-{name}" keys.
+ */
+import type { ConfigAdapter, ManagedEntry } from "../types.js";
+type GeminiMcpEntry = {
+    httpUrl: string;
+    timeout?: number;
+};
+type GeminiSettings = {
+    mcpServers?: Record<string, GeminiMcpEntry>;
+    [key: string]: unknown;
+};
+export declare class GeminiConfigAdapter implements ConfigAdapter {
+    readonly agent: "gemini";
+    configPath(): string;
+    configExists(): boolean;
+    read(): GeminiSettings;
+    merge(current: Record<string, unknown>, managed: ManagedEntry[], previousManagedKeys: string[]): GeminiSettings;
+    serialize(config: Record<string, unknown>): string;
+    private toGeminiEntry;
+}
+export {};
+//# sourceMappingURL=gemini.d.ts.map

package/dist/lib/config-sync/adapters/gemini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../../../../src/lib/config-sync/adapters/gemini.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,KAAK,cAAc,GAAG;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC5C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB,CAAC;AAEF,qBAAa,mBAAoB,YAAW,aAAa;IACvD,QAAQ,CAAC,KAAK,EAAG,QAAQ,CAAU;IAEnC,UAAU,IAAI,MAAM;IAIpB,YAAY,IAAI,OAAO;IAIvB,IAAI,IAAI,cAAc;IAStB,KAAK,CACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,YAAY,EAAE,EACvB,mBAAmB,EAAE,MAAM,EAAE,GAC5B,cAAc;IAoBjB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAIlD,OAAO,CAAC,aAAa;CAYtB"}

package/dist/lib/config-sync/adapters/gemini.js

@@ -0,0 +1,62 @@
+/**
+ * Gemini CLI config adapter.
+ *
+ * Config: ~/.gemini/settings.json
+ * Format: { mcpServers: { "name": { ... } } } inside top-level settings
+ *
+ * Gemini only supports http transport. stdio/sse connections are skipped.
+ * Managed entries use "abbie-{name}" keys.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+export class GeminiConfigAdapter {
+    agent = "gemini";
+    configPath() {
+        return join(homedir(), ".gemini", "settings.json");
+    }
+    configExists() {
+        return existsSync(this.configPath());
+    }
+    read() {
+        if (!this.configExists())
+            return {};
+        try {
+            return JSON.parse(readFileSync(this.configPath(), "utf-8"));
+        }
+        catch {
+            return {};
+        }
+    }
+    merge(current, managed, previousManagedKeys) {
+        const config = current;
+        const servers = { ...(config.mcpServers ?? {}) };
+        // Remove previously managed keys
+        for (const key of previousManagedKeys) {
+            delete servers[key];
+        }
+        // Add only http-compatible entries (Gemini doesn't support stdio/sse)
+        for (const entry of managed) {
+            const geminiEntry = this.toGeminiEntry(entry);
+            if (geminiEntry) {
+                servers[entry.key] = geminiEntry;
+            }
+        }
+        return { ...config, mcpServers: servers };
+    }
+    serialize(config) {
+        return JSON.stringify(config, null, 2) + "\n";
+    }
+    toGeminiEntry(entry) {
+        // Gemini only supports http transport
+        if (entry.transport === "http" && entry.serverUrl) {
+            return { httpUrl: entry.serverUrl };
+        }
+        // SSE can often be used as http — try it
+        if (entry.transport === "sse" && entry.serverUrl) {
+            return { httpUrl: entry.serverUrl };
+        }
+        // Skip stdio — Gemini doesn't support it
+        return null;
+    }
+}

package/dist/lib/config-sync/adapters/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Config adapter registry.
+ */
+import type { ConfigAdapter, ConfigSyncAgent } from "../types.js";
+/** Get adapter for a specific agent */
+export declare function getAdapter(agent: ConfigSyncAgent): ConfigAdapter | undefined;
+/** Get all adapters */
+export declare function getAllAdapters(): ConfigAdapter[];
+/** Get adapters that have config files present */
+export declare function getActiveAdapters(): ConfigAdapter[];
+export { ClaudeConfigAdapter } from "./claude.js";
+export { CodexConfigAdapter } from "./codex.js";
+export { CopilotConfigAdapter } from "./copilot.js";
+export { GeminiConfigAdapter } from "./gemini.js";
+export { OpencodeConfigAdapter } from "./opencode.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/config-sync/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/config-sync/adapters/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAelE,uCAAuC;AACvC,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,aAAa,GAAG,SAAS,CAE5E;AAED,uBAAuB;AACvB,wBAAgB,cAAc,IAAI,aAAa,EAAE,CAEhD;AAED,kDAAkD;AAClD,wBAAgB,iBAAiB,IAAI,aAAa,EAAE,CAEnD;AAED,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC"}

package/dist/lib/config-sync/adapters/index.js

@@ -0,0 +1,32 @@
+/**
+ * Config adapter registry.
+ */
+import { ClaudeConfigAdapter } from "./claude.js";
+import { CodexConfigAdapter } from "./codex.js";
+import { CopilotConfigAdapter } from "./copilot.js";
+import { GeminiConfigAdapter } from "./gemini.js";
+import { OpencodeConfigAdapter } from "./opencode.js";
+const ADAPTERS = [
+    new ClaudeConfigAdapter(),
+    new CodexConfigAdapter(),
+    new CopilotConfigAdapter(),
+    new GeminiConfigAdapter(),
+    new OpencodeConfigAdapter(),
+];
+/** Get adapter for a specific agent */
+export function getAdapter(agent) {
+    return ADAPTERS.find((a) => a.agent === agent);
+}
+/** Get all adapters */
+export function getAllAdapters() {
+    return ADAPTERS;
+}
+/** Get adapters that have config files present */
+export function getActiveAdapters() {
+    return ADAPTERS.filter((a) => a.agent !== "opencode" ? true : a.configExists());
+}
+export { ClaudeConfigAdapter } from "./claude.js";
+export { CodexConfigAdapter } from "./codex.js";
+export { CopilotConfigAdapter } from "./copilot.js";
+export { GeminiConfigAdapter } from "./gemini.js";
+export { OpencodeConfigAdapter } from "./opencode.js";

package/dist/lib/config-sync/adapters/opencode.d.ts

@@ -0,0 +1,28 @@
+/**
+ * opencode config adapter.
+ *
+ * Unlike other agents, opencode uses CLI commands for MCP management:
+ *   opencode mcp add <name> --transport <type> --url <url>
+ *   opencode mcp remove <name>
+ *
+ * This adapter shells out to the CLI rather than writing config files.
+ * Read/merge/serialize are no-ops — sync is handled via applyChanges().
+ */
+import type { ConfigAdapter, ManagedEntry } from "../types.js";
+export declare class OpencodeConfigAdapter implements ConfigAdapter {
+    readonly agent: "opencode";
+    configPath(): string;
+    configExists(): boolean;
+    read(): Record<string, unknown>;
+    merge(_current: Record<string, unknown>, _managed: ManagedEntry[], _previousManagedKeys: string[]): Record<string, unknown>;
+    serialize(_config: Record<string, unknown>): string;
+    /**
+     * Apply changes via opencode CLI commands.
+     * Removes old managed keys, adds new ones.
+     */
+    applyChanges(managed: ManagedEntry[], previousManagedKeys: string[]): {
+        added: string[];
+        removed: string[];
+    };
+}
+//# sourceMappingURL=opencode.d.ts.map

package/dist/lib/config-sync/adapters/opencode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../../../src/lib/config-sync/adapters/opencode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,qBAAa,qBAAsB,YAAW,aAAa;IACzD,QAAQ,CAAC,KAAK,EAAG,UAAU,CAAU;IAErC,UAAU,IAAI,MAAM;IAIpB,YAAY,IAAI,OAAO;IASvB,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAK/B,KAAK,CACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,QAAQ,EAAE,YAAY,EAAE,EACxB,oBAAoB,EAAE,MAAM,EAAE,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAK1B,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM;IAInD;;;OAGG;IACH,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,mBAAmB,EAAE,MAAM,EAAE,GAAG;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE;CAyC7G"}

package/dist/lib/config-sync/adapters/opencode.js

@@ -0,0 +1,83 @@
+/**
+ * opencode config adapter.
+ *
+ * Unlike other agents, opencode uses CLI commands for MCP management:
+ *   opencode mcp add <name> --transport <type> --url <url>
+ *   opencode mcp remove <name>
+ *
+ * This adapter shells out to the CLI rather than writing config files.
+ * Read/merge/serialize are no-ops — sync is handled via applyChanges().
+ */
+import { execSync } from "node:child_process";
+export class OpencodeConfigAdapter {
+    agent = "opencode";
+    configPath() {
+        return "(cli-based)";
+    }
+    configExists() {
+        try {
+            execSync("which opencode", { stdio: "pipe" });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    read() {
+        // No file to read — state managed by opencode CLI
+        return {};
+    }
+    merge(_current, _managed, _previousManagedKeys) {
+        // No merge logic — handled by applyChanges
+        return {};
+    }
+    serialize(_config) {
+        return "";
+    }
+    /**
+     * Apply changes via opencode CLI commands.
+     * Removes old managed keys, adds new ones.
+     */
+    applyChanges(managed, previousManagedKeys) {
+        const added = [];
+        const removed = [];
+        // Remove old managed keys
+        const currentKeys = new Set(managed.map((e) => e.key));
+        for (const key of previousManagedKeys) {
+            if (!currentKeys.has(key)) {
+                try {
+                    execSync(`opencode mcp remove ${key}`, { stdio: "pipe", timeout: 10_000 });
+                    removed.push(key);
+                }
+                catch {
+                    // ignore — may already be removed
+                }
+            }
+        }
+        // Add/update current entries
+        for (const entry of managed) {
+            try {
+                // Remove first to ensure clean state
+                try {
+                    execSync(`opencode mcp remove ${entry.key}`, { stdio: "pipe", timeout: 10_000 });
+                }
+                catch {
+                    // ignore
+                }
+                const args = [`opencode mcp add ${entry.key}`];
+                if (entry.transport)
+                    args.push(`--transport ${entry.transport}`);
+                if (entry.serverUrl)
+                    args.push(`--url ${entry.serverUrl}`);
+                if (entry.command)
+                    args.push(`--command ${entry.command}`);
+                execSync(args.join(" "), { stdio: "pipe", timeout: 10_000 });
+                added.push(entry.key);
+            }
+            catch {
+                // Skip on failure — don't block other agents
+            }
+        }
+        return { added, removed };
+    }
+}

package/dist/lib/config-sync/index.d.ts

@@ -0,0 +1,74 @@
+/**
+ * ConfigSyncRunner — orchestrates Convex → local agent config sync.
+ *
+ * fetch snapshot → compare hash → per-agent merge → atomic write → update manifest
+ */
+import type { ConfigSyncAgent, ConfigSyncState, SidecarManifest, SyncTickResult } from "./types.js";
+type FetchSnapshotFn = () => Promise<{
+    connections: {
+        _id: string;
+        name: string;
+        transport?: string;
+        serverUrl?: string;
+        command?: string;
+        commandArgs?: string[];
+        apiKey?: string;
+        propagateTo?: string[];
+        disabledTools?: string[];
+    }[];
+    revision: number;
+    hash: string;
+}>;
+type DecryptFn = (value: string) => Promise<string>;
+export type ConfigSyncRunnerOptions = {
+    /** Function to fetch the snapshot from Convex */
+    fetchSnapshot: FetchSnapshotFn;
+    /** Function to decrypt enc_v1: values. If not provided, passes through. */
+    decrypt?: DecryptFn;
+    /** Filter to specific agents (default: all) */
+    agents?: ConfigSyncAgent[];
+};
+export declare class ConfigSyncRunner {
+    private fetchSnapshot;
+    private decryptFn;
+    private agentFilter?;
+    private state;
+    private manifest;
+    constructor(opts: ConfigSyncRunnerOptions);
+    /**
+     * Run one sync tick.
+     *
+     * @param opts.force - Skip hash comparison
+     * @param opts.dryRun - Don't write, just report what would change
+     * @param opts.snapshot - Pre-fetched snapshot (from subscription). Skips fetch if provided.
+     */
+    tick(opts?: {
+        force?: boolean;
+        dryRun?: boolean;
+        snapshot?: Awaited<ReturnType<FetchSnapshotFn>>;
+    }): Promise<SyncTickResult>;
+    /**
+     * Get current state (for status command).
+     */
+    getState(): ConfigSyncState;
+    /**
+     * Get current manifest (for status command).
+     */
+    getManifest(): SidecarManifest;
+    /**
+     * Build managed entries grouped by agent, respecting propagateTo.
+     */
+    private buildEntriesByAgent;
+    private get statePath();
+    private get manifestPath();
+    private loadState;
+    private saveState;
+    private loadManifest;
+    private saveManifest;
+    private recordFailure;
+    private isCircuitOpen;
+}
+export { getAdapter, getAllAdapters, getActiveAdapters } from "./adapters/index.js";
+export { writeConfigAtomic, createBackup, restoreBackup, getLatestBackup, getSyncDir, getBackupsDir } from "./writer.js";
+export type { ConfigAdapter, ConfigSyncAgent, ConfigSyncState, ManagedEntry, SidecarManifest, SyncTickResult, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/config-sync/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/config-sync/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EAGf,eAAe,EACf,cAAc,EACf,MAAM,YAAY,CAAC;AAapB,KAAK,eAAe,GAAG,MAAM,OAAO,CAAC;IACnC,WAAW,EAAE;QACX,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;QACvB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;KAC1B,EAAE,CAAC;IACJ,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC,CAAC;AAEH,KAAK,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEpD,MAAM,MAAM,uBAAuB,GAAG;IACpC,iDAAiD;IACjD,aAAa,EAAE,eAAe,CAAC;IAC/B,2EAA2E;IAC3E,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,eAAe,EAAE,CAAC;CAC5B,CAAC;AAEF,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,aAAa,CAAkB;IACvC,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,WAAW,CAAC,CAAoB;IACxC,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,QAAQ,CAAkB;gBAEtB,IAAI,EAAE,uBAAuB;IAQzC;;;;;;OAMG;IACG,IAAI,CAAC,IAAI,CAAC,EAAE;QAChB,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC;KACjD,GAAG,OAAO,CAAC,cAAc,CAAC;IAuL3B;;OAEG;IACH,QAAQ,IAAI,eAAe;IAI3B;;OAEG;IACH,WAAW,IAAI,eAAe;IAM9B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoC3B,OAAO,KAAK,SAAS,GAEpB;IAED,OAAO,KAAK,YAAY,GAEvB;IAED,OAAO,CAAC,SAAS;IAgBjB,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,YAAY;IAMpB,OAAO,CAAC,aAAa;IAWrB,OAAO,CAAC,aAAa;CAMtB;AAED,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACzH,YAAY,EACV,aAAa,EACb,eAAe,EACf,eAAe,EACf,YAAY,EACZ,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC"}