@keel_flow/telemetry 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 jglasskatz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/emitter.d.ts

@@ -0,0 +1,23 @@
+import type { AgentEvent, TriggeredBy } from "@keel_flow/schema";
+export interface TelemetryEmitter {
+    emit(event: Omit<AgentEvent, "id" | "ts" | "workspaceId"> & {
+        workspaceId?: string | null;
+    }): void;
+    flush(): Promise<void>;
+    close(): Promise<void>;
+    droppedEvents(): number;
+    droppedLocalEvents(): number;
+    droppedForwardEvents(): number;
+}
+export interface CreateEmitterOptions {
+    sessionId: string;
+    workspaceId?: string | null;
+    triggeredBy?: TriggeredBy;
+    jsonlPath?: string;
+    batchSize?: number;
+    flushIntervalMs?: number;
+    onForward?: (batch: AgentEvent[]) => Promise<void>;
+    scrubSecrets?: boolean;
+}
+export declare function createEmitter(opts: CreateEmitterOptions): TelemetryEmitter;
+//# sourceMappingURL=emitter.d.ts.map

package/dist/emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emitter.d.ts","sourceRoot":"","sources":["../src/emitter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAGjE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,GAAG,IAAI,GAAG,aAAa,CAAC,GAAG;QAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACnG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,aAAa,IAAI,MAAM,CAAC;IACxB,kBAAkB,IAAI,MAAM,CAAC;IAC7B,oBAAoB,IAAI,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAKD,wBAAgB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,gBAAgB,CAmI1E"}

package/dist/emitter.js

@@ -0,0 +1,122 @@
+import { randomUUID } from "node:crypto";
+import { promises as fs } from "node:fs";
+import { dirname, join } from "node:path";
+import { scrubPayload } from "./scrub.js";
+const DEFAULT_BATCH_SIZE = 50;
+const DEFAULT_FLUSH_INTERVAL_MS = 1000;
+export function createEmitter(opts) {
+    const { sessionId, workspaceId = null, triggeredBy = { kind: "user" }, jsonlPath = join(".keel", "sessions", `${sessionId}.jsonl`), batchSize = DEFAULT_BATCH_SIZE, flushIntervalMs = DEFAULT_FLUSH_INTERVAL_MS, onForward, scrubSecrets = true, } = opts;
+    let buffer = [];
+    let dirEnsured = false;
+    let pending = Promise.resolve();
+    let closed = false;
+    let localLossCount = 0;
+    let forwardLossCount = 0;
+    let localLossReported = false;
+    let forwardLossReported = false;
+    function recordLocalLoss(count, err) {
+        localLossCount += count;
+        if (!localLossReported) {
+            localLossReported = true;
+            console.error(`[keel/telemetry] LOCAL LOSS: dropped ${count} event(s) (local write failed); traces consumed by reflect/learn are now incomplete. Cause:`, err);
+        }
+    }
+    function recordForwardLoss(count, err) {
+        forwardLossCount += count;
+        if (!forwardLossReported) {
+            forwardLossReported = true;
+            console.error(`[keel/telemetry] FORWARD LOSS: failed to forward ${count} event(s) after retry (events are durable in the local JSONL). Cause:`, err);
+        }
+    }
+    const timer = setInterval(() => {
+        if (buffer.length > 0) {
+            void flush();
+        }
+    }, flushIntervalMs);
+    if (typeof timer.unref === "function")
+        timer.unref();
+    async function ensureDir() {
+        if (dirEnsured)
+            return;
+        await fs.mkdir(dirname(jsonlPath), { recursive: true });
+        dirEnsured = true;
+    }
+    async function writeBatch(batch) {
+        if (batch.length === 0)
+            return;
+        try {
+            await ensureDir();
+            const lines = batch.map((e) => JSON.stringify(e)).join("\n") + "\n";
+            await fs.appendFile(jsonlPath, lines, "utf8");
+        }
+        catch (err) {
+            recordLocalLoss(batch.length, err);
+            return;
+        }
+        if (onForward) {
+            try {
+                await onForward(batch);
+            }
+            catch {
+                try {
+                    await onForward(batch);
+                }
+                catch (retryErr) {
+                    recordForwardLoss(batch.length, retryErr);
+                }
+            }
+        }
+    }
+    function flush() {
+        if (buffer.length === 0)
+            return pending;
+        const batch = buffer;
+        buffer = [];
+        pending = pending.then(() => writeBatch(batch));
+        return pending;
+    }
+    function emit(event) {
+        if (closed) {
+            console.warn("[keel/telemetry] emit() called on closed emitter; dropping event");
+            return;
+        }
+        try {
+            const full = {
+                ...event,
+                id: randomUUID(),
+                ts: new Date().toISOString(),
+                sessionId: event.sessionId || sessionId,
+                workspaceId: event.workspaceId === undefined ? workspaceId : event.workspaceId,
+                triggeredBy: event.triggeredBy ?? triggeredBy,
+                payload: scrubSecrets
+                    ? scrubPayload(event.payload)
+                    : event.payload,
+            };
+            buffer.push(full);
+            if (buffer.length >= batchSize) {
+                void flush();
+            }
+        }
+        catch (err) {
+            console.warn("[keel/telemetry] emit failed:", err);
+        }
+    }
+    async function close() {
+        closed = true;
+        clearInterval(timer);
+        await flush();
+        await pending;
+    }
+    return {
+        emit,
+        flush: async () => {
+            await flush();
+            await pending;
+        },
+        close,
+        droppedEvents: () => localLossCount + forwardLossCount,
+        droppedLocalEvents: () => localLossCount,
+        droppedForwardEvents: () => forwardLossCount,
+    };
+}
+//# sourceMappingURL=emitter.js.map

package/dist/emitter.js.map

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

package/dist/forwarder.d.ts

@@ -0,0 +1,8 @@
+import type { AgentEvent } from "@keel_flow/schema";
+export interface CreateApiForwarderOptions {
+    apiUrl: string;
+    workspaceId: string;
+    fetchFn?: typeof fetch;
+}
+export declare function createApiForwarder(opts: CreateApiForwarderOptions): (batch: AgentEvent[]) => Promise<void>;
+//# sourceMappingURL=forwarder.d.ts.map

package/dist/forwarder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"forwarder.d.ts","sourceRoot":"","sources":["../src/forwarder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,yBAAyB,GAC9B,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAkBxC"}

package/dist/forwarder.js

@@ -0,0 +1,19 @@
+export function createApiForwarder(opts) {
+    const fetchImpl = opts.fetchFn ?? fetch;
+    const base = opts.apiUrl.replace(/\/+$/, "");
+    const endpoint = `${base}/events.record`;
+    return async (batch) => {
+        if (batch.length === 0)
+            return;
+        const res = await fetchImpl(endpoint, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ workspaceId: opts.workspaceId, events: batch }),
+        });
+        if (!res.ok) {
+            const detail = await res.text().catch(() => "");
+            throw new Error(`keel/telemetry forwarder POST ${endpoint} failed: ${res.status} ${res.statusText} ${detail}`.trim());
+        }
+    };
+}
+//# sourceMappingURL=forwarder.js.map

package/dist/forwarder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forwarder.js","sourceRoot":"","sources":["../src/forwarder.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,kBAAkB,CAChC,IAA+B;IAE/B,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC;IACxC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,GAAG,IAAI,gBAAgB,CAAC;IACzC,OAAO,KAAK,EAAE,KAAmB,EAAiB,EAAE;QAClD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAC/B,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,QAAQ,EAAE;YACpC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;SACvE,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,MAAM,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAChD,MAAM,IAAI,KAAK,CACb,iCAAiC,QAAQ,YAAY,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,IAAI,MAAM,EAAE,CAAC,IAAI,EAAE,CACrG,CAAC;QACJ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+export { createEmitter } from "./emitter.js";
+export type { TelemetryEmitter, CreateEmitterOptions } from "./emitter.js";
+export { createApiForwarder } from "./forwarder.js";
+export type { CreateApiForwarderOptions } from "./forwarder.js";
+export { scrubPayload, scrubString } from "./scrub.js";
+export { AgentEventSchema, AgentEventKindSchema, TriggeredBySchema, } from "./types.js";
+export type { AgentEvent, AgentEventKind, TriggeredBy } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,YAAY,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACpD,YAAY,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { createEmitter } from "./emitter.js";
+export { createApiForwarder } from "./forwarder.js";
+export { scrubPayload, scrubString } from "./scrub.js";
+export { AgentEventSchema, AgentEventKindSchema, TriggeredBySchema, } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/scrub.d.ts

@@ -0,0 +1,3 @@
+export declare function scrubString(value: string): string;
+export declare function scrubPayload(value: unknown, keyHint?: string): unknown;
+//# sourceMappingURL=scrub.d.ts.map

package/dist/scrub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scrub.d.ts","sourceRoot":"","sources":["../src/scrub.ts"],"names":[],"mappings":"AA6CA,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASjD;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAmBtE"}

package/dist/scrub.js

@@ -0,0 +1,69 @@
+const SECRET_PATTERNS = [
+    /sk-ant-[A-Za-z0-9_-]{20,}/g,
+    /sk-proj-[A-Za-z0-9_-]{20,}/g,
+    /sk-[A-Za-z0-9]{20,}/g,
+    /ghp_[A-Za-z0-9]{36,}/g,
+    /github_pat_[A-Za-z0-9_]{50,}/g,
+    /AKIA[0-9A-Z]{16}/g,
+    /pa-[A-Za-z0-9_-]{20,}/g,
+];
+const JWT_PATTERN = /\beyJ[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}\b/g;
+const CONNECTION_STRING_PASSWORD = /(\b[a-z][a-z0-9+.-]*:\/\/[^\s:/@]+:)([^\s/@]+)(@)/gi;
+const HIGH_ENTROPY_TOKEN = /[A-Za-z0-9_-]{32,}/g;
+const UUID_SHAPE = /^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$/;
+const SENSITIVE_KEY = /(authorization|api[_-]?key|token|secret|password|passwd|cookie|credential|private[_-]?key)/i;
+const REDACTED = "[REDACTED]";
+function shannonEntropy(token) {
+    const counts = new Map();
+    for (const ch of token)
+        counts.set(ch, (counts.get(ch) ?? 0) + 1);
+    let entropy = 0;
+    for (const count of counts.values()) {
+        const p = count / token.length;
+        entropy -= p * Math.log2(p);
+    }
+    return entropy;
+}
+function isLikelySecretToken(token) {
+    if (UUID_SHAPE.test(token))
+        return false;
+    const hasLower = /[a-z]/.test(token);
+    const hasUpper = /[A-Z]/.test(token);
+    const hasDigit = /[0-9]/.test(token);
+    const hasSymbol = /[_-]/.test(token);
+    const classes = [hasLower, hasUpper, hasDigit, hasSymbol].filter(Boolean).length;
+    if (classes < 3)
+        return false;
+    return shannonEntropy(token) >= 3.5;
+}
+export function scrubString(value) {
+    let out = value;
+    for (const pattern of SECRET_PATTERNS) {
+        out = out.replace(pattern, REDACTED);
+    }
+    out = out.replace(JWT_PATTERN, REDACTED);
+    out = out.replace(CONNECTION_STRING_PASSWORD, (_m, prefix, _pw, at) => `${prefix}${REDACTED}${at}`);
+    out = out.replace(HIGH_ENTROPY_TOKEN, (match) => (isLikelySecretToken(match) ? REDACTED : match));
+    return out;
+}
+export function scrubPayload(value, keyHint) {
+    const isSensitiveKey = keyHint !== undefined && SENSITIVE_KEY.test(keyHint);
+    if (typeof value === "string") {
+        if (isSensitiveKey) {
+            return REDACTED;
+        }
+        return scrubString(value);
+    }
+    if (Array.isArray(value)) {
+        return value.map((element) => scrubPayload(element, keyHint));
+    }
+    if (value !== null && typeof value === "object") {
+        const result = {};
+        for (const [k, v] of Object.entries(value)) {
+            result[k] = scrubPayload(v, k);
+        }
+        return result;
+    }
+    return value;
+}
+//# sourceMappingURL=scrub.js.map

package/dist/scrub.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,3 @@
+export type { AgentEvent, AgentEventKind, TriggeredBy, } from "@keel_flow/schema";
+export { AgentEventSchema, AgentEventKindSchema, TriggeredBySchema, } from "@keel_flow/schema";
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,UAAU,EACV,cAAc,EACd,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export { AgentEventSchema, AgentEventKindSchema, TriggeredBySchema, } from "@keel_flow/schema";
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,mBAAmB,CAAC"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@keel_flow/telemetry",
+  "version": "0.2.0",
+  "private": false,
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "dependencies": {
+    "zod": "^3.23.0",
+    "@keel_flow/schema": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "lint": "eslint src"
+  }
+}