@deepseek-ai/dsh-sdk-jsonrpc-server 0.0.1-rc.5

package/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2026, DeepSeek
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.i18n.yaml

@@ -0,0 +1,6 @@
+# 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:
+#   pnpm run verify-translation-pairing --write packages/sdk/server/README.md
+README.md: 5377b4fcf425cc5e10497e9d40fdddc075d52a10
+README.zh.md: dcca65a7175bb2774460bf265d98e41439df6a01

package/README.md

@@ -0,0 +1,48 @@
+# @deepseek-ai/dsh-sdk-jsonrpc-server
+
+English | [中文](README.zh.md)
+
+The `jsonrpc` plugin serves newline-delimited JSON-RPC over stdio so out-of-process SDK clients can drive harness agents. [`HarnessSdkJsonRpcServer`](src/server.ts) owns the protocol methods and notifications; the transport and the named wire types live in [`dsh-sdk-protocol`](../protocol/README.md), shared with the client SDKs; [`jsonrpc-demo`](../../examples/jsonrpc-demo/README.md) supplies the surrounding `cordis.yml` application.
+
+## Wiring
+
+`inject: ['agents']`. The server gets or creates one agent per `sessionId`. It forwards subagent completions only when the service-snapshotted lifecycle `local` flag is true; provider names, child ids, and durable lineage never establish locality. A registered adapter wins, an unowned `deepseek-official` route mounts `dsh-llm-deepseek`, and any other unowned provider fails initialization. Other capabilities come from the surrounding `cordis.yml`.
+
+## Config
+
+`maxTokensAsSuccess` defaults to `false` and affects only the deployment-mapped status on `subagent.finished`; root-session prompts have no prompt-level status. `JsonRpcConfig.input`, `output`, and `exit` are runtime-only transport hooks; production uses process stdio and `process.exit`.
+
+## stdout is the protocol
+
+Stdout carries only JSON-RPC frames. The deployment must not compose a stdout logger; diagnostics belong on stderr.
+
+## Shutdown and exit semantics
+
+The plugin answers `shutdown`, flushes the response, disposes the root context so SDK-owned agents, subscriptions, and persistence reach quiescence, then exits with code 0. EOF and signal exits belong to the app bin, which also disposes the root context. Unloading only this plugin stops serving without exiting the process.
+
+## Wire notes
+
+`initialize.serverInfo.name` is the wire-stable `deepseek-harness-sdk-runtime`. An optional positive `initialize.maxTokens` becomes the request output cap of each SDK-created agent and its in-process descendants; invalid values reject initialization, while omission sends no SDK cap and allows the selected adapter or provider route default to apply. `session/prompt` queues one identified user message and immediately returns `{ messageId }`. The server streams every durable fact as `session.event` and every whole-agent lifecycle transition as `session.status`; it does not assign an assistant message or `turn/end` to that prompt. Independent requests may enqueue more work on the same session. Persistence roots and persona come from `cordis.yml`.
+
+## Model Experience
+
+### SDK user message
+
+#### What the model sees
+
+For each accepted `session/prompt`, the conversation model receives the caller-supplied `contentBlocks` verbatim as one user message in that SDK session. This package adds no system-prompt prose or tool schema; those come from the plugins in the surrounding `cordis.yml`.
+
+#### Token effect
+
+Data-dependent user-message tokens enter retained session history and are resent on later turns until another package compacts them. The JSON-RPC frames, session notifications, and server bookkeeping add zero model-context tokens.
+
+#### KV Cache effect
+
+Append-only; newly visible content follows the reusable request prefix and does not invalidate existing KV-cache entries.
+
+## Known Limitations and Deferred Work
+
+- **The wire has no per-session close or prompt-cancel method** — SDK-created agents remain live until process shutdown.
+- **There is no per-prompt result** — `MessageId` identifies inbox admission only; clients that own an automation interval must define and observe that interval themselves.
+- **stdout purity is deployment-enforced** — a surrounding config can still load a stdout logger and corrupt the JSON-RPC channel; this plugin does not inspect or veto sibling loggers.
+- **Automatic adapter mounting is DeepSeek-specific** — `initialize` can reuse any pre-registered model adapter, but its only fallback mounts `dsh-llm-deepseek`.

package/README.zh.md

@@ -0,0 +1,48 @@
+# @deepseek-ai/dsh-sdk-jsonrpc-server
+
+[English](README.md) | 中文
+
+`jsonrpc` 插件通过 stdio 提供以换行符分隔的 JSON-RPC，使进程外 SDK 客户端能够驱动 harness agent（智能体）。[`HarnessSdkJsonRpcServer`](src/server.ts) 负责协议方法和通知；传输与具名协议类型位于 [`dsh-sdk-protocol`](../protocol/README.md)，与客户端 SDK 共享；[`jsonrpc-demo`](../../examples/jsonrpc-demo/README.md) 提供外围的 `cordis.yml` 应用。
+
+## 组装
+
+`inject: ['agents']`。服务器按 `sessionId` 获取或创建一个 agent。只有服务对生命周期建立快照时记录的 `local` 标志为 true，服务器才会转发 subagent 完成事件；提供方名称、子级 id 和持久化谱系均不能证明本地性。已注册的适配器优先；尚无适配器负责的 `deepseek-official` 路由会挂载 `dsh-llm-deepseek`，任何其他尚无适配器负责的提供方都会导致初始化失败。其他能力由外围 `cordis.yml` 提供。
+
+## 配置
+
+`maxTokensAsSuccess` 默认为 `false`，且只影响 `subagent.finished` 上由部署映射的状态；根会话提示词没有提示词级状态。`JsonRpcConfig.input`、`output` 和 `exit` 是仅供运行时使用的传输钩子；生产环境使用进程 stdio 和 `process.exit`。
+
+## stdout 即协议
+
+Stdout 只承载 JSON-RPC 帧。部署不得组合 stdout logger；诊断应写入 stderr。
+
+## 关闭与退出语义
+
+插件响应 `shutdown`，刷新响应并 dispose（资源释放）根上下文，使 SDK 持有的 agent、订阅和持久化达到完全停稳，然后以代码 0 退出。EOF 和信号退出由 app bin 处理，后者也会 dispose 根上下文。仅卸载此插件会停止服务，但不会退出进程。
+
+## 协议说明
+
+`initialize.serverInfo.name` 的协议稳定值为 `deepseek-harness-sdk-runtime`。可选的正整数 `initialize.maxTokens` 会成为每个 SDK 创建的 agent 及其进程内后代的请求输出上限；非法值会使初始化失败，省略时则不发送 SDK 上限，并应用所选适配器或提供方路由的默认值。`session/prompt` 将一条带标识的用户消息排入队列，并立即返回 `{ messageId }`。服务器将每个持久事实作为 `session.event` 流式发出，并将整个 agent 生命周期的每次状态转换作为 `session.status` 发出；它不会把某条助手消息或 `turn/end` 归属于该提示词。同一会话上的独立请求可以继续排入更多工作。持久化根目录和 persona 由 `cordis.yml` 提供。
+
+## 模型体验
+
+### SDK 用户消息
+
+#### 模型看到的内容
+
+对于每个已接受的 `session/prompt`，对话模型会将调用方提供的 `contentBlocks` 原样作为该 SDK 会话中的一条用户消息接收。此包不会添加系统提示词文本或工具 schema；这些内容来自外围 `cordis.yml` 中的插件。
+
+#### Token 影响
+
+依数据而定的用户消息 token 会进入保留的会话历史，并在后续轮次中重复发送，直至另一个包将其压缩（compaction）。JSON-RPC 帧、会话通知和服务器内部记录不会增加模型上下文 token。
+
+#### KV Cache 影响
+
+仅追加；新可见内容位于可复用请求前缀之后，不会使现有 KV Cache 条目失效。
+
+## 已知限制与暂缓事项
+
+- **协议没有逐会话关闭或提示词取消方法**：SDK 创建的 agent 会一直存活到进程关闭。
+- **没有逐提示词结果**：`MessageId` 只标识 inbox 准入；拥有自动化活动区间的客户端必须自行定义并观察该区间。
+- **stdout 纯净性由部署保证**：外围配置仍可能加载 stdout logger 并破坏 JSON-RPC 通道；此插件不会检查或否决同级 logger。
+- **自动挂载适配器仅支持 DeepSeek**：`initialize` 可以复用任何预先注册的模型适配器，但唯一的回退行为是挂载 `dsh-llm-deepseek`。

package/lib/index.js

@@ -0,0 +1,254 @@
+import Schema from "@deepseek-ai/schemastery";
+import { JsonRpcLineTransport } from "@deepseek-ai/dsh-sdk-protocol";
+import { resolve } from "node:path";
+import { createUserMessage } from "@deepseek-ai/dsh-llm";
+import { carrierKeyOf } from "@deepseek-ai/dsh-scope";
+import { SessionId } from "@deepseek-ai/dsh-session";
+import * as LlmDeepSeek from "@deepseek-ai/dsh-llm-deepseek";
+//#region lib/types/server.js
+/**
+* JSON-RPC methods and notifications for out-of-process harness SDKs.
+* The surrounding context owns plugins, persistence, and configured adapters.
+*
+* @module @deepseek-ai/dsh-sdk-jsonrpc-server/server
+*/
+/** Recover the delegating parent from the service-owned scoped carrier. */
+function subagentParentOf(carrier) {
+	return carrierKeyOf(carrier);
+}
+function successStatus(reason, options) {
+	if (reason === "completed") return "ok";
+	return reason === "max-tokens" && options.maxTokensAsSuccess === true ? "ok" : "error";
+}
+/**
+* SDK server over one booted harness context and transport peer. Construction
+* subscribes to session, agent, and subagent lifecycle events until shutdown;
+* reinitialization is unsupported.
+*/
+var HarnessSdkJsonRpcServer = class {
+	ctx;
+	transport;
+	options;
+	cwd = process.cwd();
+	provider = "deepseek-official";
+	model = "deepseek-official";
+	maxTokens;
+	llmFiber;
+	sessions = /* @__PURE__ */ new Map();
+	sessionCreations = /* @__PURE__ */ new Map();
+	disposers = [];
+	shutdownTask;
+	shuttingDown = false;
+	constructor(ctx, transport, options = {}) {
+		this.ctx = ctx;
+		this.transport = transport;
+		this.options = options;
+		const serverOptions = this.options;
+		this.disposers.push(ctx.on("session/event", (session, event) => {
+			const payload = {
+				sessionId: String(session.id),
+				event
+			};
+			this.transport.notify("session.event", payload);
+		}));
+		this.disposers.push(ctx.on("agent/status", ({ agent, status }) => {
+			this.transport.notify("session.status", {
+				sessionId: String(agent.session.id),
+				status
+			});
+		}));
+		this.disposers.push(ctx.on("session/created", (session) => {
+			const parentSession = session.header.parentSession;
+			if (parentSession === void 0) return;
+			const payload = {
+				parentSessionId: String(parentSession),
+				childSessionId: String(session.id)
+			};
+			this.transport.notify("subagent.started", payload);
+		}));
+		this.disposers.push(ctx.on("subagent/end", function(info) {
+			const parent = subagentParentOf(this);
+			if (!info.local) return;
+			const payload = {
+				provider: info.provider,
+				agentId: String(info.id),
+				parentSessionId: String(parent.session.id),
+				childSessionId: String(info.id),
+				status: successStatus(info.stopReason, serverOptions),
+				stopReason: info.stopReason,
+				...info.lastAssistantMessage === void 0 ? {} : { lastAssistantMessage: info.lastAssistantMessage }
+			};
+			transport.notify("subagent.finished", payload);
+		}));
+	}
+	/**
+	* Configure the SDK route, mounting the DeepSeek fallback only when unowned.
+	* @param params - SDK handshake parameters.
+	* @returns server identity for the handshake.
+	*/
+	async initialize(params) {
+		if (params.maxTokens !== void 0 && (!Number.isSafeInteger(params.maxTokens) || params.maxTokens <= 0)) throw new TypeError("initialize maxTokens must be a positive safe integer");
+		this.cwd = resolve(params.cwd);
+		this.provider = params.provider;
+		this.model = params.model;
+		this.maxTokens = params.maxTokens;
+		if (!this.hasAdapterFor(this.provider)) {
+			if (this.provider !== "deepseek-official") throw new Error(`no adapter registered for provider "${this.provider}"`);
+			this.llmFiber = await this.ctx.plugin(LlmDeepSeek, {});
+		}
+		return { serverInfo: {
+			name: "deepseek-harness-sdk-runtime",
+			version: "0.0.1"
+		} };
+	}
+	/**
+	* Queue one identified prompt without assigning later activity to it.
+	* @param params - target session and user content.
+	* @returns the durable message identity.
+	*/
+	async prompt(params) {
+		const rec = await this.getOrCreateSession(params.sessionId);
+		if (this.ctx.agents.get(rec.handle.agent.id) !== rec.handle.agent) throw new Error(`session agent was disposed outside the server: ${params.sessionId}`);
+		const message = createUserMessage({
+			content: params.contentBlocks,
+			source: { kind: "user" }
+		});
+		rec.handle.agent.followup(message);
+		return { messageId: message.id };
+	}
+	/**
+	* Dispose server-owned agents, adapter, and subscriptions to quiescence.
+	* The surrounding context remains running.
+	* @returns empty JSON-RPC result.
+	*/
+	shutdown() {
+		this.shutdownTask ??= this.performShutdown();
+		return this.shutdownTask;
+	}
+	async performShutdown() {
+		this.shuttingDown = true;
+		const pendingCreations = [...this.sessionCreations.values()];
+		await Promise.allSettled(pendingCreations);
+		this.sessionCreations.clear();
+		const records = [...this.sessions.values()];
+		this.sessions.clear();
+		const failures = [];
+		while (this.disposers.length > 0) try {
+			this.disposers.pop()?.();
+		} catch (error) {
+			failures.push(error);
+		}
+		const teardownResults = await Promise.allSettled([...records.map((rec) => Promise.resolve().then(() => rec.handle.dispose())), ...this.llmFiber === void 0 ? [] : [Promise.resolve().then(() => this.llmFiber?.dispose())]]);
+		this.llmFiber = void 0;
+		failures.push(...teardownResults.filter((result) => result.status === "rejected").map((result) => result.reason));
+		if (failures.length === 1) throw failures[0];
+		if (failures.length > 1) throw new AggregateError(failures, "SDK server teardown failed");
+		return {};
+	}
+	/**
+	* Dispatch one incoming JSON-RPC request to its typed handler. Throws (→ a
+	* JSON-RPC error response) on an unknown method.
+	* @param method - the JSON-RPC method name.
+	* @param params - the raw params object from the wire.
+	* @returns the handler's result, to be serialized as the response.
+	*/
+	async handleRequest(method, params) {
+		switch (method) {
+			case "initialize": return this.initialize(params);
+			case "session/prompt": return this.prompt(params);
+			case "shutdown": return this.shutdown();
+			default: throw new Error(`unknown DeepSeek Harness SDK runtime method: ${method}`);
+		}
+	}
+	async getOrCreateSession(sessionId) {
+		if (this.shuttingDown) throw new Error("SDK server is shutting down");
+		const existing = this.sessions.get(sessionId);
+		if (existing) return existing;
+		const pending = this.sessionCreations.get(sessionId);
+		if (pending) return pending;
+		const creation = this.createSession(sessionId);
+		this.sessionCreations.set(sessionId, creation);
+		creation.then(() => {
+			this.sessionCreations.delete(sessionId);
+		}, () => {
+			this.sessionCreations.delete(sessionId);
+		});
+		return creation;
+	}
+	async createSession(sessionId) {
+		const rec = { handle: await this.ctx.agents.create({
+			sessionId: SessionId(sessionId),
+			meta: { cwd: this.cwd },
+			agentOptions: {
+				provider: this.provider,
+				model: this.model,
+				...this.maxTokens === void 0 ? {} : { maxTokens: this.maxTokens }
+			}
+		}) };
+		this.sessions.set(sessionId, rec);
+		return rec;
+	}
+	hasAdapterFor(provider) {
+		return this.ctx.get("llm")?.listProviders().some((entry) => entry.id === provider) ?? false;
+	}
+};
+//#endregion
+//#region lib/types/index.js
+/**
+* SDK-facing JSON-RPC plugin over stdio. An external `cordis.yml` decides
+* whether to load it; see the single-executable Agent Note and package README.
+* Stdout is reserved for protocol frames, so the tree must not load a stdout logger.
+* This plugin answers `shutdown`, disposes the complete root runtime, and exits 0; the app bin
+* owns EOF and signal exits. Keep named plugin exports with no default export so
+* Loader `unwrapExports` preserves `name`, `inject`, `Config`, and `apply`.
+*
+* @module @deepseek-ai/dsh-sdk-jsonrpc-server
+*/
+const name = "sdk-jsonrpc-server";
+const inject = ["agents"];
+const Config = Schema.object({ maxTokensAsSuccess: Schema.boolean().default(false) });
+/**
+* Serve SDK requests over the configured streams. Effect disposal shuts down
+* SDK-created agents and closes the transport. A `shutdown` response is flushed
+* before the root runtime is disposed and the process exits 0; the app bin
+* owns root-context disposal for EOF and signals.
+*/
+function apply(ctx, config) {
+	const resolvedConfig = config;
+	const rootFiber = ctx.root.fiber;
+	/* v8 ignore next -- production stdio wiring; tests always inject the runtime hooks */
+	const input = config.input ?? process.stdin;
+	/* v8 ignore next -- production stdio wiring; tests always inject the runtime hooks */
+	const output = config.output ?? process.stdout;
+	/* v8 ignore next -- production exit wiring; tests always inject the runtime hooks */
+	const exit = config.exit ?? ((code) => {
+		process.exit(code);
+	});
+	const transport = new JsonRpcLineTransport(input, output);
+	const server = new HarnessSdkJsonRpcServer(ctx, transport, { maxTokensAsSuccess: resolvedConfig.maxTokensAsSuccess });
+	let exitTask;
+	const disposeAndExit = () => {
+		exitTask ??= (async () => {
+			await Promise.allSettled([Promise.resolve().then(() => transport.flush())]);
+			await Promise.allSettled([Promise.resolve().then(() => rootFiber.dispose())]);
+			exit(0);
+		})();
+		return exitTask;
+	};
+	transport.onRequest(async (method, params) => {
+		const result = await server.handleRequest(method, params);
+		if (method === "shutdown") setImmediate(() => {
+			disposeAndExit();
+		});
+		return result;
+	});
+	ctx.effect(() => {
+		transport.start();
+		return async () => {
+			await server.shutdown();
+			transport.close();
+		};
+	}, "jsonrpc.serve");
+}
+//#endregion
+export { Config, HarnessSdkJsonRpcServer, apply, inject, name };

package/lib/invariant.js

@@ -0,0 +1,23 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@deepseek-ai/dsh-sdk-jsonrpc-server`.
+* @module @deepseek-ai/dsh-sdk-jsonrpc-server/invariant
+*/
+const PACKAGE_NAME = "@deepseek-ai/dsh-sdk-jsonrpc-server";
+/** Cordis companion plugin name. */
+const name = "sdk-jsonrpc-server-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: this presentation adapter owns no durable package-local event stream;
+* boundary and replay tests cover its protocol mapping.
+*/
+const install = () => {};
+/**
+* Register this package's invariant companion.
+* @param ctx - Cordis context carrying the invariant service.
+* @returns the installed registration's disposer after setup succeeds.
+*/
+const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+//#endregion
+export { apply, inject, name };

package/lib/types/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * SDK-facing JSON-RPC plugin over stdio. An external `cordis.yml` decides
+ * whether to load it; see the single-executable Agent Note and package README.
+ * Stdout is reserved for protocol frames, so the tree must not load a stdout logger.
+ * This plugin answers `shutdown`, disposes the complete root runtime, and exits 0; the app bin
+ * owns EOF and signal exits. Keep named plugin exports with no default export so
+ * Loader `unwrapExports` preserves `name`, `inject`, `Config`, and `apply`.
+ *
+ * @module @deepseek-ai/dsh-sdk-jsonrpc-server
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { Readable, Writable } from 'node:stream';
+import Schema from '@deepseek-ai/schemastery';
+export * from './server.ts';
+export declare const name = "sdk-jsonrpc-server";
+export declare const inject: string[];
+/** JSON-RPC deployment config plus runtime-only test hooks. */
+export interface JsonRpcConfig {
+    /** Report max-token turn/subagent termination as a successful SDK result. */
+    maxTokensAsSuccess?: boolean;
+    /** Transport input override; production uses `process.stdin`. */
+    input?: Readable;
+    /** Transport output override; production uses `process.stdout`. */
+    output?: Writable;
+    /** Process-exit override; production uses `process.exit`. */
+    exit?: (code: number) => void;
+}
+export declare const Config: Schema<JsonRpcConfig>;
+/**
+ * Serve SDK requests over the configured streams. Effect disposal shuts down
+ * SDK-created agents and closes the transport. A `shutdown` response is flushed
+ * before the root runtime is disposed and the process exits 0; the app bin
+ * owns root-context disposal for EOF and signals.
+ */
+export declare function apply(ctx: Context, config: JsonRpcConfig): void;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@deepseek-ai/dsh-sdk-jsonrpc-server`.
+ * @module @deepseek-ai/dsh-sdk-jsonrpc-server/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "sdk-jsonrpc-server-invariant";
+/** Service required before the companion can reserve package ownership. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/lib/types/server.d.ts

@@ -0,0 +1,65 @@
+/**
+ * JSON-RPC methods and notifications for out-of-process harness SDKs.
+ * The surrounding context owns plugins, persistence, and configured adapters.
+ *
+ * @module @deepseek-ai/dsh-sdk-jsonrpc-server/server
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import type { InitializeParams, InitializeResult, JsonRpcTransportPeer, SessionPromptParams, SessionPromptResult } 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. */
+    maxTokensAsSuccess?: boolean;
+}
+/**
+ * SDK server over one booted harness context and transport peer. Construction
+ * subscribes to session, agent, and subagent lifecycle events until shutdown;
+ * reinitialization is unsupported.
+ */
+export declare class HarnessSdkJsonRpcServer {
+    private readonly ctx;
+    private readonly transport;
+    private readonly options;
+    private cwd;
+    private provider;
+    private model;
+    private maxTokens;
+    private llmFiber;
+    private readonly sessions;
+    private readonly sessionCreations;
+    private readonly disposers;
+    private shutdownTask;
+    private shuttingDown;
+    constructor(ctx: Context, transport: JsonRpcTransportPeer, options?: HarnessSdkJsonRpcServerOptions);
+    /**
+     * Configure the SDK route, mounting the DeepSeek fallback only when unowned.
+     * @param params - SDK handshake parameters.
+     * @returns server identity for the handshake.
+     */
+    initialize(params: InitializeParams): Promise<InitializeResult>;
+    /**
+     * Queue one identified prompt without assigning later activity to it.
+     * @param params - target session and user content.
+     * @returns the durable message identity.
+     */
+    prompt(params: SessionPromptParams): Promise<SessionPromptResult>;
+    /**
+     * Dispose server-owned agents, adapter, and subscriptions to quiescence.
+     * The surrounding context remains running.
+     * @returns empty JSON-RPC result.
+     */
+    shutdown(): Promise<Record<string, never>>;
+    private performShutdown;
+    /**
+     * Dispatch one incoming JSON-RPC request to its typed handler. Throws (→ a
+     * JSON-RPC error response) on an unknown method.
+     * @param method - the JSON-RPC method name.
+     * @param params - the raw params object from the wire.
+     * @returns the handler's result, to be serialized as the response.
+     */
+    handleRequest(method: string, params: Record<string, unknown> | undefined): Promise<unknown>;
+    private getOrCreateSession;
+    private createSession;
+    private hasAdapterFor;
+}
+//# sourceMappingURL=server.d.ts.map

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@deepseek-ai/dsh-sdk-jsonrpc-server",
+  "description": "Stdio JSON-RPC server plugin for out-of-process DeepSeek Harness SDK clients",
+  "version": "0.0.1-rc.5",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/sdk/server"
+  },
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./invariant": {
+      "types": "./lib/types/invariant.d.ts",
+      "default": "./lib/invariant.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/index.js",
+    "lib/invariant.js",
+    "lib/types/**/*.d.ts"
+  ],
+  "license": "BSD-3-Clause",
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.1-rc.4"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.5",
+    "@deepseek-ai/dsh-llm": "^0.0.1-rc.5",
+    "@deepseek-ai/dsh-agent": "^0.0.1-rc.5",
+    "@deepseek-ai/dsh-scope": "^0.0.1-rc.5",
+    "@deepseek-ai/dsh-sdk-protocol": "^0.0.1-rc.5",
+    "@deepseek-ai/dsh-session": "^0.0.1-rc.5",
+    "@deepseek-ai/dsh-subagent": "^0.0.1-rc.5",
+    "@deepseek-ai/cordis": "^4.0.1-rc.4",
+    "@deepseek-ai/dsh-llm-deepseek": "^0.0.1-rc.5"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis-plugin-loader": "^1.0.2-rc.4",
+    "@deepseek-ai/dsh-agent": "^0.0.1-rc.5",
+    "@deepseek-ai/dsh-agent-spine-demo": "^0.0.1-rc.5",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.5",
+    "@deepseek-ai/dsh-scope": "^0.0.1-rc.5",
+    "@deepseek-ai/dsh-sdk-protocol": "^0.0.1-rc.5",
+    "@deepseek-ai/dsh-session": "^0.0.1-rc.5",
+    "@deepseek-ai/dsh-session-persistence-jsonl": "^0.0.1-rc.5",
+    "@deepseek-ai/dsh-subagent": "^0.0.1-rc.5",
+    "@deepseek-ai/cordis": "^4.0.1-rc.4",
+    "@deepseek-ai/dsh-llm": "^0.0.1-rc.5",
+    "@deepseek-ai/dsh-llm-deepseek": "^0.0.1-rc.5"
+  }
+}