@volcengine/tls-observer-trae 0.0.2

package/dist/state.d.ts

@@ -0,0 +1,8 @@
+import type { TurnStartState, TurnStateFile } from './types';
+export declare function loadState(stateFilePath: string): TurnStateFile;
+export declare function getSessionState(state: TurnStateFile, sessionId: string): TurnStartState;
+export declare function pruneOldSessions(state: TurnStateFile, now?: number): TurnStateFile;
+export declare function atomicUpdateState(stateFilePath: string, fn: (state: TurnStateFile) => TurnStateFile): Promise<void>;
+export declare function clearedActiveSession(session: TurnStartState, updates?: Partial<TurnStartState>): TurnStartState;
+export declare function saveTurnStartState(stateFilePath: string, turn: TurnStartState): Promise<void>;
+export declare function readTurnStartState(stateFilePath: string, sessionId: string): TurnStartState | undefined;

package/dist/stdin.d.ts

@@ -0,0 +1 @@
+export declare function readStdinJson<T>(): Promise<T>;

package/dist/tracer.d.ts

@@ -0,0 +1,3 @@
+import type { Config, TraceTraeOptions } from './types';
+export declare function writeSendLog(config: Config, record: Record<string, unknown>): Promise<void>;
+export declare function traceTraeSession(options: TraceTraeOptions): Promise<Record<string, unknown>>;

package/dist/types.d.ts

@@ -0,0 +1,78 @@
+export type HookInput = Record<string, any>;
+export interface Config {
+    enabled: boolean;
+    dataRoot: string;
+    turnStateFilePath: string;
+    sendLogsDir: string;
+    diagnosticLogMaxBytes: number;
+    diagnosticLogMaxFiles: number;
+    captureContent: boolean;
+    debugArtifacts: boolean;
+    serviceName: string;
+    serviceInstanceId: string;
+    ctxCli: string;
+    ctxCliTimeoutMs: number;
+    tlsEndpoint?: string;
+    otelEndpoint?: string;
+    region?: string;
+    traceTopicId?: string;
+    apiKey?: string;
+    ak?: string;
+    sk?: string;
+    authMode: 'header' | 'resource';
+    exportTimeoutMs: number;
+    exportTimeoutRetries: number;
+}
+export interface ContextFsTurn {
+    files: string[];
+    messages: Record<string, any>[];
+    errors: string[];
+    missingEnv?: string[];
+    envStatus?: {
+        ready: boolean;
+        cfsTokenPresent: boolean;
+        cfsIpcNamePresent: boolean;
+        cfsTransport: string;
+    };
+}
+export interface TraceTraeOptions {
+    input: HookInput;
+    config: Config;
+}
+export interface TokenUsage {
+    input_tokens?: number;
+    output_tokens?: number;
+    cache_read_input_tokens?: number;
+    reasoning_output_tokens?: number;
+    total_tokens?: number;
+    estimated?: boolean;
+    token_estimate_method?: string;
+}
+export interface PendingToolUse {
+    tool_call_id: string;
+    tool_name?: string;
+    llm_tool_name?: string;
+    tool_input?: unknown;
+    start_time_ms?: number;
+    timestamp?: string;
+}
+export interface TurnStartState {
+    sessionId: string;
+    active?: boolean;
+    turnId?: string;
+    cwd?: string;
+    agentId?: string;
+    agentName?: string;
+    userName?: string;
+    model?: string;
+    hookEventName?: string;
+    messages?: Record<string, any>[];
+    usage?: TokenUsage;
+    pendingToolUses?: Record<string, PendingToolUse>;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface TurnStateFile {
+    version: 1;
+    sessions: Record<string, TurnStartState>;
+}

package/hooks/hooks.json

@@ -0,0 +1,49 @@
+{
+  "version": 1,
+  "hooks": {
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ./dist/index.js",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "PreToolUse": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ./dist/index.js",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ./dist/index.js",
+            "timeout": 30
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ./dist/index.js",
+            "timeout": 30
+          }
+        ]
+      }
+    ]
+  }
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@volcengine/tls-observer-trae",
+  "version": "0.0.2",
+  "description": "Export Trae hook telemetry to Volcengine TLS with OTLP traces.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "trae",
+    "hooks",
+    "observability",
+    "opentelemetry",
+    "tls"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@volcengine/openapi": "^1.36.1"
+  }
+}