diff --git a/.agents/notes/implemented/architecture/2026-09-25-session-log-otel-byte-limits.i18n.yaml b/.agents/notes/implemented/architecture/2026-09-25-session-log-otel-byte-limits.i18n.yaml
index 0326afebcf..15f69188be 100644
--- a/.agents/notes/implemented/architecture/2026-09-25-session-log-otel-byte-limits.i18n.yaml
+++ b/.agents/notes/implemented/architecture/2026-09-25-session-log-otel-byte-limits.i18n.yaml
@@ -9,8 +9,8 @@
en: 20f659a15fb55352
zh: 49d39c95da1b8aa5
/agent-note-session-log-otlp-strings-and-bounded-requests/decision:
- en: 06c1b11a1666c42e
- zh: 6319b67e8afe0d6f
+ en: 0f0866232326658b
+ zh: aa608d17ba712d8a
/agent-note-session-log-otlp-strings-and-bounded-requests/alternatives-considered:
en: 0dc933b18a1a3573
zh: 77655740322c4e45
diff --git a/.agents/notes/implemented/architecture/2026-09-25-session-log-otel-byte-limits.md b/.agents/notes/implemented/architecture/2026-09-25-session-log-otel-byte-limits.md
index 7444326bb0..57fbe72dc5 100644
--- a/.agents/notes/implemented/architecture/2026-09-25-session-log-otel-byte-limits.md
+++ b/.agents/notes/implemented/architecture/2026-09-25-session-log-otel-byte-limits.md
@@ -10,11 +10,11 @@ Session logs contain nested JSON and large tool results. The product collector a
## Decision
-The Session OTel backend owns the Session-log reporter. The product service owns only product events, with no Session types or unused Session queue. Each canonical event becomes `eventName: "session-log"`, with `sessionId` and JSON-stringified event values in `content`; serialization does not preserve JSONL key ordering. Redaction runs before serialization and the copied envelope excludes the payload.
+The shared `otel` Cordis plugin owns ordinary-event and Session-log transport implementations. Business adapters inject it and create independent caller-owned channels; their existing UI/RPC entry points retain authorization, redaction, identity, configuration, and bounded shutdown. Mounting the shared service creates no unused queues. Each canonical event becomes `eventName: "session-log"`, with `sessionId` and JSON-stringified event values in `content`; serialization does not preserve JSONL key ordering. Redaction runs before serialization and the copied envelope excludes the payload.
Session logs use a separate provider and byte/count queue. Each record is measured once with the SDK serializer including a full envelope; the sum conservatively bounds a combined request. Greedy packing avoids full-candidate serialization and recursive re-encoding. Single oversized records receive one diagnostic and do not block later events. One HTTP request owns the transport slot until settlement, even after its watchdog fires; shutdown expiry stops the remaining queue. Scope name/version and explicit transport options remain owned by the backend.
-The [telemetry revival](../feature/2026-07-23-session-telemetry-otel-revival.md) remains authoritative for redaction, capture, and best-effort handoff. This decision replaces its SDK-only queue/batching rule: SDK batch deadlines cannot own an operation split into multiple HTTP requests. The backend schedules complete requests; the SDK still owns transport/retry. Feedback authorization and the separate DeepSeek model-request contribution remain unchanged.
+The [telemetry revival](../feature/2026-07-23-session-telemetry-otel-revival.md) remains authoritative for redaction, capture, and best-effort handoff. This decision replaces its SDK-only queue/batching rule: SDK batch deadlines cannot own an operation split into multiple HTTP requests. The shared Session-log channel schedules complete requests; the SDK still owns transport/retry. Feedback authorization and the separate DeepSeek model-request contribution remain unchanged.
## Alternatives considered
diff --git a/.agents/notes/implemented/architecture/2026-09-25-session-log-otel-byte-limits.zh.md b/.agents/notes/implemented/architecture/2026-09-25-session-log-otel-byte-limits.zh.md
index aa353fd0f6..f6e8306978 100644
--- a/.agents/notes/implemented/architecture/2026-09-25-session-log-otel-byte-limits.zh.md
+++ b/.agents/notes/implemented/architecture/2026-09-25-session-log-otel-byte-limits.zh.md
@@ -10,11 +10,11 @@ Session 日志包含嵌套 JSON 和大型工具结果。产品采集端接收带
## 决策
-Session OTel 后端拥有 Session 日志 reporter。产品服务仅负责产品事件,不依赖 Session 类型,也不创建无人使用的 Session 队列。每条规范事件对应 `eventName: "session-log"`,属性包含 `sessionId` 和 JSON 字符串形式的事件值 `content`;序列化不保留 JSONL 键顺序。脱敏在序列化前执行,复制的 envelope 不含 payload。
+共享 `otel` Cordis 插件负责普通事件和 Session 日志的传输实现。业务适配器注入它并创建独立、由调用方持有的通道;现有 UI/RPC 入口保留授权、脱敏、身份、配置和有期限的关闭。只挂载共享服务不会创建无用队列。每条规范事件转换为 `eventName: "session-log"`,带有 `sessionId` 和在 `content` 中 JSON 字符串化的事件值;序列化不保留 JSONL 键顺序。脱敏先于序列化,复制的 envelope 不包含 payload。
Session 日志使用独立 provider 和字节/条数队列。每条记录使用 SDK 序列化器计量一次,包含完整 envelope;其总和保守约束合并请求大小。顺序组包避免候选批次的完整序列化和递归重复编码。单条超限记录只产生一次诊断,不阻塞后续事件。每个 HTTP 请求在结束前始终占有传输槽位,即使其监测期限已经触发;关闭期限到期后停止剩余队列。scope 名称/版本和显式传输选项仍由后端拥有。
-[遥测恢复决策](../feature/2026-07-23-session-telemetry-otel-revival.zh.md) 继续约束脱敏、捕获和尽力交接。本决策替代其仅使用 SDK 队列/聚合的规则:SDK 批次期限无法拥有拆成多个 HTTP 请求的操作。后端调度完整请求,SDK 仍负责传输和重试。反馈授权和独立的 DeepSeek 模型请求附加路径不变。
+[遥测恢复决策](../feature/2026-07-23-session-telemetry-otel-revival.zh.md) 继续约束脱敏、捕获和尽力交接。本决策替代其仅使用 SDK 队列/聚合的规则:SDK 批次期限无法拥有拆成多个 HTTP 请求的操作。共享 Session 日志通道调度完整请求,SDK 仍负责传输和重试。反馈授权和独立的 DeepSeek 模型请求附加路径不变。
## 考虑过的替代方案
diff --git a/apps/cli/composition.md b/apps/cli/composition.md
index e72a1f0ce6..e627d9e47d 100644
--- a/apps/cli/composition.md
+++ b/apps/cli/composition.md
@@ -74,6 +74,8 @@ flowchart LR
cfg --> plugin_dsh_base_storage_domain
plugin_dsh_base_session_projection_cache["session-projection-cache
@deepseek-ai/dsh-session-projection-cache"]
cfg --> plugin_dsh_base_session_projection_cache
+ plugin_dsh_base_otel["otel
@deepseek-ai/dsh-otel"]
+ cfg --> plugin_dsh_base_otel
plugin_dsh_base_session_telemetry_otel["session-telemetry-otel
@deepseek-ai/dsh-session-telemetry-otel"]
cfg --> plugin_dsh_base_session_telemetry_otel
plugin_dsh_base_subprocess["subprocess
@deepseek-ai/dsh-subprocess-local"]
@@ -231,6 +233,7 @@ flowchart LR
| `storage-json` | `@deepseek-ai/dsh-storage-json` |
| `storage-domain` | `@deepseek-ai/dsh-storage-domain` |
| `session-projection-cache` | `@deepseek-ai/dsh-session-projection-cache` |
+| `otel` | `@deepseek-ai/dsh-otel` |
| `session-telemetry-otel` | `@deepseek-ai/dsh-session-telemetry-otel` |
| `subprocess` | `@deepseek-ai/dsh-subprocess-local` |
| `sandbox` | `@deepseek-ai/dsh-sandbox-local` |
diff --git a/docs/capability-seams.i18n.yaml b/docs/capability-seams.i18n.yaml
index a20cbf9cde..9982152e55 100644
--- a/docs/capability-seams.i18n.yaml
+++ b/docs/capability-seams.i18n.yaml
@@ -6,5 +6,5 @@
en: 41d772192075e133
zh: 5ef3da69b4de1d8a
/capability-seams-and-core-services:
- en: 0d14d210d41c6770
- zh: 964e92962b7cfa88
+ en: 8d7ae3eb1265031d
+ zh: 970ce559f5f95a65
diff --git a/docs/capability-seams.md b/docs/capability-seams.md
index 21b4a8205b..093c5852e5 100644
--- a/docs/capability-seams.md
+++ b/docs/capability-seams.md
@@ -112,11 +112,13 @@ flowchart LR
pkg_api_account_controller["api-account-controller"]
pkg_authorization["authorization"]
svc_authorization["ctx.authorization
Authorization flow registry"]
+ pkg_otel["otel"]
+ svc_otel["ctx.otel
Shared OTel reporting channels"]
pkg_host_product_telemetry_otel["host-product-telemetry-otel"]
+ pkg_session_telemetry_otel["session-telemetry-otel"]
svc_productTelemetry["ctx.productTelemetry
Product usage event sender"]
pkg_session_telemetry["session-telemetry"]
svc_sessionTelemetry["ctx.sessionTelemetry
Session telemetry seam"]
- pkg_session_telemetry_otel["session-telemetry-otel"]
pkg_storage["storage"]
svc_storage["ctx.storage
Non-session storage hub"]
pkg_storage_json["storage-json"]
@@ -348,6 +350,7 @@ flowchart LR
pkg_mcp_resources --> svc_mcpResources
pkg_message_feedback --> svc_messageFeedback
pkg_office_to_pdf --> svc_officeToPdf
+ pkg_otel --> svc_otel
pkg_permission_presets --> svc_permissionPresets
pkg_plan_mode --> svc_planMode
pkg_plugin_manager --> svc_pluginManager
@@ -472,6 +475,8 @@ flowchart LR
svc_lsp --> pkg_tool_lsp
svc_mcpResources --> pkg_mcp_resources
svc_officeToPdf --> pkg_client_ui_sidebar_documentpreview
+ svc_otel --> pkg_host_product_telemetry_otel
+ svc_otel --> pkg_session_telemetry_otel
svc_pluginManager --> pkg_plugin_manager
svc_pluginManager --> pkg_ui_settings_plugin_inventory
svc_pluginRegistryProbe --> pkg_client_ui_plugin_manager
@@ -605,6 +610,7 @@ flowchart LR
| `ctx.credentials` | `seam` | [`credentials`](../packages/credentials/credentials) | [`credentials-local`](../packages/credentials/credentials-local) | [`api-settings-controller`](../packages/api/settings-controller), [`llm-deepseek`](../packages/llm/llm-deepseek), [`llm-pi-ai`](../packages/llm/llm-pi-ai) | - | Configuration carries references to secrets; providers own the values. Consumers resolve per operation, so a rotated credential reaches the very next request; the settings controller exposes value-free views and write-only storage. |
| `ctx.deepseekAccount` | `seam` | [`deepseek-account`](../packages/credentials/deepseek-account) | [`deepseek-account-platform`](../packages/credentials/deepseek-account-platform) | [`api-account-controller`](../packages/api/account-controller), [`llm-deepseek`](../packages/llm/llm-deepseek) | - | The Host owns browser authorization and local credentials; UI consumers receive state without tokens. |
| `ctx.authorization` | `seam` | [`authorization`](../packages/credentials/authorization) | - | [`llm-pi-ai`](../packages/llm/llm-pi-ai) | - | Flows are registered by the plugin that knows how to obtain one credential and keyed by the record they write; the seam owns the conversation and the one-attempt-per-key lifecycle, never the protocol. |
+| `ctx.otel` | `service` | [`otel`](../packages/telemetry/otel) | - | [`host-product-telemetry-otel`](../packages/host/product-telemetry-otel), [`session-telemetry-otel`](../packages/session/session-telemetry-otel) | - | Product analytics and Session feedback adapters create independent reporting channels through one injected service. |
| `ctx.productTelemetry` | `service` | [`host-product-telemetry-otel`](../packages/host/product-telemetry-otel) | - | - | - | Exports explicitly submitted analytics events through OTLP/HTTP; mounting alone collects nothing. |
| `ctx.sessionTelemetry` | `seam` | [`session-telemetry`](../packages/session/session-telemetry) | [`session-telemetry-otel`](../packages/session/session-telemetry-otel) | - | - | The seam captures, redacts, and hands session records to one backend; nothing else consumes the service — its output leaves the process. |
| `ctx.storage` | `seam` | [`storage`](../packages/storage/storage) | [`storage-json`](../packages/storage/storage-json), [`storage-sqlite`](../packages/storage/storage-sqlite) | [`storage-domain`](../packages/storage/storage-domain) | - | Backends register side by side under names; data forms (domain first) mount on the hub and translate typed operations into opaque KV-unit primitives. |
diff --git a/docs/capability-seams.zh.md b/docs/capability-seams.zh.md
index 996fc1b863..4e41705687 100644
--- a/docs/capability-seams.zh.md
+++ b/docs/capability-seams.zh.md
@@ -114,11 +114,13 @@ flowchart LR
pkg_api_account_controller["api-account-controller"]
pkg_authorization["authorization"]
svc_authorization["ctx.authorization
Authorization flow registry"]
+ pkg_otel["otel"]
+ svc_otel["ctx.otel
Shared OTel reporting channels"]
pkg_host_product_telemetry_otel["host-product-telemetry-otel"]
+ pkg_session_telemetry_otel["session-telemetry-otel"]
svc_productTelemetry["ctx.productTelemetry
Product usage event sender"]
pkg_session_telemetry["session-telemetry"]
svc_sessionTelemetry["ctx.sessionTelemetry
Session telemetry seam"]
- pkg_session_telemetry_otel["session-telemetry-otel"]
pkg_storage["storage"]
svc_storage["ctx.storage
Non-session storage hub"]
pkg_storage_json["storage-json"]
@@ -350,6 +352,7 @@ flowchart LR
pkg_mcp_resources --> svc_mcpResources
pkg_message_feedback --> svc_messageFeedback
pkg_office_to_pdf --> svc_officeToPdf
+ pkg_otel --> svc_otel
pkg_permission_presets --> svc_permissionPresets
pkg_plan_mode --> svc_planMode
pkg_plugin_manager --> svc_pluginManager
@@ -474,6 +477,8 @@ flowchart LR
svc_lsp --> pkg_tool_lsp
svc_mcpResources --> pkg_mcp_resources
svc_officeToPdf --> pkg_client_ui_sidebar_documentpreview
+ svc_otel --> pkg_host_product_telemetry_otel
+ svc_otel --> pkg_session_telemetry_otel
svc_pluginManager --> pkg_plugin_manager
svc_pluginManager --> pkg_ui_settings_plugin_inventory
svc_pluginRegistryProbe --> pkg_client_ui_plugin_manager
@@ -607,6 +612,7 @@ flowchart LR
| `ctx.credentials` | `seam` | [`credentials`](../packages/credentials/credentials) | [`credentials-local`](../packages/credentials/credentials-local) | [`api-settings-controller`](../packages/api/settings-controller), [`llm-deepseek`](../packages/llm/llm-deepseek), [`llm-pi-ai`](../packages/llm/llm-pi-ai) | - | 配置携带对机密信息的引用;提供方拥有实际值。消费方按操作解析,因此轮换后的凭据会在紧接着的下一次请求中生效;settings controller 提供不含实际值的视图和只写存储。 |
| `ctx.deepseekAccount` | `seam` | [`deepseek-account`](../packages/credentials/deepseek-account) | [`deepseek-account-platform`](../packages/credentials/deepseek-account-platform) | [`api-account-controller`](../packages/api/account-controller), [`llm-deepseek`](../packages/llm/llm-deepseek) | - | Host 负责浏览器授权和本地凭证;UI 使用方只接收不含 token 的状态。 |
| `ctx.authorization` | `seam` | [`authorization`](../packages/credentials/authorization) | - | [`llm-pi-ai`](../packages/llm/llm-pi-ai) | - | flow 由知道如何取得某份凭据的插件注册,并以其写入的记录为键;seam 拥有这段对话与"每个键同时只跑一次尝试"的生命周期,而非协议本身。 |
+| `ctx.otel` | `service` | [`otel`](../packages/telemetry/otel) | - | [`host-product-telemetry-otel`](../packages/host/product-telemetry-otel), [`session-telemetry-otel`](../packages/session/session-telemetry-otel) | - | 产品埋点和 Session 反馈适配器通过同一个注入服务创建独立上报通道。 |
| `ctx.productTelemetry` | `service` | [`host-product-telemetry-otel`](../packages/host/product-telemetry-otel) | - | - | - | 通过 OTLP/HTTP 发送显式提交的分析事件;仅挂载插件不会采集信息。 |
| `ctx.sessionTelemetry` | `seam` | [`session-telemetry`](../packages/session/session-telemetry) | [`session-telemetry-otel`](../packages/session/session-telemetry-otel) | - | - | 该 seam 捕获会话记录、进行脱敏并交给一个后端;没有其他组件消费该服务,其输出会离开当前进程。 |
| `ctx.storage` | `seam` | [`storage`](../packages/storage/storage) | [`storage-json`](../packages/storage/storage-json), [`storage-sqlite`](../packages/storage/storage-sqlite) | [`storage-domain`](../packages/storage/storage-domain) | - | 各后端以不同名称并列注册;数据形态(领域优先)挂载到枢纽上,并将类型化操作转换为不透明的 KV 单元原语。 |
diff --git a/docs/config-catalog.md b/docs/config-catalog.md
index b70bcfa723..2b8e67a545 100644
--- a/docs/config-catalog.md
+++ b/docs/config-catalog.md
@@ -1435,7 +1435,8 @@ export interface Config {
## `@deepseek-ai/dsh-host-product-telemetry-otel`
-- `source`: [`packages/host/product-telemetry-otel/src/index.ts:37`](../packages/host/product-telemetry-otel/src/index.ts)
+- `inject`: `otel`
+- `source`: [`packages/host/product-telemetry-otel/src/index.ts:18`](../packages/host/product-telemetry-otel/src/index.ts)
```ts config-catalog
/** Collector routing, application identity, and bounded in-memory batch settings. */
@@ -2701,9 +2702,9 @@ export interface Config {
## `@deepseek-ai/dsh-session-telemetry-otel`
-- `inject`: `sessions`
+- `inject`: `sessions` · `otel`
- `refs`: `BatchLogRecordProcessorOptions` (`@opentelemetry/sdk-logs`) · `OTLPExporterNodeConfigBase` (`@opentelemetry/otlp-exporter-base`)
-- `source`: [`packages/session/session-telemetry-otel/src/index.ts:86`](../packages/session/session-telemetry-otel/src/index.ts)
+- `source`: [`packages/session/session-telemetry-otel/src/index.ts:87`](../packages/session/session-telemetry-otel/src/index.ts)
```ts config-catalog
/**
@@ -4354,6 +4355,7 @@ These load from a `cordis.yml` entry with no `config:` block; they declare no co
| `@deepseek-ai/dsh-llm` | — | [`packages/llm/llm/src/index.ts`](../packages/llm/llm/src/index.ts) |
| `@deepseek-ai/dsh-lsp` | — | [`packages/lsp/lsp/src/index.ts`](../packages/lsp/lsp/src/index.ts) |
| `@deepseek-ai/dsh-mcp-resources` | `tools` | [`packages/mcp/mcp-resources/src/index.ts`](../packages/mcp/mcp-resources/src/index.ts) |
+| `@deepseek-ai/dsh-otel` | — | [`packages/telemetry/otel/src/index.ts`](../packages/telemetry/otel/src/index.ts) |
| `@deepseek-ai/dsh-sandbox-ssh` | `ssh` | [`packages/ssh/sandbox-ssh/src/index.ts`](../packages/ssh/sandbox-ssh/src/index.ts) |
| `@deepseek-ai/dsh-session` | — | [`packages/core/session/src/index.ts`](../packages/core/session/src/index.ts) |
| `@deepseek-ai/dsh-session-checkpoint-policy` | `llm` · `sessionPersistence` · `sessions` · `tools` | [`packages/session/session-checkpoint-policy/src/index.ts`](../packages/session/session-checkpoint-policy/src/index.ts) |
diff --git a/docs/config-catalog.zh.md b/docs/config-catalog.zh.md
index e6855a7e89..a01fd92d86 100644
--- a/docs/config-catalog.zh.md
+++ b/docs/config-catalog.zh.md
@@ -1437,7 +1437,8 @@ export interface Config {
## `@deepseek-ai/dsh-host-product-telemetry-otel`
-- `source`: [`packages/host/product-telemetry-otel/src/index.ts:37`](../packages/host/product-telemetry-otel/src/index.ts)
+- `inject`: `otel`
+- `source`: [`packages/host/product-telemetry-otel/src/index.ts:18`](../packages/host/product-telemetry-otel/src/index.ts)
```ts config-catalog
/** Collector routing, application identity, and bounded in-memory batch settings. */
@@ -2703,9 +2704,9 @@ export interface Config {
## `@deepseek-ai/dsh-session-telemetry-otel`
-- `inject`: `sessions`
+- `inject`: `sessions` · `otel`
- `refs`: `BatchLogRecordProcessorOptions` (`@opentelemetry/sdk-logs`) · `OTLPExporterNodeConfigBase` (`@opentelemetry/otlp-exporter-base`)
-- `source`: [`packages/session/session-telemetry-otel/src/index.ts:86`](../packages/session/session-telemetry-otel/src/index.ts)
+- `source`: [`packages/session/session-telemetry-otel/src/index.ts:87`](../packages/session/session-telemetry-otel/src/index.ts)
```ts config-catalog
/**
@@ -4356,6 +4357,7 @@ export interface Config {
| `@deepseek-ai/dsh-llm` | — | [`packages/llm/llm/src/index.ts`](../packages/llm/llm/src/index.ts) |
| `@deepseek-ai/dsh-lsp` | — | [`packages/lsp/lsp/src/index.ts`](../packages/lsp/lsp/src/index.ts) |
| `@deepseek-ai/dsh-mcp-resources` | `tools` | [`packages/mcp/mcp-resources/src/index.ts`](../packages/mcp/mcp-resources/src/index.ts) |
+| `@deepseek-ai/dsh-otel` | — | [`packages/telemetry/otel/src/index.ts`](../packages/telemetry/otel/src/index.ts) |
| `@deepseek-ai/dsh-sandbox-ssh` | `ssh` | [`packages/ssh/sandbox-ssh/src/index.ts`](../packages/ssh/sandbox-ssh/src/index.ts) |
| `@deepseek-ai/dsh-session` | — | [`packages/core/session/src/index.ts`](../packages/core/session/src/index.ts) |
| `@deepseek-ai/dsh-session-checkpoint-policy` | `llm` · `sessionPersistence` · `sessions` · `tools` | [`packages/session/session-checkpoint-policy/src/index.ts`](../packages/session/session-checkpoint-policy/src/index.ts) |
diff --git a/docs/module-graph.md b/docs/module-graph.md
index 95370f261d..de67896484 100644
--- a/docs/module-graph.md
+++ b/docs/module-graph.md
@@ -395,6 +395,9 @@ flowchart TD
pkg_subprocess_local["subprocess-local"]
pkg_win32_process["win32-process"]
end
+ subgraph group_telemetry["packages/telemetry"]
+ pkg_otel["otel"]
+ end
subgraph group_terminal["packages/terminal"]
pkg_terminal["terminal"]
pkg_terminal_bash["terminal-bash"]
@@ -510,6 +513,7 @@ flowchart TD
pkg_settings --> pkg_brand
pkg_settings --> pkg_invariants
pkg_settings --> pkg_session
+ pkg_otel --> pkg_session
pkg_session_snapshot --> pkg_http_proxy
pkg_session_snapshot --> pkg_session
pkg_fs --> pkg_brand
@@ -522,6 +526,7 @@ flowchart TD
pkg_hmr --> pkg_app_boot
pkg_hmr --> pkg_cmdline
pkg_experimental_speech_to_text --> pkg_settings
+ pkg_host_product_telemetry_otel --> pkg_otel
pkg_ptc_runtime --> pkg_sandbox
pkg_sandbox_local --> pkg_llm
pkg_sandbox_local --> pkg_sandbox
@@ -1037,6 +1042,7 @@ flowchart TD
pkg_session_telemetry_otel --> pkg_command_feedback
pkg_session_telemetry_otel --> pkg_llm
pkg_session_telemetry_otel --> pkg_message_feedback
+ pkg_session_telemetry_otel --> pkg_otel
pkg_session_telemetry_otel --> pkg_session
pkg_session_telemetry_otel --> pkg_session_telemetry
pkg_tool_bash --> pkg_agent
@@ -1462,7 +1468,6 @@ flowchart TD
| [`host-directory-picker-browse`](../packages/host/directory-picker-browse) | `host` | — |
| [`host-directory-picker-native`](../packages/host/directory-picker-native) | `host` | — |
| [`host-open-in-app`](../packages/host/open-in-app) | `host` | — |
-| [`host-product-telemetry-otel`](../packages/host/product-telemetry-otel) | `host` | — |
| [`host-webserver`](../packages/host/webserver) | `host` | — |
| [`invariants`](../packages/runtime-diagnostics/invariants) | `runtime-diagnostics` | — |
| [`session-format`](../packages/session/session-format) | `session` | — |
@@ -1522,12 +1527,14 @@ flowchart TD
| [`session-persistence`](../packages/session/session-persistence) | `session` | [`brand`](../packages/util/brand), [`session`](../packages/core/session), [`timeout`](../packages/util/timeout) |
| [`session-projection`](../packages/session/session-projection) | `session` | [`session`](../packages/core/session) |
| [`settings`](../packages/settings/settings) | `settings` | [`brand`](../packages/util/brand), [`invariants`](../packages/runtime-diagnostics/invariants), [`session`](../packages/core/session) |
+| [`otel`](../packages/telemetry/otel) | `telemetry` | [`session`](../packages/core/session) |
| [`session-snapshot`](../packages/test-support/session-snapshot) | `test-support` | [`http-proxy`](../packages/util/http-proxy), [`session`](../packages/core/session) |
| [`fs`](../packages/fs/fs) | `fs` | [`brand`](../packages/util/brand), [`invariants`](../packages/runtime-diagnostics/invariants), [`llm`](../packages/llm/llm), [`sandbox`](../packages/sandbox/sandbox) |
| [`spill-local`](../packages/spill/spill-local) | `spill` | [`spill`](../packages/spill/spill) |
| [`session-log-export`](../packages/session-query/session-log-export) | `session-query` | [`session`](../packages/core/session), [`session-persistence`](../packages/session/session-persistence) |
| [`hmr`](../packages/boot/hmr) | `boot` | [`app-boot`](../packages/boot/app-boot), [`cmdline`](../packages/boot/cmdline) |
| [`experimental-speech-to-text`](../packages/experimental/speech-to-text) | `experimental` | [`settings`](../packages/settings/settings) |
+| [`host-product-telemetry-otel`](../packages/host/product-telemetry-otel) | `host` | [`otel`](../packages/telemetry/otel) |
| [`ptc-runtime`](../packages/ptc-runtime/ptc-runtime) | `ptc-runtime` | [`sandbox`](../packages/sandbox/sandbox) |
| [`sandbox-local`](../packages/sandbox/sandbox-local) | `sandbox` | [`llm`](../packages/llm/llm), [`sandbox`](../packages/sandbox/sandbox), [`session`](../packages/core/session) |
| [`session-persistence-jsonl`](../packages/session/session-persistence-jsonl) | `session` | [`session`](../packages/core/session), [`session-persistence`](../packages/session/session-persistence) |
@@ -1637,7 +1644,7 @@ flowchart TD
| [`host-plugin-inventory`](../packages/host/plugin-inventory) | `host` | [`agent-preset-registry`](../packages/preset/agent-preset-registry), [`brand`](../packages/util/brand), [`typert-protocol`](../packages/typert/protocol) |
| [`mcp-client`](../packages/mcp/mcp-client) | `mcp` | [`attachment`](../packages/attachment/attachment), [`llm`](../packages/llm/llm), [`mcp-resources`](../packages/mcp/mcp-resources), [`scope`](../packages/core/scope), [`subprocess`](../packages/subprocess/subprocess), [`system-prompt`](../packages/core/system-prompt), [`timeout`](../packages/util/timeout), [`tools`](../packages/core/tools) |
| [`agent-preset`](../packages/preset/agent-preset) | `preset` | [`agent-preset-registry`](../packages/preset/agent-preset-registry) |
-| [`session-telemetry-otel`](../packages/session/session-telemetry-otel) | `session` | [`anonymous-user-id`](../packages/identity/anonymous-user-id), [`command-feedback`](../packages/feedback/command-feedback), [`llm`](../packages/llm/llm), [`message-feedback`](../packages/feedback/message-feedback), [`session`](../packages/core/session), [`session-telemetry`](../packages/session/session-telemetry) |
+| [`session-telemetry-otel`](../packages/session/session-telemetry-otel) | `session` | [`anonymous-user-id`](../packages/identity/anonymous-user-id), [`command-feedback`](../packages/feedback/command-feedback), [`llm`](../packages/llm/llm), [`message-feedback`](../packages/feedback/message-feedback), [`otel`](../packages/telemetry/otel), [`session`](../packages/core/session), [`session-telemetry`](../packages/session/session-telemetry) |
| [`tool-bash`](../packages/shell/tool-bash) | `shell` | [`agent`](../packages/core/agent), [`jobs`](../packages/jobs/jobs), [`llm`](../packages/llm/llm), [`sandbox`](../packages/sandbox/sandbox), [`sandbox-policy`](../packages/sandbox/sandbox-policy), [`shell`](../packages/shell/shell), [`shell-env`](../packages/shell/shell-env), [`system-prompt`](../packages/core/system-prompt), [`tools`](../packages/core/tools), [`user-approval`](../packages/interaction/user-approval) |
| [`tool-pwsh`](../packages/shell/tool-pwsh) | `shell` | [`agent`](../packages/core/agent), [`jobs`](../packages/jobs/jobs), [`llm`](../packages/llm/llm), [`sandbox`](../packages/sandbox/sandbox), [`sandbox-policy`](../packages/sandbox/sandbox-policy), [`shell`](../packages/shell/shell), [`shell-env`](../packages/shell/shell-env), [`system-prompt`](../packages/core/system-prompt), [`tools`](../packages/core/tools), [`user-approval`](../packages/interaction/user-approval) |
| [`fs-ssh`](../packages/ssh/fs-ssh) | `ssh` | [`fs`](../packages/fs/fs), [`sandbox`](../packages/sandbox/sandbox), [`sandbox-policy`](../packages/sandbox/sandbox-policy), [`ssh`](../packages/ssh/ssh) |
diff --git a/docs/module-graph.zh.md b/docs/module-graph.zh.md
index fa7306530d..6942a4d409 100644
--- a/docs/module-graph.zh.md
+++ b/docs/module-graph.zh.md
@@ -397,6 +397,9 @@ flowchart TD
pkg_subprocess_local["subprocess-local"]
pkg_win32_process["win32-process"]
end
+ subgraph group_telemetry["packages/telemetry"]
+ pkg_otel["otel"]
+ end
subgraph group_terminal["packages/terminal"]
pkg_terminal["terminal"]
pkg_terminal_bash["terminal-bash"]
@@ -512,6 +515,7 @@ flowchart TD
pkg_settings --> pkg_brand
pkg_settings --> pkg_invariants
pkg_settings --> pkg_session
+ pkg_otel --> pkg_session
pkg_session_snapshot --> pkg_http_proxy
pkg_session_snapshot --> pkg_session
pkg_fs --> pkg_brand
@@ -524,6 +528,7 @@ flowchart TD
pkg_hmr --> pkg_app_boot
pkg_hmr --> pkg_cmdline
pkg_experimental_speech_to_text --> pkg_settings
+ pkg_host_product_telemetry_otel --> pkg_otel
pkg_ptc_runtime --> pkg_sandbox
pkg_sandbox_local --> pkg_llm
pkg_sandbox_local --> pkg_sandbox
@@ -1039,6 +1044,7 @@ flowchart TD
pkg_session_telemetry_otel --> pkg_command_feedback
pkg_session_telemetry_otel --> pkg_llm
pkg_session_telemetry_otel --> pkg_message_feedback
+ pkg_session_telemetry_otel --> pkg_otel
pkg_session_telemetry_otel --> pkg_session
pkg_session_telemetry_otel --> pkg_session_telemetry
pkg_tool_bash --> pkg_agent
@@ -1464,7 +1470,6 @@ flowchart TD
| [`host-directory-picker-browse`](../packages/host/directory-picker-browse) | `host` | — |
| [`host-directory-picker-native`](../packages/host/directory-picker-native) | `host` | — |
| [`host-open-in-app`](../packages/host/open-in-app) | `host` | — |
-| [`host-product-telemetry-otel`](../packages/host/product-telemetry-otel) | `host` | — |
| [`host-webserver`](../packages/host/webserver) | `host` | — |
| [`invariants`](../packages/runtime-diagnostics/invariants) | `runtime-diagnostics` | — |
| [`session-format`](../packages/session/session-format) | `session` | — |
@@ -1524,12 +1529,14 @@ flowchart TD
| [`session-persistence`](../packages/session/session-persistence) | `session` | [`brand`](../packages/util/brand), [`session`](../packages/core/session), [`timeout`](../packages/util/timeout) |
| [`session-projection`](../packages/session/session-projection) | `session` | [`session`](../packages/core/session) |
| [`settings`](../packages/settings/settings) | `settings` | [`brand`](../packages/util/brand), [`invariants`](../packages/runtime-diagnostics/invariants), [`session`](../packages/core/session) |
+| [`otel`](../packages/telemetry/otel) | `telemetry` | [`session`](../packages/core/session) |
| [`session-snapshot`](../packages/test-support/session-snapshot) | `test-support` | [`http-proxy`](../packages/util/http-proxy), [`session`](../packages/core/session) |
| [`fs`](../packages/fs/fs) | `fs` | [`brand`](../packages/util/brand), [`invariants`](../packages/runtime-diagnostics/invariants), [`llm`](../packages/llm/llm), [`sandbox`](../packages/sandbox/sandbox) |
| [`spill-local`](../packages/spill/spill-local) | `spill` | [`spill`](../packages/spill/spill) |
| [`session-log-export`](../packages/session-query/session-log-export) | `session-query` | [`session`](../packages/core/session), [`session-persistence`](../packages/session/session-persistence) |
| [`hmr`](../packages/boot/hmr) | `boot` | [`app-boot`](../packages/boot/app-boot), [`cmdline`](../packages/boot/cmdline) |
| [`experimental-speech-to-text`](../packages/experimental/speech-to-text) | `experimental` | [`settings`](../packages/settings/settings) |
+| [`host-product-telemetry-otel`](../packages/host/product-telemetry-otel) | `host` | [`otel`](../packages/telemetry/otel) |
| [`ptc-runtime`](../packages/ptc-runtime/ptc-runtime) | `ptc-runtime` | [`sandbox`](../packages/sandbox/sandbox) |
| [`sandbox-local`](../packages/sandbox/sandbox-local) | `sandbox` | [`llm`](../packages/llm/llm), [`sandbox`](../packages/sandbox/sandbox), [`session`](../packages/core/session) |
| [`session-persistence-jsonl`](../packages/session/session-persistence-jsonl) | `session` | [`session`](../packages/core/session), [`session-persistence`](../packages/session/session-persistence) |
@@ -1639,7 +1646,7 @@ flowchart TD
| [`host-plugin-inventory`](../packages/host/plugin-inventory) | `host` | [`agent-preset-registry`](../packages/preset/agent-preset-registry), [`brand`](../packages/util/brand), [`typert-protocol`](../packages/typert/protocol) |
| [`mcp-client`](../packages/mcp/mcp-client) | `mcp` | [`attachment`](../packages/attachment/attachment), [`llm`](../packages/llm/llm), [`mcp-resources`](../packages/mcp/mcp-resources), [`scope`](../packages/core/scope), [`subprocess`](../packages/subprocess/subprocess), [`system-prompt`](../packages/core/system-prompt), [`timeout`](../packages/util/timeout), [`tools`](../packages/core/tools) |
| [`agent-preset`](../packages/preset/agent-preset) | `preset` | [`agent-preset-registry`](../packages/preset/agent-preset-registry) |
-| [`session-telemetry-otel`](../packages/session/session-telemetry-otel) | `session` | [`anonymous-user-id`](../packages/identity/anonymous-user-id), [`command-feedback`](../packages/feedback/command-feedback), [`llm`](../packages/llm/llm), [`message-feedback`](../packages/feedback/message-feedback), [`session`](../packages/core/session), [`session-telemetry`](../packages/session/session-telemetry) |
+| [`session-telemetry-otel`](../packages/session/session-telemetry-otel) | `session` | [`anonymous-user-id`](../packages/identity/anonymous-user-id), [`command-feedback`](../packages/feedback/command-feedback), [`llm`](../packages/llm/llm), [`message-feedback`](../packages/feedback/message-feedback), [`otel`](../packages/telemetry/otel), [`session`](../packages/core/session), [`session-telemetry`](../packages/session/session-telemetry) |
| [`tool-bash`](../packages/shell/tool-bash) | `shell` | [`agent`](../packages/core/agent), [`jobs`](../packages/jobs/jobs), [`llm`](../packages/llm/llm), [`sandbox`](../packages/sandbox/sandbox), [`sandbox-policy`](../packages/sandbox/sandbox-policy), [`shell`](../packages/shell/shell), [`shell-env`](../packages/shell/shell-env), [`system-prompt`](../packages/core/system-prompt), [`tools`](../packages/core/tools), [`user-approval`](../packages/interaction/user-approval) |
| [`tool-pwsh`](../packages/shell/tool-pwsh) | `shell` | [`agent`](../packages/core/agent), [`jobs`](../packages/jobs/jobs), [`llm`](../packages/llm/llm), [`sandbox`](../packages/sandbox/sandbox), [`sandbox-policy`](../packages/sandbox/sandbox-policy), [`shell`](../packages/shell/shell), [`shell-env`](../packages/shell/shell-env), [`system-prompt`](../packages/core/system-prompt), [`tools`](../packages/core/tools), [`user-approval`](../packages/interaction/user-approval) |
| [`fs-ssh`](../packages/ssh/fs-ssh) | `ssh` | [`fs`](../packages/fs/fs), [`sandbox`](../packages/sandbox/sandbox), [`sandbox-policy`](../packages/sandbox/sandbox-policy), [`ssh`](../packages/ssh/ssh) |
diff --git a/docs/subsystems/README.i18n.yaml b/docs/subsystems/README.i18n.yaml
index a7934d3e58..7051478b51 100644
--- a/docs/subsystems/README.i18n.yaml
+++ b/docs/subsystems/README.i18n.yaml
@@ -3,5 +3,5 @@
# After editing either side, bring the other along and re-record with:
# pnpm run verify-translation-pairing --write docs/subsystems/README.md
/subsystems:
- en: 58466f6fd60755eb
- zh: ab46a374f5a3c3ed
+ en: ab6cd11804f6b644
+ zh: 7a82dc5b22c40703
diff --git a/docs/subsystems/README.md b/docs/subsystems/README.md
index 479dbe7cb3..e2f8dc51e2 100644
--- a/docs/subsystems/README.md
+++ b/docs/subsystems/README.md
@@ -67,6 +67,7 @@ One page per subsystem of the DeepSeek Harness: what it is, the data structures
| [conversation.md](conversation.md) | target-neutral Session-event assembly: Context identity, Location data, replay paths, view builders, and target-owned render nodes |
| [session-projection.md](session-projection.md) | the projection seam: `SessionProjectionMap`, the pure `ProjectionDefinition` unit, `ProjectionSnapshot`'s consistent cut, the change feed |
| [session-telemetry.md](session-telemetry.md) | the outbound session-reporting capability seam: `SessionTelemetryRecord`/`SessionTelemetrySeverity`, the `SessionTelemetrySink` contract, and the `session-telemetry/record` redact waterfall |
+| [otel.md](otel.md) | Shared ordinary-event and Session-log OTLP channels |
| [product-telemetry.md](product-telemetry.md) | Explicit product analytics submission and OTLP/HTTP transport |
> Type declarations and their JSDoc on these pages are source-equivalent and drift-checked by `pnpm run verify-type-equiv` (see [development.md](../development.md#documenting-types-verbatim-ts-type-equiv)). Ordinary blocks preserve complete declarations; `public-api` blocks preserve body-stripped public class declarations. Cordis services and events use each page's generated **Cordis API** section.
diff --git a/docs/subsystems/README.zh.md b/docs/subsystems/README.zh.md
index a6b9226df6..31f4489d43 100644
--- a/docs/subsystems/README.zh.md
+++ b/docs/subsystems/README.zh.md
@@ -67,6 +67,7 @@
| [conversation.md](conversation.zh.md) | 目标无关的会话事件组装:上下文标识、位置数据、回放路径、视图构建器与目标自有的渲染节点 |
| [session-projection.md](session-projection.zh.md) | 投影 seam:`SessionProjectionMap`、纯函数 `ProjectionDefinition` 单元、`ProjectionSnapshot` 的一致切面、变更馈送 |
| [session-telemetry.md](session-telemetry.zh.md) | 对外会话上报能力 seam:`SessionTelemetryRecord`/`SessionTelemetrySeverity`、`SessionTelemetrySink` 约定和 `session-telemetry/record` 脱敏 waterfall(瀑布式事件) |
+| [otel.md](otel.zh.md) | 共享普通事件与 Session 日志 OTLP 通道 |
| [product-telemetry.md](product-telemetry.zh.md) | 显式产品分析事件提交与 OTLP/HTTP 传输 |
> 这些页面上的类型声明及其 JSDoc 与源码等价,并由 `pnpm run verify-type-equiv` 检查漂移(见 [development.md](../development.zh.md#documenting-types-verbatim-ts-type-equiv))。普通块保留完整声明;`public-api` 块保留去除实现体的公开 class 声明。Cordis 服务与事件使用每页生成的 **Cordis API** 小节。
diff --git a/docs/subsystems/otel.i18n.yaml b/docs/subsystems/otel.i18n.yaml
new file mode 100644
index 0000000000..7547678647
--- /dev/null
+++ b/docs/subsystems/otel.i18n.yaml
@@ -0,0 +1,7 @@
+# Bilingual-pair consistency record for otel.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
+# pnpm run verify-translation-pairing --write docs/subsystems/otel.md
+/otel-reporting:
+ en: adf67758d37c46f2
+ zh: 9e41b63531fa875a
diff --git a/docs/subsystems/otel.md b/docs/subsystems/otel.md
new file mode 100644
index 0000000000..bcba92f51b
--- /dev/null
+++ b/docs/subsystems/otel.md
@@ -0,0 +1,44 @@
+# OTel reporting
+
+English | [中文](otel.zh.md)
+
+The [OTel plugin](../../packages/telemetry/otel/README.md) registers `ctx.otel`, a shared factory for independent ordinary-event and Session-log channels. It owns SDK transport and batching implementations. Business consumers inject the service, supply explicit transport/resource/scope options, and own each returned channel's shutdown.
+
+UI feedback reaches the Session feedback services through their existing Remote APIs. Feedback recording authorizes the Session adapter's canonical-prefix capture and redaction before it reports through an OTel channel. Ordinary product consumers submit selected fields through the product adapter. The shared service has no automatic identity or capture policy, and channels never share queues or requests.
+
+The [product adapter](../../packages/host/product-telemetry-otel/README.md) and [Session adapter](../../packages/session/session-telemetry-otel/README.md) retain their deployment configuration and disposal deadlines. Consumers must not reuse a channel after shutdown. Mounting only the OTel service allocates no provider or transport.
+
+
+
+
+
+## Cordis API
+
+Generated from source by `scripts/gen-cordis-catalog.ts` (verified fresh by `pnpm run verify-cordis-catalog` in doc-sync; regenerate with `pnpm run gen-cordis-catalog`) — the language sides differ only in locale-specific paired document paths. Signature blocks use a `ts cordis-catalog` fence and keep the original source JSDoc; dispatch modes are defined in the [primer](../cordis-primer.md#dispatch-modes), and the framework-inherited `ctx` API lives in [cordis-api/inherited.md](../cordis-api/inherited.md).
+
+
+
+### `ctx.otel` — `OTel`
+
+Shared transport provider. Mounting creates no queue, identity, or network connection.
+
+```ts cordis-catalog
+/**
+ * Create an independent ordinary-event channel with count-based batching.
+ * The injected consumer must drain it during its fiber disposal.
+ * @param options - transport, scope, resource, queue, and diagnostic settings selected by the consumer.
+ * @returns the caller-owned channel; no state is shared with other channels.
+ */
+createEventReporter(options: EventLogOptions): EventLogReporter
+
+/**
+ * Create an independent byte-bounded Session-log channel.
+ * Authorization and redaction precede reporting; the consumer owns shutdown and its outer deadline.
+ * @param options - transport, scope, resource, queue, and diagnostic settings selected by the consumer.
+ * @returns the caller-owned channel, preserving complete accepted events within the request byte ceiling.
+ */
+createSessionLogReporter(options: SessionLogOptions): SessionLogReporter
+```
+
+Source: [`packages/telemetry/otel/src/index.ts`](../../packages/telemetry/otel/src/index.ts)
+
diff --git a/docs/subsystems/otel.zh.md b/docs/subsystems/otel.zh.md
new file mode 100644
index 0000000000..dbe7f3cb9e
--- /dev/null
+++ b/docs/subsystems/otel.zh.md
@@ -0,0 +1,44 @@
+# OTel 上报
+
+[English](otel.md) | 中文
+
+[OTel 插件](../../packages/telemetry/otel/README.zh.md) 注册 `ctx.otel`,作为独立普通事件通道和 Session 日志通道的共享工厂。它持有 SDK 传输与聚合实现。业务调用方注入服务,显式提供传输、resource 和 scope 选项,并负责返回通道的关闭。
+
+UI 反馈通过现有 Remote API 到达 Session 反馈服务。记录反馈后,Session 适配器才获得规范日志前缀的捕获授权,完成脱敏后通过 OTel 通道上报。普通产品调用方通过产品适配器提交选定字段。共享服务没有自动身份或捕获策略,通道之间不共享队列或请求。
+
+[产品适配器](../../packages/host/product-telemetry-otel/README.zh.md) 和 [Session 适配器](../../packages/session/session-telemetry-otel/README.zh.md) 保留各自部署配置及销毁期限。通道关闭后调用方不得复用。只挂载 OTel 服务不会分配 provider 或 transport。
+
+
+
+
+
+## Cordis API
+
+Generated from source by `scripts/gen-cordis-catalog.ts` (verified fresh by `pnpm run verify-cordis-catalog` in doc-sync; regenerate with `pnpm run gen-cordis-catalog`) — the language sides differ only in locale-specific paired document paths. Signature blocks use a `ts cordis-catalog` fence and keep the original source JSDoc; dispatch modes are defined in the [primer](../cordis-primer.zh.md#dispatch-modes), and the framework-inherited `ctx` API lives in [cordis-api/inherited.md](../cordis-api/inherited.md).
+
+
+
+### `ctx.otel` — `OTel`
+
+Shared transport provider. Mounting creates no queue, identity, or network connection.
+
+```ts cordis-catalog
+/**
+ * Create an independent ordinary-event channel with count-based batching.
+ * The injected consumer must drain it during its fiber disposal.
+ * @param options - transport, scope, resource, queue, and diagnostic settings selected by the consumer.
+ * @returns the caller-owned channel; no state is shared with other channels.
+ */
+createEventReporter(options: EventLogOptions): EventLogReporter
+
+/**
+ * Create an independent byte-bounded Session-log channel.
+ * Authorization and redaction precede reporting; the consumer owns shutdown and its outer deadline.
+ * @param options - transport, scope, resource, queue, and diagnostic settings selected by the consumer.
+ * @returns the caller-owned channel, preserving complete accepted events within the request byte ceiling.
+ */
+createSessionLogReporter(options: SessionLogOptions): SessionLogReporter
+```
+
+Source: [`packages/telemetry/otel/src/index.ts`](../../packages/telemetry/otel/src/index.ts)
+
diff --git a/docs/subsystems/product-telemetry.md b/docs/subsystems/product-telemetry.md
index d86540d5a2..10732ec45b 100644
--- a/docs/subsystems/product-telemetry.md
+++ b/docs/subsystems/product-telemetry.md
@@ -11,24 +11,13 @@ Enqueue is synchronous and does not acknowledge delivery. The SDK owns batching
## Record types
```ts type-equiv
-/** Scalar values accepted by the collector's Arrow attributes map. */
-type ProductTelemetryScalar = string | number | boolean
+/** Scalar values accepted in product attributes. */
+type ProductTelemetryScalar = OTelEventScalar
```
```ts type-equiv
-/** Explicitly selected analytics fields; object values may contain scalars only. */
-interface ProductTelemetryRecord {
- /** Product/DA-owned event name. */
- eventName: string
- /** Human-readable summary; never a prompt, response, credential, or file contents. */
- body: string
- /** Event occurrence time in Unix milliseconds. Observation time is assigned on enqueue. */
- timestamp: number
- /** OTel severity; omitted values use INFO. */
- severityNumber?: SeverityNumber
- /** Business fields selected by the caller; no automatic device or account identity. */
- attributes?: Record>
-}
+/** Caller-selected ordinary analytics record. */
+type ProductTelemetryRecord = OTelEventRecord
```
Source: [`packages/host/product-telemetry-otel/src/index.ts`](../../packages/host/product-telemetry-otel/src/index.ts)
diff --git a/docs/subsystems/product-telemetry.zh.md b/docs/subsystems/product-telemetry.zh.md
index 52ad119363..6747e31310 100644
--- a/docs/subsystems/product-telemetry.zh.md
+++ b/docs/subsystems/product-telemetry.zh.md
@@ -11,24 +11,13 @@
## 记录类型
```ts type-equiv
-/** Scalar values accepted by the collector's Arrow attributes map. */
-type ProductTelemetryScalar = string | number | boolean
+/** Scalar values accepted in product attributes. */
+type ProductTelemetryScalar = OTelEventScalar
```
```ts type-equiv
-/** Explicitly selected analytics fields; object values may contain scalars only. */
-interface ProductTelemetryRecord {
- /** Product/DA-owned event name. */
- eventName: string
- /** Human-readable summary; never a prompt, response, credential, or file contents. */
- body: string
- /** Event occurrence time in Unix milliseconds. Observation time is assigned on enqueue. */
- timestamp: number
- /** OTel severity; omitted values use INFO. */
- severityNumber?: SeverityNumber
- /** Business fields selected by the caller; no automatic device or account identity. */
- attributes?: Record>
-}
+/** Caller-selected ordinary analytics record. */
+type ProductTelemetryRecord = OTelEventRecord
```
Source: [`packages/host/product-telemetry-otel/src/index.ts`](../../packages/host/product-telemetry-otel/src/index.ts)
diff --git a/packages/README.i18n.yaml b/packages/README.i18n.yaml
index d091e6d74c..f9879d6dcd 100644
--- a/packages/README.i18n.yaml
+++ b/packages/README.i18n.yaml
@@ -15,8 +15,8 @@
en: ffc55792d6e922e1
zh: 83bd759638857e2d
/packages/package-groups:
- en: 2818a70fa6bbb1b6
- zh: 800b34102e82c192
+ en: d865abbfa65d1d4f
+ zh: ea079b795b51dd55
/packages/release-expectations:
en: 1ab880da3642bde1
zh: 6e168322f026a9cf
diff --git a/packages/README.md b/packages/README.md
index 54c4cdc758..cfb5ea6c74 100644
--- a/packages/README.md
+++ b/packages/README.md
@@ -34,6 +34,7 @@ Every package lives in exactly one group; new packages join existing groups, and
| [`goal/`](goal/README.md) | Same-session goal persistence and lifecycle |
| [`schedule/`](schedule/README.md) | Host-owned scheduled follow-ups |
| [`feedback/`](feedback/README.md) | Human feedback capture and command |
+| [`telemetry/`](telemetry/README.md) | Shared Cordis OTel reporting channels |
| [`identity/`](identity/README.md) | Shared anonymous identity |
| [`llm/`](llm/README.md) | LLM capability family: abstract service + provider adapters |
| [`subprocess/`](subprocess/README.md) | Subprocess capability family: Service Definition + local process-tree provider |
diff --git a/packages/README.zh.md b/packages/README.zh.md
index 9ea4426082..2edb62d8cd 100644
--- a/packages/README.zh.md
+++ b/packages/README.zh.md
@@ -34,6 +34,7 @@ harness 由 `packages/` 下的 npm 包组装而成,按能力系列分组:会
| [`goal/`](goal/README.zh.md) | 同会话 goal 的持久化与生命周期 |
| [`schedule/`](schedule/README.zh.md) | Host 拥有的定时后续操作 |
| [`feedback/`](feedback/README.zh.md) | 人类反馈的采集与命令 |
+| [`telemetry/`](telemetry/README.zh.md) | 共享 Cordis OTel 上报通道 |
| [`identity/`](identity/README.zh.md) | 共享匿名身份 |
| [`llm/`](llm/README.zh.md) | LLM(大语言模型)能力系列:抽象服务 + 提供方适配器 |
| [`subprocess/`](subprocess/README.zh.md) | 子进程能力系列:Service Definition + 本地进程树提供方 |
diff --git a/packages/bundle/base/cordis.patch.yml b/packages/bundle/base/cordis.patch.yml
index 821dbda459..9c35ebf5c2 100644
--- a/packages/bundle/base/cordis.patch.yml
+++ b/packages/bundle/base/cordis.patch.yml
@@ -185,6 +185,9 @@
writeEveryEvents: 200
writeIntervalMs: 5000
+ - id: otel
+ name: '@deepseek-ai/dsh-otel'
+
# OTel releases a Session-log prefix only after explicit user feedback,
# regardless of model provider. Ordinary activity never triggers capture.
# DSH_TELEMETRY_OTLP_URL overrides the production endpoint. A non-empty
diff --git a/packages/bundle/base/package.json b/packages/bundle/base/package.json
index e5b0025eaa..51b37cf282 100644
--- a/packages/bundle/base/package.json
+++ b/packages/bundle/base/package.json
@@ -125,7 +125,8 @@
"@deepseek-ai/dsh-authorization": "workspace:*",
"@deepseek-ai/dsh-deepseek-account-platform": "workspace:*",
"@deepseek-ai/dsh-config-editor": "workspace:*",
- "@deepseek-ai/dsh-settings": "workspace:*"
+ "@deepseek-ai/dsh-settings": "workspace:*",
+ "@deepseek-ai/dsh-otel": "workspace:*"
},
"peerDependencies": {
"@deepseek-ai/cordis": "workspace:~"
diff --git a/packages/extensions/tool-cordis/src/api-catalog.ts b/packages/extensions/tool-cordis/src/api-catalog.ts
index 1d8e577a09..c1cf57a74f 100644
--- a/packages/extensions/tool-cordis/src/api-catalog.ts
+++ b/packages/extensions/tool-cordis/src/api-catalog.ts
@@ -1541,6 +1541,25 @@ export const SERVICE_API: readonly ServiceApiEntry[] = [
},
],
},
+ {
+ key: 'otel',
+ summary: 'Shared transport provider.',
+ description: 'Shared transport provider. Mounting creates no queue, identity, or network connection.',
+ methods: [
+ {
+ signature: 'createEventReporter(options: EventLogOptions): EventLogReporter',
+ description: 'Create an independent ordinary-event channel with count-based batching. The injected consumer must drain it during its fiber disposal.',
+ parameters: [{ name: 'options', description: 'transport, scope, resource, queue, and diagnostic settings selected by the consumer.' }],
+ returns: 'the caller-owned channel; no state is shared with other channels.',
+ },
+ {
+ signature: 'createSessionLogReporter(options: SessionLogOptions): SessionLogReporter',
+ description: 'Create an independent byte-bounded Session-log channel. Authorization and redaction precede reporting; the consumer owns shutdown and its outer deadline.',
+ parameters: [{ name: 'options', description: 'transport, scope, resource, queue, and diagnostic settings selected by the consumer.' }],
+ returns: 'the caller-owned channel, preserving complete accepted events within the request byte ceiling.',
+ },
+ ],
+ },
{
key: 'permissionPresets',
summary: 'Owns the deployment\'s configured permission presets, the fixed Auto integration hook, and their write path.',
@@ -5081,6 +5100,14 @@ export const TYPE_API: readonly TypeApiEntry[] = [
name: 'EpochHeader',
declaration: 'export interface EpochHeader {\n config: LlmCallConfig;\n adapterDefaults?: LlmCallConfigAdapterDefaults;\n tools?: ToolSchema[];\n system?: never;\n}',
},
+ {
+ name: 'EventLogOptions',
+ declaration: 'export interface EventLogOptions {\n exporter: SessionLogOptions[\'exporter\'];\n resourceAttributes: Attributes;\n scope: {\n name: string;\n version?: string;\n };\n processor: Omit;\n onFailure: SessionLogOptions[\'onFailure\'];\n}',
+ },
+ {
+ name: 'EventLogReporter',
+ declaration: 'export class EventLogReporter {\n constructor(options: EventLogOptions);\n emit(record: OTelEventRecord): void;\n shutdown(): Promise;\n}',
+ },
{
name: 'EveryScheduleRecord',
declaration: 'export interface EveryScheduleRecord {\n readonly id: ScheduleId;\n readonly kind: \'every\';\n readonly title: string;\n readonly prompt: string;\n readonly everySeconds: number;\n readonly scheduledAt: string;\n}',
@@ -5801,6 +5828,14 @@ export const TYPE_API: readonly TypeApiEntry[] = [
name: 'OptionalSessionSeq',
declaration: 'export type OptionalSessionSeq = SessionSeq | null;',
},
+ {
+ name: 'OTelEventRecord',
+ declaration: 'export interface OTelEventRecord {\n eventName: string;\n body: string;\n timestamp: number;\n severityNumber?: SeverityNumber;\n attributes?: Record>;\n}',
+ },
+ {
+ name: 'OTelEventScalar',
+ declaration: 'export type OTelEventScalar = string | number | boolean;',
+ },
{
name: 'PackageResult',
declaration: 'export interface PackageResult {\n exitCode: number;\n output: string;\n truncated: boolean;\n logPath: string;\n kind?: PluginInstallFailureKind;\n timedOut?: boolean;\n incompatible?: IncompatiblePlugin[];\n}',
@@ -5931,11 +5966,7 @@ export const TYPE_API: readonly TypeApiEntry[] = [
},
{
name: 'ProductTelemetryRecord',
- declaration: 'export interface ProductTelemetryRecord {\n eventName: string;\n body: string;\n timestamp: number;\n severityNumber?: SeverityNumber;\n attributes?: Record>;\n}',
- },
- {
- name: 'ProductTelemetryScalar',
- declaration: 'export type ProductTelemetryScalar = string | number | boolean;',
+ declaration: 'export type ProductTelemetryRecord = OTelEventRecord;',
},
{
name: 'ProfilePnpmInvocation',
@@ -6561,6 +6592,18 @@ export const TYPE_API: readonly TypeApiEntry[] = [
name: 'SessionLogOffset',
declaration: 'export type SessionLogOffset = BrandedNumber<\'SessionLogOffset\'>;',
},
+ {
+ name: 'SessionLogOptions',
+ declaration: 'export interface SessionLogOptions {\n exporter: OTLPExporterNodeConfigBase & {\n url: string;\n };\n processor?: Omit;\n maxRequestBytes?: number;\n scope: {\n name: string;\n version?: string;\n };\n resourceAttributes: Attributes;\n onFailure: (message: string, error?: Error) => void;\n}',
+ },
+ {
+ name: 'SessionLogRecord',
+ declaration: 'export interface SessionLogRecord {\n sessionId: SessionId;\n event: Omit & {\n data: unknown;\n };\n attributes?: Attributes;\n severityNumber?: SeverityNumber;\n}',
+ },
+ {
+ name: 'SessionLogReporter',
+ declaration: 'export class SessionLogReporter {\n constructor(options: SessionLogOptions);\n reportSessionLog(record: SessionLogRecord): void;\n stopPending(): void;\n shutdown(): Promise;\n}',
+ },
{
name: 'SessionLogSnapshot',
declaration: 'export interface SessionLogSnapshot {\n session: SessionHeader;\n inheritedEventCount: SessionLogOffset;\n events: SessionEvent[];\n}',
diff --git a/packages/host/product-telemetry-otel/README.i18n.yaml b/packages/host/product-telemetry-otel/README.i18n.yaml
index e35c7672f8..5c840f876c 100644
--- a/packages/host/product-telemetry-otel/README.i18n.yaml
+++ b/packages/host/product-telemetry-otel/README.i18n.yaml
@@ -18,8 +18,8 @@
en: 08e0bcbc259d131b
zh: 1d7cbde2688a903f
/deepseek-ai-dsh-host-product-telemetry-otel/understand-the-implementation:
- en: 5d2c06a357a1c06a
- zh: 9a1a17535889f5e3
+ en: d7807324fdeb2b42
+ zh: 1bfe1e943e513500
/deepseek-ai-dsh-host-product-telemetry-otel/further-exploration:
en: 6bfb5e8a723ff0a9
zh: fffc6b02e2c1a3cb
diff --git a/packages/host/product-telemetry-otel/README.md b/packages/host/product-telemetry-otel/README.md
index af1f2c415f..f5b00d1496 100644
--- a/packages/host/product-telemetry-otel/README.md
+++ b/packages/host/product-telemetry-otel/README.md
@@ -28,6 +28,7 @@ Send selected product usage events to an OTLP/HTTP collector. Events carry a nam
Mount the plugin in a Cordis composition with the application identity; override the collector endpoint when needed. The shipped profiles do not mount it. Set `DSH_APP_VERSION` to the running application release version in the launcher environment; the schema rejects an absent version.
```yaml
+- name: '@deepseek-ai/dsh-otel'
- name: '@deepseek-ai/dsh-host-product-telemetry-otel'
config:
endpoint: https://dsh-otel-collector.deepseeksvc.com/v1/logs
@@ -65,7 +66,7 @@ The collector expects a string body and attributes containing strings, numbers,
Implementation internals — click to expand
-A private OTel logger feeds `BatchLogRecordProcessor` and the SDK HTTP delegate with its JSON log serializer. The delegate receives explicit headers and an HTTP agent; only shared timeout and compression settings use SDK environment resolution. The direct `@opentelemetry/core` dependency matches `sdk-logs` at 2.9.0 so exporter result enums share one TypeScript identity. The SDK owns queueing, transient-error retries, and compression; plugin disposal drains pending records with a bounded wait. Export completion is observed separately because SDK shutdown can resolve after a rejected export. No global OTel provider is installed.
+The adapter injects `otel` and creates an independent ordinary-event channel through `ctx.otel.createEventReporter()`. The [shared OTel plugin](../../telemetry/otel/README.md) owns SDK transport and batching; this adapter owns analytics configuration and its bounded shutdown wait. No global OTel provider is installed.
[`src/index.ts`](src/index.ts) owns configuration and submission. No runtime invariant companion is published: delivery has no independent local acknowledgement to compare with the SDK's queue.
diff --git a/packages/host/product-telemetry-otel/README.zh.md b/packages/host/product-telemetry-otel/README.zh.md
index ffdb682d9a..8d88254368 100644
--- a/packages/host/product-telemetry-otel/README.zh.md
+++ b/packages/host/product-telemetry-otel/README.zh.md
@@ -28,6 +28,7 @@ kind: "package-reference"
在 Cordis 组合中挂载插件并提供应用标识;需要时可覆盖接收地址。内置 profile 不挂载本插件。启动器环境须将 `DSH_APP_VERSION` 设为运行中应用的发布版本;缺少版本时 schema 会拒绝配置。
```yaml
+- name: '@deepseek-ai/dsh-otel'
- name: '@deepseek-ai/dsh-host-product-telemetry-otel'
config:
endpoint: https://dsh-otel-collector.deepseeksvc.com/v1/logs
@@ -65,7 +66,7 @@ kind: "package-reference"
实现细节——点击展开
-私有 OTel logger 将记录交给 `BatchLogRecordProcessor`,再由 SDK HTTP delegate 和 JSON 日志序列化器发送。delegate 使用显式请求头和 HTTP agent,只有共享的超时与压缩配置使用 SDK 环境变量解析。直接依赖的 `@opentelemetry/core` 与 `sdk-logs` 对齐为 2.9.0,使导出结果枚举共享同一个 TypeScript 类型身份。SDK 负责队列、临时错误重试与压缩;插件卸载时在限定时间内发送剩余记录。发送完成结果单独观测,因为 SDK 在发送被拒绝后仍可能正常完成退出。不安装全局 OTel provider。
+适配器注入 `otel`,通过 `ctx.otel.createEventReporter()` 创建独立的普通事件通道。[共享 OTel 插件](../../telemetry/otel/README.zh.md) 负责 SDK 传输和聚合;本适配器负责埋点配置及有期限的关闭等待。不安装全局 OTel provider。
[`src/index.ts`](src/index.ts) 负责配置与提交。不发布运行时不变量伴随模块:本地没有独立的送达确认可与 SDK 队列比较。
diff --git a/packages/host/product-telemetry-otel/package.json b/packages/host/product-telemetry-otel/package.json
index 29c291020d..6a5ba372cb 100644
--- a/packages/host/product-telemetry-otel/package.json
+++ b/packages/host/product-telemetry-otel/package.json
@@ -28,21 +28,19 @@
"license": "MIT",
"dependencies": {
"@deepseek-ai/schemastery": "workspace:~",
- "@opentelemetry/api": "^1.9.1",
"@opentelemetry/api-logs": "^0.220.0",
- "@opentelemetry/core": "2.9.0",
"@opentelemetry/otlp-exporter-base": "^0.220.0",
- "@opentelemetry/otlp-transformer": "^0.220.0",
- "@opentelemetry/resources": "^2.9.0",
"@opentelemetry/sdk-logs": "^0.220.0"
},
"peerDependencies": {
- "@deepseek-ai/cordis": "workspace:~"
+ "@deepseek-ai/cordis": "workspace:~",
+ "@deepseek-ai/dsh-otel": "workspace:*"
},
"devDependencies": {
"@deepseek-ai/cordis": "workspace:~",
"@deepseek-ai/cordis-plugin-loader": "workspace:~",
"@deepseek-ai/dsh-app-boot": "workspace:*",
- "@deepseek-ai/dsh-loader-smoke": "workspace:*"
+ "@deepseek-ai/dsh-loader-smoke": "workspace:*",
+ "@deepseek-ai/dsh-otel": "workspace:*"
}
}
diff --git a/packages/host/product-telemetry-otel/src/index.ts b/packages/host/product-telemetry-otel/src/index.ts
index eef6ec5dce..ec2eda239e 100644
--- a/packages/host/product-telemetry-otel/src/index.ts
+++ b/packages/host/product-telemetry-otel/src/index.ts
@@ -1,37 +1,18 @@
-/** Explicit product usage events over OTLP/HTTP; no automatic collection or Session access. */
+/** Product analytics policy adapter for the shared Cordis OTel service. */
import { Context, Service } from '@deepseek-ai/cordis'
import z from '@deepseek-ai/schemastery'
-import { SeverityNumber, type Logger } from '@opentelemetry/api-logs'
import { validateHeaderValue } from 'node:http'
-import { JsonLogsSerializer } from '@opentelemetry/otlp-transformer'
-import { createOtlpHttpExportDelegate, getSharedConfigurationFromEnvironment, httpAgentFactoryFromOptions } from '@opentelemetry/otlp-exporter-base/node-http'
-import { CompressionAlgorithm, getSharedConfigurationDefaults, mergeOtlpSharedConfigurationWithDefaults, OTLPExporterBase } from '@opentelemetry/otlp-exporter-base'
-import { ExportResultCode } from '@opentelemetry/core'
-import { resourceFromAttributes } from '@opentelemetry/resources'
-import { BatchLogRecordProcessor, LoggerProvider } from '@opentelemetry/sdk-logs'
+import { CompressionAlgorithm } from '@opentelemetry/otlp-exporter-base'
+import type { EventLogReporter, OTelEventRecord, OTelEventScalar } from '@deepseek-ai/dsh-otel'
declare module '@deepseek-ai/cordis' {
- interface Context {
- productTelemetry: ProductTelemetry
- }
+ interface Context { productTelemetry: ProductTelemetry }
}
-/** Scalar values accepted by the collector's Arrow attributes map. */
-export type ProductTelemetryScalar = string | number | boolean
-
-/** Explicitly selected analytics fields; object values may contain scalars only. */
-export interface ProductTelemetryRecord {
- /** Product/DA-owned event name. */
- eventName: string
- /** Human-readable summary; never a prompt, response, credential, or file contents. */
- body: string
- /** Event occurrence time in Unix milliseconds. Observation time is assigned on enqueue. */
- timestamp: number
- /** OTel severity; omitted values use INFO. */
- severityNumber?: SeverityNumber
- /** Business fields selected by the caller; no automatic device or account identity. */
- attributes?: Record>
-}
+/** Caller-selected ordinary analytics record. */
+export type ProductTelemetryRecord = OTelEventRecord
+/** Scalar values accepted in product attributes. */
+export type ProductTelemetryScalar = OTelEventScalar
/** Collector routing, application identity, and bounded in-memory batch settings. */
export interface Config {
@@ -78,8 +59,9 @@ export const Config: z, Config> = z.object({
/** Host analytics sender. Mounting alone sends nothing; the owning fiber drains it on unload. */
export default class ProductTelemetry extends Service {
+ static inject = ['otel']
static Config = Config
- private readonly logger: Logger
+ private readonly reporter: EventLogReporter
constructor(ctx: Context, config: Config) {
let endpoint: URL
@@ -100,44 +82,20 @@ export default class ProductTelemetry extends Service {
throw new Error('product-telemetry-otel: maxExportBatchSize must not exceed maxQueueSize')
}
super(ctx, 'productTelemetry')
- const shared = mergeOtlpSharedConfigurationWithDefaults({
- timeoutMillis: config.timeoutMillis,
- ...(config.compression === undefined ? {} : {
- compression: config.compression === 'gzip' ? CompressionAlgorithm.GZIP : CompressionAlgorithm.NONE,
- }),
- }, getSharedConfigurationFromEnvironment('LOGS'), getSharedConfigurationDefaults())
- const transport = {
- ...shared,
- url: config.endpoint,
- // This collector must not inherit another endpoint's headers or TLS client identity.
- headers: () => Promise.resolve({ 'Content-Type': 'application/json', 'x-channel': config.channel }),
- agentFactory: httpAgentFactoryFromOptions({ keepAlive: true }),
- }
- const exporter = new OTLPExporterBase(createOtlpHttpExportDelegate(transport, JsonLogsSerializer))
- const provider = new LoggerProvider({
- resource: resourceFromAttributes({
- 'service.name': config.serviceName,
- 'service.version': config.serviceVersion,
- }),
- processors: [new BatchLogRecordProcessor({
- maxExportBatchSize: config.maxExportBatchSize,
- maxQueueSize: config.maxQueueSize,
- scheduledDelayMillis: config.scheduledDelayMillis,
- exportTimeoutMillis: config.exportTimeoutMillis,
- exporter: {
- export: (records, callback) => {
- exporter.export(records, (result) => {
- // SDK flush/shutdown can resolve after export failure; observe the actual completion.
- if (result.code !== ExportResultCode.SUCCESS) ctx.logger.warn('Product telemetry export failed', result.error)
- callback(result)
- })
- },
- forceFlush: () => exporter.forceFlush(),
- shutdown: () => exporter.shutdown(),
- },
- })],
+ const reporter = ctx.otel.createEventReporter({
+ exporter: {
+ url: config.endpoint, headers: { 'x-channel': config.channel }, timeoutMillis: config.timeoutMillis,
+ ...(config.compression === undefined ? {} : { compression: config.compression === 'gzip' ? CompressionAlgorithm.GZIP : CompressionAlgorithm.NONE }),
+ },
+ resourceAttributes: { 'service.name': config.serviceName, 'service.version': config.serviceVersion },
+ scope: { name: '@deepseek-ai/dsh-host-product-telemetry-otel' },
+ processor: {
+ maxExportBatchSize: config.maxExportBatchSize, maxQueueSize: config.maxQueueSize,
+ scheduledDelayMillis: config.scheduledDelayMillis, exportTimeoutMillis: config.exportTimeoutMillis,
+ },
+ onFailure: (message, error) => { ctx.logger.warn(message, error) },
})
- this.logger = provider.getLogger('@deepseek-ai/dsh-host-product-telemetry-otel')
+ this.reporter = reporter
ctx.effect(() => async () => {
let timer!: ReturnType
const deadline = new Promise((resolve) => {
@@ -147,7 +105,7 @@ export default class ProductTelemetry extends Service {
}, config.shutdownTimeoutMillis)
})
try {
- await Promise.race([provider.shutdown(), deadline])
+ await Promise.race([reporter.shutdown(), deadline])
} finally {
clearTimeout(timer)
}
@@ -160,12 +118,6 @@ export default class ProductTelemetry extends Service {
* @param record - caller-owned event containing only approved analytics fields.
*/
emit(record: ProductTelemetryRecord): void {
- const severityNumber = record.severityNumber ?? SeverityNumber.INFO
- this.logger.emit({
- ...record,
- observedTimestamp: Date.now(),
- severityNumber,
- severityText: SeverityNumber[severityNumber],
- })
+ this.reporter.emit(record)
}
}
diff --git a/packages/host/product-telemetry-otel/tests/telemetry.spec.ts b/packages/host/product-telemetry-otel/tests/telemetry.spec.ts
index 22f7df5c30..eadaf49f12 100644
--- a/packages/host/product-telemetry-otel/tests/telemetry.spec.ts
+++ b/packages/host/product-telemetry-otel/tests/telemetry.spec.ts
@@ -1,3 +1,4 @@
+import OTel from '@deepseek-ai/dsh-otel'
import { createServer, type IncomingHttpHeaders } from 'node:http'
import { once } from 'node:events'
import { gunzipSync } from 'node:zlib'
@@ -58,7 +59,8 @@ function config(endpoint: string, overrides: Partial = {}): Config {
function context() {
const ctx = new Context()
- cleanup.push(() => ctx.fiber.dispose())
+ const ready = ctx.plugin(OTel)
+ cleanup.push(async () => { await ready; await ctx.fiber.dispose() })
return ctx
}
@@ -201,3 +203,16 @@ describe('explicit product telemetry', () => {
await vi.advanceTimersByTimeAsync(0)
})
})
+
+it('drains the dependent product channel when the shared OTel plugin unloads', async () => {
+ const target = await collector()
+ const ctx = new Context()
+ cleanup.push(() => ctx.fiber.dispose())
+ const service = await ctx.plugin(OTel)
+ await ctx.plugin(ProductTelemetry, config(target.endpoint))
+ ctx.productTelemetry.emit(event)
+ await service.dispose()
+ expect(ctx.get('otel')).toBeUndefined()
+ expect(ctx.get('productTelemetry')).toBeUndefined()
+ expect(target.captures).toHaveLength(1)
+})
diff --git a/packages/host/product-telemetry-otel/tsconfig.json b/packages/host/product-telemetry-otel/tsconfig.json
index f0063ae28d..2c542e3a1f 100644
--- a/packages/host/product-telemetry-otel/tsconfig.json
+++ b/packages/host/product-telemetry-otel/tsconfig.json
@@ -16,6 +16,9 @@
},
{
"path": "../../../vendor/schemastery"
+ },
+ {
+ "path": "../../telemetry/otel"
}
]
}
diff --git a/packages/preset/agent-preset/skills/cordis-composition-reference/references/packages.md b/packages/preset/agent-preset/skills/cordis-composition-reference/references/packages.md
index 0b40a02972..5fbb7dfa56 100644
--- a/packages/preset/agent-preset/skills/cordis-composition-reference/references/packages.md
+++ b/packages/preset/agent-preset/skills/cordis-composition-reference/references/packages.md
@@ -445,6 +445,12 @@ Every package below exports a Cordis plugin that a bundle patch can name in a Lo
|---|---|---|
| `@deepseek-ai/dsh-subprocess-local` | no | Local-subprocess implementation of the DeepSeek Harness subprocess seam |
+## telemetry
+
+| Package | Config | Description |
+|---|---|---|
+| `@deepseek-ai/dsh-otel` | no | Cordis service for independent ordinary-event and byte-bounded Session-log OTLP channels |
+
## terminal
| Package | Config | Description |
diff --git a/packages/session/session-telemetry-otel/README.i18n.yaml b/packages/session/session-telemetry-otel/README.i18n.yaml
index 63fd635885..d26ad40f35 100644
--- a/packages/session/session-telemetry-otel/README.i18n.yaml
+++ b/packages/session/session-telemetry-otel/README.i18n.yaml
@@ -9,8 +9,8 @@
en: f8ea869792c8b207
zh: bc076172ce22ba9b
/deepseek-ai-dsh-session-telemetry-otel/summary:
- en: 8f48640985c1f920
- zh: 88446c8d7f95142c
+ en: 828903209ef34983
+ zh: 8eac63f1e8df15d8
/deepseek-ai-dsh-session-telemetry-otel/table-of-contents:
en: d152484eb41ac6b4
zh: 09388d293f9be9cb
@@ -24,8 +24,8 @@
en: 11845fd50dc0a494
zh: ee990bfca3621bd3
/deepseek-ai-dsh-session-telemetry-otel/use-this-package/what-leaves-the-machine:
- en: 78d933a0f391cc58
- zh: 0552999de92573b1
+ en: 2a5ddd227e400455
+ zh: 74b7bd9b9161b054
/deepseek-ai-dsh-session-telemetry-otel/use-this-package/failures-and-shutdown:
en: a66831cb9de57e04
zh: 3ada28bb868e0932
@@ -33,8 +33,8 @@
en: ee672a6a6f0fa02d
zh: c3bab8e6b60e768c
/deepseek-ai-dsh-session-telemetry-otel/understand-the-implementation/design-concept:
- en: 22eccb2e5ab7c7d4
- zh: 0a6eb06e46857745
+ en: 34f8a88224a1f6cf
+ zh: 40839dabaea39602
/deepseek-ai-dsh-session-telemetry-otel/understand-the-implementation/source-map:
en: 0b99d2e5c27213cd
zh: 3cbdaa7f6a45d81a
diff --git a/packages/session/session-telemetry-otel/README.md b/packages/session/session-telemetry-otel/README.md
index cfab2495a6..f3fc3fa417 100644
--- a/packages/session/session-telemetry-otel/README.md
+++ b/packages/session/session-telemetry-otel/README.md
@@ -9,6 +9,8 @@ English | [中文](README.zh.md)
## Summary
+The adapter injects `otel`; the [shared OTel plugin](../../telemetry/otel/README.md) creates its independent Session-log channel. Authorization, redaction, identity, scope version, configuration, and the shutdown deadline remain owned here.
+
`dsh-session-telemetry-otel` exports session records through the OTel JS SDK only after new explicit feedback, for all users and providers, including `deepseek-official`. `FEEDBACK_ONLY` releases the canonical prefix through that feedback, including context; later records wait for the next explicit feedback. `DISABLED` constructs no transport. Scheduled batching can finish an authorized upload without another user interaction or model call. Deployments own their redaction rules.
## Table of Contents
@@ -69,7 +71,7 @@ Model requests, request headers, Session creation or adoption, restoration, and
Each Session event becomes one `eventName: "session-log"` record. `attributes.sessionId` is the collector Session identity; `attributes.content` encodes the complete event envelope with redacted `event.data`. JSON values are preserved, not the original JSONL bytes or key ordering. Legacy `session.id`, `event.seq`, and `event.type` metadata remain for existing consumers. Resources carry application and anonymous-user identity; scope carries the backend package name and version. The base profile uses `https://dsh-otel-collector.deepseeksvc.com/v1/logs`; `DSH_TELEMETRY_OTLP_URL` overrides it. No channel header is added implicitly.
-The backend measures each record once with the SDK OTLP JSON serializer, including its resource/scope envelope, then greedily packs requests using those conservative sizes. A single oversized event produces one rejection diagnostic without truncation. Session logs never mix with product analytics in a request. Capture handoff and shutdown are not collector acknowledgements.
+The shared OTel channel measures each record once with the SDK OTLP JSON serializer, including its resource/scope envelope, then greedily packs requests using those conservative sizes. A single oversized event produces one rejection diagnostic without truncation. Session logs never mix with product analytics in a request. Capture handoff and shutdown are not collector acknowledgements.
### Failures and shutdown
@@ -87,7 +89,7 @@ This section explains the backend's composition; the observable behavior is full
### Design concept
-The backend owns feedback authorization, identity, byte/count scheduling, and shutdown. OTel owns record construction, JSON transport, compression, and retries. Resource identity carries `service.name`/`service.version` from `APP_IDENTITY` and anonymous `user.id`; the scope retains this package’s name and version.
+The backend owns feedback authorization, identity, and shutdown. The shared OTel service owns channel creation, byte/count scheduling, record construction, JSON transport, compression, and retries. Resource identity carries `service.name`/`service.version` from `APP_IDENTITY` and anonymous `user.id`; the scope retains this package’s name and version.
### Source map
diff --git a/packages/session/session-telemetry-otel/README.zh.md b/packages/session/session-telemetry-otel/README.zh.md
index 8acb57c385..2220cc4291 100644
--- a/packages/session/session-telemetry-otel/README.zh.md
+++ b/packages/session/session-telemetry-otel/README.zh.md
@@ -9,6 +9,8 @@ kind: "package-reference"
## 概述
+适配器注入 `otel`;[共享 OTel 插件](../../telemetry/otel/README.zh.md) 创建其独立 Session 日志通道。授权、脱敏、身份、scope 版本、配置和关闭期限仍由本包负责。
+
`dsh-session-telemetry-otel` 仅在新的显式反馈后通过 OTel JS SDK 导出会话记录,适用于所有用户和提供方,包括 `deepseek-official`。`FEEDBACK_ONLY` 释放截至该反馈的权威日志前缀,包含上下文;后续记录等待下一次显式反馈。`DISABLED` 不构造传输。定时批处理可完成已授权的上传,无需另一次用户交互或模型调用。部署方负责脱敏规则。
## 目录
@@ -69,7 +71,7 @@ kind: "package-reference"
每条 Session 事件对应一个 `eventName: "session-log"` 记录。`attributes.sessionId` 是 collector 使用的 Session 身份;`attributes.content` 编码完整事件 envelope 和脱敏后的 `event.data`。保留的是 JSON 值,不保证原 JSONL 字节或键顺序相同。为现有消费者保留 `session.id`、`event.seq` 和 `event.type` 元数据。Resource 携带应用和匿名用户身份;scope 携带后端包名和版本。基础配置使用 `https://dsh-otel-collector.deepseeksvc.com/v1/logs`,可用 `DSH_TELEMETRY_OTLP_URL` 覆盖。不隐式添加 channel 头。
-后端使用 SDK 的 OTLP JSON 序列化器对每条记录计量一次,包含其 resource/scope envelope,再按保守大小顺序组包。单条超限事件产生一次拒绝诊断且不截断。Session 日志不会与产品埋点混在一个请求中。捕获交接和关闭完成不代表 collector 确认。
+共享 OTel 通道使用 SDK 的 OTLP JSON 序列化器对每条记录计量一次,包含其 resource/scope envelope,再按保守大小顺序组包。单条超限事件产生一次拒绝诊断且不截断。Session 日志不会与产品埋点混在一个请求中。捕获交接和关闭完成不代表 collector 确认。
### 失败与关闭
@@ -87,7 +89,7 @@ kind: "package-reference"
### 设计理念
-后端负责反馈授权、身份、字节/条数调度和关闭。OTel 负责记录构造、JSON 传输、压缩和重试。Resource 身份包含 `APP_IDENTITY` 的 `service.name`/`service.version` 和匿名 `user.id`;scope 保留本包名称和版本。
+后端负责反馈授权、身份和关闭。共享 OTel 服务负责通道创建、字节和条数调度、记录构造、JSON 传输、压缩与重试。Resource 身份携带 `APP_IDENTITY` 中的 `service.name` / `service.version` 以及匿名 `user.id`;scope 保留本包的名称和版本。
### 源码地图
diff --git a/packages/session/session-telemetry-otel/package.json b/packages/session/session-telemetry-otel/package.json
index de53b97c7d..7777001d47 100644
--- a/packages/session/session-telemetry-otel/package.json
+++ b/packages/session/session-telemetry-otel/package.json
@@ -27,14 +27,10 @@
],
"license": "MIT",
"dependencies": {
- "@opentelemetry/api": "^1.9.1",
"@opentelemetry/api-logs": "^0.220.0",
"@opentelemetry/otlp-exporter-base": "^0.220.0",
- "@opentelemetry/resources": "^2.9.0",
"@opentelemetry/sdk-logs": "^0.220.0",
- "@deepseek-ai/schemastery": "workspace:~",
- "@opentelemetry/core": "2.9.0",
- "@opentelemetry/otlp-transformer": "^0.220.0"
+ "@deepseek-ai/schemastery": "workspace:~"
},
"peerDependencies": {
"@deepseek-ai/dsh-command-feedback": "workspace:*",
@@ -43,7 +39,8 @@
"@deepseek-ai/dsh-session": "workspace:*",
"@deepseek-ai/dsh-session-telemetry": "workspace:*",
"@deepseek-ai/dsh-anonymous-user-id": "workspace:*",
- "@deepseek-ai/cordis": "workspace:~"
+ "@deepseek-ai/cordis": "workspace:~",
+ "@deepseek-ai/dsh-otel": "workspace:*"
},
"devDependencies": {
"@deepseek-ai/cordis-plugin-logger-console": "workspace:~",
@@ -61,6 +58,7 @@
"@deepseek-ai/dsh-subprocess-local": "workspace:*",
"@deepseek-ai/dsh-anonymous-user-id": "workspace:*",
"@deepseek-ai/cordis": "workspace:~",
- "@deepseek-ai/dsh-http-proxy": "workspace:*"
+ "@deepseek-ai/dsh-http-proxy": "workspace:*",
+ "@deepseek-ai/dsh-otel": "workspace:*"
}
}
diff --git a/packages/session/session-telemetry-otel/src/index.ts b/packages/session/session-telemetry-otel/src/index.ts
index bdd05fa82a..6d351a585f 100644
--- a/packages/session/session-telemetry-otel/src/index.ts
+++ b/packages/session/session-telemetry-otel/src/index.ts
@@ -8,6 +8,7 @@
* @module @deepseek-ai/dsh-session-telemetry-otel
*/
+import { createRequire } from 'node:module'
import z from '@deepseek-ai/schemastery'
import type { Context } from '@deepseek-ai/cordis'
import type {} from '@deepseek-ai/dsh-command-feedback'
@@ -23,7 +24,7 @@ import {
} from '@deepseek-ai/dsh-session-telemetry'
import { APP_IDENTITY } from '@deepseek-ai/dsh-llm'
import { getOrCreateAnonymousUserId } from '@deepseek-ai/dsh-anonymous-user-id'
-import { SessionLogReporter } from './session-log.ts'
+import type { SessionLogReporter } from '@deepseek-ai/dsh-otel'
import type { BatchLogRecordProcessorOptions } from '@opentelemetry/sdk-logs'
import type { OTLPExporterNodeConfigBase } from '@opentelemetry/otlp-exporter-base'
import { SeverityNumber } from '@opentelemetry/api-logs'
@@ -140,7 +141,7 @@ const SEVERITY: Record = {
* SDK state and listens only to warn when recorded feedback stays local.
*/
export class OpenTelemetrySessionBackend extends SessionTelemetryBackend {
- static inject = ['sessions']
+ static inject = ['sessions', 'otel']
static Config = Config
private readonly provider: SessionLogReporter | undefined
@@ -184,7 +185,9 @@ export class OpenTelemetrySessionBackend extends SessionTelemetryBackend {
throw new Error(`session-telemetry-otel: shutdownTimeoutMillis must be a positive finite number no greater than ${MAX_TIMER_DELAY_MILLIS}, got ${String(shutdownTimeoutMillis)}`)
}
this.shutdownTimeoutMillis = shutdownTimeoutMillis
- const reporter = new SessionLogReporter({
+ const { version } = createRequire(import.meta.url)('../package.json') as { version: string }
+ const reporter = ctx.otel.createSessionLogReporter({
+ scope: { name: '@deepseek-ai/dsh-session-telemetry-otel', version },
exporter: { ...config.exporter, url },
...(config.processor === undefined ? {} : { processor: config.processor }),
...(config.maxRequestBytes === undefined ? {} : { maxRequestBytes: config.maxRequestBytes }),
diff --git a/packages/session/session-telemetry-otel/tests/egress.spec.ts b/packages/session/session-telemetry-otel/tests/egress.spec.ts
index 72f7c35617..5dea6f9473 100644
--- a/packages/session/session-telemetry-otel/tests/egress.spec.ts
+++ b/packages/session/session-telemetry-otel/tests/egress.spec.ts
@@ -1,3 +1,4 @@
+import OTel from '@deepseek-ai/dsh-otel'
import { createServer, type Server } from 'node:http'
import { once } from 'node:events'
import { mkdtempSync, rmSync } from 'node:fs'
@@ -80,6 +81,7 @@ describe('session-telemetry-otel egress', () => {
captures.length = 0
const disposeProxy = await installProxyFromEnvironment(proxyEnv(), () => undefined)
const ctx = new Context()
+ ctx.plugin(OTel)
try {
// The positive control proves a fetch-based exporter would reach the proxy.
const response = await fetch(collectorUrl)
diff --git a/packages/session/session-telemetry-otel/tests/otel.spec.ts b/packages/session/session-telemetry-otel/tests/otel.spec.ts
index a9e1da2c92..86082a026b 100644
--- a/packages/session/session-telemetry-otel/tests/otel.spec.ts
+++ b/packages/session/session-telemetry-otel/tests/otel.spec.ts
@@ -1,3 +1,4 @@
+import OTel from '@deepseek-ai/dsh-otel'
/**
* OTel backend unit tier: wire assertions against a scripted `node:http`
* mock collector through the SDK's REAL pipeline (BatchLogRecordProcessor →
@@ -102,6 +103,7 @@ async function mockCollector(
async function boot(url: string) {
const ctx = new Context()
+ ctx.plugin(OTel)
await ctx.plugin(SessionStore)
const fiber = await ctx.plugin(OpenTelemetrySessionBackend, {
mode: SessionTelemetryMode.FEEDBACK_ONLY,
@@ -210,6 +212,7 @@ describe('OpenTelemetrySessionBackend wire', () => {
}
})
const ctx = new Context()
+ ctx.plugin(OTel)
await ctx.plugin(SessionStore)
const fiber = await ctx.plugin(OpenTelemetrySessionBackend, {
mode: SessionTelemetryMode.FEEDBACK_ONLY,
@@ -245,6 +248,7 @@ describe('OpenTelemetrySessionBackend wire', () => {
}
})
const ctx = new Context()
+ ctx.plugin(OTel)
await ctx.plugin(SessionStore)
const fiber = await ctx.plugin(OpenTelemetrySessionBackend, {
mode: SessionTelemetryMode.FEEDBACK_ONLY,
@@ -275,6 +279,7 @@ describe('OpenTelemetrySessionBackend wire', () => {
it('passes exporter options beyond url and headers through to the SDK exporter', async () => {
const { url, captures } = await mockCollector()
const ctx = new Context()
+ ctx.plugin(OTel)
await ctx.plugin(SessionStore)
// `compression` is a documented SDK exporter option; the advertised
// verbatim passthrough must hand it (and every other field) to the
@@ -316,6 +321,7 @@ describe('OpenTelemetrySessionBackend wire', () => {
it('replays each session suffix only at the next feedback event', async () => {
const { url, captures } = await mockCollector()
const ctx = new Context()
+ ctx.plugin(OTel)
await ctx.plugin(SessionStore)
const fiber = await ctx.plugin(OpenTelemetrySessionBackend, {
mode: SessionTelemetryMode.FEEDBACK_ONLY,
@@ -352,6 +358,7 @@ describe('OpenTelemetrySessionBackend wire', () => {
it('ignores direct emits and non-canonical feedback in feedback-only mode', async () => {
const { url, captures } = await mockCollector()
const ctx = new Context()
+ ctx.plugin(OTel)
await ctx.plugin(SessionStore)
const warn = vi.spyOn(ctx.logger, 'warn').mockImplementation(() => {})
const fiber = await ctx.plugin(OpenTelemetrySessionBackend, {
@@ -381,6 +388,7 @@ describe('OpenTelemetrySessionBackend wire', () => {
it('constructs no disabled transport even when exporter options are present', async () => {
const { url, captures } = await mockCollector()
const ctx = new Context()
+ ctx.plugin(OTel)
await ctx.plugin(SessionStore)
const warn = vi.spyOn(ctx.logger, 'warn').mockImplementation(() => {})
const fiber = await ctx.plugin(OpenTelemetrySessionBackend, {
@@ -414,18 +422,24 @@ describe('OpenTelemetrySessionBackend wire', () => {
const { url, captures } = await mockCollector()
const gatedCtx = new Context()
+
+ gatedCtx.plugin(OTel)
await gatedCtx.plugin(SessionStore)
const gated = await gatedCtx.plugin(OpenTelemetrySessionBackend, { mode: SessionTelemetryMode.FEEDBACK_ONLY, exporter: { url } })
expect(gatedCtx.sessionTelemetry.sharing).toBe('feedback-only')
await gated.dispose()
const disabledCtx = new Context()
+
+ disabledCtx.plugin(OTel)
await disabledCtx.plugin(SessionStore)
const disabled = await disabledCtx.plugin(OpenTelemetrySessionBackend, { mode: SessionTelemetryMode.DISABLED })
expect(disabledCtx.sessionTelemetry.sharing).toBe('disabled')
await disabled.dispose()
const defaultCtx = new Context()
+
+ defaultCtx.plugin(OTel)
await defaultCtx.plugin(SessionStore)
const defaulted = await defaultCtx.plugin(OpenTelemetrySessionBackend, { exporter: { url } })
expect(defaultCtx.sessionTelemetry.sharing).toBe('feedback-only')
@@ -438,6 +452,7 @@ describe('OpenTelemetrySessionBackend wire', () => {
it('defaults direct construction to feedback-only delivery', async () => {
const { url, captures } = await mockCollector()
const ctx = new Context()
+ ctx.plugin(OTel)
try {
await ctx.plugin(SessionStore)
new OpenTelemetrySessionBackend(ctx, {
@@ -464,6 +479,7 @@ describe('OpenTelemetrySessionBackend route and feedback', () => {
it.each(['deepseek-official', 'mock', undefined])('uploads new text feedback for %s while the host stays alive', async (provider) => {
const { url, captures } = await mockCollector()
const ctx = new Context()
+ ctx.plugin(OTel)
try {
await ctx.plugin(SessionStore)
await ctx.plugin(OpenTelemetrySessionBackend, {
@@ -488,6 +504,7 @@ describe('OpenTelemetrySessionBackend route and feedback', () => {
it('does not upload ordinary events, inherited feedback, new/open/resume/fork or HMR', async () => {
const { url, captures } = await mockCollector()
const ctx = new Context()
+ ctx.plugin(OTel)
await ctx.plugin(SessionStore)
const donor = Session.create(SessionId('stored-feedback'))
recordFeedback(donor, { text: 'old feedback is not a submission' })
@@ -517,6 +534,7 @@ describe('OpenTelemetrySessionBackend route and feedback', () => {
const { url, captures } = await mockCollector()
const root = mkdtempSync(join(tmpdir(), 'dsh-otel-live-'))
const ctx = new Context()
+ ctx.plugin(OTel)
try {
await ctx.plugin(SessionStore)
await ctx.plugin(JsonlPersistence, { root, compression: 'none' })
@@ -593,6 +611,7 @@ describe('OpenTelemetrySessionBackend route and feedback', () => {
const { url, captures } = await mockCollector()
const root = mkdtempSync(join(tmpdir(), 'dsh-otel-cold-fork-'))
const ctx = new Context()
+ ctx.plugin(OTel)
try {
await ctx.plugin(SessionStore)
await ctx.plugin(JsonlPersistence, { root, compression: 'none' })
@@ -648,6 +667,7 @@ describe('OpenTelemetrySessionBackend route and feedback', () => {
const { url, captures } = await mockCollector()
const root = mkdtempSync(join(tmpdir(), 'dsh-otel-cold-'))
const ctx = new Context()
+ ctx.plugin(OTel)
const warn = vi.spyOn(ctx.logger, 'warn').mockImplementation(() => {})
try {
await ctx.plugin(SessionStore)
@@ -731,12 +751,14 @@ describe('OpenTelemetrySessionBackend config fails loud', () => {
[{ mode: SessionTelemetryMode.FEEDBACK_ONLY, exporter: { url: 'http://c/v1/logs' }, shutdownTimeoutMillis: Number.POSITIVE_INFINITY }, /shutdownTimeoutMillis/],
])('rejects %j at plugin load', async (config, message) => {
const ctx = new Context()
+ ctx.plugin(OTel)
await ctx.plugin(SessionStore)
await expect(ctx.plugin(OpenTelemetrySessionBackend, config as Config)).rejects.toThrow(message)
})
it.each(['INVALID', 'FULL'])('rejects direct mode %s before reading transport config', async (mode) => {
const ctx = new Context()
+ ctx.plugin(OTel)
await ctx.plugin(SessionStore)
let exporterRead = false
const config = {
@@ -753,6 +775,7 @@ describe('OpenTelemetrySessionBackend config fails loud', () => {
it('does not read any transport setting in disabled mode', async () => {
const ctx = new Context()
+ ctx.plugin(OTel)
await ctx.plugin(SessionStore)
const transportRead = vi.fn(() => {
throw new Error('transport config was read')
@@ -782,7 +805,7 @@ describe('dsh-session-telemetry-otel real-load-path guard', () => {
const loader = Object.create(Loader.prototype) as Loader
const unwrapped = loader.unwrapExports(module) as typeof OpenTelemetrySessionBackend
expect(unwrapped).toBe(OpenTelemetrySessionBackend)
- expect(unwrapped.inject).toEqual(['sessions'])
+ expect(unwrapped.inject).toEqual(['sessions', 'otel'])
expect(typeof unwrapped.Config).toBe('function')
})
@@ -792,6 +815,7 @@ describe('dsh-session-telemetry-otel real-load-path guard', () => {
const loader = Object.create(Loader.prototype) as Loader
const unwrapped = loader.unwrapExports(module) as Parameters[0]
const ctx = new Context()
+ ctx.plugin(OTel)
await ctx.plugin(SessionStore)
const fiber = await ctx.plugin(unwrapped, { mode: SessionTelemetryMode.FEEDBACK_ONLY, exporter: { url } })
expect(ctx.sessionTelemetry).toBeInstanceOf(OpenTelemetrySessionBackend)
@@ -802,6 +826,7 @@ describe('dsh-session-telemetry-otel real-load-path guard', () => {
it('reports oversized records without failing feedback or exporting their contents', async () => {
const { url, captures } = await mockCollector()
const ctx = new Context()
+ ctx.plugin(OTel)
try {
await ctx.plugin(SessionStore)
const warn = vi.spyOn(ctx.logger, 'warn')
diff --git a/packages/session/session-telemetry-otel/tsconfig.json b/packages/session/session-telemetry-otel/tsconfig.json
index 87f43bdc9a..08f78d0e6c 100644
--- a/packages/session/session-telemetry-otel/tsconfig.json
+++ b/packages/session/session-telemetry-otel/tsconfig.json
@@ -34,6 +34,9 @@
},
{
"path": "../../identity/anonymous-user-id"
+ },
+ {
+ "path": "../../telemetry/otel"
}
]
}
diff --git a/packages/telemetry/README.i18n.yaml b/packages/telemetry/README.i18n.yaml
new file mode 100644
index 0000000000..8febf5c4f2
--- /dev/null
+++ b/packages/telemetry/README.i18n.yaml
@@ -0,0 +1,25 @@
+# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
+# pnpm run verify-translation-pairing --write packages/telemetry/README.md
+/:
+ en: 53661eb6551dbf31
+ zh: 8cc1a84f4cb8a69f
+/telemetry-shared-reporting:
+ en: 0c5ec106d3250ce7
+ zh: ab9e19ea56f1f75f
+/telemetry-shared-reporting/summary:
+ en: 9dbe398017c89288
+ zh: 91b8c2de8176de4f
+/telemetry-shared-reporting/table-of-contents:
+ en: 09848f4d056e4fc1
+ zh: 8df6139cff0288f6
+/telemetry-shared-reporting/packages:
+ en: 0bc9ee219231fa9a
+ zh: 873150749266f259
+/telemetry-shared-reporting/related-documentation:
+ en: f550e93c6228156b
+ zh: 7414955502825abd
+/telemetry-shared-reporting/dev-note:
+ en: b75c8458928b72b9
+ zh: 003ba4e17b4b5269
diff --git a/packages/telemetry/README.md b/packages/telemetry/README.md
new file mode 100644
index 0000000000..e77964022e
--- /dev/null
+++ b/packages/telemetry/README.md
@@ -0,0 +1,35 @@
+---
+description: "Shared telemetry transport plugins for business consumers."
+kind: "package-group"
+---
+
+# telemetry/ — shared reporting
+
+English | [中文](README.zh.md)
+
+## Summary
+
+This group provides reporting infrastructure shared by product analytics and feedback-authorized Session uploads. Business plugins select events, identities, authorization, and redaction; transport plugins own encoding and delivery.
+
+## Table of Contents
+
+- [Packages](#packages)
+- [Related documentation](#related-documentation)
+- [Dev Note](#dev-note)
+
+
+## Packages
+
+| Package | Role |
+|---|---|
+| [`otel`](otel/README.md) | Cordis service creating independent ordinary-event and byte-bounded Session-log channels |
+
+
+## Related documentation
+
+- [OTel subsystem](../../docs/subsystems/otel.md) — shared service and consumer ownership.
+
+
+## Dev Note
+
+None.
diff --git a/packages/telemetry/README.zh.md b/packages/telemetry/README.zh.md
new file mode 100644
index 0000000000..61e3ecd3df
--- /dev/null
+++ b/packages/telemetry/README.zh.md
@@ -0,0 +1,35 @@
+---
+description: "供业务调用方共享的遥测传输插件。"
+kind: "package-group"
+---
+
+# telemetry/ — 共享上报
+
+[English](README.md) | 中文
+
+## 概述
+
+本组提供产品埋点和反馈授权 Session 上传共用的上报基础设施。业务插件选择事件、身份、授权和脱敏规则;传输插件负责编码和投递。
+
+## 目录
+
+- [包](#packages)
+- [相关文档](#related-documentation)
+- [开发备注](#dev-note)
+
+
+## 包
+
+| 包 | 职责 |
+|---|---|
+| [`otel`](otel/README.zh.md) | 创建独立普通事件通道和受字节上限约束的 Session 日志通道的 Cordis 服务 |
+
+
+## 相关文档
+
+- [OTel 子系统](../../docs/subsystems/otel.zh.md) — 共享服务与调用方职责。
+
+
+## 开发备注
+
+无。
diff --git a/packages/telemetry/otel/README.i18n.yaml b/packages/telemetry/otel/README.i18n.yaml
new file mode 100644
index 0000000000..3eee76e8c9
--- /dev/null
+++ b/packages/telemetry/otel/README.i18n.yaml
@@ -0,0 +1,37 @@
+# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
+# pnpm run verify-translation-pairing --write packages/telemetry/otel/README.md
+/:
+ en: 49f35d8bc0fe3689
+ zh: ef2fd903cca7d129
+/deepseek-ai-dsh-otel:
+ en: 925bc4650e9895d6
+ zh: 02f8917c4048f6e2
+/deepseek-ai-dsh-otel/summary:
+ en: e32c122f34c04593
+ zh: bea48183ab438454
+/deepseek-ai-dsh-otel/table-of-contents:
+ en: 23386452a66b2fbd
+ zh: 55b2121ae6059425
+/deepseek-ai-dsh-otel/use-this-package:
+ en: a295efbb5b488489
+ zh: 4baa7f0f78ce862d
+/deepseek-ai-dsh-otel/understand-the-implementation:
+ en: 79e1c09af1c84c06
+ zh: 10bf2f50a59c01f6
+/deepseek-ai-dsh-otel/further-exploration:
+ en: ee17b991de098cc0
+ zh: f90257e411921f2b
+/deepseek-ai-dsh-otel/model-experience:
+ en: 5b364b9451ced69f
+ zh: 025feb91ef96bdb8
+/deepseek-ai-dsh-otel/model-experience/kv-cache-effect:
+ en: 8be9251f0d5256ed
+ zh: d46143a02855c8bc
+/deepseek-ai-dsh-otel/known-limitations-and-deferred-work:
+ en: 5c3e29312d45ee52
+ zh: b148e3a6decc0f7d
+/deepseek-ai-dsh-otel/known-limitations-and-deferred-work/dev-note:
+ en: 0a1253c6f7b5e8b9
+ zh: 9f56528562c7c914
diff --git a/packages/telemetry/otel/README.md b/packages/telemetry/otel/README.md
new file mode 100644
index 0000000000..2f8bc0fe43
--- /dev/null
+++ b/packages/telemetry/otel/README.md
@@ -0,0 +1,70 @@
+---
+description: "Create independent OTLP reporting channels through the shared Cordis OTel service."
+kind: "package-reference"
+---
+
+# @deepseek-ai/dsh-otel
+
+English | [中文](README.zh.md)
+
+## Summary
+
+Mount one `otel` service to create ordinary-event and Session-log reporting channels. Each channel has its own exporter, resource, instrumentation scope, and queue. Mounting alone creates no transport or identity and sends nothing. Business consumers own authorization, redaction, field selection, and their channel's disposal.
+
+## Table of Contents
+
+- [Use this package](#use-this-package)
+- [Understand the implementation](#understand-the-implementation)
+- [Further Exploration](#further-exploration)
+- [Model Experience](#model-experience)
+- [Known Limitations and Deferred Work](#known-limitations-and-deferred-work)
+- [Dev Note](#dev-note)
+
+
+## Use this package
+
+The base bundle mounts `@deepseek-ai/dsh-otel`. Independent compositions must mount it before consumers that inject `otel`. Call `ctx.otel.createEventReporter(options)` for ordinary analytics or `ctx.otel.createSessionLogReporter(options)` for complete Session events. Options explicitly supply endpoint, scope, resource attributes, queue settings, and a diagnostic callback; the service has no deployment defaults or automatic collection policy of its own.
+
+The returned channel belongs to the consumer. Register shutdown with the consumer's Cordis fiber and bound the complete drain with its configured deadline. Injection makes service replacement unload dependent consumers. Do not retain a channel after its consumer unloads. The product and Session adapters implement this ownership for UI and feedback callers.
+
+Ordinary channels use SDK count-based batching. Session channels preserve one complete event per record with `eventName: "session-log"`, `sessionId`, and a JSON string `content`, and enforce at most 4,000,000 uncompressed request bytes. Their byte limits, single-record rejection, serial transport settlement, and shutdown behavior are specified by the [Session adapter](../../session/session-telemetry-otel/README.md). A Session channel never shares a request or queue with ordinary events.
+
+Headers are explicit. The service does not add a channel header or inherit ambient authorization headers or TLS identity. Agent factories own their returned agents, including keepAlive. Scope names and versions are supplied by each consumer, so transport sharing does not change event attribution.
+
+
+## Understand the implementation
+
+`src/index.ts` registers the service; `event-log.ts` owns ordinary SDK batching; `session-log.ts` owns byte/count scheduling; `transport.ts` supplies the SDK JSON HTTP delegate. No global OTel provider is installed. The Session processor measures each record once, groups conservative sizes, and waits for the SDK concurrency queue to clear after every callback before sending another request.
+
+No runtime invariant companion is published: channel creation registers no independent domain state, and collector delivery cannot be inferred from local queues. Composition tests exercise independent channels and service removal; adapter tests cover dependent-fiber cleanup and feedback authorization.
+
+
+## Further Exploration
+
+- [OTel subsystem](../../../docs/subsystems/otel.md) — service ownership and API.
+- [Product adapter](../../host/product-telemetry-otel/README.md) — explicit analytics policy and configuration.
+- [Session adapter](../../session/session-telemetry-otel/README.md) — feedback authorization and configured upload limits.
+
+
+## Model Experience
+
+None, as the service delivers caller-selected records without changing model context.
+
+#### KV Cache effect
+
+None; reporting does not change model requests.
+
+## Known Limitations and Deferred Work
+
+
+
+Channels provide best-effort, memory-only delivery with the following limits.
+
+- The caller owns consent, redaction, resource identity, renderer-to-host RPC, and the outer shutdown deadline.
+- Queue overflow, oversized Session events, transport failure, and process exit can lose records. There is no durable outbox or warehouse acknowledgement.
+- Ordinary-event channels batch by count; their consumers must select event and batch sizes suitable for the collector.
+
+
+### Dev Note
+
+None.
diff --git a/packages/telemetry/otel/README.zh.md b/packages/telemetry/otel/README.zh.md
new file mode 100644
index 0000000000..111f30fc4b
--- /dev/null
+++ b/packages/telemetry/otel/README.zh.md
@@ -0,0 +1,70 @@
+---
+description: "通过共享 Cordis OTel 服务创建独立的 OTLP 上报通道。"
+kind: "package-reference"
+---
+
+# @deepseek-ai/dsh-otel
+
+[English](README.md) | 中文
+
+## 概述
+
+挂载一个 `otel` 服务即可创建普通事件和 Session 日志上报通道。每个通道拥有独立的 exporter、resource、instrumentation scope 和队列。仅挂载不会创建传输、身份或发送数据。业务调用方负责授权、脱敏、字段选择及通道销毁。
+
+## 目录
+
+- [使用本包](#use-this-package)
+- [理解实现](#understand-the-implementation)
+- [进一步探索](#further-exploration)
+- [模型体验](#model-experience)
+- [已知限制与后续工作](#known-limitations-and-deferred-work)
+- [开发备注](#dev-note)
+
+
+## 使用本包
+
+base bundle 挂载 `@deepseek-ai/dsh-otel`。独立组合必须在注入 `otel` 的调用方之前挂载它。普通埋点调用 `ctx.otel.createEventReporter(options)`,完整 Session 事件调用 `ctx.otel.createSessionLogReporter(options)`。选项显式提供 endpoint、scope、resource attributes、队列设置和诊断回调;服务本身没有部署默认值或自动采集策略。
+
+返回的通道由调用方持有。将关闭注册到调用方的 Cordis fiber,并用配置的期限约束完整清空过程。注入机制使服务替换时卸载依赖方。调用方卸载后不得继续保留通道。产品和 Session 适配器为 UI 和反馈调用方实现这些职责。
+
+普通通道使用 SDK 按条数聚合。Session 通道将每条完整事件保留为一个记录,包含 `eventName: "session-log"`、`sessionId` 和 JSON 字符串 `content`,并保证未压缩请求不超过 4,000,000 字节。字节限制、单条拒绝、串行传输结束和关闭行为见 [Session 适配器](../../session/session-telemetry-otel/README.zh.md)。Session 通道不会与普通事件共享请求或队列。
+
+Header 显式提供。服务不会附加 channel header,也不继承环境中的授权 header 或 TLS 身份。Agent factory 负责返回的 agent,包括 keepAlive。每个调用方提供 scope 名称和版本,因此共享传输不会改变事件归属。
+
+
+## 理解实现
+
+`src/index.ts` 注册服务;`event-log.ts` 负责普通事件的 SDK 聚合;`session-log.ts` 负责字节和条数调度;`transport.ts` 提供 SDK JSON HTTP delegate。不安装全局 OTel provider。Session processor 对每条记录只计量一次,按保守大小组包,并在每次回调后等待 SDK 并发队列清理完成才发送下一请求。
+
+不发布运行时不变式伴生入口:通道创建不注册独立领域状态,无法从本地队列推断 collector 是否收到记录。组合测试覆盖独立通道和服务移除;适配器测试覆盖依赖 fiber 清理与反馈授权。
+
+
+## 进一步探索
+
+- [OTel 子系统](../../../docs/subsystems/otel.zh.md) — 服务职责与 API。
+- [产品适配器](../../host/product-telemetry-otel/README.zh.md) — 显式埋点策略与配置。
+- [Session 适配器](../../session/session-telemetry-otel/README.zh.md) — 反馈授权和上传限制配置。
+
+
+## 模型体验
+
+无,因为服务只投递调用方选择的记录,不改变模型上下文。
+
+#### KV Cache 影响
+
+无;上报不改变模型请求。
+
+## 已知限制与后续工作
+
+
+
+通道提供尽力而为的纯内存投递,具有以下限制。
+
+- 调用方负责同意、脱敏、resource 身份、renderer 到 host 的 RPC 及外层关闭期限。
+- 队列溢出、Session 事件超限、传输失败和进程退出可能丢失记录。不提供持久 outbox 或仓库确认。
+- 普通事件通道按条数聚合;调用方必须选择适合 collector 的事件和批次大小。
+
+
+### 开发备注
+
+无。
diff --git a/packages/telemetry/otel/package.json b/packages/telemetry/otel/package.json
new file mode 100644
index 0000000000..64d065bd62
--- /dev/null
+++ b/packages/telemetry/otel/package.json
@@ -0,0 +1,46 @@
+{
+ "name": "@deepseek-ai/dsh-otel",
+ "description": "Cordis service for independent ordinary-event and byte-bounded Session-log OTLP channels",
+ "version": "0.1.7-rc.2",
+ "publishConfig": {
+ "access": "public"
+ },
+ "repository": {
+ "type": "git",
+ "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+ "directory": "packages/telemetry/otel"
+ },
+ "type": "module",
+ "main": "lib/index.js",
+ "types": "lib/types/index.d.ts",
+ "exports": {
+ ".": {
+ "types": "./lib/types/index.d.ts",
+ "default": "./lib/index.js"
+ },
+ "./src/*": "./src/*",
+ "./package.json": "./package.json"
+ },
+ "files": [
+ "lib/index.js",
+ "lib/types/**/*.d.ts"
+ ],
+ "license": "MIT",
+ "dependencies": {
+ "@opentelemetry/api": "^1.9.1",
+ "@opentelemetry/api-logs": "^0.220.0",
+ "@opentelemetry/otlp-exporter-base": "^0.220.0",
+ "@opentelemetry/resources": "^2.9.0",
+ "@opentelemetry/sdk-logs": "^0.220.0",
+ "@opentelemetry/core": "2.9.0",
+ "@opentelemetry/otlp-transformer": "^0.220.0"
+ },
+ "peerDependencies": {
+ "@deepseek-ai/cordis": "workspace:~",
+ "@deepseek-ai/dsh-session": "workspace:*"
+ },
+ "devDependencies": {
+ "@deepseek-ai/cordis": "workspace:~",
+ "@deepseek-ai/dsh-session": "workspace:*"
+ }
+}
diff --git a/packages/telemetry/otel/src/event-log.ts b/packages/telemetry/otel/src/event-log.ts
new file mode 100644
index 0000000000..4f57f5fb1e
--- /dev/null
+++ b/packages/telemetry/otel/src/event-log.ts
@@ -0,0 +1,77 @@
+/** Ordinary event batching over an explicit SDK HTTP transport. */
+import type { Attributes } from '@opentelemetry/api'
+import { SeverityNumber, type Logger } from '@opentelemetry/api-logs'
+import { ExportResultCode } from '@opentelemetry/core'
+import { resourceFromAttributes } from '@opentelemetry/resources'
+import { BatchLogRecordProcessor, LoggerProvider, type BatchLogRecordProcessorOptions } from '@opentelemetry/sdk-logs'
+import type { SessionLogOptions } from './session-log.ts'
+import { createLogExporter } from './transport.ts'
+
+/** Scalar values accepted by the collector's Arrow attributes map. */
+export type OTelEventScalar = string | number | boolean
+
+/** Explicitly selected analytics fields; object values may contain scalars only. */
+export interface OTelEventRecord {
+ /** Product/DA-owned event name. */
+ eventName: string
+ /** Human-readable summary; never a prompt, response, credential, or file contents. */
+ body: string
+ /** Event occurrence time in Unix milliseconds. Observation time is assigned on enqueue. */
+ timestamp: number
+ /** OTel severity; omitted values use INFO. */
+ severityNumber?: SeverityNumber
+ /** Business fields selected by the caller; no automatic device or account identity. */
+ attributes?: Record>
+}
+
+/** Ordinary-event transport, resource, scope, and count-batching options. */
+export interface EventLogOptions {
+ exporter: SessionLogOptions['exporter']
+ resourceAttributes: Attributes
+ scope: { name: string; version?: string }
+ processor: Omit
+ onFailure: SessionLogOptions['onFailure']
+}
+
+/** One caller-owned ordinary-event queue, independent of every Session-log queue. */
+export class EventLogReporter {
+ private readonly provider: LoggerProvider
+ private readonly logger: Logger
+
+ /** @param options - explicit transport, resource, scope, queue, and diagnostic settings. */
+ constructor(options: EventLogOptions) {
+ const exporter = createLogExporter(options.exporter)
+ this.provider = new LoggerProvider({
+ resource: resourceFromAttributes(options.resourceAttributes),
+ processors: [new BatchLogRecordProcessor({
+ ...options.processor,
+ exporter: {
+ export: (records, callback) => {
+ exporter.export(records, (result) => {
+ if (result.code !== ExportResultCode.SUCCESS) options.onFailure('Product telemetry export failed', result.error)
+ callback(result)
+ })
+ },
+ forceFlush: () => exporter.forceFlush(),
+ shutdown: () => exporter.shutdown(),
+ },
+ })],
+ })
+ this.logger = this.provider.getLogger(options.scope.name, options.scope.version)
+ }
+
+ /**
+ * Enqueue caller-selected analytics fields without acknowledging delivery.
+ * @param record - the ordinary event to report.
+ */
+ emit(record: OTelEventRecord): void {
+ const severityNumber = record.severityNumber ?? SeverityNumber.INFO
+ this.logger.emit({ ...record, observedTimestamp: Date.now(), severityNumber, severityText: SeverityNumber[severityNumber] })
+ }
+
+ /**
+ * Drain the queue and release its SDK transport.
+ * @returns completion of SDK shutdown; callers own their outer deadline.
+ */
+ shutdown(): Promise { return this.provider.shutdown() }
+}
diff --git a/packages/telemetry/otel/src/index.ts b/packages/telemetry/otel/src/index.ts
new file mode 100644
index 0000000000..607b0c2908
--- /dev/null
+++ b/packages/telemetry/otel/src/index.ts
@@ -0,0 +1,34 @@
+/** Cordis entry for independent ordinary-event and Session-log OTLP channels. */
+import { Context, Service } from '@deepseek-ai/cordis'
+import { EventLogReporter, type EventLogOptions } from './event-log.ts'
+import { SessionLogReporter, type SessionLogOptions } from './session-log.ts'
+
+declare module '@deepseek-ai/cordis' {
+ interface Context {
+ otel: OTel
+ }
+}
+
+/** Shared transport provider. Mounting creates no queue, identity, or network connection. */
+export default class OTel extends Service {
+ constructor(ctx: Context) { super(ctx, 'otel') }
+
+ /**
+ * Create an independent ordinary-event channel with count-based batching.
+ * The injected consumer must drain it during its fiber disposal.
+ * @param options - transport, scope, resource, queue, and diagnostic settings selected by the consumer.
+ * @returns the caller-owned channel; no state is shared with other channels.
+ */
+ createEventReporter(options: EventLogOptions): EventLogReporter { return new EventLogReporter(options) }
+
+ /**
+ * Create an independent byte-bounded Session-log channel.
+ * Authorization and redaction precede reporting; the consumer owns shutdown and its outer deadline.
+ * @param options - transport, scope, resource, queue, and diagnostic settings selected by the consumer.
+ * @returns the caller-owned channel, preserving complete accepted events within the request byte ceiling.
+ */
+ createSessionLogReporter(options: SessionLogOptions): SessionLogReporter { return new SessionLogReporter(options) }
+}
+
+export type { EventLogOptions, OTelEventRecord, OTelEventScalar, EventLogReporter } from './event-log.ts'
+export type { SessionLogRecord, SessionLogOptions, SessionLogReporter } from './session-log.ts'
diff --git a/packages/session/session-telemetry-otel/src/session-log.ts b/packages/telemetry/otel/src/session-log.ts
similarity index 97%
rename from packages/session/session-telemetry-otel/src/session-log.ts
rename to packages/telemetry/otel/src/session-log.ts
index 6027f78dcb..59ee612d29 100644
--- a/packages/session/session-telemetry-otel/src/session-log.ts
+++ b/packages/telemetry/otel/src/session-log.ts
@@ -1,5 +1,4 @@
/** Session-log records in an independent byte-bounded OTLP queue. */
-import { createRequire } from 'node:module'
import type { SessionEvent, SessionId } from '@deepseek-ai/dsh-session'
import type { Attributes } from '@opentelemetry/api'
import { SeverityNumber } from '@opentelemetry/api-logs'
@@ -35,6 +34,8 @@ export interface SessionLogOptions {
processor?: Omit
/** May lower, but never exceed, the collector's 4,000,000-byte limit. */
maxRequestBytes?: number
+ /** Instrumentation scope supplied by the business owner. */
+ scope: { name: string; version?: string }
/** Application and anonymous identity carried on the OTLP resource. */
resourceAttributes: Attributes
/** Report rejected single records and network failures without recording their content. */
@@ -195,8 +196,7 @@ export class SessionLogReporter {
resource: resourceFromAttributes(options.resourceAttributes),
processors: [this.processor],
})
- const { version } = createRequire(import.meta.url)('../package.json') as { version: string }
- this.logger = this.provider.getLogger('@deepseek-ai/dsh-session-telemetry-otel', version)
+ this.logger = this.provider.getLogger(options.scope.name, options.scope.version)
}
/**
diff --git a/packages/session/session-telemetry-otel/src/transport.ts b/packages/telemetry/otel/src/transport.ts
similarity index 100%
rename from packages/session/session-telemetry-otel/src/transport.ts
rename to packages/telemetry/otel/src/transport.ts
diff --git a/packages/session/session-telemetry-otel/tests/session-log.spec.ts b/packages/telemetry/otel/tests/session-log.spec.ts
similarity index 89%
rename from packages/session/session-telemetry-otel/tests/session-log.spec.ts
rename to packages/telemetry/otel/tests/session-log.spec.ts
index 8d6062a12c..10299d95e8 100644
--- a/packages/session/session-telemetry-otel/tests/session-log.spec.ts
+++ b/packages/telemetry/otel/tests/session-log.spec.ts
@@ -1,4 +1,6 @@
import { createRequire } from 'node:module'
+import { Context } from '@deepseek-ai/cordis'
+import OTel from '../src/index.ts'
import { Agent, createServer, type IncomingHttpHeaders } from 'node:http'
import { once } from 'node:events'
import { gunzipSync } from 'node:zlib'
@@ -6,7 +8,7 @@ import { afterEach, beforeEach, expect, it, vi } from 'vitest'
import { CompressionAlgorithm } from '@opentelemetry/otlp-exporter-base'
import { JsonLogsSerializer } from '@opentelemetry/otlp-transformer'
import { SessionId, SessionSeq } from '@deepseek-ai/dsh-session'
-import { SESSION_LOG_MAX_REQUEST_BYTES, SessionLogReporter, type SessionLogRecord, type SessionLogOptions } from '../src/session-log.ts'
+import { SESSION_LOG_MAX_REQUEST_BYTES, type SessionLogRecord, type SessionLogOptions } from '../src/session-log.ts'
interface Capture {
bytes: number
@@ -14,6 +16,7 @@ interface Capture {
body: { resourceLogs: { resource: unknown; scopeLogs: { logRecords: Record[] }[] }[] }
}
const cleanup: (() => Promise)[] = []
+let ctx: Context
afterEach(async () => {
try {
for (const dispose of cleanup.splice(0).reverse()) await dispose()
@@ -24,7 +27,10 @@ afterEach(async () => {
}
})
-beforeEach(() => {
+beforeEach(async () => {
+ ctx = new Context()
+ cleanup.push(() => ctx.fiber.dispose())
+ await ctx.plugin(OTel)
vi.stubEnv('OTEL_EXPORTER_OTLP_COMPRESSION', undefined)
vi.stubEnv('OTEL_EXPORTER_OTLP_LOGS_COMPRESSION', undefined)
})
@@ -79,7 +85,8 @@ function parseContent(content: string): unknown {
function reporter(endpoint: string, overrides: Partial = {}) {
const onFailure = vi.fn()
- const sender = new SessionLogReporter({
+ const sender = ctx.otel.createSessionLogReporter({
+ scope: { name: '@deepseek-ai/dsh-session-telemetry-otel', version: (createRequire(import.meta.url)('../package.json') as { version: string }).version },
exporter: { url: endpoint, timeoutMillis: 1000 }, resourceAttributes: { 'service.name': 'session-test' },
processor: { scheduledDelayMillis: 60000 }, onFailure, ...overrides,
})
@@ -271,3 +278,25 @@ it('bounds the queued record count while a transport request is unsettled', asyn
finish({ code:0 })
await done
})
+
+it('keeps ordinary events and Session logs in independent channels through one Cordis service', async () => {
+ const target = await collector()
+ const ordinary = ctx.otel.createEventReporter({
+ exporter: { url: target.endpoint },
+ resourceAttributes: { 'service.name': 'ordinary-test' },
+ scope: { name: 'ordinary-consumer', version: '1' },
+ processor: { scheduledDelayMillis: 60000 },
+ onFailure: () => { throw new Error('unexpected export failure') },
+ })
+ cleanup.push(() => ordinary.shutdown())
+ const { sender } = reporter(target.endpoint)
+ ordinary.emit({ eventName: 'ui.click', body: 'click', timestamp: Date.now() })
+ sender.reportSessionLog(sessionRecord('authorized'))
+ expect(target.captures).toEqual([])
+ await sender.shutdown()
+ expect(target.captures.flatMap(logs).map(r => r.eventName)).toEqual(['session-log'])
+ await ordinary.shutdown()
+ expect(target.captures.map(c => logs(c).map(r => r.eventName))).toEqual([['session-log'], ['ui.click']])
+ await ctx.fiber.dispose()
+ expect(ctx.get('otel')).toBeUndefined()
+})
diff --git a/packages/telemetry/otel/tsconfig.json b/packages/telemetry/otel/tsconfig.json
new file mode 100644
index 0000000000..e88100b9a0
--- /dev/null
+++ b/packages/telemetry/otel/tsconfig.json
@@ -0,0 +1,21 @@
+{
+ "extends": "../../../tsconfig.base.json",
+ "compilerOptions": {
+ "rootDir": "src",
+ "outDir": "lib/types"
+ },
+ "include": [
+ "src"
+ ],
+ "references": [
+ {
+ "path": "../../../vendor/cordis"
+ },
+ {
+ "path": "../../../vendor/cosmokit"
+ },
+ {
+ "path": "../../core/session"
+ }
+ ]
+}
diff --git a/pnpm-lock.yaml b/pnpm-lock.yaml
index 8381006be1..1a08122bf0 100644
--- a/pnpm-lock.yaml
+++ b/pnpm-lock.yaml
@@ -1986,6 +1986,9 @@ importers:
'@deepseek-ai/dsh-mcp-resources':
specifier: workspace:*
version: link:../../mcp/mcp-resources
+ '@deepseek-ai/dsh-otel':
+ specifier: workspace:*
+ version: link:../../telemetry/otel
'@deepseek-ai/dsh-permission-presets':
specifier: workspace:*
version: link:../../interaction/permission-presets
@@ -8992,24 +8995,12 @@ importers:
'@deepseek-ai/schemastery':
specifier: link:../../../vendor/schemastery
version: link:../../../vendor/schemastery
- '@opentelemetry/api':
- specifier: ^1.9.1
- version: 1.9.1
'@opentelemetry/api-logs':
specifier: ^0.220.0
version: 0.220.0
- '@opentelemetry/core':
- specifier: 2.9.0
- version: 2.9.0(@opentelemetry/api@1.9.1)
'@opentelemetry/otlp-exporter-base':
specifier: ^0.220.0
version: 0.220.0(@opentelemetry/api@1.9.1)
- '@opentelemetry/otlp-transformer':
- specifier: ^0.220.0
- version: 0.220.0(@opentelemetry/api@1.9.1)
- '@opentelemetry/resources':
- specifier: ^2.9.0
- version: 2.10.0(@opentelemetry/api@1.9.1)
'@opentelemetry/sdk-logs':
specifier: ^0.220.0
version: 0.220.0(@opentelemetry/api@1.9.1)
@@ -9026,6 +9017,9 @@ importers:
'@deepseek-ai/dsh-loader-smoke':
specifier: workspace:*
version: link:../../test-support/loader-smoke
+ '@deepseek-ai/dsh-otel':
+ specifier: workspace:*
+ version: link:../../telemetry/otel
packages/host/webserver:
dependencies:
@@ -10911,24 +10905,12 @@ importers:
'@deepseek-ai/schemastery':
specifier: link:../../../vendor/schemastery
version: link:../../../vendor/schemastery
- '@opentelemetry/api':
- specifier: ^1.9.1
- version: 1.9.1
'@opentelemetry/api-logs':
specifier: ^0.220.0
version: 0.220.0
- '@opentelemetry/core':
- specifier: 2.9.0
- version: 2.9.0(@opentelemetry/api@1.9.1)
'@opentelemetry/otlp-exporter-base':
specifier: ^0.220.0
version: 0.220.0(@opentelemetry/api@1.9.1)
- '@opentelemetry/otlp-transformer':
- specifier: ^0.220.0
- version: 0.220.0(@opentelemetry/api@1.9.1)
- '@opentelemetry/resources':
- specifier: ^2.9.0
- version: 2.10.0(@opentelemetry/api@1.9.1)
'@opentelemetry/sdk-logs':
specifier: ^0.220.0
version: 0.220.0(@opentelemetry/api@1.9.1)
@@ -10966,6 +10948,9 @@ importers:
'@deepseek-ai/dsh-message-feedback':
specifier: workspace:*
version: link:../../feedback/message-feedback
+ '@deepseek-ai/dsh-otel':
+ specifier: workspace:*
+ version: link:../../telemetry/otel
'@deepseek-ai/dsh-session':
specifier: workspace:*
version: link:../../core/session
@@ -12707,6 +12692,37 @@ importers:
specifier: workspace:~
version: link:../../../vendor/cordis
+ packages/telemetry/otel:
+ dependencies:
+ '@opentelemetry/api':
+ specifier: ^1.9.1
+ version: 1.9.1
+ '@opentelemetry/api-logs':
+ specifier: ^0.220.0
+ version: 0.220.0
+ '@opentelemetry/core':
+ specifier: 2.9.0
+ version: 2.9.0(@opentelemetry/api@1.9.1)
+ '@opentelemetry/otlp-exporter-base':
+ specifier: ^0.220.0
+ version: 0.220.0(@opentelemetry/api@1.9.1)
+ '@opentelemetry/otlp-transformer':
+ specifier: ^0.220.0
+ version: 0.220.0(@opentelemetry/api@1.9.1)
+ '@opentelemetry/resources':
+ specifier: ^2.9.0
+ version: 2.10.0(@opentelemetry/api@1.9.1)
+ '@opentelemetry/sdk-logs':
+ specifier: ^0.220.0
+ version: 0.220.0(@opentelemetry/api@1.9.1)
+ devDependencies:
+ '@deepseek-ai/cordis':
+ specifier: workspace:~
+ version: link:../../../vendor/cordis
+ '@deepseek-ai/dsh-session':
+ specifier: workspace:*
+ version: link:../../core/session
+
packages/terminal/terminal:
devDependencies:
'@deepseek-ai/cordis':
@@ -14025,6 +14041,9 @@ importers:
'@deepseek-ai/dsh-message-feedback':
specifier: workspace:*
version: link:../../packages/feedback/message-feedback
+ '@deepseek-ai/dsh-otel':
+ specifier: workspace:*
+ version: link:../../packages/telemetry/otel
'@deepseek-ai/dsh-output-retention':
specifier: workspace:*
version: link:../../packages/util/output-retention
diff --git a/python/sdk-runtime/package.json b/python/sdk-runtime/package.json
index 3083c4ad9f..6fde3d59f4 100644
--- a/python/sdk-runtime/package.json
+++ b/python/sdk-runtime/package.json
@@ -152,6 +152,7 @@
"@deepseek-ai/dsh-web-search-perplexity": "workspace:*",
"@deepseek-ai/dsh-workflow": "workspace:*",
"@deepseek-ai/dsh-workflow-ptc": "workspace:*",
+ "@deepseek-ai/dsh-otel": "workspace:*",
"@deepseek-ai/schemastery": "workspace:~"
}
}
diff --git a/scripts/gen-cordis-catalog.ts b/scripts/gen-cordis-catalog.ts
index facc1d7222..b62ff2606a 100644
--- a/scripts/gen-cordis-catalog.ts
+++ b/scripts/gen-cordis-catalog.ts
@@ -52,6 +52,7 @@ export { REGION_BEGIN, REGION_END }
export const SERVICE_PAGE: Record = {
speechToText: 'voice-input.md',
speechController: 'voice-input.md',
+ otel: 'otel.md',
productTelemetry: 'product-telemetry.md',
connection: 'web-server.md',
pluginManager: 'boot.md',
@@ -273,6 +274,12 @@ export const EVENT_WALK_EXEMPTIONS: Record = {
* appear on more than one page.
*/
export const LINK_MAP: Readonly> = {
+ EventLogOptions: 'otel.md',
+ EventLogReporter: 'otel.md',
+ SessionLogOptions: 'otel.md',
+ SessionLogReporter: 'otel.md',
+ OTelEventRecord: 'otel.md',
+ OTelEventScalar: 'otel.md',
ProductTelemetryRecord: 'product-telemetry.md',
ProductTelemetryScalar: 'product-telemetry.md',
WorkspaceChangesSummary: 'deliverables.md',
diff --git a/scripts/gen-doc-graphs.ts b/scripts/gen-doc-graphs.ts
index d9fcf17470..2d02cb8398 100644
--- a/scripts/gen-doc-graphs.ts
+++ b/scripts/gen-doc-graphs.ts
@@ -405,6 +405,14 @@ const SERVICE_ROLES: ServiceRole[] = [
consumers: ['llm-pi-ai'],
note: 'Flows are registered by the plugin that knows how to obtain one credential and keyed by the record they write; the seam owns the conversation and the one-attempt-per-key lifecycle, never the protocol.',
},
+ {
+ key: 'otel',
+ pkg: 'otel',
+ title: 'Shared OTel reporting channels',
+ mode: 'service',
+ consumers: ['host-product-telemetry-otel', 'session-telemetry-otel'],
+ note: 'Product analytics and Session feedback adapters create independent reporting channels through one injected service.',
+ },
{
key: 'productTelemetry',
pkg: 'host-product-telemetry-otel',
diff --git a/scripts/verify-package-readme-model-experience.ts b/scripts/verify-package-readme-model-experience.ts
index 842708cc12..900f0300b5 100644
--- a/scripts/verify-package-readme-model-experience.ts
+++ b/scripts/verify-package-readme-model-experience.ts
@@ -50,6 +50,7 @@ const SENTENCE_MODEL_EXPERIENCE: Readonly> = {
'packages/experimental/speech-to-text-sensevoice': { kind: 'none', reason: 'Local recognition returns transient text without modifying model context.' },
'packages/experimental/client-ui-voice-input': { kind: 'none', reason: 'Inserts reviewable text into the unsent draft without submitting to the Agent.' },
'packages/experimental/voice-input-bundle': { kind: 'none', reason: 'Composes dictation and preparation plugins without adding any model-facing contribution.' },
+ 'packages/telemetry/otel': { kind: 'none', reason: 'The service delivers caller-selected records without changing model context.' },
'packages/host/product-telemetry-otel': { kind: 'none', reason: 'The plugin exports explicit analytics records without contributing model context.' },
'packages/api/terminal-controller': { kind: 'none', reason: 'User-owned terminal processes and screen streams never enter model requests or Session events.' },
'packages/client/ui-sidebar-terminal': { kind: 'none', reason: 'The browser renders user terminal screens without exposing them to the model.' },
diff --git a/tsconfig.base.json b/tsconfig.base.json
index f303dfc77a..60d4d66712 100644
--- a/tsconfig.base.json
+++ b/tsconfig.base.json
@@ -28,6 +28,7 @@
// not declaration path aliases, keep each package/vendor source compiled
// under its own tsconfig boundary.
"paths": {
+ "@deepseek-ai/dsh-otel": ["./packages/telemetry/otel/src"],
"@deepseek-ai/dsh-client-ui-settings-account": ["./packages/client/ui-settings-account/src/index.ts"],
"@deepseek-ai/dsh-client-ui-settings-account/client": ["./packages/client/ui-settings-account/src/client/index.ts"],
"@deepseek-ai/dsh-api-gateway/stream-protocol": ["./packages/api/gateway/src/stream-protocol.ts"],
diff --git a/tsconfig.host.json b/tsconfig.host.json
index f73460ef8c..68e4bcc4ed 100644
--- a/tsconfig.host.json
+++ b/tsconfig.host.json
@@ -198,6 +198,7 @@
"scripts/client-bundle-purity.spec.ts"
],
"references": [
+ { "path": "./packages/telemetry/otel" },
{ "path": "./packages/experimental/speech-to-text" },
{ "path": "./packages/experimental/speech-to-text-sensevoice" },
{ "path": "./packages/experimental/api-speech-to-text" },