@braintrust/temporal 0.1.0 → 0.1.1

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.d.mts

@@ -43,8 +43,7 @@ declare class BraintrustTemporalPlugin implements ClientPlugin, WorkerPlugin {
     configureClient(options: Omit<ClientOptions, "plugins">): Omit<ClientOptions, "plugins">;
     /**
      * Configure the Temporal Worker with Braintrust interceptors and sinks.
-     * Adds the activity interceptor for creating spans, the sinks for workflow spans,
-     * and the workflow interceptor modules for bundling.
+     * Prepends interceptors to ensure they run first, making plugin order irrelevant.
      */
     configureWorker(options: WorkerOptions): WorkerOptions;
 }

package/dist/index.d.ts

@@ -43,8 +43,7 @@ declare class BraintrustTemporalPlugin implements ClientPlugin, WorkerPlugin {
     configureClient(options: Omit<ClientOptions, "plugins">): Omit<ClientOptions, "plugins">;
     /**
      * Configure the Temporal Worker with Braintrust interceptors and sinks.
-     * Adds the activity interceptor for creating spans, the sinks for workflow spans,
-     * and the workflow interceptor modules for bundling.
+     * Prepends interceptors to ensure they run first, making plugin order irrelevant.
      */
     configureWorker(options: WorkerOptions): WorkerOptions;
 }

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];
@@ -265,28 +269,25 @@ var BraintrustTemporalPlugin = class {
   }
   /**
    * Configure the Temporal Worker with Braintrust interceptors and sinks.
-   * Adds the activity interceptor for creating spans, the sinks for workflow spans,
-   * and the workflow interceptor modules for bundling.
+   * Prepends interceptors to ensure they run first, making plugin order irrelevant.
    */
   configureWorker(options) {
-    const existingActivityInterceptors = options.interceptors?.activity ?? [];
-    const existingWorkflowModules = options.interceptors?.workflowModules ?? [];
-    const existingSinks = options.sinks ?? {};
-    const braintrustSinks = createBraintrustSinks();
-    const workflowInterceptorsPath = require.resolve("@braintrust/temporal/workflow-interceptors");
     return {
       ...options,
       interceptors: {
         ...options.interceptors,
         activity: [
-          ...existingActivityInterceptors,
-          createBraintrustActivityInterceptor
+          createBraintrustActivityInterceptor,
+          ...options.interceptors?.activity ?? []
         ],
-        workflowModules: [...existingWorkflowModules, workflowInterceptorsPath]
+        workflowModules: [
+          WORKFLOW_INTERCEPTORS_SPEC,
+          ...options.interceptors?.workflowModules ?? []
+        ]
       },
       sinks: {
-        ...existingSinks,
-        ...braintrustSinks
+        ...createBraintrustSinks(),
+        ...options.sinks ?? {}
       }
     };
   }

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];
@@ -220,30 +223,25 @@ var BraintrustTemporalPlugin = class {
   }
   /**
    * Configure the Temporal Worker with Braintrust interceptors and sinks.
-   * Adds the activity interceptor for creating spans, the sinks for workflow spans,
-   * and the workflow interceptor modules for bundling.
+   * Prepends interceptors to ensure they run first, making plugin order irrelevant.
    */
   configureWorker(options) {
-    const existingActivityInterceptors = options.interceptors?.activity ?? [];
-    const existingWorkflowModules = options.interceptors?.workflowModules ?? [];
-    const existingSinks = options.sinks ?? {};
-    const braintrustSinks = createBraintrustSinks();
-    const workflowInterceptorsPath = __require.resolve(
-      "@braintrust/temporal/workflow-interceptors"
-    );
     return {
       ...options,
       interceptors: {
         ...options.interceptors,
         activity: [
-          ...existingActivityInterceptors,
-          createBraintrustActivityInterceptor
+          createBraintrustActivityInterceptor,
+          ...options.interceptors?.activity ?? []
         ],
-        workflowModules: [...existingWorkflowModules, workflowInterceptorsPath]
+        workflowModules: [
+          WORKFLOW_INTERCEPTORS_SPEC,
+          ...options.interceptors?.workflowModules ?? []
+        ]
       },
       sinks: {
-        ...existingSinks,
-        ...braintrustSinks
+        ...createBraintrustSinks(),
+        ...options.sinks ?? {}
       }
     };
   }

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",
   "description": "SDK for integrating Braintrust with Temporal",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

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,9 @@
-import type { ClientPlugin, ClientOptions } from "@temporalio/client";
+import type {
+  ClientPlugin,
+  ClientOptions,
+  WorkflowClientInterceptor,
+  WorkflowClientInterceptors,
+} from "@temporalio/client";
 import type { WorkerPlugin, WorkerOptions } from "@temporalio/worker";
 import {
   createBraintrustClientInterceptor,
@@ -6,6 +11,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 +61,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,40 +88,30 @@ export class BraintrustTemporalPlugin implements ClientPlugin, WorkerPlugin {
         ...options.interceptors,
         workflow,
       },
-    };
+    } as Omit<ClientOptions, "plugins">;
   }
 
   /**
    * Configure the Temporal Worker with Braintrust interceptors and sinks.
-   * Adds the activity interceptor for creating spans, the sinks for workflow spans,
-   * and the workflow interceptor modules for bundling.
+   * Prepends interceptors to ensure they run first, making plugin order irrelevant.
    */
   configureWorker(options: WorkerOptions): WorkerOptions {
-    const existingActivityInterceptors = options.interceptors?.activity ?? [];
-    const existingWorkflowModules = options.interceptors?.workflowModules ?? [];
-    const existingSinks = options.sinks ?? {};
-
-    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",
-    );
-
     return {
       ...options,
       interceptors: {
         ...options.interceptors,
         activity: [
-          ...existingActivityInterceptors,
           createBraintrustActivityInterceptor,
+          ...(options.interceptors?.activity ?? []),
+        ],
+        workflowModules: [
+          WORKFLOW_INTERCEPTORS_SPEC,
+          ...(options.interceptors?.workflowModules ?? []),
         ],
-        workflowModules: [...existingWorkflowModules, workflowInterceptorsPath],
       },
       sinks: {
-        ...existingSinks,
-        ...braintrustSinks,
+        ...createBraintrustSinks(),
+        ...(options.sinks ?? {}),
       },
     };
   }

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();
-  });
-});