deepseek-harness/docs/upgrade-guide/v0.2.2-alpha.2/llm-request-purpose-declarations/guide.md

kind, description

kind	description
upgrade-guide	Auxiliary LLM request purposes require producer-owned type declarations instead of a shared fixed union.

Declare auxiliary LLM request purposes

English | 中文

Change

GenerateOptions.purpose derives from the declaration-mergeable LlmRequestPurposeMap exported by @deepseek-ai/dsh-llm/types. The shared package no longer declares compaction or session-title. Plugins that construct auxiliary requests must load the producer's declarations or declare their own purpose. Existing runtime purpose strings keep their meaning.

Migration

1. Import @deepseek-ai/dsh-compaction-basic for direct compaction requests, or @deepseek-ai/dsh-session-title-llm for title requests, using a type-only import when only the declaration is needed.

2. For a plugin-owned purpose, augment LlmRequestPurposeMap from the plugin's public type entry. Map the purpose key to true:

   import type {} from '@deepseek-ai/dsh-llm/types'
   
   declare module '@deepseek-ai/dsh-llm/types' {
     interface LlmRequestPurposeMap {
       'my-plugin-purpose': true
     }
   }
   

3. Compile the plugin against the new package declarations. Confirm that its request accepts the declared purpose and rejects an undeclared key.