@deepseek-ai/dsh-tool-cordis 0.1.3-alpha.2 → 0.1.5-alpha.2

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # 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:
 #   pnpm run verify-translation-pairing --write packages/extensions/tool-cordis/README.md
-README.md: 574a98ed7fe75e8af108906d80b2cd0c2e043fe8
-README.zh.md: d48d7539f8724834a2272eb7bed7e9b353f27edc
+README.md: b6a3de0fec47dea42e0462101186138c256b88d2
+README.zh.md: 374bc9a554d258d305bd1d80e51a5e94884b9d9c

package/README.md

@@ -9,7 +9,7 @@ English | [中文](README.zh.md)
 
 ## Summary
 
-`dsh-tool-cordis` gives the model seven tools over the live Cordis runtime of the current DSH process: inspect what is loaded and what a dynamic package may use, define a package with a host half, a browser half, or both, run it, stop it, and remove it. Packages are versioned — a plugin holds immutable package versions, and the model can append a corrected package and update to it after a failure. Definitions live only in process memory and vanish on DSH restart; nothing here writes repository files, installs packages, or changes `cordis.yml`. It also adds a system-prompt section that teaches the workflow; compose it with `@deepseek-ai/dsh-cordis-host-runner`, the package that runs the sandbox and the run round trip.
+`dsh-tool-cordis` lets a model inspect the live Cordis runtime and create, run, stop, update, or remove temporary dynamic packages with host code, browser code, or both. Package versions are immutable, so a failed package can be corrected by adding a new version and updating the active one. Definitions exist only in process memory and disappear when DSH restarts; the package does not write repository files, install dependencies, or change `cordis.yml`. It also teaches the model this workflow. Compose it with `@deepseek-ai/dsh-cordis-host-runner`, which provides the sandbox and run round trip.
 
 ## Table of Contents
 

package/README.zh.md

@@ -9,7 +9,7 @@ kind: "package-reference"
 
 ## 概述
 
-`dsh-tool-cordis` 给模型提供七个作用于当前 DSH 进程实时 Cordis 运行时的工具：检查已加载的内容与动态包可用之物，定义包含 host 半、浏览器半或两者的包，运行它、停止它并移除它。包带版本——插件持有若干不可变的包版本，模型在失败后可以追加修正版并更新过去。定义只存在于进程内存中，DSH 重启即消失；本包不写仓库文件、不安装任何包、不改 `cordis.yml`。它还增加一个教这套工作流的系统提示词章节；把它与 `@deepseek-ai/dsh-cordis-host-runner` 一同组合，后者负责沙箱与运行往返。
+`dsh-tool-cordis` 让模型检查实时 Cordis 运行时，并创建、运行、停止、更新或移除包含 host 代码、浏览器代码或两者的临时动态包。包版本不可变，因此包失败后，模型可以添加新版本并更新当前运行的版本。定义只存在于进程内存中，DSH 重启即消失；本包不写仓库文件、不安装依赖，也不改 `cordis.yml`。它还会把这套工作流教给模型。请与 `@deepseek-ai/dsh-cordis-host-runner` 一同组合，后者提供沙箱与运行往返。
 
 ## 目录
 

package/lib/index.js

@@ -73,7 +73,7 @@ const SERVICE_API = [
 					description: "caller context that structurally owns the lifecycle."
 				}, {
 					name: "options",
-					description: "identities, session seed/metadata, loop options, setup, and cancellation."
+					description: "identities, optional live parent, session seed/metadata, loop options, setup, and cancellation."
 				}],
 				returns: "the published handle."
 			},
@@ -85,7 +85,7 @@ const SERVICE_API = [
 					description: "caller context that owns load, setup, and the live lifecycle."
 				}, {
 					name: "options",
-					description: "persisted identity, loop options, setup, and cancellation."
+					description: "persisted identity, optional live parent, loop options, setup, and cancellation."
 				}],
 				returns: "the published handle."
 			}
@@ -294,7 +294,7 @@ const SERVICE_API = [
 		methods: [
 			{
 				signature: "currentInitiator(): Agent | undefined",
-				description: "Read the Agent that initiated the inherited asynchronous driver chain. Use this optional form for logging, tracing, metrics, or host attribution that also supports agentless calls. When a parent creates a child, setup reports the causal parent while `agentCtx.agent` identifies the child.",
+				description: "Read the Agent that initiated the inherited asynchronous driver chain. Use this optional form for logging, tracing, metrics, or host attribution that also supports agentless calls. When a parent creates a child, setup reports the causal parent while the setup callback's Agent parameter identifies the child.",
 				parameters: [],
 				returns: "the inherited Agent, or `undefined` outside an initiator boundary and inside an explicit clearing boundary.",
 				throws: ["when this service instance has been disposed."]
@@ -343,7 +343,7 @@ const SERVICE_API = [
 				description: "Create and publish a new agent through the registered factory. Distinct from register (which records an already-constructed agent): this constructs the agent and its session. Rejects if no factory is registered or creation/setup fails. The resolved AgentHandle lets the owner tear down exactly this agent.",
 				parameters: [{
 					name: "options",
-					description: "shared identity, session seed/metadata, and agent options."
+					description: "shared identity, optional live parent, session seed/metadata, and agent options."
 				}],
 				returns: "the handle after setup, rollback-covered publication, and loop start complete."
 			},
@@ -352,13 +352,13 @@ const SERVICE_API = [
 				description: "Load a persisted session and resume an agent on it through the registered factory. Rejects if no factory is registered; the factory rejects if session persistence is not configured or persistence/setup fails.",
 				parameters: [{
 					name: "options",
-					description: "persisted identity, configuration, and optional setup."
+					description: "persisted identity, optional live parent, configuration, and setup."
 				}],
 				returns: "the handle after setup, rollback-covered publication, and loop start complete."
 			},
 			{
 				signature: "register(agent: Agent): () => void",
-				description: "Register a live agent. Throws if an agent with the same id is already registered. Emits `agent/created` on registration and `agent/disposed` when the calling fiber is disposed — both with the agent's scope carrier (`scopeTarget(agent, agent)`): the subject is the agent in hand, so the emits are scope-filtered regardless of which context invoked `register` (calling through `agent.ctx` scopes EFFECTS; dispatch scoping always requires passing the carrier). Returns the disposer.",
+				description: "Register a live agent. Throws if an agent with the same id is already registered. Emits `agent/created` on registration and `agent/disposed` when the calling fiber is disposed — both with the agent's scope carrier (`scopeTarget(agent, agent)`): the subject is the agent in hand, so the emits are scope-filtered regardless of which context invoked `register` (calling through `agent.ctx` scopes EFFECTS; dispatch scoping always requires passing the carrier). The entry is a runtime root; factory-backed creation uses `options.parentAgent` for child ownership. Returns the disposer.",
 				parameters: [{
 					name: "agent",
 					description: "the already-constructed agent to record in the store."
@@ -373,7 +373,7 @@ const SERVICE_API = [
 					description: "the prepared, unpublished agent."
 				}, {
 					name: "owner",
-					description: "live agent whose scoped context created this agent, or undefined for a top-level runtime root. This is runtime ownership, not the resumed session's durable parent lineage."
+					description: "explicitly supplied live runtime owner, or undefined for a top-level runtime root. This is runtime ownership, not the resumed session's durable parent lineage."
 				}],
 				returns: "an idempotent closure that removes this exact entry and emits `agent/disposed` with listener failures contained. When called from a synchronous `agent/created` listener, removal and disposal wait until that creation dispatch unwinds."
 			},
@@ -845,6 +845,15 @@ const SERVICE_API = [
 				}],
 				returns: "the path, or undefined for an unknown id."
 			},
+			{
+				signature: "fetchBundle(request: Request): Response",
+				description: "Serve an advertised revisioned bundle or source map without a Web server. Unknown URLs return 404, unsupported methods return 405, and `HEAD` returns the same immutable headers without a body.",
+				parameters: [{
+					name: "request",
+					description: "shell-carrier request for a `/plugins` resource."
+				}],
+				returns: "the exact response also exposed by the optional Web route."
+			},
 			{
 				signature: "artifactBaseline(id: string): ClientArtifactBaseline | undefined",
 				description: "Filesystem baseline captured before an entry's current bytes were read. HMR compares it with the live files when installing a watch, so a write between startup composition and watch installation cannot disappear into the watcher's initial state.",
@@ -1514,6 +1523,25 @@ const SERVICE_API = [
 				],
 				returns: "the full raw content, at most `maxBytes` long."
 			},
+			{
+				signature: "abstract readByteRange(target: FsTarget, range: { offset: number; length: number }, signal?: AbortSignal): Promise<Uint8Array>",
+				description: "Read one byte window of the regular file as raw bytes with no decoding or binary rejection: the bytes at `[offset, offset + length)`, shorter when the file ends inside the window and empty when `offset` lies at or past its end. The window is the bound here, not the file: a backend transfers at most `length` bytes of content beyond the prefix it skips to reach `offset` and never buffers the whole file, so the caller's cap on `length` is the guard against unbounded buffering.",
+				parameters: [
+					{
+						name: "target",
+						description: "the resolved target to read."
+					},
+					{
+						name: "range",
+						description: "`offset`, the 0-based first byte, and `length`, the largest byte count; both non-negative integers."
+					},
+					{
+						name: "signal",
+						description: "aborts the read."
+					}
+				],
+				returns: "the window's bytes, at most `length` long."
+			},
 			{
 				signature: "abstract listDir(target: FsTarget, signal?: AbortSignal): Promise<FsDirEntry[]>",
 				description: "List direct children of a directory in stable name order. Returns resolved child targets plus cheap metadata only; never reads file contents.",
@@ -1588,7 +1616,7 @@ const SERVICE_API = [
 		description: "Goal service (`ctx.goals`) backed exclusively by the owning session log.",
 		methods: [
 			{
-				signature: "get(agent: Agent): GoalView | undefined",
+				signature: "@Remote('get') get(agent: Agent): GoalView | undefined",
 				description: "Read the current goal for one exact live agent.",
 				parameters: [{
 					name: "agent",
@@ -2334,6 +2362,12 @@ const SERVICE_API = [
 				parameters: [],
 				returns: "true when the matching open operation is available."
 			},
+			{
+				signature: "workspaceDesktop(): { name: string; available: boolean; fileManager: 'finder' | 'explorer' | 'directory' | null }",
+				description: "Describe the serving desktop for authenticated file-action routes.",
+				parameters: [],
+				returns: "Host name, configured availability, and platform-specific file-manager behavior."
+			},
 			{
 				signature: "@Remote('openWorkspacePath') async openWorkspacePath( request: SessionOpenWorkspacePathRequest, signal: AbortSignal, ): Promise<SessionOpenWorkspacePathValue>",
 				description: "Open one path prepared by a Session-aware caller on the Host desktop.",
@@ -2439,6 +2473,20 @@ const SERVICE_API = [
 			}
 		]
 	},
+	{
+		key: "sessionFeedback",
+		summary: "Host Remote through which a product surface records a Session-level remark.",
+		description: "Host Remote through which a product surface records a Session-level remark.",
+		methods: [{
+			signature: "@Remote('record') record(request: SessionFeedbackRecordRequest): Promise<SessionFeedbackRecordResult>",
+			description: "Record one remark on a live Session.",
+			parameters: [{
+				name: "request",
+				description: "target Session plus the optional text and category."
+			}],
+			returns: "the recorded postcondition, or `session-not-found` when no live Session carries the id."
+		}]
+	},
 	{
 		key: "sessionFileReferences",
 		summary: "Host Remote adapter over the composed file-reference provider.",
@@ -3649,11 +3697,11 @@ const SERVICE_API = [
 	},
 	{
 		key: "subagentModelSelection",
-		summary: "Singleton settings owner read by delegation tools when an Agent is published.",
-		description: "Singleton settings owner read by delegation tools when an Agent is published.",
+		summary: "Singleton settings owner read when delegation tools are composed for a Session.",
+		description: "Singleton settings owner read when delegation tools are composed for a Session.",
 		methods: [{
 			signature: "current(): SubagentModelSelectionSettings",
-			description: "Read a detached selection preference for the next eligible Agent publication.",
+			description: "Read a detached selection preference for the next eligible Session composition.",
 			parameters: [],
 			returns: "the enabled state and exact allowed routes."
 		}]
@@ -3830,7 +3878,7 @@ const SERVICE_API = [
 			},
 			{
 				signature: "async start(name: string, request: SubagentStartRequest): Promise<SubagentRun>",
-				description: "Establish a published child on the named provider. Capability and semantic checks run before delegation. Provider ownership lasts until its promise fulfills; a rejection therefore has no run for the caller to dispose and emits no run lifecycle events. Post-publication turn and infrastructure failures settle through the returned run.",
+				description: "Establish a published child on the named provider. Capability and semantic checks run before delegation. Provider ownership lasts until its promise fulfills; a rejection therefore has no run for the caller to dispose and emits no run lifecycle events. Post-publication turn and infrastructure failures settle through the returned run. A catalog append failure disposes the run and handles its result rejection; the caller receives the catalog error even if disposal also fails.",
 				parameters: [{
 					name: "name",
 					description: "the provider to use."
@@ -4144,7 +4192,7 @@ const SERVICE_API = [
 		description: "Replay owner for one service-wide estimator and isolated per-session folds.",
 		methods: [{
 			signature: "measure(session: Session, requestHeader?: EpochHeader): TokenMeasurement",
-			description: "Measure current request pressure and surface through the durable tail.\n\nThe effective envelope's routed provider/model selects the request-image pricing every node is priced under: a route whose adapter declares image pricing charges each retained image its visual tokens plus its model-visible text, while other routes keep the fixed heuristic. Provider usage is reused only when the latest successful call's canonical request envelope matches `requestHeader` and its total is no lower than that call's full route-priced anchor; otherwise the complete envelope and surface are repriced.\n\n`requestHeader` replaces the latest logged envelope for pressure and node pricing; the node set always describes the current session surface. Every call clones those positional nodes, so measurement is O(surface).",
+			description: "Measure current request pressure and surface through the durable tail.\n\nThe effective envelope's routed provider/model selects the request-image pricing every node is priced under: a route whose adapter declares image pricing charges each retained image its visual tokens plus its model-visible text, while other routes keep the fixed heuristic. Provider usage is reused only when the latest successful call's canonical request envelope matches `requestHeader` and its total is no lower than that call's full route-priced anchor; otherwise the complete envelope and surface are repriced. The anchor includes all surface nodes immediately before the assistant message, including inputs admitted after step/start.\n\n`requestHeader` replaces the latest logged envelope for pressure and node pricing; the node set always describes the current session surface. Every call clones those positional nodes, so measurement is O(surface).",
 			parameters: [{
 				name: "session",
 				description: "session to replay through its current durable tail."
@@ -4642,6 +4690,151 @@ const SERVICE_API = [
 			}
 		]
 	},
+	{
+		key: "workspaceFiles",
+		summary: "Host Remote file reads and workspace directory observations over the composed filesystem.",
+		description: "Host Remote file reads and workspace directory observations over the composed filesystem.",
+		methods: [
+			{
+				signature: "@Remote async read( workspaceFileScope: WorkspaceFileScope, path: string, range: WorkspaceFileRange, signal: AbortSignal, ): Promise<WorkspaceFileText>",
+				description: "Read one page of lines from a UTF-8 file readable by the filesystem backend.",
+				parameters: [
+					{
+						name: "workspaceFileScope",
+						description: "header-derived workspace root for the Session identity on the wire."
+					},
+					{
+						name: "path",
+						description: "absolute path or path relative to the workspace root; files outside it are allowed."
+					},
+					{
+						name: "range",
+						description: "the line window; omitted fields take the page defaults."
+					},
+					{
+						name: "signal",
+						description: "caller cancellation."
+					}
+				],
+				returns: "the page, the file's version at the stat before it, and whether it reaches the last line."
+			},
+			{
+				signature: "@Remote async readBytes( workspaceFileScope: WorkspaceFileScope, path: string, range: WorkspaceByteRange, signal: AbortSignal, ): Promise<WorkspaceFileBytes>",
+				description: "Read one byte window of a regular file readable by the filesystem backend: raw bytes, no text decoding and no binary rejection.",
+				parameters: [
+					{
+						name: "workspaceFileScope",
+						description: "header-derived workspace root for the Session identity on the wire."
+					},
+					{
+						name: "path",
+						description: "absolute path or path relative to the workspace root; files outside it are allowed."
+					},
+					{
+						name: "range",
+						description: "the byte window; omitted fields take the window defaults."
+					},
+					{
+						name: "signal",
+						description: "caller cancellation."
+					}
+				],
+				returns: "the window in base64, the file's version and size at the stat before it, and whether it reaches the last byte."
+			},
+			{
+				signature: "@Remote async readAll(workspaceFileScope: WorkspaceFileScope, path: string, signal: AbortSignal): Promise<WorkspaceFileBytes>",
+				description: "Read a complete regular file as bytes, subject to the configured full-file cap.",
+				parameters: [
+					{
+						name: "workspaceFileScope",
+						description: "header-derived workspace root for the Session identity on the wire."
+					},
+					{
+						name: "path",
+						description: "absolute or workspace-relative file path."
+					},
+					{
+						name: "signal",
+						description: "caller cancellation."
+					}
+				],
+				returns: "one complete base64 window with offset zero and eof true; oversized files fail with too-large."
+			},
+			{
+				signature: "@Remote async readRelated( workspaceFileScope: WorkspaceFileScope, path: string, relativePath: string, signal: AbortSignal, ): Promise<WorkspaceFileBytes>",
+				description: "Read a complete file relative to another file's directory, including outside the workspace.",
+				parameters: [
+					{
+						name: "workspaceFileScope",
+						description: "header-derived workspace root for the Session identity on the wire."
+					},
+					{
+						name: "path",
+						description: "base file, absolute or workspace-relative."
+					},
+					{
+						name: "relativePath",
+						description: "relative filesystem path, not a URL or absolute path."
+					},
+					{
+						name: "signal",
+						description: "caller cancellation."
+					}
+				],
+				returns: "the complete related file using the ordinary file-size and access checks."
+			},
+			{
+				signature: "@Remote async stat(workspaceFileScope: WorkspaceFileScope, path: string, signal: AbortSignal): Promise<WorkspaceFileStat>",
+				description: "Report one regular file's identity, version, and size without its content.",
+				parameters: [
+					{
+						name: "workspaceFileScope",
+						description: "header-derived workspace root for the Session identity on the wire."
+					},
+					{
+						name: "path",
+						description: "absolute path or path relative to the workspace root; files outside it are allowed."
+					},
+					{
+						name: "signal",
+						description: "caller cancellation."
+					}
+				],
+				returns: "the file's absolute path, current version, and byte size."
+			},
+			{
+				signature: "@Remote async list(workspaceFileScope: WorkspaceFileScope, path: string, signal: AbortSignal): Promise<WorkspaceDirectoryListing>",
+				description: "List the direct children of one directory inside the Session's workspace.",
+				parameters: [
+					{
+						name: "workspaceFileScope",
+						description: "header-derived workspace root for the Session identity on the wire."
+					},
+					{
+						name: "path",
+						description: "workspace path, absolute or relative to the workspace root."
+					},
+					{
+						name: "signal",
+						description: "caller cancellation."
+					}
+				],
+				returns: "the directory's children in the backend's stable name order, bounded by the entry cap."
+			},
+			{
+				signature: "@Remote({ mode: 'stream' }) changes(workspaceFileScope: WorkspaceFileScope, signal: AbortSignal): AsyncIterable<WorkspaceFileWatchFrame>",
+				description: "Stream every `fs/observed` observation of a file inside the Session's workspace. Only instrumented filesystem operations report here; the OS is not watched.",
+				parameters: [{
+					name: "workspaceFileScope",
+					description: "header-derived workspace root for the Session identity on the wire."
+				}, {
+					name: "signal",
+					description: "generation cancellation."
+				}],
+				returns: "`ready` once the Host observation queue is active and the workspace root is resolved, then queued and live observations in emission order."
+			}
+		]
+	},
 	{
 		key: "workspaceRegistry",
 		summary: "Durable workspace registry.",
@@ -4836,7 +5029,7 @@ const EVENT_API = [
 		mode: "waterfall",
 		signature: "'agent/request'(this: Scoped<Agent>, payload: { agent: Agent; turn: number; step: number; signal: AbortSignal }, next: () => Promise<LlmCallConfig>): Promise<LlmCallConfig>",
 		summary: "Replace the frozen call configuration.",
-		description: "Replace the frozen call configuration. `await next()` yields the config the machine would use (agent options on the first request, the logged header afterwards); return a replacement to switch. Model-visible content must use logged channels; this waterfall cannot mutate messages.",
+		description: "Replace the frozen call configuration. `await next()` yields the config the machine would use (agent options on the first request, the logged header afterwards); return a replacement to switch. On step admission, this runs after assembly and `step/start`, before the system prompt and accepted user batch are committed. Cancellation here or during subsequent `prepareCall()` resolution commits neither. The prepared call capability governs prompt admission. Model-visible content must use logged channels; this waterfall cannot mutate messages.",
 		parameters: [{
 			name: "payload",
 			description: ".signal - the current turn's explicit abort signal. Scope-filtered dispatch (`@deepseek-ai/dsh-scope`): agent-scoped listeners receive only that agent."
@@ -5142,6 +5335,17 @@ const EVENT_API = [
 			description: "the opaque tool-execution context the decider keys off."
 		}]
 	},
+	{
+		name: "goal/activation-changed",
+		mode: "emit",
+		signature: "'goal/activation-changed'(payload: GoalActivationChanged): void",
+		summary: "Process-local goal activation changed for one session.",
+		description: "Process-local goal activation changed for one session.",
+		parameters: [{
+			name: "payload",
+			description: "session id and the exact current goal activation, or no goal after a clear."
+		}]
+	},
 	{
 		name: "goal/changed",
 		mode: "emit",
@@ -5391,8 +5595,8 @@ const EVENT_API = [
 		name: "tools/ptc-dispatch-log",
 		mode: "waterfall",
 		signature: "'tools/ptc-dispatch-log'(this: Scoped<ToolRuntime>, dispatch: PtcDispatchLog, next: () => Promise<ContentBlock[]>): Promise<ContentBlock[]>",
-		summary: "Allow a listener to replace content in the DURABLE LOG COPY of one `run_code` sub-dispatch outcome before the bridge appends its `tool/code-dispatch` event.",
-		description: "Allow a listener to replace content in the DURABLE LOG COPY of one `run_code` sub-dispatch outcome before the bridge appends its `tool/code-dispatch` event. `next()` keeps the content unchanged; a listener may return replacement blocks (e.g. the spill policy's preview + locator for an oversized text result). Only the logged copy is affected — the program already received the complete value, and the model sees neither. A throwing listener is contained: the bridge falls back to logging the original settled content. Scope-filtered dispatch (`@deepseek-ai/dsh-scope`): agent-scoped listeners receive only that agent's dispatches.",
+		summary: "Allow a listener to replace content in the DURABLE LOG COPY of one `run_code` sub-dispatch outcome before the bridge appends its `tool/ptc-dispatch` event.",
+		description: "Allow a listener to replace content in the DURABLE LOG COPY of one `run_code` sub-dispatch outcome before the bridge appends its `tool/ptc-dispatch` event. `next()` keeps the content unchanged; a listener may return replacement blocks (e.g. the spill policy's preview + locator for an oversized text result). Only the logged copy is affected — the program already received the complete value, and the model sees neither. A throwing listener is contained: the bridge falls back to logging the original settled content. Scope-filtered dispatch (`@deepseek-ai/dsh-scope`): agent-scoped listeners receive only that agent's dispatches.",
 		parameters: [{
 			name: "dispatch",
 			description: "the parent execution, sub-call identity, and the settled content to log."
@@ -5580,7 +5784,7 @@ const TYPE_API = [
 	},
 	{
 		name: "AgentSetup",
-		declaration: "export type AgentSetup = (agentCtx: Context) => AgentSetupCommit | Promise<AgentSetupCommit | void> | void;"
+		declaration: "export type AgentSetup = (agentCtx: Context, agent: Agent) => AgentSetupCommit | Promise<AgentSetupCommit | void> | void;"
 	},
 	{
 		name: "AgentSetupCommit",
@@ -5968,7 +6172,7 @@ const TYPE_API = [
 	},
 	{
 		name: "CreateAgentOptions",
-		declaration: "export interface CreateAgentOptions {\n    readonly sessionId: SessionId;\n    readonly meta?: {\n        readonly cwd?: string;\n        readonly parentSession?: SessionId;\n        readonly isSeeded?: boolean;\n        readonly origin?: 'subagent';\n        readonly delegationDepth?: number;\n        readonly agentPreset?: string;\n    };\n    readonly inheritedEventCount?: SessionLogOffset;\n    readonly seed?: readonly SessionEvent[];\n    readonly agentOptions?: AgentOptions;\n    readonly signal?: AbortSignal;\n    readonly setup?: AgentSetup;\n}"
+		declaration: "export interface CreateAgentOptions {\n    readonly sessionId: SessionId;\n    readonly parentAgent?: Agent;\n    readonly meta?: {\n        readonly cwd?: string;\n        readonly parentSession?: SessionId;\n        readonly isSeeded?: boolean;\n        readonly origin?: 'subagent';\n        readonly delegationDepth?: number;\n        readonly agentPreset?: string;\n    };\n    readonly inheritedEventCount?: SessionLogOffset;\n    readonly seed?: readonly SessionEvent[];\n    readonly agentOptions?: AgentOptions;\n    readonly signal?: AbortSignal;\n    readonly setup?: AgentSetup;\n}"
 	},
 	{
 		name: "CreateGoalRequest",
@@ -6148,7 +6352,11 @@ const TYPE_API = [
 	},
 	{
 		name: "EpochHeader",
-		declaration: "export interface EpochHeader {\n    config: LlmCallConfig;\n    adapterDefaults?: LlmCallConfigAdapterDefaults;\n    system?: string;\n    tools?: ToolSchema[];\n}"
+		declaration: "export interface EpochHeader {\n    config: LlmCallConfig;\n    adapterDefaults?: LlmCallConfigAdapterDefaults;\n    tools?: ToolSchema[];\n}"
+	},
+	{
+		name: "FeedbackCategory",
+		declaration: "export type FeedbackCategory = 'task-result' | 'instruction-following' | 'product-interaction' | 'service-stability' | 'resource-cost' | 'security-privacy-permission' | 'other';"
 	},
 	{
 		name: "FiberState",
@@ -6250,6 +6458,10 @@ const TYPE_API = [
 		name: "GoalActivation",
 		declaration: "export type GoalActivation = 'armed' | 'disarmed';"
 	},
+	{
+		name: "GoalActivationChanged",
+		declaration: "export interface GoalActivationChanged {\n    readonly sessionId: SessionId;\n    readonly goal?: {\n        readonly id: GoalId;\n        readonly revision: number;\n        readonly activation: GoalActivation;\n    };\n}"
+	},
 	{
 		name: "GoalBlockReason",
 		declaration: "export interface GoalBlockReason {\n    readonly code: string;\n    readonly message: string;\n}"
@@ -6456,7 +6668,7 @@ const TYPE_API = [
 	},
 	{
 		name: "LlmConfigurableProvider",
-		declaration: "export interface LlmConfigurableProvider {\n    provider: string;\n    displayName: string;\n    settingsNs: string;\n    settingsPath: readonly string[];\n    declared?: boolean;\n}"
+		declaration: "export interface LlmConfigurableProvider {\n    provider: string;\n    displayName: string;\n    settingsNs: string;\n    settingsPath: readonly string[];\n    declared?: boolean;\n    error?: string;\n}"
 	},
 	{
 		name: "LlmDiscoveredModel",
@@ -6500,7 +6712,7 @@ const TYPE_API = [
 	},
 	{
 		name: "LlmResolvedModelInfo",
-		declaration: "export interface LlmResolvedModelInfo extends LlmModelInfo {\n    context?: LlmModelContext;\n    defaultMaxTokens?: number;\n    reasoning?: LlmModelReasoningInfo;\n}"
+		declaration: "export interface LlmResolvedModelInfo extends LlmModelInfo {\n    context?: LlmModelContext;\n    defaultMaxTokens?: number;\n    reasoning?: LlmModelReasoningInfo;\n    systemPromptUpdate?: SystemPromptUpdate;\n}"
 	},
 	{
 		name: "LlmRuntime",
@@ -6572,7 +6784,7 @@ const TYPE_API = [
 	},
 	{
 		name: "MessageFeedbackItem",
-		declaration: "export interface MessageFeedbackItem {\n    readonly messageId: MessageId;\n    readonly rating: MessageFeedbackRating;\n    readonly note?: string;\n    readonly version: MessageFeedbackVersion;\n    readonly createdAt: number;\n    readonly updatedAt: number;\n}"
+		declaration: "export interface MessageFeedbackItem {\n    readonly messageId: MessageId;\n    readonly rating: MessageFeedbackRating;\n    readonly note?: string;\n    readonly category?: FeedbackCategory;\n    readonly version: MessageFeedbackVersion;\n    readonly createdAt: number;\n    readonly updatedAt: number;\n}"
 	},
 	{
 		name: "MessageFeedbackListRequest",
@@ -6596,7 +6808,7 @@ const TYPE_API = [
 	},
 	{
 		name: "MessageFeedbackPutRequest",
-		declaration: "export interface MessageFeedbackPutRequest {\n    readonly sessionId: SessionId;\n    readonly messageId: MessageId;\n    readonly rating: MessageFeedbackRating;\n    readonly note?: string;\n    readonly ifVersion: MessageFeedbackVersion | null;\n}"
+		declaration: "export interface MessageFeedbackPutRequest {\n    readonly sessionId: SessionId;\n    readonly messageId: MessageId;\n    readonly rating: MessageFeedbackRating;\n    readonly note?: string;\n    readonly category?: FeedbackCategory;\n    readonly ifVersion: MessageFeedbackVersion | null;\n}"
 	},
 	{
 		name: "MessageFeedbackPutResult",
@@ -6712,7 +6924,7 @@ 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 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 adapterDefaults: LlmCallConfigAdapterDefaults;\n    stream(options: GenerateOptions): AsyncIterable<StreamChunk>;\n}"
 	},
 	{
 		name: "PreparedReferencedMessage",
@@ -6844,7 +7056,7 @@ const TYPE_API = [
 	},
 	{
 		name: "RequestContext",
-		declaration: "export interface RequestContext {\n    provider: string;\n    model: string;\n    contextWindow?: number;\n}"
+		declaration: "export interface RequestContext {\n    provider: string;\n    model: string;\n    contextWindow?: number;\n    systemPromptUpdate?: SystemPromptUpdate;\n}"
 	},
 	{
 		name: "RequestErrorAction",
@@ -6892,7 +7104,7 @@ const TYPE_API = [
 	},
 	{
 		name: "ResumeAgentOptions",
-		declaration: "export interface ResumeAgentOptions {\n    readonly resumeSessionId: SessionId;\n    readonly agentOptions?: AgentOptions;\n    readonly signal?: AbortSignal;\n    readonly setup?: AgentSetup;\n}"
+		declaration: "export interface ResumeAgentOptions {\n    readonly resumeSessionId: SessionId;\n    readonly parentAgent?: Agent;\n    readonly agentOptions?: AgentOptions;\n    readonly signal?: AbortSignal;\n    readonly setup?: AgentSetup;\n}"
 	},
 	{
 		name: "RunnerFailureRule",
@@ -7040,7 +7252,7 @@ const TYPE_API = [
 	},
 	{
 		name: "SessionEvent",
-		declaration: "export type SessionEvent<T extends SessionEventType = SessionEventType> = {\n    [K in SessionEventType]: {\n        type: K;\n        seq: SessionSeq;\n        time: number;\n        data: SessionEventMap[K];\n        ignorable?: true;\n    } & (K extends SurfaceEventType ? {\n        sourceEventSeqs?: SessionSeq[];\n        surfaceOp?: SurfaceOp;\n    } : object);\n}[T];"
+		declaration: "export type SessionEvent<T extends SessionEventType = SessionEventType> = {\n    [K in SessionEventType]: {\n        type: K;\n        seq: SessionSeq;\n        time: number;\n        data: SessionEventMap[K];\n        ignorable?: true;\n    } & (K extends SurfaceEventType ? SurfaceIntent<K> : {\n        surfaceOp?: never;\n        sourceEventSeqs?: never;\n    });\n}[T];"
 	},
 	{
 		name: "SessionEventEntry",
@@ -7048,7 +7260,7 @@ const TYPE_API = [
 	},
 	{
 		name: "SessionEventMap",
-		declaration: "export interface SessionEventMap {\n    'turn/start': {\n        turn: number;\n    };\n    'turn/end': {\n        turn: number;\n        reason: TurnEndReason;\n    };\n    'step/start': {\n        turn: number;\n        step: number;\n    };\n    'step/end': {\n        turn: number;\n        step: number;\n    };\n    'user/message': UserMessage;\n    'assistant/message': {\n        turn: number;\n        step: number;\n        message: AssistantMessage;\n        stream: AssistantStreamRecord[];\n        usage?: TokenUsage;\n        interrupted?: true;\n    };\n    'assistant/attempt': {\n        turn: number;\n        step: number;\n        stream: AssistantStreamRecord[];\n    };\n    'tool/call': {\n        turn: number;\n        step: number;\n        callId: ToolCallId;\n        name: string;\n        arguments: string;\n    };\n    'tool/result': {\n        turn: number;\n        step: number;\n        message: ToolResultMessage;\n        error?: {\n            name: string;\n            code: string;\n        };\n        meta?: JsonValue;\n    };\n    'request/header': {\n        header: EpochHeader;\n        reason: RequestHeaderReason;\n        startsSeries?: true;\n    };\n    'request/context': RequestContext;\n    'session/end-seed': {\n        inherited?: true;\n    };\n}"
+		declaration: "export interface SessionEventMap {\n    'turn/start': {\n        turn: number;\n    };\n    'turn/end': {\n        turn: number;\n        reason: TurnEndReason;\n    };\n    'step/start': {\n        turn: number;\n        step: number;\n    };\n    'step/end': {\n        turn: number;\n        step: number;\n    };\n    'user/message': UserMessage;\n    'system/message': {\n        turn: number;\n        step: number;\n        message: SystemMessage;\n    };\n    'assistant/message': {\n        turn: number;\n        step: number;\n        message: AssistantMessage;\n        stream: AssistantStreamRecord[];\n        usage?: TokenUsage;\n        interrupted?: true;\n    };\n    'assistant/attempt': {\n        turn: number;\n        step: number;\n        stream: AssistantStreamRecord[];\n    };\n    'tool/call': {\n        turn: number;\n        step: number;\n        callId: ToolCallId;\n        name: string;\n        arguments: string;\n    };\n    'tool/result': {\n        turn: number;\n        step: number;\n        message: ToolResultMessage;\n        error?: {\n            name: string;\n            code: string;\n        };\n        meta?: JsonValue;\n    };\n    'request/header': {\n        header: EpochHeader;\n        reason: RequestHeaderReason;\n        startsSeries?: true;\n    };\n    'request/context': RequestContext;\n    'session/end-seed': {\n        inherited?: true;\n    };\n}"
 	},
 	{
 		name: "SessionEventMetadataFilter",
@@ -7106,6 +7318,22 @@ const TYPE_API = [
 		name: "SessionEventWindow",
 		declaration: "export interface SessionEventWindow {\n    session: SessionHeader;\n    inheritedEventCount: SessionLogOffset;\n    target: SessionEvent;\n    events: SessionEvent[];\n    startSeq: SessionSeq;\n    endSeq: SessionSeq;\n}"
 	},
+	{
+		name: "SessionFeedbackRecordRequest",
+		declaration: "export interface SessionFeedbackRecordRequest {\n    readonly sessionId: SessionId;\n    readonly text?: string;\n    readonly category?: FeedbackCategory;\n}"
+	},
+	{
+		name: "SessionFeedbackRecordResult",
+		declaration: "export type SessionFeedbackRecordResult = {\n    readonly ok: true;\n    readonly value: SessionFeedbackRecordValue;\n} | {\n    readonly ok: false;\n    readonly error: SessionFeedbackSessionNotFound;\n};"
+	},
+	{
+		name: "SessionFeedbackRecordValue",
+		declaration: "export interface SessionFeedbackRecordValue {\n    readonly recorded: true;\n}"
+	},
+	{
+		name: "SessionFeedbackSessionNotFound",
+		declaration: "export interface SessionFeedbackSessionNotFound {\n    readonly code: 'session-not-found';\n    readonly sessionId: SessionId;\n}"
+	},
 	{
 		name: "SessionFollowFrame",
 		declaration: "export type SessionFollowFrame = {\n    readonly type: 'snapshot';\n    readonly header: SessionWireHeader;\n    readonly cursor: number;\n    readonly records: readonly SessionHistoryRecord[];\n    readonly hasMore: boolean;\n    readonly projections: SessionProjectionBaseline;\n    readonly assistantStream?: SessionAssistantStreamBaseline;\n} | SessionEventEntry | {\n    readonly type: 'assistant-stream';\n    readonly frame: SessionAssistantStreamFrame;\n};"
@@ -7200,7 +7428,7 @@ const TYPE_API = [
 	},
 	{
 		name: "SessionOpenWorkspacePathRequest",
-		declaration: "export interface SessionOpenWorkspacePathRequest {\n    readonly path: string;\n}"
+		declaration: "export interface SessionOpenWorkspacePathRequest {\n    readonly action?: 'reveal';\n    readonly path: string;\n}"
 	},
 	{
 		name: "SessionOpenWorkspacePathValue",
@@ -7444,16 +7672,12 @@ const TYPE_API = [
 	},
 	{
 		name: "SessionWireEvent",
-		declaration: "export interface SessionWireEvent {\n    readonly type: string;\n    readonly seq: number;\n    readonly time: number;\n    readonly data: JsonValue;\n    readonly ignorable?: true;\n    readonly sourceEventSeqs?: number[];\n    readonly surfaceOp?: SessionWireSurfaceOp;\n}"
+		declaration: "export interface SessionWireEvent {\n    readonly type: string;\n    readonly seq: number;\n    readonly time: number;\n    readonly data: JsonValue;\n    readonly ignorable?: true;\n    readonly sourceEventSeqs?: JsonValue;\n    readonly surfaceOp?: JsonValue;\n}"
 	},
 	{
 		name: "SessionWireHeader",
 		declaration: "export interface SessionWireHeader {\n    readonly version: number;\n    readonly id: SessionId;\n    readonly createdAt: number;\n    readonly cwd?: string;\n    readonly parentSession?: SessionId;\n    readonly isSeeded: boolean;\n    readonly origin?: 'subagent';\n    readonly delegationDepth?: number;\n    readonly agentPreset?: string;\n}"
 	},
-	{
-		name: "SessionWireSurfaceOp",
-		declaration: "export type SessionWireSurfaceOp = 'append' | {\n    readonly op: 'replace';\n    readonly start: number;\n    readonly end: number;\n};"
-	},
 	{
 		name: "SettingsApplies",
 		declaration: "export type SettingsApplies = 'live' | 'restart';"
@@ -7780,11 +8004,11 @@ const TYPE_API = [
 	},
 	{
 		name: "SurfaceEvent",
-		declaration: "export type SurfaceEvent = SessionEvent<SurfaceEventType> & {\n    surfaceOp: SurfaceOp;\n};"
+		declaration: "export type SurfaceEvent = SessionEvent<SurfaceEventType>;"
 	},
 	{
 		name: "SurfaceEventType",
-		declaration: "export type SurfaceEventType = 'user/message' | 'assistant/message' | 'tool/result';"
+		declaration: "export type SurfaceEventType = 'system/message' | 'user/message' | 'assistant/message' | 'tool/result';"
 	},
 	{
 		name: "SurfaceIntent",
@@ -7792,12 +8016,20 @@ const TYPE_API = [
 	},
 	{
 		name: "SurfaceOp",
-		declaration: "export type SurfaceOp = 'append' | {\n    op: 'replace';\n    start: SessionSeq;\n    end: SessionSeq;\n};"
+		declaration: "export type SurfaceOp = 'append' | {\n    op: 'replace';\n    startSeq: SessionSeq;\n    endSeq: SessionSeq;\n};"
+	},
+	{
+		name: "SystemMessage",
+		declaration: "export interface SystemMessage extends Message {\n    readonly role: 'system';\n    readonly source: MessageSourceMap['plugin'];\n}"
 	},
 	{
 		name: "SystemPrompt",
 		declaration: "export class SystemPrompt extends Service {\n    static Config: z<Config>;\n    constructor(ctx: Context, config: Config);\n    section(section: PromptSection): () => void;\n    getSectionOrder(name: PromptSectionOrderName): number;\n    getContextOrder(name: PromptContextOrderName): number;\n    context(context: PromptContext): () => void;\n    suppressRuntimeContext(): () => void;\n    tools(provider: (context: AssembleContext) => ToolProviderResult): () => void;\n    variable(name: string, provider: (context: AssembleContext) => string | undefined): () => void;\n    async assemble(context: AssembleContext = {}): Promise<PromptAssembly>;\n}"
 	},
+	{
+		name: "SystemPromptUpdate",
+		declaration: "export type SystemPromptUpdate = 'in-history';"
+	},
 	{
 		name: "TableKeyOf",
 		declaration: "export type TableKeyOf<S extends DomainSpec, N extends keyof S['tables']> = S['tables'][N] extends DomainTableSpec<infer K> ? K : never;"
@@ -8120,7 +8352,7 @@ const TYPE_API = [
 	},
 	{
 		name: "TypertRemoteEventContext",
-		declaration: "export interface TypertRemoteEventContext {\n    readonly value: Context;\n    readonly subject: object;\n}"
+		declaration: "export interface TypertRemoteEventContext {\n    readonly value: Context;\n    readonly subject: object;\n    readonly agentId: string;\n}"
 	},
 	{
 		name: "TypertRemoteEventDispatch",
@@ -8346,6 +8578,10 @@ const TYPE_API = [
 		name: "WorkspaceBaseline",
 		declaration: "export interface WorkspaceBaseline {\n    readonly items: readonly WorkspaceView[];\n    readonly archivedSessionIds: readonly SessionId[];\n}"
 	},
+	{
+		name: "WorkspaceByteRange",
+		declaration: "export interface WorkspaceByteRange {\n    readonly offset?: number;\n    readonly length?: number;\n}"
+	},
 	{
 		name: "WorkspaceCreateRequest",
 		declaration: "export interface WorkspaceCreateRequest {\n    readonly path: string;\n}"
@@ -8362,6 +8598,42 @@ const TYPE_API = [
 		name: "WorkspaceDeleteValue",
 		declaration: "export interface WorkspaceDeleteValue {\n    readonly deleted: true;\n}"
 	},
+	{
+		name: "WorkspaceDirectoryEntry",
+		declaration: "export interface WorkspaceDirectoryEntry {\n    readonly name: string;\n    readonly type: 'file' | 'directory' | 'other';\n    readonly size?: number;\n}"
+	},
+	{
+		name: "WorkspaceDirectoryListing",
+		declaration: "export interface WorkspaceDirectoryListing {\n    readonly path: string;\n    readonly entries: readonly WorkspaceDirectoryEntry[];\n    readonly truncated: boolean;\n}"
+	},
+	{
+		name: "WorkspaceFileBytes",
+		declaration: "export interface WorkspaceFileBytes extends WorkspaceFileStat {\n    readonly offset: number;\n    readonly data: string;\n    readonly eof: boolean;\n}"
+	},
+	{
+		name: "WorkspaceFileChange",
+		declaration: "export type WorkspaceFileChange = {\n    readonly absolutePath: string;\n    readonly version: string;\n} | {\n    readonly absolutePath: string;\n    readonly absent: true;\n};"
+	},
+	{
+		name: "WorkspaceFileRange",
+		declaration: "export interface WorkspaceFileRange {\n    readonly offset?: number;\n    readonly limit?: number;\n}"
+	},
+	{
+		name: "WorkspaceFileScope",
+		declaration: "export interface WorkspaceFileScope {\n    readonly sessionId: SessionId;\n    readonly workspaceRoot: string;\n}"
+	},
+	{
+		name: "WorkspaceFileStat",
+		declaration: "export interface WorkspaceFileStat {\n    readonly absolutePath: string;\n    readonly version: string;\n    readonly bytes?: number;\n}"
+	},
+	{
+		name: "WorkspaceFileText",
+		declaration: "export interface WorkspaceFileText extends WorkspaceFileStat {\n    readonly offset: number;\n    readonly text: string;\n    readonly lines: number;\n    readonly eof: boolean;\n}"
+	},
+	{
+		name: "WorkspaceFileWatchFrame",
+		declaration: "export type WorkspaceFileWatchFrame = {\n    readonly kind: 'ready';\n} | {\n    readonly kind: 'change';\n    readonly change: WorkspaceFileChange;\n};"
+	},
 	{
 		name: "WorkspaceFollowFrame",
 		declaration: "export type WorkspaceFollowFrame = {\n    readonly type: 'baseline';\n    readonly value: WorkspaceBaseline;\n} | WorkspaceFollowIncrement;"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-tool-cordis",
   "description": "Self-referential cordis toolset: inspect the live runtime, mount and dispose model-written plugins",
-  "version": "0.1.3-alpha.2",
+  "version": "0.1.5-alpha.2",
   "publishConfig": {
     "access": "public"
   },
@@ -27,24 +27,24 @@
   ],
   "license": "MIT",
   "peerDependencies": {
-    "@deepseek-ai/dsh-cordis-host-runner": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-agent": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-llm": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-scope": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-tools": "^0.1.3-alpha.2",
+    "@deepseek-ai/dsh-agent": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-cordis-host-runner": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-llm": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-scope": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-tools": "^0.1.5-alpha.2",
     "@deepseek-ai/cordis": "^4.0.2"
   },
   "devDependencies": {
     "@deepseek-ai/cordis-plugin-loader": "^1.0.3",
-    "@deepseek-ai/dsh-agent": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-llm": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-scope": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-session": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-cordis-host-runner": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-system-prompt": "^0.1.3-alpha.2",
-    "@deepseek-ai/dsh-tools": "^0.1.3-alpha.2",
+    "@deepseek-ai/dsh-agent": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-cordis-host-runner": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-llm": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-scope": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-session": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-system-prompt": "^0.1.5-alpha.2",
+    "@deepseek-ai/dsh-tools": "^0.1.5-alpha.2",
     "@deepseek-ai/cordis": "^4.0.2"
   }
 }