@deepseek-ai/dsh-api-session-controller 0.2.1-alpha.1 → 0.2.1-alpha.3

package/lib/typert.remote-client.js

@@ -1,49 +1,41 @@
 /* Generated by @deepseek-ai/dsh-typert-generator from the Host FaceModel — do not edit. */
 import { z } from 'zod'
 
-let JsonValueRemoteCodec$schema$value
-const JsonValueRemoteCodec$schema = () => (JsonValueRemoteCodec$schema$value ??= z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema()))]))
-let JsonValueRemoteCodec$schema2$value
-const JsonValueRemoteCodec$schema2 = () => (JsonValueRemoteCodec$schema2$value ??= z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema2())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema2()))]))
-let JsonValueRemoteCodec$schema3$value
-const JsonValueRemoteCodec$schema3 = () => (JsonValueRemoteCodec$schema3$value ??= z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema3())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema3()))]))
-let JsonValueRemoteCodec$schema4$value
-const JsonValueRemoteCodec$schema4 = () => (JsonValueRemoteCodec$schema4$value ??= z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema4())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema4()))]))
-let JsonValueRemoteCodec$schema5$value
-const JsonValueRemoteCodec$schema5 = () => (JsonValueRemoteCodec$schema5$value ??= z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema5())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema5()))]))
+import { createTypertRemoteInfo } from '@deepseek-ai/dsh-typert-protocol/remote-info'
+
 let _deepseek_ai_dsh_api_session_controller_fileReferences_list_parameter_0$schema$value
-const _deepseek_ai_dsh_api_session_controller_fileReferences_list_parameter_0$schema = () => (_deepseek_ai_dsh_api_session_controller_fileReferences_list_parameter_0$schema$value ??= z.intersection(z.string(), z.unknown()))
+const _deepseek_ai_dsh_api_session_controller_fileReferences_list_parameter_0$schema = () => (_deepseek_ai_dsh_api_session_controller_fileReferences_list_parameter_0$schema$value ??= z.string())
 let _deepseek_ai_dsh_api_session_controller_fileReferences_list_parameter_1$schema$value
 const _deepseek_ai_dsh_api_session_controller_fileReferences_list_parameter_1$schema = () => (_deepseek_ai_dsh_api_session_controller_fileReferences_list_parameter_1$schema$value ??= z.string())
 let _deepseek_ai_dsh_api_session_controller_fileReferences_list_result$schema$value
 const _deepseek_ai_dsh_api_session_controller_fileReferences_list_result$schema = () => (_deepseek_ai_dsh_api_session_controller_fileReferences_list_result$schema$value ??= z.array(z.object({
-  'path': z.string(),
-  'kind': z.union([z.literal("file"), z.literal("directory")]),
+  'path': z.string().describe('User-facing path accepted by normal prompts and filesystem tools.'),
+  'kind': z.union([z.literal("file"), z.literal("directory")]).describe('Directories keep completion open; files finish the mention.'),
 })))
 let _deepseek_ai_dsh_api_session_controller_session_attachment_parameter_0$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_attachment_parameter_0$schema = () => (_deepseek_ai_dsh_api_session_controller_session_attachment_parameter_0$schema$value ??= z.object({
-  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
-  'attachmentId': z.intersection(z.string(), z.unknown()).readonly(),
+  'sessionId': z.string().readonly(),
+  'attachmentId': z.string().readonly(),
 }))
 let _deepseek_ai_dsh_api_session_controller_session_attachment_result$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_attachment_result$schema = () => (_deepseek_ai_dsh_api_session_controller_session_attachment_result$schema$value ??= z.object({
   'attachment': z.object({
-  'attachmentId': z.intersection(z.string(), z.unknown()),
-  'mediaType': z.union([z.literal("image/png"), z.literal("image/jpeg"), z.literal("image/webp"), z.literal("image/gif")]),
-  'bytes': z.number(),
-  'width': z.number(),
-  'height': z.number(),
-  'name': z.string().optional(),
+  'attachmentId': z.string().describe('Opaque storage identifier; never a filesystem path or bearer URL.'),
+  'mediaType': z.union([z.literal("image/png"), z.literal("image/jpeg"), z.literal("image/webp"), z.literal("image/gif")]).describe('Media type verified from the stored bytes.'),
+  'bytes': z.number().describe('Exact encoded byte length.'),
+  'width': z.number().describe('Intrinsic encoded width in pixels.'),
+  'height': z.number().describe('Intrinsic encoded height in pixels.'),
+  'name': z.string().optional().describe('Optional display name stripped of local path information.'),
   'originalDimensions': z.object({
   'width': z.number(),
   'height': z.number(),
-}).optional(),
+}).optional().describe('Input dimensions after applying EXIF orientation and before normalization scaling. Present only when normalization reduced the image.'),
 }).readonly(),
   'data': z.string().readonly(),
 }))
 let _deepseek_ai_dsh_api_session_controller_session_cancel_parameter_0$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_cancel_parameter_0$schema = () => (_deepseek_ai_dsh_api_session_controller_session_cancel_parameter_0$schema$value ??= z.object({
-  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
+  'sessionId': z.string().readonly(),
 }))
 let _deepseek_ai_dsh_api_session_controller_session_cancel_result$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_cancel_result$schema = () => (_deepseek_ai_dsh_api_session_controller_session_cancel_result$schema$value ??= z.object({
@@ -55,184 +47,212 @@ let _deepseek_ai_dsh_api_session_controller_session_control_result$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_control_result$schema = () => (_deepseek_ai_dsh_api_session_controller_session_control_result$schema$value ??= z.union([z.object({
   'type': z.literal("baseline").readonly(),
   'value': z.object({
-  'projections': z.record(z.intersection(z.string(), z.unknown()), z.object({
+  'projections': z.record(z.string(), z.object({
   'asOfSeq': z.number().readonly(),
   'values': z.intersection(z.object({
   'inbox': z.object({
-  'next-turn': z.array(z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema5())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema5()))])).readonly(),
-  'next-step': z.array(z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema5())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema5()))])).readonly(),
-}).optional(),
-  'agentPreset': z.union([z.literal(null), z.string()]).optional(),
-  'title': z.union([z.literal(null), z.string()]).optional(),
+  'next-turn': z.array(z.json()).readonly(),
+  'next-step': z.array(z.json()).readonly(),
+}).optional().describe('Pending agent input reconstructed from durable inbox splices.'),
+  'workingDirectory': z.union([z.literal(null), z.string()]).optional().describe('Recorded current directory for Session observations, or null when none is recorded.'),
+  'agentPreset': z.union([z.literal(null), z.string()]).optional().describe('Preset the Session runs, or null when the deployment composes none.'),
+  'title': z.union([z.literal(null), z.string()]).optional().describe('The session\'s current normalized title — the latest `session/title` event\'s text (last-wins), or `null` before the first title lands. A plain string: the shape the client list rows consume.'),
   'todos': z.union([z.literal(null), z.array(z.object({
-  'content': z.string(),
-  'status': z.union([z.literal("completed"), z.literal("pending"), z.literal("in_progress")]),
-}))]).optional(),
+  'content': z.string().describe('What this task is — a short imperative line shown in the UI.'),
+  'status': z.union([z.literal("completed"), z.literal("pending"), z.literal("in_progress")]).describe('Lifecycle state. `in_progress` marks a task being worked now; parallel work may mark several.'),
+}))]).optional().describe('The agent\'s current whole todo list (the latest `todo/write` snapshot), or `null` before the first write. Whole-value rule: every `todo/write` carries the complete replacement list, so the fold is last-wins.'),
   'sessionListMetadata': z.object({
-  'blank': z.boolean().readonly(),
-  'lastPromptAt': z.union([z.literal(null), z.number()]).readonly(),
-}).optional(),
+  'blank': z.boolean().readonly().describe('Whether the folded prefix contains no turn.'),
+  'lastPromptAt': z.union([z.literal(null), z.number()]).readonly().describe('Latest human-authored prompt time in the folded prefix.'),
+}).optional().describe('Persisted facts used to summarize a Session without activating it.'),
   'imageLimits': z.object({
   'maxImageBytes': z.number(),
   'maxImagesPerMessage': z.number(),
   'maxMessageImageBytes': z.number(),
   'maxImagePixels': z.number(),
-  'maxImageDimension': z.number(),
+  'maxImageDimension': z.number().describe('Maximum intrinsic width and maximum intrinsic height in pixels for one image.'),
   'mediaTypes': z.array(z.union([z.literal("image/png"), z.literal("image/jpeg"), z.literal("image/webp"), z.literal("image/gif")])),
-}).optional(),
+}).optional().describe('Image-intake limits enforced by the Session prompt endpoint.'),
   'modelSelection': z.object({
   'lastUsed': z.union([z.literal(null), z.object({
   'provider': z.string().readonly(),
   'model': z.string().readonly(),
   'reasoningEffort': z.string().readonly().optional(),
-})]).readonly(),
+})]).readonly().describe('Selection consumed by the latest recorded model request.'),
   'next': z.union([z.literal(null), z.object({
   'provider': z.string().readonly(),
   'model': z.string().readonly(),
   'reasoningEffort': z.string().readonly().optional(),
-})]).readonly(),
-}).optional(),
+})]).readonly().describe('Selection the next request should use, falling back to {@link lastUsed}.'),
+}).optional().describe('Durable model selection already used and selected for the next request.'),
   'permissions': z.object({
-  'currentValue': z.string(),
-}).optional(),
-  'subagentCatalog': z.array(z.union([z.intersection(z.object({
-  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'currentValue': z.string().describe('The effective current value: a configured preset key, `auto`, or `custom`.'),
+}).optional().describe('The session\'s current permission, folded from the three whole-value knob events (`permission/preset`, `sandbox/mode`, `approval/policy`) over the composition defaults. Selectable options come from the process-level catalog Remote. Key absence means no permission service is composed — clients hide the control.'),
+  'subagentCatalog': z.array(z.union([z.object({
+  'id': z.string().readonly(),
   'createdAt': z.number().readonly(),
-}), z.object({
   'mode': z.literal("one-shot").readonly(),
   'label': z.string().readonly().optional(),
-})), z.intersection(z.object({
-  'id': z.intersection(z.string(), z.unknown()).readonly(),
+}), z.object({
+  'id': z.string().readonly(),
   'createdAt': z.number().readonly(),
+  'mode': z.literal("external").readonly(),
+  'label': z.string().readonly().optional(),
 }), z.object({
+  'id': z.string().readonly(),
+  'createdAt': z.number().readonly(),
   'mode': z.literal("continuable").readonly(),
   'label': z.string().readonly(),
-})), z.intersection(z.object({
-  'id': z.intersection(z.string(), z.unknown()).readonly(),
-  'createdAt': z.number().readonly(),
 }), z.object({
+  'id': z.string().readonly(),
+  'createdAt': z.number().readonly(),
   'mode': z.literal("unknown").readonly(),
   'label': z.string().readonly().optional(),
-}))])).optional(),
+})])).optional().describe('Direct children in parent catalog event order, excluding fork-inherited facts.'),
   'subagentTiming': z.object({
-  'settledMs': z.number(),
+  'settledMs': z.number().describe('Milliseconds accumulated across completed turns after the child\'s own descriptor.'),
   'active': z.object({
-  'since': z.number(),
-  'through': z.number(),
-}).optional(),
-  'lastTurnCompleted': z.boolean().optional(),
-}).optional(),
+  'since': z.number().describe('Start of the open turn.'),
+  'through': z.number().describe('Latest event time folded into this projection cut.'),
+}).optional().describe('Same-cut bounds of the currently open turn, when one has not reached `turn/end`.'),
+  'lastTurnCompleted': z.boolean().optional().describe('Whether the latest closed turn after the child\'s own descriptor completed normally; absent while a turn is open or before one closes.'),
+}).optional().describe('Active-turn duration and latest closed-turn completion for a descriptor-backed subagent session.'),
   'subagent': z.union([z.literal(null), z.object({
-  'mode': z.literal("one-shot"),
-  'label': z.string().optional(),
-  'seq': z.intersection(z.number(), z.unknown()),
+  'mode': z.literal("one-shot").describe('A terminal one-shot child.'),
+  'label': z.string().optional().describe('Optional durable creation label from the child\'s descriptor.'),
+  'seq': z.number().describe('Seq of the `subagent/descriptor` event this identity was folded from. `session.isOwnSeq(seq)` proves the identity comes from the child\'s OWN log suffix — where a descriptor is immutable once appended — and not from a fork seed\'s replayed ancestor descriptor.'),
 }), z.object({
-  'mode': z.literal("continuable"),
-  'label': z.string(),
-  'seq': z.intersection(z.number(), z.unknown()),
-})]).optional(),
+  'mode': z.literal("continuable").describe('A resumable conversation.'),
+  'label': z.string().describe('Durable creation label from the child\'s descriptor.'),
+  'seq': z.number().describe('Seq of the folded descriptor event; see the one-shot arm for the own-suffix proof.'),
+})]).optional().describe('Identity of a descriptor-backed subagent session. `null` ⟺ no valid descriptor (missing, malformed, or unrecognized-version — deliberately undistinguished). The sentinel is deliberately serializable: a value pushed over JSON transports must survive `JSON.stringify` losslessly, where an `undefined` field would be dropped and a stale identity would survive on the receiving side. The entry itself stays non-optional.'),
   'tokenUsage': z.object({
   'uncachedInputTokens': z.number(),
   'outputTokens': z.number(),
   'cacheReadTokens': z.number(),
   'cacheWriteTokens': z.number(),
-}).optional(),
+}).optional().describe('Provider-reported usage accumulated across the complete durable log.'),
   'contextPressure': z.object({
-  'pressureTokens': z.number().optional(),
-  'projectedTokens': z.number().optional(),
-  'contextWindow': z.number().optional(),
-}).optional(),
+  'pressureTokens': z.number().optional().describe('Provider-reported prompt size of the most recent request: uncached input plus cache reads and writes. Response output is excluded, so this does not grow as the current turn streams. Absent until a provider reports usage.'),
+  'projectedTokens': z.number().optional().describe('What the NEXT request\'s prompt would cost: {@link pressureTokens} plus the heuristic repricing of everything the surface gained or lost since that sample. Only the delta is estimated, so the figure stays anchored to the provider while still reacting the moment a compaction shadows a span — which `pressureTokens` alone cannot do, since compaction reports no usage of its own. Absent until a provider reports usage.'),
+  'contextWindow': z.number().optional().describe('Newest recorded route capacity; absent when no adapter advertised one.'),
+}).optional().describe('Newest request pressure paired with the newest known route capacity.'),
   'contextBreakdown': z.object({
-  'systemTokens': z.number(),
-  'toolsTokens': z.number(),
-  'messageTokens': z.number(),
-}).optional(),
+  'systemTokens': z.number().describe('Heuristic tokens of the last nonempty surviving system prompt in surface order; 0 when none exists.'),
+  'toolsTokens': z.number().describe('Heuristic tokens of the newest request envelope\'s tool schemas; 0 before any request.'),
+  'messageTokens': z.number().describe('Heuristic tokens of every other visible surface node, including superseded system prompts.'),
+}).optional().describe('Heuristic system/tools/message composition of the next request.'),
+  'agentTeam': z.object({
+  'members': z.array(z.object({
+  'id': z.string().readonly(),
+  'name': z.string().readonly(),
+  'role': z.union([z.literal("lead"), z.literal("teammate")]).readonly(),
+  'phase': z.union([z.literal("failed"), z.literal("provisioning"), z.literal("active")]).readonly().describe('Durable lifecycle; the Lead row is always `active`. Turn activity comes from Session status.'),
+  'error': z.string().readonly().optional(),
+})).readonly(),
+  'tasks': z.array(z.object({
+  'id': z.string().readonly(),
+  'revision': z.number().readonly(),
+  'subject': z.string().readonly(),
+  'description': z.string().readonly(),
+  'status': z.union([z.literal("completed"), z.literal("pending"), z.literal("in_progress"), z.literal("deleted")]).readonly(),
+  'blockedBy': z.array(z.string()).readonly(),
+  'writeScopes': z.array(z.string()).readonly(),
+  'ownerName': z.string().readonly().optional(),
+  'ready': z.boolean().readonly(),
+  'writeScopeWarnings': z.array(z.string()).readonly(),
+})).readonly(),
+  'failure': z.string().readonly().optional(),
+}).optional().describe('Durable roster and non-deleted task board of the Team rooted at the projected Session.'),
   'userQuestions': z.object({
   'active': z.array(z.object({
-  'callId': z.intersection(z.string(), z.unknown()).readonly(),
+  'callId': z.string().readonly(),
   'questions': z.array(z.object({
-  'id': z.string(),
-  'question': z.string(),
-  'detail': z.string().optional(),
-  'header': z.string().optional(),
+  'id': z.string().describe('Stable caller-provided question id, echoed in the answer.'),
+  'question': z.string().describe('The question to display.'),
+  'detail': z.string().optional().describe('Optional supporting detail rendered with the question but kept out of option labels.'),
+  'header': z.string().optional().describe('Optional short heading/group label.'),
   'options': z.array(z.object({
-  'label': z.string(),
-  'description': z.string().optional(),
-})).optional(),
-  'multiSelect': z.boolean().optional(),
+  'label': z.string().describe('User-facing label.'),
+  'description': z.string().optional().describe('Optional extra context rendered by capable UIs.'),
+})).optional().describe('Optional choices the UI can render as a menu.'),
+  'multiSelect': z.boolean().optional().describe('Whether more than one option may be selected. Defaults to single-select.'),
   'intent': z.object({
-  'kind': z.literal("plan-review"),
-  'approve': z.string(),
-  'callId': z.intersection(z.string(), z.unknown()).optional(),
-}).optional(),
+  'kind': z.literal("plan-review").describe('A plan submitted for review: `detail` is the plan markdown `ask()` requires, and the decision approves or declines it.'),
+  'approve': z.string().describe('The option label that approves the plan; every other option declines it. Named rather than positional so no UI infers the verdict from option order. An `approve` naming no option of its own question is rejected at `ask()`.'),
+  'callId': z.string().optional().describe('Logged tool invocation whose arguments contain the reviewed plan.'),
+}).optional().describe('Optional presentation intent for capable UIs; absent asks for the generic option list.'),
 })).readonly(),
   'state': z.union([z.literal("open"), z.literal("continued")]).readonly(),
-})).readonly(),
+})).readonly().describe('Calls that can still take an answer, in ask order.'),
   'settled': z.array(z.object({
-  'callId': z.intersection(z.string(), z.unknown()).readonly(),
+  'callId': z.string().readonly().describe('The settled call.'),
   'answers': z.array(z.object({
-  'id': z.string(),
-  'selected': z.array(z.string()),
-  'custom': z.string().optional(),
-})).readonly(),
-})).readonly(),
-}).optional(),
+  'id': z.string().describe('The answered question id.'),
+  'selected': z.array(z.string()).describe('Selected option labels. May accompany custom text for a multi-select question.'),
+  'custom': z.string().optional().describe('Optional free-text "Other" answer.'),
+})).readonly().describe('The recorded batch, one entry per question; empty when the late reply carried none.'),
+})).readonly().describe('Calls an answer settled, in settlement order.'),
+}).optional().describe('Timed questions that remain answerable in this Session, and the ones a late reply settled.'),
   'goal': z.union([z.literal(null), z.object({
   'goal': z.object({
-  'objective': z.string().readonly(),
-  'phase': z.union([z.literal("active"), z.literal("paused"), z.literal("blocked"), z.literal("complete")]).readonly(),
+  'objective': z.string().readonly().describe('Human-requested completion objective.'),
+  'phase': z.union([z.literal("active"), z.literal("paused"), z.literal("blocked"), z.literal("complete")]).readonly().describe('Durable lifecycle phase.'),
   'blockedReason': z.object({
-  'code': z.string().readonly(),
-  'message': z.string().readonly(),
-}).readonly().optional(),
-  'maxGoalRounds': z.number().readonly(),
-  'id': z.intersection(z.string(), z.unknown()).readonly(),
-  'revision': z.number().readonly(),
-}).readonly(),
-  'roundsStarted': z.number().readonly(),
-  'createdAt': z.number().readonly(),
-  'updatedAt': z.number().readonly(),
-})]).optional(),
-}), z.record(z.string(), z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema5())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema5()))])).readonly()).readonly(),
+  'code': z.string().readonly().describe('Stable lower-kebab-case classification chosen by the blocking policy.'),
+  'message': z.string().readonly().describe('Non-empty explanation shown to humans and models.'),
+}).readonly().optional().describe('Present exactly while `phase` is `blocked`.'),
+  'maxGoalRounds': z.number().readonly().describe('Total admitted goal-round cap.'),
+  'id': z.string().readonly().describe('Stable goal identity.'),
+  'revision': z.number().readonly().describe('Positive revision; every durable mutation increments it.'),
+}).readonly().describe('Current durable goal snapshot (the CAS ref for mutations rides on it).'),
+  'roundsStarted': z.number().readonly().describe('Highest admitted round number for this goal.'),
+  'createdAt': z.number().readonly().describe('Epoch milliseconds of the create mutation.'),
+  'updatedAt': z.number().readonly().describe('Epoch milliseconds of the latest mutation.'),
+})]).optional().describe('The session\'s current goal and admitted-round count, or `null` before the first create and after a clear tombstone. `goal/change` supplies the whole lifecycle value; matching admitted `user/message` events advance `roundsStarted`.'),
+  'plan': z.object({
+  'active': z.boolean(),
+  'pending': z.boolean(),
+}).optional().describe('Plan collaboration state folded from the plan command lifecycle and `plan/mode` events.'),
+}), z.record(z.string(), z.json()).readonly()).readonly().describe('Provider-validated values; omitted keys are absent capabilities at this cut.'),
 })).readonly().readonly(),
 }).readonly(),
-}), z.intersection(z.object({
-  'type': z.literal("projection").readonly(),
 }), z.object({
-  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
+  'type': z.literal("projection").readonly(),
+  'sessionId': z.string().readonly(),
   'key': z.string().readonly(),
-  'value': z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema5())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema5()))]).readonly(),
+  'value': z.json().readonly(),
   'seq': z.number().readonly(),
-}))]))
+})]))
 let _deepseek_ai_dsh_api_session_controller_session_create_parameter_0$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_create_parameter_0$schema = () => (_deepseek_ai_dsh_api_session_controller_session_create_parameter_0$schema$value ??= z.object({
-  'workspaceId': z.intersection(z.string(), z.unknown()).readonly().optional(),
-  'cwd': z.string().readonly().optional(),
-  'sessionId': z.intersection(z.string(), z.unknown()).readonly().optional(),
-  'agentPreset': z.string().readonly().optional(),
+  'workspaceId': z.string().readonly().optional().describe('Workspace the Session joins; exclusive with `cwd`.'),
+  'cwd': z.string().readonly().optional().describe('Directory the Session owns when no Workspace is named.'),
+  'sessionId': z.string().readonly().optional().describe('Blank Session to reuse while it is reusable, or the identity of a new Session when none is stored under it.'),
+  'agentPreset': z.string().readonly().optional().describe('Preset the Session runs, replacing a reused Session\'s recorded preset; the configured default when omitted.'),
 }))
 let _deepseek_ai_dsh_api_session_controller_session_create_result$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_create_result$schema = () => (_deepseek_ai_dsh_api_session_controller_session_create_result$schema$value ??= z.object({
-  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
-  'agentPreset': z.string().readonly().optional(),
+  'sessionId': z.string().readonly().describe('The created or reused Session, which may differ from the requested `sessionId`.'),
+  'agentPreset': z.string().readonly().optional().describe('Preset the Session runs, when the deployment composes a preset roster.'),
 }))
 let _deepseek_ai_dsh_api_session_controller_session_follow_parameter_0$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_follow_parameter_0$schema = () => (_deepseek_ai_dsh_api_session_controller_session_follow_parameter_0$schema$value ??= z.object({
   'address': z.union([z.object({
   'kind': z.literal("session").readonly(),
-  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
+  'sessionId': z.string().readonly(),
 }), z.object({
   'kind': z.literal("subagent").readonly(),
-  'parentSessionId': z.intersection(z.string(), z.unknown()).readonly(),
-  'childSessionId': z.intersection(z.string(), z.unknown()).readonly(),
+  'parentSessionId': z.string().readonly(),
+  'childSessionId': z.string().readonly(),
   'mode': z.union([z.literal("one-shot"), z.literal("continuable"), z.literal("unknown")]).readonly(),
 })]).readonly(),
-  'assistantStream': z.literal(true).readonly().optional(),
+  'assistantStream': z.literal(true).readonly().optional().describe('Include process-local assistant presentation frames for the Web client.'),
   'maxMessages': z.number().readonly().optional(),
   'turnWindow': z.object({
-  'minMessages': z.number().readonly(),
-  'minTurns': z.number().readonly(),
-}).readonly().optional(),
+  'minMessages': z.number().readonly().describe('Minimum append-origin user/assistant messages; must not exceed maxMessages.'),
+  'minTurns': z.number().readonly().describe('Minimum Turn starts crossed, including the partial Turn at beforeSeq.'),
+}).readonly().optional().describe('Stop at a Turn start after both minima, unless maxMessages or history exhaustion wins.'),
 }))
 let _deepseek_ai_dsh_api_session_controller_session_follow_result$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_follow_result$schema = () => (_deepseek_ai_dsh_api_session_controller_session_follow_result$schema$value ??= z.union([z.object({
@@ -241,20 +261,20 @@ const _deepseek_ai_dsh_api_session_controller_session_follow_result$schema = ()
   'type': z.string().readonly(),
   'seq': z.number().readonly(),
   'time': z.number().readonly(),
-  'data': z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema3())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema3()))]).readonly(),
+  'data': z.json().readonly(),
   'ignorable': z.literal(true).readonly().optional(),
-  'sourceEventSeqs': z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema3())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema3()))]).readonly().optional(),
-  'surfaceOp': z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema3())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema3()))]).readonly().optional(),
+  'sourceEventSeqs': z.json().readonly().optional().describe('Earlier sources on current surface events; opaque JSON on unknown ignorable events.'),
+  'surfaceOp': z.json().readonly().optional().describe('Canonical placement on current surface events; opaque JSON on unknown ignorable events.'),
 }).readonly(),
 }), z.object({
   'type': z.literal("snapshot").readonly(),
   'header': z.object({
   'version': z.number().readonly(),
-  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'id': z.string().readonly(),
   'createdAt': z.number().readonly(),
   'cwd': z.string().readonly().optional(),
-  'parentSession': z.intersection(z.string(), z.unknown()).readonly().optional(),
-  'isSeeded': z.boolean().readonly(),
+  'parentSession': z.string().readonly().optional(),
+  'isSeeded': z.boolean().readonly().describe('Whether the Session contains a fork-inherited prefix.'),
   'origin': z.literal("subagent").readonly().optional(),
   'delegationDepth': z.number().readonly().optional(),
   'agentPreset': z.string().readonly().optional(),
@@ -266,10 +286,10 @@ const _deepseek_ai_dsh_api_session_controller_session_follow_result$schema = ()
   'type': z.string().readonly(),
   'seq': z.number().readonly(),
   'time': z.number().readonly(),
-  'data': z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema3())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema3()))]).readonly(),
+  'data': z.json().readonly(),
   'ignorable': z.literal(true).readonly().optional(),
-  'sourceEventSeqs': z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema3())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema3()))]).readonly().optional(),
-  'surfaceOp': z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema3())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema3()))]).readonly().optional(),
+  'sourceEventSeqs': z.json().readonly().optional().describe('Earlier sources on current surface events; opaque JSON on unknown ignorable events.'),
+  'surfaceOp': z.json().readonly().optional().describe('Canonical placement on current surface events; opaque JSON on unknown ignorable events.'),
 }).readonly(),
 })).readonly(),
   'hasMore': z.boolean().readonly(),
@@ -277,174 +297,203 @@ const _deepseek_ai_dsh_api_session_controller_session_follow_result$schema = ()
   'asOfSeq': z.number().readonly(),
   'values': z.intersection(z.object({
   'inbox': z.object({
-  'next-turn': z.array(z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema3())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema3()))])).readonly(),
-  'next-step': z.array(z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema3())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema3()))])).readonly(),
-}).optional(),
-  'agentPreset': z.union([z.literal(null), z.string()]).optional(),
-  'title': z.union([z.literal(null), z.string()]).optional(),
+  'next-turn': z.array(z.json()).readonly(),
+  'next-step': z.array(z.json()).readonly(),
+}).optional().describe('Pending agent input reconstructed from durable inbox splices.'),
+  'workingDirectory': z.union([z.literal(null), z.string()]).optional().describe('Recorded current directory for Session observations, or null when none is recorded.'),
+  'agentPreset': z.union([z.literal(null), z.string()]).optional().describe('Preset the Session runs, or null when the deployment composes none.'),
+  'title': z.union([z.literal(null), z.string()]).optional().describe('The session\'s current normalized title — the latest `session/title` event\'s text (last-wins), or `null` before the first title lands. A plain string: the shape the client list rows consume.'),
   'todos': z.union([z.literal(null), z.array(z.object({
-  'content': z.string(),
-  'status': z.union([z.literal("completed"), z.literal("pending"), z.literal("in_progress")]),
-}))]).optional(),
+  'content': z.string().describe('What this task is — a short imperative line shown in the UI.'),
+  'status': z.union([z.literal("completed"), z.literal("pending"), z.literal("in_progress")]).describe('Lifecycle state. `in_progress` marks a task being worked now; parallel work may mark several.'),
+}))]).optional().describe('The agent\'s current whole todo list (the latest `todo/write` snapshot), or `null` before the first write. Whole-value rule: every `todo/write` carries the complete replacement list, so the fold is last-wins.'),
   'sessionListMetadata': z.object({
-  'blank': z.boolean().readonly(),
-  'lastPromptAt': z.union([z.literal(null), z.number()]).readonly(),
-}).optional(),
+  'blank': z.boolean().readonly().describe('Whether the folded prefix contains no turn.'),
+  'lastPromptAt': z.union([z.literal(null), z.number()]).readonly().describe('Latest human-authored prompt time in the folded prefix.'),
+}).optional().describe('Persisted facts used to summarize a Session without activating it.'),
   'imageLimits': z.object({
   'maxImageBytes': z.number(),
   'maxImagesPerMessage': z.number(),
   'maxMessageImageBytes': z.number(),
   'maxImagePixels': z.number(),
-  'maxImageDimension': z.number(),
+  'maxImageDimension': z.number().describe('Maximum intrinsic width and maximum intrinsic height in pixels for one image.'),
   'mediaTypes': z.array(z.union([z.literal("image/png"), z.literal("image/jpeg"), z.literal("image/webp"), z.literal("image/gif")])),
-}).optional(),
+}).optional().describe('Image-intake limits enforced by the Session prompt endpoint.'),
   'modelSelection': z.object({
   'lastUsed': z.union([z.literal(null), z.object({
   'provider': z.string().readonly(),
   'model': z.string().readonly(),
   'reasoningEffort': z.string().readonly().optional(),
-})]).readonly(),
+})]).readonly().describe('Selection consumed by the latest recorded model request.'),
   'next': z.union([z.literal(null), z.object({
   'provider': z.string().readonly(),
   'model': z.string().readonly(),
   'reasoningEffort': z.string().readonly().optional(),
-})]).readonly(),
-}).optional(),
+})]).readonly().describe('Selection the next request should use, falling back to {@link lastUsed}.'),
+}).optional().describe('Durable model selection already used and selected for the next request.'),
   'permissions': z.object({
-  'currentValue': z.string(),
-}).optional(),
-  'subagentCatalog': z.array(z.union([z.intersection(z.object({
-  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'currentValue': z.string().describe('The effective current value: a configured preset key, `auto`, or `custom`.'),
+}).optional().describe('The session\'s current permission, folded from the three whole-value knob events (`permission/preset`, `sandbox/mode`, `approval/policy`) over the composition defaults. Selectable options come from the process-level catalog Remote. Key absence means no permission service is composed — clients hide the control.'),
+  'subagentCatalog': z.array(z.union([z.object({
+  'id': z.string().readonly(),
   'createdAt': z.number().readonly(),
-}), z.object({
   'mode': z.literal("one-shot").readonly(),
   'label': z.string().readonly().optional(),
-})), z.intersection(z.object({
-  'id': z.intersection(z.string(), z.unknown()).readonly(),
+}), z.object({
+  'id': z.string().readonly(),
   'createdAt': z.number().readonly(),
+  'mode': z.literal("external").readonly(),
+  'label': z.string().readonly().optional(),
 }), z.object({
+  'id': z.string().readonly(),
+  'createdAt': z.number().readonly(),
   'mode': z.literal("continuable").readonly(),
   'label': z.string().readonly(),
-})), z.intersection(z.object({
-  'id': z.intersection(z.string(), z.unknown()).readonly(),
-  'createdAt': z.number().readonly(),
 }), z.object({
+  'id': z.string().readonly(),
+  'createdAt': z.number().readonly(),
   'mode': z.literal("unknown").readonly(),
   'label': z.string().readonly().optional(),
-}))])).optional(),
+})])).optional().describe('Direct children in parent catalog event order, excluding fork-inherited facts.'),
   'subagentTiming': z.object({
-  'settledMs': z.number(),
+  'settledMs': z.number().describe('Milliseconds accumulated across completed turns after the child\'s own descriptor.'),
   'active': z.object({
-  'since': z.number(),
-  'through': z.number(),
-}).optional(),
-  'lastTurnCompleted': z.boolean().optional(),
-}).optional(),
+  'since': z.number().describe('Start of the open turn.'),
+  'through': z.number().describe('Latest event time folded into this projection cut.'),
+}).optional().describe('Same-cut bounds of the currently open turn, when one has not reached `turn/end`.'),
+  'lastTurnCompleted': z.boolean().optional().describe('Whether the latest closed turn after the child\'s own descriptor completed normally; absent while a turn is open or before one closes.'),
+}).optional().describe('Active-turn duration and latest closed-turn completion for a descriptor-backed subagent session.'),
   'subagent': z.union([z.literal(null), z.object({
-  'mode': z.literal("one-shot"),
-  'label': z.string().optional(),
-  'seq': z.intersection(z.number(), z.unknown()),
+  'mode': z.literal("one-shot").describe('A terminal one-shot child.'),
+  'label': z.string().optional().describe('Optional durable creation label from the child\'s descriptor.'),
+  'seq': z.number().describe('Seq of the `subagent/descriptor` event this identity was folded from. `session.isOwnSeq(seq)` proves the identity comes from the child\'s OWN log suffix — where a descriptor is immutable once appended — and not from a fork seed\'s replayed ancestor descriptor.'),
 }), z.object({
-  'mode': z.literal("continuable"),
-  'label': z.string(),
-  'seq': z.intersection(z.number(), z.unknown()),
-})]).optional(),
+  'mode': z.literal("continuable").describe('A resumable conversation.'),
+  'label': z.string().describe('Durable creation label from the child\'s descriptor.'),
+  'seq': z.number().describe('Seq of the folded descriptor event; see the one-shot arm for the own-suffix proof.'),
+})]).optional().describe('Identity of a descriptor-backed subagent session. `null` ⟺ no valid descriptor (missing, malformed, or unrecognized-version — deliberately undistinguished). The sentinel is deliberately serializable: a value pushed over JSON transports must survive `JSON.stringify` losslessly, where an `undefined` field would be dropped and a stale identity would survive on the receiving side. The entry itself stays non-optional.'),
   'tokenUsage': z.object({
   'uncachedInputTokens': z.number(),
   'outputTokens': z.number(),
   'cacheReadTokens': z.number(),
   'cacheWriteTokens': z.number(),
-}).optional(),
+}).optional().describe('Provider-reported usage accumulated across the complete durable log.'),
   'contextPressure': z.object({
-  'pressureTokens': z.number().optional(),
-  'projectedTokens': z.number().optional(),
-  'contextWindow': z.number().optional(),
-}).optional(),
+  'pressureTokens': z.number().optional().describe('Provider-reported prompt size of the most recent request: uncached input plus cache reads and writes. Response output is excluded, so this does not grow as the current turn streams. Absent until a provider reports usage.'),
+  'projectedTokens': z.number().optional().describe('What the NEXT request\'s prompt would cost: {@link pressureTokens} plus the heuristic repricing of everything the surface gained or lost since that sample. Only the delta is estimated, so the figure stays anchored to the provider while still reacting the moment a compaction shadows a span — which `pressureTokens` alone cannot do, since compaction reports no usage of its own. Absent until a provider reports usage.'),
+  'contextWindow': z.number().optional().describe('Newest recorded route capacity; absent when no adapter advertised one.'),
+}).optional().describe('Newest request pressure paired with the newest known route capacity.'),
   'contextBreakdown': z.object({
-  'systemTokens': z.number(),
-  'toolsTokens': z.number(),
-  'messageTokens': z.number(),
-}).optional(),
+  'systemTokens': z.number().describe('Heuristic tokens of the last nonempty surviving system prompt in surface order; 0 when none exists.'),
+  'toolsTokens': z.number().describe('Heuristic tokens of the newest request envelope\'s tool schemas; 0 before any request.'),
+  'messageTokens': z.number().describe('Heuristic tokens of every other visible surface node, including superseded system prompts.'),
+}).optional().describe('Heuristic system/tools/message composition of the next request.'),
+  'agentTeam': z.object({
+  'members': z.array(z.object({
+  'id': z.string().readonly(),
+  'name': z.string().readonly(),
+  'role': z.union([z.literal("lead"), z.literal("teammate")]).readonly(),
+  'phase': z.union([z.literal("failed"), z.literal("provisioning"), z.literal("active")]).readonly().describe('Durable lifecycle; the Lead row is always `active`. Turn activity comes from Session status.'),
+  'error': z.string().readonly().optional(),
+})).readonly(),
+  'tasks': z.array(z.object({
+  'id': z.string().readonly(),
+  'revision': z.number().readonly(),
+  'subject': z.string().readonly(),
+  'description': z.string().readonly(),
+  'status': z.union([z.literal("completed"), z.literal("pending"), z.literal("in_progress"), z.literal("deleted")]).readonly(),
+  'blockedBy': z.array(z.string()).readonly(),
+  'writeScopes': z.array(z.string()).readonly(),
+  'ownerName': z.string().readonly().optional(),
+  'ready': z.boolean().readonly(),
+  'writeScopeWarnings': z.array(z.string()).readonly(),
+})).readonly(),
+  'failure': z.string().readonly().optional(),
+}).optional().describe('Durable roster and non-deleted task board of the Team rooted at the projected Session.'),
   'userQuestions': z.object({
   'active': z.array(z.object({
-  'callId': z.intersection(z.string(), z.unknown()).readonly(),
+  'callId': z.string().readonly(),
   'questions': z.array(z.object({
-  'id': z.string(),
-  'question': z.string(),
-  'detail': z.string().optional(),
-  'header': z.string().optional(),
+  'id': z.string().describe('Stable caller-provided question id, echoed in the answer.'),
+  'question': z.string().describe('The question to display.'),
+  'detail': z.string().optional().describe('Optional supporting detail rendered with the question but kept out of option labels.'),
+  'header': z.string().optional().describe('Optional short heading/group label.'),
   'options': z.array(z.object({
-  'label': z.string(),
-  'description': z.string().optional(),
-})).optional(),
-  'multiSelect': z.boolean().optional(),
+  'label': z.string().describe('User-facing label.'),
+  'description': z.string().optional().describe('Optional extra context rendered by capable UIs.'),
+})).optional().describe('Optional choices the UI can render as a menu.'),
+  'multiSelect': z.boolean().optional().describe('Whether more than one option may be selected. Defaults to single-select.'),
   'intent': z.object({
-  'kind': z.literal("plan-review"),
-  'approve': z.string(),
-  'callId': z.intersection(z.string(), z.unknown()).optional(),
-}).optional(),
+  'kind': z.literal("plan-review").describe('A plan submitted for review: `detail` is the plan markdown `ask()` requires, and the decision approves or declines it.'),
+  'approve': z.string().describe('The option label that approves the plan; every other option declines it. Named rather than positional so no UI infers the verdict from option order. An `approve` naming no option of its own question is rejected at `ask()`.'),
+  'callId': z.string().optional().describe('Logged tool invocation whose arguments contain the reviewed plan.'),
+}).optional().describe('Optional presentation intent for capable UIs; absent asks for the generic option list.'),
 })).readonly(),
   'state': z.union([z.literal("open"), z.literal("continued")]).readonly(),
-})).readonly(),
+})).readonly().describe('Calls that can still take an answer, in ask order.'),
   'settled': z.array(z.object({
-  'callId': z.intersection(z.string(), z.unknown()).readonly(),
+  'callId': z.string().readonly().describe('The settled call.'),
   'answers': z.array(z.object({
-  'id': z.string(),
-  'selected': z.array(z.string()),
-  'custom': z.string().optional(),
-})).readonly(),
-})).readonly(),
-}).optional(),
+  'id': z.string().describe('The answered question id.'),
+  'selected': z.array(z.string()).describe('Selected option labels. May accompany custom text for a multi-select question.'),
+  'custom': z.string().optional().describe('Optional free-text "Other" answer.'),
+})).readonly().describe('The recorded batch, one entry per question; empty when the late reply carried none.'),
+})).readonly().describe('Calls an answer settled, in settlement order.'),
+}).optional().describe('Timed questions that remain answerable in this Session, and the ones a late reply settled.'),
   'goal': z.union([z.literal(null), z.object({
   'goal': z.object({
-  'objective': z.string().readonly(),
-  'phase': z.union([z.literal("active"), z.literal("paused"), z.literal("blocked"), z.literal("complete")]).readonly(),
+  'objective': z.string().readonly().describe('Human-requested completion objective.'),
+  'phase': z.union([z.literal("active"), z.literal("paused"), z.literal("blocked"), z.literal("complete")]).readonly().describe('Durable lifecycle phase.'),
   'blockedReason': z.object({
-  'code': z.string().readonly(),
-  'message': z.string().readonly(),
-}).readonly().optional(),
-  'maxGoalRounds': z.number().readonly(),
-  'id': z.intersection(z.string(), z.unknown()).readonly(),
-  'revision': z.number().readonly(),
-}).readonly(),
-  'roundsStarted': z.number().readonly(),
-  'createdAt': z.number().readonly(),
-  'updatedAt': z.number().readonly(),
-})]).optional(),
-}), z.record(z.string(), z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema3())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema3()))])).readonly()).readonly(),
+  'code': z.string().readonly().describe('Stable lower-kebab-case classification chosen by the blocking policy.'),
+  'message': z.string().readonly().describe('Non-empty explanation shown to humans and models.'),
+}).readonly().optional().describe('Present exactly while `phase` is `blocked`.'),
+  'maxGoalRounds': z.number().readonly().describe('Total admitted goal-round cap.'),
+  'id': z.string().readonly().describe('Stable goal identity.'),
+  'revision': z.number().readonly().describe('Positive revision; every durable mutation increments it.'),
+}).readonly().describe('Current durable goal snapshot (the CAS ref for mutations rides on it).'),
+  'roundsStarted': z.number().readonly().describe('Highest admitted round number for this goal.'),
+  'createdAt': z.number().readonly().describe('Epoch milliseconds of the create mutation.'),
+  'updatedAt': z.number().readonly().describe('Epoch milliseconds of the latest mutation.'),
+})]).optional().describe('The session\'s current goal and admitted-round count, or `null` before the first create and after a clear tombstone. `goal/change` supplies the whole lifecycle value; matching admitted `user/message` events advance `roundsStarted`.'),
+  'plan': z.object({
+  'active': z.boolean(),
+  'pending': z.boolean(),
+}).optional().describe('Plan collaboration state folded from the plan command lifecycle and `plan/mode` events.'),
+}), z.record(z.string(), z.json()).readonly()).readonly().describe('Provider-validated values; omitted keys are absent capabilities at this cut.'),
 }).readonly(),
   'assistantStream': z.object({
   'revision': z.number().readonly(),
   'activeAttempt': z.object({
-  'attemptId': z.intersection(z.string(), z.unknown()).readonly(),
-  'startedAfterSeq': z.union([z.intersection(z.number(), z.unknown()), z.literal(-1)]).readonly(),
+  'attemptId': z.string().readonly(),
+  'startedAfterSeq': z.union([z.number(), z.literal(-1)]).readonly().describe('Last durable Session seq observed when this attempt started.'),
   'turn': z.number().readonly(),
   'step': z.number().readonly(),
-  'nextIndex': z.number().readonly(),
-  'stream': z.array(z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema3())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema3()))])).readonly(),
+  'nextIndex': z.number().readonly().describe('Dense position expected for the next live chunk frame.'),
+  'stream': z.array(z.json()).readonly().describe('Compact detached stream accumulated at this opening revision.'),
 }).readonly().optional(),
 }).readonly().optional(),
 }), z.object({
   'type': z.literal("assistant-stream").readonly(),
   'frame': z.union([z.object({
   'type': z.literal("start").readonly(),
-  'attemptId': z.intersection(z.string(), z.unknown()).readonly(),
+  'attemptId': z.string().readonly(),
   'revision': z.number().readonly(),
-  'startedAfterSeq': z.union([z.intersection(z.number(), z.unknown()), z.literal(-1)]).readonly(),
+  'startedAfterSeq': z.union([z.number(), z.literal(-1)]).readonly(),
   'turn': z.number().readonly(),
   'step': z.number().readonly(),
 }), z.object({
   'type': z.literal("chunk").readonly(),
-  'attemptId': z.intersection(z.string(), z.unknown()).readonly(),
+  'attemptId': z.string().readonly(),
   'revision': z.number().readonly(),
   'index': z.number().readonly(),
   'time': z.number().readonly(),
-  'chunk': z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema3())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema3()))]).readonly(),
+  'chunk': z.json().readonly(),
 }), z.object({
   'type': z.literal("end").readonly(),
-  'attemptId': z.intersection(z.string(), z.unknown()).readonly(),
+  'attemptId': z.string().readonly(),
   'revision': z.number().readonly(),
-  'index': z.number().readonly(),
+  'index': z.number().readonly().describe('Number of chunk frames represented by this terminal marker.'),
   'outcome': z.union([z.object({
   'kind': z.literal("committed").readonly(),
   'eventType': z.union([z.literal("assistant/message"), z.literal("assistant/attempt")]).readonly(),
@@ -456,12 +505,13 @@ const _deepseek_ai_dsh_api_session_controller_session_follow_result$schema = ()
 })]))
 let _deepseek_ai_dsh_api_session_controller_session_fork_parameter_0$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_fork_parameter_0$schema = () => (_deepseek_ai_dsh_api_session_controller_session_fork_parameter_0$schema$value ??= z.object({
-  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
-  'atSeq': z.number().readonly().optional(),
+  'sessionId': z.string().readonly(),
+  'atSeq': z.number().readonly().optional().describe('Exact inclusive source event seq; omission selects the latest completed-turn prefix.'),
+  'allowMigration': z.boolean().readonly().optional().describe('False asks the Host to check for required migration before forking. Defaults to true.'),
 }))
 let _deepseek_ai_dsh_api_session_controller_session_fork_result$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_fork_result$schema = () => (_deepseek_ai_dsh_api_session_controller_session_fork_result$schema$value ??= z.object({
-  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
+  'sessionId': z.string().readonly(),
 }))
 let _deepseek_ai_dsh_api_session_controller_session_initializeDefaultModel_result$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_initializeDefaultModel_result$schema = () => (_deepseek_ai_dsh_api_session_controller_session_initializeDefaultModel_result$schema$value ??= z.void())
@@ -472,154 +522,184 @@ const _deepseek_ai_dsh_api_session_controller_session_list_parameter_0$schema =
 let _deepseek_ai_dsh_api_session_controller_session_list_result$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_list_result$schema = () => (_deepseek_ai_dsh_api_session_controller_session_list_result$schema$value ??= z.object({
   'items': z.array(z.object({
-  'agentAvailable': z.boolean().readonly(),
-  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
+  'agentAvailable': z.boolean().readonly().describe('Whether this Session currently owns a live Agent.'),
+  'formatStatus': z.union([z.literal("current"), z.literal("migration-required")]).readonly().optional().describe('Current for attached Sessions; otherwise the persistence format status when reported.'),
+  'sessionId': z.string().readonly(),
   'updatedAt': z.number().readonly(),
   'running': z.boolean().readonly(),
   'blank': z.boolean().readonly(),
-  'parentSessionId': z.intersection(z.string(), z.unknown()).readonly().optional(),
+  'parentSessionId': z.string().readonly().optional(),
   'origin': z.literal("subagent").readonly().optional(),
   'cwd': z.string().readonly().optional(),
   'projections': z.object({
-  'kind': z.union([z.literal("cached"), z.literal("sequenced")]).readonly(),
-  'asOfSeq': z.number().readonly(),
+  'kind': z.union([z.literal("cached"), z.literal("sequenced")]).readonly().describe('`sequenced`: the Host\'s live registry produced the block for an attached Session, so `asOfSeq` is comparable with baselines and frames of the same connection. `cached`: a header-only listing viewed the block from the persisted projection cache, so `asOfSeq` is the stored record\'s own watermark and must not be compared with the connected Session\'s values.'),
+  'asOfSeq': z.number().readonly().describe('Watermark of the block in the sequence space named by `kind`.'),
   'values': z.intersection(z.object({
   'inbox': z.object({
-  'next-turn': z.array(z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema()))])).readonly(),
-  'next-step': z.array(z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema()))])).readonly(),
-}).optional(),
-  'agentPreset': z.union([z.literal(null), z.string()]).optional(),
-  'title': z.union([z.literal(null), z.string()]).optional(),
+  'next-turn': z.array(z.json()).readonly(),
+  'next-step': z.array(z.json()).readonly(),
+}).optional().describe('Pending agent input reconstructed from durable inbox splices.'),
+  'workingDirectory': z.union([z.literal(null), z.string()]).optional().describe('Recorded current directory for Session observations, or null when none is recorded.'),
+  'agentPreset': z.union([z.literal(null), z.string()]).optional().describe('Preset the Session runs, or null when the deployment composes none.'),
+  'title': z.union([z.literal(null), z.string()]).optional().describe('The session\'s current normalized title — the latest `session/title` event\'s text (last-wins), or `null` before the first title lands. A plain string: the shape the client list rows consume.'),
   'todos': z.union([z.literal(null), z.array(z.object({
-  'content': z.string(),
-  'status': z.union([z.literal("completed"), z.literal("pending"), z.literal("in_progress")]),
-}))]).optional(),
+  'content': z.string().describe('What this task is — a short imperative line shown in the UI.'),
+  'status': z.union([z.literal("completed"), z.literal("pending"), z.literal("in_progress")]).describe('Lifecycle state. `in_progress` marks a task being worked now; parallel work may mark several.'),
+}))]).optional().describe('The agent\'s current whole todo list (the latest `todo/write` snapshot), or `null` before the first write. Whole-value rule: every `todo/write` carries the complete replacement list, so the fold is last-wins.'),
   'sessionListMetadata': z.object({
-  'blank': z.boolean().readonly(),
-  'lastPromptAt': z.union([z.literal(null), z.number()]).readonly(),
-}).optional(),
+  'blank': z.boolean().readonly().describe('Whether the folded prefix contains no turn.'),
+  'lastPromptAt': z.union([z.literal(null), z.number()]).readonly().describe('Latest human-authored prompt time in the folded prefix.'),
+}).optional().describe('Persisted facts used to summarize a Session without activating it.'),
   'imageLimits': z.object({
   'maxImageBytes': z.number(),
   'maxImagesPerMessage': z.number(),
   'maxMessageImageBytes': z.number(),
   'maxImagePixels': z.number(),
-  'maxImageDimension': z.number(),
+  'maxImageDimension': z.number().describe('Maximum intrinsic width and maximum intrinsic height in pixels for one image.'),
   'mediaTypes': z.array(z.union([z.literal("image/png"), z.literal("image/jpeg"), z.literal("image/webp"), z.literal("image/gif")])),
-}).optional(),
+}).optional().describe('Image-intake limits enforced by the Session prompt endpoint.'),
   'modelSelection': z.object({
   'lastUsed': z.union([z.literal(null), z.object({
   'provider': z.string().readonly(),
   'model': z.string().readonly(),
   'reasoningEffort': z.string().readonly().optional(),
-})]).readonly(),
+})]).readonly().describe('Selection consumed by the latest recorded model request.'),
   'next': z.union([z.literal(null), z.object({
   'provider': z.string().readonly(),
   'model': z.string().readonly(),
   'reasoningEffort': z.string().readonly().optional(),
-})]).readonly(),
-}).optional(),
+})]).readonly().describe('Selection the next request should use, falling back to {@link lastUsed}.'),
+}).optional().describe('Durable model selection already used and selected for the next request.'),
   'permissions': z.object({
-  'currentValue': z.string(),
-}).optional(),
-  'subagentCatalog': z.array(z.union([z.intersection(z.object({
-  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'currentValue': z.string().describe('The effective current value: a configured preset key, `auto`, or `custom`.'),
+}).optional().describe('The session\'s current permission, folded from the three whole-value knob events (`permission/preset`, `sandbox/mode`, `approval/policy`) over the composition defaults. Selectable options come from the process-level catalog Remote. Key absence means no permission service is composed — clients hide the control.'),
+  'subagentCatalog': z.array(z.union([z.object({
+  'id': z.string().readonly(),
   'createdAt': z.number().readonly(),
-}), z.object({
   'mode': z.literal("one-shot").readonly(),
   'label': z.string().readonly().optional(),
-})), z.intersection(z.object({
-  'id': z.intersection(z.string(), z.unknown()).readonly(),
+}), z.object({
+  'id': z.string().readonly(),
   'createdAt': z.number().readonly(),
+  'mode': z.literal("external").readonly(),
+  'label': z.string().readonly().optional(),
 }), z.object({
+  'id': z.string().readonly(),
+  'createdAt': z.number().readonly(),
   'mode': z.literal("continuable").readonly(),
   'label': z.string().readonly(),
-})), z.intersection(z.object({
-  'id': z.intersection(z.string(), z.unknown()).readonly(),
-  'createdAt': z.number().readonly(),
 }), z.object({
+  'id': z.string().readonly(),
+  'createdAt': z.number().readonly(),
   'mode': z.literal("unknown").readonly(),
   'label': z.string().readonly().optional(),
-}))])).optional(),
+})])).optional().describe('Direct children in parent catalog event order, excluding fork-inherited facts.'),
   'subagentTiming': z.object({
-  'settledMs': z.number(),
+  'settledMs': z.number().describe('Milliseconds accumulated across completed turns after the child\'s own descriptor.'),
   'active': z.object({
-  'since': z.number(),
-  'through': z.number(),
-}).optional(),
-  'lastTurnCompleted': z.boolean().optional(),
-}).optional(),
+  'since': z.number().describe('Start of the open turn.'),
+  'through': z.number().describe('Latest event time folded into this projection cut.'),
+}).optional().describe('Same-cut bounds of the currently open turn, when one has not reached `turn/end`.'),
+  'lastTurnCompleted': z.boolean().optional().describe('Whether the latest closed turn after the child\'s own descriptor completed normally; absent while a turn is open or before one closes.'),
+}).optional().describe('Active-turn duration and latest closed-turn completion for a descriptor-backed subagent session.'),
   'subagent': z.union([z.literal(null), z.object({
-  'mode': z.literal("one-shot"),
-  'label': z.string().optional(),
-  'seq': z.intersection(z.number(), z.unknown()),
+  'mode': z.literal("one-shot").describe('A terminal one-shot child.'),
+  'label': z.string().optional().describe('Optional durable creation label from the child\'s descriptor.'),
+  'seq': z.number().describe('Seq of the `subagent/descriptor` event this identity was folded from. `session.isOwnSeq(seq)` proves the identity comes from the child\'s OWN log suffix — where a descriptor is immutable once appended — and not from a fork seed\'s replayed ancestor descriptor.'),
 }), z.object({
-  'mode': z.literal("continuable"),
-  'label': z.string(),
-  'seq': z.intersection(z.number(), z.unknown()),
-})]).optional(),
+  'mode': z.literal("continuable").describe('A resumable conversation.'),
+  'label': z.string().describe('Durable creation label from the child\'s descriptor.'),
+  'seq': z.number().describe('Seq of the folded descriptor event; see the one-shot arm for the own-suffix proof.'),
+})]).optional().describe('Identity of a descriptor-backed subagent session. `null` ⟺ no valid descriptor (missing, malformed, or unrecognized-version — deliberately undistinguished). The sentinel is deliberately serializable: a value pushed over JSON transports must survive `JSON.stringify` losslessly, where an `undefined` field would be dropped and a stale identity would survive on the receiving side. The entry itself stays non-optional.'),
   'tokenUsage': z.object({
   'uncachedInputTokens': z.number(),
   'outputTokens': z.number(),
   'cacheReadTokens': z.number(),
   'cacheWriteTokens': z.number(),
-}).optional(),
+}).optional().describe('Provider-reported usage accumulated across the complete durable log.'),
   'contextPressure': z.object({
-  'pressureTokens': z.number().optional(),
-  'projectedTokens': z.number().optional(),
-  'contextWindow': z.number().optional(),
-}).optional(),
+  'pressureTokens': z.number().optional().describe('Provider-reported prompt size of the most recent request: uncached input plus cache reads and writes. Response output is excluded, so this does not grow as the current turn streams. Absent until a provider reports usage.'),
+  'projectedTokens': z.number().optional().describe('What the NEXT request\'s prompt would cost: {@link pressureTokens} plus the heuristic repricing of everything the surface gained or lost since that sample. Only the delta is estimated, so the figure stays anchored to the provider while still reacting the moment a compaction shadows a span — which `pressureTokens` alone cannot do, since compaction reports no usage of its own. Absent until a provider reports usage.'),
+  'contextWindow': z.number().optional().describe('Newest recorded route capacity; absent when no adapter advertised one.'),
+}).optional().describe('Newest request pressure paired with the newest known route capacity.'),
   'contextBreakdown': z.object({
-  'systemTokens': z.number(),
-  'toolsTokens': z.number(),
-  'messageTokens': z.number(),
-}).optional(),
+  'systemTokens': z.number().describe('Heuristic tokens of the last nonempty surviving system prompt in surface order; 0 when none exists.'),
+  'toolsTokens': z.number().describe('Heuristic tokens of the newest request envelope\'s tool schemas; 0 before any request.'),
+  'messageTokens': z.number().describe('Heuristic tokens of every other visible surface node, including superseded system prompts.'),
+}).optional().describe('Heuristic system/tools/message composition of the next request.'),
+  'agentTeam': z.object({
+  'members': z.array(z.object({
+  'id': z.string().readonly(),
+  'name': z.string().readonly(),
+  'role': z.union([z.literal("lead"), z.literal("teammate")]).readonly(),
+  'phase': z.union([z.literal("failed"), z.literal("provisioning"), z.literal("active")]).readonly().describe('Durable lifecycle; the Lead row is always `active`. Turn activity comes from Session status.'),
+  'error': z.string().readonly().optional(),
+})).readonly(),
+  'tasks': z.array(z.object({
+  'id': z.string().readonly(),
+  'revision': z.number().readonly(),
+  'subject': z.string().readonly(),
+  'description': z.string().readonly(),
+  'status': z.union([z.literal("completed"), z.literal("pending"), z.literal("in_progress"), z.literal("deleted")]).readonly(),
+  'blockedBy': z.array(z.string()).readonly(),
+  'writeScopes': z.array(z.string()).readonly(),
+  'ownerName': z.string().readonly().optional(),
+  'ready': z.boolean().readonly(),
+  'writeScopeWarnings': z.array(z.string()).readonly(),
+})).readonly(),
+  'failure': z.string().readonly().optional(),
+}).optional().describe('Durable roster and non-deleted task board of the Team rooted at the projected Session.'),
   'userQuestions': z.object({
   'active': z.array(z.object({
-  'callId': z.intersection(z.string(), z.unknown()).readonly(),
+  'callId': z.string().readonly(),
   'questions': z.array(z.object({
-  'id': z.string(),
-  'question': z.string(),
-  'detail': z.string().optional(),
-  'header': z.string().optional(),
+  'id': z.string().describe('Stable caller-provided question id, echoed in the answer.'),
+  'question': z.string().describe('The question to display.'),
+  'detail': z.string().optional().describe('Optional supporting detail rendered with the question but kept out of option labels.'),
+  'header': z.string().optional().describe('Optional short heading/group label.'),
   'options': z.array(z.object({
-  'label': z.string(),
-  'description': z.string().optional(),
-})).optional(),
-  'multiSelect': z.boolean().optional(),
+  'label': z.string().describe('User-facing label.'),
+  'description': z.string().optional().describe('Optional extra context rendered by capable UIs.'),
+})).optional().describe('Optional choices the UI can render as a menu.'),
+  'multiSelect': z.boolean().optional().describe('Whether more than one option may be selected. Defaults to single-select.'),
   'intent': z.object({
-  'kind': z.literal("plan-review"),
-  'approve': z.string(),
-  'callId': z.intersection(z.string(), z.unknown()).optional(),
-}).optional(),
+  'kind': z.literal("plan-review").describe('A plan submitted for review: `detail` is the plan markdown `ask()` requires, and the decision approves or declines it.'),
+  'approve': z.string().describe('The option label that approves the plan; every other option declines it. Named rather than positional so no UI infers the verdict from option order. An `approve` naming no option of its own question is rejected at `ask()`.'),
+  'callId': z.string().optional().describe('Logged tool invocation whose arguments contain the reviewed plan.'),
+}).optional().describe('Optional presentation intent for capable UIs; absent asks for the generic option list.'),
 })).readonly(),
   'state': z.union([z.literal("open"), z.literal("continued")]).readonly(),
-})).readonly(),
+})).readonly().describe('Calls that can still take an answer, in ask order.'),
   'settled': z.array(z.object({
-  'callId': z.intersection(z.string(), z.unknown()).readonly(),
+  'callId': z.string().readonly().describe('The settled call.'),
   'answers': z.array(z.object({
-  'id': z.string(),
-  'selected': z.array(z.string()),
-  'custom': z.string().optional(),
-})).readonly(),
-})).readonly(),
-}).optional(),
+  'id': z.string().describe('The answered question id.'),
+  'selected': z.array(z.string()).describe('Selected option labels. May accompany custom text for a multi-select question.'),
+  'custom': z.string().optional().describe('Optional free-text "Other" answer.'),
+})).readonly().describe('The recorded batch, one entry per question; empty when the late reply carried none.'),
+})).readonly().describe('Calls an answer settled, in settlement order.'),
+}).optional().describe('Timed questions that remain answerable in this Session, and the ones a late reply settled.'),
   'goal': z.union([z.literal(null), z.object({
   'goal': z.object({
-  'objective': z.string().readonly(),
-  'phase': z.union([z.literal("active"), z.literal("paused"), z.literal("blocked"), z.literal("complete")]).readonly(),
+  'objective': z.string().readonly().describe('Human-requested completion objective.'),
+  'phase': z.union([z.literal("active"), z.literal("paused"), z.literal("blocked"), z.literal("complete")]).readonly().describe('Durable lifecycle phase.'),
   'blockedReason': z.object({
-  'code': z.string().readonly(),
-  'message': z.string().readonly(),
-}).readonly().optional(),
-  'maxGoalRounds': z.number().readonly(),
-  'id': z.intersection(z.string(), z.unknown()).readonly(),
-  'revision': z.number().readonly(),
-}).readonly(),
-  'roundsStarted': z.number().readonly(),
-  'createdAt': z.number().readonly(),
-  'updatedAt': z.number().readonly(),
-})]).optional(),
-}), z.record(z.string(), z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema()))])).readonly()).readonly(),
+  'code': z.string().readonly().describe('Stable lower-kebab-case classification chosen by the blocking policy.'),
+  'message': z.string().readonly().describe('Non-empty explanation shown to humans and models.'),
+}).readonly().optional().describe('Present exactly while `phase` is `blocked`.'),
+  'maxGoalRounds': z.number().readonly().describe('Total admitted goal-round cap.'),
+  'id': z.string().readonly().describe('Stable goal identity.'),
+  'revision': z.number().readonly().describe('Positive revision; every durable mutation increments it.'),
+}).readonly().describe('Current durable goal snapshot (the CAS ref for mutations rides on it).'),
+  'roundsStarted': z.number().readonly().describe('Highest admitted round number for this goal.'),
+  'createdAt': z.number().readonly().describe('Epoch milliseconds of the create mutation.'),
+  'updatedAt': z.number().readonly().describe('Epoch milliseconds of the latest mutation.'),
+})]).optional().describe('The session\'s current goal and admitted-round count, or `null` before the first create and after a clear tombstone. `goal/change` supplies the whole lifecycle value; matching admitted `user/message` events advance `roundsStarted`.'),
+  'plan': z.object({
+  'active': z.boolean(),
+  'pending': z.boolean(),
+}).optional().describe('Plan collaboration state folded from the plan command lifecycle and `plan/mode` events.'),
+}), z.record(z.string(), z.json()).readonly()).readonly().describe('Provider-validated values present in the block; omitted keys remain unknown.'),
 }).readonly().optional(),
 })).readonly(),
 }))
@@ -630,7 +710,7 @@ const _deepseek_ai_dsh_api_session_controller_session_modelCatalog_result$schema
   'model': z.string().readonly(),
   'reasoningEffort': z.string().readonly().optional(),
 }).readonly(),
-  'routableProviders': z.array(z.string()).readonly(),
+  'routableProviders': z.array(z.string()).readonly().describe('Provider routes with at least one currently available catalog model.'),
   'groups': z.array(z.object({
   'id': z.string().readonly(),
   'name': z.string().readonly(),
@@ -656,9 +736,9 @@ const _deepseek_ai_dsh_api_session_controller_session_modelCatalog_result$schema
 }))
 let _deepseek_ai_dsh_api_session_controller_session_openWorkspacePath_parameter_0$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_openWorkspacePath_parameter_0$schema = () => (_deepseek_ai_dsh_api_session_controller_session_openWorkspacePath_parameter_0$schema$value ??= z.object({
-  'action': z.literal("reveal").readonly().optional(),
-  'application': z.string().readonly().optional(),
-  'path': z.string().readonly(),
+  'action': z.literal("reveal").readonly().optional().describe('File-manager navigation when requested; omission uses the default application.'),
+  'application': z.string().readonly().optional().describe('Registered application identifier; ignored for reveal. Omission preserves the operating system default.'),
+  'path': z.string().readonly().describe('Path after best-effort Session workspace resolution, in Host filesystem syntax.'),
 }))
 let _deepseek_ai_dsh_api_session_controller_session_openWorkspacePath_result$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_openWorkspacePath_result$schema = () => (_deepseek_ai_dsh_api_session_controller_session_openWorkspacePath_result$schema$value ??= z.object({
@@ -668,20 +748,20 @@ let _deepseek_ai_dsh_api_session_controller_session_page_parameter_0$schema$valu
 const _deepseek_ai_dsh_api_session_controller_session_page_parameter_0$schema = () => (_deepseek_ai_dsh_api_session_controller_session_page_parameter_0$schema$value ??= z.object({
   'address': z.union([z.object({
   'kind': z.literal("session").readonly(),
-  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
+  'sessionId': z.string().readonly(),
 }), z.object({
   'kind': z.literal("subagent").readonly(),
-  'parentSessionId': z.intersection(z.string(), z.unknown()).readonly(),
-  'childSessionId': z.intersection(z.string(), z.unknown()).readonly(),
+  'parentSessionId': z.string().readonly(),
+  'childSessionId': z.string().readonly(),
   'mode': z.union([z.literal("one-shot"), z.literal("continuable"), z.literal("unknown")]).readonly(),
 })]).readonly(),
-  'throughSeq': z.number().readonly(),
+  'throughSeq': z.number().readonly().describe('Inclusive log cut obtained from the corresponding follow opening frame.'),
   'beforeSeq': z.number().readonly().optional(),
   'maxMessages': z.number().readonly().optional(),
   'turnWindow': z.object({
-  'minMessages': z.number().readonly(),
-  'minTurns': z.number().readonly(),
-}).readonly().optional(),
+  'minMessages': z.number().readonly().describe('Minimum append-origin user/assistant messages; must not exceed maxMessages.'),
+  'minTurns': z.number().readonly().describe('Minimum Turn starts crossed, including the partial Turn at beforeSeq.'),
+}).readonly().optional().describe('Stop at a Turn start after both minima, unless maxMessages or history exhaustion wins.'),
 }))
 let _deepseek_ai_dsh_api_session_controller_session_page_result$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_page_result$schema = () => (_deepseek_ai_dsh_api_session_controller_session_page_result$schema$value ??= z.object({
@@ -691,163 +771,361 @@ const _deepseek_ai_dsh_api_session_controller_session_page_result$schema = () =>
   'type': z.string().readonly(),
   'seq': z.number().readonly(),
   'time': z.number().readonly(),
-  'data': z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema2())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema2()))]).readonly(),
+  'data': z.json().readonly(),
   'ignorable': z.literal(true).readonly().optional(),
-  'sourceEventSeqs': z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema2())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema2()))]).readonly().optional(),
-  'surfaceOp': z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema2())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema2()))]).readonly().optional(),
+  'sourceEventSeqs': z.json().readonly().optional().describe('Earlier sources on current surface events; opaque JSON on unknown ignorable events.'),
+  'surfaceOp': z.json().readonly().optional().describe('Canonical placement on current surface events; opaque JSON on unknown ignorable events.'),
 }).readonly(),
 })).readonly(),
   'hasMore': z.boolean().readonly(),
 }))
 let _deepseek_ai_dsh_api_session_controller_session_projections_parameter_0$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_projections_parameter_0$schema = () => (_deepseek_ai_dsh_api_session_controller_session_projections_parameter_0$schema$value ??= z.object({
-  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
+  'sessionId': z.string().readonly(),
 }))
 let _deepseek_ai_dsh_api_session_controller_session_projections_result$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_projections_result$schema = () => (_deepseek_ai_dsh_api_session_controller_session_projections_result$schema$value ??= z.union([z.literal(null), z.object({
   'asOfSeq': z.number().readonly(),
   'values': z.intersection(z.object({
   'inbox': z.object({
-  'next-turn': z.array(z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema4())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema4()))])).readonly(),
-  'next-step': z.array(z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema4())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema4()))])).readonly(),
-}).optional(),
-  'agentPreset': z.union([z.literal(null), z.string()]).optional(),
-  'title': z.union([z.literal(null), z.string()]).optional(),
+  'next-turn': z.array(z.json()).readonly(),
+  'next-step': z.array(z.json()).readonly(),
+}).optional().describe('Pending agent input reconstructed from durable inbox splices.'),
+  'workingDirectory': z.union([z.literal(null), z.string()]).optional().describe('Recorded current directory for Session observations, or null when none is recorded.'),
+  'agentPreset': z.union([z.literal(null), z.string()]).optional().describe('Preset the Session runs, or null when the deployment composes none.'),
+  'title': z.union([z.literal(null), z.string()]).optional().describe('The session\'s current normalized title — the latest `session/title` event\'s text (last-wins), or `null` before the first title lands. A plain string: the shape the client list rows consume.'),
   'todos': z.union([z.literal(null), z.array(z.object({
-  'content': z.string(),
-  'status': z.union([z.literal("completed"), z.literal("pending"), z.literal("in_progress")]),
-}))]).optional(),
+  'content': z.string().describe('What this task is — a short imperative line shown in the UI.'),
+  'status': z.union([z.literal("completed"), z.literal("pending"), z.literal("in_progress")]).describe('Lifecycle state. `in_progress` marks a task being worked now; parallel work may mark several.'),
+}))]).optional().describe('The agent\'s current whole todo list (the latest `todo/write` snapshot), or `null` before the first write. Whole-value rule: every `todo/write` carries the complete replacement list, so the fold is last-wins.'),
   'sessionListMetadata': z.object({
-  'blank': z.boolean().readonly(),
-  'lastPromptAt': z.union([z.literal(null), z.number()]).readonly(),
-}).optional(),
+  'blank': z.boolean().readonly().describe('Whether the folded prefix contains no turn.'),
+  'lastPromptAt': z.union([z.literal(null), z.number()]).readonly().describe('Latest human-authored prompt time in the folded prefix.'),
+}).optional().describe('Persisted facts used to summarize a Session without activating it.'),
   'imageLimits': z.object({
   'maxImageBytes': z.number(),
   'maxImagesPerMessage': z.number(),
   'maxMessageImageBytes': z.number(),
   'maxImagePixels': z.number(),
-  'maxImageDimension': z.number(),
+  'maxImageDimension': z.number().describe('Maximum intrinsic width and maximum intrinsic height in pixels for one image.'),
   'mediaTypes': z.array(z.union([z.literal("image/png"), z.literal("image/jpeg"), z.literal("image/webp"), z.literal("image/gif")])),
-}).optional(),
+}).optional().describe('Image-intake limits enforced by the Session prompt endpoint.'),
   'modelSelection': z.object({
   'lastUsed': z.union([z.literal(null), z.object({
   'provider': z.string().readonly(),
   'model': z.string().readonly(),
   'reasoningEffort': z.string().readonly().optional(),
-})]).readonly(),
+})]).readonly().describe('Selection consumed by the latest recorded model request.'),
   'next': z.union([z.literal(null), z.object({
   'provider': z.string().readonly(),
   'model': z.string().readonly(),
   'reasoningEffort': z.string().readonly().optional(),
-})]).readonly(),
-}).optional(),
+})]).readonly().describe('Selection the next request should use, falling back to {@link lastUsed}.'),
+}).optional().describe('Durable model selection already used and selected for the next request.'),
   'permissions': z.object({
-  'currentValue': z.string(),
-}).optional(),
-  'subagentCatalog': z.array(z.union([z.intersection(z.object({
-  'id': z.intersection(z.string(), z.unknown()).readonly(),
+  'currentValue': z.string().describe('The effective current value: a configured preset key, `auto`, or `custom`.'),
+}).optional().describe('The session\'s current permission, folded from the three whole-value knob events (`permission/preset`, `sandbox/mode`, `approval/policy`) over the composition defaults. Selectable options come from the process-level catalog Remote. Key absence means no permission service is composed — clients hide the control.'),
+  'subagentCatalog': z.array(z.union([z.object({
+  'id': z.string().readonly(),
   'createdAt': z.number().readonly(),
-}), z.object({
   'mode': z.literal("one-shot").readonly(),
   'label': z.string().readonly().optional(),
-})), z.intersection(z.object({
-  'id': z.intersection(z.string(), z.unknown()).readonly(),
+}), z.object({
+  'id': z.string().readonly(),
   'createdAt': z.number().readonly(),
+  'mode': z.literal("external").readonly(),
+  'label': z.string().readonly().optional(),
 }), z.object({
+  'id': z.string().readonly(),
+  'createdAt': z.number().readonly(),
   'mode': z.literal("continuable").readonly(),
   'label': z.string().readonly(),
-})), z.intersection(z.object({
-  'id': z.intersection(z.string(), z.unknown()).readonly(),
-  'createdAt': z.number().readonly(),
 }), z.object({
+  'id': z.string().readonly(),
+  'createdAt': z.number().readonly(),
   'mode': z.literal("unknown").readonly(),
   'label': z.string().readonly().optional(),
-}))])).optional(),
+})])).optional().describe('Direct children in parent catalog event order, excluding fork-inherited facts.'),
   'subagentTiming': z.object({
-  'settledMs': z.number(),
+  'settledMs': z.number().describe('Milliseconds accumulated across completed turns after the child\'s own descriptor.'),
   'active': z.object({
-  'since': z.number(),
-  'through': z.number(),
-}).optional(),
-  'lastTurnCompleted': z.boolean().optional(),
-}).optional(),
+  'since': z.number().describe('Start of the open turn.'),
+  'through': z.number().describe('Latest event time folded into this projection cut.'),
+}).optional().describe('Same-cut bounds of the currently open turn, when one has not reached `turn/end`.'),
+  'lastTurnCompleted': z.boolean().optional().describe('Whether the latest closed turn after the child\'s own descriptor completed normally; absent while a turn is open or before one closes.'),
+}).optional().describe('Active-turn duration and latest closed-turn completion for a descriptor-backed subagent session.'),
   'subagent': z.union([z.literal(null), z.object({
-  'mode': z.literal("one-shot"),
-  'label': z.string().optional(),
-  'seq': z.intersection(z.number(), z.unknown()),
+  'mode': z.literal("one-shot").describe('A terminal one-shot child.'),
+  'label': z.string().optional().describe('Optional durable creation label from the child\'s descriptor.'),
+  'seq': z.number().describe('Seq of the `subagent/descriptor` event this identity was folded from. `session.isOwnSeq(seq)` proves the identity comes from the child\'s OWN log suffix — where a descriptor is immutable once appended — and not from a fork seed\'s replayed ancestor descriptor.'),
 }), z.object({
-  'mode': z.literal("continuable"),
-  'label': z.string(),
-  'seq': z.intersection(z.number(), z.unknown()),
-})]).optional(),
+  'mode': z.literal("continuable").describe('A resumable conversation.'),
+  'label': z.string().describe('Durable creation label from the child\'s descriptor.'),
+  'seq': z.number().describe('Seq of the folded descriptor event; see the one-shot arm for the own-suffix proof.'),
+})]).optional().describe('Identity of a descriptor-backed subagent session. `null` ⟺ no valid descriptor (missing, malformed, or unrecognized-version — deliberately undistinguished). The sentinel is deliberately serializable: a value pushed over JSON transports must survive `JSON.stringify` losslessly, where an `undefined` field would be dropped and a stale identity would survive on the receiving side. The entry itself stays non-optional.'),
   'tokenUsage': z.object({
   'uncachedInputTokens': z.number(),
   'outputTokens': z.number(),
   'cacheReadTokens': z.number(),
   'cacheWriteTokens': z.number(),
-}).optional(),
+}).optional().describe('Provider-reported usage accumulated across the complete durable log.'),
   'contextPressure': z.object({
-  'pressureTokens': z.number().optional(),
-  'projectedTokens': z.number().optional(),
-  'contextWindow': z.number().optional(),
-}).optional(),
+  'pressureTokens': z.number().optional().describe('Provider-reported prompt size of the most recent request: uncached input plus cache reads and writes. Response output is excluded, so this does not grow as the current turn streams. Absent until a provider reports usage.'),
+  'projectedTokens': z.number().optional().describe('What the NEXT request\'s prompt would cost: {@link pressureTokens} plus the heuristic repricing of everything the surface gained or lost since that sample. Only the delta is estimated, so the figure stays anchored to the provider while still reacting the moment a compaction shadows a span — which `pressureTokens` alone cannot do, since compaction reports no usage of its own. Absent until a provider reports usage.'),
+  'contextWindow': z.number().optional().describe('Newest recorded route capacity; absent when no adapter advertised one.'),
+}).optional().describe('Newest request pressure paired with the newest known route capacity.'),
   'contextBreakdown': z.object({
-  'systemTokens': z.number(),
-  'toolsTokens': z.number(),
-  'messageTokens': z.number(),
-}).optional(),
+  'systemTokens': z.number().describe('Heuristic tokens of the last nonempty surviving system prompt in surface order; 0 when none exists.'),
+  'toolsTokens': z.number().describe('Heuristic tokens of the newest request envelope\'s tool schemas; 0 before any request.'),
+  'messageTokens': z.number().describe('Heuristic tokens of every other visible surface node, including superseded system prompts.'),
+}).optional().describe('Heuristic system/tools/message composition of the next request.'),
+  'agentTeam': z.object({
+  'members': z.array(z.object({
+  'id': z.string().readonly(),
+  'name': z.string().readonly(),
+  'role': z.union([z.literal("lead"), z.literal("teammate")]).readonly(),
+  'phase': z.union([z.literal("failed"), z.literal("provisioning"), z.literal("active")]).readonly().describe('Durable lifecycle; the Lead row is always `active`. Turn activity comes from Session status.'),
+  'error': z.string().readonly().optional(),
+})).readonly(),
+  'tasks': z.array(z.object({
+  'id': z.string().readonly(),
+  'revision': z.number().readonly(),
+  'subject': z.string().readonly(),
+  'description': z.string().readonly(),
+  'status': z.union([z.literal("completed"), z.literal("pending"), z.literal("in_progress"), z.literal("deleted")]).readonly(),
+  'blockedBy': z.array(z.string()).readonly(),
+  'writeScopes': z.array(z.string()).readonly(),
+  'ownerName': z.string().readonly().optional(),
+  'ready': z.boolean().readonly(),
+  'writeScopeWarnings': z.array(z.string()).readonly(),
+})).readonly(),
+  'failure': z.string().readonly().optional(),
+}).optional().describe('Durable roster and non-deleted task board of the Team rooted at the projected Session.'),
   'userQuestions': z.object({
   'active': z.array(z.object({
-  'callId': z.intersection(z.string(), z.unknown()).readonly(),
+  'callId': z.string().readonly(),
   'questions': z.array(z.object({
-  'id': z.string(),
-  'question': z.string(),
-  'detail': z.string().optional(),
-  'header': z.string().optional(),
+  'id': z.string().describe('Stable caller-provided question id, echoed in the answer.'),
+  'question': z.string().describe('The question to display.'),
+  'detail': z.string().optional().describe('Optional supporting detail rendered with the question but kept out of option labels.'),
+  'header': z.string().optional().describe('Optional short heading/group label.'),
   'options': z.array(z.object({
-  'label': z.string(),
-  'description': z.string().optional(),
-})).optional(),
-  'multiSelect': z.boolean().optional(),
+  'label': z.string().describe('User-facing label.'),
+  'description': z.string().optional().describe('Optional extra context rendered by capable UIs.'),
+})).optional().describe('Optional choices the UI can render as a menu.'),
+  'multiSelect': z.boolean().optional().describe('Whether more than one option may be selected. Defaults to single-select.'),
   'intent': z.object({
-  'kind': z.literal("plan-review"),
-  'approve': z.string(),
-  'callId': z.intersection(z.string(), z.unknown()).optional(),
-}).optional(),
+  'kind': z.literal("plan-review").describe('A plan submitted for review: `detail` is the plan markdown `ask()` requires, and the decision approves or declines it.'),
+  'approve': z.string().describe('The option label that approves the plan; every other option declines it. Named rather than positional so no UI infers the verdict from option order. An `approve` naming no option of its own question is rejected at `ask()`.'),
+  'callId': z.string().optional().describe('Logged tool invocation whose arguments contain the reviewed plan.'),
+}).optional().describe('Optional presentation intent for capable UIs; absent asks for the generic option list.'),
 })).readonly(),
   'state': z.union([z.literal("open"), z.literal("continued")]).readonly(),
-})).readonly(),
+})).readonly().describe('Calls that can still take an answer, in ask order.'),
   'settled': z.array(z.object({
-  'callId': z.intersection(z.string(), z.unknown()).readonly(),
+  'callId': z.string().readonly().describe('The settled call.'),
   'answers': z.array(z.object({
-  'id': z.string(),
-  'selected': z.array(z.string()),
-  'custom': z.string().optional(),
+  'id': z.string().describe('The answered question id.'),
+  'selected': z.array(z.string()).describe('Selected option labels. May accompany custom text for a multi-select question.'),
+  'custom': z.string().optional().describe('Optional free-text "Other" answer.'),
+})).readonly().describe('The recorded batch, one entry per question; empty when the late reply carried none.'),
+})).readonly().describe('Calls an answer settled, in settlement order.'),
+}).optional().describe('Timed questions that remain answerable in this Session, and the ones a late reply settled.'),
+  'goal': z.union([z.literal(null), z.object({
+  'goal': z.object({
+  'objective': z.string().readonly().describe('Human-requested completion objective.'),
+  'phase': z.union([z.literal("active"), z.literal("paused"), z.literal("blocked"), z.literal("complete")]).readonly().describe('Durable lifecycle phase.'),
+  'blockedReason': z.object({
+  'code': z.string().readonly().describe('Stable lower-kebab-case classification chosen by the blocking policy.'),
+  'message': z.string().readonly().describe('Non-empty explanation shown to humans and models.'),
+}).readonly().optional().describe('Present exactly while `phase` is `blocked`.'),
+  'maxGoalRounds': z.number().readonly().describe('Total admitted goal-round cap.'),
+  'id': z.string().readonly().describe('Stable goal identity.'),
+  'revision': z.number().readonly().describe('Positive revision; every durable mutation increments it.'),
+}).readonly().describe('Current durable goal snapshot (the CAS ref for mutations rides on it).'),
+  'roundsStarted': z.number().readonly().describe('Highest admitted round number for this goal.'),
+  'createdAt': z.number().readonly().describe('Epoch milliseconds of the create mutation.'),
+  'updatedAt': z.number().readonly().describe('Epoch milliseconds of the latest mutation.'),
+})]).optional().describe('The session\'s current goal and admitted-round count, or `null` before the first create and after a clear tombstone. `goal/change` supplies the whole lifecycle value; matching admitted `user/message` events advance `roundsStarted`.'),
+  'plan': z.object({
+  'active': z.boolean(),
+  'pending': z.boolean(),
+}).optional().describe('Plan collaboration state folded from the plan command lifecycle and `plan/mode` events.'),
+}), z.record(z.string(), z.json()).readonly()).readonly().describe('Provider-validated values; omitted keys are absent capabilities at this cut.'),
+  'kind': z.literal("sequenced").readonly(),
+}), z.object({
+  'kind': z.literal("migration-required").readonly(),
+  'values': z.intersection(z.object({
+  'inbox': z.object({
+  'next-turn': z.array(z.json()).readonly(),
+  'next-step': z.array(z.json()).readonly(),
+}).optional().describe('Pending agent input reconstructed from durable inbox splices.'),
+  'workingDirectory': z.union([z.literal(null), z.string()]).optional().describe('Recorded current directory for Session observations, or null when none is recorded.'),
+  'agentPreset': z.union([z.literal(null), z.string()]).optional().describe('Preset the Session runs, or null when the deployment composes none.'),
+  'title': z.union([z.literal(null), z.string()]).optional().describe('The session\'s current normalized title — the latest `session/title` event\'s text (last-wins), or `null` before the first title lands. A plain string: the shape the client list rows consume.'),
+  'todos': z.union([z.literal(null), z.array(z.object({
+  'content': z.string().describe('What this task is — a short imperative line shown in the UI.'),
+  'status': z.union([z.literal("completed"), z.literal("pending"), z.literal("in_progress")]).describe('Lifecycle state. `in_progress` marks a task being worked now; parallel work may mark several.'),
+}))]).optional().describe('The agent\'s current whole todo list (the latest `todo/write` snapshot), or `null` before the first write. Whole-value rule: every `todo/write` carries the complete replacement list, so the fold is last-wins.'),
+  'sessionListMetadata': z.object({
+  'blank': z.boolean().readonly().describe('Whether the folded prefix contains no turn.'),
+  'lastPromptAt': z.union([z.literal(null), z.number()]).readonly().describe('Latest human-authored prompt time in the folded prefix.'),
+}).optional().describe('Persisted facts used to summarize a Session without activating it.'),
+  'imageLimits': z.object({
+  'maxImageBytes': z.number(),
+  'maxImagesPerMessage': z.number(),
+  'maxMessageImageBytes': z.number(),
+  'maxImagePixels': z.number(),
+  'maxImageDimension': z.number().describe('Maximum intrinsic width and maximum intrinsic height in pixels for one image.'),
+  'mediaTypes': z.array(z.union([z.literal("image/png"), z.literal("image/jpeg"), z.literal("image/webp"), z.literal("image/gif")])),
+}).optional().describe('Image-intake limits enforced by the Session prompt endpoint.'),
+  'modelSelection': z.object({
+  'lastUsed': z.union([z.literal(null), z.object({
+  'provider': z.string().readonly(),
+  'model': z.string().readonly(),
+  'reasoningEffort': z.string().readonly().optional(),
+})]).readonly().describe('Selection consumed by the latest recorded model request.'),
+  'next': z.union([z.literal(null), z.object({
+  'provider': z.string().readonly(),
+  'model': z.string().readonly(),
+  'reasoningEffort': z.string().readonly().optional(),
+})]).readonly().describe('Selection the next request should use, falling back to {@link lastUsed}.'),
+}).optional().describe('Durable model selection already used and selected for the next request.'),
+  'permissions': z.object({
+  'currentValue': z.string().describe('The effective current value: a configured preset key, `auto`, or `custom`.'),
+}).optional().describe('The session\'s current permission, folded from the three whole-value knob events (`permission/preset`, `sandbox/mode`, `approval/policy`) over the composition defaults. Selectable options come from the process-level catalog Remote. Key absence means no permission service is composed — clients hide the control.'),
+  'subagentCatalog': z.array(z.union([z.object({
+  'id': z.string().readonly(),
+  'createdAt': z.number().readonly(),
+  'mode': z.literal("one-shot").readonly(),
+  'label': z.string().readonly().optional(),
+}), z.object({
+  'id': z.string().readonly(),
+  'createdAt': z.number().readonly(),
+  'mode': z.literal("external").readonly(),
+  'label': z.string().readonly().optional(),
+}), z.object({
+  'id': z.string().readonly(),
+  'createdAt': z.number().readonly(),
+  'mode': z.literal("continuable").readonly(),
+  'label': z.string().readonly(),
+}), z.object({
+  'id': z.string().readonly(),
+  'createdAt': z.number().readonly(),
+  'mode': z.literal("unknown").readonly(),
+  'label': z.string().readonly().optional(),
+})])).optional().describe('Direct children in parent catalog event order, excluding fork-inherited facts.'),
+  'subagentTiming': z.object({
+  'settledMs': z.number().describe('Milliseconds accumulated across completed turns after the child\'s own descriptor.'),
+  'active': z.object({
+  'since': z.number().describe('Start of the open turn.'),
+  'through': z.number().describe('Latest event time folded into this projection cut.'),
+}).optional().describe('Same-cut bounds of the currently open turn, when one has not reached `turn/end`.'),
+  'lastTurnCompleted': z.boolean().optional().describe('Whether the latest closed turn after the child\'s own descriptor completed normally; absent while a turn is open or before one closes.'),
+}).optional().describe('Active-turn duration and latest closed-turn completion for a descriptor-backed subagent session.'),
+  'subagent': z.union([z.literal(null), z.object({
+  'mode': z.literal("one-shot").describe('A terminal one-shot child.'),
+  'label': z.string().optional().describe('Optional durable creation label from the child\'s descriptor.'),
+  'seq': z.number().describe('Seq of the `subagent/descriptor` event this identity was folded from. `session.isOwnSeq(seq)` proves the identity comes from the child\'s OWN log suffix — where a descriptor is immutable once appended — and not from a fork seed\'s replayed ancestor descriptor.'),
+}), z.object({
+  'mode': z.literal("continuable").describe('A resumable conversation.'),
+  'label': z.string().describe('Durable creation label from the child\'s descriptor.'),
+  'seq': z.number().describe('Seq of the folded descriptor event; see the one-shot arm for the own-suffix proof.'),
+})]).optional().describe('Identity of a descriptor-backed subagent session. `null` ⟺ no valid descriptor (missing, malformed, or unrecognized-version — deliberately undistinguished). The sentinel is deliberately serializable: a value pushed over JSON transports must survive `JSON.stringify` losslessly, where an `undefined` field would be dropped and a stale identity would survive on the receiving side. The entry itself stays non-optional.'),
+  'tokenUsage': z.object({
+  'uncachedInputTokens': z.number(),
+  'outputTokens': z.number(),
+  'cacheReadTokens': z.number(),
+  'cacheWriteTokens': z.number(),
+}).optional().describe('Provider-reported usage accumulated across the complete durable log.'),
+  'contextPressure': z.object({
+  'pressureTokens': z.number().optional().describe('Provider-reported prompt size of the most recent request: uncached input plus cache reads and writes. Response output is excluded, so this does not grow as the current turn streams. Absent until a provider reports usage.'),
+  'projectedTokens': z.number().optional().describe('What the NEXT request\'s prompt would cost: {@link pressureTokens} plus the heuristic repricing of everything the surface gained or lost since that sample. Only the delta is estimated, so the figure stays anchored to the provider while still reacting the moment a compaction shadows a span — which `pressureTokens` alone cannot do, since compaction reports no usage of its own. Absent until a provider reports usage.'),
+  'contextWindow': z.number().optional().describe('Newest recorded route capacity; absent when no adapter advertised one.'),
+}).optional().describe('Newest request pressure paired with the newest known route capacity.'),
+  'contextBreakdown': z.object({
+  'systemTokens': z.number().describe('Heuristic tokens of the last nonempty surviving system prompt in surface order; 0 when none exists.'),
+  'toolsTokens': z.number().describe('Heuristic tokens of the newest request envelope\'s tool schemas; 0 before any request.'),
+  'messageTokens': z.number().describe('Heuristic tokens of every other visible surface node, including superseded system prompts.'),
+}).optional().describe('Heuristic system/tools/message composition of the next request.'),
+  'agentTeam': z.object({
+  'members': z.array(z.object({
+  'id': z.string().readonly(),
+  'name': z.string().readonly(),
+  'role': z.union([z.literal("lead"), z.literal("teammate")]).readonly(),
+  'phase': z.union([z.literal("failed"), z.literal("provisioning"), z.literal("active")]).readonly().describe('Durable lifecycle; the Lead row is always `active`. Turn activity comes from Session status.'),
+  'error': z.string().readonly().optional(),
 })).readonly(),
+  'tasks': z.array(z.object({
+  'id': z.string().readonly(),
+  'revision': z.number().readonly(),
+  'subject': z.string().readonly(),
+  'description': z.string().readonly(),
+  'status': z.union([z.literal("completed"), z.literal("pending"), z.literal("in_progress"), z.literal("deleted")]).readonly(),
+  'blockedBy': z.array(z.string()).readonly(),
+  'writeScopes': z.array(z.string()).readonly(),
+  'ownerName': z.string().readonly().optional(),
+  'ready': z.boolean().readonly(),
+  'writeScopeWarnings': z.array(z.string()).readonly(),
 })).readonly(),
-}).optional(),
+  'failure': z.string().readonly().optional(),
+}).optional().describe('Durable roster and non-deleted task board of the Team rooted at the projected Session.'),
+  'userQuestions': z.object({
+  'active': z.array(z.object({
+  'callId': z.string().readonly(),
+  'questions': z.array(z.object({
+  'id': z.string().describe('Stable caller-provided question id, echoed in the answer.'),
+  'question': z.string().describe('The question to display.'),
+  'detail': z.string().optional().describe('Optional supporting detail rendered with the question but kept out of option labels.'),
+  'header': z.string().optional().describe('Optional short heading/group label.'),
+  'options': z.array(z.object({
+  'label': z.string().describe('User-facing label.'),
+  'description': z.string().optional().describe('Optional extra context rendered by capable UIs.'),
+})).optional().describe('Optional choices the UI can render as a menu.'),
+  'multiSelect': z.boolean().optional().describe('Whether more than one option may be selected. Defaults to single-select.'),
+  'intent': z.object({
+  'kind': z.literal("plan-review").describe('A plan submitted for review: `detail` is the plan markdown `ask()` requires, and the decision approves or declines it.'),
+  'approve': z.string().describe('The option label that approves the plan; every other option declines it. Named rather than positional so no UI infers the verdict from option order. An `approve` naming no option of its own question is rejected at `ask()`.'),
+  'callId': z.string().optional().describe('Logged tool invocation whose arguments contain the reviewed plan.'),
+}).optional().describe('Optional presentation intent for capable UIs; absent asks for the generic option list.'),
+})).readonly(),
+  'state': z.union([z.literal("open"), z.literal("continued")]).readonly(),
+})).readonly().describe('Calls that can still take an answer, in ask order.'),
+  'settled': z.array(z.object({
+  'callId': z.string().readonly().describe('The settled call.'),
+  'answers': z.array(z.object({
+  'id': z.string().describe('The answered question id.'),
+  'selected': z.array(z.string()).describe('Selected option labels. May accompany custom text for a multi-select question.'),
+  'custom': z.string().optional().describe('Optional free-text "Other" answer.'),
+})).readonly().describe('The recorded batch, one entry per question; empty when the late reply carried none.'),
+})).readonly().describe('Calls an answer settled, in settlement order.'),
+}).optional().describe('Timed questions that remain answerable in this Session, and the ones a late reply settled.'),
   'goal': z.union([z.literal(null), z.object({
   'goal': z.object({
-  'objective': z.string().readonly(),
-  'phase': z.union([z.literal("active"), z.literal("paused"), z.literal("blocked"), z.literal("complete")]).readonly(),
+  'objective': z.string().readonly().describe('Human-requested completion objective.'),
+  'phase': z.union([z.literal("active"), z.literal("paused"), z.literal("blocked"), z.literal("complete")]).readonly().describe('Durable lifecycle phase.'),
   'blockedReason': z.object({
-  'code': z.string().readonly(),
-  'message': z.string().readonly(),
-}).readonly().optional(),
-  'maxGoalRounds': z.number().readonly(),
-  'id': z.intersection(z.string(), z.unknown()).readonly(),
-  'revision': z.number().readonly(),
-}).readonly(),
-  'roundsStarted': z.number().readonly(),
-  'createdAt': z.number().readonly(),
-  'updatedAt': z.number().readonly(),
-})]).optional(),
-}), z.record(z.string(), z.union([z.literal(null), z.string(), z.number(), z.literal(false), z.literal(true), z.array(z.lazy(() => JsonValueRemoteCodec$schema4())), z.record(z.string(), z.lazy(() => JsonValueRemoteCodec$schema4()))])).readonly()).readonly(),
+  'code': z.string().readonly().describe('Stable lower-kebab-case classification chosen by the blocking policy.'),
+  'message': z.string().readonly().describe('Non-empty explanation shown to humans and models.'),
+}).readonly().optional().describe('Present exactly while `phase` is `blocked`.'),
+  'maxGoalRounds': z.number().readonly().describe('Total admitted goal-round cap.'),
+  'id': z.string().readonly().describe('Stable goal identity.'),
+  'revision': z.number().readonly().describe('Positive revision; every durable mutation increments it.'),
+}).readonly().describe('Current durable goal snapshot (the CAS ref for mutations rides on it).'),
+  'roundsStarted': z.number().readonly().describe('Highest admitted round number for this goal.'),
+  'createdAt': z.number().readonly().describe('Epoch milliseconds of the create mutation.'),
+  'updatedAt': z.number().readonly().describe('Epoch milliseconds of the latest mutation.'),
+})]).optional().describe('The session\'s current goal and admitted-round count, or `null` before the first create and after a clear tombstone. `goal/change` supplies the whole lifecycle value; matching admitted `user/message` events advance `roundsStarted`.'),
+  'plan': z.object({
+  'active': z.boolean(),
+  'pending': z.boolean(),
+}).optional().describe('Plan collaboration state folded from the plan command lifecycle and `plan/mode` events.'),
+}), z.record(z.string(), z.json()).readonly()).readonly(),
 })]))
 let _deepseek_ai_dsh_api_session_controller_session_prompt_parameter_0$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_prompt_parameter_0$schema = () => (_deepseek_ai_dsh_api_session_controller_session_prompt_parameter_0$schema$value ??= z.object({
-  'requestId': z.intersection(z.string(), z.unknown()).readonly(),
-  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
+  'requestId': z.string().readonly().describe('Client-minted identity persisted on the exact accepted user message.'),
+  'sessionId': z.string().readonly(),
   'mode': z.union([z.literal("queue"), z.literal("steer")]).readonly(),
   'content': z.array(z.union([z.object({
   'type': z.literal("text").readonly(),
@@ -859,8 +1137,8 @@ const _deepseek_ai_dsh_api_session_controller_session_prompt_parameter_0$schema
   'name': z.string().readonly().optional(),
 }), z.object({
   'type': z.literal("file").readonly(),
-  'receiptId': z.intersection(z.string(), z.unknown()).readonly(),
-})])).readonly(),
+  'receiptId': z.string().readonly(),
+})])).readonly().describe('At least one non-whitespace text part or attachment.'),
   'clientTimeZone': z.string().readonly().optional(),
 }))
 let _deepseek_ai_dsh_api_session_controller_session_prompt_result$schema$value
@@ -869,7 +1147,7 @@ const _deepseek_ai_dsh_api_session_controller_session_prompt_result$schema = ()
 }))
 let _deepseek_ai_dsh_api_session_controller_session_rename_parameter_0$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_rename_parameter_0$schema = () => (_deepseek_ai_dsh_api_session_controller_session_rename_parameter_0$schema$value ??= z.object({
-  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
+  'sessionId': z.string().readonly(),
   'title': z.string().readonly(),
 }))
 let _deepseek_ai_dsh_api_session_controller_session_rename_result$schema$value
@@ -884,14 +1162,14 @@ const _deepseek_ai_dsh_api_session_controller_session_search_parameter_0$schema
 let _deepseek_ai_dsh_api_session_controller_session_search_result$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_search_result$schema = () => (_deepseek_ai_dsh_api_session_controller_session_search_result$schema$value ??= z.object({
   'items': z.array(z.object({
-  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
+  'sessionId': z.string().readonly(),
   'snippet': z.string().readonly(),
 })).readonly(),
   'hasMore': z.boolean().readonly(),
 }))
 let _deepseek_ai_dsh_api_session_controller_session_selectModel_parameter_0$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_selectModel_parameter_0$schema = () => (_deepseek_ai_dsh_api_session_controller_session_selectModel_parameter_0$schema$value ??= z.object({
-  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
+  'sessionId': z.string().readonly(),
   'provider': z.string().readonly(),
   'model': z.string().readonly(),
   'reasoningEffort': z.string().readonly().optional(),
@@ -906,14 +1184,14 @@ const _deepseek_ai_dsh_api_session_controller_session_selectModel_result$schema
 }))
 let _deepseek_ai_dsh_api_session_controller_session_updateQueue_parameter_0$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_updateQueue_parameter_0$schema = () => (_deepseek_ai_dsh_api_session_controller_session_updateQueue_parameter_0$schema$value ??= z.object({
-  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
-  'itemId': z.intersection(z.string(), z.unknown()).readonly(),
+  'sessionId': z.string().readonly(),
+  'itemId': z.string().readonly(),
   'action': z.union([z.object({
   'kind': z.literal("edit").readonly(),
   'content': z.array(z.object({
   'type': z.literal("text"),
   'text': z.string(),
-})).readonly(),
+})).readonly().describe('Non-empty text-only replacement content.'),
 }), z.object({
   'kind': z.literal("remove").readonly(),
 }), z.object({
@@ -930,34 +1208,168 @@ const _deepseek_ai_dsh_api_session_controller_session_workspacePathApplications_
 }))
 let _deepseek_ai_dsh_api_session_controller_session_workspacePathApplications_result$schema$value
 const _deepseek_ai_dsh_api_session_controller_session_workspacePathApplications_result$schema = () => (_deepseek_ai_dsh_api_session_controller_session_workspacePathApplications_result$schema$value ??= z.array(z.object({
-  'id': z.string().readonly(),
+  'id': z.string().readonly().describe('OS application identifier; callers must revalidate it against the file\'s current handlers before opening.'),
   'name': z.string().readonly(),
   'default': z.boolean().readonly(),
-  'icon': z.union([z.literal(null), z.string()]).readonly(),
+  'icon': z.union([z.literal(null), z.string()]).readonly().describe('PNG or SVG data URL, or null when the desktop supplies no icon.'),
 })))
 let _deepseek_ai_dsh_api_session_controller_skills_list_parameter_0$schema$value
 const _deepseek_ai_dsh_api_session_controller_skills_list_parameter_0$schema = () => (_deepseek_ai_dsh_api_session_controller_skills_list_parameter_0$schema$value ??= z.object({
-  'sessionId': z.intersection(z.string(), z.unknown()).readonly(),
+  'sessionId': z.string().readonly(),
 }))
 let _deepseek_ai_dsh_api_session_controller_skills_list_result$schema$value
 const _deepseek_ai_dsh_api_session_controller_skills_list_result$schema = () => (_deepseek_ai_dsh_api_session_controller_skills_list_result$schema$value ??= z.object({
   'skills': z.array(z.object({
-  'path': z.string().readonly().optional(),
-  'name': z.string().readonly(),
-  'description': z.string().readonly(),
-  'whenToUse': z.string().readonly().optional(),
-  'modelInvocable': z.boolean().readonly(),
+  'path': z.string().readonly().optional().describe('Absolute SKILL.md path when supplied by a filesystem provider.'),
+  'name': z.string().readonly().describe('Kebab-case identifier referenced as `/name`.'),
+  'description': z.string().readonly().describe('Short routing description.'),
+  'whenToUse': z.string().readonly().optional().describe('Optional extra routing guidance.'),
+  'modelInvocable': z.boolean().readonly().describe('Whether the same skill is also advertised to the model.'),
 })).readonly(),
 }))
+let _deepseek_ai_dsh_api_session_controller_fileReferences_list_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_api_session_controller_fileReferences_list_parameter_0_strict$schema = () => (_deepseek_ai_dsh_api_session_controller_fileReferences_list_parameter_0_strict$schema$value ??= z.string())
+let _deepseek_ai_dsh_api_session_controller_fileReferences_list_parameter_1_strict$schema$value
+const _deepseek_ai_dsh_api_session_controller_fileReferences_list_parameter_1_strict$schema = () => (_deepseek_ai_dsh_api_session_controller_fileReferences_list_parameter_1_strict$schema$value ??= z.string())
+let _deepseek_ai_dsh_api_session_controller_session_attachment_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_api_session_controller_session_attachment_parameter_0_strict$schema = () => (_deepseek_ai_dsh_api_session_controller_session_attachment_parameter_0_strict$schema$value ??= z.strictObject({
+  'sessionId': z.string().readonly(),
+  'attachmentId': z.string().readonly(),
+}))
+let _deepseek_ai_dsh_api_session_controller_session_cancel_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_api_session_controller_session_cancel_parameter_0_strict$schema = () => (_deepseek_ai_dsh_api_session_controller_session_cancel_parameter_0_strict$schema$value ??= z.strictObject({
+  'sessionId': z.string().readonly(),
+}))
+let _deepseek_ai_dsh_api_session_controller_session_create_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_api_session_controller_session_create_parameter_0_strict$schema = () => (_deepseek_ai_dsh_api_session_controller_session_create_parameter_0_strict$schema$value ??= z.strictObject({
+  'workspaceId': z.string().readonly().optional().describe('Workspace the Session joins; exclusive with `cwd`.'),
+  'cwd': z.string().readonly().optional().describe('Directory the Session owns when no Workspace is named.'),
+  'sessionId': z.string().readonly().optional().describe('Blank Session to reuse while it is reusable, or the identity of a new Session when none is stored under it.'),
+  'agentPreset': z.string().readonly().optional().describe('Preset the Session runs, replacing a reused Session\'s recorded preset; the configured default when omitted.'),
+}))
+let _deepseek_ai_dsh_api_session_controller_session_follow_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_api_session_controller_session_follow_parameter_0_strict$schema = () => (_deepseek_ai_dsh_api_session_controller_session_follow_parameter_0_strict$schema$value ??= z.strictObject({
+  'address': z.union([z.strictObject({
+  'kind': z.literal("session").readonly(),
+  'sessionId': z.string().readonly(),
+}), z.strictObject({
+  'kind': z.literal("subagent").readonly(),
+  'parentSessionId': z.string().readonly(),
+  'childSessionId': z.string().readonly(),
+  'mode': z.union([z.literal("one-shot"), z.literal("continuable"), z.literal("unknown")]).readonly(),
+})]).readonly(),
+  'assistantStream': z.literal(true).readonly().optional().describe('Include process-local assistant presentation frames for the Web client.'),
+  'maxMessages': z.number().readonly().optional(),
+  'turnWindow': z.strictObject({
+  'minMessages': z.number().readonly().describe('Minimum append-origin user/assistant messages; must not exceed maxMessages.'),
+  'minTurns': z.number().readonly().describe('Minimum Turn starts crossed, including the partial Turn at beforeSeq.'),
+}).readonly().optional().describe('Stop at a Turn start after both minima, unless maxMessages or history exhaustion wins.'),
+}))
+let _deepseek_ai_dsh_api_session_controller_session_fork_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_api_session_controller_session_fork_parameter_0_strict$schema = () => (_deepseek_ai_dsh_api_session_controller_session_fork_parameter_0_strict$schema$value ??= z.strictObject({
+  'sessionId': z.string().readonly(),
+  'atSeq': z.number().readonly().optional().describe('Exact inclusive source event seq; omission selects the latest completed-turn prefix.'),
+  'allowMigration': z.boolean().readonly().optional().describe('False asks the Host to check for required migration before forking. Defaults to true.'),
+}))
+let _deepseek_ai_dsh_api_session_controller_session_list_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_api_session_controller_session_list_parameter_0_strict$schema = () => (_deepseek_ai_dsh_api_session_controller_session_list_parameter_0_strict$schema$value ??= z.strictObject({
+  'cursor': z.string().readonly().optional(),
+}))
+let _deepseek_ai_dsh_api_session_controller_session_openWorkspacePath_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_api_session_controller_session_openWorkspacePath_parameter_0_strict$schema = () => (_deepseek_ai_dsh_api_session_controller_session_openWorkspacePath_parameter_0_strict$schema$value ??= z.strictObject({
+  'action': z.literal("reveal").readonly().optional().describe('File-manager navigation when requested; omission uses the default application.'),
+  'application': z.string().readonly().optional().describe('Registered application identifier; ignored for reveal. Omission preserves the operating system default.'),
+  'path': z.string().readonly().describe('Path after best-effort Session workspace resolution, in Host filesystem syntax.'),
+}))
+let _deepseek_ai_dsh_api_session_controller_session_page_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_api_session_controller_session_page_parameter_0_strict$schema = () => (_deepseek_ai_dsh_api_session_controller_session_page_parameter_0_strict$schema$value ??= z.strictObject({
+  'address': z.union([z.strictObject({
+  'kind': z.literal("session").readonly(),
+  'sessionId': z.string().readonly(),
+}), z.strictObject({
+  'kind': z.literal("subagent").readonly(),
+  'parentSessionId': z.string().readonly(),
+  'childSessionId': z.string().readonly(),
+  'mode': z.union([z.literal("one-shot"), z.literal("continuable"), z.literal("unknown")]).readonly(),
+})]).readonly(),
+  'throughSeq': z.number().readonly().describe('Inclusive log cut obtained from the corresponding follow opening frame.'),
+  'beforeSeq': z.number().readonly().optional(),
+  'maxMessages': z.number().readonly().optional(),
+  'turnWindow': z.strictObject({
+  'minMessages': z.number().readonly().describe('Minimum append-origin user/assistant messages; must not exceed maxMessages.'),
+  'minTurns': z.number().readonly().describe('Minimum Turn starts crossed, including the partial Turn at beforeSeq.'),
+}).readonly().optional().describe('Stop at a Turn start after both minima, unless maxMessages or history exhaustion wins.'),
+}))
+let _deepseek_ai_dsh_api_session_controller_session_projections_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_api_session_controller_session_projections_parameter_0_strict$schema = () => (_deepseek_ai_dsh_api_session_controller_session_projections_parameter_0_strict$schema$value ??= z.strictObject({
+  'sessionId': z.string().readonly(),
+}))
+let _deepseek_ai_dsh_api_session_controller_session_prompt_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_api_session_controller_session_prompt_parameter_0_strict$schema = () => (_deepseek_ai_dsh_api_session_controller_session_prompt_parameter_0_strict$schema$value ??= z.strictObject({
+  'requestId': z.string().readonly().describe('Client-minted identity persisted on the exact accepted user message.'),
+  'sessionId': z.string().readonly(),
+  'mode': z.union([z.literal("queue"), z.literal("steer")]).readonly(),
+  'content': z.array(z.union([z.strictObject({
+  'type': z.literal("text").readonly(),
+  'text': z.string().readonly(),
+}), z.strictObject({
+  'type': z.literal("image").readonly(),
+  'mediaType': z.union([z.literal("image/png"), z.literal("image/jpeg"), z.literal("image/webp"), z.literal("image/gif")]).readonly(),
+  'data': z.string().readonly(),
+  'name': z.string().readonly().optional(),
+}), z.strictObject({
+  'type': z.literal("file").readonly(),
+  'receiptId': z.string().readonly(),
+})])).readonly().describe('At least one non-whitespace text part or attachment.'),
+  'clientTimeZone': z.string().readonly().optional(),
+}))
+let _deepseek_ai_dsh_api_session_controller_session_rename_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_api_session_controller_session_rename_parameter_0_strict$schema = () => (_deepseek_ai_dsh_api_session_controller_session_rename_parameter_0_strict$schema$value ??= z.strictObject({
+  'sessionId': z.string().readonly(),
+  'title': z.string().readonly(),
+}))
+let _deepseek_ai_dsh_api_session_controller_session_search_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_api_session_controller_session_search_parameter_0_strict$schema = () => (_deepseek_ai_dsh_api_session_controller_session_search_parameter_0_strict$schema$value ??= z.strictObject({
+  'query': z.string().readonly(),
+}))
+let _deepseek_ai_dsh_api_session_controller_session_selectModel_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_api_session_controller_session_selectModel_parameter_0_strict$schema = () => (_deepseek_ai_dsh_api_session_controller_session_selectModel_parameter_0_strict$schema$value ??= z.strictObject({
+  'sessionId': z.string().readonly(),
+  'provider': z.string().readonly(),
+  'model': z.string().readonly(),
+  'reasoningEffort': z.string().readonly().optional(),
+}))
+let _deepseek_ai_dsh_api_session_controller_session_updateQueue_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_api_session_controller_session_updateQueue_parameter_0_strict$schema = () => (_deepseek_ai_dsh_api_session_controller_session_updateQueue_parameter_0_strict$schema$value ??= z.strictObject({
+  'sessionId': z.string().readonly(),
+  'itemId': z.string().readonly(),
+  'action': z.union([z.strictObject({
+  'kind': z.literal("edit").readonly(),
+  'content': z.array(z.strictObject({
+  'type': z.literal("text"),
+  'text': z.string(),
+})).readonly().describe('Non-empty text-only replacement content.'),
+}), z.strictObject({
+  'kind': z.literal("remove").readonly(),
+}), z.strictObject({
+  'kind': z.literal("steer").readonly(),
+})]).readonly(),
+}))
+let _deepseek_ai_dsh_api_session_controller_session_workspacePathApplications_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_api_session_controller_session_workspacePathApplications_parameter_0_strict$schema = () => (_deepseek_ai_dsh_api_session_controller_session_workspacePathApplications_parameter_0_strict$schema$value ??= z.strictObject({
+  'path': z.string().readonly(),
+}))
+let _deepseek_ai_dsh_api_session_controller_skills_list_parameter_0_strict$schema$value
+const _deepseek_ai_dsh_api_session_controller_skills_list_parameter_0_strict$schema = () => (_deepseek_ai_dsh_api_session_controller_skills_list_parameter_0_strict$schema$value ??= z.strictObject({
+  'sessionId': z.string().readonly(),
+}))
 
-export const TYPERT_REMOTE = {
+export const TYPERT_REMOTE = createTypertRemoteInfo({
   package: '@deepseek-ai/dsh-api-session-controller',
-  descriptors: [
-    {
-      id: '@deepseek-ai/dsh-api-session-controller#fileReferences/list',
+  methods: {
+    'fileReferences/list': {
       service: 'sessionFileReferences',
-      namespace: 'fileReferences',
-      method: 'list',
+      description: 'List file and directory candidates for one Agent\'s working directory.',
       invocation: { kind: 'direct' },
       scope: {
         context: 'agent',
@@ -967,22 +1379,37 @@ export const TYPERT_REMOTE = {
         {
           name: 'agent',
           wire: 'agentId',
+          description: 'target Agent resolved from the Session identity on the wire.',
           source: 'lookup',
           lookup: 'agent',
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
             create: _deepseek_ai_dsh_api_session_controller_fileReferences_list_parameter_0$schema,
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-session/types#SessionId',
+            create: _deepseek_ai_dsh_api_session_controller_fileReferences_list_parameter_0_strict$schema,
+            jsonSchema: {"type":"string"},
           },
         },
         {
           name: 'query',
-          wire: 'query',
+          description: 'path text following `@` or `@"`.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-session-controller#fileReferences/list:query',
             create: _deepseek_ai_dsh_api_session_controller_fileReferences_list_parameter_1$schema,
+            jsonSchema: {"type":"string"},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-session-controller#fileReferences/list:query',
+            create: _deepseek_ai_dsh_api_session_controller_fileReferences_list_parameter_1_strict$schema,
+            jsonSchema: {"type":"string"},
           },
         },
       ],
@@ -991,24 +1418,31 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-session-controller#fileReferences/list:result',
         create: _deepseek_ai_dsh_api_session_controller_fileReferences_list_result$schema,
+        description: 'deterministic path-only candidates from the composed provider.',
+        jsonSchema: {"type":"array","items":{"type":"object","properties":{"path":{"type":"string","description":"User-facing path accepted by normal prompts and filesystem tools."},"kind":{"type":"string","enum":["file","directory"],"description":"Directories keep completion open; files finish the mention."}},"required":["path","kind"],"additionalProperties":true}},
       },
       sourceLocation: {"file":"packages/api/session-controller/src/file-references.ts","line":33,"column":3},
     },
-    {
-      id: '@deepseek-ai/dsh-api-session-controller#session/attachment',
+    'session/attachment': {
       service: 'sessionController',
-      namespace: 'session',
-      method: 'attachment',
+      description: 'Read one image proven reachable from the addressed Session log.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
+          description: 'Session and attachment identities used for authorization.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionAttachmentRequest',
             create: _deepseek_ai_dsh_api_session_controller_session_attachment_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string"},"attachmentId":{"type":"string"}},"required":["sessionId","attachmentId"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionAttachmentRequest',
+            create: _deepseek_ai_dsh_api_session_controller_session_attachment_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string"},"attachmentId":{"type":"string"}},"required":["sessionId","attachmentId"],"additionalProperties":false},
           },
         },
       ],
@@ -1016,24 +1450,31 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionAttachmentValue',
         create: _deepseek_ai_dsh_api_session_controller_session_attachment_result$schema,
+        description: 'the durable attachment reference and base64-encoded bytes.',
+        jsonSchema: {"type":"object","properties":{"attachment":{"type":"object","properties":{"attachmentId":{"type":"string","description":"Opaque storage identifier; never a filesystem path or bearer URL."},"mediaType":{"type":"string","enum":["image/png","image/jpeg","image/webp","image/gif"],"description":"Media type verified from the stored bytes."},"bytes":{"type":"number","description":"Exact encoded byte length."},"width":{"type":"number","description":"Intrinsic encoded width in pixels."},"height":{"type":"number","description":"Intrinsic encoded height in pixels."},"name":{"type":"string","description":"Optional display name stripped of local path information."},"originalDimensions":{"type":"object","properties":{"width":{"type":"number"},"height":{"type":"number"}},"required":["width","height"],"additionalProperties":true,"description":"Input dimensions after applying EXIF orientation and before normalization scaling. Present only when normalization reduced the image."}},"required":["attachmentId","mediaType","bytes","width","height"],"additionalProperties":true},"data":{"type":"string"}},"required":["attachment","data"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":444,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":494,"column":3},
     },
-    {
-      id: '@deepseek-ai/dsh-api-session-controller#session/cancel',
+    'session/cancel': {
       service: 'sessionController',
-      namespace: 'session',
-      method: 'cancel',
+      description: 'Cancel one active Agent turn without dropping its pending inbox.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
+          description: 'Session whose active Agent turn is cancelled.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionCancelRequest',
             create: _deepseek_ai_dsh_api_session_controller_session_cancel_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string"}},"required":["sessionId"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionCancelRequest',
+            create: _deepseek_ai_dsh_api_session_controller_session_cancel_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string"}},"required":["sessionId"],"additionalProperties":false},
           },
         },
       ],
@@ -1041,14 +1482,14 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionCancelValue',
         create: _deepseek_ai_dsh_api_session_controller_session_cancel_result$schema,
+        description: 'acknowledgement that cancellation was requested.',
+        jsonSchema: {"type":"object","properties":{"accepted":{"type":"boolean","const":true}},"required":["accepted"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":464,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":514,"column":3},
     },
-    {
-      id: '@deepseek-ai/dsh-api-session-controller#session/canOpenWorkspacePath',
+    'session/canOpenWorkspacePath': {
       service: 'sessionController',
-      namespace: 'session',
-      method: 'canOpenWorkspacePath',
+      description: 'Report whether this deployment can hand a Session workspace path to a native desktop.',
       invocation: { kind: 'direct' },
       parameters: [
       ],
@@ -1056,14 +1497,14 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-session-controller#session/canOpenWorkspacePath:result',
         create: _deepseek_ai_dsh_api_session_controller_session_canOpenWorkspacePath_result$schema,
+        description: 'true when the matching open operation is available.',
+        jsonSchema: {"type":"boolean"},
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":326,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":347,"column":3},
     },
-    {
-      id: '@deepseek-ai/dsh-api-session-controller#session/control',
+    'session/control': {
       service: 'sessionController',
-      namespace: 'session',
-      method: 'control',
+      description: 'Stream a complete live-control baseline followed by replacement frames.',
       mode: 'stream',
       invocation: { kind: 'direct' },
       parameters: [
@@ -1073,24 +1514,31 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionControlFrame',
         create: _deepseek_ai_dsh_api_session_controller_session_control_result$schema,
+        description: 'one complete baseline followed by live replacement frames.',
+        jsonSchemaError: 'typert tool schema: selected dictionaries require string keys and unconstrained JSON values',
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":527,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":599,"column":10},
     },
-    {
-      id: '@deepseek-ai/dsh-api-session-controller#session/create',
+    'session/create': {
       service: 'sessionController',
-      namespace: 'session',
-      method: 'create',
+      description: 'Create one ordinary Session for a new conversation, reusing the named blank Session while it is reusable.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
+          description: 'optional blank Session to reuse, location, and Agent preset.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionCreateRequest',
             create: _deepseek_ai_dsh_api_session_controller_session_create_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"workspaceId":{"type":"string","description":"Workspace the Session joins; exclusive with `cwd`."},"cwd":{"type":"string","description":"Directory the Session owns when no Workspace is named."},"sessionId":{"type":"string","description":"Blank Session to reuse while it is reusable, or the identity of a new Session when none is stored under it."},"agentPreset":{"type":"string","description":"Preset the Session runs, replacing a reused Session's recorded preset; the configured default when omitted."}},"required":[],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionCreateRequest',
+            create: _deepseek_ai_dsh_api_session_controller_session_create_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"workspaceId":{"type":"string","description":"Workspace the Session joins; exclusive with `cwd`."},"cwd":{"type":"string","description":"Directory the Session owns when no Workspace is named."},"sessionId":{"type":"string","description":"Blank Session to reuse while it is reusable, or the identity of a new Session when none is stored under it."},"agentPreset":{"type":"string","description":"Preset the Session runs, replacing a reused Session's recorded preset; the configured default when omitted."}},"required":[],"additionalProperties":false},
           },
         },
       ],
@@ -1098,25 +1546,32 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionCreateValue',
         create: _deepseek_ai_dsh_api_session_controller_session_create_result$schema,
+        description: 'the created or reused Session identity and its preset when configured.',
+        jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string","description":"The created or reused Session, which may differ from the requested `sessionId`."},"agentPreset":{"type":"string","description":"Preset the Session runs, when the deployment composes a preset roster."}},"required":["sessionId"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":280,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":301,"column":3},
     },
-    {
-      id: '@deepseek-ai/dsh-api-session-controller#session/follow',
+    'session/follow': {
       service: 'sessionController',
-      namespace: 'session',
-      method: 'follow',
+      description: 'Follow one Session log from its opening or resume cursor.',
       mode: 'stream',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
+          description: 'durable address and last committed sequence already held by the caller.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionFollowRequest',
             create: _deepseek_ai_dsh_api_session_controller_session_follow_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"address":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"session"},"sessionId":{"type":"string"}},"required":["kind","sessionId"],"additionalProperties":true},{"type":"object","properties":{"kind":{"type":"string","const":"subagent"},"parentSessionId":{"type":"string"},"childSessionId":{"type":"string"},"mode":{"type":"string","enum":["one-shot","continuable","unknown"]}},"required":["kind","parentSessionId","childSessionId","mode"],"additionalProperties":true}]},"assistantStream":{"type":"boolean","const":true,"description":"Include process-local assistant presentation frames for the Web client."},"maxMessages":{"type":"number"},"turnWindow":{"type":"object","properties":{"minMessages":{"type":"number","description":"Minimum append-origin user/assistant messages; must not exceed maxMessages."},"minTurns":{"type":"number","description":"Minimum Turn starts crossed, including the partial Turn at beforeSeq."}},"required":["minMessages","minTurns"],"additionalProperties":true,"description":"Stop at a Turn start after both minima, unless maxMessages or history exhaustion wins."}},"required":["address"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionFollowRequest',
+            create: _deepseek_ai_dsh_api_session_controller_session_follow_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"address":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"session"},"sessionId":{"type":"string"}},"required":["kind","sessionId"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"subagent"},"parentSessionId":{"type":"string"},"childSessionId":{"type":"string"},"mode":{"type":"string","enum":["one-shot","continuable","unknown"]}},"required":["kind","parentSessionId","childSessionId","mode"],"additionalProperties":false}]},"assistantStream":{"type":"boolean","const":true,"description":"Include process-local assistant presentation frames for the Web client."},"maxMessages":{"type":"number"},"turnWindow":{"type":"object","properties":{"minMessages":{"type":"number","description":"Minimum append-origin user/assistant messages; must not exceed maxMessages."},"minTurns":{"type":"number","description":"Minimum Turn starts crossed, including the partial Turn at beforeSeq."}},"required":["minMessages","minTurns"],"additionalProperties":false,"description":"Stop at a Turn start after both minima, unless maxMessages or history exhaustion wins."}},"required":["address"],"additionalProperties":false},
           },
         },
       ],
@@ -1125,24 +1580,31 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionFollowFrame',
         create: _deepseek_ai_dsh_api_session_controller_session_follow_result$schema,
+        description: 'a complete opening snapshot followed by gap-free durable event frames and optional cursorless assistant-stream frames.',
+        jsonSchema: {"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"event"},"event":{"type":"object","properties":{"type":{"type":"string"},"seq":{"type":"number"},"time":{"type":"number"},"data":{},"ignorable":{"type":"boolean","const":true},"sourceEventSeqs":{"description":"Earlier sources on current surface events; opaque JSON on unknown ignorable events."},"surfaceOp":{"description":"Canonical placement on current surface events; opaque JSON on unknown ignorable events."}},"required":["type","seq","time","data"],"additionalProperties":true}},"required":["type","event"],"additionalProperties":true},{"type":"object","properties":{"type":{"type":"string","const":"snapshot"},"header":{"type":"object","properties":{"version":{"type":"number"},"id":{"type":"string"},"createdAt":{"type":"number"},"cwd":{"type":"string"},"parentSession":{"type":"string"},"isSeeded":{"type":"boolean","description":"Whether the Session contains a fork-inherited prefix."},"origin":{"type":"string","const":"subagent"},"delegationDepth":{"type":"number"},"agentPreset":{"type":"string"}},"required":["version","id","createdAt","isSeeded"],"additionalProperties":true},"cursor":{"type":"number"},"records":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"event"},"event":{"type":"object","properties":{"type":{"type":"string"},"seq":{"type":"number"},"time":{"type":"number"},"data":{},"ignorable":{"type":"boolean","const":true},"sourceEventSeqs":{"description":"Earlier sources on current surface events; opaque JSON on unknown ignorable events."},"surfaceOp":{"description":"Canonical placement on current surface events; opaque JSON on unknown ignorable events."}},"required":["type","seq","time","data"],"additionalProperties":true}},"required":["type","event"],"additionalProperties":true}},"hasMore":{"type":"boolean"},"projections":{"type":"object","properties":{"asOfSeq":{"type":"number"},"values":{"type":"object","properties":{"inbox":{"type":"object","properties":{"next-turn":{"type":"array","items":{}},"next-step":{"type":"array","items":{}}},"required":["next-turn","next-step"],"additionalProperties":true,"description":"Pending agent input reconstructed from durable inbox splices."},"workingDirectory":{"oneOf":[{"type":"null","const":null},{"type":"string"}],"description":"Recorded current directory for Session observations, or null when none is recorded."},"agentPreset":{"oneOf":[{"type":"null","const":null},{"type":"string"}],"description":"Preset the Session runs, or null when the deployment composes none."},"title":{"oneOf":[{"type":"null","const":null},{"type":"string"}],"description":"The session's current normalized title — the latest `session/title` event's text (last-wins), or `null` before the first title lands. A plain string: the shape the client list rows consume."},"todos":{"oneOf":[{"type":"null","const":null},{"type":"array","items":{"type":"object","properties":{"content":{"type":"string","description":"What this task is — a short imperative line shown in the UI."},"status":{"type":"string","enum":["completed","pending","in_progress"],"description":"Lifecycle state. `in_progress` marks a task being worked now; parallel work may mark several."}},"required":["content","status"],"additionalProperties":true}}],"description":"The agent's current whole todo list (the latest `todo/write` snapshot), or `null` before the first write. Whole-value rule: every `todo/write` carries the complete replacement list, so the fold is last-wins."},"sessionListMetadata":{"type":"object","properties":{"blank":{"type":"boolean","description":"Whether the folded prefix contains no turn."},"lastPromptAt":{"oneOf":[{"type":"null","const":null},{"type":"number"}],"description":"Latest human-authored prompt time in the folded prefix."}},"required":["blank","lastPromptAt"],"additionalProperties":true,"description":"Persisted facts used to summarize a Session without activating it."},"imageLimits":{"type":"object","properties":{"maxImageBytes":{"type":"number"},"maxImagesPerMessage":{"type":"number"},"maxMessageImageBytes":{"type":"number"},"maxImagePixels":{"type":"number"},"maxImageDimension":{"type":"number","description":"Maximum intrinsic width and maximum intrinsic height in pixels for one image."},"mediaTypes":{"type":"array","items":{"type":"string","enum":["image/png","image/jpeg","image/webp","image/gif"]}}},"required":["maxImageBytes","maxImagesPerMessage","maxMessageImageBytes","maxImagePixels","maxImageDimension","mediaTypes"],"additionalProperties":true,"description":"Image-intake limits enforced by the Session prompt endpoint."},"modelSelection":{"type":"object","properties":{"lastUsed":{"oneOf":[{"type":"null","const":null},{"type":"object","properties":{"provider":{"type":"string"},"model":{"type":"string"},"reasoningEffort":{"type":"string"}},"required":["provider","model"],"additionalProperties":true}],"description":"Selection consumed by the latest recorded model request."},"next":{"oneOf":[{"type":"null","const":null},{"type":"object","properties":{"provider":{"type":"string"},"model":{"type":"string"},"reasoningEffort":{"type":"string"}},"required":["provider","model"],"additionalProperties":true}],"description":"Selection the next request should use, falling back to {@link lastUsed}."}},"required":["lastUsed","next"],"additionalProperties":true,"description":"Durable model selection already used and selected for the next request."},"permissions":{"type":"object","properties":{"currentValue":{"type":"string","description":"The effective current value: a configured preset key, `auto`, or `custom`."}},"required":["currentValue"],"additionalProperties":true,"description":"The session's current permission, folded from the three whole-value knob events (`permission/preset`, `sandbox/mode`, `approval/policy`) over the composition defaults. Selectable options come from the process-level catalog Remote. Key absence means no permission service is composed — clients hide the control."},"subagentCatalog":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"number"},"mode":{"type":"string","const":"one-shot"},"label":{"type":"string"}},"required":["id","createdAt","mode"],"additionalProperties":true},{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"number"},"mode":{"type":"string","const":"external"},"label":{"type":"string"}},"required":["id","createdAt","mode"],"additionalProperties":true},{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"number"},"mode":{"type":"string","const":"continuable"},"label":{"type":"string"}},"required":["id","createdAt","mode","label"],"additionalProperties":true},{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"number"},"mode":{"type":"string","const":"unknown"},"label":{"type":"string"}},"required":["id","createdAt","mode"],"additionalProperties":true}]},"description":"Direct children in parent catalog event order, excluding fork-inherited facts."},"subagentTiming":{"type":"object","properties":{"settledMs":{"type":"number","description":"Milliseconds accumulated across completed turns after the child's own descriptor."},"active":{"type":"object","properties":{"since":{"type":"number","description":"Start of the open turn."},"through":{"type":"number","description":"Latest event time folded into this projection cut."}},"required":["since","through"],"additionalProperties":true,"description":"Same-cut bounds of the currently open turn, when one has not reached `turn/end`."},"lastTurnCompleted":{"type":"boolean","description":"Whether the latest closed turn after the child's own descriptor completed normally; absent while a turn is open or before one closes."}},"required":["settledMs"],"additionalProperties":true,"description":"Active-turn duration and latest closed-turn completion for a descriptor-backed subagent session."},"subagent":{"oneOf":[{"type":"null","const":null},{"type":"object","properties":{"mode":{"type":"string","const":"one-shot","description":"A terminal one-shot child."},"label":{"type":"string","description":"Optional durable creation label from the child's descriptor."},"seq":{"type":"number","description":"Seq of the `subagent/descriptor` event this identity was folded from. `session.isOwnSeq(seq)` proves the identity comes from the child's OWN log suffix — where a descriptor is immutable once appended — and not from a fork seed's replayed ancestor descriptor."}},"required":["mode","seq"],"additionalProperties":true},{"type":"object","properties":{"mode":{"type":"string","const":"continuable","description":"A resumable conversation."},"label":{"type":"string","description":"Durable creation label from the child's descriptor."},"seq":{"type":"number","description":"Seq of the folded descriptor event; see the one-shot arm for the own-suffix proof."}},"required":["mode","label","seq"],"additionalProperties":true}],"description":"Identity of a descriptor-backed subagent session. `null` ⟺ no valid descriptor (missing, malformed, or unrecognized-version — deliberately undistinguished). The sentinel is deliberately serializable: a value pushed over JSON transports must survive `JSON.stringify` losslessly, where an `undefined` field would be dropped and a stale identity would survive on the receiving side. The entry itself stays non-optional."},"tokenUsage":{"type":"object","properties":{"uncachedInputTokens":{"type":"number"},"outputTokens":{"type":"number"},"cacheReadTokens":{"type":"number"},"cacheWriteTokens":{"type":"number"}},"required":["uncachedInputTokens","outputTokens","cacheReadTokens","cacheWriteTokens"],"additionalProperties":true,"description":"Provider-reported usage accumulated across the complete durable log."},"contextPressure":{"type":"object","properties":{"pressureTokens":{"type":"number","description":"Provider-reported prompt size of the most recent request: uncached input plus cache reads and writes. Response output is excluded, so this does not grow as the current turn streams. Absent until a provider reports usage."},"projectedTokens":{"type":"number","description":"What the NEXT request's prompt would cost: {@link pressureTokens} plus the heuristic repricing of everything the surface gained or lost since that sample. Only the delta is estimated, so the figure stays anchored to the provider while still reacting the moment a compaction shadows a span — which `pressureTokens` alone cannot do, since compaction reports no usage of its own. Absent until a provider reports usage."},"contextWindow":{"type":"number","description":"Newest recorded route capacity; absent when no adapter advertised one."}},"required":[],"additionalProperties":true,"description":"Newest request pressure paired with the newest known route capacity."},"contextBreakdown":{"type":"object","properties":{"systemTokens":{"type":"number","description":"Heuristic tokens of the last nonempty surviving system prompt in surface order; 0 when none exists."},"toolsTokens":{"type":"number","description":"Heuristic tokens of the newest request envelope's tool schemas; 0 before any request."},"messageTokens":{"type":"number","description":"Heuristic tokens of every other visible surface node, including superseded system prompts."}},"required":["systemTokens","toolsTokens","messageTokens"],"additionalProperties":true,"description":"Heuristic system/tools/message composition of the next request."},"agentTeam":{"type":"object","properties":{"members":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string","enum":["lead","teammate"]},"phase":{"type":"string","enum":["failed","provisioning","active"],"description":"Durable lifecycle; the Lead row is always `active`. Turn activity comes from Session status."},"error":{"type":"string"}},"required":["id","name","role","phase"],"additionalProperties":true}},"tasks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"revision":{"type":"number"},"subject":{"type":"string"},"description":{"type":"string"},"status":{"type":"string","enum":["completed","pending","in_progress","deleted"]},"blockedBy":{"type":"array","items":{"type":"string"}},"writeScopes":{"type":"array","items":{"type":"string"}},"ownerName":{"type":"string"},"ready":{"type":"boolean"},"writeScopeWarnings":{"type":"array","items":{"type":"string"}}},"required":["id","revision","subject","description","status","blockedBy","writeScopes","ready","writeScopeWarnings"],"additionalProperties":true}},"failure":{"type":"string"}},"required":["members","tasks"],"additionalProperties":true,"description":"Durable roster and non-deleted task board of the Team rooted at the projected Session."},"userQuestions":{"type":"object","properties":{"active":{"type":"array","items":{"type":"object","properties":{"callId":{"type":"string"},"questions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Stable caller-provided question id, echoed in the answer."},"question":{"type":"string","description":"The question to display."},"detail":{"type":"string","description":"Optional supporting detail rendered with the question but kept out of option labels."},"header":{"type":"string","description":"Optional short heading/group label."},"options":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","description":"User-facing label."},"description":{"type":"string","description":"Optional extra context rendered by capable UIs."}},"required":["label"],"additionalProperties":true},"description":"Optional choices the UI can render as a menu."},"multiSelect":{"type":"boolean","description":"Whether more than one option may be selected. Defaults to single-select."},"intent":{"type":"object","properties":{"kind":{"type":"string","const":"plan-review","description":"A plan submitted for review: `detail` is the plan markdown `ask()` requires, and the decision approves or declines it."},"approve":{"type":"string","description":"The option label that approves the plan; every other option declines it. Named rather than positional so no UI infers the verdict from option order. An `approve` naming no option of its own question is rejected at `ask()`."},"callId":{"type":"string","description":"Logged tool invocation whose arguments contain the reviewed plan."}},"required":["kind","approve"],"additionalProperties":true,"description":"Optional presentation intent for capable UIs; absent asks for the generic option list."}},"required":["id","question"],"additionalProperties":true}},"state":{"type":"string","enum":["open","continued"]}},"required":["callId","questions","state"],"additionalProperties":true},"description":"Calls that can still take an answer, in ask order."},"settled":{"type":"array","items":{"type":"object","properties":{"callId":{"type":"string","description":"The settled call."},"answers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The answered question id."},"selected":{"type":"array","items":{"type":"string"},"description":"Selected option labels. May accompany custom text for a multi-select question."},"custom":{"type":"string","description":"Optional free-text \"Other\" answer."}},"required":["id","selected"],"additionalProperties":true},"description":"The recorded batch, one entry per question; empty when the late reply carried none."}},"required":["callId","answers"],"additionalProperties":true},"description":"Calls an answer settled, in settlement order."}},"required":["active","settled"],"additionalProperties":true,"description":"Timed questions that remain answerable in this Session, and the ones a late reply settled."},"goal":{"oneOf":[{"type":"null","const":null},{"type":"object","properties":{"goal":{"type":"object","properties":{"objective":{"type":"string","description":"Human-requested completion objective."},"phase":{"type":"string","enum":["active","paused","blocked","complete"],"description":"Durable lifecycle phase."},"blockedReason":{"type":"object","properties":{"code":{"type":"string","description":"Stable lower-kebab-case classification chosen by the blocking policy."},"message":{"type":"string","description":"Non-empty explanation shown to humans and models."}},"required":["code","message"],"additionalProperties":true,"description":"Present exactly while `phase` is `blocked`."},"maxGoalRounds":{"type":"number","description":"Total admitted goal-round cap."},"id":{"type":"string","description":"Stable goal identity."},"revision":{"type":"number","description":"Positive revision; every durable mutation increments it."}},"required":["objective","phase","maxGoalRounds","id","revision"],"additionalProperties":true,"description":"Current durable goal snapshot (the CAS ref for mutations rides on it)."},"roundsStarted":{"type":"number","description":"Highest admitted round number for this goal."},"createdAt":{"type":"number","description":"Epoch milliseconds of the create mutation."},"updatedAt":{"type":"number","description":"Epoch milliseconds of the latest mutation."}},"required":["goal","roundsStarted","createdAt","updatedAt"],"additionalProperties":true}],"description":"The session's current goal and admitted-round count, or `null` before the first create and after a clear tombstone. `goal/change` supplies the whole lifecycle value; matching admitted `user/message` events advance `roundsStarted`."},"plan":{"type":"object","properties":{"active":{"type":"boolean"},"pending":{"type":"boolean"}},"required":["active","pending"],"additionalProperties":true,"description":"Plan collaboration state folded from the plan command lifecycle and `plan/mode` events."}},"required":[],"additionalProperties":true,"description":"Provider-validated values; omitted keys are absent capabilities at this cut."}},"required":["asOfSeq","values"],"additionalProperties":true},"assistantStream":{"type":"object","properties":{"revision":{"type":"number"},"activeAttempt":{"type":"object","properties":{"attemptId":{"type":"string"},"startedAfterSeq":{"type":"number","description":"Last durable Session seq observed when this attempt started."},"turn":{"type":"number"},"step":{"type":"number"},"nextIndex":{"type":"number","description":"Dense position expected for the next live chunk frame."},"stream":{"type":"array","items":{},"description":"Compact detached stream accumulated at this opening revision."}},"required":["attemptId","startedAfterSeq","turn","step","nextIndex","stream"],"additionalProperties":true}},"required":["revision"],"additionalProperties":true}},"required":["type","header","cursor","records","hasMore","projections"],"additionalProperties":true},{"type":"object","properties":{"type":{"type":"string","const":"assistant-stream"},"frame":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"start"},"attemptId":{"type":"string"},"revision":{"type":"number"},"startedAfterSeq":{"type":"number"},"turn":{"type":"number"},"step":{"type":"number"}},"required":["type","attemptId","revision","startedAfterSeq","turn","step"],"additionalProperties":true},{"type":"object","properties":{"type":{"type":"string","const":"chunk"},"attemptId":{"type":"string"},"revision":{"type":"number"},"index":{"type":"number"},"time":{"type":"number"},"chunk":{}},"required":["type","attemptId","revision","index","time","chunk"],"additionalProperties":true},{"type":"object","properties":{"type":{"type":"string","const":"end"},"attemptId":{"type":"string"},"revision":{"type":"number"},"index":{"type":"number","description":"Number of chunk frames represented by this terminal marker."},"outcome":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"committed"},"eventType":{"type":"string","enum":["assistant/message","assistant/attempt"]},"seq":{"type":"number"}},"required":["kind","eventType","seq"],"additionalProperties":true},{"type":"object","properties":{"kind":{"type":"string","const":"abandoned"}},"required":["kind"],"additionalProperties":true}]}},"required":["type","attemptId","revision","index","outcome"],"additionalProperties":true}]}},"required":["type","frame"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":487,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":537,"column":3},
     },
-    {
-      id: '@deepseek-ai/dsh-api-session-controller#session/fork',
+    'session/fork': {
       service: 'sessionController',
-      namespace: 'session',
-      method: 'fork',
+      description: 'Fork one cold-readable exact event prefix into a new Session. An omitted boundary selects the latest completed-turn prefix; an open cut receives synthetic fork closers.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
+          description: 'source Session, optional exact inclusive event boundary, and migration preflight choice.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionForkRequest',
             create: _deepseek_ai_dsh_api_session_controller_session_fork_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string"},"atSeq":{"type":"number","description":"Exact inclusive source event seq; omission selects the latest completed-turn prefix."},"allowMigration":{"type":"boolean","description":"False asks the Host to check for required migration before forking. Defaults to true."}},"required":["sessionId"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionForkRequest',
+            create: _deepseek_ai_dsh_api_session_controller_session_fork_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string"},"atSeq":{"type":"number","description":"Exact inclusive source event seq; omission selects the latest completed-turn prefix."},"allowMigration":{"type":"boolean","description":"False asks the Host to check for required migration before forking. Defaults to true."}},"required":["sessionId"],"additionalProperties":false},
           },
         },
       ],
@@ -1150,14 +1612,14 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionForkValue',
         create: _deepseek_ai_dsh_api_session_controller_session_fork_result$schema,
+        description: 'the new Session identity.',
+        jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string"}},"required":["sessionId"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":422,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":443,"column":9},
     },
-    {
-      id: '@deepseek-ai/dsh-api-session-controller#session/initializeDefaultModel',
+    'session/initializeDefaultModel': {
       service: 'sessionController',
-      namespace: 'session',
-      method: 'initializeDefaultModel',
+      description: 'Select the first available account model after login when no provider API key is configured.',
       invocation: { kind: 'direct' },
       parameters: [
       ],
@@ -1165,24 +1627,31 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-session-controller#session/initializeDefaultModel:result',
         create: _deepseek_ai_dsh_api_session_controller_session_initializeDefaultModel_result$schema,
+        description: 'after saving the first available model or retaining the existing default.',
+        jsonSchemaError: 'typert tool schema: unsupported void value',
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":299,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":320,"column":9},
     },
-    {
-      id: '@deepseek-ai/dsh-api-session-controller#session/list',
+    'session/list': {
       service: 'sessionController',
-      namespace: 'session',
-      method: 'list',
+      description: 'Read all visible Session rows without resuming an Agent.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: '_request',
-          wire: '_request',
+          description: 'reserved empty list request.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionListRequest',
             create: _deepseek_ai_dsh_api_session_controller_session_list_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"cursor":{"type":"string"}},"required":[],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionListRequest',
+            create: _deepseek_ai_dsh_api_session_controller_session_list_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"cursor":{"type":"string"}},"required":[],"additionalProperties":false},
           },
         },
       ],
@@ -1191,14 +1660,14 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionListValue',
         create: _deepseek_ai_dsh_api_session_controller_session_list_result$schema,
+        description: 'visible Session summaries ordered by activity.',
+        jsonSchema: {"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"agentAvailable":{"type":"boolean","description":"Whether this Session currently owns a live Agent."},"formatStatus":{"type":"string","enum":["current","migration-required"],"description":"Current for attached Sessions; otherwise the persistence format status when reported."},"sessionId":{"type":"string"},"updatedAt":{"type":"number"},"running":{"type":"boolean"},"blank":{"type":"boolean"},"parentSessionId":{"type":"string"},"origin":{"type":"string","const":"subagent"},"cwd":{"type":"string"},"projections":{"type":"object","properties":{"kind":{"type":"string","enum":["cached","sequenced"],"description":"`sequenced`: the Host's live registry produced the block for an attached Session, so `asOfSeq` is comparable with baselines and frames of the same connection. `cached`: a header-only listing viewed the block from the persisted projection cache, so `asOfSeq` is the stored record's own watermark and must not be compared with the connected Session's values."},"asOfSeq":{"type":"number","description":"Watermark of the block in the sequence space named by `kind`."},"values":{"type":"object","properties":{"inbox":{"type":"object","properties":{"next-turn":{"type":"array","items":{}},"next-step":{"type":"array","items":{}}},"required":["next-turn","next-step"],"additionalProperties":true,"description":"Pending agent input reconstructed from durable inbox splices."},"workingDirectory":{"oneOf":[{"type":"null","const":null},{"type":"string"}],"description":"Recorded current directory for Session observations, or null when none is recorded."},"agentPreset":{"oneOf":[{"type":"null","const":null},{"type":"string"}],"description":"Preset the Session runs, or null when the deployment composes none."},"title":{"oneOf":[{"type":"null","const":null},{"type":"string"}],"description":"The session's current normalized title — the latest `session/title` event's text (last-wins), or `null` before the first title lands. A plain string: the shape the client list rows consume."},"todos":{"oneOf":[{"type":"null","const":null},{"type":"array","items":{"type":"object","properties":{"content":{"type":"string","description":"What this task is — a short imperative line shown in the UI."},"status":{"type":"string","enum":["completed","pending","in_progress"],"description":"Lifecycle state. `in_progress` marks a task being worked now; parallel work may mark several."}},"required":["content","status"],"additionalProperties":true}}],"description":"The agent's current whole todo list (the latest `todo/write` snapshot), or `null` before the first write. Whole-value rule: every `todo/write` carries the complete replacement list, so the fold is last-wins."},"sessionListMetadata":{"type":"object","properties":{"blank":{"type":"boolean","description":"Whether the folded prefix contains no turn."},"lastPromptAt":{"oneOf":[{"type":"null","const":null},{"type":"number"}],"description":"Latest human-authored prompt time in the folded prefix."}},"required":["blank","lastPromptAt"],"additionalProperties":true,"description":"Persisted facts used to summarize a Session without activating it."},"imageLimits":{"type":"object","properties":{"maxImageBytes":{"type":"number"},"maxImagesPerMessage":{"type":"number"},"maxMessageImageBytes":{"type":"number"},"maxImagePixels":{"type":"number"},"maxImageDimension":{"type":"number","description":"Maximum intrinsic width and maximum intrinsic height in pixels for one image."},"mediaTypes":{"type":"array","items":{"type":"string","enum":["image/png","image/jpeg","image/webp","image/gif"]}}},"required":["maxImageBytes","maxImagesPerMessage","maxMessageImageBytes","maxImagePixels","maxImageDimension","mediaTypes"],"additionalProperties":true,"description":"Image-intake limits enforced by the Session prompt endpoint."},"modelSelection":{"type":"object","properties":{"lastUsed":{"oneOf":[{"type":"null","const":null},{"type":"object","properties":{"provider":{"type":"string"},"model":{"type":"string"},"reasoningEffort":{"type":"string"}},"required":["provider","model"],"additionalProperties":true}],"description":"Selection consumed by the latest recorded model request."},"next":{"oneOf":[{"type":"null","const":null},{"type":"object","properties":{"provider":{"type":"string"},"model":{"type":"string"},"reasoningEffort":{"type":"string"}},"required":["provider","model"],"additionalProperties":true}],"description":"Selection the next request should use, falling back to {@link lastUsed}."}},"required":["lastUsed","next"],"additionalProperties":true,"description":"Durable model selection already used and selected for the next request."},"permissions":{"type":"object","properties":{"currentValue":{"type":"string","description":"The effective current value: a configured preset key, `auto`, or `custom`."}},"required":["currentValue"],"additionalProperties":true,"description":"The session's current permission, folded from the three whole-value knob events (`permission/preset`, `sandbox/mode`, `approval/policy`) over the composition defaults. Selectable options come from the process-level catalog Remote. Key absence means no permission service is composed — clients hide the control."},"subagentCatalog":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"number"},"mode":{"type":"string","const":"one-shot"},"label":{"type":"string"}},"required":["id","createdAt","mode"],"additionalProperties":true},{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"number"},"mode":{"type":"string","const":"external"},"label":{"type":"string"}},"required":["id","createdAt","mode"],"additionalProperties":true},{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"number"},"mode":{"type":"string","const":"continuable"},"label":{"type":"string"}},"required":["id","createdAt","mode","label"],"additionalProperties":true},{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"number"},"mode":{"type":"string","const":"unknown"},"label":{"type":"string"}},"required":["id","createdAt","mode"],"additionalProperties":true}]},"description":"Direct children in parent catalog event order, excluding fork-inherited facts."},"subagentTiming":{"type":"object","properties":{"settledMs":{"type":"number","description":"Milliseconds accumulated across completed turns after the child's own descriptor."},"active":{"type":"object","properties":{"since":{"type":"number","description":"Start of the open turn."},"through":{"type":"number","description":"Latest event time folded into this projection cut."}},"required":["since","through"],"additionalProperties":true,"description":"Same-cut bounds of the currently open turn, when one has not reached `turn/end`."},"lastTurnCompleted":{"type":"boolean","description":"Whether the latest closed turn after the child's own descriptor completed normally; absent while a turn is open or before one closes."}},"required":["settledMs"],"additionalProperties":true,"description":"Active-turn duration and latest closed-turn completion for a descriptor-backed subagent session."},"subagent":{"oneOf":[{"type":"null","const":null},{"type":"object","properties":{"mode":{"type":"string","const":"one-shot","description":"A terminal one-shot child."},"label":{"type":"string","description":"Optional durable creation label from the child's descriptor."},"seq":{"type":"number","description":"Seq of the `subagent/descriptor` event this identity was folded from. `session.isOwnSeq(seq)` proves the identity comes from the child's OWN log suffix — where a descriptor is immutable once appended — and not from a fork seed's replayed ancestor descriptor."}},"required":["mode","seq"],"additionalProperties":true},{"type":"object","properties":{"mode":{"type":"string","const":"continuable","description":"A resumable conversation."},"label":{"type":"string","description":"Durable creation label from the child's descriptor."},"seq":{"type":"number","description":"Seq of the folded descriptor event; see the one-shot arm for the own-suffix proof."}},"required":["mode","label","seq"],"additionalProperties":true}],"description":"Identity of a descriptor-backed subagent session. `null` ⟺ no valid descriptor (missing, malformed, or unrecognized-version — deliberately undistinguished). The sentinel is deliberately serializable: a value pushed over JSON transports must survive `JSON.stringify` losslessly, where an `undefined` field would be dropped and a stale identity would survive on the receiving side. The entry itself stays non-optional."},"tokenUsage":{"type":"object","properties":{"uncachedInputTokens":{"type":"number"},"outputTokens":{"type":"number"},"cacheReadTokens":{"type":"number"},"cacheWriteTokens":{"type":"number"}},"required":["uncachedInputTokens","outputTokens","cacheReadTokens","cacheWriteTokens"],"additionalProperties":true,"description":"Provider-reported usage accumulated across the complete durable log."},"contextPressure":{"type":"object","properties":{"pressureTokens":{"type":"number","description":"Provider-reported prompt size of the most recent request: uncached input plus cache reads and writes. Response output is excluded, so this does not grow as the current turn streams. Absent until a provider reports usage."},"projectedTokens":{"type":"number","description":"What the NEXT request's prompt would cost: {@link pressureTokens} plus the heuristic repricing of everything the surface gained or lost since that sample. Only the delta is estimated, so the figure stays anchored to the provider while still reacting the moment a compaction shadows a span — which `pressureTokens` alone cannot do, since compaction reports no usage of its own. Absent until a provider reports usage."},"contextWindow":{"type":"number","description":"Newest recorded route capacity; absent when no adapter advertised one."}},"required":[],"additionalProperties":true,"description":"Newest request pressure paired with the newest known route capacity."},"contextBreakdown":{"type":"object","properties":{"systemTokens":{"type":"number","description":"Heuristic tokens of the last nonempty surviving system prompt in surface order; 0 when none exists."},"toolsTokens":{"type":"number","description":"Heuristic tokens of the newest request envelope's tool schemas; 0 before any request."},"messageTokens":{"type":"number","description":"Heuristic tokens of every other visible surface node, including superseded system prompts."}},"required":["systemTokens","toolsTokens","messageTokens"],"additionalProperties":true,"description":"Heuristic system/tools/message composition of the next request."},"agentTeam":{"type":"object","properties":{"members":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string","enum":["lead","teammate"]},"phase":{"type":"string","enum":["failed","provisioning","active"],"description":"Durable lifecycle; the Lead row is always `active`. Turn activity comes from Session status."},"error":{"type":"string"}},"required":["id","name","role","phase"],"additionalProperties":true}},"tasks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"revision":{"type":"number"},"subject":{"type":"string"},"description":{"type":"string"},"status":{"type":"string","enum":["completed","pending","in_progress","deleted"]},"blockedBy":{"type":"array","items":{"type":"string"}},"writeScopes":{"type":"array","items":{"type":"string"}},"ownerName":{"type":"string"},"ready":{"type":"boolean"},"writeScopeWarnings":{"type":"array","items":{"type":"string"}}},"required":["id","revision","subject","description","status","blockedBy","writeScopes","ready","writeScopeWarnings"],"additionalProperties":true}},"failure":{"type":"string"}},"required":["members","tasks"],"additionalProperties":true,"description":"Durable roster and non-deleted task board of the Team rooted at the projected Session."},"userQuestions":{"type":"object","properties":{"active":{"type":"array","items":{"type":"object","properties":{"callId":{"type":"string"},"questions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Stable caller-provided question id, echoed in the answer."},"question":{"type":"string","description":"The question to display."},"detail":{"type":"string","description":"Optional supporting detail rendered with the question but kept out of option labels."},"header":{"type":"string","description":"Optional short heading/group label."},"options":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","description":"User-facing label."},"description":{"type":"string","description":"Optional extra context rendered by capable UIs."}},"required":["label"],"additionalProperties":true},"description":"Optional choices the UI can render as a menu."},"multiSelect":{"type":"boolean","description":"Whether more than one option may be selected. Defaults to single-select."},"intent":{"type":"object","properties":{"kind":{"type":"string","const":"plan-review","description":"A plan submitted for review: `detail` is the plan markdown `ask()` requires, and the decision approves or declines it."},"approve":{"type":"string","description":"The option label that approves the plan; every other option declines it. Named rather than positional so no UI infers the verdict from option order. An `approve` naming no option of its own question is rejected at `ask()`."},"callId":{"type":"string","description":"Logged tool invocation whose arguments contain the reviewed plan."}},"required":["kind","approve"],"additionalProperties":true,"description":"Optional presentation intent for capable UIs; absent asks for the generic option list."}},"required":["id","question"],"additionalProperties":true}},"state":{"type":"string","enum":["open","continued"]}},"required":["callId","questions","state"],"additionalProperties":true},"description":"Calls that can still take an answer, in ask order."},"settled":{"type":"array","items":{"type":"object","properties":{"callId":{"type":"string","description":"The settled call."},"answers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The answered question id."},"selected":{"type":"array","items":{"type":"string"},"description":"Selected option labels. May accompany custom text for a multi-select question."},"custom":{"type":"string","description":"Optional free-text \"Other\" answer."}},"required":["id","selected"],"additionalProperties":true},"description":"The recorded batch, one entry per question; empty when the late reply carried none."}},"required":["callId","answers"],"additionalProperties":true},"description":"Calls an answer settled, in settlement order."}},"required":["active","settled"],"additionalProperties":true,"description":"Timed questions that remain answerable in this Session, and the ones a late reply settled."},"goal":{"oneOf":[{"type":"null","const":null},{"type":"object","properties":{"goal":{"type":"object","properties":{"objective":{"type":"string","description":"Human-requested completion objective."},"phase":{"type":"string","enum":["active","paused","blocked","complete"],"description":"Durable lifecycle phase."},"blockedReason":{"type":"object","properties":{"code":{"type":"string","description":"Stable lower-kebab-case classification chosen by the blocking policy."},"message":{"type":"string","description":"Non-empty explanation shown to humans and models."}},"required":["code","message"],"additionalProperties":true,"description":"Present exactly while `phase` is `blocked`."},"maxGoalRounds":{"type":"number","description":"Total admitted goal-round cap."},"id":{"type":"string","description":"Stable goal identity."},"revision":{"type":"number","description":"Positive revision; every durable mutation increments it."}},"required":["objective","phase","maxGoalRounds","id","revision"],"additionalProperties":true,"description":"Current durable goal snapshot (the CAS ref for mutations rides on it)."},"roundsStarted":{"type":"number","description":"Highest admitted round number for this goal."},"createdAt":{"type":"number","description":"Epoch milliseconds of the create mutation."},"updatedAt":{"type":"number","description":"Epoch milliseconds of the latest mutation."}},"required":["goal","roundsStarted","createdAt","updatedAt"],"additionalProperties":true}],"description":"The session's current goal and admitted-round count, or `null` before the first create and after a clear tombstone. `goal/change` supplies the whole lifecycle value; matching admitted `user/message` events advance `roundsStarted`."},"plan":{"type":"object","properties":{"active":{"type":"boolean"},"pending":{"type":"boolean"}},"required":["active","pending"],"additionalProperties":true,"description":"Plan collaboration state folded from the plan command lifecycle and `plan/mode` events."}},"required":[],"additionalProperties":true,"description":"Provider-validated values present in the block; omitted keys remain unknown."}},"required":["kind","asOfSeq","values"],"additionalProperties":true}},"required":["agentAvailable","sessionId","updatedAt","running","blank"],"additionalProperties":true}}},"required":["items"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":259,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":276,"column":9},
     },
-    {
-      id: '@deepseek-ai/dsh-api-session-controller#session/modelCatalog',
+    'session/modelCatalog': {
       service: 'sessionController',
-      namespace: 'session',
-      method: 'modelCatalog',
+      description: 'Describe every currently routable model for Host-generation selectors.',
       invocation: { kind: 'direct' },
       parameters: [
       ],
@@ -1206,24 +1675,31 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#ModelCatalog',
         create: _deepseek_ai_dsh_api_session_controller_session_modelCatalog_result$schema,
+        description: 'provider-grouped models, the deployment default, and isolated provider failures.',
+        jsonSchema: {"type":"object","properties":{"default":{"type":"object","properties":{"provider":{"type":"string"},"model":{"type":"string"},"reasoningEffort":{"type":"string"}},"required":["provider","model"],"additionalProperties":true},"routableProviders":{"type":"array","items":{"type":"string"},"description":"Provider routes with at least one currently available catalog model."},"groups":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"models":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"reasoning":{"type":"object","properties":{"efforts":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"}},"required":["id","name"],"additionalProperties":true}},"defaultEffort":{"type":"string"}},"required":["efforts"],"additionalProperties":true}},"required":["id","name"],"additionalProperties":true}}},"required":["id","name","models"],"additionalProperties":true}},"failures":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"message":{"type":"string"}},"required":["id","name","message"],"additionalProperties":true}}},"required":["default","routableProviders","groups","failures"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":317,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":338,"column":3},
     },
-    {
-      id: '@deepseek-ai/dsh-api-session-controller#session/openWorkspacePath',
+    'session/openWorkspacePath': {
       service: 'sessionController',
-      namespace: 'session',
-      method: 'openWorkspacePath',
+      description: 'Verify one path through the composed filesystem and open it on the Host desktop.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
+          description: 'path after best-effort Session workspace resolution.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionOpenWorkspacePathRequest',
             create: _deepseek_ai_dsh_api_session_controller_session_openWorkspacePath_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"action":{"type":"string","const":"reveal","description":"File-manager navigation when requested; omission uses the default application."},"application":{"type":"string","description":"Registered application identifier; ignored for reveal. Omission preserves the operating system default."},"path":{"type":"string","description":"Path after best-effort Session workspace resolution, in Host filesystem syntax."}},"required":["path"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionOpenWorkspacePathRequest',
+            create: _deepseek_ai_dsh_api_session_controller_session_openWorkspacePath_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"action":{"type":"string","const":"reveal","description":"File-manager navigation when requested; omission uses the default application."},"application":{"type":"string","description":"Registered application identifier; ignored for reveal. Omission preserves the operating system default."},"path":{"type":"string","description":"Path after best-effort Session workspace resolution, in Host filesystem syntax."}},"required":["path"],"additionalProperties":false},
           },
         },
       ],
@@ -1232,24 +1708,31 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionOpenWorkspacePathValue',
         create: _deepseek_ai_dsh_api_session_controller_session_openWorkspacePath_result$schema,
+        description: 'confirmation after the native opener accepts the path.',
+        jsonSchema: {"type":"object","properties":{"opened":{"type":"boolean","const":true}},"required":["opened"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":347,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":368,"column":9},
     },
-    {
-      id: '@deepseek-ai/dsh-api-session-controller#session/page',
+    'session/page': {
       service: 'sessionController',
-      namespace: 'session',
-      method: 'page',
+      description: 'Read one cold-safe, message-aligned Session history page.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
+          description: 'durable address, backward cursor, and page budget.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionPageRequest',
             create: _deepseek_ai_dsh_api_session_controller_session_page_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"address":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"session"},"sessionId":{"type":"string"}},"required":["kind","sessionId"],"additionalProperties":true},{"type":"object","properties":{"kind":{"type":"string","const":"subagent"},"parentSessionId":{"type":"string"},"childSessionId":{"type":"string"},"mode":{"type":"string","enum":["one-shot","continuable","unknown"]}},"required":["kind","parentSessionId","childSessionId","mode"],"additionalProperties":true}]},"throughSeq":{"type":"number","description":"Inclusive log cut obtained from the corresponding follow opening frame."},"beforeSeq":{"type":"number"},"maxMessages":{"type":"number"},"turnWindow":{"type":"object","properties":{"minMessages":{"type":"number","description":"Minimum append-origin user/assistant messages; must not exceed maxMessages."},"minTurns":{"type":"number","description":"Minimum Turn starts crossed, including the partial Turn at beforeSeq."}},"required":["minMessages","minTurns"],"additionalProperties":true,"description":"Stop at a Turn start after both minima, unless maxMessages or history exhaustion wins."}},"required":["address","throughSeq"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionPageRequest',
+            create: _deepseek_ai_dsh_api_session_controller_session_page_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"address":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"session"},"sessionId":{"type":"string"}},"required":["kind","sessionId"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"subagent"},"parentSessionId":{"type":"string"},"childSessionId":{"type":"string"},"mode":{"type":"string","enum":["one-shot","continuable","unknown"]}},"required":["kind","parentSessionId","childSessionId","mode"],"additionalProperties":false}]},"throughSeq":{"type":"number","description":"Inclusive log cut obtained from the corresponding follow opening frame."},"beforeSeq":{"type":"number"},"maxMessages":{"type":"number"},"turnWindow":{"type":"object","properties":{"minMessages":{"type":"number","description":"Minimum append-origin user/assistant messages; must not exceed maxMessages."},"minTurns":{"type":"number","description":"Minimum Turn starts crossed, including the partial Turn at beforeSeq."}},"required":["minMessages","minTurns"],"additionalProperties":false,"description":"Stop at a Turn start after both minima, unless maxMessages or history exhaustion wins."}},"required":["address","throughSeq"],"additionalProperties":false},
           },
         },
       ],
@@ -1258,24 +1741,31 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionPage',
         create: _deepseek_ai_dsh_api_session_controller_session_page_result$schema,
+        description: 'one chronological page.',
+        jsonSchema: {"type":"object","properties":{"records":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"event"},"event":{"type":"object","properties":{"type":{"type":"string"},"seq":{"type":"number"},"time":{"type":"number"},"data":{},"ignorable":{"type":"boolean","const":true},"sourceEventSeqs":{"description":"Earlier sources on current surface events; opaque JSON on unknown ignorable events."},"surfaceOp":{"description":"Canonical placement on current surface events; opaque JSON on unknown ignorable events."}},"required":["type","seq","time","data"],"additionalProperties":true}},"required":["type","event"],"additionalProperties":true}},"hasMore":{"type":"boolean"}},"required":["records","hasMore"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":475,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":525,"column":3},
     },
-    {
-      id: '@deepseek-ai/dsh-api-session-controller#session/projections',
+    'session/projections': {
       service: 'sessionController',
-      namespace: 'session',
-      method: 'projections',
+      description: 'Read exact projections, returning cached hints only when migration is required.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
+          description: 'Session whose current values are required.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionProjectionsRequest',
             create: _deepseek_ai_dsh_api_session_controller_session_projections_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string"}},"required":["sessionId"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionProjectionsRequest',
+            create: _deepseek_ai_dsh_api_session_controller_session_projections_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string"}},"required":["sessionId"],"additionalProperties":false},
           },
         },
       ],
@@ -1284,24 +1774,31 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionProjectionsValue',
         create: _deepseek_ai_dsh_api_session_controller_session_projections_result$schema,
+        description: 'a sequenced baseline, cached hints when migration is deferred, or null when absent.',
+        jsonSchema: {"oneOf":[{"type":"null","const":null},{"type":"object","properties":{"asOfSeq":{"type":"number"},"values":{"type":"object","properties":{"inbox":{"type":"object","properties":{"next-turn":{"type":"array","items":{}},"next-step":{"type":"array","items":{}}},"required":["next-turn","next-step"],"additionalProperties":true,"description":"Pending agent input reconstructed from durable inbox splices."},"workingDirectory":{"oneOf":[{"type":"null","const":null},{"type":"string"}],"description":"Recorded current directory for Session observations, or null when none is recorded."},"agentPreset":{"oneOf":[{"type":"null","const":null},{"type":"string"}],"description":"Preset the Session runs, or null when the deployment composes none."},"title":{"oneOf":[{"type":"null","const":null},{"type":"string"}],"description":"The session's current normalized title — the latest `session/title` event's text (last-wins), or `null` before the first title lands. A plain string: the shape the client list rows consume."},"todos":{"oneOf":[{"type":"null","const":null},{"type":"array","items":{"type":"object","properties":{"content":{"type":"string","description":"What this task is — a short imperative line shown in the UI."},"status":{"type":"string","enum":["completed","pending","in_progress"],"description":"Lifecycle state. `in_progress` marks a task being worked now; parallel work may mark several."}},"required":["content","status"],"additionalProperties":true}}],"description":"The agent's current whole todo list (the latest `todo/write` snapshot), or `null` before the first write. Whole-value rule: every `todo/write` carries the complete replacement list, so the fold is last-wins."},"sessionListMetadata":{"type":"object","properties":{"blank":{"type":"boolean","description":"Whether the folded prefix contains no turn."},"lastPromptAt":{"oneOf":[{"type":"null","const":null},{"type":"number"}],"description":"Latest human-authored prompt time in the folded prefix."}},"required":["blank","lastPromptAt"],"additionalProperties":true,"description":"Persisted facts used to summarize a Session without activating it."},"imageLimits":{"type":"object","properties":{"maxImageBytes":{"type":"number"},"maxImagesPerMessage":{"type":"number"},"maxMessageImageBytes":{"type":"number"},"maxImagePixels":{"type":"number"},"maxImageDimension":{"type":"number","description":"Maximum intrinsic width and maximum intrinsic height in pixels for one image."},"mediaTypes":{"type":"array","items":{"type":"string","enum":["image/png","image/jpeg","image/webp","image/gif"]}}},"required":["maxImageBytes","maxImagesPerMessage","maxMessageImageBytes","maxImagePixels","maxImageDimension","mediaTypes"],"additionalProperties":true,"description":"Image-intake limits enforced by the Session prompt endpoint."},"modelSelection":{"type":"object","properties":{"lastUsed":{"oneOf":[{"type":"null","const":null},{"type":"object","properties":{"provider":{"type":"string"},"model":{"type":"string"},"reasoningEffort":{"type":"string"}},"required":["provider","model"],"additionalProperties":true}],"description":"Selection consumed by the latest recorded model request."},"next":{"oneOf":[{"type":"null","const":null},{"type":"object","properties":{"provider":{"type":"string"},"model":{"type":"string"},"reasoningEffort":{"type":"string"}},"required":["provider","model"],"additionalProperties":true}],"description":"Selection the next request should use, falling back to {@link lastUsed}."}},"required":["lastUsed","next"],"additionalProperties":true,"description":"Durable model selection already used and selected for the next request."},"permissions":{"type":"object","properties":{"currentValue":{"type":"string","description":"The effective current value: a configured preset key, `auto`, or `custom`."}},"required":["currentValue"],"additionalProperties":true,"description":"The session's current permission, folded from the three whole-value knob events (`permission/preset`, `sandbox/mode`, `approval/policy`) over the composition defaults. Selectable options come from the process-level catalog Remote. Key absence means no permission service is composed — clients hide the control."},"subagentCatalog":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"number"},"mode":{"type":"string","const":"one-shot"},"label":{"type":"string"}},"required":["id","createdAt","mode"],"additionalProperties":true},{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"number"},"mode":{"type":"string","const":"external"},"label":{"type":"string"}},"required":["id","createdAt","mode"],"additionalProperties":true},{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"number"},"mode":{"type":"string","const":"continuable"},"label":{"type":"string"}},"required":["id","createdAt","mode","label"],"additionalProperties":true},{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"number"},"mode":{"type":"string","const":"unknown"},"label":{"type":"string"}},"required":["id","createdAt","mode"],"additionalProperties":true}]},"description":"Direct children in parent catalog event order, excluding fork-inherited facts."},"subagentTiming":{"type":"object","properties":{"settledMs":{"type":"number","description":"Milliseconds accumulated across completed turns after the child's own descriptor."},"active":{"type":"object","properties":{"since":{"type":"number","description":"Start of the open turn."},"through":{"type":"number","description":"Latest event time folded into this projection cut."}},"required":["since","through"],"additionalProperties":true,"description":"Same-cut bounds of the currently open turn, when one has not reached `turn/end`."},"lastTurnCompleted":{"type":"boolean","description":"Whether the latest closed turn after the child's own descriptor completed normally; absent while a turn is open or before one closes."}},"required":["settledMs"],"additionalProperties":true,"description":"Active-turn duration and latest closed-turn completion for a descriptor-backed subagent session."},"subagent":{"oneOf":[{"type":"null","const":null},{"type":"object","properties":{"mode":{"type":"string","const":"one-shot","description":"A terminal one-shot child."},"label":{"type":"string","description":"Optional durable creation label from the child's descriptor."},"seq":{"type":"number","description":"Seq of the `subagent/descriptor` event this identity was folded from. `session.isOwnSeq(seq)` proves the identity comes from the child's OWN log suffix — where a descriptor is immutable once appended — and not from a fork seed's replayed ancestor descriptor."}},"required":["mode","seq"],"additionalProperties":true},{"type":"object","properties":{"mode":{"type":"string","const":"continuable","description":"A resumable conversation."},"label":{"type":"string","description":"Durable creation label from the child's descriptor."},"seq":{"type":"number","description":"Seq of the folded descriptor event; see the one-shot arm for the own-suffix proof."}},"required":["mode","label","seq"],"additionalProperties":true}],"description":"Identity of a descriptor-backed subagent session. `null` ⟺ no valid descriptor (missing, malformed, or unrecognized-version — deliberately undistinguished). The sentinel is deliberately serializable: a value pushed over JSON transports must survive `JSON.stringify` losslessly, where an `undefined` field would be dropped and a stale identity would survive on the receiving side. The entry itself stays non-optional."},"tokenUsage":{"type":"object","properties":{"uncachedInputTokens":{"type":"number"},"outputTokens":{"type":"number"},"cacheReadTokens":{"type":"number"},"cacheWriteTokens":{"type":"number"}},"required":["uncachedInputTokens","outputTokens","cacheReadTokens","cacheWriteTokens"],"additionalProperties":true,"description":"Provider-reported usage accumulated across the complete durable log."},"contextPressure":{"type":"object","properties":{"pressureTokens":{"type":"number","description":"Provider-reported prompt size of the most recent request: uncached input plus cache reads and writes. Response output is excluded, so this does not grow as the current turn streams. Absent until a provider reports usage."},"projectedTokens":{"type":"number","description":"What the NEXT request's prompt would cost: {@link pressureTokens} plus the heuristic repricing of everything the surface gained or lost since that sample. Only the delta is estimated, so the figure stays anchored to the provider while still reacting the moment a compaction shadows a span — which `pressureTokens` alone cannot do, since compaction reports no usage of its own. Absent until a provider reports usage."},"contextWindow":{"type":"number","description":"Newest recorded route capacity; absent when no adapter advertised one."}},"required":[],"additionalProperties":true,"description":"Newest request pressure paired with the newest known route capacity."},"contextBreakdown":{"type":"object","properties":{"systemTokens":{"type":"number","description":"Heuristic tokens of the last nonempty surviving system prompt in surface order; 0 when none exists."},"toolsTokens":{"type":"number","description":"Heuristic tokens of the newest request envelope's tool schemas; 0 before any request."},"messageTokens":{"type":"number","description":"Heuristic tokens of every other visible surface node, including superseded system prompts."}},"required":["systemTokens","toolsTokens","messageTokens"],"additionalProperties":true,"description":"Heuristic system/tools/message composition of the next request."},"agentTeam":{"type":"object","properties":{"members":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string","enum":["lead","teammate"]},"phase":{"type":"string","enum":["failed","provisioning","active"],"description":"Durable lifecycle; the Lead row is always `active`. Turn activity comes from Session status."},"error":{"type":"string"}},"required":["id","name","role","phase"],"additionalProperties":true}},"tasks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"revision":{"type":"number"},"subject":{"type":"string"},"description":{"type":"string"},"status":{"type":"string","enum":["completed","pending","in_progress","deleted"]},"blockedBy":{"type":"array","items":{"type":"string"}},"writeScopes":{"type":"array","items":{"type":"string"}},"ownerName":{"type":"string"},"ready":{"type":"boolean"},"writeScopeWarnings":{"type":"array","items":{"type":"string"}}},"required":["id","revision","subject","description","status","blockedBy","writeScopes","ready","writeScopeWarnings"],"additionalProperties":true}},"failure":{"type":"string"}},"required":["members","tasks"],"additionalProperties":true,"description":"Durable roster and non-deleted task board of the Team rooted at the projected Session."},"userQuestions":{"type":"object","properties":{"active":{"type":"array","items":{"type":"object","properties":{"callId":{"type":"string"},"questions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Stable caller-provided question id, echoed in the answer."},"question":{"type":"string","description":"The question to display."},"detail":{"type":"string","description":"Optional supporting detail rendered with the question but kept out of option labels."},"header":{"type":"string","description":"Optional short heading/group label."},"options":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","description":"User-facing label."},"description":{"type":"string","description":"Optional extra context rendered by capable UIs."}},"required":["label"],"additionalProperties":true},"description":"Optional choices the UI can render as a menu."},"multiSelect":{"type":"boolean","description":"Whether more than one option may be selected. Defaults to single-select."},"intent":{"type":"object","properties":{"kind":{"type":"string","const":"plan-review","description":"A plan submitted for review: `detail` is the plan markdown `ask()` requires, and the decision approves or declines it."},"approve":{"type":"string","description":"The option label that approves the plan; every other option declines it. Named rather than positional so no UI infers the verdict from option order. An `approve` naming no option of its own question is rejected at `ask()`."},"callId":{"type":"string","description":"Logged tool invocation whose arguments contain the reviewed plan."}},"required":["kind","approve"],"additionalProperties":true,"description":"Optional presentation intent for capable UIs; absent asks for the generic option list."}},"required":["id","question"],"additionalProperties":true}},"state":{"type":"string","enum":["open","continued"]}},"required":["callId","questions","state"],"additionalProperties":true},"description":"Calls that can still take an answer, in ask order."},"settled":{"type":"array","items":{"type":"object","properties":{"callId":{"type":"string","description":"The settled call."},"answers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The answered question id."},"selected":{"type":"array","items":{"type":"string"},"description":"Selected option labels. May accompany custom text for a multi-select question."},"custom":{"type":"string","description":"Optional free-text \"Other\" answer."}},"required":["id","selected"],"additionalProperties":true},"description":"The recorded batch, one entry per question; empty when the late reply carried none."}},"required":["callId","answers"],"additionalProperties":true},"description":"Calls an answer settled, in settlement order."}},"required":["active","settled"],"additionalProperties":true,"description":"Timed questions that remain answerable in this Session, and the ones a late reply settled."},"goal":{"oneOf":[{"type":"null","const":null},{"type":"object","properties":{"goal":{"type":"object","properties":{"objective":{"type":"string","description":"Human-requested completion objective."},"phase":{"type":"string","enum":["active","paused","blocked","complete"],"description":"Durable lifecycle phase."},"blockedReason":{"type":"object","properties":{"code":{"type":"string","description":"Stable lower-kebab-case classification chosen by the blocking policy."},"message":{"type":"string","description":"Non-empty explanation shown to humans and models."}},"required":["code","message"],"additionalProperties":true,"description":"Present exactly while `phase` is `blocked`."},"maxGoalRounds":{"type":"number","description":"Total admitted goal-round cap."},"id":{"type":"string","description":"Stable goal identity."},"revision":{"type":"number","description":"Positive revision; every durable mutation increments it."}},"required":["objective","phase","maxGoalRounds","id","revision"],"additionalProperties":true,"description":"Current durable goal snapshot (the CAS ref for mutations rides on it)."},"roundsStarted":{"type":"number","description":"Highest admitted round number for this goal."},"createdAt":{"type":"number","description":"Epoch milliseconds of the create mutation."},"updatedAt":{"type":"number","description":"Epoch milliseconds of the latest mutation."}},"required":["goal","roundsStarted","createdAt","updatedAt"],"additionalProperties":true}],"description":"The session's current goal and admitted-round count, or `null` before the first create and after a clear tombstone. `goal/change` supplies the whole lifecycle value; matching admitted `user/message` events advance `roundsStarted`."},"plan":{"type":"object","properties":{"active":{"type":"boolean"},"pending":{"type":"boolean"}},"required":["active","pending"],"additionalProperties":true,"description":"Plan collaboration state folded from the plan command lifecycle and `plan/mode` events."}},"required":[],"additionalProperties":true,"description":"Provider-validated values; omitted keys are absent capabilities at this cut."},"kind":{"type":"string","const":"sequenced"}},"required":["asOfSeq","values","kind"],"additionalProperties":true},{"type":"object","properties":{"kind":{"type":"string","const":"migration-required"},"values":{"type":"object","properties":{"inbox":{"type":"object","properties":{"next-turn":{"type":"array","items":{}},"next-step":{"type":"array","items":{}}},"required":["next-turn","next-step"],"additionalProperties":true,"description":"Pending agent input reconstructed from durable inbox splices."},"workingDirectory":{"oneOf":[{"type":"null","const":null},{"type":"string"}],"description":"Recorded current directory for Session observations, or null when none is recorded."},"agentPreset":{"oneOf":[{"type":"null","const":null},{"type":"string"}],"description":"Preset the Session runs, or null when the deployment composes none."},"title":{"oneOf":[{"type":"null","const":null},{"type":"string"}],"description":"The session's current normalized title — the latest `session/title` event's text (last-wins), or `null` before the first title lands. A plain string: the shape the client list rows consume."},"todos":{"oneOf":[{"type":"null","const":null},{"type":"array","items":{"type":"object","properties":{"content":{"type":"string","description":"What this task is — a short imperative line shown in the UI."},"status":{"type":"string","enum":["completed","pending","in_progress"],"description":"Lifecycle state. `in_progress` marks a task being worked now; parallel work may mark several."}},"required":["content","status"],"additionalProperties":true}}],"description":"The agent's current whole todo list (the latest `todo/write` snapshot), or `null` before the first write. Whole-value rule: every `todo/write` carries the complete replacement list, so the fold is last-wins."},"sessionListMetadata":{"type":"object","properties":{"blank":{"type":"boolean","description":"Whether the folded prefix contains no turn."},"lastPromptAt":{"oneOf":[{"type":"null","const":null},{"type":"number"}],"description":"Latest human-authored prompt time in the folded prefix."}},"required":["blank","lastPromptAt"],"additionalProperties":true,"description":"Persisted facts used to summarize a Session without activating it."},"imageLimits":{"type":"object","properties":{"maxImageBytes":{"type":"number"},"maxImagesPerMessage":{"type":"number"},"maxMessageImageBytes":{"type":"number"},"maxImagePixels":{"type":"number"},"maxImageDimension":{"type":"number","description":"Maximum intrinsic width and maximum intrinsic height in pixels for one image."},"mediaTypes":{"type":"array","items":{"type":"string","enum":["image/png","image/jpeg","image/webp","image/gif"]}}},"required":["maxImageBytes","maxImagesPerMessage","maxMessageImageBytes","maxImagePixels","maxImageDimension","mediaTypes"],"additionalProperties":true,"description":"Image-intake limits enforced by the Session prompt endpoint."},"modelSelection":{"type":"object","properties":{"lastUsed":{"oneOf":[{"type":"null","const":null},{"type":"object","properties":{"provider":{"type":"string"},"model":{"type":"string"},"reasoningEffort":{"type":"string"}},"required":["provider","model"],"additionalProperties":true}],"description":"Selection consumed by the latest recorded model request."},"next":{"oneOf":[{"type":"null","const":null},{"type":"object","properties":{"provider":{"type":"string"},"model":{"type":"string"},"reasoningEffort":{"type":"string"}},"required":["provider","model"],"additionalProperties":true}],"description":"Selection the next request should use, falling back to {@link lastUsed}."}},"required":["lastUsed","next"],"additionalProperties":true,"description":"Durable model selection already used and selected for the next request."},"permissions":{"type":"object","properties":{"currentValue":{"type":"string","description":"The effective current value: a configured preset key, `auto`, or `custom`."}},"required":["currentValue"],"additionalProperties":true,"description":"The session's current permission, folded from the three whole-value knob events (`permission/preset`, `sandbox/mode`, `approval/policy`) over the composition defaults. Selectable options come from the process-level catalog Remote. Key absence means no permission service is composed — clients hide the control."},"subagentCatalog":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"number"},"mode":{"type":"string","const":"one-shot"},"label":{"type":"string"}},"required":["id","createdAt","mode"],"additionalProperties":true},{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"number"},"mode":{"type":"string","const":"external"},"label":{"type":"string"}},"required":["id","createdAt","mode"],"additionalProperties":true},{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"number"},"mode":{"type":"string","const":"continuable"},"label":{"type":"string"}},"required":["id","createdAt","mode","label"],"additionalProperties":true},{"type":"object","properties":{"id":{"type":"string"},"createdAt":{"type":"number"},"mode":{"type":"string","const":"unknown"},"label":{"type":"string"}},"required":["id","createdAt","mode"],"additionalProperties":true}]},"description":"Direct children in parent catalog event order, excluding fork-inherited facts."},"subagentTiming":{"type":"object","properties":{"settledMs":{"type":"number","description":"Milliseconds accumulated across completed turns after the child's own descriptor."},"active":{"type":"object","properties":{"since":{"type":"number","description":"Start of the open turn."},"through":{"type":"number","description":"Latest event time folded into this projection cut."}},"required":["since","through"],"additionalProperties":true,"description":"Same-cut bounds of the currently open turn, when one has not reached `turn/end`."},"lastTurnCompleted":{"type":"boolean","description":"Whether the latest closed turn after the child's own descriptor completed normally; absent while a turn is open or before one closes."}},"required":["settledMs"],"additionalProperties":true,"description":"Active-turn duration and latest closed-turn completion for a descriptor-backed subagent session."},"subagent":{"oneOf":[{"type":"null","const":null},{"type":"object","properties":{"mode":{"type":"string","const":"one-shot","description":"A terminal one-shot child."},"label":{"type":"string","description":"Optional durable creation label from the child's descriptor."},"seq":{"type":"number","description":"Seq of the `subagent/descriptor` event this identity was folded from. `session.isOwnSeq(seq)` proves the identity comes from the child's OWN log suffix — where a descriptor is immutable once appended — and not from a fork seed's replayed ancestor descriptor."}},"required":["mode","seq"],"additionalProperties":true},{"type":"object","properties":{"mode":{"type":"string","const":"continuable","description":"A resumable conversation."},"label":{"type":"string","description":"Durable creation label from the child's descriptor."},"seq":{"type":"number","description":"Seq of the folded descriptor event; see the one-shot arm for the own-suffix proof."}},"required":["mode","label","seq"],"additionalProperties":true}],"description":"Identity of a descriptor-backed subagent session. `null` ⟺ no valid descriptor (missing, malformed, or unrecognized-version — deliberately undistinguished). The sentinel is deliberately serializable: a value pushed over JSON transports must survive `JSON.stringify` losslessly, where an `undefined` field would be dropped and a stale identity would survive on the receiving side. The entry itself stays non-optional."},"tokenUsage":{"type":"object","properties":{"uncachedInputTokens":{"type":"number"},"outputTokens":{"type":"number"},"cacheReadTokens":{"type":"number"},"cacheWriteTokens":{"type":"number"}},"required":["uncachedInputTokens","outputTokens","cacheReadTokens","cacheWriteTokens"],"additionalProperties":true,"description":"Provider-reported usage accumulated across the complete durable log."},"contextPressure":{"type":"object","properties":{"pressureTokens":{"type":"number","description":"Provider-reported prompt size of the most recent request: uncached input plus cache reads and writes. Response output is excluded, so this does not grow as the current turn streams. Absent until a provider reports usage."},"projectedTokens":{"type":"number","description":"What the NEXT request's prompt would cost: {@link pressureTokens} plus the heuristic repricing of everything the surface gained or lost since that sample. Only the delta is estimated, so the figure stays anchored to the provider while still reacting the moment a compaction shadows a span — which `pressureTokens` alone cannot do, since compaction reports no usage of its own. Absent until a provider reports usage."},"contextWindow":{"type":"number","description":"Newest recorded route capacity; absent when no adapter advertised one."}},"required":[],"additionalProperties":true,"description":"Newest request pressure paired with the newest known route capacity."},"contextBreakdown":{"type":"object","properties":{"systemTokens":{"type":"number","description":"Heuristic tokens of the last nonempty surviving system prompt in surface order; 0 when none exists."},"toolsTokens":{"type":"number","description":"Heuristic tokens of the newest request envelope's tool schemas; 0 before any request."},"messageTokens":{"type":"number","description":"Heuristic tokens of every other visible surface node, including superseded system prompts."}},"required":["systemTokens","toolsTokens","messageTokens"],"additionalProperties":true,"description":"Heuristic system/tools/message composition of the next request."},"agentTeam":{"type":"object","properties":{"members":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"role":{"type":"string","enum":["lead","teammate"]},"phase":{"type":"string","enum":["failed","provisioning","active"],"description":"Durable lifecycle; the Lead row is always `active`. Turn activity comes from Session status."},"error":{"type":"string"}},"required":["id","name","role","phase"],"additionalProperties":true}},"tasks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"revision":{"type":"number"},"subject":{"type":"string"},"description":{"type":"string"},"status":{"type":"string","enum":["completed","pending","in_progress","deleted"]},"blockedBy":{"type":"array","items":{"type":"string"}},"writeScopes":{"type":"array","items":{"type":"string"}},"ownerName":{"type":"string"},"ready":{"type":"boolean"},"writeScopeWarnings":{"type":"array","items":{"type":"string"}}},"required":["id","revision","subject","description","status","blockedBy","writeScopes","ready","writeScopeWarnings"],"additionalProperties":true}},"failure":{"type":"string"}},"required":["members","tasks"],"additionalProperties":true,"description":"Durable roster and non-deleted task board of the Team rooted at the projected Session."},"userQuestions":{"type":"object","properties":{"active":{"type":"array","items":{"type":"object","properties":{"callId":{"type":"string"},"questions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Stable caller-provided question id, echoed in the answer."},"question":{"type":"string","description":"The question to display."},"detail":{"type":"string","description":"Optional supporting detail rendered with the question but kept out of option labels."},"header":{"type":"string","description":"Optional short heading/group label."},"options":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string","description":"User-facing label."},"description":{"type":"string","description":"Optional extra context rendered by capable UIs."}},"required":["label"],"additionalProperties":true},"description":"Optional choices the UI can render as a menu."},"multiSelect":{"type":"boolean","description":"Whether more than one option may be selected. Defaults to single-select."},"intent":{"type":"object","properties":{"kind":{"type":"string","const":"plan-review","description":"A plan submitted for review: `detail` is the plan markdown `ask()` requires, and the decision approves or declines it."},"approve":{"type":"string","description":"The option label that approves the plan; every other option declines it. Named rather than positional so no UI infers the verdict from option order. An `approve` naming no option of its own question is rejected at `ask()`."},"callId":{"type":"string","description":"Logged tool invocation whose arguments contain the reviewed plan."}},"required":["kind","approve"],"additionalProperties":true,"description":"Optional presentation intent for capable UIs; absent asks for the generic option list."}},"required":["id","question"],"additionalProperties":true}},"state":{"type":"string","enum":["open","continued"]}},"required":["callId","questions","state"],"additionalProperties":true},"description":"Calls that can still take an answer, in ask order."},"settled":{"type":"array","items":{"type":"object","properties":{"callId":{"type":"string","description":"The settled call."},"answers":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"The answered question id."},"selected":{"type":"array","items":{"type":"string"},"description":"Selected option labels. May accompany custom text for a multi-select question."},"custom":{"type":"string","description":"Optional free-text \"Other\" answer."}},"required":["id","selected"],"additionalProperties":true},"description":"The recorded batch, one entry per question; empty when the late reply carried none."}},"required":["callId","answers"],"additionalProperties":true},"description":"Calls an answer settled, in settlement order."}},"required":["active","settled"],"additionalProperties":true,"description":"Timed questions that remain answerable in this Session, and the ones a late reply settled."},"goal":{"oneOf":[{"type":"null","const":null},{"type":"object","properties":{"goal":{"type":"object","properties":{"objective":{"type":"string","description":"Human-requested completion objective."},"phase":{"type":"string","enum":["active","paused","blocked","complete"],"description":"Durable lifecycle phase."},"blockedReason":{"type":"object","properties":{"code":{"type":"string","description":"Stable lower-kebab-case classification chosen by the blocking policy."},"message":{"type":"string","description":"Non-empty explanation shown to humans and models."}},"required":["code","message"],"additionalProperties":true,"description":"Present exactly while `phase` is `blocked`."},"maxGoalRounds":{"type":"number","description":"Total admitted goal-round cap."},"id":{"type":"string","description":"Stable goal identity."},"revision":{"type":"number","description":"Positive revision; every durable mutation increments it."}},"required":["objective","phase","maxGoalRounds","id","revision"],"additionalProperties":true,"description":"Current durable goal snapshot (the CAS ref for mutations rides on it)."},"roundsStarted":{"type":"number","description":"Highest admitted round number for this goal."},"createdAt":{"type":"number","description":"Epoch milliseconds of the create mutation."},"updatedAt":{"type":"number","description":"Epoch milliseconds of the latest mutation."}},"required":["goal","roundsStarted","createdAt","updatedAt"],"additionalProperties":true}],"description":"The session's current goal and admitted-round count, or `null` before the first create and after a clear tombstone. `goal/change` supplies the whole lifecycle value; matching admitted `user/message` events advance `roundsStarted`."},"plan":{"type":"object","properties":{"active":{"type":"boolean"},"pending":{"type":"boolean"}},"required":["active","pending"],"additionalProperties":true,"description":"Plan collaboration state folded from the plan command lifecycle and `plan/mode` events."}},"required":[],"additionalProperties":true}},"required":["kind","values"],"additionalProperties":true}]},
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":498,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":548,"column":9},
     },
-    {
-      id: '@deepseek-ai/dsh-api-session-controller#session/prompt',
+    'session/prompt': {
       service: 'sessionController',
-      namespace: 'session',
-      method: 'prompt',
+      description: 'Admit one prompt after explicitly resuming its Session.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
+          description: 'Session identity, prompt content, source metadata, and delivery mode.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionPromptRequest',
             create: _deepseek_ai_dsh_api_session_controller_session_prompt_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"requestId":{"type":"string","description":"Client-minted identity persisted on the exact accepted user message."},"sessionId":{"type":"string"},"mode":{"type":"string","enum":["queue","steer"]},"content":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":true},{"type":"object","properties":{"type":{"type":"string","const":"image"},"mediaType":{"type":"string","enum":["image/png","image/jpeg","image/webp","image/gif"]},"data":{"type":"string"},"name":{"type":"string"}},"required":["type","mediaType","data"],"additionalProperties":true},{"type":"object","properties":{"type":{"type":"string","const":"file"},"receiptId":{"type":"string"}},"required":["type","receiptId"],"additionalProperties":true}]},"description":"At least one non-whitespace text part or attachment."},"clientTimeZone":{"type":"string"}},"required":["requestId","sessionId","mode","content"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionPromptRequest',
+            create: _deepseek_ai_dsh_api_session_controller_session_prompt_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"requestId":{"type":"string","description":"Client-minted identity persisted on the exact accepted user message."},"sessionId":{"type":"string"},"mode":{"type":"string","enum":["queue","steer"]},"content":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"image"},"mediaType":{"type":"string","enum":["image/png","image/jpeg","image/webp","image/gif"]},"data":{"type":"string"},"name":{"type":"string"}},"required":["type","mediaType","data"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"file"},"receiptId":{"type":"string"}},"required":["type","receiptId"],"additionalProperties":false}]},"description":"At least one non-whitespace text part or attachment."},"clientTimeZone":{"type":"string"}},"required":["requestId","sessionId","mode","content"],"additionalProperties":false},
           },
         },
       ],
@@ -1310,24 +1807,31 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionPromptValue',
         create: _deepseek_ai_dsh_api_session_controller_session_prompt_result$schema,
+        description: 'acknowledgement that the Agent accepted the prompt.',
+        jsonSchema: {"type":"object","properties":{"accepted":{"type":"boolean","const":true}},"required":["accepted"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":433,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":462,"column":9},
     },
-    {
-      id: '@deepseek-ai/dsh-api-session-controller#session/rename',
+    'session/rename': {
       service: 'sessionController',
-      namespace: 'session',
-      method: 'rename',
+      description: 'Rename one Session after explicitly resuming it.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
+          description: 'Session identity and proposed title.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionRenameRequest',
             create: _deepseek_ai_dsh_api_session_controller_session_rename_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string"},"title":{"type":"string"}},"required":["sessionId","title"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionRenameRequest',
+            create: _deepseek_ai_dsh_api_session_controller_session_rename_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string"},"title":{"type":"string"}},"required":["sessionId","title"],"additionalProperties":false},
           },
         },
       ],
@@ -1335,24 +1839,31 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionRenameValue',
         create: _deepseek_ai_dsh_api_session_controller_session_rename_result$schema,
+        description: 'the accepted title and durable event sequence.',
+        jsonSchema: {"type":"object","properties":{"title":{"type":"string"},"seq":{"type":"number"}},"required":["title","seq"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":410,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":431,"column":3},
     },
-    {
-      id: '@deepseek-ai/dsh-api-session-controller#session/search',
+    'session/search': {
       service: 'sessionController',
-      namespace: 'session',
-      method: 'search',
+      description: 'Search visible Session content without resuming an Agent. A non-owner receives only the hits whose Session `allows()` admits; `hasMore` describes the bounded result before that filtering.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
+          description: 'literal message-content query.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionSearchRequest',
             create: _deepseek_ai_dsh_api_session_controller_session_search_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"query":{"type":"string"}},"required":["query"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionSearchRequest',
+            create: _deepseek_ai_dsh_api_session_controller_session_search_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"query":{"type":"string"}},"required":["query"],"additionalProperties":false},
           },
         },
       ],
@@ -1361,24 +1872,31 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionSearchValue',
         create: _deepseek_ai_dsh_api_session_controller_session_search_result$schema,
+        description: 'authorized bounded Session search results.',
+        jsonSchema: {"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"sessionId":{"type":"string"},"snippet":{"type":"string"}},"required":["sessionId","snippet"],"additionalProperties":true}},"hasMore":{"type":"boolean"}},"required":["items","hasMore"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":270,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":290,"column":9},
     },
-    {
-      id: '@deepseek-ai/dsh-api-session-controller#session/selectModel',
+    'session/selectModel': {
       service: 'sessionController',
-      namespace: 'session',
-      method: 'selectModel',
+      description: 'Select one Session-local model after explicitly resuming the Session; save the default in the background.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
+          description: 'Session identity and requested model selection.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionSelectModelRequest',
             create: _deepseek_ai_dsh_api_session_controller_session_selectModel_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string"},"provider":{"type":"string"},"model":{"type":"string"},"reasoningEffort":{"type":"string"}},"required":["sessionId","provider","model"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionSelectModelRequest',
+            create: _deepseek_ai_dsh_api_session_controller_session_selectModel_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string"},"provider":{"type":"string"},"model":{"type":"string"},"reasoningEffort":{"type":"string"}},"required":["sessionId","provider","model"],"additionalProperties":false},
           },
         },
       ],
@@ -1386,24 +1904,31 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionSelectModelValue',
         create: _deepseek_ai_dsh_api_session_controller_session_selectModel_result$schema,
+        description: 'the normalized selection installed for the Session, without waiting for default persistence.',
+        jsonSchema: {"type":"object","properties":{"selected":{"type":"object","properties":{"provider":{"type":"string"},"model":{"type":"string"},"reasoningEffort":{"type":"string"}},"required":["provider","model"],"additionalProperties":true}},"required":["selected"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":290,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":311,"column":3},
     },
-    {
-      id: '@deepseek-ai/dsh-api-session-controller#session/updateQueue',
+    'session/updateQueue': {
       service: 'sessionController',
-      namespace: 'session',
-      method: 'updateQueue',
+      description: 'Mutate one still-pending queue occurrence, resuming a cold Agent first.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
+          description: 'Session, queue item, and requested mutation.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionUpdateQueueRequest',
             create: _deepseek_ai_dsh_api_session_controller_session_updateQueue_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string"},"itemId":{"type":"string"},"action":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"edit"},"content":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":true},"description":"Non-empty text-only replacement content."}},"required":["kind","content"],"additionalProperties":true},{"type":"object","properties":{"kind":{"type":"string","const":"remove"}},"required":["kind"],"additionalProperties":true},{"type":"object","properties":{"kind":{"type":"string","const":"steer"}},"required":["kind"],"additionalProperties":true}]}},"required":["sessionId","itemId","action"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionUpdateQueueRequest',
+            create: _deepseek_ai_dsh_api_session_controller_session_updateQueue_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string"},"itemId":{"type":"string"},"action":{"oneOf":[{"type":"object","properties":{"kind":{"type":"string","const":"edit"},"content":{"type":"array","items":{"type":"object","properties":{"type":{"type":"string","const":"text"},"text":{"type":"string"}},"required":["type","text"],"additionalProperties":false},"description":"Non-empty text-only replacement content."}},"required":["kind","content"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"remove"}},"required":["kind"],"additionalProperties":false},{"type":"object","properties":{"kind":{"type":"string","const":"steer"}},"required":["kind"],"additionalProperties":false}]}},"required":["sessionId","itemId","action"],"additionalProperties":false},
           },
         },
       ],
@@ -1411,24 +1936,31 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SessionUpdateQueueValue',
         create: _deepseek_ai_dsh_api_session_controller_session_updateQueue_result$schema,
+        description: 'acknowledgement that the queue mutation was applied.',
+        jsonSchema: {"type":"object","properties":{"accepted":{"type":"boolean","const":true}},"required":["accepted"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":454,"column":3},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":504,"column":3},
     },
-    {
-      id: '@deepseek-ai/dsh-api-session-controller#session/workspacePathApplications',
+    'session/workspacePathApplications': {
       service: 'sessionController',
-      namespace: 'session',
-      method: 'workspacePathApplications',
+      description: 'Query current file handlers on the serving desktop without activating an Agent.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
+          description: 'file path in Host filesystem syntax.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-session-controller#session/workspacePathApplications:request',
             create: _deepseek_ai_dsh_api_session_controller_session_workspacePathApplications_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"path":{"type":"string"}},"required":["path"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-session-controller#session/workspacePathApplications:request',
+            create: _deepseek_ai_dsh_api_session_controller_session_workspacePathApplications_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"path":{"type":"string"}},"required":["path"],"additionalProperties":false},
           },
         },
       ],
@@ -1437,24 +1969,31 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-session-controller#session/workspacePathApplications:result',
         create: _deepseek_ai_dsh_api_session_controller_session_workspacePathApplications_result$schema,
+        description: 'OS application names, icons, and default selection; empty when desktop opening is unavailable.',
+        jsonSchema: {"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"OS application identifier; callers must revalidate it against the file's current handlers before opening."},"name":{"type":"string"},"default":{"type":"boolean"},"icon":{"oneOf":[{"type":"null","const":null},{"type":"string"}],"description":"PNG or SVG data URL, or null when the desktop supplies no icon."}},"required":["id","name","default","icon"],"additionalProperties":true}},
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":377,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/index.ts","line":398,"column":9},
     },
-    {
-      id: '@deepseek-ai/dsh-api-session-controller#skills/list',
+    'skills/list': {
       service: 'sessionSkillCatalog',
-      namespace: 'skills',
-      method: 'list',
+      description: 'List the user-invocable skills visible to one Session composition.',
       invocation: { kind: 'direct' },
       parameters: [
         {
           name: 'request',
-          wire: 'request',
+          description: 'Session identity whose cwd and preset select the catalog view.',
           source: 'json',
           codec: {
             mode: 'strict',
             typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SkillListRequest',
             create: _deepseek_ai_dsh_api_session_controller_skills_list_parameter_0$schema,
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string"}},"required":["sessionId"],"additionalProperties":true},
+          },
+          strictCodec: {
+            mode: 'strict',
+            typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SkillListRequest',
+            create: _deepseek_ai_dsh_api_session_controller_skills_list_parameter_0_strict$schema,
+            jsonSchema: {"type":"object","properties":{"sessionId":{"type":"string"}},"required":["sessionId"],"additionalProperties":false},
           },
         },
       ],
@@ -1463,10 +2002,12 @@ export const TYPERT_REMOTE = {
         mode: 'strict',
         typeSymbol: '@deepseek-ai/dsh-api-session-controller/types#SkillListValue',
         create: _deepseek_ai_dsh_api_session_controller_skills_list_result$schema,
+        description: 'user-invocable skill metadata without loading skill bodies.',
+        jsonSchema: {"type":"object","properties":{"skills":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string","description":"Absolute SKILL.md path when supplied by a filesystem provider."},"name":{"type":"string","description":"Kebab-case identifier referenced as `/name`."},"description":{"type":"string","description":"Short routing description."},"whenToUse":{"type":"string","description":"Optional extra routing guidance."},"modelInvocable":{"type":"boolean","description":"Whether the same skill is also advertised to the model."}},"required":["name","description","modelInvocable"],"additionalProperties":true}}},"required":["skills"],"additionalProperties":true},
       },
-      sourceLocation: {"file":"packages/api/session-controller/src/skill-catalog.ts","line":35,"column":9},
+      sourceLocation: {"file":"packages/api/session-controller/src/skill-catalog.ts","line":36,"column":9},
     },
-  ],
-}
+  },
+}, z)
 
 export default TYPERT_REMOTE