@deepseek-ai/dsh-sdk-jsonrpc-server 0.2.1-alpha.2 → 0.2.1-alpha.3

package/README.i18n.yaml

@@ -15,8 +15,8 @@
   en: d152484eb41ac6b4
   zh: 09388d293f9be9cb
 /deepseek-ai-dsh-sdk-jsonrpc-server/use-this-package:
-  en: ab5b719668e746f2
-  zh: 971c2fdaa9e7d351
+  en: e136ff3a0b42cc22
+  zh: f6c4df5bbafa335f
 /deepseek-ai-dsh-sdk-jsonrpc-server/use-this-package/wiring:
   en: 47a33e9397e36e15
   zh: e6d173820f9ea6e5

package/README.md

@@ -25,6 +25,8 @@ English | [中文](README.zh.md)
 <a id="use-this-package"></a>
 ## Use this package
 
+`session/resume` accepts a persisted `{ sessionId }` after initialization and returns `{}` once its Agent is ready. It loads history through `agents.resume()`, repairs an interrupted final turn, and preserves the stored origin and effective directory while applying the initialized model route. It sends no new input. Missing, unreadable, incompatible, or occupied sessions reject without creating a replacement. Prompts for an identity currently being restored wait for that restoration; shutdown drains pending restoration and releases its Agent. Historical events are retained in the log rather than streamed again as new notifications.
+
 `session/working-directory/get` accepts `{ sessionId }`; `session/working-directory/set` accepts `{ sessionId, path }`. Both return `{ cwd }` and create an unknown Session without starting a model turn. Reads recover missing directories through the working-directory service; changes preserve origin metadata and permissions, and reach the model through logged user context.
 
 Mount this plugin when a runtime must serve SDK clients: add it to a `cordis.yml` that composes the agent service, boot the runtime, and clients connect over stdio. The common path is explicit — the plugin needs the `agents` service; every other capability comes from the surrounding tree.

package/README.zh.md

@@ -25,6 +25,8 @@ kind: "package-reference"
 <a id="use-this-package"></a>
 ## 使用本包
 
+`session/resume` 在初始化后接受持久化的 `{ sessionId }`，待其 Agent 就绪后返回 `{}`。它通过 `agents.resume()` 加载历史、修复最后一个被中断的轮次，并保留存储的起始目录和当前有效目录，同时应用初始化时选定的模型路由。它不发送新输入。会话缺失、不可读、不兼容或被占用时，请求失败且不创建替代会话。对正在恢复的标识发送提示词时，会等待恢复完成；shutdown 会等待进行中的恢复并释放其 Agent。历史事件保留在日志中，不会作为新通知重新发送。
+
 `session/working-directory/get` 接收 `{ sessionId }`；`session/working-directory/set` 接收 `{ sessionId, path }`。两者均返回 `{ cwd }`，并可创建未知 Session，而不启动模型轮次。读取通过工作目录服务恢复缺失目录；修改保留起始目录元数据与权限，并通过已记录的用户上下文告知模型。
 
 当运行时必须服务 SDK 客户端时挂载本插件：把它加入组合了 agent 服务的 `cordis.yml`，启动运行时，客户端即可通过 stdio 连接。常用路径是显式的——插件需要 `agents` 服务；其余每个能力都来自外围插件树。

package/lib/index.js

@@ -164,6 +164,21 @@ var HarnessSdkJsonRpcServer = class {
 		return { messageId: message.id };
 	}
 	/**
+	* Restore a persisted session and repair its interrupted final turn without sending input.
+	* Uses the initialized model route while preserving the stored session identity and directory.
+	* Rejects missing, unreadable, or already owned sessions; never creates a replacement.
+	* @param params - persisted session identity in the configured persistence store.
+	* @returns an empty result after the Agent is ready for prompts.
+	*/
+	async resume(params) {
+		if (!this.initialized) throw new Error("SDK server is not initialized");
+		if (this.shuttingDown) throw new Error("SDK server is shutting down");
+		const sessionId = params.sessionId;
+		if (this.sessions.has(sessionId) || this.sessionCreations.has(sessionId)) throw new Error(`SDK session is already open or opening: ${sessionId}`);
+		await this.openSession(sessionId, true);
+		return {};
+	}
+	/**
 	* Wait for an existing owned Agent and its managed descendants to finish.
 	* The response follows all Session notifications emitted during the wait.
 	* Rejects a live Agent failure that has no subsequent durable terminal.
@@ -261,6 +276,11 @@ var HarnessSdkJsonRpcServer = class {
 		switch (method) {
 			case "initialize": return this.initialize(params);
 			case "session/prompt": return this.prompt(params);
+			case "session/resume": {
+				const sessionId = params?.sessionId;
+				if (typeof sessionId !== "string" || sessionId.length === 0) throw new TypeError("session/resume requires a non-empty sessionId string");
+				return this.resume({ sessionId });
+			}
 			case "session/wait": {
 				const sessionId = params?.sessionId;
 				if (typeof sessionId !== "string") throw new TypeError("session/wait requires a sessionId string");
@@ -285,7 +305,10 @@ var HarnessSdkJsonRpcServer = class {
 		if (existing) return existing;
 		const pending = this.sessionCreations.get(sessionId);
 		if (pending) return pending;
-		const creation = this.createSession(sessionId);
+		return this.openSession(sessionId, false);
+	}
+	openSession(sessionId, resume) {
+		const creation = this.createSession(sessionId, resume);
 		this.sessionCreations.set(sessionId, creation);
 		creation.then(() => {
 			this.sessionCreations.delete(sessionId);
@@ -294,18 +317,22 @@ var HarnessSdkJsonRpcServer = class {
 		});
 		return creation;
 	}
-	async createSession(sessionId) {
+	async createSession(sessionId, resume) {
+		const agentOptions = {
+			provider: this.provider,
+			model: this.model,
+			...this.reasoningEffort === void 0 ? {} : { reasoningEffort: this.reasoningEffort },
+			...this.maxTokens === void 0 ? {} : { maxTokens: this.maxTokens }
+		};
 		const rec = {
-			handle: await this.ctx.agents.create({
+			handle: await (resume ? this.ctx.agents.resume({
+				resumeSessionId: brandString(sessionId),
+				agentOptions
+			}) : this.ctx.agents.create({
 				sessionId: brandString(sessionId),
 				meta: { cwd: this.cwd },
-				agentOptions: {
-					provider: this.provider,
-					model: this.model,
-					...this.reasoningEffort === void 0 ? {} : { reasoningEffort: this.reasoningEffort },
-					...this.maxTokens === void 0 ? {} : { maxTokens: this.maxTokens }
-				}
-			}),
+				agentOptions
+			})),
 			failure: void 0
 		};
 		this.sessions.set(sessionId, rec);

package/lib/types/server.d.ts

@@ -5,7 +5,7 @@
  * @module @deepseek-ai/dsh-sdk-jsonrpc-server/server
  */
 import type { Context } from '@deepseek-ai/cordis';
-import type { InitializeParams, InitializeResult, JsonRpcTransportPeer, SessionPromptParams, SessionPromptResult, SessionWaitParams, SessionWorkingDirectoryParams, SessionWorkingDirectorySetParams, SessionWorkingDirectoryResult } from '@deepseek-ai/dsh-sdk-protocol';
+import type { InitializeParams, InitializeResult, JsonRpcTransportPeer, SessionPromptParams, SessionPromptResult, SessionResumeParams, SessionWaitParams, SessionWorkingDirectoryParams, SessionWorkingDirectorySetParams, SessionWorkingDirectoryResult } from '@deepseek-ai/dsh-sdk-protocol';
 /** Deployment-specific status mapping for SDK turn and subagent outcomes. */
 export interface HarnessSdkJsonRpcServerOptions {
     /** Report max-token termination as an accepted result instead of an infrastructure error. */
@@ -45,6 +45,14 @@ export declare class HarnessSdkJsonRpcServer {
      * @returns the durable message identity.
      */
     prompt(params: SessionPromptParams): Promise<SessionPromptResult>;
+    /**
+     * Restore a persisted session and repair its interrupted final turn without sending input.
+     * Uses the initialized model route while preserving the stored session identity and directory.
+     * Rejects missing, unreadable, or already owned sessions; never creates a replacement.
+     * @param params - persisted session identity in the configured persistence store.
+     * @returns an empty result after the Agent is ready for prompts.
+     */
+    resume(params: SessionResumeParams): Promise<Record<string, never>>;
     /**
      * Wait for an existing owned Agent and its managed descendants to finish.
      * The response follows all Session notifications emitted during the wait.
@@ -84,6 +92,7 @@ export declare class HarnessSdkJsonRpcServer {
      */
     handleRequest(method: string, params: Record<string, unknown> | undefined): Promise<unknown>;
     private getOrCreateSession;
+    private openSession;
     private createSession;
     private hasAdapterFor;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-sdk-jsonrpc-server",
   "description": "Stdio JSON-RPC server plugin for out-of-process DeepSeek Harness SDK clients",
-  "version": "0.2.1-alpha.2",
+  "version": "0.2.1-alpha.3",
   "publishConfig": {
     "access": "public"
   },
@@ -27,36 +27,36 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@deepseek-ai/dsh-brand": "0.2.1-alpha.2",
-    "@deepseek-ai/schemastery": "~3.18.5-alpha.1"
+    "@deepseek-ai/dsh-brand": "0.2.1-alpha.3",
+    "@deepseek-ai/schemastery": "~3.18.5-alpha.2"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
-    "@deepseek-ai/dsh-agent": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-attachment": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-llm": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-llm-deepseek-api-key": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-scope": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-sdk-protocol": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-subagent": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-working-directory": "0.2.1-alpha.2"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2",
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-attachment": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-llm-deepseek-api-key": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-scope": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-sdk-protocol": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-subagent": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-working-directory": "0.2.1-alpha.3"
   },
   "devDependencies": {
-    "@deepseek-ai/cordis": "~4.0.5-alpha.1",
-    "@deepseek-ai/cordis-plugin-loader": "~1.0.6-alpha.1",
-    "@deepseek-ai/dsh-agent": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-agent-loop": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-agent-loop-testkit": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-attachment": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-llm": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-llm-deepseek-api-key": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-scope": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-sdk-protocol": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-session": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-session-persistence-jsonl": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-subagent": "0.2.1-alpha.2",
-    "@deepseek-ai/dsh-working-directory": "0.2.1-alpha.2"
+    "@deepseek-ai/cordis": "~4.0.5-alpha.2",
+    "@deepseek-ai/cordis-plugin-loader": "~1.0.6-alpha.2",
+    "@deepseek-ai/dsh-agent": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-agent-loop": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-agent-loop-testkit": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-attachment": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-llm": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-llm-deepseek-api-key": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-scope": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-sdk-protocol": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-session-projection": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-subagent": "0.2.1-alpha.3",
+    "@deepseek-ai/dsh-working-directory": "0.2.1-alpha.3"
   }
 }