@zihanw/pi-forge 0.3.2 → 0.4.0-beta.1

package/src/web-editor/server.ts

@@ -1,294 +0,0 @@
-import { randomBytes } from "node:crypto";
-import { createServer, type IncomingMessage, type Server, type ServerResponse } from "node:http";
-import type { Socket } from "node:net";
-
-import { convertSillyTavernPreset } from "../sillytavern-importer.ts";
-import type { PromptStack } from "../types.ts";
-import { renderEditorHtml } from "./page.ts";
-import type { WebEditorHost, WebEditorOperationResult, WebEditorServer, WebEditorServerOptions } from "./types.ts";
-
-// Port 0 asks Node to bind any available localhost port.
-export const DEFAULT_WEB_EDITOR_PORT = 0;
-
-export async function startWebEditorServer(host: WebEditorHost, options: WebEditorServerOptions = {}): Promise<WebEditorServer> {
-	let currentHost = host;
-	const token = randomBytes(24).toString("base64url");
-	const sockets = new Set<Socket>();
-	const server = createServer((req, res) => {
-		void handleRequest(currentHost, token, req, res).catch((error) => {
-			sendJson(res, 500, { error: error instanceof Error ? error.message : String(error) });
-		});
-	});
-	server.on("connection", (socket) => {
-		sockets.add(socket);
-		socket.on("close", () => sockets.delete(socket));
-	});
-
-	await new Promise<void>((resolve, reject) => {
-		server.once("error", reject);
-		server.listen(options.port ?? DEFAULT_WEB_EDITOR_PORT, "127.0.0.1", () => {
-			server.off("error", reject);
-			resolve();
-		});
-	});
-
-	const address = server.address();
-	if (!address || typeof address === "string") {
-		await closeServer(server, sockets);
-		throw new Error("Failed to start pi-forge editor server.");
-	}
-
-	const url = `http://127.0.0.1:${address.port}/?token=${encodeURIComponent(token)}`;
-	return {
-		url,
-		port: address.port,
-		updateHost: (nextHost) => {
-			currentHost = nextHost;
-		},
-		close: () => closeServer(server, sockets),
-	};
-}
-
-async function handleRequest(host: WebEditorHost, token: string, req: IncomingMessage, res: ServerResponse): Promise<void> {
-	const url = new URL(req.url ?? "/", "http://127.0.0.1");
-
-	if (url.pathname === "/" && req.method === "GET") {
-		if (url.searchParams.get("token") !== token) {
-			sendText(res, 403, "Invalid pi-forge editor token.");
-			return;
-		}
-		sendHtml(res, renderEditorHtml());
-		return;
-	}
-
-	if (!url.pathname.startsWith("/api/")) {
-		sendText(res, 404, "Not found.");
-		return;
-	}
-
-	if (!hasValidToken(req, url, token)) {
-		sendJson(res, 403, { error: "Invalid pi-forge editor token." });
-		return;
-	}
-
-	const parts = url.pathname.split("/").filter(Boolean).map((part) => decodeURIComponent(part));
-
-	if (req.method === "GET" && parts[1] === "stacks" && parts.length === 2) {
-		sendJson(res, 200, { stacks: host.listStacks(), cwd: host.cwd });
-		return;
-	}
-
-	if (req.method === "GET" && parts[1] === "resources" && parts.length === 2) {
-		sendJson(res, 200, host.listResources());
-		return;
-	}
-
-	if (req.method === "POST" && parts[1] === "stacks" && parts.length === 2) {
-		const body = await readJsonBody(req);
-		const parsed = readStackPayload(body);
-		if (!parsed.ok) {
-			sendJson(res, 400, { error: parsed.error });
-			return;
-		}
-		const options = isPlainObject(body)
-			? { activate: body.activate === true, overwrite: body.overwrite === true }
-			: {};
-		const result = await host.createStack(parsed.stack, options);
-		if (result.ok && parsed.importFormat) {
-			sendJson(res, 200, { ...result, importFormat: parsed.importFormat, importReport: parsed.importReport });
-			return;
-		}
-		sendOperation(res, result);
-		return;
-	}
-
-	if (req.method === "GET" && parts[1] === "stacks" && parts.length === 3) {
-		const loaded = host.getStack(parts[2]!);
-		if (!loaded) {
-			sendJson(res, 404, { error: `Unknown prompt stack: ${parts[2]}` });
-			return;
-		}
-		sendJson(res, 200, loaded);
-		return;
-	}
-
-	if (req.method === "PUT" && parts[1] === "stacks" && parts.length === 3) {
-		const body = await readJsonBody(req);
-		const parsed = readStackPayload(body);
-		if (!parsed.ok) {
-			sendJson(res, 400, { error: parsed.error });
-			return;
-		}
-		sendOperation(res, await host.saveStack(parts[2]!, parsed.stack));
-		return;
-	}
-
-	if (req.method === "DELETE" && parts[1] === "stacks" && parts.length === 3) {
-		sendOperation(res, await host.deleteStack(parts[2]!));
-		return;
-	}
-
-	if (req.method === "POST" && parts[1] === "stacks" && parts.length === 4 && parts[3] === "validate") {
-		const body = await readJsonBody(req);
-		const parsed = readStackPayload(body);
-		if (!parsed.ok) {
-			sendJson(res, 400, { error: parsed.error });
-			return;
-		}
-		sendJson(res, 200, { diagnostics: host.validateStack(parsed.stack) });
-		return;
-	}
-
-	if (req.method === "POST" && parts[1] === "stacks" && parts.length === 4 && parts[3] === "preview") {
-		const body = await readJsonBody(req);
-		const parsed = readStackPayload(body);
-		if (!parsed.ok) {
-			sendJson(res, 400, { error: parsed.error });
-			return;
-		}
-		sendOperation(res, host.previewStack(parts[2]!, parsed.stack));
-		return;
-	}
-
-	if (req.method === "GET" && parts[1] === "payload" && parts.length === 2) {
-		sendOperation(res, host.getPayload());
-		return;
-	}
-
-	if (req.method === "POST" && parts[1] === "payload" && parts.length === 3 && parts[2] === "arm") {
-		const body = await readJsonBody(req);
-		const savePath = isPlainObject(body) && typeof body.savePath === "string" && body.savePath.trim() ? body.savePath.trim() : undefined;
-		sendOperation(res, host.armPayload(savePath));
-		return;
-	}
-
-	if (req.method === "DELETE" && parts[1] === "payload" && parts.length === 2) {
-		sendOperation(res, host.clearPayload());
-		return;
-	}
-
-	if (req.method === "POST" && parts[1] === "stacks" && parts.length === 4 && parts[3] === "activate") {
-		sendOperation(res, host.activateStack(parts[2]!));
-		return;
-	}
-
-	if (req.method === "POST" && parts[1] === "disable" && parts.length === 2) {
-		sendOperation(res, host.disableStacks());
-		return;
-	}
-
-	if (req.method === "POST" && parts[1] === "reload" && parts.length === 2) {
-		sendOperation(res, await host.reloadStacks());
-		return;
-	}
-
-	sendJson(res, 404, { error: "Unknown pi-forge editor API route." });
-}
-
-function hasValidToken(req: IncomingMessage, url: URL, token: string): boolean {
-	const header = req.headers["x-pi-forge-token"];
-	return header === token || url.searchParams.get("token") === token;
-}
-
-async function readJsonBody(req: IncomingMessage): Promise<unknown> {
-	const chunks: Buffer[] = [];
-	let size = 0;
-	const maxBytes = 2_000_000;
-
-	for await (const chunk of req) {
-		const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
-		size += buffer.length;
-		if (size > maxBytes) throw new Error("Request body is too large.");
-		chunks.push(buffer);
-	}
-
-	const text = Buffer.concat(chunks).toString("utf8");
-	return text.trim() ? JSON.parse(text) : {};
-}
-
-function readStackPayload(body: unknown): { ok: true; stack: PromptStack; importFormat?: "sillytavern"; importReport?: string } | { ok: false; error: string } {
-	const rawStack = isPlainObject(body) && "stack" in body ? body.stack : body;
-	if (!isPlainObject(rawStack)) return { ok: false, error: "Stack payload must be a JSON object." };
-
-	if (isSillyTavernPresetPayload(rawStack)) {
-		const sourceName = isPlainObject(body) && typeof body.sourceName === "string" ? body.sourceName : undefined;
-		const characterId = readCharacterId(body);
-		const result = convertSillyTavernPreset(rawStack, { sourceName, characterId });
-		if ("error" in result) return { ok: false, error: `SillyTavern import error: ${result.error}` };
-		return { ok: true, stack: result.stack, importFormat: "sillytavern", importReport: result.report };
-	}
-
-	if (typeof rawStack.id !== "string" || !rawStack.id.trim()) return { ok: false, error: "Stack id must be a non-empty string." };
-	if (!Array.isArray(rawStack.items)) return { ok: false, error: "Stack items must be an array." };
-
-	for (const [index, item] of rawStack.items.entries()) {
-		if (!isPlainObject(item)) return { ok: false, error: `Item ${index + 1} must be an object.` };
-		if (item.kind !== "block" && item.kind !== "slot") return { ok: false, error: `Item ${index + 1} kind must be block or slot.` };
-		if (typeof item.id !== "string" || !item.id.trim()) return { ok: false, error: `Item ${index + 1} id must be a non-empty string.` };
-		if (item.kind === "block" && typeof item.content !== "string") return { ok: false, error: `Block item ${item.id} content must be a string.` };
-		if (item.kind === "slot" && typeof item.slot !== "string") return { ok: false, error: `Slot item ${item.id} slot must be a string.` };
-	}
-
-	return { ok: true, stack: rawStack as unknown as PromptStack };
-}
-
-function isSillyTavernPresetPayload(value: Record<string, unknown>): boolean {
-	return Array.isArray(value.prompts) && !Array.isArray(value.items);
-}
-
-function readCharacterId(body: unknown): number | undefined {
-	if (!isPlainObject(body)) return undefined;
-	const raw = body.characterId;
-	if (typeof raw === "number" && Number.isInteger(raw)) return raw;
-	if (typeof raw === "string" && raw.trim()) {
-		const parsed = Number(raw.trim());
-		if (Number.isInteger(parsed)) return parsed;
-	}
-	return undefined;
-}
-
-function sendOperation<T>(res: ServerResponse, result: WebEditorOperationResult<T>): void {
-	if (!result.ok) {
-		sendJson(res, result.status ?? 400, { error: result.error });
-		return;
-	}
-	sendJson(res, 200, result);
-}
-
-function sendHtml(res: ServerResponse, html: string): void {
-	res.writeHead(200, {
-		"content-type": "text/html; charset=utf-8",
-		"cache-control": "no-store",
-		"connection": "close",
-	});
-	res.end(html);
-}
-
-function sendText(res: ServerResponse, status: number, text: string): void {
-	res.writeHead(status, {
-		"content-type": "text/plain; charset=utf-8",
-		"cache-control": "no-store",
-		"connection": "close",
-	});
-	res.end(text);
-}
-
-function sendJson(res: ServerResponse, status: number, value: unknown): void {
-	res.writeHead(status, {
-		"content-type": "application/json; charset=utf-8",
-		"cache-control": "no-store",
-		"connection": "close",
-	});
-	res.end(JSON.stringify(value));
-}
-
-function closeServer(server: Server, sockets: Set<Socket>): Promise<void> {
-	return new Promise((resolve, reject) => {
-		server.close((error) => error ? reject(error) : resolve());
-		for (const socket of sockets) socket.destroy();
-	});
-}
-
-function isPlainObject(value: unknown): value is Record<string, unknown> {
-	return !!value && typeof value === "object" && !Array.isArray(value);
-}

package/src/web-editor/types.ts

@@ -1,98 +0,0 @@
-import type { PromptStack, PromptStackDiagnostic } from "../types.ts";
-
-export interface WebEditorStackSummary {
-	id: string;
-	name?: string;
-	filePath: string;
-	active: boolean;
-	autoActivate?: boolean;
-	mode?: string;
-	itemCount: number;
-	errors: number;
-	warnings: number;
-	diagnostics: PromptStackDiagnostic[];
-}
-
-export interface WebEditorHost {
-	cwd: string;
-	listStacks(): WebEditorStackSummary[];
-	listResources(): WebEditorPolicyResources;
-	getStack(id: string): { stack: PromptStack; filePath: string; diagnostics: PromptStackDiagnostic[] } | undefined;
-	createStack(stack: PromptStack, options: WebEditorCreateStackOptions): Promise<WebEditorOperationResult<{ stack: WebEditorStackSummary; stacks: WebEditorStackSummary[] }>>;
-	saveStack(id: string, stack: PromptStack): Promise<WebEditorOperationResult<{ stack: WebEditorStackSummary; stacks: WebEditorStackSummary[] }>>;
-	deleteStack(id: string): Promise<WebEditorOperationResult<{ activeId?: string; stacks: WebEditorStackSummary[] }>>;
-	validateStack(stack: PromptStack): PromptStackDiagnostic[];
-	previewStack(id: string, stack: PromptStack): WebEditorOperationResult<{ text: string; preview?: WebEditorPreview; diagnostics: PromptStackDiagnostic[] }>;
-	getPayload(): WebEditorOperationResult<WebEditorPayloadSnapshot>;
-	armPayload(savePath?: string): WebEditorOperationResult<WebEditorPayloadSnapshot>;
-	clearPayload(): WebEditorOperationResult<WebEditorPayloadSnapshot>;
-	activateStack(id: string): WebEditorOperationResult<{ activeId?: string; stacks: WebEditorStackSummary[] }>;
-	disableStacks(): WebEditorOperationResult<{ activeId?: string; stacks: WebEditorStackSummary[] }>;
-	reloadStacks(): Promise<WebEditorOperationResult<{ activeId?: string; stacks: WebEditorStackSummary[] }>>;
-}
-
-export interface WebEditorPreviewSection {
-	id: string;
-	title: string;
-	role?: string;
-	content: string;
-	chars: number;
-	approxTokens: number;
-}
-
-export interface WebEditorPreview {
-	stackId: string;
-	generatedAt: string;
-	system: WebEditorPreviewSection;
-	messages: WebEditorPreviewSection[];
-	totalChars: number;
-	approxTokens: number;
-}
-
-export interface WebEditorPayloadCapture {
-	capturedAt: string;
-	stackId?: string;
-	savePath?: string;
-	payload?: unknown;
-	text: string;
-	chars: number;
-	approxTokens: number;
-	truncated: boolean;
-	error?: string;
-}
-
-export type WebEditorPayloadSnapshot =
-	| { status: "idle" }
-	| { status: "armed"; armedAt?: string; savePath?: string }
-	| { status: "captured"; capture: WebEditorPayloadCapture };
-
-export interface WebEditorCreateStackOptions {
-	activate?: boolean;
-	overwrite?: boolean;
-}
-
-export interface WebEditorPolicyResource {
-	name: string;
-	description?: string;
-	source?: string;
-	active?: boolean;
-	hidden?: boolean;
-}
-
-export interface WebEditorPolicyResources {
-	tools: WebEditorPolicyResource[];
-	skills: WebEditorPolicyResource[];
-}
-
-export type WebEditorOperationResult<T> = ({ ok: true } & T) | { ok: false; status?: number; error: string };
-
-export interface WebEditorServer {
-	url: string;
-	port: number;
-	updateHost(host: WebEditorHost): void;
-	close(): Promise<void>;
-}
-
-export interface WebEditorServerOptions {
-	port?: number;
-}

package/src/web-host.ts

@@ -1,232 +0,0 @@
-import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import type { ExtensionCommandContext } from "@earendil-works/pi-coding-agent";
-import {
-	isInsidePromptStackStorage,
-	promptStackPath,
-	validatePromptStack,
-} from "./loader.ts";
-import type { LoadedPromptStack, PromptStack, PromptStackDiagnostic } from "./types.ts";
-import type {
-	WebEditorCreateStackOptions,
-	WebEditorHost,
-	WebEditorOperationResult,
-	WebEditorPayloadSnapshot,
-	WebEditorPolicyResources,
-	WebEditorPreview,
-	WebEditorStackSummary,
-} from "./web-editor/index.ts";
-
-export interface WebHostRuntime {
-	getStacks(): LoadedPromptStack[];
-	getActive(): LoadedPromptStack | undefined;
-	getActiveId(): string | undefined;
-	getSelectedActiveId(): string | undefined;
-	setActive(id: string | undefined): boolean;
-	reloadStacks(preferredId?: string): Promise<void>;
-	buildPreview(target: LoadedPromptStack): {
-		text: string;
-		preview: WebEditorPreview;
-		diagnostics: PromptStackDiagnostic[];
-	};
-	getPolicyResources(): WebEditorPolicyResources;
-	getPayload(): WebEditorOperationResult<WebEditorPayloadSnapshot>;
-	armPayload(savePath?: string): WebEditorOperationResult<WebEditorPayloadSnapshot>;
-	clearPayload(): WebEditorOperationResult<WebEditorPayloadSnapshot>;
-}
-
-export function createWebEditorHost(ctx: ExtensionCommandContext, runtime: WebHostRuntime): WebEditorHost {
-	return {
-		cwd: ctx.cwd,
-		listStacks: () => stackSummaries(runtime.getStacks(), runtime.getActive()),
-		listResources: () => runtime.getPolicyResources(),
-		getStack: (id) => {
-			const loaded = runtime.getStacks().find((candidate) => candidate.stack.id === id);
-			return loaded ? { stack: loaded.stack, filePath: loaded.filePath, diagnostics: loaded.diagnostics } : undefined;
-		},
-		createStack: (stack, options) => createStackFile(ctx, runtime, stack, options),
-		saveStack: (id, stack) => saveStackFile(ctx, runtime, id, stack),
-		deleteStack: (id) => deleteStackFile(ctx, runtime, id),
-		validateStack: (stack) => validatePromptStack(stack),
-		previewStack: (id, stack) => {
-			const target = runtime.getStacks().find((candidate) => candidate.stack.id === id);
-			if (!target) return { ok: false, status: 404, error: `Unknown prompt stack: ${id}` };
-			const diagnostics = validatePromptStack(stack);
-			const preview = runtime.buildPreview({ stack, filePath: target.filePath, diagnostics });
-			return { ok: true, text: preview.text, preview: preview.preview, diagnostics: preview.diagnostics };
-		},
-		getPayload: () => runtime.getPayload(),
-		armPayload: (savePath) => runtime.armPayload(savePath),
-		clearPayload: () => runtime.clearPayload(),
-		activateStack: (id) => {
-			if (!runtime.setActive(id)) return { ok: false, status: 404, error: `Unknown prompt stack: ${id}` };
-			return { ok: true, activeId: runtime.getActiveId(), stacks: stackSummaries(runtime.getStacks(), runtime.getActive()) };
-		},
-		disableStacks: () => {
-			runtime.setActive("none");
-			return { ok: true, activeId: runtime.getActiveId(), stacks: stackSummaries(runtime.getStacks(), runtime.getActive()) };
-		},
-		reloadStacks: async () => {
-			await runtime.reloadStacks(runtime.getSelectedActiveId());
-			return { ok: true, activeId: runtime.getActiveId(), stacks: stackSummaries(runtime.getStacks(), runtime.getActive()) };
-		},
-	};
-}
-
-export function stackSummary(loaded: LoadedPromptStack, active: LoadedPromptStack | undefined): WebEditorStackSummary {
-	const errors = loaded.diagnostics.filter((d) => d.level === "error").length;
-	const warnings = loaded.diagnostics.filter((d) => d.level === "warning").length;
-	return {
-		id: loaded.stack.id,
-		name: loaded.stack.name,
-		filePath: loaded.filePath,
-		active: loaded === active,
-		autoActivate: loaded.stack.autoActivate,
-		mode: loaded.stack.mode ?? "replace",
-		itemCount: loaded.stack.items.length,
-		errors,
-		warnings,
-		diagnostics: loaded.diagnostics,
-	};
-}
-
-export function stackSummaries(stacks: LoadedPromptStack[], active: LoadedPromptStack | undefined): WebEditorStackSummary[] {
-	return stacks.map((loaded) => stackSummary(loaded, active));
-}
-
-export function loadWebEditorSettings(ctx: ExtensionCommandContext): { preferredPort?: number; configPath: string; warnings: string[] } {
-	const configPath = join(ctx.cwd, ".pi", "forge", "config.json");
-	if (!ctx.isProjectTrusted() || !existsSync(configPath)) {
-		return { configPath, warnings: [] };
-	}
-
-	let raw: unknown;
-	try {
-		raw = JSON.parse(readFileSync(configPath, "utf8"));
-	} catch (error) {
-		return {
-			configPath,
-			warnings: [`pi-forge: failed to read ${configPath}; using an available editor port. ${error instanceof Error ? error.message : String(error)}`],
-		};
-	}
-
-	if (!isPlainObject(raw)) {
-		return {
-			configPath,
-			warnings: [`pi-forge: ${configPath} must be a JSON object; using an available editor port.`],
-		};
-	}
-
-	const webEditorConfig = isPlainObject(raw.webEditor) ? raw.webEditor : undefined;
-	const rawPort = webEditorConfig?.port ?? raw.webEditorPort;
-	if (rawPort === undefined) return { configPath, warnings: [] };
-
-	if (typeof rawPort === "number" && Number.isInteger(rawPort) && rawPort >= 1 && rawPort <= 65535) {
-		return { preferredPort: rawPort, configPath, warnings: [] };
-	}
-
-	return {
-		configPath,
-		warnings: [`pi-forge: ${configPath} webEditor.port must be an integer from 1 to 65535; using an available editor port.`],
-	};
-}
-
-async function saveStackFile(
-	ctx: ExtensionCommandContext,
-	runtime: WebHostRuntime,
-	id: string,
-	stack: PromptStack,
-): Promise<WebEditorOperationResult<{ stack: WebEditorStackSummary; stacks: WebEditorStackSummary[] }>> {
-	if (!ctx.isProjectTrusted()) {
-		return { ok: false, status: 403, error: "Project is not trusted; refusing to save prompt stacks." };
-	}
-
-	const target = runtime.getStacks().find((candidate) => candidate.stack.id === id);
-	if (!target) return { ok: false, status: 404, error: `Unknown prompt stack: ${id}` };
-	if (!isInsidePromptStackStorage(ctx.cwd, target.filePath)) {
-		return { ok: false, status: 403, error: "Refusing to save outside prompt-stack storage." };
-	}
-
-	writeFileSync(target.filePath, `${JSON.stringify(stack, null, 2)}\n`, "utf8");
-	const preferredId = runtime.getActive()?.stack.id === id ? stack.id : runtime.getSelectedActiveId();
-	await runtime.reloadStacks(preferredId);
-	const saved = runtime.getStacks().find((candidate) => candidate.stack.id === stack.id) ?? runtime.getStacks().find((candidate) => candidate.filePath === target.filePath);
-	if (!saved) return { ok: false, status: 500, error: "Saved stack could not be reloaded." };
-	return { ok: true, stack: stackSummary(saved, runtime.getActive()), stacks: stackSummaries(runtime.getStacks(), runtime.getActive()) };
-}
-
-async function createStackFile(
-	ctx: ExtensionCommandContext,
-	runtime: WebHostRuntime,
-	stack: PromptStack,
-	options: WebEditorCreateStackOptions,
-): Promise<WebEditorOperationResult<{ stack: WebEditorStackSummary; stacks: WebEditorStackSummary[] }>> {
-	if (!ctx.isProjectTrusted()) {
-		return { ok: false, status: 403, error: "Project is not trusted; refusing to create prompt stacks." };
-	}
-
-	const idError = validateWebStackId(stack.id);
-	if (idError) return { ok: false, status: 400, error: idError };
-
-	const existingById = runtime.getStacks().find((candidate) => candidate.stack.id === stack.id);
-	if (existingById && !options.overwrite) {
-		return { ok: false, status: 409, error: `Prompt stack already exists: ${stack.id}` };
-	}
-
-	const targetPath = existingById && options.overwrite ? existingById.filePath : promptStackPath(ctx.cwd, stack.id);
-	if (!isInsidePromptStackStorage(ctx.cwd, targetPath)) {
-		return { ok: false, status: 403, error: "Refusing to create outside prompt-stack storage." };
-	}
-
-	if (!existingById && existsSync(targetPath) && !options.overwrite) {
-		return { ok: false, status: 409, error: `Prompt stack already exists: ${stack.id}` };
-	}
-
-	const previousSelection = runtime.getSelectedActiveId();
-	mkdirSync(dirname(targetPath), { recursive: true });
-	writeFileSync(targetPath, `${JSON.stringify(stack, null, 2)}\n`, "utf8");
-	await runtime.reloadStacks(options.activate ? stack.id : (previousSelection ?? "none"));
-	if (options.activate) runtime.setActive(stack.id);
-
-	const created = runtime.getStacks().find((candidate) => candidate.stack.id === stack.id);
-	if (!created) return { ok: false, status: 500, error: "Created stack could not be reloaded." };
-	return { ok: true, stack: stackSummary(created, runtime.getActive()), stacks: stackSummaries(runtime.getStacks(), runtime.getActive()) };
-}
-
-async function deleteStackFile(
-	ctx: ExtensionCommandContext,
-	runtime: WebHostRuntime,
-	id: string,
-): Promise<WebEditorOperationResult<{ activeId?: string; stacks: WebEditorStackSummary[] }>> {
-	if (!ctx.isProjectTrusted()) {
-		return { ok: false, status: 403, error: "Project is not trusted; refusing to delete prompt stacks." };
-	}
-
-	const target = runtime.getStacks().find((candidate) => candidate.stack.id === id);
-	if (!target) return { ok: false, status: 404, error: `Unknown prompt stack: ${id}` };
-	if (!isInsidePromptStackStorage(ctx.cwd, target.filePath)) {
-		return { ok: false, status: 403, error: "Refusing to delete outside prompt-stack storage." };
-	}
-
-	const wasActive = runtime.getActive()?.stack.id === id;
-	unlinkSync(target.filePath);
-	if (wasActive) {
-		runtime.setActive("none");
-		await runtime.reloadStacks("none");
-	} else {
-		await runtime.reloadStacks(runtime.getSelectedActiveId());
-	}
-	return { ok: true, activeId: runtime.getActiveId(), stacks: stackSummaries(runtime.getStacks(), runtime.getActive()) };
-}
-
-function validateWebStackId(id: string): string | undefined {
-	if (!id.trim()) return "Stack id must not be empty.";
-	if (!/^[A-Za-z0-9_-]+$/.test(id)) {
-		return "Stack id may only contain letters, numbers, underscore, and dash.";
-	}
-	return undefined;
-}
-
-function isPlainObject(value: unknown): value is Record<string, unknown> {
-	return !!value && typeof value === "object" && !Array.isArray(value);
-}