@deepseek-ai/dsh-sdk-client 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-client/use-this-package:
-  en: 316b142489dd050f
-  zh: 2b37ae57b2a52b5e
+  en: ff421f12a5db28a4
+  zh: 2ca9b71a3458b5e0
 /deepseek-ai-dsh-sdk-client/use-this-package/running-agent-turns-with-deepseekharness:
   en: 01c58dddd7e62de2
   zh: 6dbd46e244f3f135

package/README.md

@@ -25,6 +25,8 @@ English | [中文](README.zh.md)
 <a id="use-this-package"></a>
 ## Use this package
 
+`await harness.resumeSession(savedId)` restores a persisted session from the configured `dshHome` and returns a `HarnessSession` ready for `run()`. Save the original session id and reuse its home and workspace. Restoration preserves conversation history and its directory, repairs an interrupted final turn, and sends no new input. Missing, unreadable, incompatible, or occupied sessions reject without creating a replacement. `session(id)` remains a lazy handle for an in-process session; it does not request persisted restoration. Shell, browser, and other external processes are not restored by this API.
+
 `HarnessSession.getWorkingDirectory()` reads the effective directory; `setWorkingDirectory(path)` changes it and returns the validated absolute path. Either method creates an unknown Session without starting a model turn. Relative paths use the Session's current directory. Origin metadata, permissions, and existing processes remain unchanged. `HarnessClient` exposes the same methods with a leading `sessionId` argument.
 
 Use this client when TypeScript code must drive a complete Harness runtime from another process and you can name the runtime executable explicitly. The common path is minimal: construct a `DeepSeekHarness` with a launch spec, run prompts, and close it so the child process is always reaped.

package/README.zh.md

@@ -25,6 +25,8 @@ kind: "package-library"
 <a id="use-this-package"></a>
 ## 使用本包
 
+`await harness.resumeSession(savedId)` 从配置的 `dshHome` 恢复持久化会话，并返回可调用 `run()` 的 `HarnessSession`。请保存原会话 id，并沿用其 home 和工作区。恢复会保留对话历史及其目录、修复最后一个被中断的轮次，且不发送新输入。会话缺失、不可读、不兼容或被占用时，请求失败且不创建替代会话。`session(id)` 仍是当前进程内会话的惰性句柄，不会请求持久化恢复。此 API 不恢复 shell、浏览器或其他外部进程。
+
 `HarnessSession.getWorkingDirectory()` 读取有效目录；`setWorkingDirectory(path)` 修改目录并返回校验后的绝对路径。两个方法都可创建未知 Session，而不启动模型轮次。相对路径以 Session 当前目录解析。起始目录元数据、权限与已有进程保持不变。`HarnessClient` 提供同名方法，并以 `sessionId` 作为首个参数。
 
 当 TypeScript 代码需要从另一进程驱动完整 Harness 运行时、且你能显式指名运行时可执行文件时，使用本客户端。常用路径极简：用启动规格构造 `DeepSeekHarness`，运行提示词，然后关闭它，使子进程总能被回收。

package/lib/index.js

@@ -441,6 +441,14 @@ var HarnessClient = class {
 		return result.messageId;
 	}
 	/**
+	* Restore persisted history without sending a prompt; failures propagate without creating a session.
+	* @param sessionId - persisted identity in this runtime's configured persistence store.
+	* @returns after the session is ready for prompts.
+	*/
+	async resumeSession(sessionId) {
+		await this.request("session/resume", { sessionId });
+	}
+	/**
 	* Read a Session's effective working directory, recovering it if missing.
 	* @param sessionId - target Session; an unknown id creates it.
 	* @returns the absolute effective directory.
@@ -715,6 +723,17 @@ var DeepSeekHarness = class {
 		return new HarnessSession(this, sessionId ?? `session-${randomUUID().replaceAll("-", "")}`);
 	}
 	/**
+	* Start the runtime and restore a persisted session without sending input.
+	* The configured Harness home must contain its history; missing or occupied sessions reject.
+	* @param sessionId - exact persisted identity to continue.
+	* @returns a handle ready to run new prompts on the restored history.
+	*/
+	async resumeSession(sessionId) {
+		await this.start();
+		await this.client.resumeSession(sessionId);
+		return new HarnessSession(this, sessionId);
+	}
+	/**
 	* Run one prompt on a fresh (or named) session.
 	* @param input - prompt text, or content blocks sent verbatim.
 	* @param options - optional session id and per-notification observer.

package/lib/types/api.d.ts

@@ -53,6 +53,13 @@ export declare class DeepSeekHarness implements AsyncDisposable {
      * @returns the session handle.
      */
     session(sessionId?: string): HarnessSession;
+    /**
+     * Start the runtime and restore a persisted session without sending input.
+     * The configured Harness home must contain its history; missing or occupied sessions reject.
+     * @param sessionId - exact persisted identity to continue.
+     * @returns a handle ready to run new prompts on the restored history.
+     */
+    resumeSession(sessionId: string): Promise<HarnessSession>;
     /**
      * Run one prompt on a fresh (or named) session.
      * @param input - prompt text, or content blocks sent verbatim.

package/lib/types/client.d.ts

@@ -96,6 +96,12 @@ export declare class HarnessClient {
      * @returns the queued message id.
      */
     prompt(sessionId: string, contentBlocks: SdkPromptContentBlock[]): Promise<string>;
+    /**
+     * Restore persisted history without sending a prompt; failures propagate without creating a session.
+     * @param sessionId - persisted identity in this runtime's configured persistence store.
+     * @returns after the session is ready for prompts.
+     */
+    resumeSession(sessionId: string): Promise<void>;
     /**
      * Read a Session's effective working directory, recovering it if missing.
      * @param sessionId - target Session; an unknown id creates it.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@deepseek-ai/dsh-sdk-client",
   "description": "TypeScript client SDK for driving a DeepSeek Harness runtime subprocess over stdio JSON-RPC: the DeepSeekHarness high-level turns API and the lower-level HarnessClient",
-  "version": "0.2.1-alpha.2",
+  "version": "0.2.1-alpha.3",
   "publishConfig": {
     "access": "public"
   },
@@ -26,19 +26,19 @@
   ],
   "license": "MIT",
   "dependencies": {
-    "@deepseek-ai/dsh": "0.2.1-alpha.2"
+    "@deepseek-ai/dsh": "0.2.1-alpha.3"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-llm": "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/cordis": "~4.0.5-alpha.1"
+    "@deepseek-ai/dsh-llm": "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/cordis": "~4.0.5-alpha.2"
   },
   "devDependencies": {
-    "@deepseek-ai/dsh-llm": "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/cordis": "~4.0.5-alpha.1",
-    "@deepseek-ai/dsh-experimental-translator": "0.2.1-alpha.2"
+    "@deepseek-ai/dsh-llm": "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/cordis": "~4.0.5-alpha.2",
+    "@deepseek-ai/dsh-experimental-translator": "0.2.1-alpha.3"
   }
 }