dsh-pstack 0.2.0-beta.3 → 0.2.0

package/dist/subagent.d.mts

@@ -1,25 +1,10 @@
 import { _ as ToolsHost, g as ToolDefinition, h as SubagentsHost, m as SubagentCapabilities, n as AgentOptions, r as AgentsHost, s as LlmHost, t as Agent, v as WorkingDirectoryHost } from "./host-contract-CUPSpeNk.mjs";
-/**
- * The one pstack role manifest.
- *
- * Keys are matched exactly after normalization, and commas belong to some keys
- * (`feature, refactoring`, `reflect judgment, divergent, synthesizer`), so nothing here
- * may split a key on a comma. A second literal role list anywhere is a bug.
- *
- * This module has no Node imports: the bundle imports it directly.
- */
-/** Whether a role holds one route or a comma-separated list of routes. */
-type RoleValueShape = "single" | "list";
-interface RoleSpec {
-  /** Exact key as written in the role file. Commas belong to the key. */
-  readonly key: string;
-  readonly shape: RoleValueShape;
-  /** A list role that starts one child per entry automatically. */
-  readonly autoPanel: boolean;
-}
+import { t as RoleSpec } from "./role-manifest-C3fUzjLI.mjs";
 /** One resolved child route. */
 type Route = {
   readonly kind: "inherit";
+  /** The spelling the file used; `undefined` for an implicit fallback. */
+  readonly alias?: "inherit-parent" | "auto";
 } | {
   readonly kind: "route";
   readonly provider: string;

package/dist/subagent.mjs

@@ -1,7 +1,7 @@
 import { a as POTETO_MODE_SKILL_PATH } from "./paths-BT77khwm.mjs";
+import { a as resolveDshHome, i as requireRole, o as selectRoleRoutes, r as readRoleConfiguration, t as modelsFilePath } from "./role-config-NNn5r1JX.mjs";
 import { isAbsolute, join, relative, resolve } from "node:path";
-import { existsSync, readFileSync, statSync } from "node:fs";
-import { homedir } from "node:os";
+import { existsSync, statSync } from "node:fs";
 // src/internal/effort.ts
 /** Model-facing name of the child's own control. */
 const SET_EFFORT_TOOL = "set_reasoning_effort";
@@ -30,7 +30,7 @@ async function validateEffortFor(llm, route, effort, parent, signal) {
 	try {
 		efforts = await advertisedEfforts(llm, target, signal);
 	} catch (error) {
-		throw new Error(`route ${target.provider}/${target.model} could not be resolved for reasoningEffort: ${describeError$2(error)}`, { cause: error });
+		throw new Error(`route ${target.provider}/${target.model} could not be resolved for reasoningEffort: ${describeError$1(error)}`, { cause: error });
 	}
 	if (efforts.length === 0) throw new Error(`${target.provider}/${target.model} advertises no reasoning efforts, so it cannot take reasoningEffort "${effort}". Omit the argument and let the adapter use its own default.`);
 	if (!efforts.includes(effort)) throw new Error(`${target.provider}/${target.model} does not support reasoning effort "${effort}". It supports: ${efforts.join(", ")}.`);
@@ -83,7 +83,7 @@ function defineSetEffortTool(child, llm) {
 			try {
 				efforts = await advertisedEfforts(llm, target, exec.signal);
 			} catch (error) {
-				throw new Error(`${target.provider}/${target.model} could not be resolved for reasoning effort: ${describeError$2(error)}`, { cause: error });
+				throw new Error(`${target.provider}/${target.model} could not be resolved for reasoning effort: ${describeError$1(error)}`, { cause: error });
 			}
 			if (efforts.length === 0) throw new Error(`${target.provider}/${target.model} advertises no reasoning efforts, so this child has none to change. Your current effort stays as it is.`);
 			if (!efforts.includes(value)) throw new Error(`${target.provider}/${target.model} does not support reasoning effort "${value}", so nothing changed. It supports: ${efforts.join(", ")}.`);
@@ -110,417 +110,10 @@ function agentOptionsFor(route, effortOverride) {
 function effectiveEffort(route, effortOverride) {
 	return effortOverride ?? (route.kind === "route" ? route.effort : void 0);
 }
-function describeError$2(error) {
-	if (error instanceof Error) {
-		const code = error.code;
-		return typeof code === "string" ? `${error.message} (${code})` : error.message;
-	}
-	return String(error);
-}
-// src/internal/role-manifest.ts
-/**
-* File name the role configuration lives under inside `$DSH_HOME`.
-*
-* It keeps the upstream name `pstack-models.mdc`, so a reader moving from the Cursor docs
-* recognizes it, but stores it directly under `$DSH_HOME`; DSH does not load `.mdc` files
-* on its own, and `pstack_subagent` is the only reader.
-*/
-const PSTACK_MODELS_FILENAME = "pstack-models.mdc";
-/** Values that resolve to "send no `agentOptions` and inherit the parent route". */
-const INHERIT_PARENT_ALIASES = ["inherit-parent", "auto"];
-/** The 17 roles, in manifest order. */
-const ROLE_MANIFEST = [
-	{
-		key: "feature, refactoring",
-		shape: "single",
-		autoPanel: false
-	},
-	{
-		key: "bug-fix",
-		shape: "single",
-		autoPanel: false
-	},
-	{
-		key: "perf-issue",
-		shape: "single",
-		autoPanel: false
-	},
-	{
-		key: "hillclimb",
-		shape: "single",
-		autoPanel: false
-	},
-	{
-		key: "judgment and prose",
-		shape: "single",
-		autoPanel: false
-	},
-	{
-		key: "hardest tasks",
-		shape: "single",
-		autoPanel: false
-	},
-	{
-		key: "how explorer",
-		shape: "single",
-		autoPanel: false
-	},
-	{
-		key: "how explainer",
-		shape: "single",
-		autoPanel: false
-	},
-	{
-		key: "why investigators",
-		shape: "single",
-		autoPanel: false
-	},
-	{
-		key: "why synthesizer",
-		shape: "single",
-		autoPanel: false
-	},
-	{
-		key: "reflect tooling",
-		shape: "single",
-		autoPanel: false
-	},
-	{
-		key: "reflect judgment, divergent, synthesizer",
-		shape: "single",
-		autoPanel: false
-	},
-	{
-		key: "arena runners",
-		shape: "list",
-		autoPanel: true
-	},
-	{
-		key: "arena cross-judge pool",
-		shape: "list",
-		autoPanel: false
-	},
-	{
-		key: "swarm workers",
-		shape: "list",
-		autoPanel: false
-	},
-	{
-		key: "architect runners",
-		shape: "list",
-		autoPanel: true
-	},
-	{
-		key: "interrogate reviewers",
-		shape: "list",
-		autoPanel: true
-	}
-];
-/** Exact manifest lookup. Callers normalize the key first. */
-function findRoleSpec(key) {
-	return ROLE_MANIFEST.find((role) => role.key === key);
-}
-// src/internal/role-config.ts
-/**
-* The pstack role configuration: `$DSH_HOME/pstack-models.mdc`.
-*
-* `pstack_subagent` reads this file again on every delegation, so a change reaches the
-* next child and never a child that already started.
-*
-* Three states stay apart because each needs a different fix: the file is missing (no
-* policy, so every role inherits the parent route), unreadable (a broken install, never
-* treated as "no configuration"), or loaded with per-line issues reported by line.
-*/
-/** Absolute path of the role file for one DSH home. */
-function modelsFilePath(dshHome) {
-	return join(dshHome, PSTACK_MODELS_FILENAME);
-}
-/** Resolve `$DSH_HOME` the way the Host does: the environment when set, else `~/.dsh`. */
-function resolveDshHome(env = process.env, home = homedir()) {
-	const configured = env["DSH_HOME"];
-	const path = configured !== void 0 && configured.trim() !== "" ? configured : join(home, ".dsh");
-	const expanded = path === "~" ? home : path.startsWith("~/") || path.startsWith("~\\") ? join(home, path.slice(2)) : path;
-	return resolve(expanded);
-}
-/** Read the role file. Never throws for a missing or unreadable file. */
-function readRoleConfiguration(path) {
-	let text;
-	try {
-		text = readFileSync(path, "utf8");
-	} catch (error) {
-		if (isMissingFile(error)) return {
-			status: "missing",
-			path
-		};
-		return {
-			status: "unreadable",
-			path,
-			reason: describeError$1(error)
-		};
-	}
-	return parseRoleConfiguration(text, path);
-}
-/** Parse role-file text. Pure: no file system access. */
-function parseRoleConfiguration(text, path) {
-	const issues = [];
-	const roles = /* @__PURE__ */ new Map();
-	let budget;
-	stripFrontmatter(text).split("\n").forEach((rawLine, index) => {
-		const line = index + 1;
-		const trimmed = rawLine.trim();
-		if (trimmed === "") return;
-		if (trimmed.startsWith("#")) {
-			const match = /^#\s*budget:\s*(.+)$/i.exec(trimmed);
-			if (match !== null) budget = match[1].trim();
-			return;
-		}
-		const separator = trimmed.indexOf(":");
-		if (separator === -1) {
-			issues.push({
-				line,
-				message: `expected \`<role>: <value>\`, found ${JSON.stringify(trimmed)}`
-			});
-			return;
-		}
-		const rawKey = trimmed.slice(0, separator).trim();
-		const rawValue = trimmed.slice(separator + 1).trim();
-		const key = normalizeRoleName(rawKey);
-		if (key === "") {
-			issues.push({
-				line,
-				message: "the role key is empty"
-			});
-			return;
-		}
-		const spec = findRoleSpec(key);
-		if (spec === void 0) {
-			issues.push({
-				line,
-				message: unknownRoleMessage(rawKey, key)
-			});
-			return;
-		}
-		const parsed = parseRouteValue(rawValue);
-		const entryIssues = [...parsed.issues];
-		if (spec.shape === "single" && parsed.routes.length > 1) entryIssues.push("a single-route role cannot hold a comma-separated list");
-		for (const issue of entryIssues) issues.push({
-			line,
-			message: `${rawKey}: ${issue}`
-		});
-		if (parsed.routes.length === 0) return;
-		const previous = roles.get(spec.key);
-		if (previous !== void 0) issues.push({
-			line,
-			message: `role "${spec.key}" is already configured on line ${previous.line}; line ${line} wins`
-		});
-		roles.set(spec.key, {
-			line,
-			rawKey,
-			key: spec.key,
-			spec,
-			routes: parsed.routes,
-			issues: entryIssues
-		});
-	});
-	return budget === void 0 ? {
-		status: "loaded",
-		path,
-		roles,
-		issues
-	} : {
-		status: "loaded",
-		path,
-		budget,
-		roles,
-		issues
-	};
-}
-/** Parse a role value: one route, or a comma-separated list of routes. */
-function parseRouteValue(raw) {
-	const routes = [];
-	const issues = [];
-	const segments = raw.split(",");
-	segments.forEach((segment, index) => {
-		const trimmed = segment.trim();
-		if (trimmed === "") {
-			if (index !== segments.length - 1) issues.push(`entry ${index + 1} of the list is empty`);
-			return;
-		}
-		const parsed = parseRoute(trimmed);
-		if (parsed.route === void 0) {
-			issues.push(parsed.issue);
-			return;
-		}
-		routes.push(parsed.route);
-	});
-	if (routes.length === 0 && issues.length === 0) issues.push("the value is empty; use `inherit-parent`, `auto`, or `<provider>/<model> [effort]`");
-	return {
-		routes,
-		issues
-	};
-}
-/** Parse one entry of a role value. */
-function parseRoute(raw) {
-	const value = raw.trim();
-	if (value === "") return { issue: "the value is empty" };
-	if (INHERIT_PARENT_ALIASES.includes(value.toLowerCase())) return { route: { kind: "inherit" } };
-	const match = /^([^\s/,[]+)\/([^\s/,[\]]+(?:\/[^\s/,[\]]+)*)(?:\s+\[([^[\]]*)\])?$/.exec(value);
-	if (match === null) return { issue: `${JSON.stringify(value)} is not a route; use \`inherit-parent\`, \`auto\`, or \`<provider>/<model> [effort]\`` };
-	const provider = match[1];
-	const model = match[2];
-	const effort = match[3];
-	if (effort === void 0) return { route: {
-		kind: "route",
-		provider,
-		model
-	} };
-	const trimmedEffort = effort.trim();
-	if (trimmedEffort === "") return { issue: `${JSON.stringify(value)} has empty brackets; write \`<provider>/<model> [effort]\` or drop the brackets` };
-	if (/\s/.test(trimmedEffort)) return { issue: `${JSON.stringify(value)} has a multi-word effort; an effort is one adapter-owned token` };
-	return { route: {
-		kind: "route",
-		provider,
-		model,
-		effort: trimmedEffort
-	} };
-}
-/** Raised when a role's configured list cannot be selected from. */
-var RouteSelectionError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "RouteSelectionError";
-	}
-};
-/**
-* Expand one role into the routes this call starts.
-*
-* Automatic panels start one child per entry. Another list role selects one entry, the
-* first by default; `roleIndex` chooses which. A single role holds exactly one route and
-* rejects `roleIndex`.
-*/
-function selectRoleRoutes(spec, entry, roleIndex) {
-	if (spec.shape === "single" && roleIndex !== void 0) throw new RouteSelectionError(`role "${spec.key}" holds a single route, so \`roleIndex\` does not apply; drop \`roleIndex\` or use a list-valued role (${listRoleKeys().join(", ")})`);
-	if (spec.autoPanel && roleIndex !== void 0) throw new RouteSelectionError(`role "${spec.key}" is an automatic panel: it starts one child per entry, so \`roleIndex\` does not apply`);
-	if (entry === void 0) return {
-		role: spec,
-		mode: spec.autoPanel ? "panel" : "single",
-		configured: false,
-		routes: [{ kind: "inherit" }],
-		total: 1
-	};
-	if (entry.issues.length > 0) throw new RouteSelectionError(`role "${spec.key}" has invalid configuration on line ${entry.line}: ${entry.issues.join("; ")}. Fix the role file before delegating.`);
-	if (spec.autoPanel) return {
-		role: spec,
-		mode: "panel",
-		configured: true,
-		routes: entry.routes,
-		total: entry.routes.length
-	};
-	if (spec.shape === "list") {
-		const index = roleIndex ?? 0;
-		if (index >= entry.routes.length) throw new RouteSelectionError(`role "${spec.key}" has ${entry.routes.length} entr${entry.routes.length === 1 ? "y" : "ies"}, so \`roleIndex\` ${index} is out of range; valid indexes are ${entry.routes.map((_route, position) => position).join(", ")}`);
-		return {
-			role: spec,
-			mode: "selected",
-			configured: true,
-			routes: [entry.routes[index]],
-			total: entry.routes.length,
-			roleIndex: index
-		};
-	}
-	return {
-		role: spec,
-		mode: "single",
-		configured: true,
-		routes: [entry.routes[0]],
-		total: entry.routes.length
-	};
-}
-/** Keys of the list-valued roles, including the automatic panels. */
-function listRoleKeys() {
-	return ROLE_MANIFEST.filter((role) => role.shape === "list").map((role) => role.key);
-}
-/** Raised when a role name does not match the manifest. */
-var RoleNameError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "RoleNameError";
-	}
-};
-/** Normalize a role name for lookup. Case, spacing, spacing around a comma, and a trailing colon are formatting. */
-function normalizeRoleName(raw) {
-	return raw.normalize("NFC").trim().toLowerCase().replace(/\s+/g, " ").replace(/\s*,\s*/g, ", ").replace(/:+$/, "").trim();
-}
-/** Resolve a role name, or throw a diagnostic that names the near misses. */
-function requireRole(raw) {
-	const spec = findRoleSpec(normalizeRoleName(raw));
-	if (spec !== void 0) return spec;
-	const suggestions = suggestRoles(raw);
-	const hint = suggestions.length === 0 ? "No role key is close to it." : `Closest role keys: ${suggestions.map((key) => `"${key}"`).join(", ")}.`;
-	throw new RoleNameError(`unknown pstack role ${JSON.stringify(raw)}. ${hint} Role names come from the role manifest, not from free text: pass the exact key, or omit \`role\` to inherit the parent route.`);
-}
-function suggestRoles(raw, limit = 3) {
-	const target = normalizeRoleName(raw);
-	if (target === "") return [];
-	return ROLE_MANIFEST.map((role) => {
-		const shared = sharedTokenCount(target, role.key);
-		const distance = editDistance(target, role.key);
-		const contains = role.key.includes(target) || target.includes(role.key);
-		const score = (contains ? 1e3 : 0) + shared * 100 - distance + Math.min(role.key.length, target.length);
-		return {
-			key: role.key,
-			score,
-			distance,
-			shared,
-			contains
-		};
-	}).filter((candidate) => candidate.contains || candidate.shared > 0 || candidate.distance <= 4).sort((left, right) => right.score - left.score).slice(0, limit).map((candidate) => candidate.key);
-}
-function unknownRoleMessage(rawKey, key) {
-	const suggestions = suggestRoles(key);
-	const hint = suggestions.length === 0 ? "no role key is close to it" : `closest role keys: ${suggestions.map((candidate) => `"${candidate}"`).join(", ")}`;
-	return `unknown role ${JSON.stringify(rawKey)} (${hint}). A line for a retired or misspelled role is reported rather than ignored.`;
-}
-function sharedTokenCount(left, right) {
-	const rightTokens = new Set(tokenize(right));
-	return [...new Set(tokenize(left))].filter((token) => rightTokens.has(token)).length;
-}
-function tokenize(value) {
-	return value.split(/[^a-z0-9]+/).filter((token) => token !== "");
-}
-/** Levenshtein distance, iterative with one row of state. */
-function editDistance(left, right) {
-	if (left === right) return 0;
-	if (left === "") return right.length;
-	if (right === "") return left.length;
-	let previous = Array.from({ length: right.length + 1 }, (_, index) => index);
-	for (let row = 1; row <= left.length; row += 1) {
-		const current = [row];
-		for (let column = 1; column <= right.length; column += 1) {
-			const substitution = previous[column - 1] + (left[row - 1] === right[column - 1] ? 0 : 1);
-			const deletion = previous[column] + 1;
-			const insertion = current[column - 1] + 1;
-			current.push(Math.min(substitution, deletion, insertion));
-		}
-		previous = current;
-	}
-	return previous[right.length];
-}
-function stripFrontmatter(text) {
-	const normalized = text.replaceAll("\r\n", "\n");
-	if (!normalized.startsWith("---\n")) return normalized;
-	const end = normalized.indexOf("\n---", 3);
-	if (end === -1) return normalized;
-	const after = normalized.indexOf("\n", end + 1);
-	return after === -1 ? "" : normalized.slice(after + 1);
-}
-function isMissingFile(error) {
-	return typeof error === "object" && error !== null && error.code === "ENOENT";
-}
 function describeError$1(error) {
 	if (error instanceof Error) {
 		const code = error.code;
-		return typeof code === "string" ? `${code}: ${error.message}` : error.message;
+		return typeof code === "string" ? `${error.message} (${code})` : error.message;
 	}
 	return String(error);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-pstack",
-  "version": "0.2.0-beta.3",
+  "version": "0.2.0",
   "description": "pstack for DeepSeek Harness: rigorous agent workflows ported from cursor/plugins.",
   "keywords": [
     "agent-skills",
@@ -37,10 +37,13 @@
   "exports": {
     ".": "./dist/index.mjs",
     "./models": "./dist/models.mjs",
+    "./remote": "./dist/remote.mjs",
+    "./roles": "./dist/roles.mjs",
     "./script": "./dist/script.mjs",
     "./skill": "./dist/skill.mjs",
     "./subagent": "./dist/subagent.mjs",
     "./package.json": "./package.json",
+    "./client": "./dist/client.mjs",
     "./locale/*.json": "./locale/*.json"
   },
   "dependencies": {
@@ -52,13 +55,25 @@
     "@deepseek-ai/dsh-subagent": "0.2.2-alpha.2",
     "@deepseek-ai/dsh-system-prompt": "0.2.2-alpha.2",
     "@deepseek-ai/dsh-tools": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-typert-protocol": "0.2.2-alpha.2",
     "@deepseek-ai/dsh-working-directory": "0.2.2-alpha.2",
     "commander": "14.0.0"
   },
   "devDependencies": {
+    "@deepseek-ai/dsh-api-gateway": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-client-locale": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-plugin-manager": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.2-alpha.2",
+    "@deepseek-ai/dsh-typert-registry": "0.2.2-alpha.2",
     "@types/node": "^24.1.0",
+    "@types/react": "~18.3.1",
+    "@types/react-dom": "~18.3.0",
+    "agent-browser": "0.41.0",
     "bumpp": "^12.3.0",
     "js-yaml": "^5.5.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
     "skills": "^1.7.4",
     "typescript": "^7.0.2",
     "vite-plus": "1.4.0"
@@ -80,13 +95,22 @@
     }
   },
   "engines": {
-    "dsh": ">=0.2.2-alpha.2",
+    "dsh": ">=0.2.1-rc.5",
     "node": ">=24.21.1"
   },
   "dsh": {
     "manifestVersion": 1,
     "bundle": {
       "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-api-gateway",
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-plugin-manager"
+      ]
     }
   },
   "skills": [
@@ -97,6 +121,12 @@
         "retro"
       ],
       "ref": "59db609eb1e18aaf59b63284d0e52255aff0c63c"
+    },
+    {
+      "source": "npm:agent-browser",
+      "skills": [
+        "agent-browser"
+      ]
     }
   ],
   "scripts": {