@alisio/plugin-telemetry 0.1.0

package/dist/store.d.ts

@@ -0,0 +1,188 @@
+/**
+ * The local SQLite store: the primary sink and the source of truth.
+ *
+ * REMOTE EXPORT NEVER OWNS THE DATA. Every record lands here first; OTLP batches
+ * are derived from these rows and tracked in `otlp_batches` so a failed export
+ * can be retried idempotently. Remote failures never delete or mutate rows.
+ *
+ * FULL-TEXT SEARCH IS CONTENT-ONLY AND OPT-IN. The `content_fts` shadow tables
+ * can retain fragments after rows are deleted. Deletion therefore also clears
+ * the FTS index, runs `optimize`, and vacuums; the README states plainly that
+ * forensic traces in a copied file cannot be guaranteed gone.
+ */
+import type { SqlDatabase } from "./database.js";
+import type { TelemetryRecord } from "./events.js";
+export interface TimeRange {
+    /** Inclusive ISO timestamp lower bound. */
+    from: string;
+    /** Inclusive ISO timestamp upper bound. */
+    to: string;
+}
+export interface StoreSummary {
+    sessions: number;
+    runs: number;
+    turns: number;
+    toolCalls: number;
+    toolErrors: number;
+    inputTokens: number;
+    outputTokens: number;
+    cachedInputTokens: number;
+    totalTokens: number;
+    avgToolDurationMs: number | null;
+    maxToolDurationMs: number | null;
+    firstAt: string | null;
+    lastAt: string | null;
+}
+export interface ModelAggregate {
+    model: string;
+    turns: number;
+    inputTokens: number;
+    outputTokens: number;
+    cachedInputTokens: number;
+    calls: number;
+    avgTurnDurationMs: number | null;
+}
+export interface ToolAggregate {
+    name: string;
+    calls: number;
+    errors: number;
+    errorRate: number;
+    avgDurationMs: number | null;
+    maxDurationMs: number | null;
+    effects: string[];
+}
+export interface SessionAggregate {
+    sessionId: string;
+    runs: number;
+    turns: number;
+    inputTokens: number;
+    outputTokens: number;
+    lastAt: string | null;
+    models: string[];
+}
+export interface SeriesBucket {
+    bucketStart: string;
+    runs: number;
+    turns: number;
+    toolCalls: number;
+    inputTokens: number;
+    outputTokens: number;
+}
+export interface ContentHit {
+    id: number;
+    kind: string;
+    ref: string | null;
+    snippet: string;
+    createdAt: string;
+}
+export interface BatchRow {
+    id: number;
+    batchKey: string;
+    signal: string;
+    payload: string;
+    attempts: number;
+    createdAt: string;
+}
+export interface RunSnapshot {
+    runId: string;
+    sessionId: string;
+    model: string | null;
+    startedAt: string;
+    endedAt: string | null;
+    status: string;
+    inputTokens: number;
+    outputTokens: number;
+    cachedInputTokens: number;
+    totalTokens: number | null;
+    truncated: boolean;
+    turns: number;
+    toolCalls: number;
+    toolErrors: number;
+}
+export interface TurnSnapshot {
+    runId: string;
+    sessionId: string;
+    turn: number;
+    model: string | null;
+    inputTokens: number;
+    outputTokens: number;
+    cachedInputTokens: number;
+    durationMs: number | null;
+    createdAt: string;
+}
+export interface ToolSnapshot {
+    runId: string;
+    callId: string;
+    sessionId: string;
+    name: string;
+    effect: string | null;
+    startedAt: string | null;
+    finishedAt: string | null;
+    durationMs: number | null;
+    isError: boolean;
+}
+export interface TelemetrySnapshot {
+    runs: RunSnapshot[];
+    turns: TurnSnapshot[];
+    tools: ToolSnapshot[];
+}
+export interface StoreCounts {
+    runs: number;
+    turns: number;
+    toolCalls: number;
+    content: number;
+    pendingBatches: number;
+    deadBatches: number;
+}
+export interface WindowTotals {
+    models: number;
+    tools: number;
+    sessions: number;
+}
+export interface TranscriptContent {
+    runId: string | null;
+    sessionId: string;
+    kind: string;
+    ref: string | null;
+    text: string;
+    createdAt: string;
+}
+export interface Store {
+    migrate(): void;
+    writeRecords(records: TelemetryRecord[]): {
+        written: number;
+        content: number;
+    };
+    summary(range: TimeRange): StoreSummary;
+    models(range: TimeRange, limit: number): ModelAggregate[];
+    tools(range: TimeRange, limit: number): ToolAggregate[];
+    sessions(range: TimeRange, limit: number): SessionAggregate[];
+    series(range: TimeRange, bucketSeconds: number): SeriesBucket[];
+    search(query: string, range: TimeRange, limit: number): {
+        hits: ContentHit[];
+        total: number;
+    };
+    snapshot(range: TimeRange, limit: number): TelemetrySnapshot;
+    totals(range: TimeRange): WindowTotals;
+    recordContent(records: TranscriptContent[]): number;
+    counts(): StoreCounts;
+    pruneBefore(iso: string): {
+        runs: number;
+        turns: number;
+        toolCalls: number;
+        content: number;
+    };
+    optimize(): void;
+    enqueueBatch(key: string, signal: string, payload: string, createdAt: string): boolean;
+    pendingBatches(limit: number): BatchRow[];
+    markBatchSent(id: number, at: string): void;
+    markBatchRetry(id: number, error: string, at: string): void;
+    markBatchDead(id: number, error: string, at: string): void;
+}
+export declare function createStore(database: SqlDatabase): Store;
+/**
+ * Turn free text into a safe FTS5 MATCH expression: each whitespace token is
+ * quoted as a phrase, so FTS operators in the query cannot cause a syntax error.
+ */
+export declare function toMatchQuery(query: string): string;
+//# sourceMappingURL=store.d.ts.map

package/dist/store.d.ts.map

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