opencode-otel-plugin 0.1.0

package/dist/signals/index.d.ts

@@ -0,0 +1,3 @@
+export { createMetricInstruments } from "./metrics";
+export type { MetricInstruments } from "./metrics";
+export { startSessionSpan, startChatSpan, startToolSpan, startFileEditSpan, startCompactionSpan, } from "./spans";

package/dist/signals/metrics.d.ts

@@ -0,0 +1,10 @@
+import type { Counter, Histogram, Meter } from "@opentelemetry/api";
+export interface MetricInstruments {
+    tokenUsage: Histogram;
+    operationDuration: Histogram;
+    requestCount: Counter;
+    compactionCount: Counter;
+    fileChanges: Counter;
+    toolInvocations: Counter;
+}
+export declare function createMetricInstruments(meter: Meter): MetricInstruments;

package/dist/signals/spans.d.ts

@@ -0,0 +1,26 @@
+import { type Context, type Span, type Tracer } from "@opentelemetry/api";
+export declare function startSessionSpan(tracer: Tracer, sessionID: string): {
+    span: Span;
+    context: Context;
+};
+export declare function startChatSpan(tracer: Tracer, opts: {
+    model: string;
+    provider: string;
+    sessionID: string;
+    branch?: string;
+}, parentContext?: Context): Span;
+export declare function startToolSpan(tracer: Tracer, opts: {
+    toolName: string;
+    callID: string;
+    sessionID: string;
+    branch?: string;
+}, parentContext?: Context): Span;
+export declare function startFileEditSpan(tracer: Tracer, opts: {
+    filepath: string;
+    language: string;
+    linesAdded: number;
+    linesRemoved: number;
+    sessionID: string;
+    branch?: string;
+}, parentContext?: Context): Span;
+export declare function startCompactionSpan(tracer: Tracer, sessionID: string, parentContext?: Context, branch?: string): Span;

package/dist/telemetry/index.d.ts

@@ -0,0 +1,5 @@
+export { buildResourceAttributes, createResource } from "./resources";
+export type { ResourceInput } from "./resources";
+export { initProviders } from "./provider";
+export type { Providers } from "./provider";
+export { shutdownProviders, flushProviders } from "./shutdown";

package/dist/telemetry/provider.d.ts

@@ -0,0 +1,8 @@
+import { BasicTracerProvider } from "@opentelemetry/sdk-trace-base";
+import { MeterProvider } from "@opentelemetry/sdk-metrics";
+import type { Resource } from "@opentelemetry/resources";
+export interface Providers {
+    tracerProvider: BasicTracerProvider;
+    meterProvider: MeterProvider;
+}
+export declare function initProviders(resource: Resource): Providers;

package/dist/telemetry/resources.d.ts

@@ -0,0 +1,12 @@
+import type { Resource } from "@opentelemetry/resources";
+export interface ResourceInput {
+    author: string;
+    hostname: string;
+    projectName: string;
+    repoUrl: string;
+    branch: string;
+    worktree: string;
+    directory: string;
+}
+export declare function buildResourceAttributes(input: ResourceInput): Record<string, string>;
+export declare function createResource(input: ResourceInput): Resource;

package/dist/telemetry/shutdown.d.ts

@@ -0,0 +1,3 @@
+import type { Providers } from "./provider";
+export declare function shutdownProviders(providers: Providers): Promise<void>;
+export declare function flushProviders(providers: Providers): Promise<void>;

package/dist/types.d.ts

@@ -0,0 +1,31 @@
+import type { Context, Span } from "@opentelemetry/api";
+/** Tracks the active OTel span for a session root. */
+export interface SessionSpanState {
+    span: Span;
+    context: Context;
+    sessionID: string;
+    requestCount: number;
+}
+/** Model/provider info captured in chat.params, used when ending chat spans. */
+export interface ChatRequestInfo {
+    model: string;
+    provider: string;
+    startTime: number;
+}
+/** Accumulated file change stats from session.diff events. */
+export interface FileChangeStats {
+    linesAdded: number;
+    linesRemoved: number;
+    filepath: string;
+    language: string;
+}
+/** In-flight tool span keyed by callID. */
+export type ToolSpanMap = Map<string, Span>;
+/** Plugin-wide mutable state shared across hooks. */
+export interface PluginState {
+    sessionSpans: Map<string, SessionSpanState>;
+    toolSpans: ToolSpanMap;
+    pendingChatRequests: Map<string, ChatRequestInfo>;
+    currentBranch: string | undefined;
+    opencodeVersion: string | undefined;
+}

package/dist/utils/diff.d.ts

@@ -0,0 +1,8 @@
+import type { FileChangeStats } from "../types";
+interface FileDiffLike {
+    path: string;
+    additions?: number;
+    deletions?: number;
+}
+export declare function extractFileChanges(diffs: FileDiffLike[]): FileChangeStats[];
+export {};

package/dist/utils/git.d.ts

@@ -0,0 +1,7 @@
+import type { PluginInput } from "@opencode-ai/plugin";
+type Shell = PluginInput["$"];
+export declare function getGitAuthor($: Shell): Promise<string>;
+export declare function getRepoUrl($: Shell): Promise<string>;
+export declare function getCurrentBranch($: Shell): Promise<string>;
+export declare function getHostname(): string;
+export {};

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export { detectLanguage } from "./language";
+export { extractFileChanges } from "./diff";
+export { getGitAuthor, getRepoUrl, getCurrentBranch, getHostname } from "./git";

package/dist/utils/language.d.ts

@@ -0,0 +1 @@
+export declare function detectLanguage(filepath: string): string;

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "opencode-otel-plugin",
+  "version": "0.1.0",
+  "description": "OpenTelemetry instrumentation plugin for OpenCode — traces and metrics for AI coding sessions via OTLP/HTTP",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "bun build ./src/index.ts --outdir dist --target bun && tsc --emitDeclarationOnly --outDir dist",
+    "prepublishOnly": "bun run build",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "opencode",
+    "opentelemetry",
+    "otel",
+    "tracing",
+    "metrics",
+    "observability",
+    "ai",
+    "llm",
+    "plugin"
+  ],
+  "author": "felixti",
+  "homepage": "https://github.com/felixti/opencode-otel-plugin#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/felixti/opencode-otel-plugin.git"
+  },
+  "bugs": {
+    "url": "https://github.com/felixti/opencode-otel-plugin/issues"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=0.1.0"
+  },
+  "dependencies": {
+    "@opentelemetry/api": "1.9.0",
+    "@opentelemetry/sdk-trace-base": "2.6.0",
+    "@opentelemetry/sdk-metrics": "2.6.0",
+    "@opentelemetry/exporter-trace-otlp-http": "0.213.0",
+    "@opentelemetry/exporter-metrics-otlp-http": "0.213.0",
+    "@opentelemetry/resources": "2.6.0",
+    "@opentelemetry/semantic-conventions": "1.40.0"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "latest",
+    "@types/bun": "latest",
+    "typescript": "latest"
+  },
+  "license": "MIT"
+}