@volcengine/tls-observer-opencode 0.0.3

package/LICENCE

@@ -0,0 +1,13 @@
+# Copyright 2023 Beijing Volcano Engine Technology Ltd. 
+#
+# 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

@@ -0,0 +1,43 @@
+# TLS Observer for OpenCode
+
+OpenCode plugin that converts OpenCode session events into GenAI OTEL traces and exports them to Volcengine TLS.
+
+## Trace shape
+
+```text
+agent.turn (server)
+  llm.request (client)
+  tool.call (client)
+```
+
+The plugin listens to OpenCode public plugin events, groups them by user turn, and exports one `agent.turn` trace when the assistant reaches `step-finish reason="stop"`.
+
+## Configuration
+
+Environment variables:
+
+- `OPENCODE_TLS_EXPORT=0` disables export.
+- `OPENCODE_TLS_ENV_FILE` optionally points to an env file. Defaults to `~/.config/opencode/tls-observer-opencode.env`.
+- `OPENCODE_TLS_DATA_ROOT` overrides local send-log and retry state.
+- `OPENCODE_TLS_CAPTURE_CONTENT=0` disables prompt/response/tool content capture.
+- `OPENCODE_TLS_ENDPOINT` or `TRACE_TLS_ENDPOINT`
+- `OPENCODE_TLS_REGION` or `TLS_REGION`
+- `OPENCODE_TLS_TRACE_TOPIC_ID` or `TLS_TRACE_TOPIC_ID`
+- `OPENCODE_TLS_API_KEY` or `TLS_API_KEY`
+- `OPENCODE_TLS_AK` / `OPENCODE_TLS_SK` or `TLS_AK` / `TLS_SK`
+
+Default data root:
+
+```text
+~/.config/opencode/plugins/data/tls-observer-opencode
+```
+
+## OpenCode plugin loading
+
+For local installs, place a JavaScript plugin entry file under `~/.config/opencode/plugins/`.
+The installer writes `~/.config/opencode/plugins/tls-observer-opencode.js` and keeps the
+runtime package in `~/.config/opencode/plugins/tls-observer-opencode/`.
+
+## Design notes
+
+This implementation uses a clean-room OpenCode adapter. It borrows the event-aggregation idea from existing OpenCode tracing integrations, but the code, names, state model, and TLS span mapping are independently implemented for this repository.

package/dist/config.d.ts

@@ -0,0 +1,15 @@
+export interface OpenCodeObserverConfig {
+    enabled: boolean;
+    dataRoot: string;
+    captureContent: boolean;
+    debugArtifacts: boolean;
+    serviceName: string;
+    serviceInstanceId: string;
+    pluginVersion: string;
+    exportTimeoutMs: number;
+    env: Record<string, string | undefined>;
+}
+export declare function loadEnvFile(filePath?: string): boolean;
+export declare function loadConfig(): OpenCodeObserverConfig;
+export declare function localIdentityAttributes(): Record<string, unknown>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACzC;AAyCD,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAmBtD;AAoDD,wBAAgB,UAAU,IAAI,sBAAsB,CAmBnD;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIjE"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import type { Plugin } from '@opencode-ai/plugin';
+import { loadConfig } from './config';
+import { OpenCodeTlsTracer } from './tracer';
+export declare const TlsObserverOpenCodePlugin: Plugin;
+export default TlsObserverOpenCodePlugin;
+export { loadConfig, OpenCodeTlsTracer };
+//# 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,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAuB,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAElE,eAAO,MAAM,yBAAyB,EAAE,MAkBvC,CAAC;AAEF,eAAe,yBAAyB,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAC"}