feat(deepagents): add SDK version metadata to agent traces

.changeset/sdk-trace-metadata.md

@@ -0,0 +1,5 @@
+---
+"deepagents": patch
+---
+
+feat(deepagents): Add SDK version metadata to agent traces

libs/deepagents/src/agent.ts

@@ -40,6 +40,12 @@ import type {
 import type * as _messages from "@langchain/core/messages";
 import type * as _Command from "@langchain/langgraph";
 
+/**
+ * SDK version injected at build time by tsdown's `define` option.
+ * Falls back to "unknown" during tests or when not built via tsdown.
+ */
+declare const __SDK_VERSION__: string;
+
 const BASE_PROMPT = `In order to complete the objective that the user asks of you, you have access to a number of standard tools.`;
 
 /**
@@ -304,7 +310,13 @@ export function createDeepAgent<
     checkpointer,
     store,
     name,
-  }).withConfig({ recursionLimit: 10_000 });
+  }).withConfig({
+    recursionLimit: 10_000,
+    metadata: {
+      sdk: "deepagents-js",
+      sdk_version: __SDK_VERSION__,
+    },
+  });
 
   /**
    * Combine custom middleware with flattened subagent middleware for complete type inference

libs/deepagents/tsdown.config.ts

@@ -1,8 +1,13 @@
 import { defineConfig } from "tsdown";
+import { readFileSync } from "node:fs";
 
 // Mark all node_modules as external since this is a library
 const external = [/^[^./]/];
 
+const { version } = JSON.parse(
+  readFileSync(new URL("./package.json", import.meta.url), "utf-8"),
+);
+
 export default defineConfig([
   {
     entry: ["./src/index.ts"],
@@ -13,6 +18,9 @@ export default defineConfig([
     outDir: "dist",
     outExtensions: () => ({ js: ".js" }),
     external,
+    define: {
+      __SDK_VERSION__: JSON.stringify(version),
+    },
   },
   {
     entry: ["./src/index.ts"],
@@ -23,5 +31,8 @@ export default defineConfig([
     outDir: "dist",
     outExtensions: () => ({ js: ".cjs" }),
     external,
+    define: {
+      __SDK_VERSION__: JSON.stringify(version),
+    },
   },
 ]);

libs/deepagents/vitest.config.ts

@@ -1,4 +1,5 @@
 import path from "node:path";
+import { readFileSync } from "node:fs";
 import {
   configDefaults,
   defineConfig,
@@ -9,8 +10,15 @@ import dotenv from "dotenv";
 // Load .env from workspace root (two levels up from libs/deepagents)
 dotenv.config({ path: path.resolve(__dirname, "../../.env") });
 
+const { version } = JSON.parse(
+  readFileSync(path.resolve(__dirname, "package.json"), "utf-8"),
+);
+
 export default defineConfig((env) => {
   const common: ViteUserConfigExport = {
+    define: {
+      __SDK_VERSION__: JSON.stringify(version),
+    },
     test: {
       environment: "node",
       hideSkippedTests: true,
@@ -27,6 +35,7 @@ export default defineConfig((env) => {
 
   if (env.mode === "int") {
     return {
+      define: common.define,
       test: {
         ...common.test,
         globals: false,
@@ -39,6 +48,7 @@ export default defineConfig((env) => {
   }
 
   return {
+    define: common.define,
     test: {
       ...common.test,
       include: ["src/**/*.test.ts"],