failproofai 1.0.10 → 1.0.11-beta.1

package/.next/standalone/sdk/typescript/README.md

@@ -82,6 +82,49 @@ is unreachable.
 
 ### 2. Adapters
 
+#### OpenTelemetry (opt in)
+
+If your app already emits OpenTelemetry spans, send them through FailproofAI Cloud
+without replacing its framework adapters. Install OpenTelemetry separately:
+
+```bash
+npm install @opentelemetry/api @opentelemetry/sdk-trace-base
+```
+
+```ts
+import * as failproofai from "@failproofai/sdk";
+import { BasicTracerProvider } from "@opentelemetry/sdk-trace-base";
+import type { SpanProcessor } from "@opentelemetry/sdk-trace-base";
+
+const spanProcessors: SpanProcessor[] = []; // include your existing processors
+await failproofai.instrument("otel", { spanProcessors });
+const provider = new BasicTracerProvider({ spanProcessors });
+const tracer = provider.getTracer("my-agent");
+const span = tracer.startSpan("agent", {
+  attributes: { "gen_ai.operation.name": "invoke_agent" },
+});
+span.end();
+await provider.forceFlush();
+```
+
+With no options, `instrument("otel")` creates a provider only if none is registered.
+For an existing OpenTelemetry v2 provider, add the processor before constructing
+the provider, as above. For providers exposing `addSpanProcessor`, pass `{ provider }`.
+You can also supply `new failproofai.OtelSpanExporter()` to your own span processor.
+`uninstrument("otel")` disables only FailproofAI's processor; other exporters keep working.
+
+The exporter writes OTLP/JSON export requests durably into the local relay spool
+(`$FAILPROOFAI_HOME/state/spool-otlp`, otherwise `~/.failproofai/state/spool-otlp`).
+It never sends HTTP or reads the Cloud key. Connect the daemon with `failproofai config`
+and ask an admin to enable Settings → OpenTelemetry. No local TCP listener is
+needed for SDK exports. `spoolDir` is an explicit override for tests or managed
+deployments. `configure({ baseDir })` still applies only to the existing event adapters.
+
+OTEL is never auto-enabled by a bare `instrument()`. The SDK still declares zero
+hard runtime dependencies. Your spans control content capture; do not export
+sensitive attributes unless intended. Export related spans together for complete
+agent traces; call `provider.forceFlush()` before a short-lived process exits.
+
 ```ts
 await failproofai.instrument();              // whatever it can find
 await failproofai.instrument("langchain");   // exactly one

package/.next/standalone/sdk/typescript/integration/ai.test.ts

@@ -258,8 +258,15 @@ describe.each(FIXTURES)("%s", (fixture) => {
       };
       expect(report.text).toBe("It is 20C in Paris.");
       if (major >= 7) {
-        // v7 has no OpenTelemetry dependency; the integration records the call.
-        expect(report.customer).toBe("absent");
+        // v7 has no OpenTelemetry dependency of its own. The optional OTEL
+        // exporter's dev tests can make it resolvable from the parent SDK
+        // project; when present, their provider must still own the global slot
+        // and receive only their service span (ai 7 emits no OTEL spans).
+        if (report.customer !== "absent") {
+          expect(report.customer, describeTrace(result)).toEqual({
+            registered: true, ended: ["http.request"],
+          });
+        }
         expect(shape(result.events), describeTrace(result)).toEqual(GEN);
         return;
       }

package/.next/standalone/sdk/typescript/package-lock.json

@@ -1,18 +1,20 @@
 {
   "name": "@failproofai/sdk",
-  "version": "0.0.1-beta.0",
+  "version": "0.0.1-beta.1",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "@failproofai/sdk",
-      "version": "0.0.1-beta.0",
+      "version": "0.0.1-beta.1",
       "license": "SEE LICENSE IN LICENSE",
       "bin": {
         "failproofai-evaluator": "dist/esm/evaluator/cli.js"
       },
       "devDependencies": {
         "@eslint/js": "^9.38.0",
+        "@opentelemetry/api": "^1.9.0",
+        "@opentelemetry/sdk-trace-base": "^2.12.0",
         "@types/node": "^22.10.2",
         "eslint": "^9.38.0",
         "typescript": "^5.9.2",
@@ -281,6 +283,56 @@
         "@jridgewell/sourcemap-codec": "^1.4.14"
       }
     },
+    "node_modules/@opentelemetry/api": {
+      "version": "1.9.1",
+      "resolved": "https://registry.npmjs.org/@opentelemetry/api/-/api-1.9.1.tgz",
+      "integrity": "sha512-gLyJlPHPZYdAk1JENA9LeHejZe1Ti77/pTeFm/nMXmQH/HFZlcS/O2XJB+L8fkbrNSqhdtlvjBVjxwUYanNH5Q==",
+      "dev": true,
+      "engines": { "node": ">=8.0.0" }
+    },
+    "node_modules/@opentelemetry/core": {
+      "version": "2.12.0",
+      "resolved": "https://registry.npmjs.org/@opentelemetry/core/-/core-2.12.0.tgz",
+      "integrity": "sha512-1HsSAuvT4/my0QrXWsyXFdWjKaPeCHsismKZgEEIb8NK13LP6DrMRlsUbvD/0F9mDWK3xDom9AMv3IscxgOnOQ==",
+      "dev": true,
+      "dependencies": { "@opentelemetry/semantic-conventions": "^1.29.0" },
+      "peerDependencies": { "@opentelemetry/api": ">=1.0.0 <1.10.0" },
+      "engines": { "node": "^18.19.0 || >=20.6.0" }
+    },
+    "node_modules/@opentelemetry/resources": {
+      "version": "2.12.0",
+      "resolved": "https://registry.npmjs.org/@opentelemetry/resources/-/resources-2.12.0.tgz",
+      "integrity": "sha512-+rSRoOdln6NhXTVcBdHSlZxJDNzwxadeweK2ltZO3tVtfp6aklABc06xclDk6ovRR+EiGgIcSbh/6NgjFhnb3A==",
+      "dev": true,
+      "dependencies": { "@opentelemetry/core": "2.12.0", "@opentelemetry/semantic-conventions": "^1.29.0" },
+      "peerDependencies": { "@opentelemetry/api": ">=1.3.0 <1.10.0" },
+      "engines": { "node": "^18.19.0 || >=20.6.0" }
+    },
+    "node_modules/@opentelemetry/sdk-trace": {
+      "version": "2.12.0",
+      "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-trace/-/sdk-trace-2.12.0.tgz",
+      "integrity": "sha512-ImVuRQ6faOsTi1Wna88s2avgrrf/iDgXPigIeynkUhjstMuoQUDOJXgkez2j1mlU4btjXcXBGa+q7qKFYR3GsA==",
+      "dev": true,
+      "dependencies": { "@opentelemetry/core": "2.12.0", "@opentelemetry/resources": "2.12.0", "@opentelemetry/semantic-conventions": "^1.29.0" },
+      "peerDependencies": { "@opentelemetry/api": ">=1.3.0 <1.10.0" },
+      "engines": { "node": "^18.19.0 || >=20.6.0" }
+    },
+    "node_modules/@opentelemetry/sdk-trace-base": {
+      "version": "2.12.0",
+      "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-trace-base/-/sdk-trace-base-2.12.0.tgz",
+      "integrity": "sha512-JOERgZCxRM06FEJ5kEWxlSRChah6MmXDx3KwCruqEv/iEyLkTokCSemf2y1w8oIHtfrr8EVTpzebq/31vn2Cpg==",
+      "dev": true,
+      "dependencies": { "@opentelemetry/core": "2.12.0", "@opentelemetry/resources": "2.12.0", "@opentelemetry/sdk-trace": "2.12.0", "@opentelemetry/semantic-conventions": "^1.29.0" },
+      "peerDependencies": { "@opentelemetry/api": ">=1.3.0 <1.10.0" },
+      "engines": { "node": "^18.19.0 || >=20.6.0" }
+    },
+    "node_modules/@opentelemetry/semantic-conventions": {
+      "version": "1.43.0",
+      "resolved": "https://registry.npmjs.org/@opentelemetry/semantic-conventions/-/semantic-conventions-1.43.0.tgz",
+      "integrity": "sha512-eSYWTm620tTk45EKSedaUL8MFYI8hW164hIXsgIHyxu3VobUB3fFCu5t0hQby6OoWRPsG1KkKUG2M5UadiLiVg==",
+      "dev": true,
+      "engines": { "node": ">=14" }
+    },
     "node_modules/@oxc-project/types": {
       "version": "0.150.0",
       "resolved": "https://registry.npmjs.org/@oxc-project/types/-/types-0.150.0.tgz",
@@ -2250,9 +2302,9 @@
       "license": "ISC"
     },
     "node_modules/source-map-js": {
-      "version": "1.2.1",
-      "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz",
-      "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==",
+      "version": "1.2.2",
+      "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.2.tgz",
+      "integrity": "sha512-KGj/8Y43x35aZVDtt+J4mK1hoLGHULMYfSkODJNQjNDC3oW1PqPoxMwo0pLUsWM/UEGzON/NxeHywEfNXNP3Vw==",
       "dev": true,
       "license": "BSD-3-Clause",
       "peer": true,

package/.next/standalone/sdk/typescript/package.json

@@ -389,6 +389,8 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.38.0",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/sdk-trace-base": "^2.12.0",
     "@types/node": "^22.10.2",
     "eslint": "^9.38.0",
     "typescript": "^5.9.2",

package/.next/standalone/sdk/typescript/src/edge/index.ts

@@ -42,6 +42,15 @@ import { notice } from "./notice.js";
 export { VERSION as version };
 
 export const DEFAULT_AGENT_ID = "main";
+/** File export is unavailable at the Edge, like the other telemetry surfaces. */
+export class OtelSpanExporter {
+  export(_spans: unknown[], callback: (result: { code: number }) => void): void {
+    notice();
+    callback({ code: 0 });
+  }
+  forceFlush(): Promise<void> { return Promise.resolve(); }
+  shutdown(): Promise<void> { return Promise.resolve(); }
+}
 /** The same registered symbol as the Node build's, so comparisons still hold. */
 export const AUTO: unique symbol = Symbol.for("failproofai.AUTO") as never;
 

package/.next/standalone/sdk/typescript/src/index.ts

@@ -88,6 +88,8 @@ export {
   uninstrument,
 } from "./integrations/index.js";
 export type { FrameworkName, InstrumentOptions } from "./integrations/index.js";
+export { OtelSpanExporter } from "./integrations/otel.js";
+export type { OtelReadableSpan, OtelSpanExporterOptions } from "./integrations/otel.js";
 
 export interface ConfigureOptions {
   /**

package/.next/standalone/sdk/typescript/src/integrations/index.ts

@@ -52,13 +52,14 @@ import * as compat from "./compat.js";
 import type { Adapter } from "./core.js";
 import * as core from "./core.js";
 
-export type FrameworkName = "langchain" | "ai" | "mastra" | "llamaindex";
+export type FrameworkName = "langchain" | "ai" | "mastra" | "llamaindex" | "otel";
 
 const REGISTRY: Record<FrameworkName, () => Promise<{ adapter: Adapter }>> = {
   langchain: () => import("./langchain.js"),
   ai: () => import("./ai.js"),
   mastra: () => import("./mastra.js"),
   llamaindex: () => import("./llamaindex.js"),
+  otel: () => import("./otel.js"),
 };
 
 /**
@@ -90,6 +91,8 @@ const DETECT: Record<FrameworkName, readonly string[]> = {
   ai: ["ai"],
   mastra: ["@mastra/core"],
   llamaindex: ["llamaindex", "@llamaindex/core"],
+  // Never auto-enable a second reporting path on an existing application.
+  otel: [],
 };
 
 const active = new Map<FrameworkName, Adapter>();

package/.next/standalone/sdk/typescript/src/integrations/otel.ts

@@ -0,0 +1,204 @@
+/**
+ * Opt-in OTLP/JSON SpanExporter. Only disk I/O: the daemon authenticates and
+ * delivers opaque batches. No OpenTelemetry import until instrument("otel").
+ */
+import { randomUUID } from "node:crypto";
+import { closeSync, fsyncSync, mkdirSync, openSync, renameSync, rmSync, writeSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { importModule, resolveFrom, tryRequire } from "../node-require.js";
+import type { Adapter } from "./core.js";
+
+type ObjectValue = Record<string, unknown>;
+export interface OtelReadableSpan {
+  name: string;
+  kind: number;
+  spanContext(): { traceId: string; spanId: string; traceFlags?: number; traceState?: { serialize(): string } };
+  parentSpanId?: string;
+  parentSpanContext?: { spanId: string };
+  startTime: readonly [number, number];
+  endTime: readonly [number, number];
+  attributes: ObjectValue;
+  status: { code: number; message?: string };
+  resource?: { attributes: ObjectValue; schemaUrl?: string };
+  instrumentationScope?: { name: string; version?: string; schemaUrl?: string };
+  instrumentationLibrary?: { name: string; version?: string; schemaUrl?: string };
+  events?: readonly { name: string; time: readonly [number, number]; attributes?: ObjectValue; droppedAttributesCount?: number }[];
+  links?: readonly { context: { traceId: string; spanId: string; traceFlags?: number; traceState?: { serialize(): string } }; attributes?: ObjectValue; droppedAttributesCount?: number }[];
+  droppedAttributesCount?: number;
+  droppedEventsCount?: number;
+  droppedLinksCount?: number;
+}
+export interface OtelExportResult { code: number; error?: Error }
+export interface OtelSpanExporterOptions { spoolDir?: string }
+const MAX_BYTES = 8 * 1024 * 1024;
+const metadata = '{"path":"/v1/traces","content_type":"application/json","encoding":null}\n';
+
+function anyValue(value: unknown): ObjectValue {
+  if (typeof value === "string") return { stringValue: value };
+  if (typeof value === "boolean") return { boolValue: value };
+  if (typeof value === "bigint") return { intValue: value.toString() };
+  if (typeof value === "number") {
+    if (!Number.isFinite(value)) return { doubleValue: String(value) };
+    return Number.isInteger(value) ? { intValue: String(value) } : { doubleValue: value };
+  }
+  if (value instanceof Uint8Array) return { bytesValue: Buffer.from(value).toString("base64") };
+  if (Array.isArray(value)) return { arrayValue: { values: value.map(anyValue) } };
+  if (value && typeof value === "object") return { kvlistValue: { values: attributes(value as ObjectValue) } };
+  return {};
+}
+function attributes(value: ObjectValue = {}): ObjectValue[] {
+  return Object.entries(value).filter(([, v]) => v !== undefined && v !== null)
+    .map(([key, v]) => ({ key, value: anyValue(v) }));
+}
+function nanos(time: readonly [number, number]): string {
+  return (BigInt(time[0]) * 1_000_000_000n + BigInt(time[1])).toString();
+}
+function resourceSpan(span: OtelReadableSpan): ObjectValue {
+  const context = span.spanContext();
+  const scope = span.instrumentationScope ?? span.instrumentationLibrary;
+  return {
+    resource: { attributes: attributes(span.resource?.attributes) },
+    ...(span.resource?.schemaUrl ? { schemaUrl: span.resource.schemaUrl } : {}),
+    scopeSpans: [{
+      scope: { name: scope?.name ?? "", ...(scope?.version ? { version: scope.version } : {}) },
+      ...(scope?.schemaUrl ? { schemaUrl: scope.schemaUrl } : {}),
+      spans: [{
+        traceId: context.traceId, spanId: context.spanId,
+        ...(span.parentSpanContext?.spanId || span.parentSpanId ? { parentSpanId: span.parentSpanContext?.spanId ?? span.parentSpanId } : {}),
+        ...(context.traceState ? { traceState: context.traceState.serialize() } : {}),
+        flags: context.traceFlags ?? 0, name: span.name, kind: span.kind + 1,
+        startTimeUnixNano: nanos(span.startTime), endTimeUnixNano: nanos(span.endTime),
+        attributes: attributes(span.attributes), status: span.status,
+        droppedAttributesCount: span.droppedAttributesCount ?? 0,
+        droppedEventsCount: span.droppedEventsCount ?? 0, droppedLinksCount: span.droppedLinksCount ?? 0,
+        events: (span.events ?? []).map(event => ({
+          name: event.name, timeUnixNano: nanos(event.time), attributes: attributes(event.attributes),
+          droppedAttributesCount: event.droppedAttributesCount ?? 0,
+        })),
+        links: (span.links ?? []).map(link => ({
+          traceId: link.context.traceId, spanId: link.context.spanId, flags: link.context.traceFlags ?? 0,
+          ...(link.context.traceState ? { traceState: link.context.traceState.serialize() } : {}),
+          attributes: attributes(link.attributes), droppedAttributesCount: link.droppedAttributesCount ?? 0,
+        })),
+      }],
+    }],
+  };
+}
+
+/** Structural implementation of OpenTelemetry's SpanExporter; zero hard deps. */
+export class OtelSpanExporter {
+  private stopped = false;
+  private readonly directory?: string;
+  constructor(options: OtelSpanExporterOptions = {}) { this.directory = options.spoolDir; }
+
+  export(spans: readonly OtelReadableSpan[], callback: (result: OtelExportResult) => void): void {
+    let result: OtelExportResult = { code: 0 };
+    try {
+      if (this.stopped) throw new Error("OTEL exporter has shut down.");
+      const dir = this.directory ?? join(process.env.FAILPROOFAI_HOME || join(homedir(), ".failproofai"), "state", "spool-otlp");
+      // Encode each span once and split batches at the relay's request limit.
+      const chunks: string[] = [];
+      let items: string[] = [];
+      let size = Buffer.byteLength('{"resourceSpans":[]}');
+      for (const span of spans) {
+        const encoded = JSON.stringify(resourceSpan(span));
+        const bytes = Buffer.byteLength(encoded);
+        if (bytes + 20 > MAX_BYTES) throw new Error("OTEL span exceeds the 8 MiB relay limit.");
+        if (size + bytes + 1 > MAX_BYTES) {
+          chunks.push(`{"resourceSpans":[${items.join(",")}]}`); items = []; size = 20;
+        }
+        items.push(encoded); size += bytes + 1;
+      }
+      if (items.length) chunks.push(`{"resourceSpans":[${items.join(",")}]}`);
+      for (const body of chunks) this.publish(dir, body);
+    } catch (error) {
+      result = { code: 1, error: error instanceof Error ? error : new Error(String(error)) };
+    }
+    callback(result);
+  }
+  private publish(dir: string, body: string): void {
+    mkdirSync(dir, { recursive: true, mode: 0o700 });
+    const name = `otlp-sdk-${randomUUID()}`;
+    const temp = join(dir, `.${name}.tmp`);
+    let fd: number | undefined;
+    try {
+      fd = openSync(temp, "wx", 0o600);
+      const bytes = Buffer.from(metadata + body);
+      let offset = 0;
+      while (offset < bytes.length) offset += writeSync(fd, bytes, offset, bytes.length - offset);
+      fsyncSync(fd); closeSync(fd); fd = undefined;
+      renameSync(temp, join(dir, `${name}.jsonl`));
+      if (process.platform !== "win32") {
+        const directory = openSync(dir, "r");
+        try { fsyncSync(directory); } finally { closeSync(directory); }
+      }
+    } finally {
+      if (fd !== undefined) closeSync(fd);
+      rmSync(temp, { force: true });
+    }
+  }
+  forceFlush(): Promise<void> { return Promise.resolve(); }
+  shutdown(): Promise<void> { this.stopped = true; return Promise.resolve(); }
+}
+
+interface Processor {
+  onStart(...args: unknown[]): void;
+  onEnd(...args: unknown[]): void;
+  shutdown(): Promise<void>;
+  forceFlush(): Promise<void>;
+}
+interface Provider { addSpanProcessor(processor: Processor): void }
+interface TraceSdk {
+  BatchSpanProcessor: new (exporter: OtelSpanExporter) => Processor;
+  BasicTracerProvider: new (options: { spanProcessors: Processor[] }) => unknown;
+}
+interface TraceApi { trace: { setGlobalTracerProvider(provider: unknown): boolean } }
+let installed: { enabled: boolean; processor: Processor; list?: Processor[] } | null = null;
+export const adapter: Adapter = {
+  name: "otel",
+  async install(options = {}) {
+    const provider = options.provider as Provider | undefined;
+    const list = options.spanProcessors as Processor[] | undefined;
+    if (provider && typeof provider.addSpanProcessor !== "function") {
+      throw new Error('instrument("otel") needs { spanProcessors } before constructing an OTEL v2 provider, or a provider with addSpanProcessor().');
+    }
+    const path = resolveFrom("@opentelemetry/sdk-trace-base");
+    if (!path) throw new Error('Install @opentelemetry/sdk-trace-base to use instrument("otel").');
+    const module = tryRequire<TraceSdk>("@opentelemetry/sdk-trace-base") ??
+      await importModule(path) as TraceSdk;
+    const exporter = new OtelSpanExporter({ spoolDir: options.spoolDir as string | undefined });
+    const batch = new module.BatchSpanProcessor(exporter);
+    const state = { enabled: true, processor: batch, list };
+    // Providers have no portable remove API. A gate makes uninstall effective
+    // without shutting down anybody else's processors or provider.
+    const gate: Processor = {
+      onStart: (...args) => { if (state.enabled) batch.onStart(...args); },
+      onEnd: (...args) => { if (state.enabled) batch.onEnd(...args); },
+      forceFlush: () => state.enabled ? batch.forceFlush() : Promise.resolve(),
+      shutdown: () => batch.shutdown(),
+    };
+    installed = state;
+    if (Array.isArray(list)) { list.push(gate); state.processor = gate; }
+    else if (provider) { provider.addSpanProcessor(gate); state.processor = gate; }
+    else {
+      state.processor = gate;
+      const apiPath = resolveFrom("@opentelemetry/api");
+      if (!apiPath) throw new Error("Install @opentelemetry/api to register the OTEL provider.");
+      const api = tryRequire<TraceApi>("@opentelemetry/api") ?? await importModule(apiPath) as TraceApi;
+      if (!api.trace.setGlobalTracerProvider(new module.BasicTracerProvider({ spanProcessors: [gate] }))) {
+        throw new Error('An OTEL provider is already registered; use instrument("otel", { spanProcessors }) before constructing it.');
+      }
+    }
+  },
+  uninstall() {
+    if (!installed) return;
+    installed.enabled = false;
+    if (installed.list) {
+      const index = installed.list.indexOf(installed.processor);
+      if (index >= 0) installed.list.splice(index, 1);
+    }
+    void installed.processor.shutdown().catch(() => { /* SDK teardown never throws into the app. */ });
+    installed = null;
+  },
+};

package/.next/standalone/sdk/typescript/test/integrations.test.ts

@@ -324,7 +324,7 @@ describe("RunTracker", () => {
 
 describe("the registry", () => {
   it("lists the frameworks it can instrument", () => {
-    expect(available()).toEqual(["ai", "langchain", "llamaindex", "mastra"]);
+    expect(available()).toEqual(["ai", "langchain", "llamaindex", "mastra", "otel"]);
   });
 
   it("throws on an unknown name, listing the valid ones", async () => {

package/.next/standalone/sdk/typescript/test/otel.test.ts

@@ -0,0 +1,125 @@
+import { afterEach, beforeEach, describe, expect, it } from "vitest";
+import { mkdtempSync, readdirSync, readFileSync, rmSync, statSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { BasicTracerProvider, SimpleSpanProcessor } from "@opentelemetry/sdk-trace-base";
+import type { SpanProcessor, ReadableSpan } from "@opentelemetry/sdk-trace-base";
+import { ROOT_CONTEXT, SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
+import { OtelSpanExporter } from "../src/index.js";
+import { instrument, uninstrument, activeFrameworks } from "../src/integrations/index.js";
+import { setStrict } from "../src/integrations/core.js";
+
+let home: string;
+let previousHome: string | undefined;
+beforeEach(() => {
+  home = mkdtempSync(join(tmpdir(), "fpai-otel-sdk-"));
+  previousHome = process.env.FAILPROOFAI_HOME;
+  process.env.FAILPROOFAI_HOME = home;
+});
+afterEach(() => {
+  uninstrument("otel");
+  setStrict(null);
+  if (previousHome === undefined) delete process.env.FAILPROOFAI_HOME;
+  else process.env.FAILPROOFAI_HOME = previousHome;
+  rmSync(home, { recursive: true, force: true });
+});
+function files() { return readdirSync(join(home, "state/spool-otlp")); }
+function body(name: string) {
+  const text = readFileSync(join(home, "state/spool-otlp", name), "utf8");
+  const split = text.indexOf("\n");
+  expect(JSON.parse(text.slice(0, split))).toEqual({
+    path: "/v1/traces", content_type: "application/json", encoding: null,
+  });
+  return JSON.parse(text.slice(split + 1)) as { resourceSpans: Array<{
+    resource: { attributes: unknown[] };
+    scopeSpans: Array<{ scope: { name: string }; spans: Array<Record<string, unknown>> }>;
+  }> };
+}
+
+describe("OTLP/JSON SpanExporter", () => {
+  it("exports real ended spans, links, events, precise nanos, status and typed attributes durably without network", async () => {
+    const exporter = new OtelSpanExporter();
+    const provider = new BasicTracerProvider({ spanProcessors: [new SimpleSpanProcessor(exporter)] });
+    const tracer = provider.getTracer("test-scope", "1.0");
+    const parent = tracer.startSpan("agent", { startTime: [1780000000, 123], attributes: { "gen_ai.operation.name": "invoke_agent" } });
+    const child = tracer.startSpan("chat", {
+      startTime: [1780000000, 456], kind: SpanKind.CLIENT,
+      attributes: { "gen_ai.operation.name": "chat", count: 42, enabled: true, decimal: 1.5, values: ["a", "b"] },
+      links: [{ context: parent.spanContext(), attributes: { linked: true } }],
+    }, trace.setSpanContext(ROOT_CONTEXT, parent.spanContext()));
+    child.addEvent("prompt", { text: "hello" }, [1780000000, 789]);
+    child.setStatus({ code: SpanStatusCode.ERROR, message: "failed" });
+    child.end([1780000001, 12]); parent.end([1780000001, 13]);
+    await provider.forceFlush();
+    expect(files()).toHaveLength(2);
+    const spans = files().flatMap(name => body(name).resourceSpans.flatMap(r => r.scopeSpans.flatMap(s => s.spans)));
+    const output = spans.find(span => span.name === "chat")!;
+    expect(output).toMatchObject({
+      traceId: child.spanContext().traceId, spanId: child.spanContext().spanId,
+      parentSpanId: parent.spanContext().spanId, kind: 3,
+      startTimeUnixNano: "1780000000000000456", endTimeUnixNano: "1780000001000000012",
+      status: { code: 2, message: "failed" },
+      events: [{ name: "prompt", timeUnixNano: "1780000000000000789" }],
+      links: [{ traceId: parent.spanContext().traceId, spanId: parent.spanContext().spanId }],
+    });
+    expect(output.attributes).toContainEqual({ key: "count", value: { intValue: "42" } });
+    expect(output.attributes).toContainEqual({ key: "values", value: { arrayValue: { values: [{ stringValue: "a" }, { stringValue: "b" }] } } });
+    for (const name of files()) {
+      expect(name).toMatch(/^otlp-sdk-.*\.jsonl$/);
+      expect(statSync(join(home, "state/spool-otlp", name)).mode & 0o777).toBe(0o600);
+    }
+    await provider.shutdown();
+  });
+
+  it("reports disk and post-shutdown failures through the callback, once", async () => {
+    const file = join(home, "not-a-directory");
+    writeFileSync(file, "x");
+    const exporter = new OtelSpanExporter({ spoolDir: file });
+    const provider = new BasicTracerProvider();
+    const span = provider.getTracer("test").startSpan("test");
+    span.end();
+    const results: number[] = [];
+    exporter.export([span as unknown as ReadableSpan], result => results.push(result.code));
+    await exporter.shutdown();
+    exporter.export([], result => results.push(result.code));
+    expect(results).toEqual([1, 1]);
+    await provider.shutdown();
+  });
+
+  it("splits an export above 8 MiB into complete bounded requests", async () => {
+    const provider = new BasicTracerProvider({ spanLimits: { attributeValueLengthLimit: 10_000_000 } });
+    const span = provider.getTracer("test").startSpan("big", { attributes: { content: "x".repeat(4 * 1024 * 1024) } });
+    span.end();
+    const results: number[] = [];
+    new OtelSpanExporter().export([span as unknown as ReadableSpan, span as unknown as ReadableSpan], result => results.push(result.code));
+    expect(results).toEqual([0]);
+    expect(files()).toHaveLength(2);
+    for (const name of files()) expect(body(name).resourceSpans).toHaveLength(1);
+    await provider.shutdown();
+  });
+
+  it("instrument('otel') adds one gated processor and leaves other exporters unchanged", async () => {
+    setStrict(true);
+    const processors: SpanProcessor[] = [];
+    expect(await instrument("otel", { spanProcessors: processors })).toEqual(["otel"]);
+    expect(await instrument("otel", { spanProcessors: processors })).toEqual([]);
+    const observed: string[] = [];
+    const existing: SpanProcessor = {
+      onStart() {}, onEnd(span) { observed.push(span.name); },
+      forceFlush: () => Promise.resolve(), shutdown: () => Promise.resolve(),
+    };
+    const provider = new BasicTracerProvider({ spanProcessors: [existing, ...processors] });
+    const tracer = provider.getTracer("app");
+    tracer.startSpan("before").end();
+    await provider.forceFlush();
+    expect(files()).toHaveLength(1);
+    expect(activeFrameworks()).toContain("otel");
+    expect(uninstrument("otel")).toEqual(["otel"]);
+    tracer.startSpan("after").end();
+    await provider.forceFlush();
+    expect(files()).toHaveLength(1);
+    expect(observed).toEqual(["before", "after"]);
+    expect(processors).toHaveLength(0);
+    await provider.shutdown();
+  });
+});

package/.next/standalone/server.js

@@ -9,7 +9,7 @@ const currentPort = parseInt(process.env.PORT, 10) || 3000
 const hostname = process.env.HOSTNAME || '0.0.0.0'
 
 let keepAliveTimeout = parseInt(process.env.KEEP_ALIVE_TIMEOUT, 10)
-const nextConfig = {"env":{"NEXT_PUBLIC_APP_VERSION":"1.0.10"},"typescript":{"ignoreBuildErrors":false},"typedRoutes":false,"distDir":"./.next","cleanDistDir":true,"assetPrefix":"","cacheMaxMemorySize":52428800,"configOrigin":"next.config.ts","useFileSystemPublicRoutes":true,"generateEtags":true,"pageExtensions":["tsx","ts","jsx","js"],"instrumentationClientInject":[],"poweredByHeader":true,"compress":true,"images":{"deviceSizes":[640,750,828,1080,1200,1920,2048,3840],"imageSizes":[32,48,64,96,128,256,384],"path":"/_next/image","loader":"default","loaderFile":"","domains":[],"disableStaticImages":false,"minimumCacheTTL":14400,"formats":["image/webp"],"maximumRedirects":3,"maximumResponseBody":50000000,"dangerouslyAllowLocalIP":false,"dangerouslyAllowSVG":false,"contentSecurityPolicy":"script-src 'none'; frame-src 'none'; sandbox;","contentDispositionType":"attachment","localPatterns":[{"pathname":"**","search":""}],"remotePatterns":[],"qualities":[75],"unoptimized":true,"customCacheHandler":false},"devIndicators":{"position":"bottom-left"},"onDemandEntries":{"maxInactiveAge":60000,"pagesBufferLength":5},"basePath":"","sassOptions":{},"trailingSlash":false,"i18n":null,"productionBrowserSourceMaps":false,"excludeDefaultMomentLocales":true,"reactProductionProfiling":false,"reactStrictMode":null,"reactMaxHeadersLength":6000,"httpAgentOptions":{"keepAlive":true},"logging":{"serverFunctions":true,"browserToTerminal":"warn"},"compiler":{},"expireTime":31536000,"staticPageGenerationTimeout":60,"output":"standalone","modularizeImports":{"@mui/icons-material":{"transform":"@mui/icons-material/{{member}}"},"lodash":{"transform":"lodash/{{member}}"}},"outputFileTracingRoot":"/home/runner/work/failproofai/failproofai","enablePrerenderSourceMaps":true,"cacheComponents":false,"cacheLife":{"default":{"stale":300,"revalidate":900,"expire":4294967294},"seconds":{"stale":30,"revalidate":1,"expire":60},"minutes":{"stale":300,"revalidate":60,"expire":3600},"hours":{"stale":300,"revalidate":3600,"expire":86400},"days":{"stale":300,"revalidate":86400,"expire":604800},"weeks":{"stale":300,"revalidate":604800,"expire":2592000},"max":{"stale":300,"revalidate":2592000,"expire":31536000}},"cacheHandlers":{},"experimental":{"appNewScrollHandler":true,"coldCacheBadge":false,"devValidationWorker":true,"useSkewCookie":false,"cssChunking":true,"multiZoneDraftMode":false,"appNavFailHandling":false,"prerenderEarlyExit":true,"serverMinification":true,"linkNoTouchStart":false,"caseSensitiveRoutes":false,"cachedNavigations":false,"dynamicOnHover":false,"useOffline":false,"varyParams":true,"optimisticRouting":true,"instrumentationClientRouterTransitionEvents":false,"prefetchInlining":{"maxSize":2048,"maxBundleSize":10240},"preloadEntriesOnStart":true,"clientRouterFilter":true,"clientRouterFilterRedirects":false,"fetchCacheKeyPrefix":"","proxyPrefetch":"flexible","optimisticClientCache":true,"manualClientBasePath":false,"cpus":3,"memoryBasedWorkersCount":false,"imgOptConcurrency":null,"imgOptOperationCache":null,"imgOptTimeoutInSeconds":7,"imgOptMaxInputPixels":268402689,"imgOptSequentialRead":null,"isrFlushToDisk":true,"workerThreads":false,"optimizeCss":false,"nextScriptWorkers":false,"scrollRestoration":false,"externalDir":false,"devMemoryThresholdRestart":true,"disableOptimizedLoading":false,"gzipSize":true,"craCompat":false,"esmExternals":true,"fullySpecified":false,"swcTraceProfiling":false,"forceSwcTransforms":false,"requestInsights":false,"largePageDataBytes":128000,"typedEnv":false,"parallelServerCompiles":false,"parallelServerBuildTraces":false,"ppr":false,"authInterrupts":false,"webpackMemoryOptimizations":false,"optimizeServerReact":true,"strictRouteTypes":false,"useTypeScriptCli":true,"removeUncaughtErrorAndRejectionListeners":false,"validateRSCRequestHeaders":true,"staleTimes":{"dynamic":0,"static":300},"reactDebugChannel":true,"serverComponentsHmrCache":true,"serverComponentsHmrCancellation":false,"staticGenerationMaxConcurrency":8,"staticGenerationMinPagesPerWorker":25,"transitionIndicator":false,"gestureTransition":false,"inlineCss":false,"useCache":false,"globalNotFound":false,"browserDebugInfoInTerminal":"warn","lockDistDir":true,"proxyClientMaxBodySize":10485760,"hideLogsAfterAbort":false,"mcpServer":true,"turbopackFileSystemCacheForDev":true,"turbopackFileSystemCacheForBuild":true,"turbopackInferModuleSideEffects":true,"turbopackPluginRuntimeStrategy":"childProcesses","turbopackMemoryEvictionMode":"auto","optimizePackageImports":["lucide-react","date-fns","lodash-es","ramda","antd","react-bootstrap","ahooks","@ant-design/icons","@headlessui/react","@headlessui-float/react","@heroicons/react/20/solid","@heroicons/react/24/solid","@heroicons/react/24/outline","@visx/visx","@tremor/react","rxjs","@mui/material","@mui/icons-material","recharts","react-use","effect","@effect/schema","@effect/platform","@effect/platform-node","@effect/platform-browser","@effect/platform-bun","@effect/sql","@effect/sql-mssql","@effect/sql-mysql2","@effect/sql-pg","@effect/sql-sqlite-node","@effect/sql-sqlite-bun","@effect/sql-sqlite-wasm","@effect/sql-sqlite-react-native","@effect/rpc","@effect/rpc-http","@effect/typeclass","@effect/experimental","@effect/opentelemetry","@material-ui/core","@material-ui/icons","@tabler/icons-react","mui-core","react-icons/ai","react-icons/bi","react-icons/bs","react-icons/cg","react-icons/ci","react-icons/di","react-icons/fa","react-icons/fa6","react-icons/fc","react-icons/fi","react-icons/gi","react-icons/go","react-icons/gr","react-icons/hi","react-icons/hi2","react-icons/im","react-icons/io","react-icons/io5","react-icons/lia","react-icons/lib","react-icons/lu","react-icons/md","react-icons/pi","react-icons/ri","react-icons/rx","react-icons/si","react-icons/sl","react-icons/tb","react-icons/tfi","react-icons/ti","react-icons/vsc","react-icons/wi"],"useCacheTimeout":54,"instantInsights":{"validationLevel":"warning"},"trustHostHeader":false,"isExperimentalCompile":false},"htmlLimitedBots":"[\\w-]+-Google|Google-[\\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight","bundlePagesRouterDependencies":false,"configFileName":"next.config.ts","outputFileTracingExcludes":{"*":["node_modules/@img/**","node_modules/sharp/**"]},"turbopack":{"root":"/home/runner/work/failproofai/failproofai"},"repoRoot":"/home/runner/work/failproofai/failproofai","distDirRoot":".next"}
+const nextConfig = {"env":{"NEXT_PUBLIC_APP_VERSION":"1.0.11-beta.1"},"typescript":{"ignoreBuildErrors":false},"typedRoutes":false,"distDir":"./.next","cleanDistDir":true,"assetPrefix":"","cacheMaxMemorySize":52428800,"configOrigin":"next.config.ts","useFileSystemPublicRoutes":true,"generateEtags":true,"pageExtensions":["tsx","ts","jsx","js"],"instrumentationClientInject":[],"poweredByHeader":true,"compress":true,"images":{"deviceSizes":[640,750,828,1080,1200,1920,2048,3840],"imageSizes":[32,48,64,96,128,256,384],"path":"/_next/image","loader":"default","loaderFile":"","domains":[],"disableStaticImages":false,"minimumCacheTTL":14400,"formats":["image/webp"],"maximumRedirects":3,"maximumResponseBody":50000000,"dangerouslyAllowLocalIP":false,"dangerouslyAllowSVG":false,"contentSecurityPolicy":"script-src 'none'; frame-src 'none'; sandbox;","contentDispositionType":"attachment","localPatterns":[{"pathname":"**","search":""}],"remotePatterns":[],"qualities":[75],"unoptimized":true,"customCacheHandler":false},"devIndicators":{"position":"bottom-left"},"onDemandEntries":{"maxInactiveAge":60000,"pagesBufferLength":5},"basePath":"","sassOptions":{},"trailingSlash":false,"i18n":null,"productionBrowserSourceMaps":false,"excludeDefaultMomentLocales":true,"reactProductionProfiling":false,"reactStrictMode":null,"reactMaxHeadersLength":6000,"httpAgentOptions":{"keepAlive":true},"logging":{"serverFunctions":true,"browserToTerminal":"warn"},"compiler":{},"expireTime":31536000,"staticPageGenerationTimeout":60,"output":"standalone","modularizeImports":{"@mui/icons-material":{"transform":"@mui/icons-material/{{member}}"},"lodash":{"transform":"lodash/{{member}}"}},"outputFileTracingRoot":"/home/runner/work/failproofai/failproofai","enablePrerenderSourceMaps":true,"cacheComponents":false,"cacheLife":{"default":{"stale":300,"revalidate":900,"expire":4294967294},"seconds":{"stale":30,"revalidate":1,"expire":60},"minutes":{"stale":300,"revalidate":60,"expire":3600},"hours":{"stale":300,"revalidate":3600,"expire":86400},"days":{"stale":300,"revalidate":86400,"expire":604800},"weeks":{"stale":300,"revalidate":604800,"expire":2592000},"max":{"stale":300,"revalidate":2592000,"expire":31536000}},"cacheHandlers":{},"experimental":{"appNewScrollHandler":true,"coldCacheBadge":false,"devValidationWorker":true,"useSkewCookie":false,"cssChunking":true,"multiZoneDraftMode":false,"appNavFailHandling":false,"prerenderEarlyExit":true,"serverMinification":true,"linkNoTouchStart":false,"caseSensitiveRoutes":false,"cachedNavigations":false,"dynamicOnHover":false,"useOffline":false,"varyParams":true,"optimisticRouting":true,"instrumentationClientRouterTransitionEvents":false,"prefetchInlining":{"maxSize":2048,"maxBundleSize":10240},"preloadEntriesOnStart":true,"clientRouterFilter":true,"clientRouterFilterRedirects":false,"fetchCacheKeyPrefix":"","proxyPrefetch":"flexible","optimisticClientCache":true,"manualClientBasePath":false,"cpus":3,"memoryBasedWorkersCount":false,"imgOptConcurrency":null,"imgOptOperationCache":null,"imgOptTimeoutInSeconds":7,"imgOptMaxInputPixels":268402689,"imgOptSequentialRead":null,"isrFlushToDisk":true,"workerThreads":false,"optimizeCss":false,"nextScriptWorkers":false,"scrollRestoration":false,"externalDir":false,"devMemoryThresholdRestart":true,"disableOptimizedLoading":false,"gzipSize":true,"craCompat":false,"esmExternals":true,"fullySpecified":false,"swcTraceProfiling":false,"forceSwcTransforms":false,"requestInsights":false,"largePageDataBytes":128000,"typedEnv":false,"parallelServerCompiles":false,"parallelServerBuildTraces":false,"ppr":false,"authInterrupts":false,"webpackMemoryOptimizations":false,"optimizeServerReact":true,"strictRouteTypes":false,"useTypeScriptCli":true,"removeUncaughtErrorAndRejectionListeners":false,"validateRSCRequestHeaders":true,"staleTimes":{"dynamic":0,"static":300},"reactDebugChannel":true,"serverComponentsHmrCache":true,"serverComponentsHmrCancellation":false,"staticGenerationMaxConcurrency":8,"staticGenerationMinPagesPerWorker":25,"transitionIndicator":false,"gestureTransition":false,"inlineCss":false,"useCache":false,"globalNotFound":false,"browserDebugInfoInTerminal":"warn","lockDistDir":true,"proxyClientMaxBodySize":10485760,"hideLogsAfterAbort":false,"mcpServer":true,"turbopackFileSystemCacheForDev":true,"turbopackFileSystemCacheForBuild":true,"turbopackInferModuleSideEffects":true,"turbopackPluginRuntimeStrategy":"childProcesses","turbopackMemoryEvictionMode":"auto","optimizePackageImports":["lucide-react","date-fns","lodash-es","ramda","antd","react-bootstrap","ahooks","@ant-design/icons","@headlessui/react","@headlessui-float/react","@heroicons/react/20/solid","@heroicons/react/24/solid","@heroicons/react/24/outline","@visx/visx","@tremor/react","rxjs","@mui/material","@mui/icons-material","recharts","react-use","effect","@effect/schema","@effect/platform","@effect/platform-node","@effect/platform-browser","@effect/platform-bun","@effect/sql","@effect/sql-mssql","@effect/sql-mysql2","@effect/sql-pg","@effect/sql-sqlite-node","@effect/sql-sqlite-bun","@effect/sql-sqlite-wasm","@effect/sql-sqlite-react-native","@effect/rpc","@effect/rpc-http","@effect/typeclass","@effect/experimental","@effect/opentelemetry","@material-ui/core","@material-ui/icons","@tabler/icons-react","mui-core","react-icons/ai","react-icons/bi","react-icons/bs","react-icons/cg","react-icons/ci","react-icons/di","react-icons/fa","react-icons/fa6","react-icons/fc","react-icons/fi","react-icons/gi","react-icons/go","react-icons/gr","react-icons/hi","react-icons/hi2","react-icons/im","react-icons/io","react-icons/io5","react-icons/lia","react-icons/lib","react-icons/lu","react-icons/md","react-icons/pi","react-icons/ri","react-icons/rx","react-icons/si","react-icons/sl","react-icons/tb","react-icons/tfi","react-icons/ti","react-icons/vsc","react-icons/wi"],"useCacheTimeout":54,"instantInsights":{"validationLevel":"warning"},"trustHostHeader":false,"isExperimentalCompile":false},"htmlLimitedBots":"[\\w-]+-Google|Google-[\\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight","bundlePagesRouterDependencies":false,"configFileName":"next.config.ts","outputFileTracingExcludes":{"*":["node_modules/@img/**","node_modules/sharp/**"]},"turbopack":{"root":"/home/runner/work/failproofai/failproofai"},"repoRoot":"/home/runner/work/failproofai/failproofai","distDirRoot":".next"}
 
 process.env.__NEXT_PRIVATE_STANDALONE_CONFIG = JSON.stringify(nextConfig)