Merge remote-tracking branch 'origin/master' into xtr/identified-immutable-messages

# Conflicts:
#	docs/cordis-catalog/events.md
#	docs/core-data-structures/core.i18n.yaml
#	docs/event-producer-consumer.md
#	examples/acp-agent/tests/snapshots/cordis-inspect-jsdoc/session.jsonl
#	packages/core/agent-loop/README.i18n.yaml
#	packages/core/agent/README.i18n.yaml

packages/sdk/sdk-client/src/api.ts

@@ -25,6 +25,7 @@ export class DeepSeekHarness implements AsyncDisposable {
   private readonly cwd: string
   private readonly provider: string
   private readonly model: string
+  private readonly maxTokens: number | undefined
   private initialized: Promise<void> | undefined
   private closed = false
 
@@ -38,6 +39,7 @@ export class DeepSeekHarness implements AsyncDisposable {
     this.cwd = resolve(options.cwd ?? options.launch.cwd ?? process.cwd())
     this.provider = options.provider ?? 'deepseek'
     this.model = options.model ?? 'deepseek-v4-flash'
+    this.maxTokens = options.maxTokens
   }
 
   /**
@@ -61,7 +63,12 @@ export class DeepSeekHarness implements AsyncDisposable {
     this.initialized ??= (async () => {
       try {
         this.clientInstance.start()
-        await this.clientInstance.initialize({ cwd: this.cwd, provider: this.provider, model: this.model })
+        await this.clientInstance.initialize({
+          cwd: this.cwd,
+          provider: this.provider,
+          model: this.model,
+          ...this.maxTokens === undefined ? {} : { maxTokens: this.maxTokens },
+        })
       } catch (error) {
         this.initialized = undefined
         await this.clientInstance.close()

packages/sdk/sdk-client/src/types.ts

@@ -55,6 +55,8 @@ export interface DeepSeekHarnessOptions {
   provider?: string
   /** Model for SDK-created agents (default `deepseek-v4-flash`). */
   model?: string
+  /** Maximum output tokens for each conversation-model request. */
+  maxTokens?: number
 }
 
 /** The settled outcome of one {@link HarnessSession.run} turn. */