@acid-cat/core-ts 0.2.0 → 0.3.1

package/dist/cli.js

@@ -1,5 +1,5 @@
 import { createSession } from "./session.js";
-import { CLI_EXIT_CODES, REFERENCE, bundle, cliExitCode, commandPath, isCallFailure } from "@acid-cat/spec-ts";
+import { CLI_EXIT_CODES, REFERENCE, bundle, cliExitCode, cliFlags, cliUsage, commandPath, isCallFailure } from "@acid-cat/spec-ts";
 //#region src/cli.ts
 /**
 * The CLI binding (spec/bindings/cli.md): a command line made from the catalog.
@@ -55,12 +55,15 @@ async function runCli(app, options, args, io) {
 			return CLI_EXIT_CODES.value;
 		}
 		if (first === "list") {
-			io.stdout(JSON.stringify([...session.handles.values()].map((handle) => ({
-				id: handle.id,
-				description: handle.description,
-				...handle.availability.getSnapshot(),
-				usage: `${options.name} ${commandPath(handle.id).join(" ")}`
-			})), null, 2));
+			io.stdout(JSON.stringify([...session.handles.values()].map((handle) => {
+				const input = session.view.capabilities[handle.id].input;
+				return {
+					id: handle.id,
+					description: handle.description,
+					...handle.availability.getSnapshot(),
+					usage: cliUsage(options.name, handle.id, input === void 0 ? void 0 : bundle(input, types))
+				};
+			}), null, 2));
 			return CLI_EXIT_CODES.value;
 		}
 		if (first === "call") {
@@ -150,11 +153,12 @@ function help(name, paths) {
 	].join("\n");
 }
 function usage(name, path, description, schema) {
-	const properties = Object.keys(schema.properties ?? {});
-	const required = new Set(schema.required ?? []);
-	const flags = properties.map((property) => required.has(property) ? `--${property} <value>` : `[--${property} <value>]`);
 	return [
-		`Usage: ${name} ${[...path, ...flags].join(" ")}`,
+		`Usage: ${[
+			name,
+			...path,
+			...cliFlags(schema)
+		].join(" ")}`,
 		"",
 		description
 	].join("\n");

package/dist/mcp.d.ts

@@ -5,6 +5,11 @@ export type McpOptions<Context> = McpSettings & ContextOption<Context>;
 export interface McpSettings {
     readonly name: string;
     readonly version: string;
+    /**
+     * Guidance for a model about the whole server, which `server/discover` gives as `instructions`. The default is the
+     * description of the application.
+     */
+    readonly instructions?: string | undefined;
     /** The origins that can call the server. A request with no `Origin` header is accepted. */
     readonly allowedOrigins: readonly string[];
     readonly toJsonSchema: ToJsonSchema;

package/dist/mcp.js

@@ -43,7 +43,10 @@ function mcpHandler(app, options) {
 				toJsonSchema: options.toJsonSchema
 			});
 			try {
-				return await answer(session, message, options, request.signal);
+				return await answer(session, message, {
+					...options,
+					instructions: options.instructions ?? app.description
+				}, request.signal);
 			} finally {
 				await session.dispose();
 			}
@@ -67,7 +70,8 @@ async function answer(session, message, options, signal) {
 	switch (message.method) {
 		case "server/discover": return complete({
 			supportedVersions: [MCP_PROTOCOL_VERSION],
-			capabilities: { tools: { listChanged: false } }
+			capabilities: { tools: { listChanged: false } },
+			...options.instructions === void 0 ? {} : { instructions: options.instructions }
 		}, true);
 		case "tools/list": return complete({ tools: listTools(session) }, true);
 		case "tools/call": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@acid-cat/core-ts",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "Serve AcidCat capabilities in plain TypeScript, with no Effect dependency.",
   "keywords": [
     "acidcat",
@@ -32,11 +32,11 @@
     "access": "public"
   },
   "dependencies": {
-    "@acid-cat/catalog": "0.2.0",
-    "@acid-cat/spec-ts": "0.2.0"
+    "@acid-cat/catalog": "0.3.1",
+    "@acid-cat/spec-ts": "0.3.1"
   },
   "devDependencies": {
-    "@acid-cat/cli": "0.2.0",
+    "@acid-cat/cli": "0.3.1",
     "@types/node": "26.6.5",
     "esbuild": "0.28.2",
     "playwright": "1.64.0",