@astropods/adapter-claude-agent-sdk 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import * as ClaudeAgentSDKModule from "@anthropic-ai/claude-agent-sdk";
+export * from "@anthropic-ai/claude-agent-sdk";
+export declare const query: typeof ClaudeAgentSDKModule.query;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,oBAAoB,MAAM,gCAAgC,CAAC;AAWvE,cAAc,gCAAgC,CAAC;AAK/C,eAAO,MAAM,KAAK,mCAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+import * as ClaudeAgentSDKModule from "@anthropic-ai/claude-agent-sdk";
+import { instrumentSDK } from "./instrumentation.js";
+// The Claude Agent SDK is ESM and exposes a frozen namespace, so the
+// OpenInference instrumentation cannot patch it in place. Spreading into a
+// regular object gives us a mutable copy that `manuallyInstrument` can edit.
+const patched = { ...ClaudeAgentSDKModule };
+instrumentSDK(patched);
+// Re-export the entire SDK surface so this package is a drop-in replacement.
+// New SDK exports flow through automatically.
+export * from "@anthropic-ai/claude-agent-sdk";
+// Override the un-patched bindings re-exported above with the instrumented
+// copies. The explicit local export takes precedence over the `export *`
+// re-export, so callers get the patched version.
+export const query = patched.query;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,oBAAoB,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,qEAAqE;AACrE,2EAA2E;AAC3E,6EAA6E;AAC7E,MAAM,OAAO,GAAgC,EAAE,GAAG,oBAAoB,EAAE,CAAC;AACzE,aAAa,CAAC,OAAO,CAAC,CAAC;AAEvB,6EAA6E;AAC7E,8CAA8C;AAC9C,cAAc,gCAAgC,CAAC;AAE/C,2EAA2E;AAC3E,yEAAyE;AACzE,iDAAiD;AACjD,MAAM,CAAC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC"}

package/dist/instrumentation.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Wire OpenTelemetry into a Claude Agent SDK namespace. When
+ * `OTEL_EXPORTER_OTLP_ENDPOINT` is set, this:
+ *   - Builds a `NodeTracerProvider` with the right service.name/version resource,
+ *     exporting to `<endpoint>/v1/traces` via the OTLP HTTP exporter.
+ *   - Registers the provider globally so any `trace.getTracer(...)` call uses it.
+ *   - Runs `ClaudeAgentSDKInstrumentation.manuallyInstrument(sdk)`, replacing
+ *     `sdk.query` with an OpenInference-wrapped version.
+ *   - Installs SIGTERM/SIGINT handlers that force-flush buffered spans before
+ *     exiting (so the tail of an in-flight trace isn't dropped on container shutdown).
+ *
+ * Returns `true` when instrumentation was applied, `false` when no endpoint
+ * was present (typical local-dev case — the agent runs untraced).
+ *
+ * Tests pass in a replay-SDK namespace here to verify span generation against
+ * recorded SDK event shapes without needing real Claude API calls.
+ */
+export declare function instrumentSDK(sdk: Record<string, any>): boolean;
+//# sourceMappingURL=instrumentation.d.ts.map

package/dist/instrumentation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.d.ts","sourceRoot":"","sources":["../src/instrumentation.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAgC/D"}

package/dist/instrumentation.js

@@ -0,0 +1,52 @@
+import { resourceFromAttributes } from "@opentelemetry/resources";
+import { NodeTracerProvider, BatchSpanProcessor, } from "@opentelemetry/sdk-trace-node";
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-http";
+import { ClaudeAgentSDKInstrumentation } from "@arizeai/openinference-instrumentation-claude-agent-sdk";
+/**
+ * Wire OpenTelemetry into a Claude Agent SDK namespace. When
+ * `OTEL_EXPORTER_OTLP_ENDPOINT` is set, this:
+ *   - Builds a `NodeTracerProvider` with the right service.name/version resource,
+ *     exporting to `<endpoint>/v1/traces` via the OTLP HTTP exporter.
+ *   - Registers the provider globally so any `trace.getTracer(...)` call uses it.
+ *   - Runs `ClaudeAgentSDKInstrumentation.manuallyInstrument(sdk)`, replacing
+ *     `sdk.query` with an OpenInference-wrapped version.
+ *   - Installs SIGTERM/SIGINT handlers that force-flush buffered spans before
+ *     exiting (so the tail of an in-flight trace isn't dropped on container shutdown).
+ *
+ * Returns `true` when instrumentation was applied, `false` when no endpoint
+ * was present (typical local-dev case — the agent runs untraced).
+ *
+ * Tests pass in a replay-SDK namespace here to verify span generation against
+ * recorded SDK event shapes without needing real Claude API calls.
+ */
+export function instrumentSDK(sdk) {
+    const endpoint = process.env.OTEL_EXPORTER_OTLP_ENDPOINT;
+    if (!endpoint)
+        return false;
+    const tracesUrl = `${endpoint.replace(/\/+$/, "")}/v1/traces`;
+    const provider = new NodeTracerProvider({
+        resource: resourceFromAttributes({
+            "service.name": process.env.ASTRO_AGENT_NAME ?? "claude-agent",
+            "service.version": process.env.ASTRO_AGENT_BUILD ?? "dev",
+        }),
+        spanProcessors: [
+            new BatchSpanProcessor(new OTLPTraceExporter({ url: tracesUrl })),
+        ],
+    });
+    provider.register();
+    const instrumentation = new ClaudeAgentSDKInstrumentation();
+    instrumentation.setTracerProvider(provider);
+    instrumentation.manuallyInstrument(sdk);
+    const flushAndExit = async (signal) => {
+        try {
+            await provider.forceFlush();
+            await provider.shutdown();
+        }
+        catch { }
+        process.exit(signal === "SIGINT" ? 130 : 0);
+    };
+    process.once("SIGTERM", flushAndExit);
+    process.once("SIGINT", flushAndExit);
+    return true;
+}
+//# sourceMappingURL=instrumentation.js.map

package/dist/instrumentation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instrumentation.js","sourceRoot":"","sources":["../src/instrumentation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,EAAE,6BAA6B,EAAE,MAAM,yDAAyD,CAAC;AAExG;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,aAAa,CAAC,GAAwB;IACpD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAC;IACzD,IAAI,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC;IAE5B,MAAM,SAAS,GAAG,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,YAAY,CAAC;IAE9D,MAAM,QAAQ,GAAG,IAAI,kBAAkB,CAAC;QACtC,QAAQ,EAAE,sBAAsB,CAAC;YAC/B,cAAc,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,cAAc;YAC9D,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,KAAK;SAC1D,CAAC;QACF,cAAc,EAAE;YACd,IAAI,kBAAkB,CAAC,IAAI,iBAAiB,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;SAClE;KACF,CAAC,CAAC;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAEpB,MAAM,eAAe,GAAG,IAAI,6BAA6B,EAAE,CAAC;IAC5D,eAAe,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC5C,eAAe,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;IAExC,MAAM,YAAY,GAAG,KAAK,EAAE,MAAsB,EAAE,EAAE;QACpD,IAAI,CAAC;YACH,MAAM,QAAQ,CAAC,UAAU,EAAE,CAAC;YAC5B,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;QACV,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,CAAC,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAErC,OAAO,IAAI,CAAC;AACd,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@astropods/adapter-claude-agent-sdk",
+  "license": "Apache-2.0",
+  "version": "0.2.0",
+  "description": "Drop-in replacement for @anthropic-ai/claude-agent-sdk that adds OpenTelemetry instrumentation for Astro deployments.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "bun test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/astropods/adapters.git",
+    "directory": "packages/claude-agent-sdk"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "dependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.3.142",
+    "@arizeai/openinference-instrumentation-claude-agent-sdk": "^0.1.0",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.200.0",
+    "@opentelemetry/resources": "^2.1.0",
+    "@opentelemetry/sdk-trace-node": "^2.1.0"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.5",
+    "typescript": "^5.3.0"
+  }
+}