acrylblends 1.0.4 → 1.0.5

package/lib/utils/mime.js

@@ -1,77 +1,2 @@
-//#region ../../plugins/acryl-router/src/core/utils/mime.ts
-/**
-* @module
-* MIME utility.
-*/
-const getMimeType = (filename, mimes = baseMimes) => {
-	const match = filename.match(/\.([a-zA-Z0-9]+?)$/);
-	if (!match) return;
-	return mimes[match[1].toLowerCase()];
-};
-const getExtension = (mimeType) => {
-	const baseType = mimeType.split(";", 1)[0].trim();
-	for (const ext in baseMimes) {
-		const stored = baseMimes[ext];
-		if (stored === mimeType || stored.split(";", 1)[0].trim() === baseType) return ext;
-	}
-};
-const baseMimes = {
-	aac: "audio/aac",
-	avi: "video/x-msvideo",
-	avif: "image/avif",
-	av1: "video/av1",
-	bin: "application/octet-stream",
-	bmp: "image/bmp",
-	css: "text/css; charset=utf-8",
-	csv: "text/csv; charset=utf-8",
-	eot: "application/vnd.ms-fontobject",
-	epub: "application/epub+zip",
-	gif: "image/gif",
-	gz: "application/gzip",
-	htm: "text/html; charset=utf-8",
-	html: "text/html; charset=utf-8",
-	ico: "image/x-icon",
-	ics: "text/calendar; charset=utf-8",
-	jpeg: "image/jpeg",
-	jpg: "image/jpeg",
-	js: "text/javascript; charset=utf-8",
-	json: "application/json",
-	jsonld: "application/ld+json",
-	map: "application/json",
-	mid: "audio/x-midi",
-	midi: "audio/x-midi",
-	mjs: "text/javascript; charset=utf-8",
-	mp3: "audio/mpeg",
-	mp4: "video/mp4",
-	mpeg: "video/mpeg",
-	oga: "audio/ogg",
-	ogv: "video/ogg",
-	ogx: "application/ogg",
-	opus: "audio/opus",
-	otf: "font/otf",
-	pdf: "application/pdf",
-	png: "image/png",
-	rtf: "application/rtf",
-	svg: "image/svg+xml; charset=utf-8",
-	tif: "image/tiff",
-	tiff: "image/tiff",
-	ts: "video/mp2t",
-	ttf: "font/ttf",
-	txt: "text/plain; charset=utf-8",
-	wasm: "application/wasm",
-	webm: "video/webm",
-	weba: "audio/webm",
-	webmanifest: "application/manifest+json",
-	webp: "image/webp",
-	woff: "font/woff",
-	woff2: "font/woff2",
-	xhtml: "application/xhtml+xml; charset=utf-8",
-	xml: "application/xml; charset=utf-8",
-	zip: "application/zip",
-	"3gp": "video/3gpp",
-	"3g2": "video/3gpp2",
-	gltf: "model/gltf+json",
-	glb: "model/gltf-binary"
-};
-//#endregion
+import { n as getExtension, r as getMimeType, t as baseMimes } from "../mime-BnScXkQn.js";
 export { getExtension, getMimeType, baseMimes as mimes };

package/lib/utils/stream.js

@@ -1,88 +1,2 @@
-//#region ../../plugins/acryl-router/src/core/utils/stream.ts
-/**
-* @module
-* Stream utility.
-*/
-var StreamingApi = class {
-	writer;
-	encoder;
-	writable;
-	abortSubscribers = [];
-	responseReadable;
-	/**
-	* Whether the stream has been aborted.
-	*/
-	aborted = false;
-	/**
-	* Whether the stream has been closed normally.
-	*/
-	closed = false;
-	constructor(writable, _readable) {
-		this.writable = writable;
-		this.writer = writable.getWriter();
-		this.encoder = new TextEncoder();
-		const reader = _readable.getReader();
-		this.abortSubscribers.push(async () => {
-			await reader.cancel();
-		});
-		this.responseReadable = new ReadableStream({
-			async pull(controller) {
-				const { done, value } = await reader.read();
-				done ? controller.close() : controller.enqueue(value);
-			},
-			cancel: () => {
-				if (!this.closed) this.abort();
-			}
-		});
-	}
-	async write(input) {
-		try {
-			if (typeof input === "string") input = this.encoder.encode(input);
-			await this.writer.write(input);
-		} catch {}
-		return this;
-	}
-	async writeln(input) {
-		await this.write(input + "\n");
-		return this;
-	}
-	sleep(ms) {
-		return new Promise((res) => setTimeout(res, ms));
-	}
-	async close() {
-		this.closed = true;
-		try {
-			await this.writer.close();
-		} catch {}
-	}
-	async pipe(body) {
-		this.writer.releaseLock();
-		try {
-			await body.pipeTo(this.writable, {
-				preventClose: true,
-				preventAbort: true
-			});
-		} finally {
-			this.writer = this.writable.getWriter();
-		}
-	}
-	onAbort(listener) {
-		this.abortSubscribers.push(listener);
-	}
-	/**
-	* Abort the stream.
-	* You can call this method when stream is aborted by external event.
-	*/
-	abort() {
-		if (!this.aborted) {
-			this.aborted = true;
-			this.abortSubscribers.forEach((subscriber) => {
-				try {
-					Promise.resolve(subscriber()).catch(() => {});
-				} catch {}
-			});
-		}
-	}
-};
-//#endregion
+import { t as StreamingApi } from "../stream-CzM_SHkq.js";
 export { StreamingApi };

package/lib/utils/url.js

@@ -1,197 +1,2 @@
-//#region ../../plugins/acryl-router/src/core/utils/url.ts
-const splitPath = (path) => {
-	const paths = path.split("/");
-	if (paths[0] === "") paths.shift();
-	return paths;
-};
-const splitRoutingPath = (routePath) => {
-	const { groups, path } = extractGroupsFromPath(routePath);
-	const paths = splitPath(path);
-	return replaceGroupMarks(paths, groups);
-};
-const extractGroupsFromPath = (path) => {
-	const groups = [];
-	path = path.replace(/\{[^}]+\}/g, (match, index) => {
-		const mark = `@${index}`;
-		groups.push([mark, match]);
-		return mark;
-	});
-	return {
-		groups,
-		path
-	};
-};
-const replaceGroupMarks = (paths, groups) => {
-	for (let i = groups.length - 1; i >= 0; i--) {
-		const [mark] = groups[i];
-		for (let j = paths.length - 1; j >= 0; j--) if (paths[j].includes(mark)) {
-			paths[j] = paths[j].replace(mark, groups[i][1]);
-			break;
-		}
-	}
-	return paths;
-};
-const patternCache = {};
-const getPattern = (label, next) => {
-	if (label === "*") return "*";
-	const match = label.match(/^\:([^\{\}]+)(?:\{(.+)\})?$/);
-	if (match) {
-		const cacheKey = `${label}#${next}`;
-		if (!patternCache[cacheKey]) if (match[2]) patternCache[cacheKey] = next && next[0] !== ":" && next[0] !== "*" ? [
-			cacheKey,
-			match[1],
-			new RegExp(`^${match[2]}(?=/${next})`)
-		] : [
-			label,
-			match[1],
-			new RegExp(`^${match[2]}$`)
-		];
-		else patternCache[cacheKey] = [
-			label,
-			match[1],
-			true
-		];
-		return patternCache[cacheKey];
-	}
-	return null;
-};
-const tryDecode = (str, decoder) => {
-	try {
-		return decoder(str);
-	} catch {
-		return str.replace(/(?:%[0-9A-Fa-f]{2})+/g, (match) => {
-			try {
-				return decoder(match);
-			} catch {
-				return match;
-			}
-		});
-	}
-};
-/**
-* Try to apply decodeURI() to given string.
-* If it fails, skip invalid percent encoding or invalid UTF-8 sequences, and apply decodeURI() to the rest as much as possible.
-* @param str The string to decode.
-* @returns The decoded string that sometimes contains undecodable percent encoding.
-* @example
-* tryDecodeURI('Hello%20World') // 'Hello World'
-* tryDecodeURI('Hello%20World/%A4%A2') // 'Hello World/%A4%A2'
-*/
-const tryDecodeURI = (str) => tryDecode(str, decodeURI);
-const getPath = (request) => {
-	const url = request.url;
-	const start = url.indexOf("/", url.indexOf(":") + 4);
-	let i = start;
-	for (; i < url.length; i++) {
-		const charCode = url.charCodeAt(i);
-		if (charCode === 37) {
-			const queryIndex = url.indexOf("?", i);
-			const hashIndex = url.indexOf("#", i);
-			const end = queryIndex === -1 ? hashIndex === -1 ? void 0 : hashIndex : hashIndex === -1 ? queryIndex : Math.min(queryIndex, hashIndex);
-			const path = url.slice(start, end);
-			return tryDecodeURI(path.includes("%25") ? path.replace(/%25/g, "%2525") : path);
-		} else if (charCode === 63 || charCode === 35) break;
-	}
-	return url.slice(start, i);
-};
-/**
-* @deprecated
-* Use the `URL` API instead.
-*/
-const getQueryStrings = (url) => {
-	const queryIndex = url.indexOf("?", 8);
-	if (queryIndex === -1) return "";
-	const hashIndex = url.indexOf("#", 8);
-	return hashIndex === -1 ? url.slice(queryIndex) : queryIndex < hashIndex ? url.slice(queryIndex, hashIndex) : "";
-};
-const getPathNoStrict = (request) => {
-	const result = getPath(request);
-	return result.length > 1 && result.at(-1) === "/" ? result.slice(0, -1) : result;
-};
-/**
-* Merge paths.
-* @param {string[]} ...paths - The paths to merge.
-* @returns {string} The merged path.
-* @example
-* mergePath('/api', '/users') // '/api/users'
-* mergePath('/api/', '/users') // '/api/users'
-* mergePath('/api', '/') // '/api'
-* mergePath('/api/', '/') // '/api/'
-*/
-const mergePath = (base, sub, ...rest) => {
-	if (rest.length) sub = mergePath(sub, ...rest);
-	return `${base?.[0] === "/" ? "" : "/"}${base}${sub === "/" ? "" : `${base?.at(-1) === "/" ? "" : "/"}${sub?.[0] === "/" ? sub.slice(1) : sub}`}`;
-};
-const checkOptionalParameter = (path) => {
-	if (path.charCodeAt(path.length - 1) !== 63 || !path.includes(":")) return null;
-	const segments = path.split("/");
-	const results = [];
-	let basePath = "";
-	segments.forEach((segment) => {
-		if (segment !== "" && !/\:/.test(segment)) basePath += "/" + segment;
-		else if (/\:/.test(segment)) if (segment.charCodeAt(segment.length - 1) === 63) {
-			if (results.length === 0 && basePath === "") results.push("/");
-			else results.push(basePath);
-			const optionalSegment = segment.slice(0, -1);
-			basePath += "/" + optionalSegment;
-			results.push(basePath);
-		} else basePath += "/" + segment;
-	});
-	return results.filter((v, i, a) => a.indexOf(v) === i);
-};
-const tryDecodeURIComponent = (str) => str.indexOf("%") !== -1 ? tryDecode(str, decodeURIComponent_) : str;
-const _decodeURI = (value) => {
-	if (value.indexOf("+") !== -1) value = value.replace(/\+/g, " ");
-	return tryDecodeURIComponent(value);
-};
-const _getQueryParam = (url, key, multiple) => {
-	const hashIndex = url.indexOf("#", 8);
-	if (hashIndex !== -1) url = url.slice(0, hashIndex);
-	let encoded;
-	if (!multiple && key && key.indexOf("%") === -1 && key.indexOf("+") === -1) {
-		let keyIndex = url.indexOf("?", 8);
-		if (keyIndex === -1) return;
-		if (!url.startsWith(key, keyIndex + 1)) keyIndex = url.indexOf(`&${key}`, keyIndex + 1);
-		while (keyIndex !== -1) {
-			const trailingKeyCode = url.charCodeAt(keyIndex + key.length + 1);
-			if (trailingKeyCode === 61) {
-				const valueIndex = keyIndex + key.length + 2;
-				const endIndex = url.indexOf("&", valueIndex);
-				return _decodeURI(url.slice(valueIndex, endIndex === -1 ? void 0 : endIndex));
-			} else if (trailingKeyCode == 38 || isNaN(trailingKeyCode)) return "";
-			keyIndex = url.indexOf(`&${key}`, keyIndex + 1);
-		}
-		encoded = /[%+]/.test(url);
-		if (!encoded) return;
-	}
-	const results = Object.create(null);
-	encoded ??= /[%+]/.test(url);
-	let keyIndex = url.indexOf("?", 8);
-	while (keyIndex !== -1) {
-		const nextKeyIndex = url.indexOf("&", keyIndex + 1);
-		let valueIndex = url.indexOf("=", keyIndex);
-		if (valueIndex > nextKeyIndex && nextKeyIndex !== -1) valueIndex = -1;
-		let name = url.slice(keyIndex + 1, valueIndex === -1 ? nextKeyIndex === -1 ? void 0 : nextKeyIndex : valueIndex);
-		if (encoded) name = _decodeURI(name);
-		keyIndex = nextKeyIndex;
-		if (name === "") continue;
-		let value;
-		if (valueIndex === -1) value = "";
-		else {
-			value = url.slice(valueIndex + 1, nextKeyIndex === -1 ? void 0 : nextKeyIndex);
-			if (encoded) value = _decodeURI(value);
-		}
-		if (multiple) {
-			if (!(results[name] && Array.isArray(results[name]))) results[name] = [];
-			results[name].push(value);
-		} else results[name] ??= value;
-	}
-	return key ? results[key] : results;
-};
-const getQueryParam = _getQueryParam;
-const getQueryParams = (url, key) => {
-	return _getQueryParam(url, key, true);
-};
-const decodeURIComponent_ = decodeURIComponent;
-//#endregion
+import { a as getPattern, c as getQueryStrings, d as splitRoutingPath, f as tryDecode, i as getPathNoStrict, l as mergePath, m as tryDecodeURIComponent, n as decodeURIComponent_, o as getQueryParam, p as tryDecodeURI, r as getPath, s as getQueryParams, t as checkOptionalParameter, u as splitPath } from "../url-BPh4d6j-.js";
 export { checkOptionalParameter, decodeURIComponent_, getPath, getPathNoStrict, getPattern, getQueryParam, getQueryParams, getQueryStrings, mergePath, splitPath, splitRoutingPath, tryDecode, tryDecodeURI, tryDecodeURIComponent };

package/lib/{validator-D84mq-dO.js → validator-Btiyt5VJ.js}

@@ -1,6 +1,6 @@
-import { HTTPException } from "./http-exception.js";
-import { bufferToFormData } from "./utils/buffer.js";
-import { getCookie } from "./cookie.js";
+import { t as HTTPException } from "./http-exception-MjWkT89V.js";
+import { t as bufferToFormData } from "./buffer-CkEOJCcY.js";
+import { i as getCookie } from "./cookie-BHIduy2T.js";
 //#region ../../plugins/acryl-router/src/core/validator/validator.ts
 const jsonRegex = /^application\/([a-z-\.]+\+)?json(;\s*[a-zA-Z0-9\-]+\=([^;]+))*$/i;
 const multipartRegex = /^multipart\/form-data(;\s?boundary=[a-zA-Z0-9'"()+_,\-./:=?]+)?$/i;

package/lib/validator.js

@@ -1,2 +1,2 @@
-import { t as validator } from "./validator-D84mq-dO.js";
+import { t as validator } from "./validator-Btiyt5VJ.js";
 export { validator };

package/lib/websocket-DsyBIKVA.js

@@ -0,0 +1,56 @@
+//#region ../../plugins/acryl-router/src/core/helper/websocket/index.ts
+/**
+* A context for controlling WebSockets
+*/
+var WSContext = class {
+	#init;
+	constructor(init) {
+		this.#init = init;
+		this.raw = init.raw;
+		this.url = init.url ? new URL(init.url) : null;
+		this.protocol = init.protocol ?? null;
+	}
+	send(source, options) {
+		this.#init.send(source, options ?? {});
+	}
+	raw;
+	binaryType = "arraybuffer";
+	get readyState() {
+		return this.#init.readyState;
+	}
+	get bufferedAmount() {
+		return this.#init.bufferedAmount ?? 0;
+	}
+	url;
+	protocol;
+	close(code, reason) {
+		this.#init.close(code, reason);
+	}
+};
+const createWSMessageEvent = (source) => {
+	return new MessageEvent("message", { data: source });
+};
+/**
+* Create a WebSocket adapter/helper
+*/
+const defineWebSocketHelper = (handler) => {
+	return ((...args) => {
+		if (typeof args[0] === "function") {
+			const [createEvents, options] = args;
+			return async function upgradeWebSocket(c, next) {
+				const result = await handler(c, await createEvents(c), options);
+				if (result) return result;
+				await next();
+			};
+		} else {
+			const [c, events, options] = args;
+			return (async () => {
+				const upgraded = await handler(c, events, options);
+				if (!upgraded) throw new Error("Failed to upgrade WebSocket");
+				return upgraded;
+			})();
+		}
+	});
+};
+//#endregion
+export { createWSMessageEvent as n, defineWebSocketHelper as r, WSContext as t };

package/lib/ws.js

@@ -1,56 +1,2 @@
-//#region ../../plugins/acryl-router/src/core/helper/websocket/index.ts
-/**
-* A context for controlling WebSockets
-*/
-var WSContext = class {
-	#init;
-	constructor(init) {
-		this.#init = init;
-		this.raw = init.raw;
-		this.url = init.url ? new URL(init.url) : null;
-		this.protocol = init.protocol ?? null;
-	}
-	send(source, options) {
-		this.#init.send(source, options ?? {});
-	}
-	raw;
-	binaryType = "arraybuffer";
-	get readyState() {
-		return this.#init.readyState;
-	}
-	get bufferedAmount() {
-		return this.#init.bufferedAmount ?? 0;
-	}
-	url;
-	protocol;
-	close(code, reason) {
-		this.#init.close(code, reason);
-	}
-};
-const createWSMessageEvent = (source) => {
-	return new MessageEvent("message", { data: source });
-};
-/**
-* Create a WebSocket adapter/helper
-*/
-const defineWebSocketHelper = (handler) => {
-	return ((...args) => {
-		if (typeof args[0] === "function") {
-			const [createEvents, options] = args;
-			return async function upgradeWebSocket(c, next) {
-				const result = await handler(c, await createEvents(c), options);
-				if (result) return result;
-				await next();
-			};
-		} else {
-			const [c, events, options] = args;
-			return (async () => {
-				const upgraded = await handler(c, events, options);
-				if (!upgraded) throw new Error("Failed to upgrade WebSocket");
-				return upgraded;
-			})();
-		}
-	});
-};
-//#endregion
+import { n as createWSMessageEvent, r as defineWebSocketHelper, t as WSContext } from "./websocket-DsyBIKVA.js";
 export { WSContext, createWSMessageEvent, defineWebSocketHelper };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "acrylblends",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "The Acryl web framework (import { Acryl } from \"acrylblends\") and the acrylblends command that scaffolds Cordis apps.",
   "license": "MIT",
   "type": "module",

package/plugins/acryl-door/src/host/chat-tools.ts

@@ -20,6 +20,8 @@ export function registerChatTools(tools: ToolsPort, door: Door): () => void {
     for (const verb of VERBS) {
       removers.push(tools.register(chatToolName(verb), {
         description: VERB_SPECS[verb].description,
+        // The model is told which fields the verb takes (an `act` needs its `op`), the same schema MCP lists.
+        parameters: VERB_SPECS[verb].arguments as unknown as Readonly<Record<string, unknown>>,
         run: async (input: unknown) => {
           try {
             return (await door.run(verb, input ?? {}, running.signal)).text

package/plugins/acryl-door/src/host/door.ts

@@ -35,7 +35,7 @@ export interface ExtensionsPort {
 /** The slice of acrylblends' `tools` registry (the `agent` plugin's) the tool verbs use, and where the built-in chat finds the verbs. */
 export interface ToolsPort {
   /** @returns the function that removes the tool. @throws when the name is taken. */
-  register(name: string, tool: { readonly description: string; run(input: unknown): unknown }): () => void
+  register(name: string, tool: { readonly description: string; readonly parameters?: Readonly<Record<string, unknown>>; run(input: unknown): unknown }): () => void
   list(): ReadonlyArray<{ readonly name: string; readonly description: string }>
   call(name: string, input: unknown): Promise<unknown>
 }
@@ -148,7 +148,24 @@ export class Door {
       answer = { ok: true, detail: request.op === 'reload' ? 'reloading' : `going to ${request.path}` }
     }
     if (!await back) throw new UiControlError('timeout', request.op === 'reload' ? 'the page did not come back after the reload' : `the page did not come back after going to ${request.path}: is there a page at that path, and does it load the door's script?`)
-    return { ...answer, detail: `${answer.detail ?? 'done'}; the page is back: look again` }
+    const landed = request.op === 'navigate' ? await this.statusAt(request.path) : undefined
+    return { ...answer, detail: `${answer.detail ?? 'done'}${landed === undefined ? '' : `; ${landed}`}; the page is back: look again` }
+  }
+
+  /**
+   * What the app answers at a path the page was sent to, so an agent that mistyped one is told ("404 at /nope") and not left to find out from a page it did not expect.
+   * A second GET of the same path (a page is read-only); nothing when the app has no address or does not answer in time.
+   */
+  private async statusAt(path: string): Promise<string | undefined> {
+    const base = this.deps.app.url
+    if (base === undefined) return undefined
+    try {
+      const response = await fetch(new URL(path, base), { headers: { accept: 'text/html' }, signal: AbortSignal.timeout(3000) })
+      await response.body?.cancel()
+      return response.ok ? `${response.status} at ${path}` : `${response.status} at ${path}: the app serves no page there, look at what is shown and navigate to a path it does`
+    } catch {
+      return undefined
+    }
   }
 
   private parse(input: Record<string, unknown>): UiRequest {

package/plugins/acryl-door/src/index.ts

@@ -94,6 +94,13 @@ function loopbackUrl(url: string): string {
   return parsed.origin
 }
 
+const escapeHtml = (text: string): string => text.replace(/[&<>"']/gu, char => `&#${char.charCodeAt(0)};`)
+
+/** The page of a path the app does not serve, development only: what is missing, a way back, and the door's script. */
+export function notFoundPage(path: string, scriptTag: string): string {
+  return `<!doctype html><html lang="en"><head><meta charset="utf-8"><title>404 Not Found</title></head><body><main><h1>404 Not Found</h1><p>This app has no page at <code>${escapeHtml(path)}</code>.</p><p><a href="/">Back to the app</a></p></main>${scriptTag}</body></html>`
+}
+
 export function apply(ctx: Context, rawConfig: Config = {}): void {
   const config = Config(rawConfig)
   // Development only: nothing is started, mounted or written in production, or when switched off.
@@ -124,9 +131,15 @@ export function apply(ctx: Context, rawConfig: Config = {}): void {
   // The page script on every HTML page the app answers, whenever its plugin was mounted (the pages of a plugin that loaded at boot, before this one, included): a page an agent writes
   // can be looked at and driven without anyone adding the tag. A page that already carries it (the templates' own pages) is left as it is. Development only, like the rest of the door.
   const tag = `<script type="module" src="${DOOR_PREFIX}/page.js"></script>`
-  const addScript = async (c: { res: Response }, next: () => Promise<void>): Promise<void> => {
+  const addScript = async (c: { res: Response; req: { path: string; header(name: string): string | undefined } }, next: () => Promise<void>): Promise<void> => {
     await next()
-    if (!(c.res.headers.get('content-type') ?? '').includes('text/html')) return
+    if (!(c.res.headers.get('content-type') ?? '').includes('text/html')) {
+      // A path the app does not serve, opened as a page: the browser would show a bare "404 Not Found" with no script, and the window would be left where nothing can look at it or
+      // act on it (an agent that mistypes a path would need a person to bring the window back). The page says what is missing, carries the script, and keeps the 404.
+      if (c.res.status === 404 && (c.req.header('accept') ?? '').includes('text/html') && !(c.res.headers.get('content-type') ?? '').includes('json'))
+        c.res = new Response(notFoundPage(c.req.path, tag), { status: 404, headers: { 'content-type': 'text/html; charset=utf-8' } })
+      return
+    }
     const html = await c.res.text()
     const headers = new Headers(c.res.headers)
     headers.delete('content-length')

package/plugins/acryl-node-server/src/register.ts

@@ -7,9 +7,9 @@
  * `typescript` is loaded from the app, on the first JSX file only; the framework itself has no dependencies.
  */
 
+import { existsSync, readFileSync } from 'node:fs'
 import { registerHooks } from 'node:module'
-import { readFileSync } from 'node:fs'
-import { fileURLToPath } from 'node:url'
+import { fileURLToPath, pathToFileURL } from 'node:url'
 import { compileModule } from './transpile.ts'
 
 /** The JSX runtime the docs set up; an app's tsconfig.json (or a file's own `@jsxImportSource` pragma) chooses another. */
@@ -27,3 +27,30 @@ registerHooks({
     return { format: 'module', source, shortCircuit: true }
   },
 })
+
+/**
+ * The framework's names for a file of the app: in an app the framework plugins are source under `plugins/`, not packages, so `acrylblends`, `acrylblends/body-limit` or `acryl-router`
+ * have nowhere to resolve from. A plugin installed while the app runs gets them from the extensions plugin; a plugin that is a ROW of `blend.yaml` is imported by `src/app.ts` before
+ * any of that exists, so the same names are resolved here, in the preload every `dev`, `start` and `test` script runs. Only a name that Node cannot resolve itself, only for the
+ * app's own files (never for something in `node_modules`), and only in an app that has the framework as vendored source: the published package resolves its own names.
+ */
+const plugins = new URL('../../', import.meta.url)
+const appRoot = new URL('../', plugins).href
+const resolver = new URL('extensions/resolve.ts', plugins)
+if (existsSync(fileURLToPath(new URL('acryl-router/src/index.ts', plugins))) && existsSync(fileURLToPath(resolver))) {
+  const { routerAliases } = (await import(resolver.href)) as { routerAliases(): Record<string, string> }
+  const aliases = routerAliases()
+  registerHooks({
+    resolve(specifier, context, nextResolve) {
+      try {
+        return nextResolve(specifier, context)
+      } catch (error) {
+        const alias = aliases[specifier]
+        const parent = context.parentURL
+        if (alias !== undefined && parent?.startsWith(appRoot) && !parent.includes('/node_modules/'))
+          return nextResolve(pathToFileURL(alias).href, context)
+        throw error
+      }
+    },
+  })
+}

package/plugins/agent/model.ts

@@ -21,7 +21,12 @@ export interface ModelInput {
     readonly reasoning?: string
   }>
   /** The tools the model may call. */
-  readonly tools?: ReadonlyArray<{ readonly name: string; readonly description: string }>
+  readonly tools?: ReadonlyArray<{
+    readonly name: string
+    readonly description: string
+    /** The JSON Schema of the tool's input, when it has one. */
+    readonly parameters?: Readonly<Record<string, unknown>>
+  }>
   /** Aborts when the run is cancelled: a provider that can stop its request passes this on. */
   readonly signal?: AbortSignal
 }

package/plugins/agent/tools.ts

@@ -3,6 +3,8 @@ import type { Context } from '@deepseek-ai/cordis'
 /** One tool: what it does (for the model) and how to run it. */
 export interface Tool {
   readonly description: string
+  /** The JSON Schema of the input (an object schema), sent to a real model so it knows which fields the tool takes. A tool without one takes any object. */
+  readonly parameters?: Readonly<Record<string, unknown>>
   /** `options.signal` aborts when the run is cancelled; a tool that can stop its work listens to it. */
   run(input: unknown, options?: { signal?: AbortSignal }): unknown | Promise<unknown>
 }
@@ -11,7 +13,11 @@ export interface Tool {
 export interface Tools {
   /** Register a tool. Returns the function that removes it. */
   register(name: string, tool: Tool): () => void
-  list(): Array<{ name: string; description: string }>
+  list(): Array<{
+    name: string
+    description: string
+    parameters?: Readonly<Record<string, unknown>>
+  }>
   call(name: string, input: unknown, options?: { signal?: AbortSignal }): Promise<unknown>
 }
 
@@ -31,7 +37,11 @@ export function tools(ctx: Context) {
       return () => void table.delete(name)
     },
     list: () =>
-      [...table.entries()].map(([name, tool]) => ({ name, description: tool.description })),
+      [...table.entries()].map(([name, tool]) => ({
+        name,
+        description: tool.description,
+        ...(tool.parameters === undefined ? {} : { parameters: tool.parameters }),
+      })),
     async call(name, input, options) {
       const tool = table.get(name)
       if (!tool) throw new Error(`unknown tool "${name}"`)