opencode-axonhub-tracing 1.0.0

package/README.md

@@ -0,0 +1,40 @@
+# opencode-axonhub-tracing
+
+An OpenCode plugin that automatically injects AxonHub tracing headers into your LLM requests. This allows AxonHub to group all requests from the same OpenCode session together for trace aggregation.
+
+## Installation
+
+```bash
+npm install -g opencode-axonhub-tracing
+# or
+bun add -g opencode-axonhub-tracing
+```
+
+## Usage
+
+Add the plugin to your `opencode.json`:
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-axonhub-tracing"]
+}
+```
+
+That's it! The plugin will automatically add:
+- `AH-Trace-Id` - Set to the current OpenCode session ID.
+
+## How It Works
+
+1. The plugin hooks into the `chat.headers` event.
+2. It injects the `AH-Trace-Id` into the headers of every AI provider request.
+3. The trace ID is derived from the OpenCode `sessionID`, ensuring all requests in a single session are linked in AxonHub.
+
+## Requirements
+
+- OpenCode 1.1.40 or later
+- An AxonHub setup
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+import type { Hooks, PluginInput } from "@opencode-ai/plugin";
+/**
+ * OpenCode plugin for AxonHub tracing.
+ *
+ * Automatically injects AH-Trace-Id header into all AI provider requests for
+ * AxonHub trace aggregation. This allows AxonHub to group requests from the
+ * same OpenCode session into a single trace.
+ *
+ * ## Configuration
+ *
+ * Add to your `.opencode/config.json`:
+ *
+ * ```json
+ * {
+ *   "plugin": ["opencode-axonhub-tracing"]
+ * }
+ * ```
+ */
+export default function AxonHubTracing(_input: PluginInput): Promise<Hooks>;

package/dist/index.js

@@ -0,0 +1,13 @@
+// index.ts
+async function AxonHubTracing(_input) {
+  return {
+    "chat.headers": async (input, output) => {
+      if (input.sessionID) {
+        output.headers["AH-Trace-Id"] = input.sessionID;
+      }
+    }
+  };
+}
+export {
+  AxonHubTracing as default
+};

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "opencode-axonhub-tracing",
+  "version": "1.0.0",
+  "description": "OpenCode plugin for AxonHub tracing - automatically injects session headers for request tracing",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "bun build index.ts --outdir dist --target node && bun run build:types",
+    "build:types": "tsc --declaration --emitDeclarationOnly --outDir dist",
+    "prepublishOnly": "bun run build",
+    "test": "bun test",
+    "release": "npm publish"
+  },
+  "keywords": [
+    "opencode",
+    "axonhub",
+    "tracing",
+    "session",
+    "tracking",
+    "observability",
+    "plugin",
+    "llm",
+    "ai"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/your-org/opencode-axonhub-tracing.git"
+  },
+  "bugs": {
+    "url": "https://github.com/your-org/opencode-axonhub-tracing/issues"
+  },
+  "homepage": "https://github.com/your-org/opencode-axonhub-tracing#readme",
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=0.15.0",
+    "@opencode-ai/sdk": ">=0.15.0",
+    "typescript": ">=5.0.0"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "^0.15.0",
+    "@opencode-ai/sdk": "^0.15.0",
+    "@types/bun": "^1.3.1",
+    "typescript": "^5.9.3"
+  }
+}