@devflow-tools/telemetry 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { TelemetryEngine } from "./telemetry-engine.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,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { TelemetryEngine } from "./telemetry-engine.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,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/telemetry-engine.d.ts

@@ -0,0 +1,12 @@
+import type { RunMeta, StepTrace, RunResult, RunDetail, RunFilter, FlattenedTrace, TimelineEvent } from "@devflow-tools/sdk";
+export declare class TelemetryEngine {
+    private runs;
+    startRun(meta: RunMeta): Promise<string>;
+    recordStep(runId: string, step: StepTrace): Promise<void>;
+    endRun(runId: string, result: RunResult): Promise<void>;
+    getRun(runId: string): Promise<RunDetail | null>;
+    listRuns(filter?: RunFilter): Promise<RunMeta[]>;
+    getTimeline(): Promise<TimelineEvent[]>;
+    getReplay(runId: string): Promise<FlattenedTrace | null>;
+}
+//# sourceMappingURL=telemetry-engine.d.ts.map

package/dist/telemetry-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-engine.d.ts","sourceRoot":"","sources":["../src/telemetry-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,OAAO,EACP,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,cAAc,EACd,aAAa,EACd,MAAM,oBAAoB,CAAC;AAW5B,qBAAa,eAAe;IAC1B,OAAO,CAAC,IAAI,CAAgC;IAEtC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC;IAYxC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IASzD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvD,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAehD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAiBhD,WAAW,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAkBvC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;CAK/D"}

package/dist/telemetry-engine.js

@@ -0,0 +1,82 @@
+export class TelemetryEngine {
+    runs = new Map();
+    async startRun(meta) {
+        const runId = `run:${Date.now()}:${Math.random().toString(36).slice(2, 7)}`;
+        this.runs.set(runId, {
+            meta,
+            steps: [],
+            status: "active",
+            startedAt: Date.now(),
+            tokenUsed: 0,
+        });
+        return runId;
+    }
+    async recordStep(runId, step) {
+        const run = this.runs.get(runId);
+        if (!run)
+            throw new Error(`Run "${runId}" not found`);
+        run.steps.push(step);
+        if (step.metadata?.tokensUsed) {
+            run.tokenUsed += step.metadata.tokensUsed;
+        }
+    }
+    async endRun(runId, result) {
+        const run = this.runs.get(runId);
+        if (!run)
+            throw new Error(`Run "${runId}" not found`);
+        run.status = "completed";
+        run.finishedAt = Date.now();
+        run.tokenUsed = result.tokenUsed;
+    }
+    async getRun(runId) {
+        const run = this.runs.get(runId);
+        if (!run)
+            return null;
+        const totalDuration = (run.finishedAt ?? Date.now()) - run.startedAt;
+        return {
+            meta: run.meta,
+            steps: run.steps,
+            totalDuration,
+            tokenUsed: run.tokenUsed,
+            replay: { runId, steps: run.steps },
+        };
+    }
+    async listRuns(filter) {
+        let entries = Array.from(this.runs.values());
+        if (filter?.agent) {
+            entries = entries.filter((r) => r.meta.agent === filter.agent);
+        }
+        if (filter?.status) {
+            entries = entries.filter((r) => r.status === filter.status);
+        }
+        if (filter?.since) {
+            entries = entries.filter((r) => r.startedAt >= filter.since);
+        }
+        const limit = filter?.limit ?? 50;
+        return entries.slice(0, limit).map((r) => r.meta);
+    }
+    async getTimeline() {
+        const events = [];
+        for (const [runId, run] of this.runs) {
+            for (const step of run.steps) {
+                events.push({
+                    runId,
+                    stepName: step.name,
+                    startTime: step.startTime,
+                    endTime: step.endTime,
+                    duration: step.duration,
+                    status: step.status,
+                    tokenUsed: step.metadata?.tokensUsed,
+                });
+            }
+        }
+        return events.sort((a, b) => a.startTime - b.startTime);
+    }
+    async getReplay(runId) {
+        const run = this.runs.get(runId);
+        if (!run)
+            return null;
+        return { runId, steps: [...run.steps].sort((a, b) => a.startTime - b.startTime) };
+    }
+}
+//# sourceMappingURL=telemetry-engine.js.map

package/dist/telemetry-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-engine.js","sourceRoot":"","sources":["../src/telemetry-engine.ts"],"names":[],"mappings":"AAmBA,MAAM,OAAO,eAAe;IAClB,IAAI,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE5C,KAAK,CAAC,QAAQ,CAAC,IAAa;QAC1B,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QAC5E,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE;YACnB,IAAI;YACJ,KAAK,EAAE,EAAE;YACT,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;YACrB,SAAS,EAAE,CAAC;SACb,CAAC,CAAC;QACH,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,KAAa,EAAE,IAAe;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,aAAa,CAAC,CAAC;QACtD,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,IAAI,IAAI,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAC;YAC9B,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa,EAAE,MAAiB;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,KAAK,aAAa,CAAC,CAAC;QACtD,GAAG,CAAC,MAAM,GAAG,WAAW,CAAC;QACzB,GAAG,CAAC,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC5B,GAAG,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAa;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QAEtB,MAAM,aAAa,GAAG,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,SAAS,CAAC;QAErE,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,aAAa;YACb,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE;SACpC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAkB;QAC/B,IAAI,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QAE7C,IAAI,MAAM,EAAE,KAAK,EAAE,CAAC;YAClB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,MAAM,EAAE,MAAM,EAAE,CAAC;YACnB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,CAAC;QAC9D,CAAC;QACD,IAAI,MAAM,EAAE,KAAK,EAAE,CAAC;YAClB,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,MAAM,CAAC,KAAM,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,KAAK,GAAG,MAAM,EAAE,KAAK,IAAI,EAAE,CAAC;QAClC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,MAAM,GAAoB,EAAE,CAAC;QACnC,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACrC,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;gBAC7B,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK;oBACL,QAAQ,EAAE,IAAI,CAAC,IAAI;oBACnB,SAAS,EAAE,IAAI,CAAC,SAAS;oBACzB,OAAO,EAAE,IAAI,CAAC,OAAO;oBACrB,QAAQ,EAAE,IAAI,CAAC,QAAQ;oBACvB,MAAM,EAAE,IAAI,CAAC,MAAM;oBACnB,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,UAAU;iBACrC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,KAAa;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjC,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,EAAE,CAAC;IACpF,CAAC;CACF"}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@devflow-tools/telemetry",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@devflow-tools/sdk": "*"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "gitHead": "4cede97fc7fc673f929427fac169acab100ca8ed"
+}