@deepseek-ai/dsh-tool-cordis 0.1.7-alpha.2 → 0.1.7-rc.2

package/README.i18n.yaml

@@ -1,6 +1,46 @@
-# Bilingual-pair consistency record (docs/i18n/README.md): the git blob hash of each
-# side as of the last confirmed-consistent state. Both languages carry equal authority;
-# after editing either side, bring the other along and re-record with:
+# Bilingual-pair consistency record for README.md (docs/i18n/README.md): per heading
+# section, a hash of its English and Chinese blocks outside code blocks and generated regions.
+# After editing either side, bring the other along and re-record with:
 #   pnpm run verify-translation-pairing --write packages/extensions/tool-cordis/README.md
-README.md: 23e2d4a3d047c1442769e07be045f7da4a24a783
-README.zh.md: da855b7b1d4b4287a1f8d3a5ea7a1fb0c9407f2f
+/:
+  en: 784a82be07311e99
+  zh: 85d917ecc6386ec9
+/deepseek-ai-dsh-tool-cordis:
+  en: ea2c0ac7e7932a08
+  zh: 5562e6f26d700b64
+/deepseek-ai-dsh-tool-cordis/summary:
+  en: 245a3cd287214bed
+  zh: 8687666c28a676cf
+/deepseek-ai-dsh-tool-cordis/table-of-contents:
+  en: d152484eb41ac6b4
+  zh: 3a2f21ff0dc3420d
+/deepseek-ai-dsh-tool-cordis/use-this-package:
+  en: e8c90b0ad037513c
+  zh: 563454508c30d9b0
+/deepseek-ai-dsh-tool-cordis/understand-the-implementation:
+  en: de18fe3471a4a341
+  zh: fda07860cfe1e325
+/deepseek-ai-dsh-tool-cordis/further-exploration:
+  en: 1863373f02bcc196
+  zh: 3efdbf5569411562
+/deepseek-ai-dsh-tool-cordis/model-experience:
+  en: 215e7ba838619b7b
+  zh: a311da3843709f90
+/deepseek-ai-dsh-tool-cordis/model-experience/runtime-inspection:
+  en: 72ffb7cae674c31a
+  zh: 85674f298a78592a
+/deepseek-ai-dsh-tool-cordis/model-experience/runtime-inspection/what-the-model-sees:
+  en: 197fabc06c289f6e
+  zh: e7f1695ee2118ed6
+/deepseek-ai-dsh-tool-cordis/model-experience/runtime-inspection/token-effect:
+  en: 5d9791798f8ce57f
+  zh: b47984cc13e12cfd
+/deepseek-ai-dsh-tool-cordis/model-experience/runtime-inspection/kv-cache-effect:
+  en: f57a20cd4e76d13c
+  zh: 7b673116422bee87
+/deepseek-ai-dsh-tool-cordis/known-limitations-and-deferred-work:
+  en: ffe15dd1fd333dbf
+  zh: b256afc74a1782cb
+/deepseek-ai-dsh-tool-cordis/known-limitations-and-deferred-work/dev-note:
+  en: 0a1253c6f7b5e8b9
+  zh: 9f56528562c7c914

package/lib/types/api-catalog.js

@@ -26,7 +26,7 @@ export const SERVICE_API = [
             },
             {
                 signature: 'async saveSelection(next: ModelSelection): Promise<void>',
-                description: 'Save the complete default model selection. A deployment without a configuration editor keeps its composition entry.',
+                description: 'Save the complete default model selection. A deployment without a configuration editor keeps its composition entry. Saves commit in submission order; a failed save rejects its caller without blocking later saves.',
                 parameters: [{ name: 'next', description: 'resolved selection accepted by an entry point.' }],
                 returns: 'fulfillment after the optional profile write settles.',
             },
@@ -81,9 +81,9 @@ export const SERVICE_API = [
             },
             {
                 signature: '@Remote(\'list\') async remoteExportList(): Promise<AgentPresetRoster>',
-                description: 'Read the selection roster and chooser policy.',
+                description: 'Read the selection roster.',
                 parameters: [],
-                returns: 'Current presets, default and chooser policy.',
+                returns: 'Current presets, each marked when it is the default.',
             },
             {
                 signature: 'async resolve(id?: string): Promise<AgentPreset>',
@@ -91,6 +91,12 @@ export const SERVICE_API = [
                 parameters: [{ name: 'id', description: 'Explicit preset or the current default.' }],
                 returns: 'Current metadata, including failure when activation failed.',
             },
+            {
+                signature: '@Remote(\'read\') readDocument(agentPreset: string): Promise<AgentPresetDocument>',
+                description: 'Read one declaration\'s child plugin list as YAML, for viewing only.',
+                parameters: [{ name: 'agentPreset', description: 'Preset identity.' }],
+                returns: 'The declared composition beside its published metadata.',
+            },
             {
                 signature: 'async mount(ctx: Context, id?: string): Promise<AgentPreset>',
                 description: 'Bind an unpublished Agent to the current preset revision.',
@@ -308,12 +314,6 @@ export const SERVICE_API = [
                 parameters: [{ name: 'agent', description: 'candidate exact live Agent.' }],
                 returns: 'Team membership, or undefined for non-Team subagents and stale identities.',
             },
-            {
-                signature: '@Remote(\'view\') remoteView(agent: Agent): TeamView',
-                description: 'Read the current roster and non-deleted task board through the generated Remote API.',
-                parameters: [{ name: 'agent', description: 'exact live Team member used as the authority credential.' }],
-                returns: 'detached current roster and task views.',
-            },
         ],
     },
     {
@@ -786,21 +786,33 @@ export const SERVICE_API = [
                 returns: 'a snapshot without credentials or PKCE secrets.',
             },
             {
-                signature: 'abstract getProfile(): Promise<AccountDetails[\'profile\'] | null>',
-                description: 'Query Platform profile independently of wallet balances.',
-                parameters: [],
+                signature: 'abstract getProfile(client: AccountClientMetadata): Promise<AccountDetails[\'profile\'] | null>',
+                description: 'Query Platform profile independently of wallet balances. A ready result whose stable profile ID first becomes available or changes notifies watch consumers, so identity consumers re-read getPlatformSession; repeated IDs stay silent.',
+                parameters: [{ name: 'client', description: 'identity of the requesting UI for this call.' }],
                 returns: 'profile outcome, or null if signed out or the grant changed during the query.',
             },
             {
-                signature: 'abstract getBalance(): Promise<AccountDetails[\'balance\'] | null>',
+                signature: 'abstract getBalance(client: AccountClientMetadata): Promise<AccountDetails[\'balance\'] | null>',
                 description: 'Query Platform recharge and bonus wallet balances independently of profile data.',
-                parameters: [],
+                parameters: [{ name: 'client', description: 'identity of the requesting UI for this call.' }],
                 returns: 'balance outcome, or null if signed out or the grant changed during the query.',
             },
             {
-                signature: 'abstract startSignIn(locale: string, callbackOrigin: string, loginSource: \'web\' | \'desktop\'): Promise<AccountView>',
+                signature: 'abstract getUnnotifiedBonuses(client: AccountClientMetadata): Promise<AccountBonusBatch | null>',
+                description: 'Query the granted bonuses Platform has not yet recorded as displayed.',
+                parameters: [{ name: 'client', description: 'identity of the requesting UI for this call; its language selects the server-authored message.' }],
+                returns: 'bonuses with their account, or null if signed out or the grant changed during the query.',
+            },
+            {
+                signature: 'abstract ackBonusNotified(accountId: AccountUserId, orderId: AccountBonusOrderId, client: AccountClientMetadata): Promise<boolean>',
+                description: 'Record one displayed bonus as notified for the account it belongs to.',
+                parameters: [{ name: 'accountId', description: 'account the notification was read for; a different current account is never acknowledged.' }, { name: 'orderId', description: 'granted bonus order the user saw.' }, { name: 'client', description: 'identity of the requesting UI for this call.' }],
+                returns: 'true once Platform records the acknowledgement; false if signed out or the account changed.',
+            },
+            {
+                signature: 'abstract startSignIn(client: AccountClientMetadata, callbackOrigin: string, loginSource: \'web\' | \'desktop\'): Promise<AccountView>',
                 description: 'Join an active attempt or start browser authorization.',
-                parameters: [{ name: 'locale', description: 'active UI language for a new attempt; joining retains its original language.' }, { name: 'callbackOrigin', description: 'browser-accessible loopback HTTP origin, including any SSH local port.' }, { name: 'loginSource', description: 'initiating UI, used to return from a failed exchange.' }],
+                parameters: [{ name: 'client', description: 'identity of the requesting UI; a new attempt captures it, and joining retains the original attempt\'s identity.' }, { name: 'callbackOrigin', description: 'browser-accessible loopback HTTP origin, including any SSH local port.' }, { name: 'loginSource', description: 'initiating UI, used to return from a failed exchange.' }],
                 returns: 'the initial snapshot without waiting for browser approval.',
             },
             {
@@ -810,9 +822,9 @@ export const SERVICE_API = [
                 returns: 'state after cancellation or an already-started commit.',
             },
             {
-                signature: 'abstract signOut(): Promise<AccountView>',
-                description: 'Remove the local grant while retaining API keys and tasks; the provider revokes it in the background.',
-                parameters: [],
+                signature: 'abstract signOut(client: AccountClientMetadata): Promise<AccountView>',
+                description: 'Remove the local grant while retaining API keys; the provider revokes it in the background.',
+                parameters: [{ name: 'client', description: 'identity of the requesting UI, captured for the background revocation retries.' }],
                 returns: 'the signed-out state after local removal; remote failures never restore the grant.',
             },
             {
@@ -827,11 +839,17 @@ export const SERVICE_API = [
                 parameters: [{ name: 'url', description: 'actual request destination or API base URL.' }],
                 returns: 'stored token, or undefined for other origins or a signed-out account.',
             },
+            {
+                signature: 'abstract rejectToken(token: string): Promise<void>',
+                description: 'Remove an inference-rejected token only while it still matches the stored login.',
+                parameters: [{ name: 'token', description: 'token captured by the rejected inference request.' }],
+                returns: 'after matching credentials are removed and the expiry notification is emitted.',
+            },
             {
                 signature: 'abstract getPlatformSession(): Promise<PlatformSession | null>',
-                description: 'Read credentials for the configured Platform origin, bound to their issuing environment.',
+                description: 'Read credentials for the configured Platform origin, bound to their issuing environment, and pair them with the account ID from the last successful profile read; no profile request is made.',
                 parameters: [],
-                returns: 'a Host-only snapshot, or null while signed out.',
+                returns: 'a Host-only snapshot, or null while signed out or when the credential changed during the read.',
             },
         ],
     },
@@ -1337,7 +1355,7 @@ export const SERVICE_API = [
             },
             {
                 signature: 'async listModels(provider: string): Promise<LlmModelInfo[]>',
-                description: 'Discover models advertised by one registered provider. Catalog membership is advisory and never changes routing or request validation.',
+                description: 'Discover models advertised by one registered provider. Catalog membership does not constrain core routing. Catalog-driven entry points may restrict selection and submission to the advertised models.',
                 parameters: [{ name: 'provider', description: 'registered provider route to inspect.' }],
                 returns: 'detached model metadata in adapter-preferred order.',
             },
@@ -1474,7 +1492,7 @@ export const SERVICE_API = [
             },
             {
                 signature: 'current(session: Session): string',
-                description: 'Resolve the preset matching the effective knob values. A still-matching last selection wins shared-bundle ties; otherwise the first configured match wins. Returns CUSTOM_PRESET when no available preset matches.',
+                description: 'Resolve the preset matching the effective knob values. A still-matching last selection wins shared-bundle ties, and a still-selected Auto also matches the `never` approval policy; otherwise the first configured match wins. Returns CUSTOM_PRESET when no available preset matches.',
                 parameters: [{ name: 'session', description: 'the session whose knob state is read.' }],
                 returns: 'the effective preset name, or `custom` when nothing matches.',
             },
@@ -1523,6 +1541,18 @@ export const SERVICE_API = [
         summary: 'Manage profile files and apply their declared reload lifecycle.',
         description: 'Manage profile files and apply their declared reload lifecycle.',
         methods: [
+            {
+                signature: '@Remote listVersionExemptions(): { exemptions: Record<string, string[]>; warnings: string[] }',
+                description: 'Read exact plugin-version exemptions saved in this profile.',
+                parameters: [],
+                returns: 'Accepted package-name@version keys with the runtime versions they may run on, and any record or file problem the reader rejected, which the caller reports instead of failing.',
+            },
+            {
+                signature: '@Remote setVersionExemption(packageVersion: string, runtimeVersion: string, enabled: boolean, acceptRisk?: boolean): Promise<ChangeResult>',
+                description: 'Grant or revoke one exact plugin/runtime exemption and reevaluate live plugins.',
+                parameters: [{ name: 'packageVersion', description: 'Exact manifest package name followed by @ and its version; never an installation spec or alias.' }, { name: 'runtimeVersion', description: 'Exact current DSH version for grants; revocation may name a previous runtime.' }, { name: 'enabled', description: 'Whether to grant rather than revoke the exemption.' }, { name: 'acceptRisk', description: 'Required true for grants after the user accepts possible crashes and data loss.' }],
+                returns: 'Saved and runtime outcomes. Startup-only profiles require restart.',
+            },
             {
                 signature: '@Remote async listPlugins(): Promise<PluginInfo[]>',
                 description: 'Read current plugins, including why a row cannot be changed through the profile patch.',
@@ -1561,7 +1591,7 @@ export const SERVICE_API = [
             },
             {
                 signature: '@Remote installBundle(spec: string, options?: InstallBundleOptions): Promise<ChangeResult>',
-                description: 'Install a package using the same pnpm implementation as dsh plugin. A run that fails, is cancelled, or adds a package without a bundle patch restores `package.json` and `pnpm-lock.yaml` as they were; downloaded files can stay.',
+                description: 'Install a package using the same pnpm implementation as dsh plugin. GitHub repositories get a connection check bounded by githubConnectionTimeoutMs before pnpm starts; only network failures or timeouts stop installation, while pnpm owns authentication and transport fallback. A run that fails, is cancelled, or adds a package without a bundle patch restores `package.json` and `pnpm-lock.yaml` as they were; downloaded files can stay.',
                 parameters: [{ name: 'spec', description: 'One package spec, including local paths relative to the invocation directory.' }, { name: 'options', description: 'Whether to activate the installed bundle (defaults to true), the request id a cancellation names, the pending build scripts to allow for this profile before pnpm runs, and the registry asked first.' }],
                 returns: 'Package-manager diagnostics, the registries asked, and the observed activation outcome.',
             },
@@ -1575,7 +1605,7 @@ export const SERVICE_API = [
                 signature: '@Remote async cancelInstall(requestId: PluginInstallRequestId): Promise<PluginInstallCancellation>',
                 description: 'Stop an installation this manager owns and wait until its files are back.',
                 parameters: [{ name: 'requestId', description: 'The id the installation was started with.' }],
-                returns: '`cancelled` once pnpm exited and the files are restored, `too-late` once the bundle is being applied, `not-running` for any other id.',
+                returns: '`cancelled` once the Git check or pnpm exited and the files are restored, `too-late` once the bundle is being applied, `not-running` for any other id.',
             },
             {
                 signature: '@Remote removeBundle(name: string): Promise<ChangeResult>',
@@ -1710,6 +1740,50 @@ export const SERVICE_API = [
             },
         ],
     },
+    {
+        key: 'schedule',
+        summary: 'Shared management service; reads, deletion, and timing edits never activate a Session.',
+        description: 'Shared management service; reads, deletion, and timing edits never activate a Session.\n\n`sessionPersistence` is a load-order requirement rather than a directly called service: a delivery commits only when `ctx.sessions.flush()` reports that a `session/flush` listener participated, and the persistence backend providing this service is the plugin that registers that listener.',
+        methods: [
+            {
+                signature: 'async create(sessionId: SessionId, request: ScheduleCreateRequest, signal?: AbortSignal): Promise<ScheduleRecord>',
+                description: 'Create a reminder bound to the caller-selected Session without activating it.\n\nThe request must supply a title; a missing, blank-after-trim, or over-long title rejects with `invalid_prompt` instead of deriving one from the prompt. The record is built from the clock reading taken before the request joins the serialized queue, so a create that waits behind a longer operation keeps its request-time anchor and may already be due when the queue reaches it.',
+                parameters: [{ name: 'sessionId', description: 'Original Session receiving the reminder.' }, { name: 'request', description: 'Validated tool selector, required title, and reminder content.' }, { name: 'signal', description: 'Optional cancellation checked before persistence begins, including after FIFO waits.' }],
+                returns: 'The durably stored schedule. Cancellation does not roll back an in-flight write.',
+            },
+            {
+                signature: '@Remote(\'list\') async list(request: ScheduleListRequest): Promise<ScheduleRecord[]>',
+                description: 'Read the selected Session\'s active tasks without resuming its Agent.',
+                parameters: [{ name: 'request', description: 'Session whose task list is requested.' }],
+                returns: 'Persisted reminders in storage order.',
+            },
+            {
+                signature: '@Remote(\'catalog\') async catalog(): Promise<ScheduleCatalogEntry[]>',
+                description: 'Read all active and inactive Host reminders with their original Session bindings. A deleted reminder has no row, so it is absent here. Does not activate Sessions or read Session history.',
+                parameters: [],
+                returns: 'Reminders ordered by scheduledAt ascending, then lexicographically by id.',
+            },
+            {
+                signature: '@Remote(\'history\') async history(request: ScheduleDeliveryHistoryRequest): Promise<ScheduleDeliveryHistoryResult>',
+                description: 'Read saved inbox deliveries without activating or reading the original Session. The task\'s own row supplies its binding, so its records stay readable through this lookup.',
+                parameters: [{ name: 'request', description: 'Session binding, task identity, explicit limit, and optional exclusive message cursor.' }],
+                returns: 'Newest-first deliveries in append order, or a task/cursor lookup failure.',
+                throws: ['ScheduleInputError when limit is not a safe integer from 1 through 100.'],
+            },
+            {
+                signature: '@Remote(\'delete\') async delete(request: ScheduleDeleteRequest, signal?: AbortSignal): Promise<ScheduleDeleteResult>',
+                description: 'Delete one task belonging to the selected Session, leaving queued messages intact.\n\nThe row is removed: the task no longer schedules, leaves `list` and `catalog`, and its saved delivery records go with it.',
+                parameters: [{ name: 'request', description: 'Session and exact task identity.' }, { name: 'signal', description: 'Optional cancellation checked before persistence begins, including after FIFO waits.' }],
+                returns: 'Whether that Session owned a deleted task. Cancellation does not roll back an in-flight write.',
+            },
+            {
+                signature: '@Remote(\'update\') async update(request: ScheduleUpdateRequest, signal?: AbortSignal): Promise<ScheduleUpdateResult>',
+                description: 'Update the name, instruction, and timing of an active task within the original Session binding without activating the Session or changing saved deliveries.\n\nEach supplied field replaces its stored value; an omitted field keeps it. A name or instruction change alone does not reset the committed target.',
+                parameters: [{ name: 'request', description: 'Task binding, complete observed record, and any combination of timing, name, and instruction.' }, { name: 'signal', description: 'Cancellation checked after domain readiness and FIFO waits, before persistence begins.' }],
+                returns: 'The committed record, unchanged record for a no-op, or a non-mutating input/lookup/conflict result. Storage and lifecycle failures reject; cancellation after a write starts does not roll it back.',
+            },
+        ],
+    },
     {
         key: 'sessionController',
         summary: 'Host service backing the generated `ctx.remote.session` namespace.',
@@ -1747,9 +1821,15 @@ export const SERVICE_API = [
             },
             {
                 signature: '@Remote(\'selectModel\') selectModel(request: SessionSelectModelRequest): Promise<SessionSelectModelValue>',
-                description: 'Select one Session-local model after explicitly resuming the Session.',
+                description: 'Select one Session-local model after explicitly resuming the Session; save the default in the background.',
                 parameters: [{ name: 'request', description: 'Session identity and requested model selection.' }],
-                returns: 'the normalized selection installed for the Session.',
+                returns: 'the normalized selection installed for the Session, without waiting for default persistence.',
+            },
+            {
+                signature: '@Remote async initializeDefaultModel(): Promise<void>',
+                description: 'Select the first available account model after login when no provider API key is configured.',
+                parameters: [],
+                returns: 'after saving the first available model or retaining the existing default.',
             },
             {
                 signature: '@Remote(\'modelCatalog\') modelCatalog(): Promise<ModelCatalog>',
@@ -2481,9 +2561,9 @@ export const SERVICE_API = [
                 returns: 'after preferences are saved.',
             },
             {
-                signature: '@Remote prepare(providerId: SpeechProviderId): void',
+                signature: '@Remote prepare(providerId: SpeechProviderId, options?: SpeechPreparationOptions): void',
                 description: 'Start or join one Host-owned preparation task.',
-                parameters: [{ name: 'providerId', description: 'selected recognizer.' }],
+                parameters: [{ name: 'providerId', description: 'selected recognizer.' }, { name: 'options', description: 'task-local source selection validated by the provider.' }],
             },
             {
                 signature: '@Remote cancelPreparation(providerId: SpeechProviderId): Promise<void>',
@@ -2535,9 +2615,9 @@ export const SERVICE_API = [
                 returns: 'after the profile write and the live update it applies.',
             },
             {
-                signature: 'prepare(id: SpeechProviderId): void',
+                signature: 'prepare(id: SpeechProviderId, options?: SpeechPreparationOptions): void',
                 description: 'Start or join provider-owned preparation.',
-                parameters: [{ name: 'id', description: 'exact registered provider identity.' }],
+                parameters: [{ name: 'id', description: 'exact registered provider identity.' }, { name: 'options', description: 'task-local source selection validated by the provider.' }],
             },
             {
                 signature: 'async cancelPreparation(id: SpeechProviderId): Promise<void>',
@@ -2717,10 +2797,10 @@ export const SERVICE_API = [
             },
             {
                 signature: 'listDescendants(rootSessionId: SessionId, signal?: AbortSignal): Promise<SubagentDescendantListEntry[]>',
-                description: 'Enumerate the root\'s complete session-backed subagent tree in stable pre-order from one live-preferred corpus, without loading or resuming an Agent. Ordinary sessions and one-shot children remain traversal nodes so continuable descendants below them are discovered; each returned entry adds its durable `parentId` and root-relative `depth`. Identity resolution, diagnostics, optional persistence, and cancellation use the registered child identity projection and complete Session corpus.',
-                parameters: [{ name: 'rootSessionId', description: 'session whose complete descendant tree is listed.' }, { name: 'signal', description: 'caller-owned cancellation forwarded to persistence reads and observed around every read await.' }],
-                returns: 'children and per-candidate diagnostics with tree position, in stable pre-order.',
-                throws: ['{@link SubagentError} when listing dependencies are unavailable or the caller cancels.'],
+                description: 'Recursively list reachable parent catalogs in stable pre-order, preserving each catalog\'s event order. Each row carries its catalog parent and depth; one-shot and unknown-mode children remain traversal nodes. Unknown modes produce unsupported diagnostics. Unreadable child catalogs produce corrupt or unavailable diagnostics and stop only that branch. Root read failures, missing services or projections, and cancellation reject the whole listing. Each catalog is observed once and released before the next read. No Agent is loaded or resumed; Sessions absent from reachable catalogs are omitted.',
+                parameters: [{ name: 'rootSessionId', description: 'session whose catalog starts descendant discovery.' }, { name: 'signal', description: 'cancellation forwarded to and checked around each catalog read.' }],
+                returns: 'children and branch diagnostics in parent-catalog pre-order.',
+                throws: ['{@link SubagentError} when listing dependencies are unavailable or the caller cancels.', 'SessionQueryError when the root catalog cannot be read.'],
             },
             {
                 signature: '@Remote(\'prompt\') async prompt(request: SubagentPromptRequest, signal: AbortSignal): Promise<SubagentPromptReceipt>',
@@ -3357,9 +3437,9 @@ export const SERVICE_API = [
                 returns: 'the Workspace and whether this call created it.',
             },
             {
-                signature: '@Remote(\'initializeDefault\') async initializeDefault(request: WorkspaceInitializeDefaultRequest, signal: AbortSignal): Promise<WorkspaceValue | undefined>',
-                description: 'Initialize or reuse the default Workspace during first-use startup.',
-                parameters: [{ name: 'request', description: 'initial directory name and title; never rename an existing default.' }, { name: 'signal', description: 'caller lifetime; cancels native directory lookup.' }],
+                signature: '@Remote(\'initializeDefault\') async initializeDefault(signal: AbortSignal): Promise<WorkspaceValue | undefined>',
+                description: 'Initialize or reuse the default Workspace during first-use startup. The directory name is fixed, so the Host never renames or relocates an existing default; its initial title is that same name, which browser consumers label in the reader\'s language.',
+                parameters: [{ name: 'signal', description: 'caller lifetime; cancels native directory lookup.' }],
                 returns: 'the durable Workspace, or undefined when first-use initialization is ineligible; creates no Session or message.',
             },
             {
@@ -3468,9 +3548,9 @@ export const SERVICE_API = [
                 returns: 'the existing or newly durable workspace.',
             },
             {
-                signature: 'initializeDefault(resolveDirectory: () => Promise<{ path: string; title: string }>): Promise<Workspace | undefined>',
+                signature: 'initializeDefault(resolveDirectory: () => Promise<string>): Promise<Workspace | undefined>',
                 description: 'Initialize the default Workspace only while both the registry and Session history are empty. Repeated requests reuse its durable identity; deleting that registration permanently disables automatic creation.',
-                parameters: [{ name: 'resolveDirectory', description: 'resolve the absolute directory and initial title; called only for eligible creation, inside the registry mutation queue. Missing directories are created recursively before registration. After resolution, caller cancellation does not roll back creation or registration.' }],
+                parameters: [{ name: 'resolveDirectory', description: 'resolve the absolute directory; called only for eligible creation, inside the registry mutation queue. Missing directories are created recursively before registration, and the initial title is the requested directory\'s own final segment — not the canonical one, so a symlink at that path does not retitle the Workspace after its target. After resolution, caller cancellation does not roll back creation or registration.' }],
                 returns: 'the initialized Workspace, or undefined when automatic creation is ineligible.',
             },
             {
@@ -3796,6 +3876,30 @@ export const EVENT_API = [
         description: 'Committed change to a provider-managed credential source: a `set`, an `unset`, or an external edit observed in storage. Ambient process-environment changes are not observable and never emit. Listener failures are contained and logged — a sync throw and an async rejection alike — without changing the committed operation\'s outcome, except `INVARIANT`-coded failures, which rethrow after every listener ran; that rethrow reaches the emitter only from synchronous listeners, so invariant checks on this event must not be async functions.',
         parameters: [{ name: 'ref', description: 'the reference whose stored value changed.' }],
     },
+    {
+        name: 'deepseek-account/model-sign-in-required',
+        mode: 'emit',
+        signature: '\'deepseek-account/model-sign-in-required\'(): void',
+        summary: 'An account model request requires the user to sign in.',
+        description: 'An account model request requires the user to sign in.',
+        parameters: [],
+    },
+    {
+        name: 'deepseek-account/session-expired',
+        mode: 'emit',
+        signature: '\'deepseek-account/session-expired\'(): void',
+        summary: 'Server rejection removed the current account credential; this notification is not replayed.',
+        description: 'Server rejection removed the current account credential; this notification is not replayed.',
+        parameters: [],
+    },
+    {
+        name: 'deepseek-account/signed-out',
+        mode: 'emit',
+        signature: '\'deepseek-account/signed-out\'(): void',
+        summary: 'Local grant removal has completed.',
+        description: 'Local grant removal has completed.',
+        parameters: [],
+    },
     {
         name: 'domain/changed',
         mode: 'emit',
@@ -3916,6 +4020,14 @@ export const EVENT_API = [
         description: 'An installation moved between its Host phases. `installing` is announced once per registry the installation asks, with the attempt\'s registry and position; `cancelling` and `applying` once.',
         parameters: [{ name: 'progress', description: 'the installation\'s request id and phase, with the attempt while installing.' }],
     },
+    {
+        name: 'schedule/changed',
+        mode: 'emit',
+        signature: '\'schedule/changed\'(): void',
+        summary: 'Durable task set changed; clients refetch global task and Session-active catalogs.',
+        description: 'Durable task set changed; clients refetch global task and Session-active catalogs.',
+        parameters: [],
+    },
     {
         name: 'session-telemetry/record',
         mode: 'waterfall',
@@ -4151,6 +4263,22 @@ export const EVENT_API = [
 ];
 /** Shapes of every exported type the Service and Event signatures reference (transitively), sorted by name. */
 export const TYPE_API = [
+    {
+        name: 'AccountBonusBatch',
+        declaration: 'export interface AccountBonusBatch {\n    readonly accountId: AccountUserId;\n    readonly bonuses: readonly AccountBonusNotification[];\n}',
+    },
+    {
+        name: 'AccountBonusNotification',
+        declaration: 'export interface AccountBonusNotification {\n    readonly orderId: AccountBonusOrderId;\n    readonly campaign: string;\n    readonly amount: string;\n    readonly currency: \'CNY\' | \'USD\';\n    readonly grantedAt: string;\n    readonly expiresAt: string;\n    readonly message: string;\n}',
+    },
+    {
+        name: 'AccountBonusOrderId',
+        declaration: 'export type AccountBonusOrderId = Branded<\'AccountBonusOrderId\'>;',
+    },
+    {
+        name: 'AccountClientMetadata',
+        declaration: 'export interface AccountClientMetadata {\n    readonly version: string;\n    readonly locale: string;\n    readonly timezoneOffsetSeconds: number;\n}',
+    },
     {
         name: 'AccountDetails',
         declaration: 'export interface AccountDetails {\n    readonly profile: {\n        readonly status: \'ready\';\n        readonly value: AccountProfile;\n    } | {\n        readonly status: \'failed\';\n    };\n    readonly balance: {\n        readonly status: \'ready\';\n        readonly value: readonly AccountWallet[];\n        readonly bonusWallets: readonly AccountWallet[];\n    } | {\n        readonly status: \'failed\';\n    };\n}',
@@ -4183,6 +4311,10 @@ export const TYPE_API = [
         name: 'AdmittedPromptContentPart',
         declaration: 'export type AdmittedPromptContentPart = {\n    readonly type: \'text\';\n    readonly text: string;\n} | {\n    readonly type: \'image\';\n    readonly attachment: ImageAttachmentRef;\n} | {\n    readonly type: \'file\';\n    readonly attachment: FileAttachmentRef;\n};',
     },
+    {
+        name: 'AfterScheduleRecord',
+        declaration: 'export interface AfterScheduleRecord {\n    readonly id: ScheduleId;\n    readonly kind: \'after\';\n    readonly title: string;\n    readonly prompt: string;\n    readonly afterSeconds: number;\n    readonly scheduledAt: string;\n}',
+    },
     {
         name: 'Agent',
         declaration: 'export interface Agent {\n    readonly id: SessionId;\n}',
@@ -4211,9 +4343,13 @@ export const TYPE_API = [
         name: 'AgentPresetCompositionRow',
         declaration: 'export interface AgentPresetCompositionRow {\n    readonly entryId: string | null;\n    readonly moduleName: string;\n    readonly enabled: CompositionRowEnablement;\n    readonly condition?: string;\n    readonly fiberState?: FiberState;\n}',
     },
+    {
+        name: 'AgentPresetDocument',
+        declaration: 'export interface AgentPresetDocument {\n    readonly agentPreset: string;\n    readonly content: string;\n    readonly name?: string;\n    readonly description?: string;\n}',
+    },
     {
         name: 'AgentPresetRoster',
-        declaration: 'export interface AgentPresetRoster {\n    readonly presets: readonly AgentPresetRow[];\n    readonly modeSelectionEnabled: boolean;\n}',
+        declaration: 'export interface AgentPresetRoster {\n    readonly presets: readonly AgentPresetRow[];\n}',
     },
     {
         name: 'AgentPresetRow',
@@ -4261,7 +4397,7 @@ export const TYPE_API = [
     },
     {
         name: 'ApprovalRequestEvent',
-        declaration: 'export interface ApprovalRequestEvent {\n    readonly agent: Agent;\n    readonly toolName: string;\n    readonly callId?: ToolCallId;\n    readonly reason?: string;\n    readonly signal?: AbortSignal;\n}',
+        declaration: 'export interface ApprovalRequestEvent {\n    readonly agent: Agent;\n    readonly toolName: string;\n    readonly callId?: ToolCallId;\n    readonly reason?: string;\n    readonly displayReason?: {\n        readonly en: string;\n        readonly [locale: string]: string;\n    };\n    readonly signal?: AbortSignal;\n}',
     },
     {
         name: 'ArchiveSessionOptions',
@@ -4323,6 +4459,14 @@ export const TYPE_API = [
         name: 'AssistantStreamRecord',
         declaration: 'export type AssistantStreamRecord = {\n    readonly type: \'text-chunks\';\n    readonly time0: number;\n    readonly index: number;\n    readonly dt: readonly number[];\n    readonly texts: readonly string[];\n} | {\n    readonly type: \'reasoning-chunks\';\n    readonly time0: number;\n    readonly index: number;\n    readonly dt: readonly number[];\n    readonly texts: readonly string[];\n} | {\n    readonly type: \'tool-call-chunks\';\n    readonly time0: number;\n    readonly index: number;\n    readonly dt: readonly number[];\n    readonly id: ToolCallId;\n    readonly name?: string;\n    readonly args: readonly string[];\n} | {\n    readonly type: \'chunk\';\n    readonly time: number;\n    readonly chunk: StreamChunk;\n};',
     },
+    {
+        name: 'AtInput',
+        declaration: 'export type AtInput = string | LocalAtInput;',
+    },
+    {
+        name: 'AtScheduleRecord',
+        declaration: 'export interface AtScheduleRecord {\n    readonly id: ScheduleId;\n    readonly kind: \'at\';\n    readonly title: string;\n    readonly prompt: string;\n    readonly scheduledAt: string;\n}',
+    },
     {
         name: 'AttachmentAdmissionPart',
         declaration: 'export type AttachmentAdmissionPart = PromptContentPart | {\n    readonly type: \'file\';\n    readonly attachment: FileAttachmentRef;\n};',
@@ -4703,6 +4847,22 @@ export const TYPE_API = [
         name: 'CredentialRef',
         declaration: 'export type CredentialRef = Branded<\'CredentialRef\'>;',
     },
+    {
+        name: 'CronInput',
+        declaration: 'export interface CronInput {\n    readonly expression: string;\n    readonly time_zone: string;\n}',
+    },
+    {
+        name: 'CronScheduleRecord',
+        declaration: 'export interface CronScheduleRecord {\n    readonly id: ScheduleId;\n    readonly kind: \'cron\';\n    readonly title: string;\n    readonly prompt: string;\n    readonly expression: string;\n    readonly timeZone: string;\n    readonly scheduledAt: string;\n}',
+    },
+    {
+        name: 'DailyInput',
+        declaration: 'export interface DailyInput {\n    readonly time: string;\n    readonly time_zone: string;\n}',
+    },
+    {
+        name: 'DailyScheduleRecord',
+        declaration: 'export interface DailyScheduleRecord {\n    readonly id: ScheduleId;\n    readonly kind: \'daily\';\n    readonly title: string;\n    readonly prompt: string;\n    readonly time: string;\n    readonly timeZone: string;\n    readonly scheduledAt: string;\n}',
+    },
     {
         name: 'DeepSeekLlmApiExtensionMap',
         declaration: 'export interface DeepSeekLlmApiExtensionMap {\n}',
@@ -4719,6 +4879,10 @@ export const TYPE_API = [
         name: 'DeepSeekLlmApiJson',
         declaration: 'export type DeepSeekLlmApiJson = null | boolean | number | string | DeepSeekLlmApiJson[] | {\n    [key: string]: DeepSeekLlmApiJson;\n};',
     },
+    {
+        name: 'DeliveryRetentionBounds',
+        declaration: 'export interface DeliveryRetentionBounds {\n    readonly days: number;\n    readonly records: number;\n}',
+    },
     {
         name: 'DeveloperMessage',
         declaration: 'export interface DeveloperMessage extends MessageBase {\n    readonly role: \'developer\';\n}',
@@ -4847,6 +5011,10 @@ export const TYPE_API = [
         name: 'EpochHeader',
         declaration: 'export interface EpochHeader {\n    config: LlmCallConfig;\n    adapterDefaults?: LlmCallConfigAdapterDefaults;\n    tools?: ToolSchema[];\n    system?: never;\n}',
     },
+    {
+        name: 'EveryScheduleRecord',
+        declaration: 'export interface EveryScheduleRecord {\n    readonly id: ScheduleId;\n    readonly kind: \'every\';\n    readonly title: string;\n    readonly prompt: string;\n    readonly everySeconds: number;\n    readonly scheduledAt: string;\n}',
+    },
     {
         name: 'FeedbackCategory',
         declaration: 'export type FeedbackCategory = \'task-result\' | \'instruction-following\' | \'product-interaction\' | \'service-stability\' | \'resource-cost\' | \'security-privacy-permission\' | \'other\';',
@@ -4891,6 +5059,10 @@ export const TYPE_API = [
         name: 'FinishReasonMap',
         declaration: 'export interface FinishReasonMap {\n    \'stop\': {\n        kind: \'stop\';\n    };\n    \'tool-calls\': {\n        kind: \'tool-calls\';\n    };\n    \'max-tokens\': {\n        kind: \'max-tokens\';\n    };\n    \'aborted\': {\n        kind: \'aborted\';\n        failure: LlmFailure;\n    };\n    \'error\': {\n        kind: \'error\';\n        failure: LlmFailure;\n    };\n}',
     },
+    {
+        name: 'FrequencyTooHighError',
+        declaration: 'export interface FrequencyTooHighError {\n    readonly code: \'frequency_too_high\';\n    readonly message: string;\n}',
+    },
     {
         name: 'FsDirEntry',
         declaration: 'export interface FsDirEntry {\n    name: string;\n    type: \'file\' | \'directory\' | \'other\';\n    target: FsTarget;\n    version?: FsVersion;\n    size?: number;\n}',
@@ -4937,7 +5109,7 @@ export const TYPE_API = [
     },
     {
         name: 'GenerateOptions',
-        declaration: 'export interface GenerateOptions {\n    provider: string;\n    model: string;\n    reasoningEffort?: ReasoningEffortId;\n    messages: RequestMessage[];\n    system?: string;\n    tools?: ToolSchema[];\n    temperature?: number;\n    maxTokens?: number;\n    stop?: string[];\n    signal?: AbortSignal;\n    sessionId?: Branded<\'SessionId\'>;\n    purpose?: \'compaction\' | \'session-title\';\n}',
+        declaration: 'export interface GenerateOptions {\n    provider: string;\n    model: string;\n    reasoningEffort?: ReasoningEffortId;\n    messages: RequestMessage[];\n    system?: string;\n    tools?: ToolSchema[];\n    toolHistory?: ToolHistory;\n    temperature?: number;\n    maxTokens?: number;\n    stop?: string[];\n    signal?: AbortSignal;\n    sessionId?: Branded<\'SessionId\'>;\n    purpose?: \'compaction\' | \'session-title\';\n}',
     },
     {
         name: 'GenericCallView',
@@ -5023,6 +5195,10 @@ export const TYPE_API = [
         name: 'ImageVariantId',
         declaration: 'export type ImageVariantId = Branded<\'ImageVariantId\'>;',
     },
+    {
+        name: 'IncompatiblePlugin',
+        declaration: 'export interface IncompatiblePlugin {\n    name: string;\n    version: string;\n    runtimeVersion: string;\n    peers: Record<string, string>;\n}',
+    },
     {
         name: 'IndexInjection',
         declaration: 'export type IndexInjection = {\n    kind: \'global\';\n    name: string;\n    value: unknown;\n} | {\n    kind: \'script\';\n    placement: IndexInjectionPlacement;\n    text: string;\n} | {\n    kind: \'script-src\';\n    placement: IndexInjectionPlacement;\n    src: string;\n} | {\n    kind: \'script-preload\';\n    src: string;\n} | {\n    kind: \'style\';\n    text: string;\n} | {\n    kind: \'html\';\n    placement: IndexInjectionPlacement;\n    html: string;\n};',
@@ -5059,6 +5235,26 @@ export const TYPE_API = [
         name: 'InstallSpecKind',
         declaration: 'export type InstallSpecKind = \'registry\' | \'path\' | \'git\' | \'tarball\';',
     },
+    {
+        name: 'InternalScheduleError',
+        declaration: 'export interface InternalScheduleError {\n    readonly code: \'internal_error\';\n    readonly message: string;\n}',
+    },
+    {
+        name: 'InvalidPromptError',
+        declaration: 'export interface InvalidPromptError {\n    readonly code: \'invalid_prompt\';\n    readonly message: string;\n}',
+    },
+    {
+        name: 'InvalidRuleError',
+        declaration: 'export interface InvalidRuleError {\n    readonly code: \'invalid_rule\';\n    readonly message: string;\n}',
+    },
+    {
+        name: 'InvalidSelectorError',
+        declaration: 'export interface InvalidSelectorError {\n    readonly code: \'invalid_selector\';\n    readonly message: string;\n}',
+    },
+    {
+        name: 'InvalidTimeZoneError',
+        declaration: 'export interface InvalidTimeZoneError {\n    readonly code: \'invalid_time_zone\';\n    readonly message: string;\n}',
+    },
     {
         name: 'InvariantFailure',
         declaration: 'export type InvariantFailure = (message: string) => never;',
@@ -5285,12 +5481,16 @@ export const TYPE_API = [
     },
     {
         name: 'LlmResolvedModelInfo',
-        declaration: 'export interface LlmResolvedModelInfo extends LlmModelInfo {\n    context?: LlmModelContext;\n    defaultMaxTokens?: number;\n    reasoning?: LlmModelReasoningInfo;\n    systemPromptUpdate?: SystemPromptUpdate;\n}',
+        declaration: 'export interface LlmResolvedModelInfo extends LlmModelInfo {\n    context?: LlmModelContext;\n    defaultMaxTokens?: number;\n    reasoning?: LlmModelReasoningInfo;\n    systemPromptUpdate?: SystemPromptUpdate;\n    toolUpdate?: ToolUpdate;\n}',
     },
     {
         name: 'LlmRuntime',
         declaration: 'export class LlmRuntime extends TypertRemoteService {\n    constructor(ctx: Context);\n    registerAdapter(providers: string[], adapter: LlmAdapter): AdapterRegistrationHandle;\n    @Remote\n    listProviders(): LlmProviderInfo[];\n    registerConfigurableProviders(entries: readonly LlmConfigurableProvider[]): DirectoryRegistrationHandle;\n    @Remote\n    listConfigurableProviders(): LlmConfigurableProvider[];\n    registerModelDiscovery(settingsNs: string, discover: (request: LlmModelDiscoveryRequest, signal?: AbortSignal) => Promise<readonly LlmDiscoveredModel[]>): () => void;\n    async discoverModels(settingsNs: string, request: LlmModelDiscoveryRequest, signal?: AbortSignal): Promise<LlmDiscoveredModel[]>;\n    @Remote(\'discoverModels\')\n    async remoteDiscoverModels(settingsNs: string, request: LlmModelDiscoveryRequest, signal: AbortSignal): Promise<LlmDiscoveredModel[]>;\n    providerRetryPolicy(provider: string): ResolvedRetryPolicy;\n    imageRequestPricing(provider: string, model: string): LlmImageRequestPricing | undefined;\n    fileRequestText(ref: FileAttachmentRef): string;\n    async listModels(provider: string): Promise<LlmModelInfo[]>;\n    async resolveModelInfo(provider: string, model: string, signal?: AbortSignal): Promise<LlmResolvedModelInfo>;\n    async resolveCallConfig(config: LlmCallConfig, signal?: AbortSignal): Promise<LlmCallConfig>;\n    async prepareCall(config: LlmCallConfig, signal?: AbortSignal): Promise<PreparedLlmCall>;\n    stream(options: GenerateOptions) /* …truncated — full shape in source */',
     },
+    {
+        name: 'LocalAtInput',
+        declaration: 'export interface LocalAtInput {\n    readonly date: string;\n    readonly time: string;\n    readonly time_zone: string;\n}',
+    },
     {
         name: 'LocalizedText',
         declaration: 'export type LocalizedText = string | {\n    readonly en: string;\n    readonly [locale: string]: string;\n};',
@@ -5337,7 +5537,7 @@ export const TYPE_API = [
     },
     {
         name: 'ManagementError',
-        declaration: 'export interface ManagementError {\n    code: ReadOnlyReason | \'unknown-plugin\' | \'invalid-spec\' | \'ambiguous-install\' | \'not-bundle\' | \'not-removable\' | \'stop-profile\' | \'bundle-in-use\' | \'stale-approval\' | \'operation-error\';\n    diagnostic?: string;\n}',
+        declaration: 'export interface ManagementError {\n    code: ReadOnlyReason | \'unknown-plugin\' | \'invalid-spec\' | \'ambiguous-install\' | \'not-bundle\' | \'not-removable\' | \'stop-profile\' | \'bundle-in-use\' | \'stale-approval\' | \'incompatible-version\' | \'operation-error\';\n    diagnostic?: string;\n    incompatible?: IncompatiblePlugin[];\n}',
     },
     {
         name: 'ManualCompactAgentContext',
@@ -5483,6 +5683,10 @@ export const TYPE_API = [
         name: 'NativeFileApplication',
         declaration: 'export interface NativeFileApplication {\n    readonly id: string;\n    readonly name: string;\n    readonly default: boolean;\n    readonly icon: string | null;\n}',
     },
+    {
+        name: 'NotFutureError',
+        declaration: 'export interface NotFutureError {\n    readonly code: \'not_future\';\n    readonly message: string;\n}',
+    },
     {
         name: 'ObjectJsonSchema',
         declaration: 'export type ObjectJsonSchema = JsonSchemaNode & {\n    type: \'object\';\n};',
@@ -5515,6 +5719,10 @@ export const TYPE_API = [
         name: 'OfficeToPdfResult',
         declaration: 'export interface OfficeToPdfResult {\n    readonly pdf: Uint8Array;\n    readonly missingFonts: string[];\n    readonly cacheKey: OfficeToPdfKey;\n    readonly generation: OfficeToPdfGeneration;\n}',
     },
+    {
+        name: 'OneShotScheduleRecord',
+        declaration: 'export type OneShotScheduleRecord = AfterScheduleRecord | AtScheduleRecord;',
+    },
     {
         name: 'OneShotSubagentDescriptorData',
         declaration: 'export interface OneShotSubagentDescriptorData extends SubagentDescriptorBase {\n    readonly mode: \'one-shot\';\n    readonly label?: string;\n}',
@@ -5525,7 +5733,7 @@ export const TYPE_API = [
     },
     {
         name: 'PackageResult',
-        declaration: 'export interface PackageResult {\n    exitCode: number;\n    output: string;\n    truncated: boolean;\n    logPath: string;\n    kind?: PluginInstallFailureKind;\n}',
+        declaration: 'export interface PackageResult {\n    exitCode: number;\n    output: string;\n    truncated: boolean;\n    logPath: string;\n    kind?: PluginInstallFailureKind;\n    timedOut?: boolean;\n    incompatible?: IncompatiblePlugin[];\n}',
     },
     {
         name: 'PeerAdmission',
@@ -5545,7 +5753,7 @@ export const TYPE_API = [
     },
     {
         name: 'PlatformSession',
-        declaration: 'export interface PlatformSession {\n    readonly origin: string;\n    readonly token: string;\n    readonly embeddedPageDist?: string;\n    readonly requestHeaders?: Readonly<Record<string, string>>;\n}',
+        declaration: 'export interface PlatformSession {\n    readonly origin: string;\n    readonly token: string;\n    readonly userId: AccountUserId | null;\n    readonly embeddedPageDist?: string;\n    readonly requestHeaders?: Readonly<Record<string, string>>;\n}',
     },
     {
         name: 'PluginChange',
@@ -5621,7 +5829,7 @@ export const TYPE_API = [
     },
     {
         name: 'PreparedLlmCall',
-        declaration: 'export interface PreparedLlmCall {\n    readonly config: LlmCallConfig;\n    readonly retryPolicy: ResolvedRetryPolicy;\n    readonly context?: LlmModelContext;\n    readonly inputModalities?: readonly ModelModality[];\n    readonly systemPromptUpdate?: SystemPromptUpdate;\n    readonly adapterDefaults: LlmCallConfigAdapterDefaults;\n    stream(options: GenerateOptions): AsyncIterable<StreamChunk>;\n}',
+        declaration: 'export interface PreparedLlmCall {\n    readonly config: LlmCallConfig;\n    readonly retryPolicy: ResolvedRetryPolicy;\n    readonly context?: LlmModelContext;\n    readonly inputModalities?: readonly ModelModality[];\n    readonly systemPromptUpdate?: SystemPromptUpdate;\n    readonly toolUpdate?: ToolUpdate;\n    readonly adapterDefaults: LlmCallConfigAdapterDefaults;\n    stream(options: GenerateOptions): AsyncIterable<StreamChunk>;\n}',
     },
     {
         name: 'PreparedReferencedMessage',
@@ -5649,7 +5857,7 @@ export const TYPE_API = [
     },
     {
         name: 'PreToolDecision',
-        declaration: 'export type PreToolDecision = {\n    kind: \'allow\';\n} | {\n    kind: \'deny\';\n    reason: string;\n    info?: ToolErrorInfo;\n} | {\n    kind: \'cancel\';\n} | {\n    kind: \'ask\';\n    reason?: string;\n};',
+        declaration: 'export type PreToolDecision = {\n    kind: \'allow\';\n} | {\n    kind: \'deny\';\n    reason: string;\n    info?: ToolErrorInfo;\n} | {\n    kind: \'cancel\';\n} | {\n    kind: \'ask\';\n    reason?: string;\n    displayReason?: {\n        readonly en: string;\n        readonly [locale: string]: string;\n    };\n};',
     },
     {
         name: 'ProductTelemetryRecord',
@@ -5783,6 +5991,10 @@ export const TYPE_API = [
         name: 'ReasoningEffortId',
         declaration: 'export type ReasoningEffortId = Branded<\'ReasoningEffortId\'>;',
     },
+    {
+        name: 'RecurringScheduleRecord',
+        declaration: 'export type RecurringScheduleRecord = EveryScheduleRecord | DailyScheduleRecord | WeeklyScheduleRecord | CronScheduleRecord;',
+    },
     {
         name: 'RedactedSecret',
         declaration: 'export interface RedactedSecret {\n    path: string[];\n    set: boolean;\n}',
@@ -5923,6 +6135,38 @@ export const TYPE_API = [
         name: 'SaveTextSpill',
         declaration: 'export interface SaveTextSpill {\n    owner: SpillOwner;\n    source: SpillSource;\n    suggestedName: string;\n    content: string;\n}',
     },
+    {
+        name: 'ScheduleCatalogEntry',
+        declaration: 'export type ScheduleCatalogEntry = ScheduleRecord & {\n    readonly sessionId: SessionId;\n    readonly status: \'active\' | \'inactive\';\n    readonly lastDelivery?: ScheduleDeliveryReceipt;\n};',
+    },
+    {
+        name: 'ScheduleCreateRequest',
+        declaration: 'export interface ScheduleCreateRequest {\n    prompt: string;\n    title: string;\n    after_seconds?: number;\n    at?: AtInput;\n    every_seconds?: number;\n    daily?: DailyInput;\n    weekly?: WeeklyInput;\n    cron?: CronInput;\n}',
+    },
+    {
+        name: 'ScheduleDeleteRequest',
+        declaration: 'export interface ScheduleDeleteRequest extends ScheduleListRequest {\n    id: ScheduleId;\n}',
+    },
+    {
+        name: 'ScheduleDeleteResult',
+        declaration: 'export type ScheduleDeleteResult = {\n    readonly id: ScheduleId;\n    readonly deleted: true;\n} | {\n    readonly id: ScheduleId;\n    readonly deleted: false;\n    readonly code: \'schedule_not_found\';\n};',
+    },
+    {
+        name: 'ScheduleDeliveryHistoryRequest',
+        declaration: 'export interface ScheduleDeliveryHistoryRequest extends ScheduleDeleteRequest {\n    limit: number;\n    before?: MessageId;\n}',
+    },
+    {
+        name: 'ScheduleDeliveryHistoryResult',
+        declaration: 'export type ScheduleDeliveryHistoryResult = {\n    readonly id: ScheduleId;\n    readonly records: ScheduleDeliveryRecord[];\n    readonly earlierRecordsUnavailable: boolean;\n    readonly earlierRecordsPruned: boolean;\n    readonly retention: DeliveryRetentionBounds;\n    readonly nextBefore?: MessageId;\n} | {\n    readonly id: ScheduleId;\n    readonly code: \'schedule_not_found\' | \'delivery_cursor_not_found\';\n};',
+    },
+    {
+        name: 'ScheduleDeliveryReceipt',
+        declaration: 'export interface ScheduleDeliveryReceipt {\n    readonly scheduledAt: string;\n    readonly deliveredAt: string;\n    readonly messageId: MessageId;\n}',
+    },
+    {
+        name: 'ScheduleDeliveryRecord',
+        declaration: 'export interface ScheduleDeliveryRecord extends ScheduleDeliveryReceipt {\n    readonly prompt?: string;\n}',
+    },
     {
         name: 'ScheduledToolDispatch',
         declaration: 'export type ScheduledToolDispatch = {\n    kind: \'post-result\';\n    result: ToolExecutionResult;\n} | {\n    kind: \'final-result\';\n    result: ToolExecutionResult;\n};',
@@ -5931,6 +6175,42 @@ export const TYPE_API = [
         name: 'ScheduledToolPreparation',
         declaration: 'export type ScheduledToolPreparation = {\n    kind: \'dispatch\';\n    exec: ToolRunContext;\n} | {\n    kind: \'post-result\';\n    exec: ToolRunContext;\n    result: ToolExecutionResult;\n} | {\n    kind: \'final-result\';\n    exec: ToolRunContext;\n    result: ToolExecutionResult;\n};',
     },
+    {
+        name: 'ScheduleId',
+        declaration: 'export type ScheduleId = Branded<\'ScheduleId\'>;',
+    },
+    {
+        name: 'ScheduleListRequest',
+        declaration: 'export interface ScheduleListRequest {\n    sessionId: SessionId;\n}',
+    },
+    {
+        name: 'ScheduleRecord',
+        declaration: 'export type ScheduleRecord = OneShotScheduleRecord | RecurringScheduleRecord;',
+    },
+    {
+        name: 'ScheduleTimingChange',
+        declaration: 'export type ScheduleTimingChange = {\n    readonly kind: \'at\';\n    readonly at: AtInput;\n} | {\n    readonly kind: \'every\';\n    readonly every_seconds: number;\n} | {\n    readonly kind: \'daily\';\n    readonly daily: DailyInput;\n} | {\n    readonly kind: \'weekly\';\n    readonly weekly: WeeklyInput;\n} | {\n    readonly kind: \'cron\';\n    readonly cron: CronInput;\n};',
+    },
+    {
+        name: 'ScheduleToolError',
+        declaration: 'export type ScheduleToolError = InvalidPromptError | InvalidSelectorError | InvalidRuleError | InvalidTimeZoneError | NotFutureError | TimeOutOfRangeError | FrequencyTooHighError | InternalScheduleError;',
+    },
+    {
+        name: 'ScheduleUpdateContent',
+        declaration: 'export interface ScheduleUpdateContent {\n    readonly title?: string;\n    readonly prompt?: string;\n}',
+    },
+    {
+        name: 'ScheduleUpdateMiss',
+        declaration: 'export interface ScheduleUpdateMiss {\n    readonly id: ScheduleId;\n    readonly updated: false;\n    readonly code: \'schedule_not_found\' | \'schedule_ended\' | \'schedule_conflict\';\n}',
+    },
+    {
+        name: 'ScheduleUpdateRequest',
+        declaration: 'export interface ScheduleUpdateRequest extends ScheduleDeleteRequest, ScheduleUpdateContent {\n    readonly expected: ScheduleRecord;\n    readonly change?: ScheduleTimingChange;\n}',
+    },
+    {
+        name: 'ScheduleUpdateResult',
+        declaration: 'export type ScheduleUpdateResult = {\n    readonly id: ScheduleId;\n    readonly updated: boolean;\n    readonly record: ScheduleRecord;\n} | ScheduleUpdateMiss | ScheduleToolError;',
+    },
     {
         name: 'Scoped',
         declaration: 'export type Scoped<T extends object> = object & {\n    readonly [ScopedBrand]: T;\n};',
@@ -5973,7 +6253,7 @@ export const TYPE_API = [
     },
     {
         name: 'Session',
-        declaration: 'export class Session {\n    get surface(): SessionSurface;\n    readonly header: SessionHeader;\n    readonly inheritedEventCount: SessionLogOffset;\n    get id(): SessionId;\n    readonly firstLiveSeq: SessionLogOffset;\n    readonly firstLifecycleSeq: SessionLogOffset;\n    static create(id: SessionId, seed?: readonly SessionEvent[], header?: SessionHeader, inheritedEventCount?: SessionLogOffset, projections?: readonly SessionMessageProjection[]): Session;\n    static fromRestore(id: SessionId, seed: readonly SessionEvent[], header: SessionHeader, inheritedEventCount: SessionLogOffset, eventState: SessionSeedEventState, projections?: readonly SessionMessageProjection[]): Session;\n    eventAt(seq: SessionSeq): SessionEvent | undefined;\n    snapshotEvents(fromSeq: SessionLogOffset = SessionLogOffset(0), toSeqExclusive: SessionLogOffset = this.seq): readonly SessionEvent[];\n    ownEvents(): readonly SessionEvent[];\n    isOwnSeq(seq: SessionSeq): boolean;\n    get seq(): SessionLogOffset;\n    append<T extends SessionEventType>(type: T, data: SessionEventMap[T], ...opts: T extends SurfaceEventType ? [\n        opts: SurfaceIntent<T>\n    ] : [\n    ]): SessionEvent<T>;\n    requestHeader(): EpochHeader | undefined;\n    requestContext(): RequestContext | undefined;\n    deriveMessages(): Message[];\n    deriveEventMessage(event: SessionEvent): Message | null;\n}',
+        declaration: 'export class Session {\n    get surface(): SessionSurface;\n    readonly header: SessionHeader;\n    readonly inheritedEventCount: SessionLogOffset;\n    get id(): SessionId;\n    readonly firstLiveSeq: SessionLogOffset;\n    readonly firstLifecycleSeq: SessionLogOffset;\n    static create(id: SessionId, seed?: readonly SessionEvent[], header?: SessionHeader, inheritedEventCount?: SessionLogOffset, projections?: readonly SessionMessageProjection[]): Session;\n    static fromRestore(id: SessionId, seed: readonly SessionEvent[], header: SessionHeader, inheritedEventCount: SessionLogOffset, eventState: SessionSeedEventState, projections?: readonly SessionMessageProjection[]): Session;\n    eventAt(seq: SessionSeq): SessionEvent | undefined;\n    snapshotEvents(fromSeq: SessionLogOffset = SessionLogOffset(0), toSeqExclusive: SessionLogOffset = this.seq): readonly SessionEvent[];\n    ownEvents(): readonly SessionEvent[];\n    isOwnSeq(seq: SessionSeq): boolean;\n    get seq(): SessionLogOffset;\n    append<T extends SessionEventType>(type: T, data: SessionEventMap[T], ...opts: T extends SurfaceEventType ? [\n        opts: SurfaceIntent<T>\n    ] : [\n    ]): SessionEvent<T>;\n    requestHeader(): EpochHeader | undefined;\n    requestContext(): RequestContext | undefined;\n    toolHistory(): ToolHistory;\n    deriveMessages(): Message[];\n    deriveEventMessage(event: SessionEvent): Message | null;\n}',
     },
     {
         name: 'SessionAccess',
@@ -6665,7 +6945,11 @@ export const TYPE_API = [
     },
     {
         name: 'SpeechPreparation',
-        declaration: 'export interface SpeechPreparation {\n    snapshot(): SpeechPreparationState;\n    subscribe(listener: () => void): () => void;\n    prepare(): void;\n    cancel(): Promise<void>;\n}',
+        declaration: 'export interface SpeechPreparation {\n    snapshot(): SpeechPreparationState;\n    subscribe(listener: () => void): () => void;\n    prepare(options?: SpeechPreparationOptions): void;\n    cancel(): Promise<void>;\n}',
+    },
+    {
+        name: 'SpeechPreparationOptions',
+        declaration: 'export interface SpeechPreparationOptions {\n    readonly downloadSource?: string;\n}',
     },
     {
         name: 'SpeechPreparationState',
@@ -6689,7 +6973,7 @@ export const TYPE_API = [
     },
     {
         name: 'SpeechProviderInfo',
-        declaration: 'export interface SpeechProviderInfo {\n    readonly id: SpeechProviderId;\n    readonly name: string;\n    readonly location: \'host-local\' | \'cloud\';\n    readonly languages: readonly string[];\n    readonly setupEstimate?: SpeechSetupEstimate;\n}',
+        declaration: 'export interface SpeechProviderInfo {\n    readonly id: SpeechProviderId;\n    readonly name: string;\n    readonly location: \'host-local\' | \'cloud\';\n    readonly languages: readonly string[];\n    readonly setupEstimate?: SpeechSetupEstimate;\n    readonly downloadSources?: readonly string[];\n}',
     },
     {
         name: 'SpeechProviderView',
@@ -6979,10 +7263,6 @@ export const TYPE_API = [
         name: 'TeamTaskView',
         declaration: 'export interface TeamTaskView {\n    readonly id: TeamTaskId;\n    readonly revision: number;\n    readonly subject: string;\n    readonly description: string;\n    readonly status: TeamTaskStatus;\n    readonly blockedBy: TeamTaskId[];\n    readonly writeScopes: string[];\n    readonly ownerName?: string;\n    readonly ready: boolean;\n    readonly writeScopeWarnings: string[];\n}',
     },
-    {
-        name: 'TeamView',
-        declaration: 'export interface TeamView {\n    readonly members: TeamMemberView[];\n    readonly tasks: TeamTaskView[];\n}',
-    },
     {
         name: 'TeamWaitResult',
         declaration: 'export interface TeamWaitResult {\n    readonly timedOut: boolean;\n}',
@@ -7091,6 +7371,10 @@ export const TYPE_API = [
         name: 'TerminalWaitReason',
         declaration: 'export type TerminalWaitReason = \'stdin_read\' | \'inferred_idle\' | \'timeout\' | \'session_exit\';',
     },
+    {
+        name: 'TimeOutOfRangeError',
+        declaration: 'export interface TimeOutOfRangeError {\n    readonly code: \'time_out_of_range\';\n    readonly message: string;\n}',
+    },
     {
         name: 'TokenMeasurement',
         declaration: 'export interface TokenMeasurement {\n    readonly logRevision: SessionLogOffset;\n    readonly baseline: TokenMeasurementBaseline;\n    readonly surfaceDeltaTokens: number;\n    readonly totalTokens: number;\n    readonly surfaceTokens: number;\n    readonly nodes: readonly TokenSurfaceNode[];\n}',
@@ -7175,6 +7459,10 @@ export const TYPE_API = [
         name: 'ToolGuard',
         declaration: 'export type ToolGuard = (execution: Readonly<ToolExecution>) => string | undefined;',
     },
+    {
+        name: 'ToolHistory',
+        declaration: 'export interface ToolHistory {\n    readonly tools: readonly ToolSchema[];\n    readonly updates: readonly {\n        readonly messageId: MessageId;\n        readonly additions: readonly ToolSchema[];\n    }[];\n}',
+    },
     {
         name: 'ToolMessageSource',
         declaration: 'export interface ToolMessageSource {\n    kind: \'tool\';\n    callId: ToolCallId;\n}',
@@ -7227,6 +7515,10 @@ export const TYPE_API = [
         name: 'ToolSchema',
         declaration: 'export interface ToolSchema {\n    deferLoading?: true;\n    name: string;\n    description: string;\n    parameters: Record<string, unknown>;\n}',
     },
+    {
+        name: 'ToolUpdate',
+        declaration: 'export type ToolUpdate = \'in-history\' | \'addition-only\';',
+    },
     {
         name: 'Transcript',
         declaration: 'export interface Transcript {\n    readonly text: string;\n    readonly audioSeconds: number;\n    readonly inferenceSeconds: number;\n}',
@@ -7479,6 +7771,14 @@ export const TYPE_API = [
         name: 'WebUpgradeRoute',
         declaration: 'export interface WebUpgradeRoute {\n    path: string;\n    handler: (req: IncomingMessage, socket: Duplex, head: Buffer) => void | Promise<void>;\n}',
     },
+    {
+        name: 'WeeklyInput',
+        declaration: 'export interface WeeklyInput {\n    readonly time: string;\n    readonly time_zone: string;\n    readonly weekdays: number[];\n}',
+    },
+    {
+        name: 'WeeklyScheduleRecord',
+        declaration: 'export interface WeeklyScheduleRecord {\n    readonly id: ScheduleId;\n    readonly kind: \'weekly\';\n    readonly title: string;\n    readonly prompt: string;\n    readonly time: string;\n    readonly timeZone: string;\n    readonly weekdays: number[];\n    readonly scheduledAt: string;\n}',
+    },
     {
         name: 'WorkflowAgentEndInfo',
         declaration: 'export interface WorkflowAgentEndInfo extends WorkflowAgentInfo {\n    outcome: WorkflowAgentOutcome;\n}',
@@ -7627,10 +7927,6 @@ export const TYPE_API = [
         name: 'WorkspaceFollowIncrement',
         declaration: 'export type WorkspaceFollowIncrement = {\n    readonly type: \'upsert\';\n    readonly workspace: WorkspaceView;\n} | {\n    readonly type: \'remove\';\n    readonly workspaceId: WorkspaceId;\n} | {\n    readonly type: \'order\';\n    readonly workspaceIds: readonly WorkspaceId[];\n} | {\n    readonly type: \'archived\';\n    readonly archivedSessionIds: readonly SessionId[];\n} | {\n    readonly type: \'pinned\';\n    readonly pinnedSessionIds: readonly SessionId[];\n};',
     },
-    {
-        name: 'WorkspaceInitializeDefaultRequest',
-        declaration: 'export interface WorkspaceInitializeDefaultRequest {\n    readonly directoryName: string;\n    readonly title: string;\n}',
-    },
     {
         name: 'WorkspaceInsertBeforeRequest',
         declaration: 'export interface WorkspaceInsertBeforeRequest {\n    readonly workspaceId: WorkspaceId;\n    readonly beforeWorkspaceId?: WorkspaceId;\n}',

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-tool-cordis",
   "description": "Read-only runtime API inspection for Harness plugin development",
-  "version": "0.1.7-alpha.2",
+  "version": "0.1.7-rc.2",
   "publishConfig": {
     "access": "public"
   },
@@ -34,20 +34,20 @@
   "peerDependencies": {
     "@deepseek-ai/cordis": "~4.0.4",
     "@deepseek-ai/cordis-plugin-loader": "~1.0.5",
-    "@deepseek-ai/dsh-agent": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-app-boot": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-tools": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-cordis-host-runner": "0.1.7-alpha.2"
+    "@deepseek-ai/dsh-agent": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-app-boot": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-cordis-host-runner": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-tools": "0.1.7-rc.2"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "~4.0.4",
     "@deepseek-ai/cordis-plugin-group": "~1.0.4",
+    "@deepseek-ai/cordis": "~4.0.4",
     "@deepseek-ai/cordis-plugin-loader": "~1.0.5",
-    "@deepseek-ai/dsh-agent": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-cordis-host-runner": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-app-boot": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-tools": "0.1.7-alpha.2",
-    "@deepseek-ai/dsh-system-prompt": "0.1.7-alpha.2",
-    "@deepseek-ai/schemastery": "~3.18.4"
+    "@deepseek-ai/dsh-agent": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-app-boot": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-system-prompt": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-tools": "0.1.7-rc.2",
+    "@deepseek-ai/schemastery": "~3.18.4",
+    "@deepseek-ai/dsh-cordis-host-runner": "0.1.7-rc.2"
   }
 }