@braintrust/temporal 0.1.0 → 0.1.1-rc.0

package/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2023 Braintrust Data LLC
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -33,9 +33,14 @@ const client = new Client({
   plugins: [plugin],
 });
 
+// ESM-safe resolution (recommended for ESM projects):
+const workflowsUrl = new URL("./workflows", import.meta.url);
+const workflowsPath = workflowsUrl.pathname;
+// CommonJS resolution (existing/example usage):
+// const workflowsPath = require.resolve("./workflows");
 const worker = await Worker.create({
   taskQueue: "my-queue",
-  workflowsPath: require.resolve("./workflows"),
+  workflowsPath: workflowsPath,
   activities,
   plugins: [plugin],
 });

package/dist/chunk-NKP2TK53.mjs

@@ -0,0 +1,31 @@
+// src/utils.ts
+var BRAINTRUST_SPAN_HEADER = "_braintrust-span";
+var BRAINTRUST_WORKFLOW_SPAN_HEADER = "_braintrust-workflow-span";
+var BRAINTRUST_WORKFLOW_SPAN_ID_HEADER = "_braintrust-workflow-span-id";
+function serializeHeaderValue(value) {
+  return {
+    metadata: {
+      encoding: new TextEncoder().encode("json/plain")
+    },
+    data: new TextEncoder().encode(JSON.stringify(value))
+  };
+}
+function deserializeHeaderValue(payload) {
+  if (!payload?.data) {
+    return void 0;
+  }
+  try {
+    const decoded = new TextDecoder().decode(payload.data);
+    return JSON.parse(decoded);
+  } catch {
+    return void 0;
+  }
+}
+
+export {
+  BRAINTRUST_SPAN_HEADER,
+  BRAINTRUST_WORKFLOW_SPAN_HEADER,
+  BRAINTRUST_WORKFLOW_SPAN_ID_HEADER,
+  serializeHeaderValue,
+  deserializeHeaderValue
+};

package/dist/index.js

@@ -233,6 +233,7 @@ function createBraintrustActivityInterceptor(ctx) {
 }
 
 // src/plugin.ts
+var WORKFLOW_INTERCEPTORS_SPEC = "@braintrust/temporal/workflow-interceptors";
 var BraintrustTemporalPlugin = class {
   get name() {
     return "braintrust";
@@ -246,11 +247,14 @@ var BraintrustTemporalPlugin = class {
     const braintrustInterceptor = createBraintrustClientInterceptor();
     let workflow;
     if (Array.isArray(existing)) {
-      workflow = [...existing, braintrustInterceptor];
+      workflow = [
+        ...existing,
+        braintrustInterceptor
+      ];
     } else if (existing) {
       workflow = {
         ...existing,
-        ...braintrustInterceptor
+        calls: [...existing.calls ?? [], () => braintrustInterceptor]
       };
     } else {
       workflow = [braintrustInterceptor];
@@ -273,22 +277,27 @@ var BraintrustTemporalPlugin = class {
     const existingWorkflowModules = options.interceptors?.workflowModules ?? [];
     const existingSinks = options.sinks ?? {};
     const braintrustSinks = createBraintrustSinks();
-    const workflowInterceptorsPath = require.resolve("@braintrust/temporal/workflow-interceptors");
-    return {
+    const workflowModules = [
+      ...existingWorkflowModules,
+      WORKFLOW_INTERCEPTORS_SPEC
+    ];
+    const activityFactories = [
+      ...existingActivityInterceptors,
+      createBraintrustActivityInterceptor
+    ];
+    const result = {
       ...options,
       interceptors: {
         ...options.interceptors,
-        activity: [
-          ...existingActivityInterceptors,
-          createBraintrustActivityInterceptor
-        ],
-        workflowModules: [...existingWorkflowModules, workflowInterceptorsPath]
+        activity: activityFactories,
+        workflowModules
       },
       sinks: {
         ...existingSinks,
         ...braintrustSinks
       }
     };
+    return result;
   }
 };
 function createBraintrustTemporalPlugin() {

package/dist/index.mjs

@@ -1,9 +1,8 @@
 import {
   BRAINTRUST_SPAN_HEADER,
   BRAINTRUST_WORKFLOW_SPAN_ID_HEADER,
-  __require,
   deserializeHeaderValue
-} from "./chunk-KT66NY2E.mjs";
+} from "./chunk-NKP2TK53.mjs";
 
 // src/interceptors.ts
 import { defaultPayloadConverter } from "@temporalio/common";
@@ -188,6 +187,7 @@ function createBraintrustActivityInterceptor(ctx) {
 }
 
 // src/plugin.ts
+var WORKFLOW_INTERCEPTORS_SPEC = "@braintrust/temporal/workflow-interceptors";
 var BraintrustTemporalPlugin = class {
   get name() {
     return "braintrust";
@@ -201,11 +201,14 @@ var BraintrustTemporalPlugin = class {
     const braintrustInterceptor = createBraintrustClientInterceptor();
     let workflow;
     if (Array.isArray(existing)) {
-      workflow = [...existing, braintrustInterceptor];
+      workflow = [
+        ...existing,
+        braintrustInterceptor
+      ];
     } else if (existing) {
       workflow = {
         ...existing,
-        ...braintrustInterceptor
+        calls: [...existing.calls ?? [], () => braintrustInterceptor]
       };
     } else {
       workflow = [braintrustInterceptor];
@@ -228,24 +231,27 @@ var BraintrustTemporalPlugin = class {
     const existingWorkflowModules = options.interceptors?.workflowModules ?? [];
     const existingSinks = options.sinks ?? {};
     const braintrustSinks = createBraintrustSinks();
-    const workflowInterceptorsPath = __require.resolve(
-      "@braintrust/temporal/workflow-interceptors"
-    );
-    return {
+    const workflowModules = [
+      ...existingWorkflowModules,
+      WORKFLOW_INTERCEPTORS_SPEC
+    ];
+    const activityFactories = [
+      ...existingActivityInterceptors,
+      createBraintrustActivityInterceptor
+    ];
+    const result = {
       ...options,
       interceptors: {
         ...options.interceptors,
-        activity: [
-          ...existingActivityInterceptors,
-          createBraintrustActivityInterceptor
-        ],
-        workflowModules: [...existingWorkflowModules, workflowInterceptorsPath]
+        activity: activityFactories,
+        workflowModules
       },
       sinks: {
         ...existingSinks,
         ...braintrustSinks
       }
     };
+    return result;
   }
 };
 function createBraintrustTemporalPlugin() {

package/dist/workflow-interceptors.mjs

@@ -4,7 +4,7 @@ import {
   BRAINTRUST_WORKFLOW_SPAN_ID_HEADER,
   deserializeHeaderValue,
   serializeHeaderValue
-} from "./chunk-KT66NY2E.mjs";
+} from "./chunk-NKP2TK53.mjs";
 
 // src/workflow-interceptors.ts
 import {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@braintrust/temporal",
-  "version": "0.1.0",
+  "version": "0.1.1-rc.0",
   "description": "SDK for integrating Braintrust with Temporal",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -20,12 +20,6 @@
       "require": "./dist/workflow-interceptors.js"
     }
   },
-  "scripts": {
-    "build": "tsup",
-    "watch": "tsup --watch",
-    "clean": "rm -r dist/*",
-    "test": "vitest run"
-  },
   "author": "Braintrust Data Inc.",
   "license": "MIT",
   "devDependencies": {
@@ -35,10 +29,10 @@
     "@temporalio/worker": "^1.14.1",
     "@temporalio/workflow": "^1.14.1",
     "@types/node": "^22.15.21",
-    "braintrust": "workspace:*",
     "tsup": "^8.5.0",
     "typescript": "5.5.4",
-    "vitest": "^2.1.9"
+    "vitest": "^2.1.9",
+    "braintrust": "2.2.0"
   },
   "peerDependencies": {
     "@temporalio/activity": ">=1.11.0",
@@ -67,5 +61,11 @@
     "@temporalio/workflow": {
       "optional": false
     }
+  },
+  "scripts": {
+    "build": "tsup",
+    "watch": "tsup --watch",
+    "clean": "rm -r dist/*",
+    "test": "vitest run"
   }
-}
+}

package/src/index.ts

@@ -24,10 +24,12 @@
  *   plugins: [braintrustPlugin],
  * });
  *
+ * const workflowsUrl = new URL("./workflows", import.meta.url);
+ * const workflowsPath = workflowsUrl.pathname;
  * // Create worker with the plugin
  * const worker = await Worker.create({
  *   taskQueue: "my-queue",
- *   workflowsPath: require.resolve("./workflows"),
+ *   workflowsPath: workflowsPath,
  *   activities,
  *   plugins: [braintrustPlugin],
  * });

package/src/plugin.ts

@@ -1,4 +1,10 @@
-import type { ClientPlugin, ClientOptions } from "@temporalio/client";
+import type {
+  ClientPlugin,
+  ClientOptions,
+  WorkflowClientInterceptor,
+  WorkflowClientInterceptors,
+  WorkflowClientCallsInterceptorFactory,
+} from "@temporalio/client";
 import type { WorkerPlugin, WorkerOptions } from "@temporalio/worker";
 import {
   createBraintrustClientInterceptor,
@@ -6,6 +12,9 @@ import {
 } from "./interceptors";
 import { createBraintrustSinks } from "./sinks";
 
+// Add the workflow interceptor package specifier so the Temporal bundler can include it
+const WORKFLOW_INTERCEPTORS_SPEC = "@braintrust/temporal/workflow-interceptors";
+
 /**
  * A Braintrust plugin for Temporal that automatically instruments
  * workflows and activities with tracing spans.
@@ -53,17 +62,24 @@ export class BraintrustTemporalPlugin implements ClientPlugin, WorkerPlugin {
     const existing = options.interceptors?.workflow;
     const braintrustInterceptor = createBraintrustClientInterceptor();
 
-    // workflow can be an array or an object with named interceptors
-    let workflow: typeof existing;
+    let workflow:
+      | WorkflowClientInterceptors
+      | WorkflowClientInterceptor[]
+      | undefined;
+
     if (Array.isArray(existing)) {
-      workflow = [...existing, braintrustInterceptor];
+      workflow = [
+        ...(existing as WorkflowClientInterceptor[]),
+        braintrustInterceptor,
+      ];
     } else if (existing) {
-      // It's a WorkflowClientInterceptors object, merge our interceptor
+      // It's a WorkflowClientInterceptors object, merge our interceptor into the calls array
       workflow = {
         ...existing,
-        ...braintrustInterceptor,
+        calls: [...(existing.calls ?? []), () => braintrustInterceptor],
       };
     } else {
+      // keep in new array form
       workflow = [braintrustInterceptor];
     }
 
@@ -73,7 +89,7 @@ export class BraintrustTemporalPlugin implements ClientPlugin, WorkerPlugin {
         ...options.interceptors,
         workflow,
       },
-    };
+    } as Omit<ClientOptions, "plugins">;
   }
 
   /**
@@ -88,27 +104,30 @@ export class BraintrustTemporalPlugin implements ClientPlugin, WorkerPlugin {
 
     const braintrustSinks = createBraintrustSinks();
 
-    // Resolve the workflow interceptors module path
-    // This needs to be resolved at runtime to get the actual file path
-    const workflowInterceptorsPath = require.resolve(
-      "@braintrust/temporal/workflow-interceptors",
-    );
+    const workflowModules = [
+      ...existingWorkflowModules,
+      WORKFLOW_INTERCEPTORS_SPEC,
+    ];
 
-    return {
+    const activityFactories = [
+      ...existingActivityInterceptors,
+      createBraintrustActivityInterceptor,
+    ];
+
+    const result: WorkerOptions = {
       ...options,
       interceptors: {
         ...options.interceptors,
-        activity: [
-          ...existingActivityInterceptors,
-          createBraintrustActivityInterceptor,
-        ],
-        workflowModules: [...existingWorkflowModules, workflowInterceptorsPath],
+        activity: activityFactories,
+        workflowModules,
       },
       sinks: {
         ...existingSinks,
         ...braintrustSinks,
       },
     };
+
+    return result;
   }
 }
 

package/examples/temporal/.env.example

@@ -1,2 +0,0 @@
-# Braintrust API key for tracing
-BRAINTRUST_API_KEY=your-api-key-here

package/examples/temporal/Procfile

@@ -1,4 +0,0 @@
-server: temporal server start-dev
-worker1: pnpm run worker
-worker2: pnpm run worker
-worker3: pnpm run worker

package/examples/temporal/README.md

@@ -1,183 +0,0 @@
-# Temporal + Braintrust Tracing Example
-
-This example demonstrates how to integrate Braintrust tracing with Temporal workflows and activities.
-
-## Prerequisites
-
-- [mise](https://mise.jdx.dev/) (recommended) - automatically installs all dependencies
-- OR manually install:
-  - Node.js 20+
-  - `pnpm`
-  - Temporal CLI (`temporal`)
-  - Optional: [`overmind`](https://github.com/DarthSim/overmind) (only if you want to use the included `Procfile`)
-
-### Option 1: Using mise (recommended)
-
-[mise](https://mise.jdx.dev/) will automatically install and manage all required tools (Node.js, Temporal CLI, overmind, and dependencies):
-
-**Install mise:**
-
-```bash
-# macOS/Linux
-curl https://mise.run | sh
-
-# Or using Homebrew
-brew install mise
-```
-
-**Setup and run:**
-
-```bash
-# Copy and configure environment
-cp .env.example .env
-# Edit .env with your BRAINTRUST_API_KEY
-
-# mise will automatically install tools and dependencies
-mise run server  # Start temporal server and workers
-
-# In another terminal:
-mise run workflow  # Run the workflow client
-```
-
-**Available mise tasks:**
-
-```bash
-mise run install   # Install dependencies
-mise run server    # Run temporal server and workers
-mise run workflow  # Run workflow client
-mise run stop      # Stop temporal server and workers
-mise run kill      # Force kill all processes
-```
-
-### Option 2: Manual installation
-
-#### Installing Temporal CLI
-
-The Temporal CLI is required to run the local Temporal server:
-
-**macOS:**
-
-```bash
-brew install temporal
-```
-
-**Linux:**
-
-```bash
-# Using Homebrew
-brew install temporal
-
-# Or using curl
-curl -sSf https://temporal.download/cli.sh | sh
-```
-
-**Windows:**
-
-```powershell
-# Using Scoop
-scoop install temporal
-
-# Or download from releases
-# https://github.com/temporalio/cli/releases
-```
-
-Verify the installation:
-
-```bash
-temporal --version
-```
-
-#### Installing overmind (optional)
-
-Overmind is a process manager that makes it easy to run multiple services together. If you want to use `overmind start` to run everything at once, install it for your platform:
-
-**macOS:**
-
-```bash
-brew install overmind
-```
-
-**Linux:**
-
-```bash
-brew install overmind
-
-# Or download from releases
-# https://github.com/DarthSim/overmind/releases
-```
-
-**Windows:**
-Overmind is not officially supported on Windows. Use the manual approach below instead.
-
-## Setup
-
-```bash
-# Copy and configure environment
-cp .env.example .env
-# Edit .env with your BRAINTRUST_API_KEY
-
-# Install dependencies
-pnpm install
-```
-
-## Running the Example
-
-### Option 1: Using overmind
-
-Start the temporal server and workers together:
-
-```bash
-overmind start
-```
-
-Then in another terminal, run the workflow:
-
-```bash
-pnpm run client
-```
-
-### Option 2: Manual
-
-1. Start the Temporal server:
-
-```bash
-temporal server start-dev
-```
-
-2. Start the worker:
-
-```bash
-pnpm run worker
-```
-
-3. Run the client:
-
-```bash
-pnpm run client
-
-# Or with a signal:
-pnpm run client -- --signal
-```
-
-## What Gets Traced
-
-- **Client span**: Wraps the workflow execution call
-- **Workflow span**: Created via sinks when the workflow starts
-- **Activity spans**: Created for each activity execution with parent linking
-
-The trace hierarchy looks like:
-
-```
-Client span ("example.temporal.workflow")
-  └── Workflow span ("temporal.workflow.simpleWorkflow")
-        └── Activity span ("temporal.activity.addTen")
-        └── Activity span ("temporal.activity.multiplyByTwo")
-        └── Activity span ("temporal.activity.subtractFive")
-```
-
-## How It Works
-
-1. **Client interceptor**: Captures the current Braintrust span context and adds it to workflow headers
-2. **Workflow interceptor**: Extracts parent context from headers and creates a workflow span via sinks
-3. **Sinks**: Allow the workflow isolate to call into Node.js to create spans (with `callDuringReplay: false`)
-4. **Activity interceptor**: Creates spans for each activity, using the workflow span as parent

package/examples/temporal/mise.toml

@@ -1,40 +0,0 @@
-# Mise will automatically read and use .tool-versions files as well as this file.
-[settings]
-experimental=true
-
-[env]
-# See env.example to configure API keys.
-_.file = ".env"
-
-[tools]
-node = "20"
-temporal = "latest"
-overmind = "latest"
-
-[hooks]
-postinstall = "mise run install"
-
-[tasks.install]
-description = "Install dependencies"
-run = "pnpm install --ignore-workspace"
-
-[tasks.server]
-description = "Run temporal server and workers"
-run = "overmind s"
-
-[tasks.workflow]
-description = "Run workflow client"
-run = "pnpm exec ts-node src/client.ts"
-
-[tasks.stop]
-description = "Stop temporal server and workers"
-run = "overmind quit || true"
-
-[tasks.kill]
-description = "Force kill temporal server and workers"
-run = """
-pkill -f 'examples/temporal.*ts-node' 2>/dev/null || true
-pkill -f 'overmind.*temporal' 2>/dev/null || true
-rm -f .overmind.sock
-echo 'Server killed'
-"""

package/examples/temporal/package.json

@@ -1,26 +0,0 @@
-{
-  "name": "temporal-example",
-  "version": "1.0.0",
-  "private": true,
-  "scripts": {
-    "build": "tsc",
-    "worker": "pnpm exec ts-node src/worker.ts",
-    "client": "pnpm exec ts-node src/client.ts"
-  },
-  "dependencies": {
-    "@braintrust/temporal": "^0.1.0",
-    "@temporalio/activity": "^1.11.0",
-    "@temporalio/client": "^1.11.0",
-    "@temporalio/common": "^1.11.0",
-    "@temporalio/worker": "^1.11.0",
-    "@temporalio/workflow": "^1.11.0",
-    "braintrust": "^2.0.0",
-    "uuid": "^9.0.0"
-  },
-  "devDependencies": {
-    "@types/node": "^20.0.0",
-    "@types/uuid": "^9.0.0",
-    "ts-node": "^10.9.0",
-    "typescript": "^5.0.0"
-  }
-}

package/examples/temporal/src/activities.ts

@@ -1,42 +0,0 @@
-import * as braintrust from "braintrust";
-
-export interface TaskInput {
-  value: number;
-}
-
-export async function addTen(input: TaskInput): Promise<number> {
-  console.log(`Adding 10 to ${input.value}`);
-
-  // Test child span within activity
-  const result = await braintrust.traced(
-    async (span) => {
-      span.log({
-        input: { value: input.value, operation: "add", operand: 10 },
-      });
-      await new Promise((resolve) => setTimeout(resolve, 500));
-      const sum = input.value + 10;
-      span.log({ output: sum });
-      return sum;
-    },
-    { name: "compute.addition" },
-  );
-
-  console.log(`Result: ${input.value} + 10 = ${result}`);
-  return result;
-}
-
-export async function multiplyByTwo(input: TaskInput): Promise<number> {
-  console.log(`Multiplying ${input.value} by 2`);
-  await new Promise((resolve) => setTimeout(resolve, 300));
-  const result = input.value * 2;
-  console.log(`Result: ${input.value} * 2 = ${result}`);
-  return result;
-}
-
-export async function subtractFive(input: TaskInput): Promise<number> {
-  console.log(`Subtracting 5 from ${input.value}`);
-  await new Promise((resolve) => setTimeout(resolve, 300));
-  const result = input.value - 5;
-  console.log(`Result: ${input.value} - 5 = ${result}`);
-  return result;
-}

package/examples/temporal/src/client.ts

@@ -1,53 +0,0 @@
-import { Client, Connection } from "@temporalio/client";
-import { v4 as uuid } from "uuid";
-import * as braintrust from "braintrust";
-import { BraintrustTemporalPlugin } from "@braintrust/temporal";
-import { simpleWorkflow } from "./workflows";
-import type { TaskInput } from "./activities";
-
-const TASK_QUEUE = "braintrust-example-task-queue";
-
-async function main() {
-  braintrust.initLogger({ projectName: "temporal-example" });
-
-  const connection = await Connection.connect({
-    address: "localhost:7233",
-  });
-
-  const client = new Client({
-    connection,
-    namespace: "default",
-    plugins: [new BraintrustTemporalPlugin()],
-  });
-
-  const inputData: TaskInput = { value: 5 };
-  const workflowId = `simple-workflow-${uuid().slice(0, 8)}`;
-
-  console.log(`Starting workflow with value: ${inputData.value}`);
-  console.log(`Workflow ID: ${workflowId}`);
-
-  // Wrap in a Braintrust span
-  await braintrust.traced(
-    async (span) => {
-      const handle = await client.workflow.start(simpleWorkflow, {
-        args: [inputData],
-        taskQueue: TASK_QUEUE,
-        workflowId,
-      });
-
-      const result = await handle.result();
-      span.log({ output: result });
-      console.log(`\nResult: ${result}`);
-      console.log(`\nView trace: ${span.link()}`);
-      return result;
-    },
-    { name: "temporal.client.simpleWorkflow" },
-  );
-
-  await braintrust.flush();
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

package/examples/temporal/src/worker.ts

@@ -1,31 +0,0 @@
-import { Worker, NativeConnection } from "@temporalio/worker";
-import * as braintrust from "braintrust";
-import { BraintrustTemporalPlugin } from "@braintrust/temporal";
-import * as activities from "./activities";
-
-const TASK_QUEUE = "braintrust-example-task-queue";
-
-async function main() {
-  braintrust.initLogger({ projectName: "temporal-example" });
-
-  const connection = await NativeConnection.connect({
-    address: "localhost:7233",
-  });
-
-  const worker = await Worker.create({
-    connection,
-    namespace: "default",
-    taskQueue: TASK_QUEUE,
-    workflowsPath: require.resolve("./workflows"),
-    activities,
-    plugins: [new BraintrustTemporalPlugin()],
-  });
-
-  console.log(`Worker started on task queue: ${TASK_QUEUE}`);
-  await worker.run();
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

package/examples/temporal/src/workflows.ts

@@ -1,47 +0,0 @@
-import {
-  proxyActivities,
-  sleep,
-  workflowInfo,
-  defineSignal,
-  setHandler,
-  log,
-} from "@temporalio/workflow";
-import type * as activities from "./activities";
-
-const { addTen, multiplyByTwo, subtractFive } = proxyActivities<
-  typeof activities
->({
-  startToCloseTimeout: "10 seconds",
-});
-
-export const addSignalValue = defineSignal<[number]>("addSignalValue");
-
-export interface TaskInput {
-  value: number;
-}
-
-export async function simpleWorkflow(input: TaskInput): Promise<string> {
-  log.info(`Starting workflow with value: ${input.value}`);
-
-  let signalValue = 0;
-  setHandler(addSignalValue, (value: number) => {
-    log.info(`Received signal with value: ${value}`);
-    signalValue += value;
-  });
-
-  // Step 1: Add 10
-  const step1 = await addTen({ value: input.value });
-  log.info(`After step 1: ${step1}`);
-
-  // Step 2: Multiply by 2
-  const step2 = await multiplyByTwo({ value: step1 });
-  log.info(`After step 2: ${step2}`);
-
-  // Step 3: Subtract 5
-  const step3 = await subtractFive({ value: step2 });
-  log.info(`After step 3: ${step3}`);
-
-  const finalResult = `Complete: ${input.value} -> +10=${step1} -> *2=${step2} -> -5=${step3} + signal(${signalValue}) = ${step3 + signalValue}`;
-  log.info(finalResult);
-  return finalResult;
-}

package/examples/temporal/tsconfig.json

@@ -1,15 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2021",
-    "module": "commonjs",
-    "lib": ["ES2021"],
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "declaration": true
-  },
-  "include": ["src/**/*"]
-}

package/src/temporal.test.ts

@@ -1,243 +0,0 @@
-import { expect, test, describe } from "vitest";
-import {
-  serializeHeaderValue,
-  deserializeHeaderValue,
-  BRAINTRUST_SPAN_HEADER,
-  BRAINTRUST_WORKFLOW_SPAN_HEADER,
-  BRAINTRUST_WORKFLOW_SPAN_ID_HEADER,
-} from "./utils";
-import { SpanComponentsV3, SpanObjectTypeV3 } from "braintrust/util";
-import {
-  BraintrustTemporalPlugin,
-  createBraintrustTemporalPlugin,
-} from "./plugin";
-
-describe("temporal header utilities", () => {
-  test("serializeHeaderValue encodes string correctly", () => {
-    const value = "test-span-id";
-    const payload = serializeHeaderValue(value);
-
-    expect(payload.metadata?.encoding).toBeDefined();
-    expect(payload.data).toBeDefined();
-    expect(new TextDecoder().decode(payload.metadata?.encoding)).toBe(
-      "json/plain",
-    );
-    expect(new TextDecoder().decode(payload.data)).toBe('"test-span-id"');
-  });
-
-  test("deserializeHeaderValue decodes payload correctly", () => {
-    const original = "test-value-123";
-    const payload = serializeHeaderValue(original);
-    const decoded = deserializeHeaderValue(payload);
-
-    expect(decoded).toBe(original);
-  });
-
-  test("deserializeHeaderValue handles undefined payload", () => {
-    expect(deserializeHeaderValue(undefined)).toBeUndefined();
-  });
-
-  test("deserializeHeaderValue handles payload without data", () => {
-    expect(deserializeHeaderValue({ metadata: {} })).toBeUndefined();
-  });
-
-  test("deserializeHeaderValue handles invalid JSON", () => {
-    const payload = {
-      data: new TextEncoder().encode("not valid json"),
-    };
-    expect(deserializeHeaderValue(payload)).toBeUndefined();
-  });
-
-  test("round-trip serialization preserves complex strings", () => {
-    const testCases = [
-      "simple",
-      "with spaces",
-      "with/slashes",
-      "unicode-日本語",
-      "emoji-👋",
-      "",
-    ];
-
-    for (const value of testCases) {
-      const payload = serializeHeaderValue(value);
-      const decoded = deserializeHeaderValue(payload);
-      expect(decoded).toBe(value);
-    }
-  });
-
-  test("header constants are defined", () => {
-    expect(BRAINTRUST_SPAN_HEADER).toBe("_braintrust-span");
-    expect(BRAINTRUST_WORKFLOW_SPAN_HEADER).toBe("_braintrust-workflow-span");
-    expect(BRAINTRUST_WORKFLOW_SPAN_ID_HEADER).toBe(
-      "_braintrust-workflow-span-id",
-    );
-  });
-});
-
-describe("SpanComponentsV3 cross-worker reconstruction", () => {
-  test("can parse and reconstruct span components with new span_id", () => {
-    const clientComponents = new SpanComponentsV3({
-      object_type: SpanObjectTypeV3.PROJECT_LOGS,
-      object_id: "project-123",
-      row_id: "row-456",
-      span_id: "client-span-id",
-      root_span_id: "root-span-id",
-    });
-
-    const clientContext = clientComponents.toStr();
-    const workflowSpanId = "workflow-span-id";
-
-    const parsed = SpanComponentsV3.fromStr(clientContext);
-    const data = parsed.data;
-
-    expect(data.row_id).toBe("row-456");
-    expect(data.root_span_id).toBe("root-span-id");
-    expect(data.span_id).toBe("client-span-id");
-
-    if (data.row_id && data.root_span_id) {
-      const workflowComponents = new SpanComponentsV3({
-        object_type: data.object_type,
-        object_id: data.object_id,
-        propagated_event: data.propagated_event,
-        row_id: data.row_id,
-        root_span_id: data.root_span_id,
-        span_id: workflowSpanId,
-      });
-
-      const reconstructed = SpanComponentsV3.fromStr(
-        workflowComponents.toStr(),
-      );
-      expect(reconstructed.data.span_id).toBe(workflowSpanId);
-      expect(reconstructed.data.row_id).toBe("row-456");
-      expect(reconstructed.data.root_span_id).toBe("root-span-id");
-      expect(reconstructed.data.object_id).toBe("project-123");
-    }
-  });
-
-  test("preserves object_type when reconstructing", () => {
-    const objectTypes = [
-      SpanObjectTypeV3.PROJECT_LOGS,
-      SpanObjectTypeV3.EXPERIMENT,
-      SpanObjectTypeV3.PLAYGROUND_LOGS,
-    ];
-
-    for (const objectType of objectTypes) {
-      const original = new SpanComponentsV3({
-        object_type: objectType,
-        object_id: "test-id",
-        row_id: "row-id",
-        span_id: "original-span-id",
-        root_span_id: "root-span-id",
-      });
-
-      const parsed = SpanComponentsV3.fromStr(original.toStr());
-
-      const reconstructed = new SpanComponentsV3({
-        object_type: parsed.data.object_type,
-        object_id: parsed.data.object_id,
-        propagated_event: parsed.data.propagated_event,
-        row_id: parsed.data.row_id!,
-        root_span_id: parsed.data.root_span_id!,
-        span_id: "new-span-id",
-      });
-
-      expect(reconstructed.data.object_type).toBe(objectType);
-    }
-  });
-
-  test("handles span components without row_id fields", () => {
-    const componentsWithoutRowId = new SpanComponentsV3({
-      object_type: SpanObjectTypeV3.PROJECT_LOGS,
-      object_id: "test-id",
-    });
-
-    const parsed = SpanComponentsV3.fromStr(componentsWithoutRowId.toStr());
-
-    expect(parsed.data.row_id).toBeUndefined();
-    expect(parsed.data.span_id).toBeUndefined();
-    expect(parsed.data.root_span_id).toBeUndefined();
-  });
-
-  test("preserves propagated_event when reconstructing", () => {
-    const propagatedEvent = { key: "value", nested: { inner: 123 } };
-
-    const original = new SpanComponentsV3({
-      object_type: SpanObjectTypeV3.PROJECT_LOGS,
-      object_id: "test-id",
-      propagated_event: propagatedEvent,
-      row_id: "row-id",
-      span_id: "original-span-id",
-      root_span_id: "root-span-id",
-    });
-
-    const parsed = SpanComponentsV3.fromStr(original.toStr());
-
-    const reconstructed = new SpanComponentsV3({
-      object_type: parsed.data.object_type,
-      object_id: parsed.data.object_id,
-      propagated_event: parsed.data.propagated_event,
-      row_id: parsed.data.row_id!,
-      root_span_id: parsed.data.root_span_id!,
-      span_id: "new-span-id",
-    });
-
-    expect(reconstructed.data.propagated_event).toEqual(propagatedEvent);
-  });
-});
-
-describe("BraintrustTemporalPlugin", () => {
-  test("createBraintrustTemporalPlugin returns a plugin instance", () => {
-    const plugin = createBraintrustTemporalPlugin();
-    expect(plugin).toBeInstanceOf(BraintrustTemporalPlugin);
-    expect(plugin.name).toBe("braintrust");
-  });
-
-  test("plugin has configureClient method", () => {
-    const plugin = createBraintrustTemporalPlugin();
-    expect(typeof plugin.configureClient).toBe("function");
-  });
-
-  test("plugin has configureWorker method", () => {
-    const plugin = createBraintrustTemporalPlugin();
-    expect(typeof plugin.configureWorker).toBe("function");
-  });
-
-  test("configureClient adds workflow interceptor", () => {
-    const plugin = createBraintrustTemporalPlugin();
-    const options = {};
-    const configured = plugin.configureClient(options);
-
-    expect(configured.interceptors).toBeDefined();
-    expect(configured.interceptors?.workflow).toBeDefined();
-    expect(Array.isArray(configured.interceptors?.workflow)).toBe(true);
-    expect(configured.interceptors?.workflow?.length).toBe(1);
-  });
-
-  test("configureClient preserves existing interceptors", () => {
-    const plugin = createBraintrustTemporalPlugin();
-    const existingInterceptor = { start: async (i: unknown, n: unknown) => n };
-    const options = {
-      interceptors: {
-        workflow: [existingInterceptor],
-      },
-    };
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const configured = plugin.configureClient(options as any);
-
-    expect(configured.interceptors?.workflow?.length).toBe(2);
-  });
-
-  test("configureWorker adds activity interceptor and sinks", () => {
-    const plugin = createBraintrustTemporalPlugin();
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    const options = {} as any;
-    const configured = plugin.configureWorker(options);
-
-    expect(configured.interceptors).toBeDefined();
-    expect(configured.interceptors?.activity).toBeDefined();
-    expect(Array.isArray(configured.interceptors?.activity)).toBe(true);
-    expect(configured.interceptors?.activity?.length).toBe(1);
-    expect(configured.sinks).toBeDefined();
-    expect(configured.sinks?.braintrust).toBeDefined();
-  });
-});