@deepseek-ai/dsh-llm 0.1.6-alpha.2 → 0.1.7-alpha.2

package/lib/types/message.d.ts

@@ -1,6 +1,6 @@
 /** Message value types, identity, and immutable construction helpers. */
 import type { MessageId, ToolCallId } from './brand.ts';
-import type { ContentBlock, ToolResultBlock } from './types.ts';
+import type { ContentBlock } from './types.ts';
 /** Provider/model identity and adapter-private replay data for an assistant message. */
 export interface AssistantProviderMetadata {
     /** Provider route that produced the message. */
@@ -18,11 +18,15 @@ export interface AssistantProviderMetadata {
 export interface ModelMessageSource extends AssistantProviderMetadata {
     kind: 'model';
 }
-/** Required source of a user-role message carrying one tool result. */
+/** Required source of a tool-role message carrying one tool result. */
 export interface ToolMessageSource {
     kind: 'tool';
     callId: ToolCallId;
 }
+/** Required source of a system-role message produced by the system-prompt plugin. */
+export interface SystemPromptMessageSource {
+    kind: 'system-prompt';
+}
 /**
  * The kind of information in producer-supplied context, declared by the
  * producer in the same `MessageSource`.
@@ -88,24 +92,24 @@ export type ContextFormed = {
     readonly form: 'recall';
 };
 /**
- * Where a message (or injected content) came from.
- * Merge-extensible sum type — plugins add their own `kind`s.
+ * Where a message (or injected content) came from, in the harness's own
+ * vocabulary. Merge-extensible sum type — each producer declares its own
+ * `kind` in its own module; there is no shared catch-all `plugin` kind.
+ * Model and tool sources answer their role messages; user messages carry any
+ * producer's kind, and consumers fall through unknown kinds.
  */
 export interface MessageSourceMap {
     user: {
         kind: 'user';
     };
-    plugin: {
-        kind: 'plugin';
-        plugin: string;
-    } & ContextFormed;
     model: ModelMessageSource;
     tool: ToolMessageSource;
+    'system-prompt': SystemPromptMessageSource;
 }
 /**
- * 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
- * objectives, tool arguments — are caller text with no length of their own.
+ * Bound for a `notice` summary. Producers commit the one-line account to the
+ * durable log; its inputs — task labels, goal objectives, tool arguments —
+ * are caller text with no length of their own.
  */
 export declare const CONTEXT_SUMMARY_MAX_CHARS = 120;
 /**
@@ -116,42 +120,62 @@ export declare const CONTEXT_SUMMARY_MAX_CHARS = 120;
 export declare function boundContextSummary(summary: string): string;
 /** Any known message source, derived from {@link MessageSourceMap}; switch on `kind` and fall through unknowns (merge-extensible). */
 export type MessageSource = MessageSourceMap[keyof MessageSourceMap];
-/** One immutable message representation shared by delivery, durable history, and model requests. */
-export interface Message {
+/** Shared immutable fields of every conversation message. */
+interface MessageBase {
     /** Stable identity preserved across every representation boundary. */
     readonly id: MessageId;
-    /** Provider-neutral conversation role. */
-    readonly role: 'system' | 'user' | 'assistant';
     /** Exact model-facing blocks. */
-    readonly content: ContentBlock[];
-    /** Required source fields supplied by the producer. */
+    readonly content: readonly ContentBlock[];
+    /** Required source fields supplied by the producer.
+     * @persistenceSource user developer
+     */
     readonly source: MessageSource;
 }
-/** A user-role specialization of the one shared message representation. */
-export interface UserMessage extends Message {
+/** A rendered system prompt attributed to the system-prompt producer; empty content sends no prompt. */
+export interface SystemMessage extends MessageBase {
+    readonly role: 'system';
+    readonly source: MessageSourceMap['system-prompt'];
+}
+/** Incremental agent session changes in conversation order, currently tool additions and removals. */
+export interface DeveloperMessage extends MessageBase {
+    readonly role: 'developer';
+}
+/** A user-role specialization of the shared message representation. */
+export interface UserMessage extends MessageBase {
     readonly role: 'user';
 }
 /** A model-produced assistant specialization of the shared message representation. */
-export interface AssistantMessage extends Message {
+export interface AssistantMessage extends MessageBase {
     readonly role: 'assistant';
     readonly source: ModelMessageSource;
 }
+/** A first-class tool-role message carrying the result of one tool invocation. */
+export interface ToolResultMessage extends MessageBase {
+    readonly role: 'tool';
+    readonly source: ToolMessageSource;
+    /** Provider-issued id of the tool call this message answers. */
+    readonly toolCallId: ToolCallId;
+    /** Whether the tool invocation failed. */
+    readonly isError?: boolean;
+}
 /**
- * A system-role specialization of the shared message representation: one
- * rendered system prompt attributed to the plugin that assembled it. Empty
- * `content` means "no system prompt" and projects to no wire message.
+ * The conversation messages persisted by Session, keyed by role. This map is
+ * closed because every model-visible role must have a durable Session event
+ * and an adapter projection.
  */
-export interface SystemMessage extends Message {
-    readonly role: 'system';
-    readonly source: MessageSourceMap['plugin'];
+export interface MessageRoleMap {
+    system: SystemMessage;
+    developer: DeveloperMessage;
+    user: UserMessage;
+    assistant: AssistantMessage;
+    tool: ToolResultMessage;
 }
-/** A tool-result specialization whose model-facing block retains call correlation. */
-export interface ToolResultMessage extends Message {
-    readonly role: 'user';
-    readonly content: [ToolResultBlock];
-    readonly source: ToolMessageSource;
-}
-type NewMessage = Omit<Message, 'id'>;
+/** Any persisted conversation message, discriminated by its `role`. */
+export type Message = MessageRoleMap[keyof MessageRoleMap];
+type NewMessage = {
+    [Role in keyof MessageRoleMap]: Omit<MessageRoleMap[Role], 'id'>;
+}[keyof MessageRoleMap];
+type NewDeveloperMessage = Omit<DeveloperMessage, 'id' | 'role'>;
 type NewUserMessage = Omit<UserMessage, 'id' | 'role'>;
 type NewAssistantMessage = Omit<AssistantMessage, 'id' | 'role' | 'source'> & {
     readonly source: Omit<ModelMessageSource, 'kind'> & {
@@ -172,6 +196,15 @@ export declare function freezeMessage<T extends Message>(message: T): T;
 export declare function createMessage<T extends NewMessage>(input: T & {
     readonly id?: never;
 }): T & Pick<Message, 'id'>;
+/**
+ * Create an identified, immutable developer message.
+ * @param input - content and producer source for the new message.
+ * @returns a detached developer message with a fresh identity.
+ */
+export declare function createDeveloperMessage<T extends NewDeveloperMessage>(input: T & {
+    readonly id?: never;
+    readonly role?: never;
+}): T & Pick<DeveloperMessage, 'id' | 'role'>;
 /**
  * Create one identified user-role message and freeze it before publication.
  * @param input - complete content and source for a new user message.
@@ -194,20 +227,19 @@ export declare function createAssistantMessage(input: NewAssistantMessage & {
  * Create and freeze one identified system-role message holding a rendered
  * system prompt.
  * @param text - the complete rendered prompt; `''` records "no system prompt".
- * @param plugin - the plugin that assembled the prompt.
  * @returns an immutable system message with a fresh stable identity.
  */
-export declare function createSystemMessage(text: string, plugin: string): SystemMessage;
+export declare function createSystemMessage(text: string): SystemMessage;
 /** Input whose acceptance creates one tool-result message. */
 export interface ToolResultMessageInput {
     readonly callId: ToolCallId;
-    readonly content: ContentBlock[];
+    readonly content: readonly ContentBlock[];
     readonly isError: boolean;
 }
 /**
  * Create and freeze one identified tool-result message.
  * @param input - call identity, raw result blocks, and outcome.
- * @returns an immutable user-role tool-result message.
+ * @returns an immutable tool-role message that answers the tool call.
  */
 export declare function createToolResultMessage(input: ToolResultMessageInput): ToolResultMessage;
 export {};

package/lib/types/message.js

@@ -3,9 +3,9 @@ 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
- * objectives, tool arguments — are caller text with no length of their own.
+ * Bound for a `notice` summary. Producers commit the one-line account to the
+ * durable log; its inputs — task labels, goal objectives, tool arguments —
+ * are caller text with no length of their own.
  */
 export const CONTEXT_SUMMARY_MAX_CHARS = 120;
 /**
@@ -32,10 +32,18 @@ export function freezeMessage(message) {
  * @returns an immutable message with a fresh stable identity.
  */
 export function createMessage(input) {
-    return freezeMessage({
+    return deepFreeze(structuredClone({
         ...input,
         id: brandString(randomUUID()),
-    });
+    }));
+}
+/**
+ * Create an identified, immutable developer message.
+ * @param input - content and producer source for the new message.
+ * @returns a detached developer message with a fresh identity.
+ */
+export function createDeveloperMessage(input) {
+    return createMessage({ ...input, role: 'developer' });
 }
 /**
  * Create one identified user-role message and freeze it before publication.
@@ -67,30 +75,27 @@ export function createAssistantMessage(input) {
  * Create and freeze one identified system-role message holding a rendered
  * system prompt.
  * @param text - the complete rendered prompt; `''` records "no system prompt".
- * @param plugin - the plugin that assembled the prompt.
  * @returns an immutable system message with a fresh stable identity.
  */
-export function createSystemMessage(text, plugin) {
+export function createSystemMessage(text) {
     return createMessage({
         role: 'system',
         content: text.length === 0 ? [] : [{ type: 'text', text }],
-        source: { kind: 'plugin', plugin },
+        source: { kind: 'system-prompt' },
     });
 }
 /**
  * Create and freeze one identified tool-result message.
  * @param input - call identity, raw result blocks, and outcome.
- * @returns an immutable user-role tool-result message.
+ * @returns an immutable tool-role message that answers the tool call.
  */
 export function createToolResultMessage(input) {
-    return createUserMessage({
+    return createMessage({
+        role: 'tool',
         source: { kind: 'tool', callId: input.callId },
-        content: [{
-                type: 'tool-result',
-                toolCallId: input.callId,
-                content: input.content,
-                isError: input.isError,
-            }],
+        toolCallId: input.callId,
+        content: input.content,
+        isError: input.isError,
     });
 }
 //# sourceMappingURL=message.js.map

package/lib/types/types.d.ts

@@ -6,7 +6,7 @@
 import type { Branded } from '@deepseek-ai/dsh-brand';
 import type { FileAttachmentRef, ImageAttachmentRef } from '@deepseek-ai/dsh-attachment';
 import type { ToolCallId, ProviderRequestId, ReasoningEffortId } from './brand.ts';
-import type { Message } from './message.ts';
+import type { Message, UserMessage } from './message.ts';
 declare module '@deepseek-ai/cordis' {
     interface Events {
         /**
@@ -21,7 +21,7 @@ declare module '@deepseek-ai/cordis' {
         'llm/adapters-updated'(): void;
     }
 }
-export type { AssistantMessage, AssistantProviderMetadata, Message, MessageSource, MessageSourceMap, ModelMessageSource, ToolMessageSource, ToolResultMessage, UserMessage, } from './message.ts';
+export type { AssistantMessage, DeveloperMessage, AssistantProviderMetadata, 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 {
     /** Human-readable provider or transport failure. */
@@ -90,16 +90,27 @@ export interface ToolCallBlock {
     /** Raw JSON string as produced by the model. */
     arguments: string;
 }
-/** The result of a tool invocation, sent back to the model. */
-export interface ToolResultBlock {
-    type: 'tool-result';
-    toolCallId: ToolCallId;
-    content: ContentBlock[];
-    isError?: boolean;
+/** Activates a tool definition from the developer event's referenced request header. */
+export interface ToolAdditionBlock {
+    type: 'tool-addition';
+    /** Name of exactly one tool in the referenced historical header. */
+    toolName: string;
+    /**
+     * Reserved against inline definitions; the historical request header owns the schema.
+     * @persistenceReserved
+     */
+    tool?: never;
+}
+/** Records the dynamic removal of a tool identified by its session-local name. */
+export interface ToolRemovalBlock {
+    type: 'tool-removal';
+    toolName: string;
 }
 /**
  * Merge-extensible content blocks keyed by `type`. New core blocks must land
- * with adapter, UI, and compaction support.
+ * with adapter, UI, and compaction support. Developer tool-change blocks are
+ * reserved for Session V4 persistence; providers and UI reject them until
+ * their producers and consumers are implemented together.
  */
 export interface ContentBlockMap {
     'text': TextBlock;
@@ -107,7 +118,8 @@ export interface ContentBlockMap {
     'image': ImageBlock;
     'file': FileBlock;
     'tool-call': ToolCallBlock;
-    'tool-result': ToolResultBlock;
+    'tool-addition': ToolAdditionBlock;
+    'tool-removal': ToolRemovalBlock;
 }
 /** The block `type` tag vocabulary; widens as plugins add entries to {@link ContentBlockMap}. */
 export type ContentBlockType = keyof ContentBlockMap;
@@ -430,11 +442,26 @@ export type StreamChunk = {
  * it from this package.
  */
 export interface ToolSchema {
+    /**
+     * Requests deferred loading of the tool definition into model context,
+     * independently of whether a tool-addition block records the tool.
+     * Uses Anthropic's defer_loading terminology.
+     */
+    deferLoading?: true;
     name: string;
     description: string;
     /** JSON Schema object for the arguments. */
     parameters: Record<string, unknown>;
 }
+/** User input for one LLM request; it has no durable Session identity or source. */
+export interface RequestUserInput {
+    readonly role: 'user';
+    readonly content: UserMessage['content'];
+    readonly id?: never;
+    readonly source?: never;
+}
+/** A durable conversation message or a user input used only for one request. */
+export type RequestMessage = Message | RequestUserInput;
 /** A single model request, fully assembled. */
 export interface GenerateOptions {
     /** Registered provider route selecting the adapter instance. */
@@ -446,9 +473,9 @@ export interface GenerateOptions {
      * Ordered conversation messages, exactly as the provider sees them. A
      * loop-built request passes the derived history (dsh-agent-loop), whose
      * leading system-role message carries the system prompt; a hand-built
-     * one-shot passes any list.
+     * one-shot may include identity-free user inputs.
      */
-    messages: Message[];
+    messages: RequestMessage[];
     /**
      * System prompt text for one-shot callers; adapters map it to the provider's
      * system slot ahead of `messages`. Loop-built requests leave it undefined.

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.6-alpha.2",
+  "version": "0.1.7-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -61,20 +61,20 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/cordis": "~4.0.4"
   },
   "dependencies": {
     "zod": "^4.4.3",
-    "@deepseek-ai/dsh-brand": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-util-values": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-util-crypto": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-timeout": "^0.1.6-alpha.2",
-    "@deepseek-ai/schemastery": "^3.18.2"
+    "@deepseek-ai/dsh-util-crypto": "0.1.7-alpha.2",
+    "@deepseek-ai/schemastery": "~3.18.4",
+    "@deepseek-ai/dsh-timeout": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-brand": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-util-values": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "0.1.7-alpha.2"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-attachment": "^0.1.6-alpha.2",
-    "@deepseek-ai/dsh-invariants": "^0.1.6-alpha.2",
-    "@deepseek-ai/cordis": "^4.0.2"
+    "@deepseek-ai/dsh-attachment": "0.1.7-alpha.2",
+    "@deepseek-ai/dsh-invariants": "0.1.7-alpha.2",
+    "@deepseek-ai/cordis": "~4.0.4"
   }
 }