@volcengine/tls-observer-trae 0.0.2

package/README.md

@@ -0,0 +1,20 @@
+# @volcengine/tls-observer-trae
+
+Trae observability runtime. It reads Trae hook input, builds a turn snapshot from hook events, converts it with the shared Trae adapter, and sends it through `runTracePipeline`.
+
+The preferred installer is `@volcengine/tls-observer-trae-install`.
+
+The runtime handles four Trae hooks:
+
+- `UserPromptSubmit`: records turn start state and does not send a trace.
+- `PreToolUse`: records tool call input and local start time.
+- `PostToolUse`: records tool call output and completes the tool span data.
+- `Stop`: records the final assistant output, attaches token usage to the root span when present, builds a trace snapshot, and sends it.
+
+## Environment
+
+- `TRAE_TLS_ENV_FILE`: optional env file path.
+- `TRAE_TLS_DATA_ROOT`: runtime state and send logs.
+- `TRAE_TLS_REGION`, `TRAE_TLS_ENDPOINT`, `TRAE_TLS_TRACE_TOPIC_ID`, `TRAE_TLS_API_KEY` or `TRAE_TLS_AK`/`TRAE_TLS_SK`: TLS export config.
+- `TRAE_TLS_CAPTURE_CONTENT=0`: disable prompt/response/tool payload capture.
+- `TRAE_TLS_DIAGNOSTIC_LOG_MAX_FILES`: max diagnostic log files, default `3`.

package/dist/config.d.ts

@@ -0,0 +1,4 @@
+import type { Config } from './types';
+export declare function loadEnvFile(filePath?: string): boolean;
+export declare function loadConfig(): Config;
+export declare function localIdentityMetadata(): Record<string, unknown>;

package/dist/contextfs.d.ts

@@ -0,0 +1,12 @@
+import type { Config, ContextFsTurn, HookInput } from './types';
+export declare function sessionIdFromInput(input: HookInput): string | undefined;
+export declare function turnIdFromInput(input: HookInput): string | undefined;
+export declare function contextFsEnvStatus(env?: NodeJS.ProcessEnv): ContextFsTurn['envStatus'] & {
+    missing: string[];
+};
+export declare function readContextFsTurn(options: {
+    config: Config;
+    sessionId: string;
+    turnId?: string;
+    env?: NodeJS.ProcessEnv;
+}): Promise<ContextFsTurn>;

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { loadConfig, loadEnvFile } from './config';
+export { contextFsEnvStatus, readContextFsTurn, sessionIdFromInput, turnIdFromInput } from './contextfs';
+export { traceTraeSession } from './tracer';
+export type { Config, ContextFsTurn, HookInput, TraceTraeOptions } from './types';