dsh-pstack 0.3.0-beta.1 → 0.3.1

package/dist/index.d.mts

@@ -1,89 +1,4 @@
-import { _ as ToolsHost, d as SkillProvider, f as SkillProviderControl, u as SkillInvocationPolicy } from "./host-contract-CUPSpeNk.mjs";
-import { LoadSkillResult, SkillResourceResult, SkillsHost, TOOL_NAME, createPstackSkillTool, readSkillResource, renderLoadedSkill } from "./skill.mjs";
-/**
- * Package-internal resource locations.
- *
- * Every shipped resource is read from `dist/` and nowhere else. The bundler writes the
- * public entries at `dist/*.mjs` and shared helper chunks under `dist/internal/`, the
- * pstack build writes `dist/pstack/`, and the packaging step writes `dist/skills/`.
- *
- * `PACKAGE_ROOT` therefore sits either one level above this module (an entry bundle in
- * `dist/`) or two (a helper chunk in `dist/internal/`). Both layouts are known, so the
- * directory name decides instead of probing for `dist` first and falling back.
- */
-/** Absolute path of the package root. */
-export declare const PACKAGE_ROOT: string;
-/** Absolute path of the generated pstack tree. */
-export declare const PORT_ROOT: string;
-/** Absolute path of the ported pstack skill directories. */
-export declare const SKILLS_ROOT: string;
-/** Absolute path of the vendored skill directories (`skills/vendored` at pack time). */
-export declare const VENDORED_SKILLS_ROOT: string;
-/** Absolute path of the skills authored in this repository. */
-export declare const AUTHORED_SKILLS_ROOT: string;
-/** Absolute path of the shipped harness mapping document. */
-export declare const HARNESS_DOC_PATH: string;
-/** One skill root the provider loads, labelled for collision errors. */
-interface SkillRoot {
-  readonly path: string;
-  readonly label: string;
-}
-/** Every skill root, in load order. Recursive discovery handles each root's nesting. */
-export declare const SKILL_ROOTS: readonly SkillRoot[];
-/** Standard precedence rank for packaged skill providers. */
-export declare const BUNDLED_SKILL_RANK = 600;
-/** Default provider name. */
-export declare const DEFAULT_PROVIDER_NAME = "pstack";
-/** One validated on-disk bundled skill. */
-interface BundledSkill {
-  readonly name: string;
-  readonly description: string;
-  readonly whenToUse?: string;
-  readonly invocation: SkillInvocationPolicy;
-  /** Absolute skill directory; also the resource base. */
-  readonly directory: string;
-  /** Absolute `SKILL.md` path. */
-  readonly instructionFile: string;
-}
-/** Validated skills keyed by their absolute directory. */
-type BundledSkillIndex = ReadonlyMap<string, BundledSkill>;
-/** Raised when a bundled asset violates the provider contract. */
-export declare class BundledSkillError extends Error {
-  constructor(message: string);
-}
-/**
- * Read and validate every bundled skill under every root.
- *
- * A skill name may appear in only one root; a duplicate is a packaging mistake, so it
- * fails activation rather than letting one silently shadow the other. A root that does
- * not exist is skipped, but an empty merged catalog fails.
- */
-export declare function loadBundledSkillIndexes(roots: readonly SkillRoot[]): BundledSkillIndex;
-/**
- * Build the provider over an already validated index.
- *
- * The catalog is sorted by name so two installs present the same order, and it never
- * changes until the package does.
- */
-export declare function createPstackSkillProvider(index: BundledSkillIndex, providerName?: string): SkillProvider;
-/** Cordis row name, used by Loader diagnostics. */
+import { Context } from "@deepseek-ai/cordis";
 export declare const name = "pstack";
-/** The row needs the skill registry and the tool registry. */
 export declare const inject: string[];
-/** The slice of the Cordis context this plugin requires. */
-export interface PstackSkillHost {
-  readonly skills: SkillsHost & {
-    registerProvider(create: (control: SkillProviderControl) => SkillProvider): () => void;
-  };
-  readonly tools: ToolsHost;
-  /** Optional-service read for `systemPrompt`; absent is fine. */
-  get?(name: string): unknown;
-}
-/**
- * Register the bundled pstack skill provider and the trusted loader.
- *
- * @param ctx - host context carrying the skill and tool registries.
- * @throws {import("./internal/skill-provider.ts").BundledSkillError} when the tree is malformed.
- */
-export declare function apply(ctx: PstackSkillHost): void;
-export { type LoadSkillResult, TOOL_NAME as PSTACK_SKILL_TOOL_NAME, type SkillResourceResult, type SkillRoot, createPstackSkillTool, readSkillResource, renderLoadedSkill };
+export declare function apply(ctx: Context): void;

package/dist/index.mjs

@@ -1,399 +1,8 @@
-import { c as VENDORED_SKILLS_ROOT, i as PORT_ROOT, n as HARNESS_DOC_PATH, o as SKILLS_ROOT, r as PACKAGE_ROOT, s as SKILL_ROOTS, t as AUTHORED_SKILLS_ROOT } from "./paths-yji9SNak.mjs";
-import { TOOL_NAME, apply as apply$1, createPstackSkillTool, readSkillResource, renderLoadedSkill } from "./skill.mjs";
-import { basename, join } from "node:path";
-import { readFileSync, readdirSync } from "node:fs";
-// src/internal/audit-context.ts
-/** Default repository-relative directory for plans, trails, and orchestration state. */
-const AUDIT_DIRECTORY = ".audit";
-const AUDIT_CONTEXT = {
-	name: "pstack:audit-store",
-	order: 500,
-	text: `pstack writes working files that are not deliverables — plans, decision trails, and orchestration state — under \`${AUDIT_DIRECTORY}/\` in the repository unless the operator names another directory. Nothing outside the repository is assigned for this, and nothing resumes from that directory on its own: a resumed or recreated child must be handed its instructions again rather than told to re-read them. \`${AUDIT_DIRECTORY}/\` stays out of version control; commit a trail only when a reviewer needs it to trust the result.`,
-	required: true
-};
-/**
-* Register the placement rule, tolerating a host without `systemPrompt`.
-*
-* The service is read through `get`, never as a property: a row whose `inject` does not
-* name `systemPrompt` would throw on property access, and index must not inject it or a
-* composition without a prompt registry would drop every bundled skill.
-*/
-function registerAuditContext(host) {
-	const registry = host.get?.("systemPrompt");
-	if (registry === void 0 || registry === null) return false;
-	const candidate = registry;
-	if (typeof candidate.context !== "function") return false;
-	candidate.context(AUDIT_CONTEXT);
-	return true;
-}
-// src/internal/frontmatter.ts
-var FrontmatterError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "FrontmatterError";
-	}
-};
-const SKILL_NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
-const MAX_SKILL_NAME_LENGTH = 64;
-/** Parse a leading `---` frontmatter block and the body after it. */
-function parseFrontmatter(source) {
-	const eol = detectEol(source);
-	const lines = (eol === "\r\n" ? source.replaceAll("\r\n", "\n") : source).split("\n");
-	if (lines[0] !== "---") throw new FrontmatterError("frontmatter: file must start with a \"---\" line");
-	const closing = lines.indexOf("---", 1);
-	if (closing === -1) throw new FrontmatterError("frontmatter: missing closing \"---\" delimiter");
-	const data = parseBlock(lines.slice(1, closing));
-	const body = lines.slice(closing + 1).join("\n");
-	return {
-		data,
-		body: eol === "\r\n" ? body.replaceAll("\n", eol) : body
-	};
-}
-/** Read the fields a skill needs, ignoring every other upstream field. */
-function validateSkillFrontmatter(data, source) {
-	const name = readName(data, source);
-	const description = readDescription(data, source);
-	const whenToUse = data["whenToUse"];
-	if (whenToUse !== void 0 && whenToUse.trim() === "") throw new FrontmatterError(`${source}: "whenToUse" must not be empty`);
-	return {
-		name,
-		description,
-		disableModelInvocation: readBoolean(data, "disable-model-invocation", source, false),
-		userInvocable: readBoolean(data, "user-invocable", source, true),
-		...whenToUse === void 0 ? {} : { whenToUse }
-	};
-}
-function detectEol(source) {
-	if (!source.includes("\r\n")) return "\n";
-	const withoutCrlf = source.replaceAll("\r\n", "");
-	if (withoutCrlf.includes("\r") || withoutCrlf.includes("\n")) throw new FrontmatterError("frontmatter: mixed line endings are not supported");
-	return "\r\n";
-}
-function parseBlock(lines) {
-	const data = {};
-	for (let index = 0; index < lines.length; index += 1) {
-		const line = lines[index];
-		const trimmed = line.trim();
-		if (trimmed === "" || trimmed.startsWith("#")) continue;
-		if (trimmed !== line) throw new FrontmatterError(`frontmatter: unexpected indented line "${trimmed}"`);
-		const entry = /^([A-Za-z_][A-Za-z0-9_-]*):(.*)$/.exec(line);
-		if (entry === null) throw new FrontmatterError(`frontmatter: expected "key: value", got "${line}"`);
-		const key = entry[1];
-		const rest = entry[2];
-		if (rest !== "" && !rest.startsWith(" ")) throw new FrontmatterError(`frontmatter: missing space after "${key}:"`);
-		if (Object.hasOwn(data, key)) throw new FrontmatterError(`frontmatter: duplicate key "${key}"`);
-		const raw = rest.trim();
-		if (raw === ">" || raw === ">-" || raw === "|" || raw === "|-") {
-			const block = [];
-			let cursor = index + 1;
-			while (cursor < lines.length) {
-				const candidate = lines[cursor];
-				if (candidate.trim() !== "" && !candidate.startsWith(" ") && !candidate.startsWith("	")) break;
-				block.push(candidate);
-				cursor += 1;
-			}
-			while (block.length > 0 && block.at(-1).trim() === "") block.pop();
-			if (block.length === 0) throw new FrontmatterError(`frontmatter: "${key}" has an empty ${raw} block`);
-			data[key] = parseBlockScalar(block, raw, key);
-			index = cursor - 1;
-			continue;
-		}
-		data[key] = parseScalar(raw, key);
-	}
-	return data;
-}
-function parseScalar(raw, key) {
-	if (raw === "") return "";
-	if (raw.startsWith("\"")) return parseDoubleQuoted(raw, key);
-	if (raw.startsWith("'")) return parseSingleQuoted(raw, key);
-	return raw;
-}
-function parseDoubleQuoted(raw, key) {
-	if (raw.length < 2 || !raw.endsWith("\"")) throw new FrontmatterError(`frontmatter: unterminated double-quoted value for "${key}"`);
-	const inner = raw.slice(1, -1);
-	let value = "";
-	for (let index = 0; index < inner.length; index += 1) {
-		const character = inner[index];
-		if (character !== "\\") {
-			value += character;
-			continue;
-		}
-		const escaped = inner[index += 1];
-		if (escaped === "\"") value += "\"";
-		else if (escaped === "\\") value += "\\";
-		else if (escaped === "n") value += "\n";
-		else throw new FrontmatterError(`frontmatter: unsupported escape "\\${escaped ?? ""}" in "${key}"`);
-	}
-	return value;
-}
-function parseSingleQuoted(raw, key) {
-	if (raw.length < 2 || !raw.endsWith("'")) throw new FrontmatterError(`frontmatter: unterminated single-quoted value for "${key}"`);
-	const inner = raw.slice(1, -1);
-	let value = "";
-	for (let index = 0; index < inner.length; index += 1) {
-		const character = inner[index];
-		if (character !== "'") {
-			value += character;
-			continue;
-		}
-		if (inner[index + 1] === "'") {
-			value += "'";
-			index += 1;
-			continue;
-		}
-		throw new FrontmatterError(`frontmatter: unescaped single quote in "${key}"`);
-	}
-	return value;
-}
-function parseBlockScalar(lines, indicator, key) {
-	const indents = lines.filter((line) => line.trim() !== "").map((line) => /^\s*/.exec(line)[0].length);
-	const indent = Math.min(...indents);
-	const content = lines.map((line) => line.trim() === "" ? "" : line.slice(indent));
-	const text = indicator.startsWith("|") ? content.join("\n") : fold(content);
-	if (text.trim() === "") throw new FrontmatterError(`frontmatter: "${key}" block is empty`);
-	return indicator.endsWith("-") ? text : `${text}\n`;
-}
-function fold(lines) {
-	const paragraphs = [[]];
-	for (const line of lines) if (line === "") paragraphs.push([]);
-	else paragraphs.at(-1).push(line);
-	return paragraphs.map((paragraph) => paragraph.join(" ")).join("\n");
-}
-function readName(data, source) {
-	const value = data["name"];
-	if (value === void 0 || value.trim() === "") throw new FrontmatterError(`${source}: missing "name"`);
-	if (!SKILL_NAME_PATTERN.test(value)) throw new FrontmatterError(`${source}: "name" must be kebab-case, got "${value}"`);
-	if (value.length > MAX_SKILL_NAME_LENGTH) throw new FrontmatterError(`${source}: "name" is longer than ${MAX_SKILL_NAME_LENGTH} characters`);
-	return value;
-}
-function readDescription(data, source) {
-	const value = data["description"];
-	if (value === void 0 || value.trim() === "") throw new FrontmatterError(`${source}: missing "description"`);
-	return value;
-}
-function readBoolean(data, key, source, fallback) {
-	const value = data[key];
-	if (value === void 0) return fallback;
-	if (value === "true") return true;
-	if (value === "false") return false;
-	throw new FrontmatterError(`${source}: "${key}" must be true or false, got "${value}"`);
-}
-// src/internal/skill-provider.ts
-/**
-* The bundled pstack skill provider: one provider over the generated skills and the
-* independent skill trees that ship inside this package.
-*
-* Roots hold skills at different depths (`pstack/skills/<skill>`,
-* `skills/vendored/<source>/<skill>`, `skills/authored/<skill>`), so discovery walks
-* down until it finds a directory with a `SKILL.md` and stops there. A malformed
-* bundled skill fails the whole index instead of disappearing from the catalog: a
-* broken asset is a startup error, not a skill users silently cannot see.
-*
-* `get()` accepts only a locator this provider produced, so a caller cannot name an
-* arbitrary path.
-*/
-/** Standard precedence rank for packaged skill providers. */
-const BUNDLED_SKILL_RANK = 600;
-/** Default provider name. */
-const DEFAULT_PROVIDER_NAME = "pstack";
-/** Raised when a bundled asset violates the provider contract. */
-var BundledSkillError = class extends Error {
-	constructor(message) {
-		super(message);
-		this.name = "BundledSkillError";
-	}
-};
-/**
-* Read and validate every bundled skill under every root.
-*
-* A skill name may appear in only one root; a duplicate is a packaging mistake, so it
-* fails activation rather than letting one silently shadow the other. A root that does
-* not exist is skipped, but an empty merged catalog fails.
-*/
-function loadBundledSkillIndexes(roots) {
-	const merged = /* @__PURE__ */ new Map();
-	const byName = /* @__PURE__ */ new Map();
-	for (const root of roots) for (const skill of loadRoot(root).values()) {
-		const previous = byName.get(skill.name);
-		if (previous !== void 0) throw new BundledSkillError(`bundled skills: "${skill.name}" is offered by both "${previous}" and "${skill.directory}"; one name belongs to one source`);
-		byName.set(skill.name, skill.directory);
-		merged.set(skill.directory, skill);
-	}
-	if (merged.size === 0) throw new BundledSkillError(`bundled skills: no skill directories under ${roots.map((root) => `"${root.path}"`).join(", ")}`);
-	return merged;
-}
-/** Validate every skill under one root. */
-function loadRoot(root) {
-	const index = /* @__PURE__ */ new Map();
-	for (const directory of discoverSkillDirectories(root.path)) {
-		const instructionFile = join(directory, "SKILL.md");
-		const frontmatter = readSkillFrontmatter(readSkillFile(instructionFile), instructionFile);
-		if (frontmatter.name !== basename(directory)) throw new BundledSkillError(`${instructionFile}: skill name "${frontmatter.name}" does not match its directory "${basename(directory)}"`);
-		index.set(directory, {
-			name: frontmatter.name,
-			description: frontmatter.description,
-			...frontmatter.whenToUse === void 0 ? {} : { whenToUse: frontmatter.whenToUse },
-			invocation: {
-				modelInvocable: !frontmatter.disableModelInvocation,
-				userInvocable: frontmatter.userInvocable
-			},
-			directory,
-			instructionFile
-		});
-	}
-	return index;
-}
-/** Directories that hold a `SKILL.md`, discovered recursively. A found skill is a leaf. */
-function discoverSkillDirectories(root) {
-	let entries;
-	try {
-		entries = readdirSync(root, { withFileTypes: true });
-	} catch (error) {
-		if (errorCode(error) === "ENOENT") return [];
-		throw new BundledSkillError(`bundled skills: cannot read "${root}": ${messageOf(error)}`);
-	}
-	if (entries.some((entry) => entry.isFile() && entry.name === "SKILL.md")) return [root];
-	const found = [];
-	const children = entries.filter((entry) => entry.isDirectory()).sort((left, right) => left.name < right.name ? -1 : 1);
-	for (const child of children) found.push(...discoverSkillDirectories(join(root, child.name)));
-	return found;
-}
-/**
-* Build the provider over an already validated index.
-*
-* The catalog is sorted by name so two installs present the same order, and it never
-* changes until the package does.
-*/
-function createPstackSkillProvider(index, providerName = DEFAULT_PROVIDER_NAME) {
-	const ordered = [...index.values()].sort((left, right) => left.name < right.name ? -1 : left.name > right.name ? 1 : 0);
-	return {
-		name: providerName,
-		async list(options) {
-			throwIfAborted(options?.signal);
-			return ordered.map((skill) => ({
-				name: skill.name,
-				description: skill.description,
-				...skill.whenToUse === void 0 ? {} : { whenToUse: skill.whenToUse },
-				invocation: skill.invocation,
-				source: "bundled",
-				provider: providerName,
-				rank: 600,
-				locator: {
-					kind: "bundled-skill",
-					directory: skill.directory,
-					instructionFile: skill.instructionFile
-				},
-				path: skill.instructionFile,
-				resourceBase: {
-					kind: "directory",
-					path: skill.directory
-				}
-			}));
-		},
-		async get(candidate, options) {
-			const locator = asBundledSkillLocator(candidate.locator);
-			if (locator === void 0) return void 0;
-			const skill = index.get(locator.directory);
-			if (skill === void 0 || skill.instructionFile !== locator.instructionFile || skill.name !== candidate.name) return;
-			throwIfAborted(options?.signal);
-			const text = readOptionalSkillFile(skill.instructionFile);
-			if (text === void 0) return void 0;
-			const { body } = parseFrontmatter(text);
-			return {
-				name: skill.name,
-				description: skill.description,
-				...skill.whenToUse === void 0 ? {} : { whenToUse: skill.whenToUse },
-				invocation: skill.invocation,
-				source: "bundled",
-				provider: providerName,
-				path: skill.instructionFile,
-				resourceBase: {
-					kind: "directory",
-					path: skill.directory
-				},
-				content: body
-			};
-		}
-	};
-}
-function asBundledSkillLocator(locator) {
-	if (typeof locator !== "object" || locator === null) return void 0;
-	const candidate = locator;
-	if (candidate.kind !== "bundled-skill") return void 0;
-	if (typeof candidate.directory !== "string") return void 0;
-	if (typeof candidate.instructionFile !== "string") return void 0;
-	return {
-		kind: "bundled-skill",
-		directory: candidate.directory,
-		instructionFile: candidate.instructionFile
-	};
-}
-function readSkillFile(instructionFile) {
-	try {
-		return readFileSync(instructionFile, "utf8");
-	} catch (error) {
-		throw new BundledSkillError(`bundled skills: cannot read "${instructionFile}": ${messageOf(error)}`);
-	}
-}
-function readSkillFrontmatter(text, instructionFile) {
-	try {
-		const { data } = parseFrontmatter(text);
-		return validateSkillFrontmatter(data, instructionFile);
-	} catch (error) {
-		const message = messageOf(error);
-		throw new BundledSkillError(message.includes(instructionFile) ? message : `${instructionFile}: ${message}`);
-	}
-}
-function readOptionalSkillFile(instructionFile) {
-	try {
-		return readFileSync(instructionFile, "utf8");
-	} catch (error) {
-		if (errorCode(error) === "ENOENT") return void 0;
-		throw error;
-	}
-}
-function throwIfAborted(signal) {
-	if (signal?.aborted !== true) return;
-	throw signal.reason ?? /* @__PURE__ */ new Error("skill provider work was aborted");
-}
-function errorCode(error) {
-	if (typeof error !== "object" || error === null) return void 0;
-	const code = error.code;
-	return typeof code === "string" ? code : void 0;
-}
-function messageOf(error) {
-	return error instanceof Error ? error.message : String(error);
-}
+import { apply as apply$1 } from "./skill.mjs";
 // src/index.ts
-/**
-* dsh-pstack Host entry: the bundled skill provider and `pstack_skill`.
-*
-* One `ctx.skills` provider serves the generated pstack tree and the independent skill
-* trees. The catalog is built once at activation and never watched; reinstalling the
-* package is the refresh boundary. A malformed bundled skill fails activation with a
-* path-qualified error instead of removing one skill from the catalog.
-*
-* `pstack_skill` is registered from the same row because it is the other half of the
-* provider: the provider keeps hidden skills out of the model catalog, and the tool
-* gives trusted pstack routing a way to load them by name.
-*/
-/** Cordis row name, used by Loader diagnostics. */
 const name = "pstack";
-/** The row needs the skill registry and the tool registry. */
 const inject = ["skills", "tools"];
-/**
-* Register the bundled pstack skill provider and the trusted loader.
-*
-* @param ctx - host context carrying the skill and tool registries.
-* @throws {import("./internal/skill-provider.ts").BundledSkillError} when the tree is malformed.
-*/
 function apply(ctx) {
-	const index = loadBundledSkillIndexes(SKILL_ROOTS);
-	ctx.skills.registerProvider((_control) => createPstackSkillProvider(index, DEFAULT_PROVIDER_NAME));
-	registerAuditContext(ctx);
-	apply$1({
-		skills: ctx.skills,
-		tools: ctx.tools
-	});
+	apply$1(ctx);
 }
-export { AUTHORED_SKILLS_ROOT, BUNDLED_SKILL_RANK, BundledSkillError, DEFAULT_PROVIDER_NAME, HARNESS_DOC_PATH, PACKAGE_ROOT, PORT_ROOT, TOOL_NAME as PSTACK_SKILL_TOOL_NAME, SKILLS_ROOT, SKILL_ROOTS, VENDORED_SKILLS_ROOT, apply, createPstackSkillProvider, createPstackSkillTool, inject, loadBundledSkillIndexes, name, readSkillResource, renderLoadedSkill };
+export { apply, inject, name };

package/dist/models.d.mts

@@ -1,44 +1,15 @@
-import { _ as ToolsHost, g as ToolDefinition, s as LlmHost } from "./host-contract-CUPSpeNk.mjs";
-/** Cordis row name, used by Loader diagnostics. */
+import { i as ProviderEntry, n as CatalogueResult, r as ModelEntry } from "./catalogue-wgVaGeUx.mjs";
+import { Context } from "@deepseek-ai/cordis";
+import { ToolDefinition } from "@deepseek-ai/dsh-tools";
+import { LlmRuntime } from "@deepseek-ai/dsh-llm";
 export declare const name = "pstack-models";
-/** The hard dependencies: the adapter registry and the tool registry. */
 export declare const inject: string[];
-/** Model-facing tool name. */
 export declare const TOOL_NAME = "pstack_models";
-export interface ModelEntry {
-  /** `<provider>/<model>`, the exact route a role line writes. */
-  readonly route: string;
-  readonly id: string;
-  readonly name: string;
-  readonly description?: string;
-  readonly contextWindow?: number;
-  readonly maxTokens?: number;
-  /** Advertised reasoning efforts, in the adapter's least-to-greatest order. */
-  readonly efforts: readonly string[];
-  readonly defaultEffort?: string;
-  /** Set when this one model could not be resolved; the route is still listed. */
-  readonly error?: string;
-}
-export interface ProviderEntry {
-  readonly provider: string;
-  readonly name: string;
-  readonly models: readonly ModelEntry[];
-  /** Set when this provider's model list could not be read. */
-  readonly error?: string;
-}
-export interface CatalogueResult {
-  readonly providers: readonly ProviderEntry[];
-  readonly truncated: boolean;
-  readonly providerFilter?: string;
-}
-/** Collect the catalogue from the live adapters. */
-export declare function collectCatalogue(llm: LlmHost, providerFilter: string | undefined, signal: AbortSignal): Promise<CatalogueResult>;
+/** Collect the live catalogue with bounded provider/model counts. */
+export declare function collectCatalogue(llm: LlmRuntime, providerFilter: string | undefined, signal: AbortSignal): Promise<CatalogueResult>;
+/** Render the catalogue as compact model-facing text. */
 export declare function renderCatalogue(result: CatalogueResult): string;
-export declare function createPstackModelsTool(llm: LlmHost): ToolDefinition;
-/** The slice of the Cordis context this row uses. */
-export interface PstackModelsHost {
-  readonly llm: LlmHost;
-  readonly tools: ToolsHost;
-}
-/** Register `pstack_models`. */
-export declare function apply(ctx: PstackModelsHost): void;
+/** Build `pstack_models` for one LLM service. */
+export declare function createPstackModelsTool(llm: LlmRuntime): ToolDefinition;
+export declare function apply(ctx: Context): void;
+export type { CatalogueResult, ModelEntry, ProviderEntry };