@deepseek-ai/dsh-llm 0.1.1-rc.2 → 0.1.2-alpha.2

package/lib/types/message.d.ts

@@ -1,6 +1,6 @@
 /** Message value types, identity, and immutable construction helpers. */
-import { MessageId, type CallId } from './brand.ts';
-import type { ContentBlock, StreamChunk, ToolResultBlock } from './types.ts';
+import type { MessageId, ToolCallId } from './brand.ts';
+import type { ContentBlock, ToolResultBlock } from './types.ts';
 /** Provider/model identity and adapter-private replay data for an assistant message. */
 export interface AssistantProvenance {
     /** Provider route that produced the message. */
@@ -21,7 +21,7 @@ export interface ModelMessageSource extends AssistantProvenance {
 /** Required source of a user-role message carrying one tool result. */
 export interface ToolMessageSource {
     kind: 'tool';
-    callId: CallId;
+    callId: ToolCallId;
 }
 /**
  * The kind of information in producer-supplied context, declared by the
@@ -183,7 +183,7 @@ export declare function createAssistantMessage(input: NewAssistantMessage & {
 }): AssistantMessage;
 /** Input whose acceptance creates one tool-result message. */
 export interface ToolResultMessageInput {
-    readonly callId: CallId;
+    readonly callId: ToolCallId;
     readonly content: ContentBlock[];
     readonly isError: boolean;
 }
@@ -193,14 +193,5 @@ export interface ToolResultMessageInput {
  * @returns an immutable user-role tool-result message.
  */
 export declare function createToolResultMessage(input: ToolResultMessageInput): ToolResultMessage;
-/**
- * Whether a stream chunk carries visible model output (the first-token
- * boundary shared by client step timing and the whole-log sessionStats
- * projection). Empty deltas (heartbeats, empty tool-call frames) do not count
- * as a first token.
- * @param chunk - the stream chunk to test.
- * @returns true when the chunk contains a non-empty text/reasoning/tool delta.
- */
-export declare function isTokenDelta(chunk: StreamChunk): boolean;
 export {};
 //# sourceMappingURL=message.d.ts.map

package/lib/types/message.js

@@ -1,6 +1,7 @@
 /** Message value types, identity, and immutable construction helpers. */
-import { MessageId } from "./brand.js";
-import { deepFreeze } from "./call-config.js";
+import { randomUUID } from '@deepseek-ai/dsh-util-crypto';
+import { brandString } from '@deepseek-ai/dsh-brand';
+import { deepFreeze } from '@deepseek-ai/dsh-util-values';
 /**
  * Bound for a `notice` summary. The account rides a collapsed transcript row
  * and is committed to the durable log, while its inputs — task labels, goal
@@ -33,7 +34,7 @@ export function freezeMessage(message) {
 export function createMessage(input) {
     return freezeMessage({
         ...input,
-        id: MessageId(crypto.randomUUID()),
+        id: brandString(randomUUID()),
     });
 }
 /**
@@ -78,23 +79,4 @@ export function createToolResultMessage(input) {
             }],
     });
 }
-/**
- * Whether a stream chunk carries visible model output (the first-token
- * boundary shared by client step timing and the whole-log sessionStats
- * projection). Empty deltas (heartbeats, empty tool-call frames) do not count
- * as a first token.
- * @param chunk - the stream chunk to test.
- * @returns true when the chunk contains a non-empty text/reasoning/tool delta.
- */
-export function isTokenDelta(chunk) {
-    switch (chunk.type) {
-        case 'text-delta':
-        case 'reasoning-delta':
-            return chunk.text !== '';
-        case 'tool-call-delta':
-            return chunk.argumentsDelta !== '' || chunk.name !== undefined;
-        default:
-            return false;
-    }
-}
 //# sourceMappingURL=message.js.map

package/lib/types/types.d.ts

@@ -5,7 +5,7 @@
  */
 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 { ToolCallId, ProviderRequestId, ReasoningEffortId } from './brand.ts';
 import type { Message } from './message.ts';
 declare module '@deepseek-ai/cordis' {
     interface Events {
@@ -49,7 +49,7 @@ export interface ReasoningBlock {
  * A durable raster image reference, valid in user or assistant content. The
  * block is deliberately role-neutral; assistant-side rendering is forward
  * compatibility — the current production adapters declare text-only output,
- * so only user content carries images today.
+ * so only user messages may carry images.
  */
 export interface ImageBlock {
     type: 'image';
@@ -60,7 +60,7 @@ export interface ImageBlock {
 export interface ToolCallBlock {
     type: 'tool-call';
     /** Provider-issued call id; correlates with the matching tool result. */
-    id: CallId;
+    id: ToolCallId;
     name: string;
     /** Raw JSON string as produced by the model. */
     arguments: string;
@@ -68,7 +68,7 @@ export interface ToolCallBlock {
 /** The result of a tool invocation, sent back to the model. */
 export interface ToolResultBlock {
     type: 'tool-result';
-    toolCallId: CallId;
+    toolCallId: ToolCallId;
     content: ContentBlock[];
     isError?: boolean;
 }
@@ -123,10 +123,46 @@ export type FinishReason = FinishReasonMap[keyof FinishReasonMap];
 export interface TokenUsage {
     inputTokens: number;
     outputTokens: number;
+    /**
+     * Exact full-call total including aggregate prompt and output tokens.
+     *
+     * Adapters preserve a provider total or derive it from authoritative
+     * aggregate prompt/output counters; they omit it when unavailable or
+     * inconsistent.
+     */
+    totalTokens?: number;
     cacheReadTokens?: number;
     cacheWriteTokens?: number;
     reasoningTokens?: number;
 }
+/**
+ * Request price of one ordered image occurrence under one exact model route's
+ * request projection. Every occurrence resolves to the pair the wire actually
+ * carries: provider visual tokens for a retained image, plus the model-visible
+ * text sent with or instead of it (request-preview handle, offload placeholder,
+ * or text-only substitution). The caller prices `text` with its own text
+ * estimator so provider pricing never fixes a text tokenization.
+ */
+export interface LlmImageRequestPrice {
+    /** Provider visual tokens for the retained request image; 0 when only text represents this occurrence. */
+    visualTokens: number;
+    /** Model-visible text sent for this occurrence, to be priced by the caller's text estimator. */
+    text: string;
+}
+/**
+ * Provider-side request-image pricing for one exact model route. Implemented
+ * by adapters whose provider charges visual tokens; consumers (the token
+ * meter) resolve it synchronously per measurement, so implementations must not
+ * perform I/O.
+ */
+export interface LlmImageRequestPricing {
+    /**
+     * Price every image occurrence of one request projection.
+     * @param images - durable image references in request order, one entry per occurrence.
+     * @returns one price per occurrence, aligned by index with `images`.
+     */
+    priceImages(images: readonly ImageAttachmentRef[]): readonly LlmImageRequestPrice[];
+}
 /** Display metadata for one registered provider route. */
 export interface LlmProviderInfo {
     /** Provider route key used by {@link GenerateOptions.provider}. */
@@ -192,9 +228,21 @@ export interface LlmModelDiscoveryRequest {
     api?: string;
     /** Credential for this interrogation alone; the harness never stores it. */
     apiKey?: string;
+}
+/** Provider-side discovery request with operation-local cancellation attached. */
+export interface LlmModelDiscoveryOperation extends LlmModelDiscoveryRequest {
     /** Caller cancellation; implementations must settle promptly after it aborts. */
     signal?: AbortSignal;
 }
+declare module '@deepseek-ai/dsh-typert-protocol' {
+    interface RemoteErrorDetailsMap {
+        /** A draft provider interrogation refused or failed. */
+        'llm/model-discovery-rejected': {
+            readonly settingsNs: string;
+            readonly baseURL?: string;
+        };
+    }
+}
 /**
  * One model an endpoint reports about itself. Every field but the id is
  * optional because most provider listings disclose an id and nothing else;
@@ -299,7 +347,7 @@ export type StreamChunk = {
 } | {
     type: 'tool-call-delta';
     index: number;
-    id: CallId;
+    id: ToolCallId;
     name?: string;
     argumentsDelta: string;
 } | {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-llm",
   "description": "Provider-neutral LLM service interface for the DeepSeek Harness",
-  "version": "0.1.1-rc.2",
+  "version": "0.1.2-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -34,6 +34,14 @@
       "types": "./lib/types/message.d.ts",
       "default": "./lib/types/message.js"
     },
+    "./typert": {
+      "types": "./lib/typert.host.d.ts",
+      "default": "./lib/typert.host.js"
+    },
+    "./remote": {
+      "types": "./lib/typert.remote-client.d.ts",
+      "default": "./lib/typert.remote-client.js"
+    },
     "./src/*": "./src/*",
     "./package.json": "./package.json"
   },
@@ -41,24 +49,28 @@
     "lib/index.js",
     "lib/invariant.js",
     "lib/types/**/*.js",
-    "lib/types/**/*.d.ts"
+    "lib/types/**/*.d.ts",
+    "lib/typert.host.js",
+    "lib/typert.host.d.ts",
+    "lib/typert.remote-client.js",
+    "lib/typert.remote-client.d.ts"
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/dsh-brand": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-attachment": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-timeout": "^0.1.1-rc.2",
-    "@deepseek-ai/cordis": "^4.0.1"
+    "@deepseek-ai/cordis": "^4.0.2"
   },
   "dependencies": {
-    "@deepseek-ai/schemastery": "^3.18.1"
+    "zod": "^4.4.3",
+    "@deepseek-ai/dsh-util-crypto": "^0.1.2-alpha.2",
+    "@deepseek-ai/schemastery": "^3.18.2",
+    "@deepseek-ai/dsh-timeout": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-brand": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-util-values": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.2-alpha.2"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-brand": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-timeout": "^0.1.1-rc.2",
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-attachment": "^0.1.1-rc.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.1-rc.2"
+    "@deepseek-ai/dsh-attachment": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.2",
+    "@deepseek-ai/cordis": "^4.0.2"
   }
 }

package/lib/types/never.d.ts

@@ -1,16 +0,0 @@
-/**
- * Exhaustiveness helper for closed core unions. Use {@link assertNever} at the default branch so a
- * new variant fails compilation at every required handler. Do not use it for declaration-merged
- * unions such as session events or content blocks: handle known variants and explicitly fall
- * through because plugins may add valid unknown cases.
- * @module @deepseek-ai/dsh-llm/never
- */
-/**
- * Mark an unreachable closed-union branch. A newly unhandled typed variant fails at the call site;
- * a value that escaped its type throws with diagnostics at runtime.
- * @param value - the impossible value; typed `never` so an unhandled variant fails compilation at the call site.
- * @param context - optional label (e.g. the switch site) prefixed into the throw message.
- * @returns never — it always throws, with the offending value JSON-rendered in the message.
- */
-export declare function assertNever(value: never, context?: string): never;
-//# sourceMappingURL=never.d.ts.map

package/lib/types/never.js

@@ -1,21 +0,0 @@
-/**
- * Exhaustiveness helper for closed core unions. Use {@link assertNever} at the default branch so a
- * new variant fails compilation at every required handler. Do not use it for declaration-merged
- * unions such as session events or content blocks: handle known variants and explicitly fall
- * through because plugins may add valid unknown cases.
- * @module @deepseek-ai/dsh-llm/never
- */
-/**
- * Mark an unreachable closed-union branch. A newly unhandled typed variant fails at the call site;
- * a value that escaped its type throws with diagnostics at runtime.
- * @param value - the impossible value; typed `never` so an unhandled variant fails compilation at the call site.
- * @param context - optional label (e.g. the switch site) prefixed into the throw message.
- * @returns never — it always throws, with the offending value JSON-rendered in the message.
- */
-export function assertNever(value, context) {
-    // JSON.stringify is typed string but returns undefined for undefined input;
-    // String() covers that and other non-serializable escapes.
-    const rendered = JSON.stringify(value) ?? String(value);
-    throw new Error(`unreachable variant${context ? ` in ${context}` : ''}: ${rendered}`);
-}
-//# sourceMappingURL=never.js.map