dsh-pstack 0.3.0-beta.1 → 0.3.1

package/dist/role-catalog.d.mts

@@ -1,35 +1,22 @@
-import { _ as ToolsHost, g as ToolDefinition } from "./host-contract-CUPSpeNk.mjs";
-import { n as RoleSpec, r as RoleValueShape } from "./role-manifest-8OERX9-s.mjs";
-/** Cordis row name, used by Loader diagnostics. */
+import { c as RoleSpec } from "./role-manifest-D1npMjqZ.mjs";
+import { Context } from "@deepseek-ai/cordis";
+import { ToolDefinition } from "@deepseek-ai/dsh-tools";
 export declare const name = "pstack-role-catalog";
-/** The row only needs the tool registry. */
 export declare const inject: string[];
-/** Model-facing tool name. */
 export declare const TOOL_NAME = "pstack_roles";
-/** Whether `roleIndex` may be passed for a role. */
-export type RoleIndexApplicability = "not-applicable" | "optional";
 export interface RoleCapability {
-  /** The exact key to pass as `role`. */
   readonly role: string;
-  /** One route, or a comma-separated list of routes. */
-  readonly shape: RoleValueShape;
-  /** A list role that starts one child per entry automatically. */
+  readonly shape: "single" | "list";
   readonly autoPanel: boolean;
-  /** `optional` only for a list role that is not an automatic panel. */
-  readonly roleIndex: RoleIndexApplicability;
-  /** How this role expands into children. */
+  readonly roleIndex: "not-applicable" | "optional";
   readonly usage: string;
 }
-/** Derive one role's capability from its manifest entry. */
+/** Derive one role's capability record. */
 export declare function roleCapability(spec: RoleSpec): RoleCapability;
-/** Every role's capability, in manifest order. */
+/** Every role's capability record in manifest order. */
 export declare function roleCapabilities(): readonly RoleCapability[];
-/** Render the capability list for the model. */
+/** Render the capabilities for the model. */
 export declare function renderRoleCapabilities(roles: readonly RoleCapability[]): string;
-export declare function createPstackRoleCatalogTool(): ToolDefinition;
-/** The slice of the Cordis context this row uses. */
-export interface PstackRoleCatalogHost {
-  readonly tools: ToolsHost;
-}
-/** Register `pstack_roles`. */
-export declare function apply(ctx: PstackRoleCatalogHost): void;
+/** Build the tool definition. */
+export declare function createPstackRolesTool(): ToolDefinition;
+export declare function apply(ctx: Context): void;

package/dist/role-catalog.mjs

@@ -1,40 +1,37 @@
-import { r as ROLE_MANIFEST } from "./role-manifest-79cnFfDM.mjs";
+import { ROLE_MANIFEST } from "./role-manifest.mjs";
 // src/role-catalog.ts
-/** Cordis row name, used by Loader diagnostics. */
 const name = "pstack-role-catalog";
-/** The row only needs the tool registry. */
 const inject = ["tools"];
-/** Model-facing tool name. */
 const TOOL_NAME = "pstack_roles";
-/** Derive one role's capability from its manifest entry. */
+/** Derive one role's capability record. */
 function roleCapability(spec) {
 	if (spec.autoPanel) return {
 		role: spec.key,
 		shape: spec.shape,
 		autoPanel: true,
 		roleIndex: "not-applicable",
-		usage: "one child per configured entry"
+		usage: "starts one child per configured entry"
 	};
 	if (spec.shape === "list") return {
 		role: spec.key,
 		shape: spec.shape,
 		autoPanel: false,
 		roleIndex: "optional",
-		usage: "one child, choosing one configured entry"
+		usage: "starts one child on the selected entry"
 	};
 	return {
 		role: spec.key,
 		shape: spec.shape,
 		autoPanel: false,
 		roleIndex: "not-applicable",
-		usage: "one child on the role's single route"
+		usage: "starts one child on the role's single route"
 	};
 }
-/** Every role's capability, in manifest order. */
+/** Every role's capability record in manifest order. */
 function roleCapabilities() {
 	return ROLE_MANIFEST.map(roleCapability);
 }
-/** Render the capability list for the model. */
+/** Render the capabilities for the model. */
 function renderRoleCapabilities(roles) {
 	return [
 		"pstack roles. Pass the exact `role` key. `roleIndex` is null unless the role is a list that is not an automatic panel.",
@@ -47,33 +44,21 @@ const OUTPUT_SCHEMA = {
 	additionalProperties: false,
 	properties: { roles: {
 		type: "array",
-		description: "One capability record per role, in manifest order.",
 		items: {
 			type: "object",
 			additionalProperties: false,
 			properties: {
-				role: {
-					type: "string",
-					description: "The exact key to pass as `role`."
-				},
+				role: { type: "string" },
 				shape: {
 					type: "string",
-					enum: ["single", "list"],
-					description: "One route, or a comma-separated list of routes."
-				},
-				autoPanel: {
-					type: "boolean",
-					description: "A list role that starts one child per configured entry."
+					enum: ["single", "list"]
 				},
+				autoPanel: { type: "boolean" },
 				roleIndex: {
 					type: "string",
-					enum: ["not-applicable", "optional"],
-					description: "`optional` only for a list role that is not an automatic panel; otherwise pass null."
+					enum: ["not-applicable", "optional"]
 				},
-				usage: {
-					type: "string",
-					description: "How this role expands into children."
-				}
+				usage: { type: "string" }
 			},
 			required: [
 				"role",
@@ -91,9 +76,10 @@ const TOOL_DESCRIPTION = [
 	"",
 	"Read-only. It reports the role manifest, not the routes in `$DSH_HOME/pstack-models.mdc`; use `pstack_models` for the routes this deployment actually serves.",
 	"",
-	"`roleIndex` applies only to a list role that is not an automatic panel: `arena cross-judge pool` and `swarm workers`. Pass `null` for every single role and for an automatic panel (`arena runners`, `architect runners`, `interrogate reviewers`), which starts one child per configured entry."
+	"`roleIndex` applies only to a list role that is not an automatic panel: `arena cross-judge pool` and `swarm workers`. Pass null for every single role and for an automatic panel."
 ].join("\n");
-function createPstackRoleCatalogTool() {
+/** Build the tool definition. */
+function createPstackRolesTool() {
 	return {
 		name: TOOL_NAME,
 		description: TOOL_DESCRIPTION,
@@ -115,8 +101,7 @@ function createPstackRoleCatalogTool() {
 		}
 	};
 }
-/** Register `pstack_roles`. */
 function apply(ctx) {
-	ctx.tools.register(createPstackRoleCatalogTool());
+	ctx.tools.register(createPstackRolesTool());
 }
-export { TOOL_NAME, apply, createPstackRoleCatalogTool, inject, name, renderRoleCapabilities, roleCapabilities, roleCapability };
+export { TOOL_NAME, apply, createPstackRolesTool, inject, name, renderRoleCapabilities, roleCapabilities, roleCapability };

package/dist/role-config.d.mts

@@ -0,0 +1,41 @@
+import { r as RoleFileIssue, t as RoleEntry } from "./role-file-CIVHnhBg.mjs";
+import { c as RoleSpec } from "./role-manifest-D1npMjqZ.mjs";
+import { n as Route } from "./route-7SqXDYrL.mjs";
+/** Parsed role-file state. */
+export type RoleConfiguration = {
+  readonly status: "missing";
+  readonly path: string;
+} | {
+  readonly status: "unreadable";
+  readonly path: string;
+  readonly reason: string;
+} | {
+  readonly status: "loaded";
+  readonly path: string;
+  readonly budget?: string;
+  readonly roles: ReadonlyMap<string, RoleEntry>;
+  readonly issues: readonly RoleFileIssue[];
+};
+/** Absolute role-file path for one DSH home. */
+export declare function modelsFilePath(dshHome: string): string;
+/** Resolve `$DSH_HOME`: environment first, then `~/.dsh`. */
+export declare function resolveDshHome(env?: Readonly<Record<string, string | undefined>>, home?: string): string;
+/** Read the role file without throwing for a missing path. */
+export declare function readRoleConfiguration(path: string): RoleConfiguration;
+/** Parse role-file text. Pure: no filesystem access. */
+export declare function parseRoleConfiguration(text: string, path: string): RoleConfiguration;
+/** How one role expands into children. */
+export type RouteSelectionMode = "single" | "panel" | "selected";
+export interface RouteSelection {
+  readonly role: RoleSpec;
+  readonly mode: RouteSelectionMode;
+  readonly configured: boolean;
+  readonly routes: readonly Route[];
+  readonly total: number;
+  readonly roleIndex?: number;
+}
+/** Resolve one role into the routes this call starts. */
+export declare function selectRoutes(spec: RoleSpec, entry: RoleEntry | undefined, roleIndex: number | undefined): RouteSelection;
+/** Resolve an exact role key or throw a diagnostic that lists the manifest. */
+export declare function requireRole(raw: string): RoleSpec;
+export type { RoleEntry, RoleFileIssue, Route };

package/dist/role-config.mjs

@@ -0,0 +1,112 @@
+import { parseRoleFileDocument } from "./role-file.mjs";
+import { PSTACK_MODELS_FILENAME, ROLE_MANIFEST, findRole } from "./role-manifest.mjs";
+import { join, resolve } from "node:path";
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+// src/role-config.ts
+/**
+* `$DSH_HOME/pstack-models.mdc` reader and route selector.
+*
+* The role file is read again on every delegation. Missing, unreadable, and
+* loaded-with-issues are distinct states: a missing file means every role
+* inherits the parent route, while an unreadable file must fail loudly instead
+* of silently behaving like a fresh install.
+*/
+/** Absolute role-file path for one DSH home. */
+function modelsFilePath(dshHome) {
+	return join(dshHome, PSTACK_MODELS_FILENAME);
+}
+/** Resolve `$DSH_HOME`: environment first, then `~/.dsh`. */
+function resolveDshHome(env = process.env, home = homedir()) {
+	const raw = env["DSH_HOME"]?.trim();
+	const path = raw === void 0 || raw === "" ? join(home, ".dsh") : raw;
+	const expanded = path === "~" ? home : path.startsWith("~/") || path.startsWith("~\\") ? join(home, path.slice(2)) : path;
+	return resolve(expanded);
+}
+/** Read the role file without throwing for a missing path. */
+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(error)
+		};
+	}
+	return parseRoleConfiguration(text, path);
+}
+/** Parse role-file text. Pure: no filesystem access. */
+function parseRoleConfiguration(text, path) {
+	const document = parseRoleFileDocument(text, path);
+	return {
+		status: "loaded",
+		path,
+		...document.budget === void 0 ? {} : { budget: document.budget },
+		roles: document.roles,
+		issues: document.issues
+	};
+}
+/** Resolve one role into the routes this call starts. */
+function selectRoutes(spec, entry, roleIndex) {
+	if (spec.shape === "single" && roleIndex !== void 0) throw new Error(`role "${spec.key}" holds a single route, so \`roleIndex\` does not apply`);
+	if (spec.autoPanel && roleIndex !== void 0) throw new Error(`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",
+			alias: "inherit-parent"
+		}],
+		total: 1
+	};
+	if (entry.issues.length > 0) throw new Error(`role "${spec.key}" has invalid configuration on line ${entry.line}: ${entry.issues.join("; ")}`);
+	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;
+		const route = entry.routes[index];
+		if (route === void 0) throw new Error(`role "${spec.key}" has ${entry.routes.length} entries, so \`roleIndex\` ${index} is out of range`);
+		return {
+			role: spec,
+			mode: "selected",
+			configured: true,
+			routes: [route],
+			total: entry.routes.length,
+			roleIndex: index
+		};
+	}
+	const route = entry.routes[0];
+	if (route === void 0) throw new Error(`role "${spec.key}" has no route`);
+	return {
+		role: spec,
+		mode: "single",
+		configured: true,
+		routes: [route],
+		total: 1
+	};
+}
+/** Resolve an exact role key or throw a diagnostic that lists the manifest. */
+function requireRole(raw) {
+	const spec = findRole(raw);
+	if (spec !== void 0) return spec;
+	throw new Error(`unknown pstack role ${JSON.stringify(raw)}; role names come from the pstack role manifest, not free text. Known roles: ${ROLE_MANIFEST.map((role) => JSON.stringify(role.key)).join(", ")}`);
+}
+function isMissingFile(error) {
+	return typeof error === "object" && error !== null && error.code === "ENOENT";
+}
+function describeError(error) {
+	return error instanceof Error ? error.message : String(error);
+}
+export { modelsFilePath, parseRoleConfiguration, readRoleConfiguration, requireRole, resolveDshHome, selectRoutes };

package/dist/role-editor.d.mts

@@ -0,0 +1,25 @@
+import { n as Route } from "./route-7SqXDYrL.mjs";
+import { collectCatalogue } from "./models.mjs";
+import { BudgetApplyRequest } from "./budget.mjs";
+import { RoleConfiguration } from "./role-config.mjs";
+import { BudgetApplyResult, RoleFileSnapshot, SaveRoleRequest, SaveRoleResult } from "./role-wire.mjs";
+import { LlmRuntime } from "@deepseek-ai/dsh-llm";
+/** Project one parsed file onto the manifest. */
+export declare function snapshotFromConfiguration(config: RoleConfiguration): RoleFileSnapshot;
+/** Validate a save against the manifest and the live model catalogue. */
+export declare function validateSaveRequest(request: SaveRoleRequest, catalogue: Awaited<ReturnType<typeof collectCatalogue>>): {
+  ok: true;
+  key: string;
+  routes: readonly Route[];
+} | {
+  ok: false;
+  reason: string;
+};
+/** Replace or append one role line, preserving the other logical lines. */
+export declare function updateRoleText(text: string, key: string, value: string): string;
+/** Remove every matching role line. Clearing an absent role is a no-op. */
+export declare function removeRoleText(text: string, key: string): string;
+/** Save one role and return the reloaded snapshot. */
+export declare function saveRoleConfiguration(path: string, request: SaveRoleRequest, llm: LlmRuntime, signal: AbortSignal): Promise<SaveRoleResult>;
+/** Apply one global budget target to the role file in a single atomic write. */
+export declare function saveBudgetConfiguration(path: string, request: BudgetApplyRequest, llm: LlmRuntime, signal: AbortSignal): Promise<BudgetApplyResult>;