@deepseek-ai/dsh-session-telemetry-otel 0.2.0-rc.2 → 0.2.1-alpha.2

package/README.i18n.yaml

@@ -54,8 +54,8 @@
   en: 7593cf5d0d2cedd6
   zh: f57cc48a1b5cbfa9
 /deepseek-ai-dsh-session-telemetry-otel/known-limitations-and-deferred-work:
-  en: e43087aea7af4c9e
-  zh: f8b529e2012b4c63
+  en: 5d0b88f8256bd782
+  zh: 36b8d64645ed6c2e
 /deepseek-ai-dsh-session-telemetry-otel/known-limitations-and-deferred-work/dev-note:
-  en: 0065df2648b09ac9
-  zh: b5bac41fc3aec70e
+  en: e67f633dc6fe7773
+  zh: 3bb0c20c93f16f98

package/README.md

@@ -137,7 +137,7 @@ None; the package neither assembles nor sends a provider request.
 
 These limits define where SDK behavior governs and where export guarantees end. They are current package constraints.
 
-- **Upstream experimental tree** — `@opentelemetry/sdk-logs` is published from the upstream experimental tree; SDK API churn lands here and only here, while the seam contract does not move.
+- **Upstream experimental tree** — `@opentelemetry/sdk-logs` is published from the upstream experimental tree; SDK API churn lands in the [shared OTel plugin](../../telemetry/otel/README.md), while the seam contract does not move.
 - **Live-collector behavior belongs to the SDK exporter** — authentication, TLS, throttling, and other real OTLP deployment behavior follow the upstream SDK rather than a package-owned compatibility layer.
 - **Best-effort handoff** — new cold snapshots and a new feedback submission after restart can repeat prefixes; receivers deduplicate by Session id, format version, and event seq. There is no durable outbox, delivery watermark, automatic retry promise, or collector-acceptance guarantee. OTel and the opt-in DeepSeek API path can overlap. Withdrawal exports a deletion event, not remote erasure.
 
@@ -152,5 +152,3 @@ These limits define where SDK behavior governs and where export guarantees end.
 None.
 
 </details>
-
-**Runtime invariant:** No companion is published. Mode selection changes capture handoff, SDK setup, and local diagnostics without mutating session or service state an independent companion can compare. Collector delivery cannot be inferred from local queue state.

package/README.zh.md

@@ -137,7 +137,7 @@ kind: "package-reference"
 
 这些限制说明 SDK 行为在何处起主导作用、导出保证止于何处。它们是当前包约束。
 
-- **上游实验性源码树**——`@opentelemetry/sdk-logs` 从上游实验性源码树发布；SDK API 的变动只会落在本包，也仅落在本包，而 seam 约定不动。
+- **上游实验性源码树**——`@opentelemetry/sdk-logs` 从上游实验性源码树发布；SDK API 的变动落在[共享 OTel 插件](../../telemetry/otel/README.zh.md)，而 seam 约定不动。
 - **真实 collector 行为属于 SDK 导出器**——身份验证、TLS、限流及其他真实 OTLP 部署行为遵循上游 SDK，不由本包自有兼容层处理。
 - **尽力交接**——新冷快照以及重启后的新反馈提交可能重复前缀；接收方按 Session id、格式版本和事件 seq 去重。没有持久化 outbox、投递水位、自动重试承诺或采集端接受保证。OTel 与需显式启用的 DeepSeek API 路径可能重叠。撤回导出删除事件，不是远端擦除。
 
@@ -152,5 +152,3 @@ kind: "package-reference"
 无。
 
 </details>
-
-**运行时不变式：** 不发布伴生入口。模式选择只改变 capture handoff、SDK setup 与本地 diagnostics，不改变可由独立 companion 对照的会话或服务状态。无法根据本地队列状态推断 collector 是否收到记录。

package/lib/index.js

@@ -61,7 +61,8 @@ function sharingStatusFor(mode) {
 * Schemastery validator for {@link Config}; cordis runs it before the plugin
 * starts. The constructor validates endpoint and shutdown requirements; the
 * reporter validates Session byte and queue limits. SDK transport and
-* processor settings retain their upstream types.
+* processor settings use the reporter's accepted option types, which exclude
+* self-observability metering.
 */
 const Config = z.object({
 	mode: z.union(Object.values(SessionTelemetryMode)).default(DEFAULT_TELEMETRY_MODE),

package/lib/types/index.d.ts

@@ -10,8 +10,7 @@
 import z from '@deepseek-ai/schemastery';
 import type { Context } from '@deepseek-ai/cordis';
 import { SessionTelemetryBackend, type SessionTelemetryRecord, type SessionTelemetrySharingStatus } from '@deepseek-ai/dsh-session-telemetry';
-import type { BatchLogRecordProcessorOptions } from '@opentelemetry/sdk-logs';
-import type { OTLPExporterNodeConfigBase } from '@opentelemetry/otlp-exporter-base';
+import type { LogExporterOptions, SessionLogProcessorOptions } from '@deepseek-ai/dsh-otel';
 /** Session-sharing policy selected by {@link Config.mode}. */
 export declare enum SessionTelemetryMode {
     FEEDBACK_ONLY = "FEEDBACK_ONLY",
@@ -30,16 +29,18 @@ export interface Config {
     /**
      * Explicit SDK HTTP transport settings, including optional routing headers.
      * Ambient credentials are not inherited. URL is required while uploading.
+     * Exporter self-observability metering is not supported.
      */
-    exporter?: OTLPExporterNodeConfigBase & {
+    exporter?: Omit<LogExporterOptions, 'url'> & {
         /** Full logs endpoint (e.g. `https://collector.example.com/v1/logs`). Required outside `DISABLED`; validated at load. */
         url?: string;
     };
     /**
      * Count, queue, cadence, and per-request watchdog settings for the byte-bounded
      * processor. A watchdog warning never releases an unsettled transport slot.
+     * SDK processor self-observability metering is not supported.
      */
-    processor?: Omit<BatchLogRecordProcessorOptions, 'exporter'>;
+    processor?: SessionLogProcessorOptions;
     /** Maximum time spent awaiting the SDK provider's complete shutdown path. */
     shutdownTimeoutMillis?: number;
     /** Uncompressed OTLP request byte limit, at most 4,000,000. */
@@ -49,7 +50,8 @@ export interface Config {
  * Schemastery validator for {@link Config}; cordis runs it before the plugin
  * starts. The constructor validates endpoint and shutdown requirements; the
  * reporter validates Session byte and queue limits. SDK transport and
- * processor settings retain their upstream types.
+ * processor settings use the reporter's accepted option types, which exclude
+ * self-observability metering.
  */
 export declare const Config: z<Config>;
 /** Default outer allowance for the SDK's complete shutdown sequence. */

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-session-telemetry-otel",
   "description": "Feedback-authorized Session logs over byte-bounded OpenTelemetry HTTP requests",
-  "version": "0.2.0-rc.2",
+  "version": "0.2.1-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -27,38 +27,36 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@opentelemetry/api-logs": "^0.220.0",
-    "@opentelemetry/otlp-exporter-base": "^0.220.0",
-    "@opentelemetry/sdk-logs": "^0.220.0",
-    "@deepseek-ai/schemastery": "~3.18.4"
+    "@opentelemetry/api-logs": "^0.222.0",
+    "@deepseek-ai/schemastery": "~3.18.5-alpha.1"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-command-feedback": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-llm": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-message-feedback": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-session": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-anonymous-user-id": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-otel": "0.2.0-rc.2",
-    "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-session-telemetry": "0.2.0-rc.2"
+    "@deepseek-ai/dsh-command-feedback": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-message-feedback": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-telemetry": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-anonymous-user-id": "0.2.1-alpha.2",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
+    "@deepseek-ai/dsh-otel": "0.2.1-alpha.2"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis-plugin-logger-console": "~1.0.4",
-    "@deepseek-ai/cordis-plugin-loader": "~1.0.5",
-    "@deepseek-ai/dsh-app-boot": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-bash-local": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-command-feedback": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-llm": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-message-feedback": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-session": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-loader-smoke": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-session-checkpoint-policy": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-session-persistence-jsonl": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-session-telemetry": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-subprocess-local": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-anonymous-user-id": "0.2.0-rc.2",
-    "@deepseek-ai/cordis": "~4.0.4",
-    "@deepseek-ai/dsh-http-proxy": "0.2.0-rc.2",
-    "@deepseek-ai/dsh-otel": "0.2.0-rc.2"
+    "@deepseek-ai/cordis-plugin-logger-console": "~1.0.5-alpha.1",
+    "@deepseek-ai/cordis-plugin-loader": "~1.0.6-alpha.1",
+    "@deepseek-ai/dsh-app-boot": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-bash-local": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-command-feedback": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-message-feedback": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-loader-smoke": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-checkpoint-policy": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-session-telemetry": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-subprocess-local": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-anonymous-user-id": "0.2.1-alpha.2",
+    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
+    "@deepseek-ai/dsh-http-proxy": "0.2.1-alpha.2",
+    "@deepseek-ai/dsh-otel": "0.2.1-alpha.2"
   }
 }