Releases: loongsuite/dsh-plugin
Release list
v0.1.1
Highlights
- ENTRY and AGENT
gen_ai.input.messagesnow contain only direct DSH messages whosesource.kindisuser. - Runtime snapshots, agent instructions, skill catalogs, goals, and coordinator relays remain available on the LLM span as part of the complete model-visible request.
- Content capture remains disabled by default.
Validation
- 44 tests passed on Node.js 22.19 and 24.
- The exact npm tarball was installed into isolated DSH
0.1.0-rc.6Web and Headless profiles. - A real Headless request exported non-empty OTLP/HTTP protobuf traces and metrics.
- Content-off telemetry excluded prompt and response content attributes.
Compatibility
- DeepSeek Harness:
>=0.1.0-rc.6 <0.2.0 - Node.js:
>=22.19.0
Install or upgrade with:
dsh plugin --profile web add @loongsuite/dsh-plugin@0.1.1
dsh plugin --profile headless add @loongsuite/dsh-plugin@0.1.1npm: https://www.npmjs.com/package/@loongsuite/dsh-plugin/v/0.1.1
v0.1.0
Highlights
- Standalone, native DeepSeek Harness observability plugin with no LoongSuite Pilot or vendor backend dependency.
- One OpenTelemetry GenAI trace per DSH turn:
ENTRY → AGENT → STEP → LLM/TOOL, including retries, errors, tools, subagent metadata, latency, and token usage. - Standard OTLP/HTTP protobuf traces and
gen_ai.client.*metrics for any compatible backend. - Privacy-safe defaults: prompts, responses, tool definitions, arguments, and results are not captured unless explicitly enabled.
- Installable from npm and the DSH community plugin market.
Changes since v0.1.0-beta.2
- Include cache-read and cache-write input tokens in
gen_ai.usage.input_tokenswhile retaining the cache detail attributes. - Honor
OTEL_METRICS_EXPORTER=nonewhenexportMetricsis not explicitly configured. - Add an end-to-end Jaeger quickstart and Langfuse trace example.
- Add Node.js 22/24 CI, release coverage thresholds, and plugin lifecycle tests.
Compatibility
- DeepSeek Harness:
>=0.1.0-rc.6 <0.2.0 - Node.js:
>=22.19.0
Install with:
dsh plugin --profile web add @loongsuite/dsh-plugin
dsh plugin --profile headless add @loongsuite/dsh-pluginnpm: https://www.npmjs.com/package/@loongsuite/dsh-plugin/v/0.1.0
v0.1.0-beta.2
First release under the current name. The package is @loongsuite/dsh-plugin and the repository is loongsuite/dsh-plugin; 0.1.0-beta.1 shipped under the previous names and is deprecated.
Install
dsh plugin --profile web add @loongsuite/dsh-plugin
export OTEL_EXPORTER_OTLP_ENDPOINT=http://localhost:4318
dsh --profile webThe latest and beta npm tags both point at this version.
What it does
Observes DeepSeek Harness's native session, agent-loop, LLM stream, and tool lifecycle, and builds one OpenTelemetry GenAI trace per turn:
ENTRY → AGENT → STEP → LLM / TOOL
Each real LLM attempt is its own span, so retries stay visible under the same step; tool calls are correlated with their results by DSH call ID; subagent sessions get their own trace carrying parent-session and delegation attributes. Errors, aborts, incomplete streams, and plugin shutdown close open spans with an error status. gen_ai.client.operation.duration and gen_ai.client.token.usage metrics are exported alongside the traces.
Everything leaves over standard OTLP/HTTP protobuf, so it lands in Jaeger, Grafana Tempo, SigNoz, Langfuse, or any OTLP-compatible backend. No sidecar and no extra collector process are required, and the plugin does not claim the harness sessionTelemetry seam — it can run next to the official OTLP-logs backend.
Defaults worth knowing
- Prompts, responses, tool definitions, arguments, and results are not captured. Enable them explicitly with
captureContent, or withOTEL_INSTRUMENTATION_GENAI_CAPTURE_MESSAGE_CONTENT=SPAN_ONLY. An explicitcaptureContent: falsealways overrides the process environment. - The plugin owns private tracer and meter providers and never registers a global OpenTelemetry provider.
- Collection and export failures are isolated: they may warn, but never change model or tool behavior.
Verified against
| Component | Supported | Verified |
|---|---|---|
| DeepSeek Harness | >=0.1.0-rc.6 <0.2.0 |
0.1.0-rc.6, Web and headless profiles |
| Node.js | >=22.19.0 |
22.19, 24.19, 25.9 |
Changes since 0.1.0-beta.1
- Package renamed to
@loongsuite/dsh-plugin; the bundle patch row, docs, and instrumentation scope name follow. - Repository renamed to
loongsuite/dsh-plugin, withrepository,homepage, andbugsURLs updated so registry tooling resolves the package correctly. - Added the
dsh-pluginnpm keyword.
Configuration reference, privacy details, and the development guide are in the README.