docs: add telemetry.dev instrumentation integration

apps/docs/lib/integrations/data.ts

@@ -2147,6 +2147,56 @@ export default defineInstrumentation({
 \`\`\``,
     configure: `Create a write key in the Raindrop dashboard and expose it as \`RAINDROP_WRITE_KEY\`. Raindrop's Vercel AI SDK integration picks up the AI SDK spans eve emits on every turn. See the [instrumentation guide](/docs/guides/instrumentation) for the trace hierarchy and the \`recordInputs\`/\`recordOutputs\` controls.`,
   },
+  "telemetry-dev": {
+    logo: "telemetry-dev",
+    docsHref: "/docs/guides/instrumentation",
+    keywords: ["otel", "opentelemetry", "tracing", "observability", "tokens", "cost", "llm"],
+    install: `Add the telemetry.dev integration from eve's registry:
+
+\`\`\`bash
+eve add instrumentation/telemetry-dev
+\`\`\``,
+
+    quickStart: `eve installs an instrumentation file that registers telemetry.dev as the OpenTelemetry provider and a hook that emits lifecycle logs for sessions, turns, steps, tool results, and subagent calls:
+
+\`\`\`ts
+// agent/instrumentation.ts
+import { telemetryDevInstrumentation } from "@telemetry-dev/eve";
+import { defineInstrumentation } from "eve/instrumentation";
+
+export default defineInstrumentation(telemetryDevInstrumentation());
+\`\`\`
+
+\`\`\`ts
+// agent/hooks/telemetry-dev.ts
+import { telemetryDevHook } from "@telemetry-dev/eve";
+import { defineHook } from "eve/hooks";
+
+export default defineHook(telemetryDevHook());
+\`\`\`
+
+telemetry.dev also ingests OTLP directly, so you can skip the package and point \`@vercel/otel\` at its endpoint instead — either setup works:
+
+\`\`\`ts
+// agent/instrumentation.ts
+import { OTLPHttpProtoTraceExporter, registerOTel } from "@vercel/otel";
+import { defineInstrumentation } from "eve/instrumentation";
+
+export default defineInstrumentation({
+  setup: ({ agentName }) =>
+    registerOTel({
+      serviceName: agentName,
+      traceExporter: new OTLPHttpProtoTraceExporter({
+        url: "https://ingest.telemetry.dev/v1/traces",
+        headers: {
+          Authorization: \`Bearer \${process.env.TELEMETRY_DEV_API_KEY}\`,
+        },
+      }),
+    }),
+});
+\`\`\``,
+    configure: `Create an ingest API key in the [telemetry.dev](https://telemetry.dev) dashboard and expose it as \`TELEMETRY_DEV_API_KEY\`; without the key the packaged integration is a no-op. Traces and lifecycle logs land in your telemetry.dev project joined by \`gen_ai.conversation.id\`, with tokens, cost, and latency attached to every turn. See the [instrumentation guide](/docs/guides/instrumentation) for the trace hierarchy and the \`recordInputs\`/\`recordOutputs\` controls.`,
+  },
   jaeger: {
     logo: "jaeger",
     docsHref: "/docs/guides/instrumentation",

apps/docs/lib/integrations/logos.tsx

@@ -686,6 +686,47 @@ export const raindropLogo = (props: LogoProps) => (
   </svg>
 );
 
+export const telemetryDevLogo = (props: LogoProps) => (
+  <svg fill="none" viewBox="0 0 114.6 115" xmlns="http://www.w3.org/2000/svg" {...props}>
+    <path
+      d="M28.3 17.8C26.8 17.8 26.1 15.9 27.4 14.9C34.3 10.6 43.7 5.8 57.3 5.8C70.9 5.8 80.3 10.6 87.2 14.9C88.5 15.9 87.8 17.8 86.3 17.8Z"
+      fill="currentColor"
+    />
+    <path
+      d="M19.8 22.9H94.8Q96.3 22.9 97.04 24.2Q100.1 27.95 101.76 32.5Q102.5 33.8 101 33.8H77.3C71.3 33.8 68.6 32 65.8 31C63 30 61.4 29.2 57.3 29.2C53.2 29.2 51.6 30 48.8 31C46 32 43.3 33.8 37.3 33.8H13.6Q12.1 33.8 12.84 32.5Q14.5 27.95 17.56 24.2Q18.3 22.9 19.8 22.9Z"
+      fill="currentColor"
+    />
+    <path
+      d="M34.2 38.8C35.6 38.8 36.3 40.3 35.6 41.4C34.7 42.6 33.4 45.4 32.9 46.9C32.4 48.3 30.8 49.3 29.9 49.3H7.8C7 49.3 6.3 48.5 6.4 47.2C6.7 45.2 7.4 42.1 8.1 40C8.4 39.35 9.1 38.8 9.55 38.8Z"
+      fill="currentColor"
+    />
+    <path
+      d="M80.4 38.8H105.05C105.75 38.8 106.2 39.35 106.5 40C107.2 42.1 107.9 45.2 108.2 47.2C108.3 48.5 107.6 49.3 106.8 49.3H84.7C83.8 49.3 82.2 48.3 81.7 46.9C81.2 45.4 79.9 42.6 79 41.4C78.3 40.3 79 38.8 80.4 38.8Z"
+      fill="currentColor"
+    />
+    <path
+      d="M6.8 54.5H107.8Q109.3 54.5 109.3 56L109.3 61.9Q109.3 63.4 107.8 63.4H6.8Q5.3 63.4 5.3 61.9L5.3 56Q5.3 54.5 6.8 54.5Z"
+      fill="currentColor"
+    />
+    <path
+      d="M8.3 68.3H106.3C107.5 68.3 107.97 69.36 107.6 70.5L106.25 74.7C105.88 75.84 106.25 76.1 105.05 76.1H9.55C8.35 76.1 8.72 75.84 8.35 74.7L7 70.5C6.63 69.36 7.1 68.3 8.3 68.3Z"
+      fill="currentColor"
+    />
+    <path
+      d="M14 81.5H100.6C101.8 81.5 102.56 83.35 101.9 84.35L99.55 87.9C98.89 88.9 99.65 88.7 98.45 88.7H16.15C14.95 88.7 15.71 88.9 15.05 87.9L12.7 84.35C12.04 83.35 12.8 81.5 14 81.5Z"
+      fill="currentColor"
+    />
+    <path
+      d="M24.2 93.5H90.4C91.6 93.5 92.27 95.83 91.35 96.6L88.7 98.8C87.78 99.57 88.9 99.3 87.7 99.3H26.9C25.7 99.3 26.82 99.57 25.9 98.8L23.25 96.6C22.33 95.83 23 93.5 24.2 93.5Z"
+      fill="currentColor"
+    />
+    <path
+      d="M45.6 104.5H69C70.7 104.5 71.2 107.2 69.3 107.5C66 108.3 61.9 108.9 57.3 108.9C52.7 108.9 48.6 108.3 45.3 107.5C43.4 107.2 43.9 104.5 45.6 104.5Z"
+      fill="currentColor"
+    />
+  </svg>
+);
+
 export const logos = {
   eve: eveLogo,
   web: webLogo,
@@ -708,6 +749,7 @@ export const logos = {
   braintrust: braintrustLogo,
   jaeger: jaegerLogo,
   raindrop: raindropLogo,
+  "telemetry-dev": telemetryDevLogo,
   kernel: kernelLogo,
   upstash: upstashLogo,
   arcana: arcanaLogo,

apps/docs/package.json

@@ -73,6 +73,7 @@
     "@posthog/ai": "7.19.6",
     "@resend/chat-sdk-adapter": "0.2.2",
     "@tailwindcss/postcss": "4.3.0",
+    "@telemetry-dev/eve": "0.1.0",
     "@types/mdx": "2.0.13",
     "@types/node": "catalog:",
     "@types/pngjs": "^6.0.5",

apps/docs/registry.json

@@ -2184,6 +2184,28 @@
         }
       ]
     },
+    {
+      "name": "instrumentation/telemetry-dev",
+      "type": "registry:item",
+      "title": "telemetry.dev",
+      "description": "Send agent traces to telemetry.dev with tokens, cost, and latency on every turn.",
+      "dependencies": ["@telemetry-dev/eve"],
+      "envVars": {
+        "TELEMETRY_DEV_API_KEY": ""
+      },
+      "files": [
+        {
+          "path": "registry/instrumentation/telemetry-dev.ts",
+          "type": "registry:file",
+          "target": "agent/instrumentation.ts"
+        },
+        {
+          "path": "registry/instrumentation/telemetry-dev-hook.ts",
+          "type": "registry:file",
+          "target": "agent/hooks/telemetry-dev.ts"
+        }
+      ]
+    },
     {
       "name": "instrumentation/jaeger",
       "type": "registry:item",

apps/docs/registry/instrumentation/telemetry-dev-hook.ts

@@ -0,0 +1,4 @@
+import { telemetryDevHook } from "@telemetry-dev/eve";
+import { defineHook } from "eve/hooks";
+
+export default defineHook(telemetryDevHook());

apps/docs/registry/instrumentation/telemetry-dev.ts

@@ -0,0 +1,4 @@
+import { telemetryDevInstrumentation } from "@telemetry-dev/eve";
+import { defineInstrumentation } from "eve/instrumentation";
+
+export default defineInstrumentation(telemetryDevInstrumentation());

apps/docs/scripts/validate-instrumentation-registry.ts

@@ -25,6 +25,7 @@ const registrySlugsByCatalogSlug: Readonly<Record<string, string>> = {
   "honeycomb-instrumentation": "honeycomb",
   arize: "arize",
   raindrop: "raindrop",
+  "telemetry-dev": "telemetry-dev",
   jaeger: "jaeger",
 };
 
@@ -61,6 +62,14 @@ for (const item of items) {
           },
         ]
       : []),
+    ...(slug === "telemetry-dev"
+      ? [
+          {
+            path: "registry/instrumentation/telemetry-dev-hook.ts",
+            target: "agent/hooks/telemetry-dev.ts",
+          },
+        ]
+      : []),
   ];
   const actualFiles = item.files?.map(({ path, target }) => ({ path, target }));
   if (JSON.stringify(actualFiles) !== JSON.stringify(expectedFiles)) {

packages/eve-catalog/src/index.ts

@@ -863,6 +863,13 @@ export const INTEGRATIONS: readonly IntegrationEntry[] = [
     tagline: "Send agent traces to Raindrop to detect and debug AI product issues.",
     surfaces: { scaffoldable: false, registry: true, gallery: true },
   },
+  {
+    slug: "telemetry-dev",
+    name: "telemetry.dev",
+    kind: "instrumentation",
+    tagline: "Send agent traces to telemetry.dev with tokens, cost, and latency on every turn.",
+    surfaces: { scaffoldable: false, gallery: true },
+  },
   {
     slug: "jaeger",
     name: "Jaeger",