@intentface/latch-langfuse 0.17.0 → 0.18.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@intentface/latch-langfuse",
-  "version": "0.17.0",
+  "version": "0.18.0",
   "description": "Latch observability on Langfuse — one-line tracing for latch runtimes via the AI SDK telemetry integration, plus score and trace-read helpers for platforms.",
   "keywords": [
     "ai",
@@ -37,7 +37,7 @@
     "@langfuse/vercel-ai-sdk": "^5.11.1",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/sdk-trace-node": "^2.0.0",
-    "@intentface/latch-core": "^0.17.0"
+    "@intentface/latch-core": "^0.18.0"
   },
   "peerDependencies": {
     "ai": ">=7.0.0"
@@ -54,7 +54,7 @@
     "directory": "packages/langfuse"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
+    "build": "tsc -p tsconfig.build.json",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run"
   }

package/dist/reads.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=reads.test.d.ts.map

package/dist/reads.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"reads.test.d.ts","sourceRoot":"","sources":["../src/reads.test.ts"],"names":[],"mappings":""}

package/dist/reads.test.js

@@ -1,150 +0,0 @@
-import { beforeEach, describe, expect, it, vi } from "vitest";
-/**
- * The trace-list calls the reader made, in order, so a test can assert WHICH
- * queries were issued (one per agent-owner tag, plus the caller's own userId).
- */
-const calls = [];
-let tracePages;
-let scoreRows;
-/** When set, the trace-list call matching this filter key rejects ("*" = all). */
-let failFor;
-vi.mock("./client.js", () => ({
-    getLangfuseClient: () => ({
-        api: {
-            trace: {
-                list: async (params) => {
-                    calls.push(params);
-                    // Key the canned page by the filter this call used.
-                    const tags = params.tags;
-                    const key = tags?.[0] ?? `user:${String(params.userId)}`;
-                    if (failFor && (failFor === "*" || key === failFor)) {
-                        throw new Error("langfuse unavailable");
-                    }
-                    return { data: tracePages[key] ?? [] };
-                },
-            },
-            scoresV3: {
-                getManyV3: async () => ({ data: scoreRows, meta: {} }),
-            },
-        },
-    }),
-}));
-const { AGENT_OWNER_TAG, listAdministeredTraces } = await import("./reads.js");
-const trace = (id, at, over = {}) => ({
-    id,
-    name: "my-agent",
-    timestamp: at,
-    tags: [`run:run-${id}`, `agent:my-agent`],
-    ...over,
-});
-describe("listAdministeredTraces", () => {
-    beforeEach(() => {
-        calls.length = 0;
-        tracePages = {};
-        scoreRows = [];
-        failFor = undefined;
-    });
-    it("queries once per agent-owner key, plus the reader's own runs", async () => {
-        await listAdministeredTraces({
-            agentOwnerTags: ["org/me", "org"],
-            ownerTag: "org/me",
-            limit: 10,
-        });
-        expect(calls).toHaveLength(3);
-        expect(calls[0]).toMatchObject({ tags: [`${AGENT_OWNER_TAG}org/me`] });
-        expect(calls[1]).toMatchObject({ tags: [`${AGENT_OWNER_TAG}org`] });
-        expect(calls[2]).toMatchObject({ userId: "org/me" });
-    });
-    it("collapses duplicate owner keys into one query", async () => {
-        // An org-only principal's personal and org keys are the same string.
-        await listAdministeredTraces({
-            agentOwnerTags: ["org", "org", ""],
-            ownerTag: "org",
-        });
-        expect(calls).toHaveLength(2); // one tag query + the userId query
-    });
-    it("surfaces another user's run on an agent I administer", async () => {
-        tracePages[`${AGENT_OWNER_TAG}org`] = [
-            trace("t1", "2026-07-31T10:00:00Z", {
-                userId: "org/colleague",
-                tags: ["run:run-t1", "agent:my-agent", `${AGENT_OWNER_TAG}org`],
-            }),
-        ];
-        const rows = await listAdministeredTraces({
-            agentOwnerTags: ["org"],
-            ownerTag: "org/me",
-        });
-        expect(rows).toHaveLength(1);
-        expect(rows[0]).toMatchObject({
-            runId: "run-t1",
-            userId: "org/colleague", // attribution: who ran it
-            agentOwner: "org", // whose agent it was
-        });
-    });
-    it("de-duplicates a trace returned by more than one source", async () => {
-        const t = trace("t1", "2026-07-31T10:00:00Z", { userId: "org/me" });
-        tracePages[`${AGENT_OWNER_TAG}org`] = [t];
-        tracePages["user:org/me"] = [t];
-        const rows = await listAdministeredTraces({
-            agentOwnerTags: ["org"],
-            ownerTag: "org/me",
-        });
-        expect(rows.map((r) => r.id)).toEqual(["t1"]);
-    });
-    it("re-sorts across sources and caps at the limit", async () => {
-        // Each source is newest-first on its own; the union must be too, or the cap
-        // would keep whichever query a row happened to come from.
-        tracePages[`${AGENT_OWNER_TAG}org`] = [
-            trace("old", "2026-07-01T00:00:00Z"),
-            trace("oldest", "2026-06-01T00:00:00Z"),
-        ];
-        tracePages["user:org/me"] = [trace("newest", "2026-07-31T00:00:00Z")];
-        const rows = await listAdministeredTraces({
-            agentOwnerTags: ["org"],
-            ownerTag: "org/me",
-            limit: 2,
-        });
-        expect(rows.map((r) => r.id)).toEqual(["newest", "old"]);
-    });
-    it("joins scores in and normalizes booleans to numbers", async () => {
-        tracePages[`${AGENT_OWNER_TAG}org`] = [trace("t1", "2026-07-31T10:00:00Z")];
-        scoreRows = [
-            { name: "greets", value: true, subject: { kind: "trace", id: "t1" }, dataType: "BOOLEAN" },
-            { name: "user-feedback", value: 1, subject: { kind: "trace", id: "t1" } },
-            { name: "ignored", value: 1, subject: { kind: "observation", id: "t1" } },
-        ];
-        const rows = await listAdministeredTraces({
-            agentOwnerTags: ["org"],
-            ownerTag: "org/me",
-        });
-        expect(rows[0].scores).toEqual([
-            { name: "greets", value: 1, comment: undefined, dataType: "BOOLEAN" },
-            { name: "user-feedback", value: 1, comment: undefined, dataType: undefined },
-        ]);
-    });
-    it("degrades to the surviving sources when one query fails", async () => {
-        tracePages["user:org/me"] = [trace("mine", "2026-07-31T10:00:00Z", { userId: "org/me" })];
-        // The tag query throws; the reader's own runs must still render.
-        failFor = `${AGENT_OWNER_TAG}org`;
-        const rows = await listAdministeredTraces({
-            agentOwnerTags: ["org"],
-            ownerTag: "org/me",
-        });
-        expect(rows.map((r) => r.id)).toEqual(["mine"]);
-    });
-    it("throws when EVERY source fails, so the caller keeps its last good page", async () => {
-        // An empty array would read as "no traces yet" and wipe the feed.
-        failFor = "*";
-        await expect(listAdministeredTraces({ agentOwnerTags: ["org"], ownerTag: "org/me" })).rejects.toThrow("langfuse unavailable");
-    });
-    it("passes the agent filter to every source", async () => {
-        await listAdministeredTraces({
-            agentOwnerTags: ["org"],
-            ownerTag: "org/me",
-            agent: "my-agent",
-        });
-        for (const c of calls)
-            expect(c).toMatchObject({ name: "my-agent" });
-    });
-});
-//# sourceMappingURL=reads.test.js.map

package/dist/reads.test.js.map

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