dsh-observe 0.2.15 → 0.2.17

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/CHANGELOG.md CHANGED
@@ -5,7 +5,19 @@ All notable changes to this project are documented in this file.
5
5
  The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
6
6
  and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
7
 
8
- ## [Unreleased]
8
+ ## [0.2.17] - 2026-09-24
9
+ ### Changed
10
+
11
+ - Move the `@deepseek-ai/dsh-*` pins from `0.1.7-alpha.2` to `0.1.7-rc.1` and re-verify against that host line. `dshWorkshop.compatibility.dshVersions` records `0.1.7-rc.1` alongside the earlier lines, the five READMEs name `dsh-v0.1.7-rc.1`, and the compat workflow installs the `0.1.7-rc.1` host (`@deepseek-ai/dsh`, `dsh-base`, `dsh-headless`). The declared peer ranges and `engines.dsh` are deliberately **unchanged**: the existing four-clause union already admits `0.1.7-rc.1`, and the family convention keeps the declared range wider than the verified line. `0.1.7-rc.1` carries no plugin-facing seam change over `0.1.7-alpha.2` — the host's core packages differ only in their version fields — so no source or test expectation had to change. The seven self-referential workspace `overrides` rows move their **values** to `0.1.7-rc.1`; their **keys** keep the `^0.1.7-alpha.2` range deliberately — pnpm matches a prerelease range only against its own `[major, minor, patch]` tuple, so those rows are what keep exactly ONE copy of the host type graph in the tree.
12
+
13
+ ## [0.2.16] - 2026-09-23
14
+
15
+ ### Changed
16
+
17
+ - **Re-verified against the `0.1.7-alpha.2` host; the `@deepseek-ai/dsh-*` host pins move to `0.1.7-alpha.2`.** The `alpha.2` wave removes nothing this plugin consumes: the published type surface of every host package it resolves is either byte-identical to `0.1.7-alpha.1` (`@deepseek-ai/cordis` `4.0.3`≡`4.0.4`, `@deepseek-ai/schemastery` `3.18.3`≡`3.18.4`) or strictly additive (`ToolDefinition.projectContent?`, `ClientModuleLoader.importError()`, six added `dsh-client-locale` keys). The wave's only removals are internals no plugin in this family references — `dsh-subprocess-local` privates and its non-entry `bindManagedProcess`, `dsh-client-web` `assertEntriesActive`, `dsh-app-boot`'s `unhandledRejection` event, `dsh-client-ui-plugin-manager` `apply()`, a refined `dsh-client-ui-primitives` `CodeBlock` signature, and the `diff.files.one`/`diff.files.other` locale key pair. Both rulers therefore stay green on the moved pin: `typecheck` against the checkout, `typecheck:ci` against the published `0.1.7-alpha.2` faces.
18
+ - The declared host range is deliberately **unchanged**. It already admits `0.1.7-alpha.2` (`0.1.7-alpha.2` satisfies the `>=0.1.7-0 <0.2.0` clause), and the family convention keeps peer ranges wider than the verified line rather than narrowing them to it; a range is what the manifest accepts, not what has been tested.
19
+ - Repo documentation (`AGENTS.md`), the workspace graph pin (`pnpm-workspace.yaml`) and the published-line workflow pins move with the manifest, so no file still claims the previous line.
20
+
9
21
 
10
22
  ## [0.2.15] - 2026-09-22
11
23
 
package/README-es.md CHANGED
@@ -17,6 +17,7 @@
17
17
  [![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-observe?label=version)](https://github.com/PerryLink/dsh-observe/releases)
18
18
  [![npm version](https://img.shields.io/npm/v/dsh-observe)](https://www.npmjs.com/package/dsh-observe)
19
19
  [![npm downloads](https://img.shields.io/npm/dm/dsh-observe)](https://www.npmjs.com/package/dsh-observe)
20
+ [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-observe?metric=downloads&lang=es)](https://dshfind.com/es/plugins/PerryLink/dsh-observe?ref=badge)
20
21
 
21
22
  [English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
22
23
 
@@ -28,7 +29,7 @@
28
29
 
29
30
  | Superficie | Estado |
30
31
  |---|---|
31
- | Harness | DeepSeek Harness `dsh-v0.1.7-alpha.1` (adaptado el 2026-09-22): el formato de sesión V4 representa el resultado de una herramienta como un mensaje de primera clase `role: 'tool'` con `toolCallId` + `content` + `isError` opcional en el nivel superior — el bloque de contenido `tool-result` de V3 ya no está en el `ContentBlockMap` del host, y este plugin solo lee la forma V4 (un log V3 anterior a la actualización todavía se proyecta mediante una ruta de compatibilidad de solo lectura). Los demás rasgos del formato de sesión V3 se mantienen: el flujo del asistente se incorpora en `assistant/message` / `assistant/attempt` y el prompt de sistema es el nodo 0 de la superficie (`system/message`); el plugin consume solo el flujo de eventos en vivo y nunca lee archivos de log de sesión. El rango de peers `>=0.1.2-rc.1 <0.2.0 \|\| >=0.1.5-alpha.1 <0.2.0 \|\| >=0.1.6-0 <0.2.0 \|\| >=0.1.7-0 <0.2.0` mantiene instalable cada línea publicada (cadena completa de puertas local; el workflow compat cubre el smoke de instalación de perfil). |
32
+ | Harness | DeepSeek Harness `dsh-v0.1.7-rc.1` (adaptado el 2026-09-22): el formato de sesión V4 representa el resultado de una herramienta como un mensaje de primera clase `role: 'tool'` con `toolCallId` + `content` + `isError` opcional en el nivel superior — el bloque de contenido `tool-result` de V3 ya no está en el `ContentBlockMap` del host, y este plugin solo lee la forma V4 (un log V3 anterior a la actualización todavía se proyecta mediante una ruta de compatibilidad de solo lectura). Los demás rasgos del formato de sesión V3 se mantienen: el flujo del asistente se incorpora en `assistant/message` / `assistant/attempt` y el prompt de sistema es el nodo 0 de la superficie (`system/message`); el plugin consume solo el flujo de eventos en vivo y nunca lee archivos de log de sesión. El rango de peers `>=0.1.2-rc.1 <0.2.0 \|\| >=0.1.5-alpha.1 <0.2.0 \|\| >=0.1.6-0 <0.2.0 \|\| >=0.1.7-0 <0.2.0` mantiene instalable cada línea publicada (cadena completa de puertas local; el workflow compat cubre el smoke de instalación de perfil). |
32
33
  | Node | `^22.19.0 \|\| >=24.0.0` |
33
34
  | Backends | OpenTelemetry OTLP/HTTP (traces + metrics, codificación JSON) y Langfuse (observabilidad de LLM) — uno o ambos |
34
35
  | Modelo | Independiente del modelo: exporta el flujo `session/event`; no realiza llamadas a modelos |
@@ -172,7 +173,7 @@ Este plugin **no registra herramientas de modelo** — es un exportador en segun
172
173
 
173
174
  ## Known limitations
174
175
 
175
- - **npm 0.1.7-alpha.1** — el plugin se desarrolla y prueba contra `@deepseek-ai/dsh@0.1.7-alpha.1` (devDeps y la regla primaria de CI); el rango de peers `>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0` mantiene instalable cada línea publicada, y la segunda regla (`typecheck:ci`) más el workflow compat cubren los baselines antiguos.
176
+ - **npm 0.1.7-rc.1** — el plugin se desarrolla y prueba contra `@deepseek-ai/dsh@0.1.7-rc.1` (devDeps y la regla primaria de CI); el rango de peers `>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0` mantiene instalable cada línea publicada, y la segunda regla (`typecheck:ci`) más el workflow compat cubren los baselines antiguos.
176
177
  - **Los eventos de auditoría no se persisten** — los registros `observe/*` del propio exportador son solo de auditoría: en la línea de host actual la puerta de append de sesión admite eventos de superficie, así que ningún evento `observe/*` se escribe en el log de sesión, y el plugin no lo falsifica con un append sin marcar (eso volvería ilegibles las sesiones). Usa la salida de estado de `/observe` y los backends OTLP/Langfuse como superficie de auditoría.
177
178
  - **Las métricas evitan la ruta de reintento/spool** — las métricas OTLP se agregan de forma acumulativa, así que un flush perdido se autocura en el siguiente (por diseño, no es un fallo).
178
179
  - **Sin muestreo** — toda familia de spans habilitada se exporta; ajusta los interruptores `capture.*` y `batch.maxBufferRecords` para sesiones de alto volumen.
@@ -181,7 +182,7 @@ Este plugin **no registra herramientas de modelo** — es un exportador en segun
181
182
 
182
183
  ```sh
183
184
  pnpm install # node ^22.19 || >=24
184
- pnpm run typecheck # tsc: src + tests contra los devDeps 0.1.7-alpha.1 (sin tsconfig paths)
185
+ pnpm run typecheck # tsc: src + tests contra los devDeps 0.1.7-rc.1 (sin tsconfig paths)
185
186
  pnpm run typecheck:ci # tsc contra la línea publicada (sin paths)
186
187
  pnpm run check:ruler-live # canario: debe fallar al compilar, probando que la regla sigue viva
187
188
  pnpm test # vitest: 126 tests, 18 suites (Context/Session/storage seam reales)
package/README-hi.md CHANGED
@@ -17,6 +17,7 @@
17
17
  [![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-observe?label=version)](https://github.com/PerryLink/dsh-observe/releases)
18
18
  [![npm version](https://img.shields.io/npm/v/dsh-observe)](https://www.npmjs.com/package/dsh-observe)
19
19
  [![npm downloads](https://img.shields.io/npm/dm/dsh-observe)](https://www.npmjs.com/package/dsh-observe)
20
+ [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-observe?metric=downloads&lang=hi)](https://dshfind.com/hi/plugins/PerryLink/dsh-observe?ref=badge)
20
21
 
21
22
  [English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
22
23
 
@@ -28,7 +29,7 @@
28
29
 
29
30
  | सतह | स्थिति |
30
31
  |---|---|
31
- | Harness | DeepSeek Harness `dsh-v0.1.7-alpha.1` (2026-09-22 को अनुकूलित): सत्र प्रारूप V4 टूल परिणाम को प्रथम-श्रेणी `role: 'tool'` संदेश के रूप में रखता है जिसमें शीर्ष-स्तर पर `toolCallId` + `content` + वैकल्पिक `isError` होता है — V3 का `tool-result` कंटेंट ब्लॉक होस्ट के `ContentBlockMap` से हट चुका है, और यह प्लगइन केवल V4 आकार पढ़ता है (अपग्रेड-पूर्व V3 लॉग अभी भी केवल-पठन संगतता पथ से प्रोजेक्ट होता है)। सत्र प्रारूप V3 के शेष लक्षण जारी हैं: सहायक स्ट्रीम `assistant/message` / `assistant/attempt` में एम्बेड होती है और सिस्टम प्रॉम्प्ट सरफ़ेस नोड 0 (`system/message`) है; प्लगइन केवल लाइव इवेंट स्ट्रीम पढ़ता है और कभी सत्र लॉग फ़ाइलें नहीं पढ़ता। peer रेंज `>=0.1.2-rc.1 <0.2.0 \|\| >=0.1.5-alpha.1 <0.2.0 \|\| >=0.1.6-0 <0.2.0 \|\| >=0.1.7-0 <0.2.0` हर प्रकाशित लाइन को इंस्टॉल-योग्य रखती है (स्थानीय पूर्ण गेट श्रृंखला; प्रोफ़ाइल इंस्टॉल स्मोक compat वर्कफ़्लो कवर करता है)। |
32
+ | Harness | DeepSeek Harness `dsh-v0.1.7-rc.1` (2026-09-22 को अनुकूलित): सत्र प्रारूप V4 टूल परिणाम को प्रथम-श्रेणी `role: 'tool'` संदेश के रूप में रखता है जिसमें शीर्ष-स्तर पर `toolCallId` + `content` + वैकल्पिक `isError` होता है — V3 का `tool-result` कंटेंट ब्लॉक होस्ट के `ContentBlockMap` से हट चुका है, और यह प्लगइन केवल V4 आकार पढ़ता है (अपग्रेड-पूर्व V3 लॉग अभी भी केवल-पठन संगतता पथ से प्रोजेक्ट होता है)। सत्र प्रारूप V3 के शेष लक्षण जारी हैं: सहायक स्ट्रीम `assistant/message` / `assistant/attempt` में एम्बेड होती है और सिस्टम प्रॉम्प्ट सरफ़ेस नोड 0 (`system/message`) है; प्लगइन केवल लाइव इवेंट स्ट्रीम पढ़ता है और कभी सत्र लॉग फ़ाइलें नहीं पढ़ता। peer रेंज `>=0.1.2-rc.1 <0.2.0 \|\| >=0.1.5-alpha.1 <0.2.0 \|\| >=0.1.6-0 <0.2.0 \|\| >=0.1.7-0 <0.2.0` हर प्रकाशित लाइन को इंस्टॉल-योग्य रखती है (स्थानीय पूर्ण गेट श्रृंखला; प्रोफ़ाइल इंस्टॉल स्मोक compat वर्कफ़्लो कवर करता है)। |
32
33
  | Node | `^22.19.0 \|\| >=24.0.0` |
33
34
  | बैकएंड | OpenTelemetry OTLP/HTTP (traces + metrics, JSON एन्कोडिंग) और Langfuse (LLM ऑब्ज़र्वेबिलिटी) — एक या दोनों |
34
35
  | मॉडल | मॉडल-स्वतंत्र: यह `session/event` स्ट्रीम निर्यात करता है; कोई मॉडल कॉल नहीं करता |
@@ -172,7 +173,7 @@ dsh --profile web --dump-config | grep -A2 'id: dsh-observe'
172
173
 
173
174
  ## Known limitations
174
175
 
175
- - **npm 0.1.7-alpha.1** — प्लगइन `@deepseek-ai/dsh@0.1.7-alpha.1` के विरुद्ध विकसित और परीक्षित है (devDeps और CI की मुख्य रूलर); peer रेंज `>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0` हर प्रकाशित लाइन को इंस्टॉल-योग्य रखती है, और दूसरी रूलर (`typecheck:ci`) तथा compat वर्कफ़्लो पुराने बेसलाइन कवर करते हैं।
176
+ - **npm 0.1.7-rc.1** — प्लगइन `@deepseek-ai/dsh@0.1.7-rc.1` के विरुद्ध विकसित और परीक्षित है (devDeps और CI की मुख्य रूलर); peer रेंज `>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0` हर प्रकाशित लाइन को इंस्टॉल-योग्य रखती है, और दूसरी रूलर (`typecheck:ci`) तथा compat वर्कफ़्लो पुराने बेसलाइन कवर करते हैं।
176
177
  - **ऑडिट इवेंट्स संग्रहीत नहीं होते** — एक्सपोर्टर के स्वयं के `observe/*` रिकॉर्ड केवल ऑडिट के लिए हैं: वर्तमान होस्ट लाइन पर सत्र append गेट केवल सरफ़ेस इवेंट स्वीकार करता है, इसलिए कोई `observe/*` इवेंट सत्र लॉग में नहीं लिखा जाता, और प्लगइन बिना मार्क के append से इसे नकली नहीं बनाता (इससे सत्र अपठनीय हो जाते)। ऑडिट सतह के लिए `/observe` स्टेटस आउटपुट और OTLP/Langfuse बैकएंड देखें।
177
178
  - **मेट्रिक्स पुनर्प्रयास/spool पथ से बचती हैं** — OTLP मेट्रिक्स संचयी रूप से एकत्र होती हैं, इसलिए खोया flush अगले में स्वयं-सुधर जाता है (डिज़ाइन से, बग नहीं)।
178
179
  - **कोई सैंपलिंग नहीं** — हर सक्षम span परिवार निर्यात होता है; उच्च-मात्रा सत्रों के लिए `capture.*` स्विच और `batch.maxBufferRecords` समायोजित करें।
@@ -181,7 +182,7 @@ dsh --profile web --dump-config | grep -A2 'id: dsh-observe'
181
182
 
182
183
  ```sh
183
184
  pnpm install # node ^22.19 || >=24
184
- pnpm run typecheck # tsc: src + tests 0.1.7-alpha.1 devDeps के विरुद्ध (कोई tsconfig paths नहीं)
185
+ pnpm run typecheck # tsc: src + tests 0.1.7-rc.1 devDeps के विरुद्ध (कोई tsconfig paths नहीं)
185
186
  pnpm run typecheck:ci # tsc प्रकाशित लाइन के विरुद्ध (बिना paths)
186
187
  pnpm run check:ruler-live # कैनरी: कंपाइल विफल होना चाहिए, यह सिद्ध करते हुए कि रूलर जीवित है
187
188
  pnpm test # vitest: 126 टेस्ट, 18 सुइट (वास्तविक Context/Session/storage seam)
package/README-pt.md CHANGED
@@ -17,6 +17,7 @@
17
17
  [![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-observe?label=version)](https://github.com/PerryLink/dsh-observe/releases)
18
18
  [![npm version](https://img.shields.io/npm/v/dsh-observe)](https://www.npmjs.com/package/dsh-observe)
19
19
  [![npm downloads](https://img.shields.io/npm/dm/dsh-observe)](https://www.npmjs.com/package/dsh-observe)
20
+ [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-observe?metric=downloads&lang=pt)](https://dshfind.com/pt/plugins/PerryLink/dsh-observe?ref=badge)
20
21
 
21
22
  [English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
22
23
 
@@ -28,7 +29,7 @@
28
29
 
29
30
  | Superfície | Status |
30
31
  |---|---|
31
- | Harness | DeepSeek Harness `dsh-v0.1.7-alpha.1` (adaptado em 2026-09-22): o formato de sessão V4 representa o resultado de uma ferramenta como uma mensagem de primeira classe `role: 'tool'` com `toolCallId` + `content` + `isError` opcional no nível superior — o bloco de conteúdo `tool-result` do V3 saiu do `ContentBlockMap` do host, e este plugin lê apenas a forma V4 (um log V3 anterior à atualização ainda é projetado por um caminho de compatibilidade somente leitura). Os demais traços do formato de sessão V3 permanecem: o fluxo do assistente é embutido em `assistant/message` / `assistant/attempt` e o prompt de sistema é o nó 0 da superfície (`system/message`); o plugin consome apenas o fluxo de eventos ao vivo e nunca lê arquivos de log de sessão. O intervalo de peers `>=0.1.2-rc.1 <0.2.0 \|\| >=0.1.5-alpha.1 <0.2.0 \|\| >=0.1.6-0 <0.2.0 \|\| >=0.1.7-0 <0.2.0` mantém cada linha publicada instalável (cadeia completa de portas local; o workflow compat cobre o smoke de instalação de perfil). |
32
+ | Harness | DeepSeek Harness `dsh-v0.1.7-rc.1` (adaptado em 2026-09-22): o formato de sessão V4 representa o resultado de uma ferramenta como uma mensagem de primeira classe `role: 'tool'` com `toolCallId` + `content` + `isError` opcional no nível superior — o bloco de conteúdo `tool-result` do V3 saiu do `ContentBlockMap` do host, e este plugin lê apenas a forma V4 (um log V3 anterior à atualização ainda é projetado por um caminho de compatibilidade somente leitura). Os demais traços do formato de sessão V3 permanecem: o fluxo do assistente é embutido em `assistant/message` / `assistant/attempt` e o prompt de sistema é o nó 0 da superfície (`system/message`); o plugin consome apenas o fluxo de eventos ao vivo e nunca lê arquivos de log de sessão. O intervalo de peers `>=0.1.2-rc.1 <0.2.0 \|\| >=0.1.5-alpha.1 <0.2.0 \|\| >=0.1.6-0 <0.2.0 \|\| >=0.1.7-0 <0.2.0` mantém cada linha publicada instalável (cadeia completa de portas local; o workflow compat cobre o smoke de instalação de perfil). |
32
33
  | Node | `^22.19.0 \|\| >=24.0.0` |
33
34
  | Backends | OpenTelemetry OTLP/HTTP (traces + metrics, codificação JSON) e Langfuse (observabilidade de LLM) — um ou ambos |
34
35
  | Modelo | Independente de modelo: exporta o fluxo `session/event`; não faz chamadas a modelos |
@@ -172,7 +173,7 @@ Este plugin **não registra ferramentas de modelo** — é um exportador em segu
172
173
 
173
174
  ## Known limitations
174
175
 
175
- - **npm 0.1.7-alpha.1** — o plugin é desenvolvido e testado contra `@deepseek-ai/dsh@0.1.7-alpha.1` (devDeps e a régua primária do CI); o intervalo de peers `>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0` mantém cada linha publicada instalável, e a segunda régua (`typecheck:ci`) mais o workflow compat cobrem os baselines antigos.
176
+ - **npm 0.1.7-rc.1** — o plugin é desenvolvido e testado contra `@deepseek-ai/dsh@0.1.7-rc.1` (devDeps e a régua primária do CI); o intervalo de peers `>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0` mantém cada linha publicada instalável, e a segunda régua (`typecheck:ci`) mais o workflow compat cobrem os baselines antigos.
176
177
  - **Eventos de auditoria não são persistidos** — os registros `observe/*` do próprio exportador são apenas de auditoria: na linha de host atual o portão de append da sessão admite eventos de superfície, então nenhum evento `observe/*` é gravado no log da sessão, e o plugin não o falsifica com um append sem marcação (isso tornaria as sessões ilegíveis). Use a saída de status do `/observe` e os backends OTLP/Langfuse como superfície de auditoria.
177
178
  - **Métricas evitam o caminho de tentativa/spool** — as métricas OTLP são agregadas cumulativamente, então um flush perdido se autocura no seguinte (por design, não é um bug).
178
179
  - **Sem amostragem** — toda família de spans habilitada é exportada; ajuste os interruptores `capture.*` e `batch.maxBufferRecords` para sessões de alto volume.
@@ -181,7 +182,7 @@ Este plugin **não registra ferramentas de modelo** — é um exportador em segu
181
182
 
182
183
  ```sh
183
184
  pnpm install # node ^22.19 || >=24
184
- pnpm run typecheck # tsc: src + tests contra os devDeps 0.1.7-alpha.1 (sem tsconfig paths)
185
+ pnpm run typecheck # tsc: src + tests contra os devDeps 0.1.7-rc.1 (sem tsconfig paths)
185
186
  pnpm run typecheck:ci # tsc contra a linha publicada (sem paths)
186
187
  pnpm run check:ruler-live # canário: deve falhar ao compilar, provando que a régua segue viva
187
188
  pnpm test # vitest: 126 testes, 18 suítes (Context/Session/storage seam reais)
package/README-zh.md CHANGED
@@ -17,6 +17,7 @@
17
17
  [![Version](https://img.shields.io/github/v/tag/PerryLink/dsh-observe?label=version)](https://github.com/PerryLink/dsh-observe/releases)
18
18
  [![npm version](https://img.shields.io/npm/v/dsh-observe)](https://www.npmjs.com/package/dsh-observe)
19
19
  [![npm downloads](https://img.shields.io/npm/dm/dsh-observe)](https://www.npmjs.com/package/dsh-observe)
20
+ [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-observe?metric=downloads&lang=zh)](https://dshfind.com/zh/plugins/PerryLink/dsh-observe?ref=badge)
20
21
 
21
22
  [English](README.md) · [简体中文](README-zh.md) · [Español](README-es.md) · [Português](README-pt.md) · [हिन्दी](README-hi.md)
22
23
 
@@ -28,7 +29,7 @@
28
29
 
29
30
  | 方面 | 状态 |
30
31
  |---|---|
31
- | Harness | DeepSeek Harness `dsh-v0.1.7-alpha.1`(2026-09-22 已适配):会话格式 V4 把工具结果改为 `role: 'tool'` 的一等消息,顶层携带 `toolCallId` + `content` + 可选 `isError` —— V3 的 `tool-result` 内容块已从宿主 `ContentBlockMap` 移除,本插件只读 V4 形状(升级前的 V3 日志仍可经只读兼容路径投影)。会话格式 V3 的其余特征沿用:助手流内嵌到 `assistant/message` / `assistant/attempt`,系统提示词为 surface 节点 0(`system/message`);本插件只消费实时事件流,从不读取会话日志文件。peer 复合范围 `>=0.1.2-rc.1 <0.2.0 \|\| >=0.1.5-alpha.1 <0.2.0 \|\| >=0.1.6-0 <0.2.0 \|\| >=0.1.7-0 <0.2.0` 保持每条已发布线可安装(本地完整门禁链;profile 安装冒烟由 compat 工作流覆盖)。 |
32
+ | Harness | DeepSeek Harness `dsh-v0.1.7-rc.1`(2026-09-22 已适配):会话格式 V4 把工具结果改为 `role: 'tool'` 的一等消息,顶层携带 `toolCallId` + `content` + 可选 `isError` —— V3 的 `tool-result` 内容块已从宿主 `ContentBlockMap` 移除,本插件只读 V4 形状(升级前的 V3 日志仍可经只读兼容路径投影)。会话格式 V3 的其余特征沿用:助手流内嵌到 `assistant/message` / `assistant/attempt`,系统提示词为 surface 节点 0(`system/message`);本插件只消费实时事件流,从不读取会话日志文件。peer 复合范围 `>=0.1.2-rc.1 <0.2.0 \|\| >=0.1.5-alpha.1 <0.2.0 \|\| >=0.1.6-0 <0.2.0 \|\| >=0.1.7-0 <0.2.0` 保持每条已发布线可安装(本地完整门禁链;profile 安装冒烟由 compat 工作流覆盖)。 |
32
33
  | Node | `^22.19.0 \|\| >=24.0.0` |
33
34
  | 后端 | OpenTelemetry OTLP/HTTP(traces + metrics,JSON 编码)与 Langfuse(LLM 可观测)——二选一或同时 |
34
35
  | 模型 | 与模型无关:它导出 session/event 流,自身不调用任何模型 |
@@ -172,7 +173,7 @@ dsh --profile web --dump-config | grep -A2 'id: dsh-observe'
172
173
 
173
174
  ## Known limitations
174
175
 
175
- - **npm 0.1.7-alpha.1** —— 插件针对 `@deepseek-ai/dsh@0.1.7-alpha.1` 开发与测试(devDeps 与 CI 主尺子);peer 复合范围 `>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0` 保持每条已发布线可安装,旧基线与第二把尺子(`typecheck:ci`)及 compat 工作流共同覆盖。
176
+ - **npm 0.1.7-rc.1** —— 插件针对 `@deepseek-ai/dsh@0.1.7-rc.1` 开发与测试(devDeps 与 CI 主尺子);peer 复合范围 `>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0` 保持每条已发布线可安装,旧基线与第二把尺子(`typecheck:ci`)及 compat 工作流共同覆盖。
176
177
  - **审计事件不落盘** —— 本插件自身的 `observe/*` 记录仅作审计:当前宿主线的会话 append 闸门只接纳 surface 事件,因此不会有 `observe/*` 事件写入会话日志;插件也不会用未标记 append 伪造一条(那会让会话不可读)。审计面请以 `/observe` 状态输出与 OTLP/Langfuse 后端为准。
177
178
  - **Metrics 不走重试/缓冲路径** —— OTLP metrics 按累计聚合,丢失一次 flush 会在下一次自愈(设计如此,非缺陷)。
178
179
  - **无采样** —— 每个启用的 span 族都会导出;大流量会话请调整 `capture.*` 开关与 `batch.maxBufferRecords`。
@@ -181,7 +182,7 @@ dsh --profile web --dump-config | grep -A2 'id: dsh-observe'
181
182
 
182
183
  ```sh
183
184
  pnpm install # node ^22.19 || >=24
184
- pnpm run typecheck # tsc:src + tests,对照 0.1.7-alpha.1 devDeps(无 tsconfig paths)
185
+ pnpm run typecheck # tsc:src + tests,对照 0.1.7-rc.1 devDeps(无 tsconfig paths)
185
186
  pnpm run typecheck:ci # tsc:对照已发布线(无 paths)
186
187
  pnpm run check:ruler-live # canary:必须编译失败,以证明尺子仍是活的
187
188
  pnpm test # vitest:126 个测试、18 个套件(真实 Context/Session/storage 接缝)
package/README.md CHANGED
@@ -3,6 +3,7 @@
3
3
  # 📊 dsh-observe
4
4
  - **1024 store channel**: `npm i -g dsh1024` once, then `dsh1024 plugin --profile web add dsh-observe` (counts toward the [deepseek1024.com](https://deepseek1024.com) install ranking).
5
5
  [![Gitee](https://img.shields.io/badge/Gitee-mirror-c71d23?logo=gitee)](https://gitee.com/perrylink/dsh-observe)
6
+ [![dshfind](https://dshfind.com/api/badge/PerryLink/dsh-observe?metric=downloads)](https://dshfind.com/plugins/PerryLink/dsh-observe?ref=badge)
6
7
  [![OpenSSF Scorecard](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-observe/badge)](https://api.securityscorecards.dev/projects/github.com/PerryLink/dsh-observe)
7
8
 
8
9
  **OpenTelemetry and Langfuse observability exporter for DeepSeek Harness.**
@@ -29,7 +30,7 @@
29
30
 
30
31
  | Surface | Status |
31
32
  |---|---|
32
- | Harness | DeepSeek Harness `dsh-v0.1.7-alpha.1` (adapted 2026-09-22): session format V4 represents a tool result as a first-class `role: 'tool'` message carrying top-level `toolCallId` + `content` + optional `isError` — the V3 `tool-result` content block is gone from the host's `ContentBlockMap`, and this plugin reads only the V4 shape (a pre-upgrade V3 log still projects through a read-only compatibility path). Session format V3's other traits carry over: the assistant stream is embedded in `assistant/message` / `assistant/attempt`, and the system prompt is surface node 0 (`system/message`); the plugin consumes only the live event stream and never reads session log files. The peer range `>=0.1.2-rc.1 <0.2.0 \|\| >=0.1.5-alpha.1 <0.2.0 \|\| >=0.1.6-0 <0.2.0 \|\| >=0.1.7-0 <0.2.0` keeps every published line installable (full local gate chain; the compat workflow covers the profile install smoke). |
33
+ | Harness | DeepSeek Harness `dsh-v0.1.7-rc.1` (adapted 2026-09-22): session format V4 represents a tool result as a first-class `role: 'tool'` message carrying top-level `toolCallId` + `content` + optional `isError` — the V3 `tool-result` content block is gone from the host's `ContentBlockMap`, and this plugin reads only the V4 shape (a pre-upgrade V3 log still projects through a read-only compatibility path). Session format V3's other traits carry over: the assistant stream is embedded in `assistant/message` / `assistant/attempt`, and the system prompt is surface node 0 (`system/message`); the plugin consumes only the live event stream and never reads session log files. The peer range `>=0.1.2-rc.1 <0.2.0 \|\| >=0.1.5-alpha.1 <0.2.0 \|\| >=0.1.6-0 <0.2.0 \|\| >=0.1.7-0 <0.2.0` keeps every published line installable (full local gate chain; the compat workflow covers the profile install smoke). |
33
34
  | Node | `^22.19.0 \|\| >=24.0.0` |
34
35
  | Backends | OpenTelemetry OTLP/HTTP (traces + metrics, JSON encoding) and Langfuse (LLM observability) — either or both |
35
36
  | Model | Model-agnostic: it exports the session/event stream; no model calls are made |
@@ -173,7 +174,7 @@ This plugin registers **no model tools** — it is a background exporter. Its su
173
174
 
174
175
  ## Known limitations
175
176
 
176
- - **npm 0.1.7-alpha.1** — the plugin is developed and tested against `@deepseek-ai/dsh@0.1.7-alpha.1` (devDeps and CI's primary ruler); the peer range `>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0` keeps every published line installable, and the second ruler (`typecheck:ci`) plus the compat workflow cover the older baselines.
177
+ - **npm 0.1.7-rc.1** — the plugin is developed and tested against `@deepseek-ai/dsh@0.1.7-rc.1` (devDeps and CI's primary ruler); the peer range `>=0.1.2-rc.1 <0.2.0 || >=0.1.5-alpha.1 <0.2.0 || >=0.1.6-0 <0.2.0 || >=0.1.7-0 <0.2.0` keeps every published line installable, and the second ruler (`typecheck:ci`) plus the compat workflow cover the older baselines.
177
178
  - **Audit events are not persisted** — the exporter's own `observe/*` records are audit-only: on the current host line the session append gate admits surface events, so no `observe/*` event is written to the session log, and the plugin does not fake one with an unmarked append (that would make sessions unreadable). Treat `/observe` status output and the OTLP/Langfuse backends as the audit surface.
178
179
  - **Metrics bypass the retry/spool path** — OTLP metrics are aggregated cumulatively, so a lost flush self-heals on the next one (by design, not a bug).
179
180
  - **No sampling** — every enabled span family is exported; set `capture.*` switches and `batch.maxBufferRecords` for high-volume sessions.
@@ -182,7 +183,7 @@ This plugin registers **no model tools** — it is a background exporter. Its su
182
183
 
183
184
  ```sh
184
185
  pnpm install # node ^22.19 || >=24
185
- pnpm run typecheck # tsc: src + tests against the 0.1.7-alpha.1 devDeps (no tsconfig paths)
186
+ pnpm run typecheck # tsc: src + tests against the 0.1.7-rc.1 devDeps (no tsconfig paths)
186
187
  pnpm run typecheck:ci # tsc against the published line (no paths)
187
188
  pnpm run check:ruler-live # canary: must fail to compile, proving the ruler is live
188
189
  pnpm test # vitest: 126 tests, 18 suites (real Context/Session/storage seam)
package/lib/index.js CHANGED
@@ -607,7 +607,7 @@ function langfuseId(...parts) {
607
607
  * @module dsh-observe/version
608
608
  */
609
609
  /** The dsh-observe package version, kept in sync with package.json. */
610
- const VERSION = "0.2.15";
610
+ const VERSION = "0.2.17";
611
611
  //#endregion
612
612
  //#region src/sinks.ts
613
613
  /** POST a JSON body with a timeout; throws on non-2xx. */
@@ -6,5 +6,5 @@
6
6
  * @module dsh-observe/version
7
7
  */
8
8
  /** The dsh-observe package version, kept in sync with package.json. */
9
- export declare const VERSION = "0.2.15";
9
+ export declare const VERSION = "0.2.17";
10
10
  //# sourceMappingURL=version.d.ts.map
@@ -6,5 +6,5 @@
6
6
  * @module dsh-observe/version
7
7
  */
8
8
  /** The dsh-observe package version, kept in sync with package.json. */
9
- export const VERSION = '0.2.15';
9
+ export const VERSION = '0.2.17';
10
10
  //# sourceMappingURL=version.js.map
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dsh-observe",
3
- "version": "0.2.15",
3
+ "version": "0.2.17",
4
4
  "description": "OpenTelemetry and Langfuse observability exporter for DeepSeek Harness: turn/step/tool/LLM spans, token and cost metrics, and sanitized LLM prompt/completion capture from the session/event stream, with async batching, bounded offline buffering, and retry with backoff.",
5
5
  "repository": {
6
6
  "type": "git",
@@ -71,7 +71,8 @@
71
71
  ],
72
72
  "compatibility": {
73
73
  "dshVersions": [
74
- "0.1.7-alpha.1"
74
+ "0.1.7-alpha.2",
75
+ "0.1.7-rc.1"
75
76
  ]
76
77
  },
77
78
  "capability": {
@@ -123,16 +124,16 @@
123
124
  "zod": "^4.4.3"
124
125
  },
125
126
  "devDependencies": {
126
- "@deepseek-ai/dsh-attachment": "0.1.7-alpha.1",
127
+ "@deepseek-ai/dsh-attachment": "0.1.7-rc.1",
127
128
  "@deepseek-ai/cordis": "^4.0.3",
128
129
  "@deepseek-ai/cordis-plugin-include": "^1.0.7",
129
130
  "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
130
- "@deepseek-ai/dsh-llm": "0.1.7-alpha.1",
131
- "@deepseek-ai/dsh-session": "0.1.7-alpha.1",
132
- "@deepseek-ai/dsh-storage": "0.1.7-alpha.1",
133
- "@deepseek-ai/dsh-storage-domain": "0.1.7-alpha.1",
134
- "@deepseek-ai/dsh-storage-json": "0.1.7-alpha.1",
135
- "@deepseek-ai/dsh-typert-protocol": "0.1.7-alpha.1",
131
+ "@deepseek-ai/dsh-llm": "0.1.7-rc.1",
132
+ "@deepseek-ai/dsh-session": "0.1.7-rc.1",
133
+ "@deepseek-ai/dsh-storage": "0.1.7-rc.1",
134
+ "@deepseek-ai/dsh-storage-domain": "0.1.7-rc.1",
135
+ "@deepseek-ai/dsh-storage-json": "0.1.7-rc.1",
136
+ "@deepseek-ai/dsh-typert-protocol": "0.1.7-rc.1",
136
137
  "@deepseek-ai/schemastery": "^3.18.3",
137
138
  "@types/node": "^22.19.0",
138
139
  "@vitest/coverage-v8": "^3.2.0",
package/src/version.ts CHANGED
@@ -7,4 +7,4 @@
7
7
  */
8
8
 
9
9
  /** The dsh-observe package version, kept in sync with package.json. */
10
- export const VERSION = '0.2.15'
10
+ export const VERSION = '0.2.17'