feat(agent-tracing): add @eggjs/agent-tracing package for AI agent tracing

tegg/core/agent-tracing/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@eggjs/agent-tracing",
+  "version": "4.0.2-beta.3",
+  "description": "Tracing support for AI agents (LangGraph, Claude Agent SDK)",
+  "keywords": [
+    "agent",
+    "claude",
+    "egg",
+    "langchain",
+    "langgraph",
+    "tegg",
+    "tracing",
+    "typescript"
+  ],
+  "homepage": "https://github.com/eggjs/egg/tree/next/tegg/core/agent-tracing",
+  "bugs": {
+    "url": "https://github.com/eggjs/egg/issues"
+  },
+  "license": "MIT",
+  "author": "killagu <killa123@126.com>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/eggjs/egg.git",
+    "directory": "tegg/core/agent-tracing"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./claude": "./src/claude.ts",
+    "./langgraph": "./src/langgraph.ts",
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public",
+    "exports": {
+      ".": "./dist/index.js",
+      "./claude": "./dist/claude.js",
+      "./langgraph": "./dist/langgraph.js",
+      "./package.json": "./package.json"
+    }
+  },
+  "scripts": {
+    "typecheck": "tsgo --noEmit",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "@eggjs/background-task": "workspace:*",
+    "@eggjs/core-decorator": "workspace:*",
+    "@eggjs/tegg-types": "workspace:*",
+    "onelogger": "catalog:"
+  },
+  "devDependencies": {
+    "@anthropic-ai/claude-agent-sdk": "^0.2.52",
+    "@anthropic-ai/sdk": "^0.78.0",
+    "@eggjs/tegg-common-util": "workspace:*",
+    "@langchain/core": "^1.1.29",
+    "@langchain/langgraph": "^0.2.74",
+    "@types/node": "catalog:",
+    "typescript": "catalog:"
+  },
+  "peerDependencies": {
+    "@anthropic-ai/claude-agent-sdk": ">=0.2.52",
+    "@langchain/core": "^1.1.29"
+  },
+  "peerDependenciesMeta": {
+    "@anthropic-ai/claude-agent-sdk": {
+      "optional": true
+    },
+    "@langchain/core": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "eggModule": {
+    "name": "teggAgentTracing"
+  }
+}

tegg/core/agent-tracing/src/AbstractLogServiceClient.ts

@@ -0,0 +1,31 @@
+/**
+ * Abstract log service client for dependency injection.
+ *
+ * To enable log service syncing in TracingService, implement this class in your application
+ * and register it with Tegg IoC. The implementation class MUST be named `LogServiceClient`
+ * (or use `@SingletonProto({ name: 'logServiceClient' })`) so the container can resolve it.
+ *
+ * @example
+ * ```typescript
+ * import { SingletonProto } from '@eggjs/core-decorator';
+ * import { AccessLevel } from '@eggjs/tegg-types';
+ * import { AbstractLogServiceClient } from '@eggjs/agent-tracing';
+ *
+ * // Class name must be LogServiceClient (registers as 'logServiceClient' in the IoC container)
+ * @SingletonProto({ accessLevel: AccessLevel.PUBLIC })
+ * export class LogServiceClient extends AbstractLogServiceClient {
+ *   async send(log: string): Promise<void> {
+ *     await fetch('https://log.example.com/api', {
+ *       method: 'POST',
+ *       headers: { 'content-type': 'application/json' },
+ *       body: JSON.stringify({ log }),
+ *     });
+ *   }
+ * }
+ * ```
+ *
+ * If no implementation is registered, log service syncing is silently skipped.
+ */
+export abstract class AbstractLogServiceClient {
+  abstract send(log: string): Promise<void>;
+}

tegg/core/agent-tracing/src/AbstractOssClient.ts

@@ -0,0 +1,27 @@
+/**
+ * Abstract OSS client for dependency injection.
+ *
+ * To enable OSS uploads in TracingService, implement this class in your application
+ * and register it with Tegg IoC. The implementation class MUST be named `OssClient`
+ * (or use `@SingletonProto({ name: 'ossClient' })`) so the container can resolve it.
+ *
+ * @example
+ * ```typescript
+ * import { SingletonProto } from '@eggjs/core-decorator';
+ * import { AccessLevel } from '@eggjs/tegg-types';
+ * import { AbstractOssClient } from '@eggjs/agent-tracing';
+ *
+ * // Class name must be OssClient (registers as 'ossClient' in the IoC container)
+ * @SingletonProto({ accessLevel: AccessLevel.PUBLIC })
+ * export class OssClient extends AbstractOssClient {
+ *   async put(key: string, content: string | Buffer): Promise<void> {
+ *     // your OSS implementation here
+ *   }
+ * }
+ * ```
+ *
+ * If no implementation is registered, OSS uploads are silently skipped.
+ */
+export abstract class AbstractOssClient {
+  abstract put(key: string, content: string | Buffer): Promise<void>;
+}