@alisio/plugin-telemetry 0.1.0

package/dist/events.d.ts

@@ -0,0 +1,135 @@
+/**
+ * Event ingestion: a defensive, synchronous bridge from the host's fire-and-
+ * forget `RunEvent` stream into a bounded in-memory record queue.
+ *
+ * THE HANDLER MUST NEVER MISBEHAVE. Alisio calls observers synchronously inside
+ * the agent run, wraps *synchronous* throws in try/catch, but does NOT catch a
+ * rejected promise from an `async` handler. Therefore the registered handler
+ * here is a plain synchronous function: it validates, maps into a compact
+ * record, enqueues, and returns `undefined`. It never awaits, never returns a
+ * promise, never throws, and never touches disk. A full queue drops the newest
+ * event and counts it rather than blocking the run.
+ *
+ * CONTENT IS STRIPPED AT THE DOOR. Tool arguments and result previews are only
+ * carried into the queue when the matching capture flag is enabled, and only
+ * after allowlist redaction. The default record contains metadata only.
+ */
+import type { CaptureSettings, RedactionSettings } from "./config.js";
+export interface EventEnvelope {
+    schemaVersion?: unknown;
+    runId?: unknown;
+    sessionId?: unknown;
+    seq?: unknown;
+    timestamp?: unknown;
+    type?: unknown;
+    data?: unknown;
+}
+/** An envelope that passed the minimum shape check. */
+export interface TrustedEnvelope {
+    schemaVersion: 1;
+    runId: string;
+    sessionId: string;
+    seq: number;
+    timestamp: string;
+    type: string;
+    data: unknown;
+}
+export interface RunStartRecord {
+    kind: "run_start";
+    runId: string;
+    sessionId: string;
+    seq: number;
+    timestamp: string;
+    model: string | null;
+}
+export interface RunEndRecord {
+    kind: "run_end";
+    runId: string;
+    sessionId: string;
+    seq: number;
+    timestamp: string;
+    status: "completed" | "error";
+    totalTokens: number | null;
+    inputTokens: number;
+    outputTokens: number;
+    cachedInputTokens: number;
+    truncated: boolean;
+    text: string | null;
+}
+export interface TurnRecord {
+    kind: "turn";
+    runId: string;
+    sessionId: string;
+    seq: number;
+    timestamp: string;
+    turn: number;
+    model: string | null;
+    inputTokens: number;
+    outputTokens: number;
+    cachedInputTokens: number;
+    calls: number;
+    durationMs: number | null;
+}
+export interface ToolStartRecord {
+    kind: "tool_start";
+    runId: string;
+    sessionId: string;
+    seq: number;
+    timestamp: string;
+    callId: string;
+    name: string;
+    effect: string | null;
+    argsBytes: number;
+    args: string | null;
+}
+export interface ToolEndRecord {
+    kind: "tool_end";
+    runId: string;
+    sessionId: string;
+    seq: number;
+    timestamp: string;
+    callId: string;
+    name: string | null;
+    isError: boolean;
+    durationMs: number | null;
+    resultBytes: number;
+    preview: string | null;
+}
+export type TelemetryRecord = RunStartRecord | RunEndRecord | TurnRecord | ToolStartRecord | ToolEndRecord;
+export interface RedactionContext {
+    capture: CaptureSettings;
+    redaction: RedactionSettings;
+}
+/** True when the envelope carries the minimum shape required to trust it. */
+export declare function isTrustedEnvelope(event: unknown): event is TrustedEnvelope;
+/**
+ * Map one trusted envelope into a compact record. Returns null for unknown
+ * event types, malformed payloads, or payloads missing required identifiers.
+ * Never throws.
+ */
+export declare function normalizeEvent(event: Readonly<TrustedEnvelope>, context: RedactionContext): TelemetryRecord | null;
+/**
+ * A bounded queue. `push` refuses the newest record when full and reports it via
+ * the dropped counter; nothing here can block or throw.
+ */
+export interface EventBuffer {
+    push(record: TelemetryRecord): boolean;
+    drain(max: number): TelemetryRecord[];
+    size(): number;
+    dropped(): number;
+}
+export declare function createEventBuffer(maxQueue: number): EventBuffer;
+export interface EventHandlerOptions {
+    buffer: EventBuffer;
+    capture: CaptureSettings;
+    redaction: RedactionSettings;
+    /** Invoked when normalization itself throws; must not throw. */
+    onError?: () => void;
+}
+/**
+ * Build the synchronous event handler registered with `api.events.on`. The
+ * return type is `void`, the body contains no `await`, and every path is
+ * wrapped so a hostile or malformed event can never reach the host.
+ */
+export declare function createEventHandler(options: EventHandlerOptions): (event: unknown) => void;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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

package/dist/events.js

@@ -0,0 +1,255 @@
+import { redactJson } from "./redact.js";
+const MAX_ID = 200;
+const MAX_MODEL = 200;
+const MAX_TOOL_NAME = 200;
+const MAX_EFFECT = 40;
+function asObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : null;
+}
+function text(value, max) {
+    if (typeof value !== "string")
+        return null;
+    const trimmed = value;
+    return trimmed.length > max ? trimmed.slice(0, max) : trimmed;
+}
+function whole(value) {
+    if (typeof value === "number" && Number.isFinite(value))
+        return Math.trunc(value);
+    if (typeof value === "bigint")
+        return Number(value);
+    return null;
+}
+/** Coerce to a non-negative integer, defaulting to 0. */
+function count(value) {
+    const numeric = whole(value);
+    return numeric === null || numeric < 0 ? 0 : numeric;
+}
+function truthy(value) {
+    if (typeof value === "boolean")
+        return value;
+    if (typeof value === "string")
+        return ["1", "true", "yes", "on"].includes(value.toLowerCase());
+    return false;
+}
+function byteLength(value) {
+    return Buffer.byteLength(value, "utf8");
+}
+function usageOf(data) {
+    const usage = asObject(data.usage);
+    return {
+        input: count(usage?.input),
+        output: count(usage?.output),
+        cachedInput: count(usage?.cachedInput),
+    };
+}
+/** True when the envelope carries the minimum shape required to trust it. */
+export function isTrustedEnvelope(event) {
+    if (typeof event !== "object" || event === null)
+        return false;
+    const candidate = event;
+    return (candidate.schemaVersion === 1 &&
+        typeof candidate.runId === "string" &&
+        candidate.runId.length > 0 &&
+        candidate.runId.length <= 512 &&
+        typeof candidate.sessionId === "string" &&
+        candidate.sessionId.length <= 512 &&
+        typeof candidate.seq === "number" &&
+        Number.isFinite(candidate.seq) &&
+        typeof candidate.timestamp === "string" &&
+        candidate.timestamp.length <= 64 &&
+        typeof candidate.type === "string");
+}
+const RUN_START = new Set(["run_started", "run_start", "run.started"]);
+const RUN_END = new Set(["run_completed", "run_finished", "run_finish", "run.completed"]);
+const TURN = new Set(["turn_completed", "turn.completed"]);
+const TOOL_START = new Set(["tool_started", "tool.started"]);
+const TOOL_END = new Set(["tool_completed", "tool.completed"]);
+/**
+ * Map one trusted envelope into a compact record. Returns null for unknown
+ * event types, malformed payloads, or payloads missing required identifiers.
+ * Never throws.
+ */
+export function normalizeEvent(event, context) {
+    const { runId, sessionId, seq, timestamp, type } = event;
+    const run = text(runId, MAX_ID);
+    const session = text(sessionId, MAX_ID);
+    if (run === null || session === null)
+        return null;
+    const data = asObject(event.data);
+    if (RUN_START.has(type)) {
+        return {
+            kind: "run_start",
+            runId: run,
+            sessionId: session,
+            seq,
+            timestamp,
+            model: text(data?.model, MAX_MODEL),
+        };
+    }
+    if (RUN_END.has(type)) {
+        const usage = data ? usageOf(data) : { input: 0, output: 0, cachedInput: 0 };
+        const textValue = data ? text(data.text, 2000) : null;
+        return {
+            kind: "run_end",
+            runId: run,
+            sessionId: session,
+            seq,
+            timestamp,
+            status: data && truthy(data.error) ? "error" : "completed",
+            totalTokens: data ? whole(data.tokens) : null,
+            inputTokens: usage.input,
+            outputTokens: usage.output,
+            cachedInputTokens: usage.cachedInput,
+            truncated: data ? truthy(data.truncated) : false,
+            text: textValue !== null && context.capture.completions
+                ? redactJson(textValue, { mode: context.redaction.mode })
+                : null,
+        };
+    }
+    if (TURN.has(type)) {
+        if (!data)
+            return null;
+        const turn = whole(data.turn);
+        if (turn === null)
+            return null;
+        const usage = usageOf(data);
+        return {
+            kind: "turn",
+            runId: run,
+            sessionId: session,
+            seq,
+            timestamp,
+            turn,
+            model: text(data.model, MAX_MODEL),
+            inputTokens: usage.input,
+            outputTokens: usage.output,
+            cachedInputTokens: usage.cachedInput,
+            calls: count(data.calls),
+            durationMs: whole(data.durationMs),
+        };
+    }
+    if (TOOL_START.has(type)) {
+        if (!data)
+            return null;
+        const callId = text(data.id, MAX_ID);
+        const name = text(data.name, MAX_TOOL_NAME);
+        if (callId === null || name === null)
+            return null;
+        const argsJson = data.arguments === undefined ? "" : safeJson(data.arguments);
+        return {
+            kind: "tool_start",
+            runId: run,
+            sessionId: session,
+            seq,
+            timestamp,
+            callId,
+            name,
+            effect: text(data.effect, MAX_EFFECT),
+            argsBytes: byteLength(argsJson),
+            args: context.capture.toolArguments && argsJson !== ""
+                ? redactJson(data.arguments, { mode: context.redaction.mode })
+                : null,
+        };
+    }
+    if (TOOL_END.has(type)) {
+        if (!data)
+            return null;
+        const callId = text(data.id, MAX_ID);
+        if (callId === null)
+            return null;
+        const preview = data.preview === undefined ? "" : safeJson(data.preview);
+        return {
+            kind: "tool_end",
+            runId: run,
+            sessionId: session,
+            seq,
+            timestamp,
+            callId,
+            name: text(data.name, MAX_TOOL_NAME),
+            isError: truthy(data.isError),
+            durationMs: whole(data.durationMs),
+            resultBytes: byteLength(preview),
+            preview: context.capture.toolResults && preview !== ""
+                ? redactJson(data.preview, { mode: context.redaction.mode })
+                : null,
+        };
+    }
+    return null;
+}
+function safeJson(value) {
+    if (typeof value === "string")
+        return value;
+    try {
+        return JSON.stringify(value) ?? "";
+    }
+    catch {
+        return "";
+    }
+}
+export function createEventBuffer(maxQueue) {
+    const limit = Math.max(1, Math.trunc(maxQueue));
+    const items = [];
+    let head = 0;
+    let droppedCount = 0;
+    return {
+        push(record) {
+            if (items.length - head >= limit) {
+                droppedCount += 1;
+                return false;
+            }
+            items.push(record);
+            return true;
+        },
+        drain(max) {
+            const take = Math.max(0, Math.trunc(max));
+            const out = [];
+            while (head < items.length && out.length < take) {
+                out.push(items[head]);
+                head += 1;
+            }
+            if (head === items.length) {
+                items.length = 0;
+                head = 0;
+            }
+            else if (head > 1024) {
+                items.splice(0, head);
+                head = 0;
+            }
+            return out;
+        },
+        size() {
+            return items.length - head;
+        },
+        dropped() {
+            return droppedCount;
+        },
+    };
+}
+/**
+ * Build the synchronous event handler registered with `api.events.on`. The
+ * return type is `void`, the body contains no `await`, and every path is
+ * wrapped so a hostile or malformed event can never reach the host.
+ */
+export function createEventHandler(options) {
+    const context = { capture: options.capture, redaction: options.redaction };
+    return (event) => {
+        try {
+            if (!isTrustedEnvelope(event))
+                return;
+            const record = normalizeEvent(event, context);
+            if (record !== null)
+                options.buffer.push(record);
+        }
+        catch {
+            try {
+                options.onError?.();
+            }
+            catch {
+                // Swallow: an error reporter must not break the run either.
+            }
+        }
+    };
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

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

package/dist/format.d.ts

@@ -0,0 +1,36 @@
+export interface BoundsWindow {
+    from: string;
+    to: string;
+    windowMinutes: number;
+}
+export interface BoundsEnvelope<T> {
+    window: BoundsWindow;
+    returned: number;
+    total: number;
+    truncated: boolean;
+    hint: string;
+    data: T;
+}
+/** A stable error payload. Shape is part of the tool contract. */
+export interface TelemetryError {
+    error: {
+        code: string;
+        message: string;
+        hint?: string;
+    };
+}
+/** Redact and bound a display string. Never returns an absolute machine path. */
+export declare function sanitizeField(value: unknown, max?: number): string;
+export declare function hintFor(returned: number, total: number, _limit: number): string;
+export declare function boundsEnvelope<T>(options: {
+    window: BoundsWindow;
+    data: T;
+    returned: number;
+    total: number;
+    limit: number;
+    hint?: string;
+}): BoundsEnvelope<T>;
+export declare function stableError(code: string, message: string, hint?: string): TelemetryError;
+/** Serialize a tool payload to bounded JSON text. */
+export declare function toolJson(value: unknown): string;
+//# sourceMappingURL=format.d.ts.map

package/dist/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,MAAM,EAAE,YAAY,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,CAAC,CAAC;CACT;AAED,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;CACH;AAID,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,SAAM,GAAG,MAAM,CAK/D;AAED,wBAAgB,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAM/E;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE;IACzC,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,CAAC,CAAC;IACR,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,cAAc,CAAC,CAAC,CAAC,CAUpB;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,cAAc,CAExF;AAED,qDAAqD;AACrD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQ/C"}

package/dist/format.js

@@ -0,0 +1,49 @@
+/**
+ * Bounded, privacy-preserving result framing shared by every telemetry tool.
+ *
+ * No tool ever returns a raw event dump. Each result carries a bounds envelope
+ * (`returned`, `total`, `truncated`, and a refinement `hint`) so an agent can
+ * tell whether it is looking at everything or a slice. Every string that leaves
+ * this module passes through redaction and looks-like-a-path neutralization, so
+ * a hostile tool name or model string cannot smuggle a credential or an absolute
+ * machine path into a result.
+ */
+import { redactText } from "./redact.js";
+const LOOKS_LIKE_PATH = /(?<!\S)\/[A-Za-z0-9._-]+(?:\/[A-Za-z0-9._-]+)+/g;
+/** Redact and bound a display string. Never returns an absolute machine path. */
+export function sanitizeField(value, max = 200) {
+    const text = typeof value === "string" ? value : value === null || value === undefined ? "" : String(value);
+    const redacted = redactText(text, { mode: "standard", maxLength: max });
+    return redacted.replace(LOOKS_LIKE_PATH, "<path>").replace(/\s+/g, " ").trim();
+}
+export function hintFor(returned, total, _limit) {
+    if (total > returned)
+        return `Showing ${returned} of ${total}. Raise limit (max 100) or narrow the window with windowMinutes.`;
+    if (total === 0)
+        return "No telemetry recorded in this window; run an agent session or widen windowMinutes.";
+    return `Complete for the selected window (${returned} of ${total}).`;
+}
+export function boundsEnvelope(options) {
+    const truncated = options.total > options.returned;
+    return {
+        window: options.window,
+        returned: options.returned,
+        total: options.total,
+        truncated,
+        hint: options.hint ?? hintFor(options.returned, options.total, options.limit),
+        data: options.data,
+    };
+}
+export function stableError(code, message, hint) {
+    return { error: hint === undefined ? { code, message } : { code, message, hint } };
+}
+/** Serialize a tool payload to bounded JSON text. */
+export function toolJson(value) {
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return JSON.stringify(stableError("serialization_failed", "Telemetry result could not be serialized."));
+    }
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA0BzC,MAAM,eAAe,GAAG,iDAAiD,CAAC;AAE1E,iFAAiF;AACjF,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,GAAG,GAAG,GAAG;IACrD,MAAM,IAAI,GACR,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACjG,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IACxE,OAAO,QAAQ,CAAC,OAAO,CAAC,eAAe,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,QAAgB,EAAE,KAAa,EAAE,MAAc;IACrE,IAAI,KAAK,GAAG,QAAQ;QAClB,OAAO,WAAW,QAAQ,OAAO,KAAK,kEAAkE,CAAC;IAC3G,IAAI,KAAK,KAAK,CAAC;QACb,OAAO,oFAAoF,CAAC;IAC9F,OAAO,qCAAqC,QAAQ,OAAO,KAAK,IAAI,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,cAAc,CAAI,OAOjC;IACC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC;IACnD,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS;QACT,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC;QAC7E,IAAI,EAAE,OAAO,CAAC,IAAI;KACnB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAY,EAAE,OAAe,EAAE,IAAa;IACtE,OAAO,EAAE,KAAK,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;AACrF,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC,SAAS,CACnB,WAAW,CAAC,sBAAsB,EAAE,2CAA2C,CAAC,CACjF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * `@alisio/plugin-telemetry` — privacy-first local agent observability.
+ *
+ * The plugin registers five read-only query tools, four operator commands, one
+ * event observer, a session-end transcript hook (only when content capture is
+ * enabled) and an agent skill. The local SQLite database is always the source of
+ * truth; remote OTLP export is opt-in and never blocks the agent run.
+ */
+import { type Plugin } from "@alisio/sdk";
+import { type TelemetryRuntimeOptions } from "./runtime.js";
+import { TOOL_NAMES } from "./tools.js";
+export * from "./commands.js";
+export * from "./config.js";
+export * from "./database.js";
+export * from "./events.js";
+export * from "./format.js";
+export * from "./otlp.js";
+export * from "./redact.js";
+export * from "./runtime.js";
+export * from "./store.js";
+export * from "./tools.js";
+export { VERSION } from "./version.js";
+/** Package-local resource directories, registered relative to the built entry. */
+export declare const resourcePaths: {
+    readonly skills: "../.agents/skills";
+};
+export type CreateTelemetryPluginOptions = TelemetryRuntimeOptions;
+/**
+ * Build the plugin. Configuration is validated at setup: an invalid
+ * configuration disables telemetry with an actionable message instead of
+ * failing the host. The same read-only tools and commands are always registered
+ * so an agent gets a stable answer rather than a missing-tool error.
+ */
+export declare function createTelemetryPlugin(options?: CreateTelemetryPluginOptions): Plugin;
+export { TOOL_NAMES };
+declare const _default: Plugin;
+export default _default;
+//# 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;;;;;;;GAOG;AACH,OAAO,EAAgB,KAAK,MAAM,EAAkB,MAAM,aAAa,CAAC;AAExE,OAAO,EAGL,KAAK,uBAAuB,EAC7B,MAAM,cAAc,CAAC;AACtB,OAAO,EAAwB,UAAU,EAAE,MAAM,YAAY,CAAC;AAG9D,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,kFAAkF;AAClF,eAAO,MAAM,aAAa;aACxB,MAAM,EAAE,mBAAmB;CACnB,CAAC;AAEX,MAAM,MAAM,4BAA4B,GAAG,uBAAuB,CAAC;AAEnE;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,4BAAiC,GAAG,MAAM,CAuCxF;AAED,OAAO,EAAE,UAAU,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,78 @@
+/**
+ * `@alisio/plugin-telemetry` — privacy-first local agent observability.
+ *
+ * The plugin registers five read-only query tools, four operator commands, one
+ * event observer, a session-end transcript hook (only when content capture is
+ * enabled) and an agent skill. The local SQLite database is always the source of
+ * truth; remote OTLP export is opt-in and never blocks the agent run.
+ */
+import { definePlugin } from "@alisio/sdk";
+import { registerCommands } from "./commands.js";
+import { createTelemetryRuntime, } from "./runtime.js";
+import { createTelemetryTools, TOOL_NAMES } from "./tools.js";
+import { VERSION } from "./version.js";
+export * from "./commands.js";
+export * from "./config.js";
+export * from "./database.js";
+export * from "./events.js";
+export * from "./format.js";
+export * from "./otlp.js";
+export * from "./redact.js";
+export * from "./runtime.js";
+export * from "./store.js";
+export * from "./tools.js";
+export { VERSION } from "./version.js";
+/** Package-local resource directories, registered relative to the built entry. */
+export const resourcePaths = {
+    skills: "../.agents/skills",
+};
+/**
+ * Build the plugin. Configuration is validated at setup: an invalid
+ * configuration disables telemetry with an actionable message instead of
+ * failing the host. The same read-only tools and commands are always registered
+ * so an agent gets a stable answer rather than a missing-tool error.
+ */
+export function createTelemetryPlugin(options = {}) {
+    let runtime = null;
+    return definePlugin({
+        id: "telemetry",
+        name: "Telemetry",
+        description: "Privacy-first local agent observability with a SQLite source of truth, bounded read-only query tools, and opt-in OpenTelemetry-aligned OTLP export",
+        categories: ["analytics"],
+        version: VERSION,
+        apiVersion: 1,
+        setup(api) {
+            const created = createTelemetryRuntime({
+                ...options,
+                // Production always reads through the host storage port; an explicit
+                // opener (tests, embedders) still wins.
+                openDatabase: options.openDatabase ?? ((path) => api.storage.sqlite(path)),
+            });
+            runtime = created;
+            const tools = createTelemetryTools({
+                store: created.store,
+                config: created.config,
+                configError: created.configError,
+                now: created.now,
+            });
+            for (const tool of tools)
+                api.tools.register(tool);
+            api.events.on(created.handler);
+            api.session.onEnd(async (info) => {
+                await created.captureTranscript(info);
+            });
+            registerCommands(api, created);
+            api.resources.skills(resourcePaths.skills);
+            created.start();
+        },
+        async dispose() {
+            const current = runtime;
+            runtime = null;
+            if (current !== null)
+                await current.dispose();
+        },
+    });
+}
+export { TOOL_NAMES };
+export default createTelemetryPlugin();
+//# 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;;;;;;;GAOG;AACH,OAAO,EAAE,YAAY,EAA+B,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EACL,sBAAsB,GAGvB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,kFAAkF;AAClF,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,MAAM,EAAE,mBAAmB;CACnB,CAAC;AAIX;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAO,GAAiC,EAAE;IAC9E,IAAI,OAAO,GAA4B,IAAI,CAAC;IAC5C,OAAO,YAAY,CAAC;QAClB,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,oJAAoJ;QACtJ,UAAU,EAAE,CAAC,WAAW,CAAC;QACzB,OAAO,EAAE,OAAO;QAChB,UAAU,EAAE,CAAC;QACb,KAAK,CAAC,GAAc;YAClB,MAAM,OAAO,GAAG,sBAAsB,CAAC;gBACrC,GAAG,OAAO;gBACV,qEAAqE;gBACrE,wCAAwC;gBACxC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;aACnF,CAAC,CAAC;YACH,OAAO,GAAG,OAAO,CAAC;YAClB,MAAM,KAAK,GAAG,oBAAoB,CAAC;gBACjC,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,WAAW,EAAE,OAAO,CAAC,WAAW;gBAChC,GAAG,EAAE,OAAO,CAAC,GAAG;aACjB,CAAC,CAAC;YACH,KAAK,MAAM,IAAI,IAAI,KAAK;gBAAE,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YACnD,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;YAC/B,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;gBAC/B,MAAM,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;YACxC,CAAC,CAAC,CAAC;YACH,gBAAgB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC/B,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YAC3C,OAAO,CAAC,KAAK,EAAE,CAAC;QAClB,CAAC;QACD,KAAK,CAAC,OAAO;YACX,MAAM,OAAO,GAAG,OAAO,CAAC;YACxB,OAAO,GAAG,IAAI,CAAC;YACf,IAAI,OAAO,KAAK,IAAI;gBAAE,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;QAChD,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,CAAC;AACtB,eAAe,qBAAqB,EAAE,CAAC"}