dsh-pstack 0.3.0-beta.1 → 0.3.1

package/dist/models.mjs

@@ -1,37 +1,25 @@
+import { CATALOGUE_OUTPUT_SCHEMA } from "./catalogue.mjs";
 // src/models.ts
-/** Cordis row name, used by Loader diagnostics. */
 const name = "pstack-models";
-/** The hard dependencies: the adapter registry and the tool registry. */
 const inject = ["llm", "tools"];
-/** Model-facing tool name. */
 const TOOL_NAME = "pstack_models";
 const MAX_PROVIDERS = 64;
-const MAX_MODELS_PER_PROVIDER = 200;
-function entryFromInfo(provider, info) {
-	const efforts = info.reasoning?.efforts.map((effort) => effort.id) ?? [];
-	return {
-		route: `${provider}/${info.id}`,
-		id: info.id,
-		name: info.name,
-		...info.description === void 0 ? {} : { description: info.description },
-		...info.context?.contextWindow === void 0 ? {} : { contextWindow: info.context.contextWindow },
-		...info.defaultMaxTokens === void 0 ? {} : { maxTokens: info.defaultMaxTokens },
-		efforts,
-		...info.reasoning?.defaultEffort === void 0 ? {} : { defaultEffort: info.reasoning.defaultEffort }
-	};
-}
-/** Collect the catalogue from the live adapters. */
+const MAX_MODELS = 200;
+/** Collect the live catalogue with bounded provider/model counts. */
 async function collectCatalogue(llm, providerFilter, signal) {
-	const all = llm.listProviders();
-	const selected = providerFilter === void 0 ? all : all.filter((provider) => provider.id === providerFilter || provider.name === providerFilter);
-	const providers = [];
-	let truncated = false;
-	for (const provider of selected.slice(0, MAX_PROVIDERS)) {
+	const registered = llm.listProviders();
+	const providers = providerFilter === void 0 ? registered : registered.filter((provider) => provider.id === providerFilter || provider.name === providerFilter);
+	const selected = providers.slice(0, MAX_PROVIDERS);
+	const output = [];
+	let truncated = providers.length > selected.length;
+	for (const provider of selected) {
+		signal.throwIfAborted();
 		let models;
 		try {
 			models = await llm.listModels(provider.id);
 		} catch (error) {
-			providers.push({
+			if (signal.aborted) throw error;
+			output.push({
 				provider: provider.id,
 				name: provider.name,
 				models: [],
@@ -39,13 +27,15 @@ async function collectCatalogue(llm, providerFilter, signal) {
 			});
 			continue;
 		}
-		if (models.length > MAX_MODELS_PER_PROVIDER) truncated = true;
+		if (models.length > MAX_MODELS) truncated = true;
 		const entries = [];
-		for (const model of models.slice(0, MAX_MODELS_PER_PROVIDER)) {
+		for (const model of models.slice(0, MAX_MODELS)) {
 			signal.throwIfAborted();
 			try {
-				entries.push(entryFromInfo(provider.id, await llm.resolveModelInfo(provider.id, model.id, signal)));
+				const info = await llm.resolveModelInfo(provider.id, model.id, signal);
+				entries.push(entryFor(provider.id, info));
 			} catch (error) {
+				if (signal.aborted) throw error;
 				entries.push({
 					route: `${provider.id}/${model.id}`,
 					id: model.id,
@@ -56,21 +46,21 @@ async function collectCatalogue(llm, providerFilter, signal) {
 				});
 			}
 		}
-		providers.push({
+		output.push({
 			provider: provider.id,
 			name: provider.name,
 			models: entries
 		});
 	}
-	if (selected.length > MAX_PROVIDERS) truncated = true;
 	return {
-		providers,
+		providers: output,
 		truncated,
 		...providerFilter === void 0 ? {} : { providerFilter }
 	};
 }
+/** Render the catalogue as compact model-facing text. */
 function renderCatalogue(result) {
-	if (result.providers.length === 0) return result.providerFilter === void 0 ? "No provider is registered with the live adapter registry." : `No provider matches "${result.providerFilter}". Registered providers are listed when \`provider\` is omitted.`;
+	if (result.providers.length === 0) return result.providerFilter === void 0 ? "No provider is registered with the live adapter registry." : `No provider matches "${result.providerFilter}".`;
 	const lines = [];
 	for (const provider of result.providers) {
 		lines.push(`${provider.provider} (${provider.name})`);
@@ -84,76 +74,36 @@ function renderCatalogue(result) {
 		}
 		for (const model of provider.models) {
 			const efforts = model.efforts.length === 0 ? "no reasoning efforts" : `efforts: ${model.efforts.join(", ")}`;
-			const defaultEffort = model.defaultEffort === void 0 ? "" : `; default: ${model.defaultEffort}`;
-			const failure = model.error === void 0 ? "" : `; error: ${model.error}`;
-			lines.push(`  ${model.route} — ${efforts}${defaultEffort}${failure}`);
+			const fallback = model.defaultEffort === void 0 ? "" : `; default: ${model.defaultEffort}`;
+			const error = model.error === void 0 ? "" : `; error: ${model.error}`;
+			lines.push(`  ${model.route} — ${efforts}${fallback}${error}`);
 		}
 	}
-	if (result.truncated) lines.push("", `Truncated at ${MAX_PROVIDERS} providers and ${MAX_MODELS_PER_PROVIDER} models each.`);
+	if (result.truncated) lines.push("", "Truncated at the provider/model page limits.");
 	return lines.join("\n");
 }
-const OUTPUT_SCHEMA = {
-	type: "object",
-	additionalProperties: false,
-	properties: {
-		providers: {
-			type: "array",
-			items: {
-				type: "object",
-				additionalProperties: false,
-				properties: {
-					provider: { type: "string" },
-					name: { type: "string" },
-					error: { type: "string" },
-					models: {
-						type: "array",
-						items: {
-							type: "object",
-							additionalProperties: false,
-							properties: {
-								route: { type: "string" },
-								id: { type: "string" },
-								name: { type: "string" },
-								description: { type: "string" },
-								contextWindow: { type: "integer" },
-								maxTokens: { type: "integer" },
-								efforts: {
-									type: "array",
-									items: { type: "string" }
-								},
-								defaultEffort: { type: "string" },
-								error: { type: "string" }
-							},
-							required: [
-								"route",
-								"id",
-								"name",
-								"efforts"
-							]
-						}
-					}
-				},
-				required: [
-					"provider",
-					"name",
-					"models"
-				]
-			}
-		},
-		truncated: { type: "boolean" },
-		providerFilter: { type: "string" }
-	},
-	required: ["providers", "truncated"]
-};
+function entryFor(provider, info) {
+	return {
+		route: `${provider}/${info.id}`,
+		id: info.id,
+		name: info.name,
+		...info.description === void 0 ? {} : { description: info.description },
+		...info.context?.contextWindow === void 0 ? {} : { contextWindow: info.context.contextWindow },
+		...info.defaultMaxTokens === void 0 ? {} : { maxTokens: info.defaultMaxTokens },
+		efforts: info.reasoning?.efforts.map((effort) => effort.id) ?? [],
+		...info.reasoning?.defaultEffort === void 0 ? {} : { defaultEffort: info.reasoning.defaultEffort }
+	};
+}
 const TOOL_DESCRIPTION = [
 	"List the exact model routes this deployment serves, with each route's advertised reasoning-effort tokens.",
 	"",
-	"Read-only. Use it before writing `$DSH_HOME/pstack-models.mdc`: it reports what the live adapters actually serve, so a role line names a route that exists instead of a slug guessed from an upstream name.",
+	"Read-only. Use it before writing `$DSH_HOME/pstack-models.mdc`: it reports what the live adapters actually serve, so a role line names a route that exists instead of a slug guessed from a Cursor name.",
 	"",
 	"`provider` limits discovery to one registered provider id or display name; omit it to list every provider.",
 	"",
-	"A route is written `<provider>/<model>`, and a role line may add `[effort]` using a token from that route's `efforts`. A provider whose discovery fails is reported beside the others rather than dropping the whole catalog."
+	"A route is written `<provider>/<model>`, and a role line may add `[effort]` using a token from that route's `efforts`."
 ].join("\n");
+/** Build `pstack_models` for one LLM service. */
 function createPstackModelsTool(llm) {
 	return {
 		name: TOOL_NAME,
@@ -163,11 +113,11 @@ function createPstackModelsTool(llm) {
 			additionalProperties: false,
 			properties: { provider: {
 				type: "string",
-				description: "A registered provider id or display name to limit discovery to. Omit it to list every provider."
+				description: "A registered provider id or display name; omit for every provider."
 			} }
 		},
 		output: {
-			schema: OUTPUT_SCHEMA,
+			schema: CATALOGUE_OUTPUT_SCHEMA,
 			render: (_args, value) => [{
 				type: "text",
 				text: renderCatalogue(value)
@@ -175,27 +125,17 @@ function createPstackModelsTool(llm) {
 		},
 		isConcurrencySafe: () => true,
 		async execute(rawArgs, exec) {
-			return await collectCatalogue(llm, readProviderArgument(rawArgs), exec.signal);
+			if (typeof rawArgs !== "object" || rawArgs === null || Array.isArray(rawArgs)) throw new Error("pstack_models takes an object argument");
+			const provider = rawArgs["provider"];
+			if (provider !== void 0 && typeof provider !== "string") throw new Error("provider must be a string when present");
+			return collectCatalogue(llm, provider, exec.signal);
 		}
 	};
 }
-function readProviderArgument(raw) {
-	if (raw === null || raw === void 0) return void 0;
-	if (typeof raw !== "object" || Array.isArray(raw)) throw new Error("pstack_models arguments must be an object");
-	const provider = raw["provider"];
-	if (provider === void 0) return void 0;
-	if (typeof provider !== "string" || provider.trim() === "") throw new Error("`provider` must be a non-empty string when present");
-	return provider.trim();
-}
-/** Register `pstack_models`. */
 function apply(ctx) {
 	ctx.tools.register(createPstackModelsTool(ctx.llm));
 }
 function describeError(error) {
-	if (error instanceof Error) {
-		const code = error.code;
-		return typeof code === "string" ? `${error.message} (${code})` : error.message;
-	}
-	return String(error);
+	return error instanceof Error ? error.message : String(error);
 }
 export { TOOL_NAME, apply, collectCatalogue, createPstackModelsTool, inject, name, renderCatalogue };

package/dist/paths.d.mts

@@ -0,0 +1,13 @@
+/**
+ * Package-internal resource locations.
+ *
+ * The bundler writes public entries to `dist/`. The generated pstack tree is
+ * copied to `dist/pstack/`, and vendored skills to `dist/skills/vendored/`.
+ */
+/**
+ * The `poteto-mode` instruction path used by the root `poteto-mode` preset and
+ * the `poteto-agent` delegate brief.
+ */
+export declare const POTETO_MODE_SKILL_PATH: string;
+/** The shipped DSH adapter document. */
+export declare const HARNESS_DOC_PATH: string;

package/dist/paths.mjs

@@ -0,0 +1,26 @@
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+// src/paths.ts
+/**
+* Package-internal resource locations.
+*
+* The bundler writes public entries to `dist/`. The generated pstack tree is
+* copied to `dist/pstack/`, and vendored skills to `dist/skills/vendored/`.
+*/
+const here = dirname(fileURLToPath(import.meta.url));
+/** The package root, from a bundled entry in `dist/`. */
+const PACKAGE_ROOT = resolve(here, "..");
+/** The shipped output tree. */
+const DIST_ROOT = join(PACKAGE_ROOT, "dist");
+/** The generated pstack tree. */
+const PORT_ROOT = join(DIST_ROOT, "pstack");
+/** The generated pstack skills. */
+const SKILLS_ROOT = join(PORT_ROOT, "skills");
+/**
+* The `poteto-mode` instruction path used by the root `poteto-mode` preset and
+* the `poteto-agent` delegate brief.
+*/
+const POTETO_MODE_SKILL_PATH = join(SKILLS_ROOT, "poteto-mode", "SKILL.md");
+/** The shipped DSH adapter document. */
+const HARNESS_DOC_PATH = join(PORT_ROOT, "docs", "harness", "dsh.md");
+export { HARNESS_DOC_PATH, POTETO_MODE_SKILL_PATH };

package/dist/poteto-mode.d.mts

@@ -0,0 +1,37 @@
+import { Context } from "@deepseek-ai/cordis";
+export declare const name = "pstack-poteto-mode";
+export declare const inject: string[];
+/** Stable section name. */
+export declare const SECTION_NAME = "pstack:poteto-mode";
+/** Section order. */
+export declare const SECTION_ORDER = 10;
+/** Error used when Agent Teams would compete with pstack delegation. */
+export declare const AGENT_TEAMS_CONFLICT = "pstack root presets cannot be used with Agent Teams. Disable @deepseek-ai/dsh-experimental-agent-team-profile in this profile, or use the standard or Creator preset for Agent Teams.";
+/** Refuse to mount a pstack root preset when Agent Teams owns delegation. */
+export declare function assertNoAgentTeams(ctx: Context): void;
+/** The prompt section shape accepted by the system prompt registry. */
+export interface PromptSectionLike {
+  readonly name: string;
+  readonly order: number;
+  readonly text: string;
+  readonly interpolate?: boolean;
+}
+/** The slice of `ctx.systemPrompt` this row writes to. */
+export interface SystemPromptHost {
+  systemPrompt: {
+    section(section: PromptSectionLike): () => void;
+  };
+}
+/**
+ * Build the persistent section from a skill file and the DSH adapter path.
+ *
+ * The leading YAML frontmatter is stripped, and `interpolate: false` keeps any
+ * literal `{{...}}` in the skill body from being resolved as a prompt variable.
+ */
+export declare function createPotetoModeSection(skillPath?: string, harnessDocPath?: string): PromptSectionLike;
+/** Optional section sources. Tests pass a temporary skill so `apply` does not read the built tree. */
+export interface PotetoModeSectionPaths {
+  readonly skillPath?: string;
+  readonly harnessDocPath?: string;
+}
+export declare function apply(ctx: Context, paths?: PotetoModeSectionPaths): void;

package/dist/poteto-mode.mjs

@@ -0,0 +1,61 @@
+import { HARNESS_DOC_PATH, POTETO_MODE_SKILL_PATH } from "./paths.mjs";
+import { dirname } from "node:path";
+import { readFileSync } from "node:fs";
+// src/poteto-mode.ts
+/**
+* `pstack-poteto-mode`: mount the full `poteto-mode` skill as a persistent section.
+*
+* A root session that selects the `poteto-mode` preset keeps this section for its
+* whole life, so the model never has to load the skill again between turns.
+*/
+const name = "pstack-poteto-mode";
+const inject = ["systemPrompt"];
+/** Stable section name. */
+const SECTION_NAME = "pstack:poteto-mode";
+/** Section order. */
+const SECTION_ORDER = 10;
+/** Error used when Agent Teams would compete with pstack delegation. */
+const AGENT_TEAMS_CONFLICT = "pstack root presets cannot be used with Agent Teams. Disable @deepseek-ai/dsh-experimental-agent-team-profile in this profile, or use the standard or Creator preset for Agent Teams.";
+/** Refuse to mount a pstack root preset when Agent Teams owns delegation. */
+function assertNoAgentTeams(ctx) {
+	if (ctx.get("agentTeams") !== void 0) throw new Error(AGENT_TEAMS_CONFLICT);
+}
+const FRONTMATTER = /^---\r?\n[\s\S]*?\r?\n---\r?\n?/;
+/**
+* Build the persistent section from a skill file and the DSH adapter path.
+*
+* The leading YAML frontmatter is stripped, and `interpolate: false` keeps any
+* literal `{{...}}` in the skill body from being resolved as a prompt variable.
+*/
+function createPotetoModeSection(skillPath = POTETO_MODE_SKILL_PATH, harnessDocPath = HARNESS_DOC_PATH) {
+	const body = readFileSync(skillPath, "utf8").replace(FRONTMATTER, "");
+	const skillDirectory = dirname(skillPath);
+	const text = [
+		"You are running in the persistent pstack `poteto-mode` root preset. The full `poteto-mode` skill below stays in this system prompt for every turn of the session.",
+		"",
+		`- Skill file: ${skillPath}`,
+		`- Skill directory: ${skillDirectory}`,
+		`- DSH adapter: ${harnessDocPath}`,
+		"",
+		`Read the DSH adapter at ${harnessDocPath} once per session before you follow this skill.`,
+		"",
+		body.replace(/^\n+/, "")
+	].join("\n");
+	return {
+		name: SECTION_NAME,
+		order: 10,
+		interpolate: false,
+		text
+	};
+}
+function apply(ctx, paths) {
+	assertNoAgentTeams(ctx);
+	const host = ctx;
+	const section = createPotetoModeSection(paths?.skillPath, paths?.harnessDocPath);
+	ctx.effect(() => host.systemPrompt.section(section), "pstack.poteto-mode.section()");
+	ctx.effect(() => ctx.on("agent/created", ({ agent }) => {
+		const preset = agent.session.header.agentPreset;
+		if (preset === "poteto-mode" || preset === "poteto-mode-creator") assertNoAgentTeams(ctx);
+	}), "pstack.poteto-mode.team-guard()");
+}
+export { AGENT_TEAMS_CONFLICT, SECTION_NAME, SECTION_ORDER, apply, assertNoAgentTeams, createPotetoModeSection, inject, name };

package/dist/preset-copy.d.mts

@@ -0,0 +1,12 @@
+/** Display copy for dsh-pstack presets. */
+/** Fallback locale for a missing catalog or preset entry. */
+export declare const FALLBACK_LOCALE = "en";
+/** One preset's display name and description. */
+export interface PresetCopy {
+  readonly name: string;
+  readonly description: string;
+}
+/** Preset copy keyed by locale, then preset id. */
+export declare const PRESET_COPY: Record<string, Record<string, PresetCopy>>;
+/** Read one preset's copy for a BCP 47 locale. */
+export declare function presetCopyFor(id: string, locale: string | undefined): PresetCopy | undefined;

package/dist/preset-copy.mjs

@@ -0,0 +1,64 @@
+// src/preset-copy.ts
+/** Display copy for dsh-pstack presets. */
+/** Fallback locale for a missing catalog or preset entry. */
+const FALLBACK_LOCALE = "en";
+/** Preset copy keyed by locale, then preset id. */
+const PRESET_COPY = {
+	en: {
+		"poteto-mode": {
+			name: "Poteto mode",
+			description: "Based on Standard mode, with the same capabilities plus the persistent poteto-mode workflow."
+		},
+		"poteto-mode-creator": {
+			name: "Poteto Creator mode",
+			description: "Based on Creator mode, with the same capabilities plus the persistent poteto-mode workflow."
+		},
+		"poteto-agent": {
+			name: "Implementation agent",
+			description: "Implementation delegate that follows poteto-mode discipline for one task."
+		},
+		"comment-sicko": {
+			name: "Comment review",
+			description: "Review comments and report deletion targets and symbols that need refactoring."
+		},
+		readonly: {
+			name: "Read-only research",
+			description: "Read-only research delegate that gathers evidence without editing files."
+		}
+	},
+	zh: {
+		"poteto-mode": {
+			name: "Poteto 模式",
+			description: "基于标准模式，能力与标准模式一致，额外常驻 poteto-mode 工作流。"
+		},
+		"poteto-mode-creator": {
+			name: "Poteto 创造模式",
+			description: "基于创造模式，能力与创造模式一致，额外常驻 poteto-mode 工作流。"
+		},
+		"poteto-agent": {
+			name: "实现代理",
+			description: "实现型子代理，按 poteto-mode 的纪律完成单个任务。"
+		},
+		"comment-sicko": {
+			name: "评论审查",
+			description: "审查评论，报告删除目标和需要重构的符号。"
+		},
+		readonly: {
+			name: "只读研究",
+			description: "只读研究代理，收集证据但不修改文件。"
+		}
+	}
+};
+/** Read one preset's copy for a BCP 47 locale. */
+function presetCopyFor(id, locale) {
+	const tag = locale?.trim().toLowerCase();
+	if (tag !== void 0 && tag !== "") {
+		const exact = PRESET_COPY[tag]?.[id];
+		if (exact !== void 0) return exact;
+		const primary = tag.split("-")[0];
+		const primaryCopy = primary === void 0 ? void 0 : PRESET_COPY[primary]?.[id];
+		if (primaryCopy !== void 0) return primaryCopy;
+	}
+	return PRESET_COPY["en"]?.[id];
+}
+export { FALLBACK_LOCALE, PRESET_COPY, presetCopyFor };

package/dist/preset.d.mts

@@ -0,0 +1,31 @@
+import { Context, Service } from "@deepseek-ai/cordis";
+import { EntryGroup } from "@deepseek-ai/cordis-plugin-loader";
+import z from "@deepseek-ai/schemastery";
+import { PresetDefinition } from "@deepseek-ai/dsh-agent-preset-registry";
+/** Read the explicit Web UI locale from `locale.preference`. */
+export declare function readWebUiLocale(ctx: Context): string | undefined;
+/** Replace one preset's name and description with its copy for the active locale. */
+export declare function localizePresetConfig(ctx: Context, config: PresetDefinition): PresetDefinition;
+/** Drop-in replacement for `@deepseek-ai/dsh-agent-preset`. */
+export default class LocalizedAgentPreset {
+  static inject: string[];
+  /** Preserve child expressions until their own plugins activate. */
+  static readonly [EntryGroup.key] = true;
+  static Config: z<Schemastery.ObjectS<NoInfer<{
+    id: z<string, string, "defined">;
+    name: z<string, string, "plain">;
+    description: z<string, string, "plain">;
+    order: z<number, number, "plain">;
+    plugins: z<any[], any[], "defined">;
+  }>>, Schemastery.ObjectT<NoInfer<{
+    id: z<string, string, "defined">;
+    name: z<string, string, "plain">;
+    description: z<string, string, "plain">;
+    order: z<number, number, "plain">;
+    plugins: z<any[], any[], "defined">;
+  }>>, "plain">;
+  private readonly ctx;
+  private readonly config;
+  constructor(ctx: Context, config: PresetDefinition);
+  [Service.init](): AsyncGenerator<() => Promise<void>, void, unknown>;
+}

package/dist/preset.mjs

@@ -0,0 +1,51 @@
+import { presetCopyFor } from "./preset-copy.mjs";
+import { Service } from "@deepseek-ai/cordis";
+import { EntryGroup } from "@deepseek-ai/cordis-plugin-loader";
+import z from "@deepseek-ai/schemastery";
+// src/preset.ts
+/** A localized `@deepseek-ai/dsh-agent-preset` replacement row. */
+/** Read the explicit Web UI locale from `locale.preference`. */
+function readWebUiLocale(ctx) {
+	const settings = ctx.get("settings");
+	try {
+		const value = settings?.describe().find((row) => row.ns === "locale")?.value;
+		if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
+		const preference = value.preference;
+		return typeof preference === "string" ? preference : void 0;
+	} catch {
+		return;
+	}
+}
+/** Replace one preset's name and description with its copy for the active locale. */
+function localizePresetConfig(ctx, config) {
+	const copy = presetCopyFor(config.id, readWebUiLocale(ctx));
+	if (copy === void 0) return config;
+	return {
+		...config,
+		name: copy.name,
+		description: copy.description
+	};
+}
+/** Drop-in replacement for `@deepseek-ai/dsh-agent-preset`. */
+var LocalizedAgentPreset = class {
+	static inject = ["agentPresets"];
+	/** Preserve child expressions until their own plugins activate. */
+	static [EntryGroup.key] = true;
+	static Config = z.object({
+		id: z.string().required(),
+		name: z.string(),
+		description: z.string(),
+		order: z.number(),
+		plugins: z.array(z.any()).required()
+	});
+	ctx;
+	config;
+	constructor(ctx, config) {
+		this.ctx = ctx;
+		this.config = localizePresetConfig(ctx, config);
+	}
+	async *[Service.init]() {
+		yield await this.ctx.agentPresets.register(this.config);
+	}
+};
+export { LocalizedAgentPreset as default, localizePresetConfig, readWebUiLocale };