@deepseek-ai/dsh-llm 0.0.1-rc.1 → 0.0.1-rc.2

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/llm/llm/README.md
-README.md: c74dd5705ab67d5bf4bf966cfb9004e6ae1cc3d7
+README.md: a5aa3155c57ae30d58ced3c79a3db903c675fd7e
 README.zh.md: 17a0fd92b48db3ea5122ac2f1c1ed6e116e6d6e0

package/README.md

@@ -6,7 +6,7 @@ Provider-neutral LLM vocabulary and abstract service. This package defines the c
 
 ## Service: `LlmService` (ctx key: `llm`)
 
-An adapter registry plus a single streaming call surface, interceptable via a waterfall event.
+An adapter registry plus a single streaming call API, interceptable via a waterfall event.
 
 ### Public API
 
@@ -73,7 +73,7 @@ Every adapter that puts a credential in an HTTP header judges it the same way be
 - `BlockAssembler` — incrementally assembles raw chunks into complete content blocks and can create an identified, frozen assistant message from them. The agent loop feeds it raw chunks (logging them for replay) while reading the assembled blocks for history.
 - `HarnessError` — base class for the harness error taxonomy: a stable `code` string (distinct from the human `message`) plus `cause` chaining. Lives here, in the leaf package every other imports, so a single base is shared without a new dependency edge. Per-package errors (`LlmError`, `ToolArgsError`, `InvariantError`, …) extend it. `isHarnessError(value)` narrows at process boundaries.
 - `LlmError` — extends `HarnessError`; its stable `code` string (`NO_ADAPTER`, `DUPLICATE_ADAPTER`, and adapter codes like `AUTH`/`RATE_LIMIT`) matches its frozen serializable `failure.code`. The payload may also retain validated status, `Retry-After`, and branded provider request id facts; policy remains outside the error.
-- `errorChain(value)` — renders a thrown value with its full `cause` chain and AggregateError members for diagnostic surfaces (UI notices, logger lines, durable `turn/end` messages), so transport wrappers like undici's `TypeError: fetch failed` surface the underlying `ECONNREFUSED`/DNS/TLS detail instead of masking it. Rendering only — route on `code`, never by parsing the result.
+- `errorChain(value)` — renders a thrown value with its full `cause` chain and AggregateError members for diagnostic outputs (UI notices, logger lines, durable `turn/end` messages), so transport wrappers like undici's `TypeError: fetch failed` surface the underlying `ECONNREFUSED`/DNS/TLS detail instead of masking it. Rendering only — route on `code`, never by parsing the result.
 - `CONTEXT_WINDOW_EXCEEDED_CODE` — the provider-neutral code both DeepSeek adapters use when a request exceeds the model context window, regardless of thrown-HTTP versus in-band finish delivery. `isContextWindowExceededError(detail)` is their shared conservative classifier for OpenAI-compatible provider detail.
 - `QUOTA_EXCEEDED_CODE` — the non-transient provider-neutral code for exhausted account quota, balance, credits, budget, or usage limits. `isQuotaExceededError(detail)` keeps those failures distinct from request-rate limits.
 - `EMPTY_RESPONSE_CODE` — the provider-neutral code both adapters use for a degenerate provider completion: a terminal `stop` that carried no content blocks at all. Classified as an error finish (not a successful empty message) because the attempt produced nothing durable; `dsh-llm-retry` retries it by default.

package/lib/index.js

@@ -578,7 +578,7 @@ const { version } = createRequire(import.meta.url)("../package.json");
 const APP_IDENTITY = {
 	product: "deepseek-harness",
 	version,
-	url: "https://github.com/deepseek-ai/deepseek-harness-sdk"
+	url: "https://github.com/deepseek-ai/deepseek-harness"
 };
 /**
 * The standard `User-Agent` value: `product/version (+url)`. The
@@ -788,7 +788,7 @@ var BlockAssembler = class {
 //#region lib/types/index.js
 /**
 * LLM service: adapter registry with a waterfall-interceptable streaming call
-* surface. Exports the `LlmService` default, the abstract `LlmAdapter` for
+* API. Exports the `LlmService` default, the abstract `LlmAdapter` for
 * provider backends, and `BlockAssembler` for chunk assembly.
 *
 * @module @deepseek-ai/dsh-llm
@@ -898,7 +898,7 @@ var LlmAdapter = class {
 };
 /**
 * The abstract `llm` service: an adapter registry plus a streaming model-call
-* surface, interceptable via the `llm/stream` waterfall.
+* API, interceptable via the `llm/stream` waterfall.
 */
 var LlmService = class extends Service {
 	adapters = /* @__PURE__ */ new Map();

package/lib/types/attribution.d.ts

@@ -18,7 +18,7 @@ export interface AppIdentity {
     product: string;
     /** Product version; sourced from package metadata, never hand-copied. */
     version: string;
-    /** Public home URL of the app, used as the `User-Agent` comment. */
+    /** Repository home URL of the app, used as the `User-Agent` comment. */
     url: string;
 }
 /**

package/lib/types/attribution.js

@@ -21,8 +21,7 @@ const { version } = createRequire(import.meta.url)('../package.json');
 export const APP_IDENTITY = {
     product: 'deepseek-harness',
     version,
-    // TODO(public-home): Ensure this public source repository exists before release.
-    url: 'https://github.com/deepseek-ai/deepseek-harness-sdk',
+    url: 'https://github.com/deepseek-ai/deepseek-harness',
 };
 /**
  * The standard `User-Agent` value: `product/version (+url)`. The

package/lib/types/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * LLM service: adapter registry with a waterfall-interceptable streaming call
- * surface. Exports the `LlmService` default, the abstract `LlmAdapter` for
+ * API. Exports the `LlmService` default, the abstract `LlmAdapter` for
  * provider backends, and `BlockAssembler` for chunk assembly.
  *
  * @module @deepseek-ai/dsh-llm
@@ -41,16 +41,6 @@ declare module '@deepseek-ai/cordis' {
          * @mode waterfall
          */
         'llm/stream'(this: LlmService, options: GenerateOptions, next: () => AsyncIterable<StreamChunk>): AsyncIterable<StreamChunk>;
-        /**
-         * The provider topology changed: an adapter registered or unregistered
-         * routes, or the configurable-provider directory gained or lost entries.
-         * This is a payload-free registry notification fired at each commit point
-         * (including registration disposal); consumers re-read `listProviders()`,
-         * `listModels()`, or `listConfigurableProviders()` for the new state.
-         * Observer failures are contained and cannot veto the registry mutation.
-         * @mode emit
-         */
-        'llm/adapters-updated'(): void;
     }
 }
 /** Structured provider facts and cause accepted by {@link LlmError}. */
@@ -203,7 +193,7 @@ export interface DirectoryRegistrationHandle {
 }
 /**
  * The abstract `llm` service: an adapter registry plus a streaming model-call
- * surface, interceptable via the `llm/stream` waterfall.
+ * API, interceptable via the `llm/stream` waterfall.
  */
 export declare class LlmService extends Service {
     private adapters;

package/lib/types/index.js

@@ -1,6 +1,6 @@
 /**
  * LLM service: adapter registry with a waterfall-interceptable streaming call
- * surface. Exports the `LlmService` default, the abstract `LlmAdapter` for
+ * API. Exports the `LlmService` default, the abstract `LlmAdapter` for
  * provider backends, and `BlockAssembler` for chunk assembly.
  *
  * @module @deepseek-ai/dsh-llm
@@ -143,7 +143,7 @@ export class LlmAdapter {
 }
 /**
  * The abstract `llm` service: an adapter registry plus a streaming model-call
- * surface, interceptable via the `llm/stream` waterfall.
+ * API, interceptable via the `llm/stream` waterfall.
  */
 export class LlmService extends Service {
     adapters = new Map();

package/lib/types/types.d.ts

@@ -7,6 +7,20 @@ import type { Branded } from '@deepseek-ai/dsh-brand';
 import type { ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
 import type { CallId, ProviderRequestId, ReasoningEffortId } from './brand.ts';
 import type { Message } from './message.ts';
+declare module '@deepseek-ai/cordis' {
+    interface Events {
+        /**
+         * The provider topology changed: an adapter registered or unregistered
+         * routes, or the configurable-provider directory gained or lost entries.
+         * This payload-free registry notification fires at each commit point
+         * (including registration disposal); consumers re-read `listProviders()`,
+         * `listModels()`, or `listConfigurableProviders()` for the new state.
+         * Observer failures are contained and cannot veto the registry mutation.
+         * @mode emit
+         */
+        'llm/adapters-updated'(): void;
+    }
+}
 export type { AssistantMessage, AssistantProvenance, Message, MessageSource, MessageSourceMap, ModelMessageSource, ToolMessageSource, ToolResultMessage, UserMessage, } from './message.ts';
 /** Serializable provider or transport failure facts; policy decides whether they are retryable. */
 export interface LlmFailure {
@@ -321,8 +335,8 @@ export interface GenerateOptions {
     stop?: string[];
     signal?: AbortSignal;
     /**
-     * Session identity stamped by the loop for listener routing. Adapters ignore
-     * it; replay uses it to keep concurrent parent and child cursors independent.
+     * Session identity stamped by the loop for request routing. Replay uses it
+     * to separate cursors; adapters may map it to model-hidden transport metadata.
      */
     sessionId?: Branded<'SessionId'>;
     /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-llm",
   "description": "Provider-neutral LLM service interface for the DeepSeek Harness",
-  "version": "0.0.1-rc.1",
+  "version": "0.0.1-rc.2",
   "publishConfig": {
     "access": "restricted"
   },
@@ -45,20 +45,20 @@
   ],
   "license": "BSD-3-Clause",
   "peerDependencies": {
-    "@deepseek-ai/dsh-attachment": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-brand": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-timeout": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-attachment": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-brand": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-timeout": "^0.0.1-rc.2",
     "@deepseek-ai/cordis": "^4.0.1-rc.1"
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1-rc.1"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-attachment": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-brand": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
-    "@deepseek-ai/dsh-timeout": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-attachment": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-brand": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-timeout": "^0.0.1-rc.2",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.2",
     "@deepseek-ai/cordis": "^4.0.1-rc.1"
   }
 }