@deepseek-ai/dsh-loader-smoke 0.0.1-rc.1

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/support/loader-smoke/README.md
+README.md: e5a33beb95f4e5940364cf309c8ea5fea60686f1
+README.zh.md: 32c7af5bef050d6d46e91783468bdd0aa66e5ca0

package/README.md

@@ -0,0 +1,25 @@
+# `@deepseek-ai/dsh-loader-smoke`
+
+English | [中文](README.zh.md)
+
+Shared subprocess harness for tests that boot an app and `cordis.yml` through the Cordis Loader. `resolveExampleLaunch` selects local `src` mode (tsx and root tsconfig paths) or CI `lib` mode (plain Node and package exports) from an explicit mode or `DSH_EXAMPLE_MODE`.
+
+`runLoaderSmoke` accepts bin and config paths, optional complete bin arguments, environment overrides, stdin, pre-run setup, and pre-cleanup inspection. It owns the isolated cwd, DSH homes, diagnostics, deadline, termination, EOF, and cleanup; it returns both streams after a zero exit and rejects with both streams on failure.
+
+`runFixtureTurn` drives one task through exactly one configured root agent, forwards canonical events after that task reaches the durable inbox, flushes the session, and returns the final assistant text plus accumulated usage. Example-local drivers retain configuration, rendering, and assertion ownership.
+
+This is support-tier test infrastructure, not product API.
+
+## Model Experience
+
+None, as the test harness submits only the consuming test's ordinary user task and delegates prompt and tool composition to the loaded tree.
+
+#### KV Cache effect
+
+None beyond the loaded tree; the helper neither changes the request prefix nor retains state across runs.
+
+## Known Limitations and Deferred Work
+
+- **Built mode requires a prior build** — the config must also resolve every named package upward through `examples/node_modules`.
+- **Captured stdout and stderr are bounded only by execa's default 100 MB `maxBuffer`** — a runaway child is terminated at that ceiling rather than at a smoke-chosen budget.
+- **Timeout kills only the direct child** — a process tree spawned by a faulty fixture can outlive the smoke and needs external cleanup.

package/README.zh.md

@@ -0,0 +1,25 @@
+# `@deepseek-ai/dsh-loader-smoke`
+
+[English](README.md) | 中文
+
+用于测试通过 Cordis Loader 启动应用和 `cordis.yml` 的共享子进程 harness。`resolveExampleLaunch` 选择本地 `src` mode（tsx 和根 tsconfig 路径）或 CI `lib` mode（普通 Node 和包导出）；选择依据为显式 mode 或 `DSH_EXAMPLE_MODE`。
+
+`runLoaderSmoke` 接受可执行文件路径和配置路径、可选的完整可执行文件参数、环境变量覆盖、标准输入、运行前准备和清理前检查。它负责隔离工作目录、DSH 主目录、诊断、截止时间、终止、EOF 和清理；进程以零状态退出后返回两个流，失败时则返回拒绝并附带两个流。
+
+`runFixtureTurn` 通过恰好一个已配置的根 agent（智能体）驱动一项任务，在该任务进入持久收件箱后转发规范事件，刷写会话，并返回最终 assistant 文本和累计用量。示例本地 driver 继续负责配置、渲染和断言。
+
+这是支持层测试基础设施，而非产品 API。
+
+## 模型体验
+
+无，因为测试 harness 仅提交调用方测试的普通用户任务，并将提示词和工具组装交由已加载的树负责。
+
+#### KV Cache 影响
+
+除已加载树本身的影响外，无其他影响；该 helper 既不更改请求前缀，也不跨运行保留状态。
+
+## 已知限制与暂缓事项
+
+- **构建模式需要事先构建**：配置还必须能够通过 `examples/node_modules` 向上解析每个命名包。
+- **捕获的 stdout 和 stderr 仅受 execa 默认 100 MB `maxBuffer` 约束**：失控子进程会在该上限处被终止，而不是在冒烟测试自选的预算处。
+- **超时只终止直接子进程**：有故障的 fixture（测试前置数据）spawn 的进程树可能比冒烟测试存活更久，需要外部清理。

package/lib/index.js

@@ -0,0 +1,211 @@
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { execa } from "execa";
+import { createUserMessage } from "@deepseek-ai/dsh-llm";
+//#region lib/types/agent-turn.js
+/**
+* Test-only direct-agent turn driver shared by assembled Loader fixtures.
+* @module @deepseek-ai/dsh-loader-smoke/agent-turn
+*/
+function addUsage(total, step) {
+	const next = {
+		inputTokens: (total?.inputTokens ?? 0) + step.inputTokens,
+		outputTokens: (total?.outputTokens ?? 0) + step.outputTokens
+	};
+	for (const key of [
+		"cacheReadTokens",
+		"cacheWriteTokens",
+		"reasoningTokens"
+	]) if (total?.[key] !== void 0 || step[key] !== void 0) next[key] = (total?.[key] ?? 0) + (step[key] ?? 0);
+	return next;
+}
+function assistantText(event) {
+	const blocks = event.data.message.content.filter((block) => block.type === "text");
+	return blocks.length === 0 ? void 0 : blocks.map((block) => block.text).join("");
+}
+function onlyRootAgent(ctx) {
+	const agents = ctx.get("agents")?.roots() ?? [];
+	const [agent] = agents;
+	if (agent === void 0 || agents.length !== 1) throw new Error(`fixture turn requires exactly one top-level agent, found ${agents.length}`);
+	return agent;
+}
+/**
+* Drive one task from its durable inbox receipt through whole-agent idle.
+* @param ctx - settled Loader context with exactly one configured root agent.
+* @param options - task and optional canonical-event observer.
+* @returns the final assistant text and accumulated model usage.
+*/
+async function runFixtureTurn(ctx, options) {
+	const agent = onlyRootAgent(ctx);
+	await agent.whenIdle();
+	const message = createUserMessage({
+		content: [{
+			type: "text",
+			text: options.task
+		}],
+		source: { kind: "user" }
+	});
+	let received = false;
+	let output = "";
+	const usageByStep = /* @__PURE__ */ new Map();
+	const disposeListener = ctx.on("session/event", (session, event) => {
+		if (session !== agent.session) return;
+		if (!received) {
+			if (event.type !== "agent/inbox/spliced" || !event.data.inserted.some((inserted) => inserted.id === message.id)) return;
+			received = true;
+		}
+		options.onEvent?.(session.id, event);
+		if (event.type === "assistant/chunk" && event.data.chunk.type === "usage") usageByStep.set(`${event.data.turn}/${event.data.step}`, event.data.chunk.usage);
+		if (event.type === "assistant/message") {
+			output = assistantText(event) ?? output;
+			if (event.data.usage !== void 0) usageByStep.set(`${event.data.turn}/${event.data.step}`, event.data.usage);
+		}
+	});
+	try {
+		agent.followup(message);
+		await agent.whenIdle();
+	} finally {
+		disposeListener();
+	}
+	await ctx.sessions.flush(agent.session);
+	const usage = [...usageByStep.values()].reduce(addUsage, void 0);
+	return {
+		type: "result",
+		sessionId: agent.session.id,
+		output,
+		...usage === void 0 ? {} : { usage }
+	};
+}
+//#endregion
+//#region lib/types/index.js
+/**
+* Shared subprocess harness for keyless example smokes that boot a real
+* `cordis.yml` through an app bin and Cordis Loader.
+*
+* It also owns the mode-aware launch resolver every example subprocess harness shares
+* ({@link resolveExampleLaunch}): booting an example bin from TypeScript source under `tsx` (the
+* zero-build dev path, resolving `@deepseek-ai/dsh-*` / `@cordisjs/*` through the tsconfig `paths`
+* map) or from built `lib/` under plain Node (resolving bare packages through real `exports`, as an
+* installed consumer does, while Node type-strips relative example-local TypeScript plugins).
+*
+* @module @deepseek-ai/dsh-loader-smoke
+*/
+const DEFAULT_PROCESS_TIMEOUT_MS = 3e4;
+/** Vitest deadline that leaves room for the subprocess-owned 30-second diagnostic timeout. */
+const LOADER_SMOKE_TEST_TIMEOUT_MS = 45e3;
+/** Environment variable selecting the mode; CI sets it to `lib`, dev leaves it unset (`src`). */
+const EXAMPLE_MODE_ENV = "DSH_EXAMPLE_MODE";
+/**
+* Parse an {@link ExampleMode} from a raw string, defaulting to `src` when absent so an unset
+* environment reproduces the dev/tsx behavior. Throws on any other value rather than silently
+* falling back, so a typo in a gate's env fails loud.
+* @param raw - the raw value; defaults to `process.env.DSH_EXAMPLE_MODE`.
+* @returns the validated mode.
+*/
+function resolveExampleMode(raw = process.env[EXAMPLE_MODE_ENV]) {
+	switch (raw) {
+		case void 0:
+		case "":
+		case "src": return "src";
+		case "lib": return "lib";
+		default: throw new Error(`${EXAMPLE_MODE_ENV} must be 'src' or 'lib', got ${JSON.stringify(raw)}.`);
+	}
+}
+/** Derive the built-lib bin (`<pkg>/lib/<name>.js`) from a source bin (`<pkg>/src/<name>.ts`). */
+function toLibBin(srcBin) {
+	const markerLength = 5;
+	const cut = Math.max(srcBin.lastIndexOf("/src/"), srcBin.lastIndexOf("\\src\\"));
+	if (cut === -1) throw new Error(`resolveExampleLaunch: expected a "/src/" segment or Windows equivalent in bin path ${JSON.stringify(srcBin)}.`);
+	const separator = srcBin.slice(cut, cut + 1);
+	const tail = srcBin.slice(cut + markerLength).replace(/\.ts$/, ".js");
+	return `${srcBin.slice(0, cut)}${separator}lib${separator}${tail}`;
+}
+/**
+* Resolve how to spawn an example bin in the selected mode.
+*
+* `src` yields `node --import <tsx> <srcBin> <configArgs>` with `TSX_TSCONFIG_PATH` set so the
+* tsconfig `paths` map resolves workspace imports to source. `lib` yields
+* `node <libBin> <configArgs>` under plain Node with no tsx and no paths map, so
+* bare package plugins resolve through real package `exports` into built `lib/`; relative example-local
+* TypeScript plugins remain source files loaded through Node's built-in type stripping. Bare resolution
+* requires the config to live below a workspace that declares its `cordis.yml` package dependencies.
+*
+* @param options - the source bin, config arguments, mode, and environment.
+* @returns the command, argument vector, and mode-specific environment to spawn with.
+*/
+function resolveExampleLaunch(options) {
+	const mode = options.mode ?? resolveExampleMode();
+	const configArgs = options.configArgs ?? [];
+	const env = { ...options.env };
+	if (mode === "src") {
+		if (options.tsconfigPath === void 0) throw new Error("resolveExampleLaunch: 'src' mode needs tsconfigPath for the workspace paths map.");
+		const tsxLoader = import.meta.resolve("tsx");
+		env.TSX_TSCONFIG_PATH = options.tsconfigPath;
+		return {
+			command: process.execPath,
+			args: [
+				"--import",
+				tsxLoader,
+				options.srcBin,
+				...configArgs
+			],
+			env
+		};
+	}
+	return {
+		command: process.execPath,
+		args: [options.libBin ?? toLibBin(options.srcBin), ...configArgs],
+		env
+	};
+}
+/**
+* Boot one real Loader tree from an isolated cwd, close stdin immediately, and
+* await a clean exit. The helper owns process kill and temp-directory cleanup on
+* every outcome, and picks src/lib via {@link resolveExampleLaunch}.
+* @param options - example paths, mode, environment, and diagnostic identity.
+* @returns captured stdout and stderr after a zero exit.
+*/
+async function runLoaderSmoke(options) {
+	const cwd = await mkdtemp(join(tmpdir(), options.tempDirPrefix));
+	const processTimeoutMs = options.processTimeoutMs ?? DEFAULT_PROCESS_TIMEOUT_MS;
+	try {
+		await options.prepare?.(cwd);
+		const launch = resolveExampleLaunch({
+			srcBin: options.binScript,
+			libBin: options.libBinScript,
+			configArgs: options.binArgs ?? [options.configPath],
+			...options.mode !== void 0 ? { mode: options.mode } : {},
+			tsconfigPath: options.tsconfigPath,
+			env: {
+				DSH_HOME: join(cwd, ".dsh"),
+				DSH_AGENTS_HOME: join(cwd, ".agents"),
+				...options.env
+			}
+		});
+		const result = await execa(launch.command, launch.args, {
+			cwd,
+			env: launch.env,
+			input: "",
+			timeout: processTimeoutMs,
+			killSignal: "SIGKILL",
+			reject: false,
+			stripFinalNewline: false
+		});
+		if (result.timedOut) throw new Error(`${options.label} did not exit within ${processTimeoutMs / 1e3}s. stdout:\n${result.stdout}\nstderr:\n${result.stderr}`);
+		const expectedExitCode = options.expectedExitCode ?? 0;
+		if (result.exitCode !== expectedExitCode) throw new Error(`${options.label} exited ${String(result.exitCode)} (expected ${expectedExitCode}). stdout:\n${result.stdout}\nstderr:\n${result.stderr}`);
+		await options.inspect?.(cwd);
+		return {
+			stdout: result.stdout,
+			stderr: result.stderr
+		};
+	} finally {
+		await rm(cwd, {
+			recursive: true,
+			force: true
+		});
+	}
+}
+//#endregion
+export { EXAMPLE_MODE_ENV, LOADER_SMOKE_TEST_TIMEOUT_MS, resolveExampleLaunch, resolveExampleMode, runFixtureTurn, runLoaderSmoke };

package/lib/invariant.js

@@ -0,0 +1,23 @@
+//#region lib/types/invariant.js
+/**
+* Package-owned invariant companion for `@deepseek-ai/dsh-loader-smoke`.
+* @module @deepseek-ai/dsh-loader-smoke/invariant
+*/
+const PACKAGE_NAME = "@deepseek-ai/dsh-loader-smoke";
+/** Cordis companion plugin name. */
+const name = "loader-smoke-invariant";
+/** Service required before the companion can reserve package ownership. */
+const inject = ["invariants"];
+/**
+* No runtime invariant: this test-support package owns no production event stream or mutable data;
+* consuming test suites exercise its behavior.
+*/
+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/agent-turn.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Test-only direct-agent turn driver shared by assembled Loader fixtures.
+ * @module @deepseek-ai/dsh-loader-smoke/agent-turn
+ */
+import type { Context } from '@deepseek-ai/cordis';
+import { type TokenUsage } from '@deepseek-ai/dsh-llm';
+import type { SessionEvent } from '@deepseek-ai/dsh-session';
+/** Result envelope consumed only by snapshot and composition tests. */
+export interface FixtureTurnResult {
+    readonly type: 'result';
+    readonly sessionId: string;
+    readonly output: string;
+    readonly usage?: TokenUsage;
+}
+/** Options for one fixture turn against exactly one configured root agent. */
+export interface FixtureTurnOptions {
+    readonly task: string;
+    readonly onEvent?: (sessionId: string, event: SessionEvent) => void;
+}
+/**
+ * Drive one task from its durable inbox receipt through whole-agent idle.
+ * @param ctx - settled Loader context with exactly one configured root agent.
+ * @param options - task and optional canonical-event observer.
+ * @returns the final assistant text and accumulated model usage.
+ */
+export declare function runFixtureTurn(ctx: Context, options: FixtureTurnOptions): Promise<FixtureTurnResult>;
+//# sourceMappingURL=agent-turn.d.ts.map

package/lib/types/index.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Shared subprocess harness for keyless example smokes that boot a real
+ * `cordis.yml` through an app bin and Cordis Loader.
+ *
+ * It also owns the mode-aware launch resolver every example subprocess harness shares
+ * ({@link resolveExampleLaunch}): booting an example bin from TypeScript source under `tsx` (the
+ * zero-build dev path, resolving `@deepseek-ai/dsh-*` / `@cordisjs/*` through the tsconfig `paths`
+ * map) or from built `lib/` under plain Node (resolving bare packages through real `exports`, as an
+ * installed consumer does, while Node type-strips relative example-local TypeScript plugins).
+ *
+ * @module @deepseek-ai/dsh-loader-smoke
+ */
+export { runFixtureTurn, type FixtureTurnOptions, type FixtureTurnResult, } from './agent-turn.ts';
+/** Vitest deadline that leaves room for the subprocess-owned 30-second diagnostic timeout. */
+export declare const LOADER_SMOKE_TEST_TIMEOUT_MS: number;
+/** Which artifact an example bin is booted from: unbuilt `src` via tsx, or built `lib` via plain Node. */
+export type ExampleMode = 'src' | 'lib';
+/** Environment variable selecting the mode; CI sets it to `lib`, dev leaves it unset (`src`). */
+export declare const EXAMPLE_MODE_ENV = "DSH_EXAMPLE_MODE";
+/**
+ * Parse an {@link ExampleMode} from a raw string, defaulting to `src` when absent so an unset
+ * environment reproduces the dev/tsx behavior. Throws on any other value rather than silently
+ * falling back, so a typo in a gate's env fails loud.
+ * @param raw - the raw value; defaults to `process.env.DSH_EXAMPLE_MODE`.
+ * @returns the validated mode.
+ */
+export declare function resolveExampleMode(raw?: string | undefined): ExampleMode;
+/** Inputs to {@link resolveExampleLaunch}. */
+export interface ExampleLaunchOptions {
+    /** Absolute path to the example bin's TypeScript source entry (`<pkg>/src/bin.ts`); the `lib` bin is derived from it. */
+    readonly srcBin: string;
+    /** Explicit plain-Node entry for `lib` mode; test fixtures may point this at Node-type-strippable TypeScript. */
+    readonly libBin?: string | undefined;
+    /** Arguments passed after the bin — the config, positional (`[configPath]`) or flagged (`['--config', configPath]`). */
+    readonly configArgs?: readonly string[];
+    /** The mode to launch in; defaults to {@link resolveExampleMode} of the environment. */
+    readonly mode?: ExampleMode;
+    /** Absolute repo tsconfig whose `paths` map resolves unbuilt workspace imports. Required in `src` mode, ignored in `lib`. */
+    readonly tsconfigPath?: string;
+    /** Extra environment entries the mode-specific ones layer over; the caller then merges the result over `process.env`. */
+    readonly env?: NodeJS.ProcessEnv;
+}
+/** The resolved spawn: `spawn(command, args, { env: { ...process.env, ...env } })`. */
+export interface ExampleLaunch {
+    /** The executable to spawn — always the current Node binary. */
+    readonly command: string;
+    /** Node flags, the resolved bin, then the caller's `configArgs`. */
+    readonly args: string[];
+    /** Mode-specific environment (`TSX_TSCONFIG_PATH` in `src`, nothing added in `lib`) layered over the caller's `env`. */
+    readonly env: NodeJS.ProcessEnv;
+}
+/**
+ * Resolve how to spawn an example bin in the selected mode.
+ *
+ * `src` yields `node --import <tsx> <srcBin> <configArgs>` with `TSX_TSCONFIG_PATH` set so the
+ * tsconfig `paths` map resolves workspace imports to source. `lib` yields
+ * `node <libBin> <configArgs>` under plain Node with no tsx and no paths map, so
+ * bare package plugins resolve through real package `exports` into built `lib/`; relative example-local
+ * TypeScript plugins remain source files loaded through Node's built-in type stripping. Bare resolution
+ * requires the config to live below a workspace that declares its `cordis.yml` package dependencies.
+ *
+ * @param options - the source bin, config arguments, mode, and environment.
+ * @returns the command, argument vector, and mode-specific environment to spawn with.
+ */
+export declare function resolveExampleLaunch(options: ExampleLaunchOptions): ExampleLaunch;
+/** Inputs that vary between real-Loader example smokes. */
+export interface LoaderSmokeOptions {
+    /** Human-readable example name used in failure diagnostics. */
+    readonly label: string;
+    /** Prefix for the isolated temporary process cwd. */
+    readonly tempDirPrefix: string;
+    /** Absolute app-bin source path (`<pkg>/src/bin.ts`); the `lib` bin is derived from it. */
+    readonly binScript: string;
+    /** Explicit plain-Node entry for `lib` mode; intended for test fixtures outside a package `src/` tree. */
+    readonly libBinScript?: string | undefined;
+    /** Absolute real Loader config path, passed as the sole bin argument by default. */
+    readonly configPath: string;
+    /** Complete argv after the bin path; overrides the default `[configPath]`. */
+    readonly binArgs?: readonly string[];
+    /** Absolute repo tsconfig path used for unbuilt workspace-package resolution (required in `src` mode). */
+    readonly tsconfigPath: string;
+    /** Boot from source via tsx (`src`) or built lib via plain Node (`lib`); defaults to the environment's mode. */
+    readonly mode?: ExampleMode;
+    /** Environment overrides layered over the parent and isolated DSH homes. */
+    readonly env?: Readonly<NodeJS.ProcessEnv>;
+    /** Process deadline override for harness tests. */
+    readonly processTimeoutMs?: number;
+    /** Optional world-state setup run in the isolated cwd before process start. */
+    readonly prepare?: (cwd: string) => Promise<void> | void;
+    /** Optional world-state assertion run in the isolated cwd before cleanup. */
+    readonly inspect?: (cwd: string) => Promise<void> | void;
+    /**
+     * Exact process exit code this smoke expects; defaults to `0`. Scenarios
+     * pinning a designed failure surface (a one-shot turn ending in an error
+     * result) declare its nonzero exit here, and a run that exits any other
+     * way — including succeeding — still fails the smoke.
+     */
+    readonly expectedExitCode?: number;
+}
+/** Captured output from a Loader smoke that exited successfully. */
+export interface LoaderSmokeResult {
+    /** Complete stdout after clean exit. */
+    readonly stdout: string;
+    /** Complete stderr after clean exit. */
+    readonly stderr: string;
+}
+/**
+ * Boot one real Loader tree from an isolated cwd, close stdin immediately, and
+ * await a clean exit. The helper owns process kill and temp-directory cleanup on
+ * every outcome, and picks src/lib via {@link resolveExampleLaunch}.
+ * @param options - example paths, mode, environment, and diagnostic identity.
+ * @returns captured stdout and stderr after a zero exit.
+ */
+export declare function runLoaderSmoke(options: LoaderSmokeOptions): Promise<LoaderSmokeResult>;
+//# sourceMappingURL=index.d.ts.map

package/lib/types/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@deepseek-ai/dsh-loader-smoke`.
+ * @module @deepseek-ai/dsh-loader-smoke/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "loader-smoke-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/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@deepseek-ai/dsh-loader-smoke",
+  "description": "Shared subprocess and direct-agent harness for keyless real-Loader example smoke tests",
+  "version": "0.0.1-rc.1",
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/deepseek-ai/deepseek-harness.git",
+    "directory": "packages/support/loader-smoke"
+  },
+  "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": {
+    "execa": "^10.0.0",
+    "tsx": "^4.22.4"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-agent": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-llm": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-session": "^0.0.1-rc.1",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-llm": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-invariants": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-agent": "^0.0.1-rc.1",
+    "@deepseek-ai/dsh-session": "^0.0.1-rc.1",
+    "@deepseek-ai/cordis": "^4.0.1-rc.1"
+  }
+}