patchwork-os 0.2.0-alpha.0

package/dist/adapters/openai.d.ts

@@ -0,0 +1,22 @@
+import type { CompletionParams, CompletionResult, ModelAdapter, StreamChunk } from "./base.js";
+export declare class OpenAIAdapter implements ModelAdapter {
+    private readonly opts;
+    readonly name: string;
+    constructor(opts?: {
+        apiKey?: string;
+        baseURL?: string;
+        defaultModel?: string;
+        fetchImpl?: typeof fetch;
+        /** Override the adapter's public name; "local" uses this for Ollama. */
+        adapterName?: string;
+        /** Some local endpoints (Ollama) don't require a bearer token. */
+        requireApiKey?: boolean;
+    });
+    private getApiKey;
+    private translateTools;
+    private translateMessages;
+    complete(params: CompletionParams): Promise<CompletionResult>;
+    stream(params: CompletionParams): AsyncIterable<StreamChunk>;
+    supportsTools(): boolean;
+    supportsVision(): boolean;
+}

package/dist/adapters/openai.js

@@ -0,0 +1,284 @@
+import { parseSseStream } from "./sse.js";
+/**
+ * OpenAIAdapter — Chat Completions API via fetch. Compatible with any
+ * OpenAI-compatible endpoint (Ollama, LM Studio, vLLM, Together.ai, ...)
+ * by setting baseURL.
+ */
+const DEFAULT_MODEL = "gpt-4o";
+const DEFAULT_MAX_TOKENS = 4096;
+const API_URL = "https://api.openai.com/v1/chat/completions";
+export class OpenAIAdapter {
+    opts;
+    name;
+    constructor(opts = {}) {
+        this.opts = opts;
+        this.name = opts.adapterName ?? "openai";
+    }
+    getApiKey() {
+        const required = this.opts.requireApiKey ?? this.name === "openai";
+        const key = this.opts.apiKey ?? process.env.OPENAI_API_KEY;
+        if (required && !key) {
+            throw new Error(`${this.name}Adapter: no API key. Set OPENAI_API_KEY or config.apiKeys.openai.`);
+        }
+        return key;
+    }
+    translateTools(tools) {
+        if (!tools?.length)
+            return undefined;
+        return tools.map((t) => ({
+            type: "function",
+            function: {
+                name: t.name,
+                description: t.description,
+                parameters: t.inputSchema,
+            },
+        }));
+    }
+    translateMessages(params) {
+        const out = [];
+        if (params.systemPrompt) {
+            out.push({ role: "system", content: params.systemPrompt });
+        }
+        for (const m of params.messages) {
+            if (m.role === "tool") {
+                out.push({
+                    role: "tool",
+                    tool_call_id: m.toolCallId ?? "",
+                    content: m.content,
+                });
+            }
+            else if (m.role === "assistant" && m.toolCalls?.length) {
+                out.push({
+                    role: "assistant",
+                    content: m.content || null,
+                    tool_calls: m.toolCalls.map((tc) => ({
+                        id: tc.id,
+                        type: "function",
+                        function: {
+                            name: tc.name,
+                            arguments: JSON.stringify(tc.arguments),
+                        },
+                    })),
+                });
+            }
+            else {
+                out.push({ role: m.role, content: m.content });
+            }
+        }
+        return out;
+    }
+    async complete(params) {
+        const apiKey = this.getApiKey();
+        const body = {
+            model: params.model ?? this.opts.defaultModel ?? DEFAULT_MODEL,
+            messages: this.translateMessages(params),
+            tools: this.translateTools(params.tools),
+            max_tokens: params.maxTokens ?? DEFAULT_MAX_TOKENS,
+            temperature: params.temperature,
+        };
+        const headers = {
+            "content-type": "application/json",
+        };
+        if (apiKey)
+            headers.authorization = `Bearer ${apiKey}`;
+        const fetchImpl = this.opts.fetchImpl ?? fetch;
+        const res = await fetchImpl(this.opts.baseURL ?? API_URL, {
+            method: "POST",
+            headers,
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            const text = await res.text();
+            throw new Error(`${this.name}Adapter: API error ${res.status}: ${text.slice(0, 500)}`);
+        }
+        const data = (await res.json());
+        const choice = data.choices[0];
+        if (!choice)
+            throw new Error(`${this.name}Adapter: empty choices`);
+        const text = choice.message.content ?? "";
+        const toolCalls = (choice.message.tool_calls ?? []).map((tc) => ({
+            id: tc.id,
+            name: tc.function.name,
+            arguments: safeJsonParse(tc.function.arguments),
+        }));
+        const stopReason = choice.finish_reason === "tool_calls"
+            ? "tool_use"
+            : choice.finish_reason === "length"
+                ? "max_tokens"
+                : choice.finish_reason === "stop"
+                    ? "end_turn"
+                    : "error";
+        return {
+            text,
+            toolCalls,
+            stopReason,
+            usage: {
+                inputTokens: data.usage?.prompt_tokens ?? 0,
+                outputTokens: data.usage?.completion_tokens ?? 0,
+            },
+        };
+    }
+    async *stream(params) {
+        const apiKey = this.getApiKey();
+        const body = {
+            model: params.model ?? this.opts.defaultModel ?? DEFAULT_MODEL,
+            messages: this.translateMessages(params),
+            tools: this.translateTools(params.tools),
+            max_tokens: params.maxTokens ?? DEFAULT_MAX_TOKENS,
+            temperature: params.temperature,
+            stream: true,
+        };
+        const headers = {
+            "content-type": "application/json",
+            accept: "text/event-stream",
+        };
+        if (apiKey)
+            headers.authorization = `Bearer ${apiKey}`;
+        const fetchImpl = this.opts.fetchImpl ?? fetch;
+        let res;
+        try {
+            res = await fetchImpl(this.opts.baseURL ?? API_URL, {
+                method: "POST",
+                headers,
+                body: JSON.stringify(body),
+            });
+        }
+        catch (err) {
+            yield {
+                type: "error",
+                message: err instanceof Error ? err.message : String(err),
+            };
+            return;
+        }
+        if (!res.ok || !res.body) {
+            const text = await res.text().catch(() => "");
+            yield {
+                type: "error",
+                message: `${this.name}Adapter: API error ${res.status}: ${text.slice(0, 500)}`,
+            };
+            return;
+        }
+        const textParts = [];
+        // OpenAI streams tool_calls by index. Each delta adds partial function
+        // name/arguments JSON. Reassemble per-index.
+        const toolStates = new Map();
+        let finishReason;
+        let inputTokens = 0;
+        let outputTokens = 0;
+        try {
+            for await (const evt of parseSseStream(res.body)) {
+                if (!evt.data || evt.data === "[DONE]")
+                    continue;
+                let parsed;
+                try {
+                    parsed = JSON.parse(evt.data);
+                }
+                catch {
+                    continue;
+                }
+                if (parsed.usage) {
+                    inputTokens = parsed.usage.prompt_tokens ?? inputTokens;
+                    outputTokens = parsed.usage.completion_tokens ?? outputTokens;
+                }
+                const choice = parsed.choices?.[0];
+                if (!choice)
+                    continue;
+                if (choice.finish_reason)
+                    finishReason = choice.finish_reason;
+                const delta = choice.delta;
+                if (!delta)
+                    continue;
+                if (typeof delta.content === "string" && delta.content.length > 0) {
+                    textParts.push(delta.content);
+                    yield { type: "text", delta: delta.content };
+                }
+                for (const tc of delta.tool_calls ?? []) {
+                    const idx = tc.index ?? 0;
+                    let state = toolStates.get(idx);
+                    if (!state) {
+                        state = { id: "", name: "", argsJson: "", started: false };
+                        toolStates.set(idx, state);
+                    }
+                    if (tc.id)
+                        state.id = tc.id;
+                    if (tc.function?.name)
+                        state.name = tc.function.name;
+                    if (!state.started && state.id && state.name) {
+                        state.started = true;
+                        yield {
+                            type: "tool_call_start",
+                            id: state.id,
+                            name: state.name,
+                        };
+                    }
+                    const argsDelta = tc.function?.arguments ?? "";
+                    if (argsDelta) {
+                        state.argsJson += argsDelta;
+                        if (state.id) {
+                            yield {
+                                type: "tool_call_delta",
+                                id: state.id,
+                                argumentsDelta: argsDelta,
+                            };
+                        }
+                    }
+                }
+            }
+        }
+        catch (err) {
+            yield {
+                type: "error",
+                message: err instanceof Error ? err.message : String(err),
+            };
+            return;
+        }
+        for (const state of toolStates.values()) {
+            if (state.started)
+                yield { type: "tool_call_end", id: state.id };
+        }
+        const toolCalls = [...toolStates.values()]
+            .filter((s) => s.started)
+            .map((s) => ({
+            id: s.id,
+            name: s.name,
+            arguments: safeJsonParse(s.argsJson),
+        }));
+        const stopReason = finishReason === "tool_calls"
+            ? "tool_use"
+            : finishReason === "length"
+                ? "max_tokens"
+                : finishReason === "stop"
+                    ? "end_turn"
+                    : toolCalls.length > 0
+                        ? "tool_use"
+                        : "end_turn";
+        yield {
+            type: "done",
+            result: {
+                text: textParts.join(""),
+                toolCalls,
+                stopReason,
+                usage: { inputTokens, outputTokens },
+            },
+        };
+    }
+    // end stream
+    supportsTools() {
+        return true;
+    }
+    supportsVision() {
+        return true;
+    }
+}
+function safeJsonParse(s) {
+    if (!s)
+        return {};
+    try {
+        const parsed = JSON.parse(s);
+        return typeof parsed === "object" && parsed !== null ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=openai.js.map

package/dist/adapters/openai.js.map

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

package/dist/adapters/sse.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Minimal SSE parser — consumes a ReadableStream<Uint8Array> and yields
+ * parsed event objects. Handles the subset every mainstream LLM provider
+ * emits: `event: <name>\ndata: <json>\n\n`.
+ *
+ * Not a full RFC-compliant SSE parser (no last-event-id, no retry hint).
+ * Good enough for Anthropic, OpenAI, Gemini streaming endpoints.
+ */
+export interface SseEvent {
+    event?: string;
+    data: string;
+}
+export declare function parseSseStream(body: ReadableStream<Uint8Array>): AsyncIterable<SseEvent>;

package/dist/adapters/sse.js

@@ -0,0 +1,58 @@
+/**
+ * Minimal SSE parser — consumes a ReadableStream<Uint8Array> and yields
+ * parsed event objects. Handles the subset every mainstream LLM provider
+ * emits: `event: <name>\ndata: <json>\n\n`.
+ *
+ * Not a full RFC-compliant SSE parser (no last-event-id, no retry hint).
+ * Good enough for Anthropic, OpenAI, Gemini streaming endpoints.
+ */
+export async function* parseSseStream(body) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder("utf-8");
+    let buf = "";
+    try {
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buf += decoder.decode(value, { stream: true });
+            // Events are separated by blank lines (\n\n or \r\n\r\n).
+            const parts = buf.split(/\r?\n\r?\n/);
+            buf = parts.pop() ?? "";
+            for (const part of parts) {
+                const evt = parseEventBlock(part);
+                if (evt)
+                    yield evt;
+            }
+        }
+        const tail = buf.trim();
+        if (tail) {
+            const evt = parseEventBlock(tail);
+            if (evt)
+                yield evt;
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+}
+function parseEventBlock(block) {
+    let event;
+    const dataLines = [];
+    for (const rawLine of block.split(/\r?\n/)) {
+        const line = rawLine.trim();
+        if (!line || line.startsWith(":"))
+            continue;
+        const sep = line.indexOf(":");
+        const field = sep === -1 ? line : line.slice(0, sep);
+        const value = sep === -1 ? "" : line.slice(sep + 1).trimStart();
+        if (field === "event")
+            event = value;
+        else if (field === "data")
+            dataLines.push(value);
+    }
+    if (dataLines.length === 0)
+        return null;
+    return { event, data: dataLines.join("\n") };
+}
+//# sourceMappingURL=sse.js.map

package/dist/adapters/sse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse.js","sourceRoot":"","sources":["../../src/adapters/sse.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,cAAc,CACnC,IAAgC;IAEhC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAChC,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5C,IAAI,IAAI;gBAAE,MAAM;YAChB,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;YAC/C,0DAA0D;YAC1D,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;YACtC,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;YACxB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;gBAClC,IAAI,GAAG;oBAAE,MAAM,GAAG,CAAC;YACrB,CAAC;QACH,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACxB,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,GAAG,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;YAClC,IAAI,GAAG;gBAAE,MAAM,GAAG,CAAC;QACrB,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,WAAW,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,IAAI,KAAyB,CAAC;IAC9B,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,SAAS;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,KAAK,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACrD,MAAM,KAAK,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;QAChE,IAAI,KAAK,KAAK,OAAO;YAAE,KAAK,GAAG,KAAK,CAAC;aAChC,IAAI,KAAK,KAAK,MAAM;YAAE,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AAC/C,CAAC"}

package/dist/analyticsAggregator.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Aggregates ActivityLog data into an anonymized session summary for opt-in
+ * usage analytics. No file paths, arguments, error messages, or personal data.
+ *
+ * Plugin tool names are hashed (prefix only) to avoid leaking org-specific names.
+ * Built-in tool names are sent verbatim.
+ */
+export interface ToolStat {
+    tool: string;
+    calls: number;
+    errors: number;
+    p50Ms: number;
+    p95Ms: number;
+}
+export interface AnalyticsSummary {
+    bridgeVersion: string;
+    sessionDurationMs: number;
+    toolStats: ToolStat[];
+}
+/**
+ * Build an anonymized summary from raw tool call entries.
+ * Accepts the same shape as ActivityLog.stats() plus raw duration arrays.
+ */
+export declare function buildSummary(entries: Array<{
+    tool: string;
+    durationMs: number;
+    status: "success" | "error";
+}>, sessionDurationMs: number, bridgeVersion: string): AnalyticsSummary;

package/dist/analyticsAggregator.js

@@ -0,0 +1,133 @@
+/**
+ * Aggregates ActivityLog data into an anonymized session summary for opt-in
+ * usage analytics. No file paths, arguments, error messages, or personal data.
+ *
+ * Plugin tool names are hashed (prefix only) to avoid leaking org-specific names.
+ * Built-in tool names are sent verbatim.
+ */
+import crypto from "node:crypto";
+/** Known built-in tool names — sent verbatim. Anything else is treated as a plugin tool. */
+const BUILTIN_TOOL_NAMES = new Set([
+    "getOpenEditors",
+    "getCurrentSelection",
+    "getLatestSelection",
+    "getDiagnostics",
+    "watchDiagnostics",
+    "getDocumentSymbols",
+    "getHover",
+    "goToDefinition",
+    "findReferences",
+    "getCallHierarchy",
+    "searchWorkspaceSymbols",
+    "getCodeActions",
+    "applyCodeAction",
+    "renameSymbol",
+    "openFile",
+    "closeTab",
+    "checkDocumentDirty",
+    "saveDocument",
+    "captureScreenshot",
+    "getBridgeStatus",
+    "getToolCapabilities",
+    "executeVSCodeCommand",
+    "getDebugState",
+    "setDebugBreakpoints",
+    "startDebugging",
+    "stopDebugging",
+    "evaluateInDebugger",
+    "readFile",
+    "writeFile",
+    "createFile",
+    "deleteFile",
+    "moveFile",
+    "listDirectory",
+    "searchFiles",
+    "searchAndReplace",
+    "runCommand",
+    "getGitStatus",
+    "getGitDiff",
+    "gitCommit",
+    "gitCheckout",
+    "gitPush",
+    "gitPull",
+    "gitLog",
+    "gitWrite",
+    "sendHttpRequest",
+    "clipboardRead",
+    "clipboardWrite",
+    "getClipboard",
+    "setClipboard",
+    "openDiff",
+    "runClaudeTask",
+    "getClaudeTaskStatus",
+    "cancelClaudeTask",
+    "listClaudeTasks",
+    "resumeClaudeTask",
+    "getAIComments",
+    "createGithubIssueFromAIComment",
+    "switchWorkspace",
+    "getOrchestratorStatus",
+    "handoffNote",
+    "workspaceSettings",
+    "getHandoffNote",
+    "writeHandoffNote",
+    "logging",
+]);
+/** Returns the safe tool name to include in analytics. */
+function safeToolName(tool) {
+    if (BUILTIN_TOOL_NAMES.has(tool))
+        return tool;
+    // Plugin tool: extract prefix (everything before first underscore) and hash it
+    const prefix = tool.includes("_") ? (tool.split("_")[0] ?? tool) : tool;
+    const hash = crypto
+        .createHash("sha256")
+        .update(prefix)
+        .digest("hex")
+        .slice(0, 8);
+    return `plugin:${hash}`;
+}
+/** Compute p50 and p95 from a sorted array of durations. */
+function percentiles(sorted) {
+    if (sorted.length === 0)
+        return { p50: 0, p95: 0 };
+    const p50 = sorted[Math.floor(sorted.length * 0.5)] ?? 0;
+    const p95 = sorted[Math.floor(sorted.length * 0.95)] ?? 0;
+    return { p50, p95 };
+}
+/**
+ * Build an anonymized summary from raw tool call entries.
+ * Accepts the same shape as ActivityLog.stats() plus raw duration arrays.
+ */
+export function buildSummary(entries, sessionDurationMs, bridgeVersion) {
+    // Group by safe tool name
+    const map = new Map();
+    for (const entry of entries) {
+        const name = safeToolName(entry.tool);
+        const s = map.get(name) ?? { calls: 0, errors: 0, durations: [] };
+        s.calls++;
+        if (entry.status === "error")
+            s.errors++;
+        s.durations.push(entry.durationMs);
+        map.set(name, s);
+    }
+    const toolStats = [];
+    for (const [tool, s] of map) {
+        const sorted = [...s.durations].sort((a, b) => a - b);
+        const { p50, p95 } = percentiles(sorted);
+        toolStats.push({
+            tool,
+            calls: s.calls,
+            errors: s.errors,
+            p50Ms: Math.round(p50),
+            p95Ms: Math.round(p95),
+        });
+    }
+    // Sort by call count descending for readability
+    toolStats.sort((a, b) => b.calls - a.calls);
+    return {
+        bridgeVersion,
+        sessionDurationMs,
+        toolStats,
+    };
+}
+//# sourceMappingURL=analyticsAggregator.js.map

package/dist/analyticsAggregator.js.map

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

package/dist/analyticsPrefs.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Reads and writes the opt-in analytics preference.
+ * Stored in ~/.claude/ide/analytics.json (respects CLAUDE_CONFIG_DIR).
+ * File created with 0o600 permissions (owner read/write only).
+ */
+/** Returns the current opt-in state, or null if no preference has been set. */
+export declare function getAnalyticsPref(): boolean | null;
+/** Persists the opt-in preference. Creates file with 0o600 permissions. */
+export declare function setAnalyticsPref(enabled: boolean): void;

package/dist/analyticsPrefs.js

@@ -0,0 +1,50 @@
+/**
+ * Reads and writes the opt-in analytics preference.
+ * Stored in ~/.claude/ide/analytics.json (respects CLAUDE_CONFIG_DIR).
+ * File created with 0o600 permissions (owner read/write only).
+ */
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+function prefsPath() {
+    const claudeDir = process.env.CLAUDE_CONFIG_DIR ?? path.join(os.homedir(), ".claude");
+    return path.join(claudeDir, "ide", "analytics.json");
+}
+/** Returns the current opt-in state, or null if no preference has been set. */
+export function getAnalyticsPref() {
+    const p = prefsPath();
+    try {
+        const raw = fs.readFileSync(p, "utf-8");
+        const obj = JSON.parse(raw);
+        if (typeof obj === "object" &&
+            obj !== null &&
+            "enabled" in obj &&
+            typeof obj.enabled === "boolean") {
+            return obj.enabled;
+        }
+        return null;
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "ENOENT")
+            return null;
+        return null;
+    }
+}
+/** Persists the opt-in preference. Creates file with 0o600 permissions. */
+export function setAnalyticsPref(enabled) {
+    const p = prefsPath();
+    const dir = path.dirname(p);
+    fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
+    const content = {
+        enabled,
+        decidedAt: new Date().toISOString(),
+    };
+    // Write to temp file then rename for atomicity
+    const tmp = `${p}.tmp`;
+    fs.writeFileSync(tmp, `${JSON.stringify(content, null, 2)}\n`, {
+        mode: 0o600,
+    });
+    fs.renameSync(tmp, p);
+}
+//# sourceMappingURL=analyticsPrefs.js.map

package/dist/analyticsPrefs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyticsPrefs.js","sourceRoot":"","sources":["../src/analyticsPrefs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAO7B,SAAS,SAAS;IAChB,MAAM,SAAS,GACb,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC;AACvD,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,gBAAgB;IAC9B,MAAM,CAAC,GAAG,SAAS,EAAE,CAAC;IACtB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACxC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QACvC,IACE,OAAO,GAAG,KAAK,QAAQ;YACvB,GAAG,KAAK,IAAI;YACZ,SAAS,IAAI,GAAG;YAChB,OAAQ,GAAiB,CAAC,OAAO,KAAK,SAAS,EAC/C,CAAC;YACD,OAAQ,GAAiB,CAAC,OAAO,CAAC;QACpC,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;QACjD,IAAI,IAAI,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,gBAAgB,CAAC,OAAgB;IAC/C,MAAM,CAAC,GAAG,SAAS,EAAE,CAAC;IACtB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACpD,MAAM,OAAO,GAAc;QACzB,OAAO;QACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IACF,+CAA+C;IAC/C,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC;IACvB,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QAC7D,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;IACH,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AACxB,CAAC"}

package/dist/analyticsSend.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Sends an anonymized analytics summary to the usage endpoint.
+ * - Fire-and-forget is NOT used: callers must await this with a timeout race.
+ * - All errors are caught and swallowed — telemetry must never affect bridge operation.
+ * - Endpoint is hardcoded (not runtime-configurable) to prevent redirect attacks.
+ */
+import type { AnalyticsSummary } from "./analyticsAggregator.js";
+/**
+ * Sends the summary to the analytics endpoint.
+ * Resolves (never rejects) — all errors are swallowed silently.
+ */
+export declare function sendAnalytics(summary: AnalyticsSummary): Promise<void>;