dsh-observe 0.2.16 → 0.2.18
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 +13 -0
- package/README-es.md +10 -3
- package/README-hi.md +10 -3
- package/README-pt.md +10 -3
- package/README-zh.md +10 -3
- package/README.md +11 -3
- package/lib/index.js +1 -1
- package/lib/types/version.d.ts +1 -1
- package/lib/types/version.js +1 -1
- package/package.json +11 -9
- package/src/version.ts +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -5,6 +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]
|
|
9
|
+
|
|
10
|
+
## [0.2.18] - 2026-09-25
|
|
11
|
+
|
|
12
|
+
### Changed
|
|
13
|
+
|
|
14
|
+
- Host pins move to `0.1.7-rc.2`; re-verified against that host line. Every `@deepseek-ai/dsh-*` dev/test dependency now pins `0.1.7-rc.2`, the `dshWorkshop.compatibility.dshVersions` timeline appends `0.1.7-rc.2`, and the compatibility baseline in every README records the `dsh-v0.1.7-rc.2` host. The declared host ranges (`engines.dsh` and the `peerDependencies` union) are deliberately **unchanged** — they already admit `0.1.7-rc.2`, and a range is what the manifest accepts, not what has been tested.
|
|
15
|
+
|
|
16
|
+
## [0.2.17] - 2026-09-24
|
|
17
|
+
### Changed
|
|
18
|
+
|
|
19
|
+
- 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.
|
|
20
|
+
|
|
8
21
|
## [0.2.16] - 2026-09-23
|
|
9
22
|
|
|
10
23
|
### Changed
|
package/README-es.md
CHANGED
|
@@ -25,11 +25,18 @@
|
|
|
25
25
|
|
|
26
26
|
---
|
|
27
27
|
|
|
28
|
+
|
|
29
|
+
<!-- star-cta -->
|
|
30
|
+
## ⭐ 如果它帮到了你
|
|
31
|
+
|
|
32
|
+
Este plugin forma parte de la [familia de plugins DSH](https://github.com/PerryLink) (más de 40, todos Apache-2.0). Si te resulta útil, **dale una estrella**: no desbloquea nada, pero ayuda a que la siguiente persona lo encuentre antes.
|
|
33
|
+
|
|
34
|
+
*English:* part of a 40+ plugin family for DeepSeek Harness. If it is useful, **a star helps the next person find it** — nothing is gated behind it.
|
|
28
35
|
## Compatibility
|
|
29
36
|
|
|
30
37
|
| Superficie | Estado |
|
|
31
38
|
|---|---|
|
|
32
|
-
| Harness | DeepSeek Harness `dsh-v0.1.7-
|
|
39
|
+
| Harness | DeepSeek Harness `dsh-v0.1.7-rc.2` (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). |
|
|
33
40
|
| Node | `^22.19.0 \|\| >=24.0.0` |
|
|
34
41
|
| Backends | OpenTelemetry OTLP/HTTP (traces + metrics, codificación JSON) y Langfuse (observabilidad de LLM) — uno o ambos |
|
|
35
42
|
| Modelo | Independiente del modelo: exporta el flujo `session/event`; no realiza llamadas a modelos |
|
|
@@ -173,7 +180,7 @@ Este plugin **no registra herramientas de modelo** — es un exportador en segun
|
|
|
173
180
|
|
|
174
181
|
## Known limitations
|
|
175
182
|
|
|
176
|
-
- **npm 0.1.7-
|
|
183
|
+
- **npm 0.1.7-rc.2** — el plugin se desarrolla y prueba contra `@deepseek-ai/dsh@0.1.7-rc.2` (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.
|
|
177
184
|
- **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.
|
|
178
185
|
- **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).
|
|
179
186
|
- **Sin muestreo** — toda familia de spans habilitada se exporta; ajusta los interruptores `capture.*` y `batch.maxBufferRecords` para sesiones de alto volumen.
|
|
@@ -182,7 +189,7 @@ Este plugin **no registra herramientas de modelo** — es un exportador en segun
|
|
|
182
189
|
|
|
183
190
|
```sh
|
|
184
191
|
pnpm install # node ^22.19 || >=24
|
|
185
|
-
pnpm run typecheck # tsc: src + tests contra los devDeps 0.1.7-
|
|
192
|
+
pnpm run typecheck # tsc: src + tests contra los devDeps 0.1.7-rc.2 (sin tsconfig paths)
|
|
186
193
|
pnpm run typecheck:ci # tsc contra la línea publicada (sin paths)
|
|
187
194
|
pnpm run check:ruler-live # canario: debe fallar al compilar, probando que la regla sigue viva
|
|
188
195
|
pnpm test # vitest: 126 tests, 18 suites (Context/Session/storage seam reales)
|
package/README-hi.md
CHANGED
|
@@ -25,11 +25,18 @@
|
|
|
25
25
|
|
|
26
26
|
---
|
|
27
27
|
|
|
28
|
+
|
|
29
|
+
<!-- star-cta -->
|
|
30
|
+
## ⭐ 如果它帮到了你
|
|
31
|
+
|
|
32
|
+
यह प्लगइन [DSH प्लगइन परिवार](https://github.com/PerryLink) का हिस्सा है (40+ प्लगइन, सभी Apache-2.0)। अगर यह उपयोगी लगे, तो **एक स्टार दें** — इससे कोई सुविधा अनलॉक नहीं होती, पर अगला व्यक्ति इसे खोज में आसानी से पा लेता है।
|
|
33
|
+
|
|
34
|
+
*English:* part of a 40+ plugin family for DeepSeek Harness. If it is useful, **a star helps the next person find it** — nothing is gated behind it.
|
|
28
35
|
## Compatibility
|
|
29
36
|
|
|
30
37
|
| सतह | स्थिति |
|
|
31
38
|
|---|---|
|
|
32
|
-
| Harness | DeepSeek Harness `dsh-v0.1.7-
|
|
39
|
+
| Harness | DeepSeek Harness `dsh-v0.1.7-rc.2` (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 वर्कफ़्लो कवर करता है)। |
|
|
33
40
|
| Node | `^22.19.0 \|\| >=24.0.0` |
|
|
34
41
|
| बैकएंड | OpenTelemetry OTLP/HTTP (traces + metrics, JSON एन्कोडिंग) और Langfuse (LLM ऑब्ज़र्वेबिलिटी) — एक या दोनों |
|
|
35
42
|
| मॉडल | मॉडल-स्वतंत्र: यह `session/event` स्ट्रीम निर्यात करता है; कोई मॉडल कॉल नहीं करता |
|
|
@@ -173,7 +180,7 @@ dsh --profile web --dump-config | grep -A2 'id: dsh-observe'
|
|
|
173
180
|
|
|
174
181
|
## Known limitations
|
|
175
182
|
|
|
176
|
-
- **npm 0.1.7-
|
|
183
|
+
- **npm 0.1.7-rc.2** — प्लगइन `@deepseek-ai/dsh@0.1.7-rc.2` के विरुद्ध विकसित और परीक्षित है (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 वर्कफ़्लो पुराने बेसलाइन कवर करते हैं।
|
|
177
184
|
- **ऑडिट इवेंट्स संग्रहीत नहीं होते** — एक्सपोर्टर के स्वयं के `observe/*` रिकॉर्ड केवल ऑडिट के लिए हैं: वर्तमान होस्ट लाइन पर सत्र append गेट केवल सरफ़ेस इवेंट स्वीकार करता है, इसलिए कोई `observe/*` इवेंट सत्र लॉग में नहीं लिखा जाता, और प्लगइन बिना मार्क के append से इसे नकली नहीं बनाता (इससे सत्र अपठनीय हो जाते)। ऑडिट सतह के लिए `/observe` स्टेटस आउटपुट और OTLP/Langfuse बैकएंड देखें।
|
|
178
185
|
- **मेट्रिक्स पुनर्प्रयास/spool पथ से बचती हैं** — OTLP मेट्रिक्स संचयी रूप से एकत्र होती हैं, इसलिए खोया flush अगले में स्वयं-सुधर जाता है (डिज़ाइन से, बग नहीं)।
|
|
179
186
|
- **कोई सैंपलिंग नहीं** — हर सक्षम span परिवार निर्यात होता है; उच्च-मात्रा सत्रों के लिए `capture.*` स्विच और `batch.maxBufferRecords` समायोजित करें।
|
|
@@ -182,7 +189,7 @@ dsh --profile web --dump-config | grep -A2 'id: dsh-observe'
|
|
|
182
189
|
|
|
183
190
|
```sh
|
|
184
191
|
pnpm install # node ^22.19 || >=24
|
|
185
|
-
pnpm run typecheck # tsc: src + tests 0.1.7-
|
|
192
|
+
pnpm run typecheck # tsc: src + tests 0.1.7-rc.2 devDeps के विरुद्ध (कोई tsconfig paths नहीं)
|
|
186
193
|
pnpm run typecheck:ci # tsc प्रकाशित लाइन के विरुद्ध (बिना paths)
|
|
187
194
|
pnpm run check:ruler-live # कैनरी: कंपाइल विफल होना चाहिए, यह सिद्ध करते हुए कि रूलर जीवित है
|
|
188
195
|
pnpm test # vitest: 126 टेस्ट, 18 सुइट (वास्तविक Context/Session/storage seam)
|
package/README-pt.md
CHANGED
|
@@ -25,11 +25,18 @@
|
|
|
25
25
|
|
|
26
26
|
---
|
|
27
27
|
|
|
28
|
+
|
|
29
|
+
<!-- star-cta -->
|
|
30
|
+
## ⭐ 如果它帮到了你
|
|
31
|
+
|
|
32
|
+
Este plugin faz parte da [família de plugins DSH](https://github.com/PerryLink) (mais de 40, todos Apache-2.0). Se for útil, **deixe uma estrela**: não desbloqueia nada, mas ajuda a próxima pessoa a encontrá-lo.
|
|
33
|
+
|
|
34
|
+
*English:* part of a 40+ plugin family for DeepSeek Harness. If it is useful, **a star helps the next person find it** — nothing is gated behind it.
|
|
28
35
|
## Compatibility
|
|
29
36
|
|
|
30
37
|
| Superfície | Status |
|
|
31
38
|
|---|---|
|
|
32
|
-
| Harness | DeepSeek Harness `dsh-v0.1.7-
|
|
39
|
+
| Harness | DeepSeek Harness `dsh-v0.1.7-rc.2` (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). |
|
|
33
40
|
| Node | `^22.19.0 \|\| >=24.0.0` |
|
|
34
41
|
| Backends | OpenTelemetry OTLP/HTTP (traces + metrics, codificação JSON) e Langfuse (observabilidade de LLM) — um ou ambos |
|
|
35
42
|
| Modelo | Independente de modelo: exporta o fluxo `session/event`; não faz chamadas a modelos |
|
|
@@ -173,7 +180,7 @@ Este plugin **não registra ferramentas de modelo** — é um exportador em segu
|
|
|
173
180
|
|
|
174
181
|
## Known limitations
|
|
175
182
|
|
|
176
|
-
- **npm 0.1.7-
|
|
183
|
+
- **npm 0.1.7-rc.2** — o plugin é desenvolvido e testado contra `@deepseek-ai/dsh@0.1.7-rc.2` (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.
|
|
177
184
|
- **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.
|
|
178
185
|
- **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).
|
|
179
186
|
- **Sem amostragem** — toda família de spans habilitada é exportada; ajuste os interruptores `capture.*` e `batch.maxBufferRecords` para sessões de alto volume.
|
|
@@ -182,7 +189,7 @@ Este plugin **não registra ferramentas de modelo** — é um exportador em segu
|
|
|
182
189
|
|
|
183
190
|
```sh
|
|
184
191
|
pnpm install # node ^22.19 || >=24
|
|
185
|
-
pnpm run typecheck # tsc: src + tests contra os devDeps 0.1.7-
|
|
192
|
+
pnpm run typecheck # tsc: src + tests contra os devDeps 0.1.7-rc.2 (sem tsconfig paths)
|
|
186
193
|
pnpm run typecheck:ci # tsc contra a linha publicada (sem paths)
|
|
187
194
|
pnpm run check:ruler-live # canário: deve falhar ao compilar, provando que a régua segue viva
|
|
188
195
|
pnpm test # vitest: 126 testes, 18 suítes (Context/Session/storage seam reais)
|
package/README-zh.md
CHANGED
|
@@ -25,11 +25,18 @@
|
|
|
25
25
|
|
|
26
26
|
---
|
|
27
27
|
|
|
28
|
+
|
|
29
|
+
<!-- star-cta -->
|
|
30
|
+
## ⭐ 如果它帮到了你
|
|
31
|
+
|
|
32
|
+
这个插件是 [DSH 插件家族](https://github.com/PerryLink)的一员(40+ 个,全部 Apache-2.0)。如果你在用,**给个 star** —— 它不会解锁任何功能,但会让下一个人在搜索里更容易找到它。
|
|
33
|
+
|
|
34
|
+
*English:* part of a 40+ plugin family for DeepSeek Harness. If it is useful, **a star helps the next person find it** — nothing is gated behind it.
|
|
28
35
|
## Compatibility
|
|
29
36
|
|
|
30
37
|
| 方面 | 状态 |
|
|
31
38
|
|---|---|
|
|
32
|
-
| Harness | DeepSeek Harness `dsh-v0.1.7-
|
|
39
|
+
| Harness | DeepSeek Harness `dsh-v0.1.7-rc.2`(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 工作流覆盖)。 |
|
|
33
40
|
| Node | `^22.19.0 \|\| >=24.0.0` |
|
|
34
41
|
| 后端 | OpenTelemetry OTLP/HTTP(traces + metrics,JSON 编码)与 Langfuse(LLM 可观测)——二选一或同时 |
|
|
35
42
|
| 模型 | 与模型无关:它导出 session/event 流,自身不调用任何模型 |
|
|
@@ -173,7 +180,7 @@ dsh --profile web --dump-config | grep -A2 'id: dsh-observe'
|
|
|
173
180
|
|
|
174
181
|
## Known limitations
|
|
175
182
|
|
|
176
|
-
- **npm 0.1.7-
|
|
183
|
+
- **npm 0.1.7-rc.2** —— 插件针对 `@deepseek-ai/dsh@0.1.7-rc.2` 开发与测试(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 工作流共同覆盖。
|
|
177
184
|
- **审计事件不落盘** —— 本插件自身的 `observe/*` 记录仅作审计:当前宿主线的会话 append 闸门只接纳 surface 事件,因此不会有 `observe/*` 事件写入会话日志;插件也不会用未标记 append 伪造一条(那会让会话不可读)。审计面请以 `/observe` 状态输出与 OTLP/Langfuse 后端为准。
|
|
178
185
|
- **Metrics 不走重试/缓冲路径** —— OTLP metrics 按累计聚合,丢失一次 flush 会在下一次自愈(设计如此,非缺陷)。
|
|
179
186
|
- **无采样** —— 每个启用的 span 族都会导出;大流量会话请调整 `capture.*` 开关与 `batch.maxBufferRecords`。
|
|
@@ -182,7 +189,7 @@ dsh --profile web --dump-config | grep -A2 'id: dsh-observe'
|
|
|
182
189
|
|
|
183
190
|
```sh
|
|
184
191
|
pnpm install # node ^22.19 || >=24
|
|
185
|
-
pnpm run typecheck # tsc:src + tests,对照 0.1.7-
|
|
192
|
+
pnpm run typecheck # tsc:src + tests,对照 0.1.7-rc.2 devDeps(无 tsconfig paths)
|
|
186
193
|
pnpm run typecheck:ci # tsc:对照已发布线(无 paths)
|
|
187
194
|
pnpm run check:ruler-live # canary:必须编译失败,以证明尺子仍是活的
|
|
188
195
|
pnpm test # vitest:126 个测试、18 个套件(真实 Context/Session/storage 接缝)
|
package/README.md
CHANGED
|
@@ -26,11 +26,19 @@
|
|
|
26
26
|
|
|
27
27
|
---
|
|
28
28
|
|
|
29
|
+
<!-- star-cta -->
|
|
30
|
+
## ⭐ 如果它帮到了你
|
|
31
|
+
|
|
32
|
+
这个插件是 [DSH 插件家族](https://github.com/PerryLink)的一员(40+ 个,全部 Apache-2.0)。如果你在用,**给个 star** —— 它不会解锁任何功能,但会让下一个人在搜索里更容易找到它。
|
|
33
|
+
|
|
34
|
+
*English:* part of a 40+ plugin family for DeepSeek Harness. If it is useful, **a star helps the next person find it** — nothing is gated behind it.
|
|
35
|
+
|
|
36
|
+
|
|
29
37
|
## Compatibility
|
|
30
38
|
|
|
31
39
|
| Surface | Status |
|
|
32
40
|
|---|---|
|
|
33
|
-
| Harness | DeepSeek Harness `dsh-v0.1.7-
|
|
41
|
+
| Harness | DeepSeek Harness `dsh-v0.1.7-rc.2` (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). |
|
|
34
42
|
| Node | `^22.19.0 \|\| >=24.0.0` |
|
|
35
43
|
| Backends | OpenTelemetry OTLP/HTTP (traces + metrics, JSON encoding) and Langfuse (LLM observability) — either or both |
|
|
36
44
|
| Model | Model-agnostic: it exports the session/event stream; no model calls are made |
|
|
@@ -174,7 +182,7 @@ This plugin registers **no model tools** — it is a background exporter. Its su
|
|
|
174
182
|
|
|
175
183
|
## Known limitations
|
|
176
184
|
|
|
177
|
-
- **npm 0.1.7-
|
|
185
|
+
- **npm 0.1.7-rc.2** — the plugin is developed and tested against `@deepseek-ai/dsh@0.1.7-rc.2` (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.
|
|
178
186
|
- **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.
|
|
179
187
|
- **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).
|
|
180
188
|
- **No sampling** — every enabled span family is exported; set `capture.*` switches and `batch.maxBufferRecords` for high-volume sessions.
|
|
@@ -183,7 +191,7 @@ This plugin registers **no model tools** — it is a background exporter. Its su
|
|
|
183
191
|
|
|
184
192
|
```sh
|
|
185
193
|
pnpm install # node ^22.19 || >=24
|
|
186
|
-
pnpm run typecheck # tsc: src + tests against the 0.1.7-
|
|
194
|
+
pnpm run typecheck # tsc: src + tests against the 0.1.7-rc.2 devDeps (no tsconfig paths)
|
|
187
195
|
pnpm run typecheck:ci # tsc against the published line (no paths)
|
|
188
196
|
pnpm run check:ruler-live # canary: must fail to compile, proving the ruler is live
|
|
189
197
|
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.
|
|
610
|
+
const VERSION = "0.2.18";
|
|
611
611
|
//#endregion
|
|
612
612
|
//#region src/sinks.ts
|
|
613
613
|
/** POST a JSON body with a timeout; throws on non-2xx. */
|
package/lib/types/version.d.ts
CHANGED
package/lib/types/version.js
CHANGED
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-observe",
|
|
3
|
-
"version": "0.2.
|
|
3
|
+
"version": "0.2.18",
|
|
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,9 @@
|
|
|
71
71
|
],
|
|
72
72
|
"compatibility": {
|
|
73
73
|
"dshVersions": [
|
|
74
|
-
"0.1.7-alpha.2"
|
|
74
|
+
"0.1.7-alpha.2",
|
|
75
|
+
"0.1.7-rc.1",
|
|
76
|
+
"0.1.7-rc.2"
|
|
75
77
|
]
|
|
76
78
|
},
|
|
77
79
|
"capability": {
|
|
@@ -123,16 +125,16 @@
|
|
|
123
125
|
"zod": "^4.4.3"
|
|
124
126
|
},
|
|
125
127
|
"devDependencies": {
|
|
126
|
-
"@deepseek-ai/dsh-attachment": "0.1.7-
|
|
128
|
+
"@deepseek-ai/dsh-attachment": "0.1.7-rc.2",
|
|
127
129
|
"@deepseek-ai/cordis": "^4.0.3",
|
|
128
130
|
"@deepseek-ai/cordis-plugin-include": "^1.0.7",
|
|
129
131
|
"@deepseek-ai/cordis-plugin-loader": "^1.0.3",
|
|
130
|
-
"@deepseek-ai/dsh-llm": "0.1.7-
|
|
131
|
-
"@deepseek-ai/dsh-session": "0.1.7-
|
|
132
|
-
"@deepseek-ai/dsh-storage": "0.1.7-
|
|
133
|
-
"@deepseek-ai/dsh-storage-domain": "0.1.7-
|
|
134
|
-
"@deepseek-ai/dsh-storage-json": "0.1.7-
|
|
135
|
-
"@deepseek-ai/dsh-typert-protocol": "0.1.7-
|
|
132
|
+
"@deepseek-ai/dsh-llm": "0.1.7-rc.2",
|
|
133
|
+
"@deepseek-ai/dsh-session": "0.1.7-rc.2",
|
|
134
|
+
"@deepseek-ai/dsh-storage": "0.1.7-rc.2",
|
|
135
|
+
"@deepseek-ai/dsh-storage-domain": "0.1.7-rc.2",
|
|
136
|
+
"@deepseek-ai/dsh-storage-json": "0.1.7-rc.2",
|
|
137
|
+
"@deepseek-ai/dsh-typert-protocol": "0.1.7-rc.2",
|
|
136
138
|
"@deepseek-ai/schemastery": "^3.18.3",
|
|
137
139
|
"@types/node": "^22.19.0",
|
|
138
140
|
"@vitest/coverage-v8": "^3.2.0",
|
package/src/version.ts
CHANGED