@abide/abide 0.109.0 → 0.110.1

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @abide/abide
 
+## 0.110.1
+
+### Patch Changes
+
+- 2aac4eb: an MCP tool's inputSchema is an object at its top level, and args that can never be one refuse the app at boot ([`ec9d80b`](https://github.com/briancray/abide/commit/ec9d80bb6f8902ba1d9f016f6dcd85eba83a47ef))
+
+## 0.110.0
+
+### Minor Changes
+
+- bfa7a68: Breaking: a server-only module and a test are named by file rather than by directory — `<name>.server.<ext>` under `lib`, `.test.ts` anywhere; `lib` and `public` are the only fences ([`e8e2666`](https://github.com/briancray/abide/commit/e8e266676a90d4f4534b74c6373116a1cbab277b))
+
 ## 0.109.0
 
 ### Minor Changes

package/docs/REGISTRY.md

@@ -313,7 +313,7 @@ type Gated<Gate, Accepted> = [Schema<Accepted>] extends [Gate] ? never : Failed<
 
 | Name | Signature | Meaning | Rules |
 | --- | --- | --- | --- |
-| `/__abide/mcp` | `POST` | The streamable-http MCP endpoint. | 19.21, 19.22, 20.5, 20.7, 20.8, 20.9, 20.10, 20.12, 20.13, 20.14, 20.16, 20.17, 36.7, 16.78 |
+| `/__abide/mcp` | `POST` | The streamable-http MCP endpoint. | 19.21, 19.22, 20.5, 20.7, 20.8, 20.9, 20.10, 20.12, 20.13, 20.14, 20.16, 20.17, 20.19, 20.20, 36.7, 16.78 |
 
 # Assistant
 
@@ -325,7 +325,7 @@ type Gated<Gate, Accepted> = [Schema<Accepted>] extends [Gate] ? never : Failed<
 | `AssistantOptions` | `{ mcp?: boolean; maxTurns?: number }` | What `assistant` takes beside a provider. | 44.6, 44.8, 44.11 |
 | `Provider` | `{ run(messages: AssistantMessage[], tools: Toolbox, limits: { maxTurns: number; signal: AbortSignal }): AsyncGenerator<AssistantEvent> }` | What runs a conversation. | 44.2, 44.29 |
 | `Toolbox` | `{ list: ToolDefinition[]; call(name: string, input: unknown): Promise<{ text: string; failed: boolean }> }` | The app's MCP tools, called as the asker. | 44.6, 44.7 |
-| `ToolDefinition` | `{ name: string; description: string; inputSchema: unknown; annotations: { readOnlyHint: boolean; destructiveHint: boolean; idempotentHint: boolean }; outputSchema: unknown }` | A tool as the app's MCP surface lists it. | 20.14, 20.16, 44.6 |
+| `ToolDefinition` | `{ name: string; description: string; inputSchema: unknown; annotations: { readOnlyHint: boolean; destructiveHint: boolean; idempotentHint: boolean }; outputSchema: unknown }` | A tool as the app's MCP surface lists it. | 20.14, 20.16, 20.19, 44.6 |
 
 ## `claudeApi`
 
@@ -650,9 +650,10 @@ type Gated<Gate, Accepted> = [Schema<Accepted>] extends [Gate] ? never : Failed<
 | Path | Meaning | Rules |
 | --- | --- | --- |
 | `src/**` | The app's source. | 36.10, 38.25 |
-| `**/server/**` | Source the browser never loads. | 16.29, 23.15, 23.16, 23.18, 36.10 |
-| `**/lib/**` | The app's code that is no address: components and modules, on both sides. | 23.15, 23.16, 23.18, 23.22, 37.1 |
-| `**/tests/**` | The app's tests. | 23.15, 23.16, 23.18, 23.22, 37.1, 38.109 |
+| `**/lib/**` | The app's code that is no address: components and modules. | 23.15, 23.16, 23.18, 23.22, 37.1 |
+| `**/lib/**/<name>.server.<extension>` | A server file: source the browser never loads. | 16.29, 23.23, 34.20, 36.10 |
+| `**/<name>.test.ts` | A test file: one of the app's tests, wherever it lies. | 23.22, 38.109 |
+| `**/<name>.d.ts` | A declaration file: types for the checker, wherever it lies. | 23.22 |
 | `**/public/**` | The files answered as authored, at their path below that directory. | 23.15, 23.16, 23.18, 36.11, 36.12, 36.13, 36.14, 36.15, 36.17, 21.12, 21.13, 21.14, 38.18, 38.19 |
 | `src/public/favicon.ico` | The file answered at `/favicon.ico`. | 36.11 |
 | `src/public/robots.txt` | The file answered at `/robots.txt`. | 36.11 |

package/docs/RULEBOOK.md

@@ -115,8 +115,11 @@ REGISTRY.md because none of them is a name an app author writes.
 | sink | What 35.7 defines. |
 | implementation | Anything claiming conformance to this document. |
 | dependency's `.abide` | A `.abide` file under a `node_modules` directory or outside the app's root. |
-| fence | A `server`, `public`, `lib` or `tests` directory. |
-| handler file | A `.ts` of the app's own, neither a `.d.ts` nor a `.test.ts`, directly in a directory under no fence. |
+| fence | A `public` or `lib` directory. |
+| server file | A file named `<name>.server.<extension>`. |
+| test file | A `.test.ts` file. |
+| declaration file | A `.d.ts` file. |
+| handler file | A `.ts` of the app's own, neither a declaration file, a test file nor a server file, directly in a directory under no fence. |
 | private handler | A handler a `<script server>` declares. |
 | chapter app | The app the documentation's story has built by the end of one chapter, kept whole so a reader can download it and run it. |
 
@@ -915,7 +918,7 @@ read it.
 16.28 A browser MUST receive a generated `Rpc` wrapper carrying the method, the mount-relative address and
 the description, and MUST NOT receive the handler file or the `<script server>` that declared it.
 
-16.29 Importing a module under a `server` directory from the client graph MUST be a compile error,
+16.29 Importing a server file from the client graph MUST be a compile error,
 and MUST NOT be a silent stub.
 
 16.30 An `Rpc` returning a raw `Value` MUST transport as `application/json`.
@@ -1317,6 +1320,12 @@ tool, the status it was answered with and how long it took, whether `/__abide/mc
 made the call — a call naming a tool it does not publish answered 404, and one whose answer threw
 500.
 
+20.19 A tool `/__abide/mcp` lists MUST declare an `inputSchema` whose top-level `type` is `object`,
+whatever its handler's args schema declares there.
+
+20.20 A handler `/__abide/mcp` would list whose args schema can never be an object MUST refuse the
+app at boot, naming the handler.
+
 # 21. Generated headers
 
 21.1 Every response MUST carry `x-content-type-options: nosniff`.
@@ -1430,8 +1439,7 @@ segment a page below it adds.
 
 23.15 A file under a fence MUST NOT have a route.
 
-23.16 A fence under a fence MUST be a build error naming both, save a `server` directory under a
-`lib` or a `tests` directory.
+23.16 A fence under a fence MUST be a build error naming both.
 
 23.17 A route whose first segment is `__abide` MUST be a build error.
 
@@ -1447,9 +1455,12 @@ error naming the mount.
 23.21 A `.abide` of the app's own directly in a directory under no fence MUST be a page, save a
 `layout.abide`, an `error.abide` and the root's `launcher.abide`.
 
-23.22 A file of the app's own directly in a directory under no fence that is neither a `.abide` nor
-a handler file MUST be a build error naming the file and a `lib` directory, save one beside the
-`package.json` of a root that holds it, nor a `.ts`.
+23.22 A file of the app's own directly in a directory under no fence that is neither a `.abide`, a
+handler file, a test file nor a declaration file MUST be a build error naming the file and a `lib` directory, save one
+beside the `package.json` of a root that holds it, nor a `.ts`.
+
+23.23 A server file of the app's own under no `lib` directory MUST be a build error naming the file
+and a `lib` directory.
 
 # 24. Tracing
 
@@ -2101,8 +2112,8 @@ error.
 34.19 A `<script server>` block MUST be module scope run on a server alone, and the module a browser
 loads MUST NOT carry it.
 
-34.20 A `<script server>` in a `.abide` file of the app's own under a `server` or `public` directory
-MUST be a compile error.
+34.20 A `<script server>` in a `.abide` file of the app's own under a `public` directory MUST be a
+compile error.
 
 34.21 A file a script block imports `with { type: 'text' }`, a `.abide` among them, MUST be imported
 as its text and typed a `string`, on a server, in a browser and to the checker alike.
@@ -2206,8 +2217,8 @@ navigation from it MUST load the document it asks for.
 
 36.9 `NO_COLOR` MUST beat `FORCE_COLOR`.
 
-36.10 A module MUST be importable from either graph unless it lies under a `server` directory, per
-16.29.
+36.10 A module MUST be importable from either graph unless it is a server file, per 16.29,
+whatever imports it.
 
 36.11 A file under a `public` directory MUST be answered at that directory's path below the app's
 `--root` followed by its own path below that directory, rooted at the mount rather than at the
@@ -2237,7 +2248,7 @@ answered per 41.12.
 # 37. Lifecycle hooks
 
 37.1 A lifecycle hook MUST be filed at the route of the `.abide` or the handler file that called it,
-one under a `lib` or a `tests` directory at the route of the directory holding that one, and at the
+one under a `lib` directory at the route of the directory holding that one, and at the
 root route where neither did; a call MUST be read as a hook only where it names a hook the module
 imports from abide, under any name, or a member of a namespace it imports from abide.