dsh-pstack 0.2.0-beta.1 → 0.2.0-beta.3

package/dist/index.mjs

@@ -1,36 +1,200 @@
-import { a as SKILLS_ROOT, n as HARNESS_DOC_PATH, r as PACKAGE_ROOT, t as ASSETS_ROOT } from "./paths-D_JlVmBk.mjs";
-import { a as SKILL_CONSUMED_FIELDS, c as parseFrontmatter, d as skillDroppedFields, f as validateAgentFrontmatter, i as MAX_SKILL_NAME_LENGTH, l as serializeAgentFrontmatter, n as AGENT_DROPPED_FIELDS, o as SKILL_DROPPED_FIELDS, p as validateSkillFrontmatter, r as FrontmatterError, s as agentDroppedFields, t as AGENT_CONSUMED_FIELDS, u as serializeSkillFrontmatter } from "./frontmatter-BQX3ekwP.mjs";
-import { join } from "node:path";
+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-BT77khwm.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";
-//#region src/provider.ts
+// 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
+};
 /**
-* The bundled pstack skill provider: one provider over the 55 generated skills
-* that ship inside this package.
-*
-* The provider contract below mirrors `@deepseek-ai/dsh-skill` 0.2.1-rc.3, which
-* was read through the host Inspect provider (`Service.listService` with
-* `service: "skills"`) and the installed type declarations. It is restated here
-* as a structural contract instead of imported so the plugin keeps zero runtime
-* imports from the host packages: a workspace-directory bundle is linked from
-* its checkout, where `@deepseek-ai/*` is not resolvable.
+* Register the placement rule, tolerating a host without `systemPrompt`.
 *
-* Design constraints this module enforces, from the port design document §8.1:
-*
-* - The catalog is built once from the package assets and never watched. A
-*   package update is the refresh boundary.
-* - A malformed bundled skill fails the whole index instead of disappearing
-*   from the catalog, so a broken asset is a startup error rather than a skill
-*   users silently cannot see.
-* - `get()` only accepts a locator this provider produced. Directory names are
-*   never joined from caller input.
+* 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
 /**
-* Standard precedence rank for packaged skill providers, re-exported by
-* `@deepseek-ai/dsh-skill` as `BUNDLED_SKILL_RANK`. Restated to keep the package
-* dependency-free; a mismatch only changes which provider wins a name collision.
+* 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 used when the row does not override it. */
+/** Default provider name. */
 const DEFAULT_PROVIDER_NAME = "pstack";
 /** Raised when a bundled asset violates the provider contract. */
 var BundledSkillError = class extends Error {
@@ -40,31 +204,31 @@ var BundledSkillError = class extends Error {
 	}
 };
 /**
-* Read and validate every bundled skill below one directory.
-*
-* This is the startup check: it runs before the provider registers, so a missing
-* `SKILL.md`, an invalid frontmatter block, or a name that disagrees with its
-* directory fails plugin activation with a path-qualified message instead of
-* dropping a skill from the catalog.
+* Read and validate every bundled skill under every root.
 *
-* @param skillsRoot - absolute path of the directory holding the skill directories.
-* @returns validated skills keyed by absolute skill directory, sorted by name.
-* @throws {BundledSkillError} when the tree or any skill in it is malformed.
+* 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 loadBundledSkillIndex(skillsRoot) {
-	let entries;
-	try {
-		entries = readdirSync(skillsRoot, { withFileTypes: true });
-	} catch (error) {
-		throw new BundledSkillError(`bundled skills: cannot read "${skillsRoot}": ${messageOf(error)}`);
+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 entry of entries.sort((left, right) => left.name < right.name ? -1 : 1)) {
-		const directory = join(skillsRoot, entry.name);
-		if (!entry.isDirectory()) throw new BundledSkillError(`bundled skills: "${directory}" is not a skill directory; remove it or add a SKILL.md`);
+	for (const directory of discoverSkillDirectories(root.path)) {
 		const instructionFile = join(directory, "SKILL.md");
 		const frontmatter = readSkillFrontmatter(readSkillFile(instructionFile), instructionFile);
-		if (frontmatter.name !== entry.name) throw new BundledSkillError(`${instructionFile}: skill name "${frontmatter.name}" does not match its directory "${entry.name}"`);
+		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,
@@ -77,15 +241,28 @@ function loadBundledSkillIndex(skillsRoot) {
 			instructionFile
 		});
 	}
-	if (index.size === 0) throw new BundledSkillError(`bundled skills: no skill directories under "${skillsRoot}"`);
 	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.
 *
-* @param index - result of {@link loadBundledSkillIndex}.
-* @param providerName - registry name for this provider.
-* @returns a read-only provider whose catalog never changes until the package does.
+* 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);
@@ -139,19 +316,6 @@ function createPstackSkillProvider(index, providerName = DEFAULT_PROVIDER_NAME)
 		}
 	};
 }
-/**
-* Load the index and build the provider in one step, failing on a malformed tree.
-*
-* `apply()` uses this exact function, so the startup failure path and the
-* provider used in tests are the same code.
-*
-* @param skillsRoot - absolute path of the bundled skill root.
-* @param providerName - registry name for this provider.
-* @returns the provider over the validated index.
-*/
-function createPstackSkillProviderFromRoot(skillsRoot, providerName = DEFAULT_PROVIDER_NAME) {
-	return createPstackSkillProvider(loadBundledSkillIndex(skillsRoot), providerName);
-}
 function asBundledSkillLocator(locator) {
 	if (typeof locator !== "object" || locator === null) return void 0;
 	const candidate = locator;
@@ -171,7 +335,6 @@ function readSkillFile(instructionFile) {
 		throw new BundledSkillError(`bundled skills: cannot read "${instructionFile}": ${messageOf(error)}`);
 	}
 }
-/** Parse and validate one skill header, reporting failures as bundled-asset errors. */
 function readSkillFrontmatter(text, instructionFile) {
 	try {
 		const { data } = parseFrontmatter(text);
@@ -201,72 +364,36 @@ function errorCode(error) {
 function messageOf(error) {
 	return error instanceof Error ? error.message : String(error);
 }
-//#endregion
-//#region src/index.ts
+// src/index.ts
 /**
-* dsh-pstack Host entry.
+* dsh-pstack Host entry: the bundled skill provider and `pstack_skill`.
 *
-* Unit 2 ships one minimal capability: a single `ctx.skills` provider over the
-* generated assets in this package. Delegation, restricted history, roles, and
-* the worktree integration are later units and are deliberately absent here.
+* 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.
 *
-* The provider contract types live in `./provider.ts` and are structural copies
-* of the `@deepseek-ai/dsh-skill` 0.2.1-rc.3 declarations, so this module imports
-* nothing from the host packages at runtime.
+* `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.
 */
-/** Plugin name used by Loader diagnostics for this row. */
+/** Cordis row name, used by Loader diagnostics. */
 const name = "pstack";
-/** The provider needs the skill registry and nothing else. */
-const inject = ["skills"];
+/** The row needs the skill registry and the tool registry. */
+const inject = ["skills", "tools"];
 /**
-* Minimal Standard Schema validator for this plugin's row config.
-*
-* Cordis validates `apply()`'s second argument with `Config["~standard"]` and
-* substitutes the returned `value`, so an omitted row `config` resolves to the
-* documented defaults without a schemastery dependency.
-*/
-const Config = { "~standard": {
-	version: 1,
-	vendor: "dsh-pstack",
-	validate(value) {
-		if (value === void 0 || value === null) return { value: { providerName: DEFAULT_PROVIDER_NAME } };
-		if (typeof value !== "object" || Array.isArray(value)) return { issues: [{ message: "config must be a mapping" }] };
-		const issues = [];
-		const record = value;
-		for (const key of Object.keys(record)) if (key !== "providerName") issues.push({
-			message: `unknown field "${key}"`,
-			path: [key]
-		});
-		const providerName = record["providerName"];
-		if (providerName === void 0) return issues.length > 0 ? { issues } : { value: { providerName: DEFAULT_PROVIDER_NAME } };
-		if (typeof providerName !== "string" || providerName.trim() === "") {
-			issues.push({
-				message: "providerName must be a non-empty string",
-				path: ["providerName"]
-			});
-			return { issues };
-		}
-		return issues.length > 0 ? { issues } : { value: { providerName } };
-	}
-} };
-/**
-* Register the bundled pstack skill provider.
-*
-* The bundled tree is validated before the provider registers, so a malformed
-* `SKILL.md` fails plugin activation with a path-qualified error instead of
-* removing one skill from the catalog. Nothing is copied out of the package and
-* nothing is watched: reinstalling the package is the refresh boundary.
+* Register the bundled pstack skill provider and the trusted loader.
 *
-* @param ctx - host context carrying the skill registry.
-* @param config - validated row config.
-* @throws {import("./provider.ts").BundledSkillError} when the bundled tree is malformed.
+* @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, config = {}) {
-	const providerName = config.providerName ?? "pstack";
-	const index = loadBundledSkillIndex(SKILLS_ROOT);
-	ctx.skills.registerProvider((_control) => createPstackSkillProvider(index, providerName));
+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
+	});
 }
-//#endregion
-export { AGENT_CONSUMED_FIELDS, AGENT_DROPPED_FIELDS, ASSETS_ROOT, BUNDLED_SKILL_RANK, BundledSkillError, Config, DEFAULT_PROVIDER_NAME, FrontmatterError, HARNESS_DOC_PATH, MAX_SKILL_NAME_LENGTH, PACKAGE_ROOT, SKILLS_ROOT, SKILL_CONSUMED_FIELDS, SKILL_DROPPED_FIELDS, agentDroppedFields, apply, createPstackSkillProvider, createPstackSkillProviderFromRoot, inject, loadBundledSkillIndex, name, parseFrontmatter, serializeAgentFrontmatter, serializeSkillFrontmatter, skillDroppedFields, validateAgentFrontmatter, validateSkillFrontmatter };
-
-//# sourceMappingURL=index.mjs.map
+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 };

package/dist/models.d.mts

@@ -0,0 +1,44 @@
+import { _ as ToolsHost, g as ToolDefinition, s as LlmHost } from "./host-contract-CUPSpeNk.mjs";
+/** Cordis row name, used by Loader diagnostics. */
+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>;
+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;