@volcengine/tls-observer-pi 0.0.1

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,58 @@
+# TLS Observer for Pi
+
+Pi Coding Agent plugin that converts Pi lifecycle 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 Pi public lifecycle hooks, groups them by session and turn in memory, and exports one `agent.turn` trace when the turn or agent run finishes.
+
+## Configuration
+
+Environment variables:
+
+- `PI_TLS_EXPORT=0` disables export.
+- `PI_TLS_ENV_FILE` optionally points to an env file. Defaults to `~/.pi/agent/tls-observer-pi.env`.
+- `PI_TLS_DATA_ROOT` overrides local send-log and retry state.
+- `PI_TLS_CAPTURE_CONTENT=0` disables prompt/response/tool content capture.
+- `PI_TLS_ENDPOINT` or `TRACE_TLS_ENDPOINT` or `TLS_ENDPOINT`
+- `PI_TLS_REGION` or `TRACE_TLS_REGION` or `TLS_REGION`
+- `PI_TLS_TRACE_TOPIC_ID` or `PI_TLS_TOPIC_ID` or `TRACE_TLS_TRACE_TOPIC_ID` or `TLS_TRACE_TOPIC_ID`
+- `PI_TLS_API_KEY` or `TRACE_TLS_API_KEY` or `TLS_API_KEY`
+- `PI_TLS_AK` / `PI_TLS_SK` or `TRACE_TLS_AK` / `TRACE_TLS_SK` or `TLS_AK` / `TLS_SK`
+
+Default data root:
+
+```text
+~/.pi/agent/tls-observer-pi
+```
+
+## Pi plugin loading
+
+Install with the dedicated installer:
+
+```bash
+npm exec -y --package=@volcengine/tls-observer-pi-install -- tls-observer-pi-install
+```
+
+If `pi` is not on `PATH`, pass `PI_TLS_PI_BIN=/absolute/path/to/pi` or `--pi-bin /absolute/path/to/pi`.
+
+For local installs, build the runtime package first and point the installer at the package source. The installer uses Pi CLI install semantics: `pi install npm:<package>` for registry installs and `pi install <local-path>` for local runtime packages.
+
+```bash
+cd packages/pi
+rslib build
+node scripts/build-package.mjs
+cd ../pi-install
+PI_PLUGIN_SOURCE=../pi/dist-package npm exec -y -- tls-observer-pi-install
+cd -
+```
+
+## Design notes
+
+This implementation uses a clean-room Pi adapter. It borrows the event-aggregation idea from existing Pi 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,13 @@
+export interface PiObserverConfig {
+    enabled: boolean;
+    dataRoot: string;
+    captureContent: 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(): PiObserverConfig;
+//# 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,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,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;AAmCD,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAmBtD;AAiDD,wBAAgB,UAAU,IAAI,gBAAgB,CAkB7C"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+import { loadConfig } from './config';
+import { PiTlsTracer } from './tracer';
+import type { PiExtensionApi } from './types';
+export declare const TlsObserverPiPlugin: (pi: PiExtensionApi) => Promise<void>;
+export default TlsObserverPiPlugin;
+export { loadConfig, PiTlsTracer };
+//# 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,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,eAAO,MAAM,mBAAmB,GAAU,IAAI,cAAc,kBAqE3D,CAAC;AAEF,eAAe,mBAAmB,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC"}