dsh-pstack 0.3.0-beta.1 → 0.3.1

package/dist/roles.mjs

@@ -1,293 +0,0 @@
-import { collectCatalogue } from "./models.mjs";
-import { i as findRoleSpec, o as normalizeRoleName, r as ROLE_MANIFEST, t as INHERIT_PARENT_ALIASES } from "./role-manifest-79cnFfDM.mjs";
-import { REMOTE_PACKAGE, ROLES_SERVICE, pstackRolesRemote } from "./remote.mjs";
-import { i as resolveDshHome, n as readRoleConfiguration, o as updateRoleDocument, t as modelsFilePath } from "./role-config-a4JpVdc-.mjs";
-import { dirname } from "node:path";
-import { mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
-import { Service } from "@deepseek-ai/cordis";
-import { TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
-import { randomUUID } from "node:crypto";
-// src/internal/role-editor.ts
-/**
-* Role-file editing behind the Plugins configuration page.
-*
-* The writer changes exactly one role line and leaves every other byte of the
-* file alone: unknown lines, malformed lines, comments, and `# budget` survive a
-* save. Saves are validated against the live `pstack_models` catalogue before
-* the first byte is written, so a rejected save leaves the file unchanged.
-*/
-function routeView(route) {
-	if (route.kind === "inherit") return {
-		kind: "inherit",
-		alias: route.alias ?? "inherit-parent"
-	};
-	return {
-		kind: "route",
-		provider: route.provider,
-		model: route.model,
-		...route.effort === void 0 ? {} : { effort: route.effort }
-	};
-}
-function roleView(spec, entry) {
-	return {
-		key: spec.key,
-		shape: spec.shape,
-		configured: entry !== void 0,
-		...entry === void 0 ? {} : { line: entry.line },
-		routes: entry === void 0 ? [] : entry.routes.map(routeView),
-		issues: entry === void 0 ? [] : [...entry.issues]
-	};
-}
-/** Project a parsed file onto the manifest, preserving order and per-line issues. */
-function snapshotFromConfiguration(config) {
-	if (config.status === "unreadable") return {
-		path: config.path,
-		status: "unreadable",
-		reason: config.reason,
-		roles: ROLE_MANIFEST.map((spec) => roleView(spec, void 0)),
-		issues: [],
-		canSave: false
-	};
-	if (config.status === "missing") return {
-		path: config.path,
-		status: "missing",
-		roles: ROLE_MANIFEST.map((spec) => roleView(spec, void 0)),
-		issues: [],
-		canSave: true
-	};
-	return {
-		path: config.path,
-		status: "loaded",
-		...config.budget === void 0 ? {} : { budget: config.budget },
-		roles: ROLE_MANIFEST.map((spec) => roleView(spec, config.roles.get(spec.key))),
-		issues: config.issues.map((issue) => ({
-			...issue.line === void 0 ? {} : { line: issue.line },
-			message: issue.message
-		})),
-		canSave: true
-	};
-}
-/** Validate one save against the manifest and the live catalogue. */
-function validateSaveRequest(request, catalogue) {
-	if (typeof request !== "object" || request === null || Array.isArray(request)) return {
-		ok: false,
-		reason: "the save request must be an object"
-	};
-	if (typeof request.key !== "string") return {
-		ok: false,
-		reason: "the save request must name a role"
-	};
-	const spec = findRoleSpec(normalizeRoleName(request.key));
-	if (spec === void 0) return {
-		ok: false,
-		reason: `unknown role ${JSON.stringify(request.key)}`
-	};
-	if (!Array.isArray(request.routes)) return {
-		ok: false,
-		reason: `role "${spec.key}" must carry a route list`
-	};
-	if (spec.shape === "single" && request.routes.length !== 1) return {
-		ok: false,
-		reason: `role "${spec.key}" holds a single route; save exactly one`
-	};
-	if (request.routes.length === 0) return {
-		ok: false,
-		reason: `role "${spec.key}" must keep at least one route`
-	};
-	const routes = [];
-	for (let index = 0; index < request.routes.length; index += 1) {
-		const route = request.routes[index];
-		const position = request.routes.length === 1 ? "the route" : `route ${index + 1}`;
-		if (typeof route !== "object" || route === null || Array.isArray(route)) return {
-			ok: false,
-			reason: `${position} must be an object`
-		};
-		if (route.kind === "inherit") {
-			const alias = route.alias ?? "inherit-parent";
-			if (!INHERIT_PARENT_ALIASES.includes(alias)) return {
-				ok: false,
-				reason: `${position} has unknown inheritance alias ${JSON.stringify(alias)}; use \`inherit-parent\` or \`auto\``
-			};
-			routes.push({
-				kind: "inherit",
-				alias
-			});
-			continue;
-		}
-		const unknownKind = route.kind;
-		if (unknownKind !== "route") return {
-			ok: false,
-			reason: `${position} has unknown kind ${JSON.stringify(unknownKind)}`
-		};
-		const provider = typeof route.provider === "string" ? route.provider.trim() : "";
-		const model = typeof route.model === "string" ? route.model.trim() : "";
-		if (provider === "" || model === "") return {
-			ok: false,
-			reason: `${position} needs both a provider and a model`
-		};
-		const providerEntry = catalogue.providers.find((candidate) => candidate.provider === provider);
-		if (providerEntry === void 0) return {
-			ok: false,
-			reason: `provider ${JSON.stringify(provider)} is not in the live model directory; run \`pstack_models\` and pick a registered provider`
-		};
-		if (providerEntry.error !== void 0) return {
-			ok: false,
-			reason: `provider ${JSON.stringify(provider)} could not be discovered: ${providerEntry.error}`
-		};
-		const modelEntry = providerEntry.models.find((candidate) => candidate.id === model);
-		if (modelEntry === void 0) return {
-			ok: false,
-			reason: `provider ${JSON.stringify(provider)} does not advertise model ${JSON.stringify(model)}`
-		};
-		if (modelEntry.error !== void 0) return {
-			ok: false,
-			reason: `model ${JSON.stringify(`${provider}/${model}`)} could not be resolved: ${modelEntry.error}`
-		};
-		const effort = typeof route.effort === "string" ? route.effort.trim() : route.effort;
-		if (effort !== void 0 && effort !== "") {
-			if (!modelEntry.efforts.includes(effort)) return {
-				ok: false,
-				reason: `model ${JSON.stringify(`${provider}/${model}`)} does not declare effort ${JSON.stringify(effort)}; declared efforts: ${modelEntry.efforts.length === 0 ? "none" : modelEntry.efforts.join(", ")}`
-			};
-			routes.push({
-				kind: "route",
-				provider,
-				model,
-				effort
-			});
-			continue;
-		}
-		if (effort === "") return {
-			ok: false,
-			reason: `${position} has an empty effort; drop the effort or pick one`
-		};
-		routes.push({
-			kind: "route",
-			provider,
-			model
-		});
-	}
-	return {
-		ok: true,
-		value: {
-			spec,
-			routes
-		}
-	};
-}
-/** Render one role's routes in the role-file grammar. */
-function renderRoleValue(routes) {
-	return routes.map((route) => route.kind === "inherit" ? route.alias ?? "inherit-parent" : route.effort === void 0 ? `${route.provider}/${route.model}` : `${route.provider}/${route.model} [${route.effort}]`).join(", ");
-}
-/** Update the winning role through the same line grammar used by the parser. */
-function updateRoleText(text, spec, value) {
-	return updateRoleDocument(text, spec, value);
-}
-function writeAtomically(path, text) {
-	mkdirSync(dirname(path), { recursive: true });
-	const temporary = `${path}.${process.pid}.${randomUUID()}.tmp`;
-	try {
-		writeFileSync(temporary, text, "utf8");
-		renameSync(temporary, path);
-	} catch (error) {
-		rmSync(temporary, { force: true });
-		throw error;
-	}
-}
-/**
-* Save one role and return the reloaded snapshot.
-*
-* A missing file is created with just this role. An unreadable file is never
-* overwritten. Every refusal leaves the existing bytes untouched.
-*/
-function saveRoleConfiguration(path, request, catalogue) {
-	const current = readRoleConfiguration(path);
-	if (current.status === "unreadable") return {
-		ok: false,
-		reason: `the role file is unreadable: ${current.reason}`
-	};
-	const validation = validateSaveRequest(request, catalogue);
-	if (!validation.ok) return validation;
-	let existing = "";
-	if (current.status === "loaded") try {
-		existing = readFileSync(path, "utf8");
-	} catch (error) {
-		return {
-			ok: false,
-			reason: `the role file could not be read: ${describeError(error)}`
-		};
-	}
-	const next = updateRoleText(existing, validation.value.spec, renderRoleValue(validation.value.routes));
-	try {
-		writeAtomically(path, next);
-	} catch (error) {
-		return {
-			ok: false,
-			reason: `the role file could not be written: ${describeError(error)}`
-		};
-	}
-	return {
-		ok: true,
-		snapshot: snapshotFromConfiguration(readRoleConfiguration(path))
-	};
-}
-function describeError(error) {
-	if (error instanceof Error) {
-		const code = error.code;
-		return typeof code === "string" ? `${error.message} (${code})` : error.message;
-	}
-	return String(error);
-}
-// src/roles.ts
-/**
-* `pstack-roles`: the Host half of the role model configuration page.
-*
-* It owns no cached policy: every read and write goes to
-* `$DSH_HOME/pstack-models.mdc`, which `pstack_subagent` also re-reads on every
-* delegation. Saving therefore takes effect on the next delegation without a
-* restart, and an already running child keeps the route it started with.
-*/
-/** Read and write the role file for the Plugins configuration page. */
-var PstackRolesService = class extends TypertRemoteService {
-	static inject = ["llm", "typert"];
-	constructor(ctx) {
-		super(ctx, ROLES_SERVICE);
-	}
-	[Service.init]() {
-		const typert = this.ctx.typert;
-		if (typert === void 0) throw new Error("pstack-roles requires the Typert registry service");
-		typert.register({
-			package: REMOTE_PACKAGE,
-			face: "host",
-			schemas: [],
-			model: {
-				services: [],
-				events: [],
-				objects: []
-			},
-			invocations: pstackRolesRemote.descriptors
-		});
-	}
-	/** Current path, status, values, and per-line issues. */
-	status() {
-		return snapshotFromConfiguration(readRoleConfiguration(roleFilePath()));
-	}
-	/** The live directory the page offers for its provider/model/effort selects. */
-	async catalogue(signal) {
-		return collectCatalogue(this.llm, void 0, signal);
-	}
-	/** Validate and save one role, then return the reloaded snapshot. */
-	async save(request, signal) {
-		signal.throwIfAborted();
-		const catalogue = await collectCatalogue(this.llm, void 0, signal);
-		signal.throwIfAborted();
-		return saveRoleConfiguration(roleFilePath(), request, catalogue);
-	}
-	get llm() {
-		return this.ctx.llm;
-	}
-};
-function roleFilePath() {
-	return modelsFilePath(resolveDshHome());
-}
-export { PstackRolesService, PstackRolesService as default };

package/dist/script.d.mts

@@ -1,91 +0,0 @@
-import { _ as ToolsHost, a as JobsHost, c as SessionId, g as ToolDefinition, i as JobId, o as JsonSchemaNode, v as WorkingDirectoryHost } from "./host-contract-CUPSpeNk.mjs";
-/** Model-facing tool name. */
-export declare const TOOL_NAME = "pstack_script";
-/** The shipped scripts this tool may run, in display order. */
-export declare const SCRIPT_IDS: string[];
-export type ScriptId = (typeof SCRIPT_IDS)[number];
-export declare const DEFAULT_TIMEOUT_MS = 120000;
-export declare const MAX_TIMEOUT_MS = 600000;
-export declare const DEFAULT_OUTPUT_LIMIT_BYTES: number;
-/** Raised for an argument problem, before anything is spawned. */
-export declare class ScriptInputError extends Error {
-  constructor(message: string);
-}
-/** Raised when a shipped artefact is missing from this install. */
-export declare class ScriptMissingError extends Error {
-  constructor(message: string);
-}
-export interface ScriptArgs {
-  readonly id: ScriptId;
-  readonly args: readonly string[];
-  readonly cwd?: string;
-  readonly background: boolean;
-  readonly timeoutMs?: number;
-  readonly outputLimitBytes?: number;
-}
-export interface ScriptResult {
-  readonly kind: "foreground";
-  readonly id: ScriptId;
-  readonly exitCode: number;
-  readonly signal: NodeJS.Signals | null;
-  readonly timedOut: boolean;
-  readonly stdout: string;
-  readonly stderr: string;
-  readonly stdoutTruncated: boolean;
-  readonly stderrTruncated: boolean;
-  readonly durationMs: number;
-}
-export interface ScriptJobResult {
-  readonly kind: "background";
-  readonly id: ScriptId;
-  readonly jobId: JobId;
-  readonly status: string;
-}
-export type ScriptOutcome = ScriptResult | ScriptJobResult;
-/** Absolute path of one shipped artefact. */
-export declare function scriptPath(id: ScriptId): string;
-/** The environment a child gets: the Electron selector, and otherwise the caller's. */
-export declare function scriptEnvironment(base?: NodeJS.ProcessEnv, versions?: {
-  readonly electron?: string;
-}): NodeJS.ProcessEnv;
-/** Validate the raw tool arguments. */
-export declare function parseScriptArgs(raw: unknown): ScriptArgs;
-/** Resolve the directory the child runs in, relative to the caller-established session directory. */
-export declare function resolveWorkingDirectory(requested: string | undefined, sessionCwd: string | undefined): string | undefined;
-/** Run one script in the foreground. A nonzero exit, signal, timeout, and truncation are returned, not thrown. */
-export declare function runForeground(args: ScriptArgs, options?: {
-  readonly execPath?: string;
-  readonly environment?: NodeJS.ProcessEnv;
-  readonly cwd?: string;
-  readonly signal?: AbortSignal;
-}): Promise<ScriptResult>;
-/** Start a script as a background job. `jobs` absent is a refusal with a reason. */
-export declare function runBackground(args: ScriptArgs, options: {
-  readonly jobs?: JobsHost | undefined;
-  readonly caller?: SessionId;
-  readonly execPath?: string;
-  readonly environment?: NodeJS.ProcessEnv;
-  readonly cwd?: string;
-}): Promise<ScriptJobResult>;
-/** Render one captured stream as a fence that the content cannot close early. */
-export declare function renderCapturedStream(text: string): readonly string[];
-/** Render one outcome for the model. */
-export declare function renderScriptOutcome(outcome: ScriptOutcome): string;
-export declare function buildScriptParameters(): Record<string, unknown>;
-export declare const OUTPUT_SCHEMA: JsonSchemaNode;
-/** The slices of the Cordis context this tool needs. */
-export interface PstackScriptHost {
-  readonly tools: ToolsHost;
-  readonly workingDirectory: WorkingDirectoryHost;
-  readonly getJobs?: () => JobsHost | undefined;
-}
-/** Build the tool for one row. */
-export declare function createPstackScriptTool(host: PstackScriptHost): ToolDefinition;
-/** Cordis row name, used by Loader diagnostics. */
-export declare const name = "pstack-script";
-/** Hard dependencies: the tool registry and the session directory. `jobs` is optional and read per call. */
-export declare const inject: string[];
-/** Register `pstack_script` for this row. */
-export declare function apply(ctx: PstackScriptHost & {
-  get?: (name: string) => JobsHost | undefined;
-}): void;