@cyanheads/faa-aircraft-registry-mcp-server 0.1.3 → 0.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/AGENTS.md +3 -3
  2. package/CLAUDE.md +3 -3
  3. package/Dockerfile +10 -6
  4. package/LICENSE +1 -1
  5. package/README.md +4 -3
  6. package/changelog/0.1.x/0.1.4.md +31 -0
  7. package/changelog/0.1.x/0.1.5.md +15 -0
  8. package/changelog/template.md +5 -3
  9. package/dist/mcp-server/tools/definitions/index.d.ts +6 -0
  10. package/dist/mcp-server/tools/definitions/index.d.ts.map +1 -1
  11. package/dist/mcp-server/tools/definitions/search-aircraft-types.tool.d.ts +4 -1
  12. package/dist/mcp-server/tools/definitions/search-aircraft-types.tool.d.ts.map +1 -1
  13. package/dist/mcp-server/tools/definitions/search-aircraft-types.tool.js +41 -9
  14. package/dist/mcp-server/tools/definitions/search-aircraft-types.tool.js.map +1 -1
  15. package/dist/mcp-server/tools/definitions/search-registrations.tool.d.ts +9 -5
  16. package/dist/mcp-server/tools/definitions/search-registrations.tool.d.ts.map +1 -1
  17. package/dist/mcp-server/tools/definitions/search-registrations.tool.js +46 -13
  18. package/dist/mcp-server/tools/definitions/search-registrations.tool.js.map +1 -1
  19. package/dist/services/registry/csv.d.ts +11 -5
  20. package/dist/services/registry/csv.d.ts.map +1 -1
  21. package/dist/services/registry/csv.js +38 -39
  22. package/dist/services/registry/csv.js.map +1 -1
  23. package/dist/services/registry/ingest.d.ts +18 -6
  24. package/dist/services/registry/ingest.d.ts.map +1 -1
  25. package/dist/services/registry/ingest.js +144 -101
  26. package/dist/services/registry/ingest.js.map +1 -1
  27. package/dist/services/registry/normalize.d.ts +21 -5
  28. package/dist/services/registry/normalize.d.ts.map +1 -1
  29. package/dist/services/registry/normalize.js +24 -6
  30. package/dist/services/registry/normalize.js.map +1 -1
  31. package/dist/services/registry/registry-service.d.ts.map +1 -1
  32. package/dist/services/registry/registry-service.js +43 -12
  33. package/dist/services/registry/registry-service.js.map +1 -1
  34. package/dist/services/registry/schema.d.ts +16 -1
  35. package/dist/services/registry/schema.d.ts.map +1 -1
  36. package/dist/services/registry/schema.js +16 -1
  37. package/dist/services/registry/schema.js.map +1 -1
  38. package/dist/services/registry/types.d.ts +8 -2
  39. package/dist/services/registry/types.d.ts.map +1 -1
  40. package/dist/services/registry/types.js.map +1 -1
  41. package/dist/services/registry/zip.d.ts +30 -12
  42. package/dist/services/registry/zip.d.ts.map +1 -1
  43. package/dist/services/registry/zip.js +58 -28
  44. package/dist/services/registry/zip.js.map +1 -1
  45. package/package.json +9 -7
  46. package/server.json +3 -3
package/AGENTS.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # Developer Protocol
2
2
 
3
3
  **Server:** faa-aircraft-registry-mcp-server
4
- **Version:** 0.1.3
5
- **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.10.9`
4
+ **Version:** 0.1.5
5
+ **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.10.14`
6
6
  **Engines:** Bun ≥1.3.0, Node ≥24.0.0
7
7
  **MCP SDK:** `@modelcontextprotocol/sdk` ^1.29.0
8
8
  **Zod:** ^4.4.3
@@ -309,7 +309,6 @@ Available skills:
309
309
  | `tool-defs-analysis` | Read-only audit of MCP definition language across the surface — voice, leaks, defaults, recovery hints, output descriptions |
310
310
  | `security-pass` | Audit server for MCP-flavored security gaps: output injection, scope blast radius, input sinks, tenant isolation |
311
311
  | `code-simplifier` | Post-session cleanup against `git diff` — modernize syntax, consolidate duplication, align with the codebase |
312
- | `devcheck` | Lint, format, typecheck, audit |
313
312
  | `polish-docs-meta` | Finalize docs, README, metadata, and agent protocol for shipping |
314
313
  | `git-wrapup` | Land working-tree changes as a versioned commit + annotated tag — version bump, changelog, verify, tag. Local only. |
315
314
  | `release-and-publish` | Push + npm + MCP Registry + GH Release + Docker. Picks up from `git-wrapup` |
@@ -317,6 +316,7 @@ Available skills:
317
316
  | `orchestrations` | Chain task skills into a gated multi-phase pipeline — build-out, QA-fix, update-ship — when you can spawn sub-agents |
318
317
  | `report-issue-framework` | File a bug or feature request against `@cyanheads/mcp-ts-core` via `gh` CLI |
319
318
  | `report-issue-local` | File a bug or feature request against this server's own repo via `gh` CLI |
319
+ | `techniques` | Catalog of response/data-shaping techniques — overflow handling, payload shaping, retrieval patterns |
320
320
  | `api-auth` | Auth modes, scopes, JWT/OAuth |
321
321
  | `api-canvas` | DataCanvas: register tabular data, run SQL, export, plus the `spillover()` helper for big result sets — Tier 3 opt-in |
322
322
  | `api-config` | AppConfig, parseConfig, env vars |
package/CLAUDE.md CHANGED
@@ -1,8 +1,8 @@
1
1
  # Developer Protocol
2
2
 
3
3
  **Server:** faa-aircraft-registry-mcp-server
4
- **Version:** 0.1.3
5
- **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.10.9`
4
+ **Version:** 0.1.5
5
+ **Framework:** [@cyanheads/mcp-ts-core](https://www.npmjs.com/package/@cyanheads/mcp-ts-core) `^0.10.14`
6
6
  **Engines:** Bun ≥1.3.0, Node ≥24.0.0
7
7
  **MCP SDK:** `@modelcontextprotocol/sdk` ^1.29.0
8
8
  **Zod:** ^4.4.3
@@ -309,7 +309,6 @@ Available skills:
309
309
  | `tool-defs-analysis` | Read-only audit of MCP definition language across the surface — voice, leaks, defaults, recovery hints, output descriptions |
310
310
  | `security-pass` | Audit server for MCP-flavored security gaps: output injection, scope blast radius, input sinks, tenant isolation |
311
311
  | `code-simplifier` | Post-session cleanup against `git diff` — modernize syntax, consolidate duplication, align with the codebase |
312
- | `devcheck` | Lint, format, typecheck, audit |
313
312
  | `polish-docs-meta` | Finalize docs, README, metadata, and agent protocol for shipping |
314
313
  | `git-wrapup` | Land working-tree changes as a versioned commit + annotated tag — version bump, changelog, verify, tag. Local only. |
315
314
  | `release-and-publish` | Push + npm + MCP Registry + GH Release + Docker. Picks up from `git-wrapup` |
@@ -317,6 +316,7 @@ Available skills:
317
316
  | `orchestrations` | Chain task skills into a gated multi-phase pipeline — build-out, QA-fix, update-ship — when you can spawn sub-agents |
318
317
  | `report-issue-framework` | File a bug or feature request against `@cyanheads/mcp-ts-core` via `gh` CLI |
319
318
  | `report-issue-local` | File a bug or feature request against this server's own repo via `gh` CLI |
319
+ | `techniques` | Catalog of response/data-shaping techniques — overflow handling, payload shaping, retrieval patterns |
320
320
  | `api-auth` | Auth modes, scopes, JWT/OAuth |
321
321
  | `api-canvas` | DataCanvas: register tabular data, run SQL, export, plus the `spillover()` helper for big result sets — Tier 3 opt-in |
322
322
  | `api-config` | AppConfig, parseConfig, env vars |
package/Dockerfile CHANGED
@@ -4,7 +4,7 @@
4
4
  # This stage installs all dependencies (including dev), builds the TypeScript
5
5
  # source code into JavaScript, and prepares the production assets.
6
6
  # ==============================================================================
7
- FROM oven/bun:1.3 AS build
7
+ FROM oven/bun:1.3.14 AS build
8
8
 
9
9
  WORKDIR /usr/src/app
10
10
 
@@ -15,7 +15,9 @@ COPY package.json bun.lock ./
15
15
  # lifecycle scripts so the optional `better-sqlite3` native addon isn't compiled
16
16
  # (node-gyp toolchain is absent on the bun base image) — the runtime uses Bun's
17
17
  # built-in `bun:sqlite`, so the addon is never loaded in this image.
18
- RUN bun install --frozen-lockfile --ignore-scripts
18
+ # The BuildKit cache mount persists Bun's global package cache across builds.
19
+ RUN --mount=type=cache,target=/root/.bun/install/cache \
20
+ bun install --frozen-lockfile --ignore-scripts
19
21
 
20
22
  # Copy the rest of the source code
21
23
  COPY . .
@@ -31,7 +33,7 @@ RUN bun run build
31
33
  # application. It uses a slim base image and only includes production
32
34
  # dependencies and build artifacts.
33
35
  # ==============================================================================
34
- FROM oven/bun:1.3-slim AS production
36
+ FROM oven/bun:1.3.14-slim AS production
35
37
 
36
38
  WORKDIR /usr/src/app
37
39
 
@@ -42,7 +44,7 @@ ENV NODE_ENV=production
42
44
  # OCI image metadata (https://github.com/opencontainers/image-spec/blob/main/annotations.md)
43
45
  ARG APP_VERSION
44
46
  LABEL org.opencontainers.image.title="faa-aircraft-registry-mcp-server"
45
- LABEL org.opencontainers.image.description="Decode N-numbers to aircraft, engine, status, and owner, and search the US civil aircraft registry (FAA Releasable Aircraft Database) by owner, type, or state — offline and keyless over an embedded SQLite + FTS5 mirror, with fail-safe owner-PII redaction."
47
+ LABEL org.opencontainers.image.description="Decode N-numbers to aircraft, engine, status, and owner; search the US civil aircraft registry by owner, type, or state; resolve active/deregistered/reserved status — offline via MCP. STDIO or Streamable HTTP."
46
48
  LABEL org.opencontainers.image.licenses="Apache-2.0"
47
49
  LABEL org.opencontainers.image.version="${APP_VERSION}"
48
50
  LABEL org.opencontainers.image.source="https://github.com/cyanheads/faa-aircraft-registry-mcp-server"
@@ -52,13 +54,15 @@ COPY package.json bun.lock ./
52
54
 
53
55
  # Install only production dependencies, ignoring any lifecycle scripts (like 'prepare')
54
56
  # that are not needed in the final production image.
55
- RUN bun install --production --frozen-lockfile --ignore-scripts
57
+ RUN --mount=type=cache,target=/root/.bun/install/cache \
58
+ bun install --production --frozen-lockfile --ignore-scripts
56
59
 
57
60
  # Conditionally install OpenTelemetry optional peer dependencies (Tier 3).
58
61
  # These are not bundled by default to keep the base image lean. Enable at build time
59
62
  # with: docker build --build-arg OTEL_ENABLED=true
60
63
  ARG OTEL_ENABLED=true
61
- RUN if [ "$OTEL_ENABLED" = "true" ]; then \
64
+ RUN --mount=type=cache,target=/root/.bun/install/cache \
65
+ if [ "$OTEL_ENABLED" = "true" ]; then \
62
66
  bun add @hono/otel \
63
67
  @opentelemetry/instrumentation-http \
64
68
  @opentelemetry/exporter-metrics-otlp-http \
package/LICENSE CHANGED
@@ -186,7 +186,7 @@ Apache License
186
186
  same "printed page" as the copyright notice for easier
187
187
  identification within third-party archives.
188
188
 
189
- Copyright 2025 Casey Hand @cyanheads
189
+ Copyright 2026 Casey Hand @cyanheads
190
190
 
191
191
  Licensed under the Apache License, Version 2.0 (the "License");
192
192
  you may not use this file except in compliance with the License.
package/README.md CHANGED
@@ -7,7 +7,7 @@
7
7
 
8
8
  <div align="center">
9
9
 
10
- [![Version](https://img.shields.io/badge/Version-0.1.3-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/faa-aircraft-registry-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/%40cyanheads%2Ffaa-aircraft-registry-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/faa-aircraft-registry-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3-blueviolet.svg?style=flat-square)](https://bun.sh/)
10
+ [![Version](https://img.shields.io/badge/Version-0.1.5-blue.svg?style=flat-square)](./CHANGELOG.md) [![License](https://img.shields.io/badge/License-Apache%202.0-orange.svg?style=flat-square)](./LICENSE) [![Docker](https://img.shields.io/badge/Docker-ghcr.io-2496ED?style=flat-square&logo=docker&logoColor=white)](https://github.com/users/cyanheads/packages/container/package/faa-aircraft-registry-mcp-server) [![MCP SDK](https://img.shields.io/badge/MCP%20SDK-^1.29.0-green.svg?style=flat-square)](https://modelcontextprotocol.io/) [![npm](https://img.shields.io/npm/v/%40cyanheads%2Ffaa-aircraft-registry-mcp-server?style=flat-square&logo=npm&logoColor=white)](https://www.npmjs.com/package/@cyanheads/faa-aircraft-registry-mcp-server) [![TypeScript](https://img.shields.io/badge/TypeScript-^6.0.3-3178C6.svg?style=flat-square)](https://www.typescriptlang.org/) [![Bun](https://img.shields.io/badge/Bun-v1.3.14-blueviolet.svg?style=flat-square)](https://bun.sh/)
11
11
 
12
12
  </div>
13
13
 
@@ -78,8 +78,9 @@ Full-text search over active registrations, returning decoded summaries with N-n
78
78
 
79
79
  - Filter by `ownerName`, `makeModel`, `state`, `aircraftType`, or `modeSCode`; at least one filter is required
80
80
  - **Owner-name search is disabled when `FAA_REDACT_OWNER_PII` is on** — search by make/model, state, type, or Mode S code instead
81
+ - Free-text terms are column-scoped: `makeModel` matches make/model only, never owner name or city
81
82
  - Each result carries an N-number to pass to `faa_lookup_registration` for full detail
82
- - Discloses truncation when the result count hits `limit` (1–200, default 25), so a partial result set is never mistaken for complete
83
+ - Every response reports `totalCount` across all matches, so a partial result set is never mistaken for complete; page through it with `limit` (1–200, default 25) and `offset` — a truncated response names the `nextOffset` to request
83
84
 
84
85
  ---
85
86
 
@@ -89,7 +90,7 @@ Discover the 7-char manufacturer/model/series codes by name before decoding them
89
90
 
90
91
  - Filter by `query` (manufacturer/model name, full-text), `aircraftType` code, or `category` code; at least one filter is required
91
92
  - Returns reference summaries with the code to pass to `faa_get_aircraft_type`
92
- - Discloses truncation at the `limit` (1–200, default 25)
93
+ - Every response reports `totalCount` across all matches; page through it with `limit` (1–200, default 25) and `offset` — a truncated response names the `nextOffset` to request
93
94
 
94
95
  ## Resources
95
96
 
@@ -0,0 +1,31 @@
1
+ ---
2
+ summary: "Column-scopes faa_search_registrations FTS matching to close a PII-redaction bypass, adds offset pagination to both search tools, corrects 'bundled registry' description drift, and adopts mcp-ts-core ^0.10.14 with a bun install supply-chain guard."
3
+ breaking: false
4
+ security: true
5
+ ---
6
+
7
+ # 0.1.4 — 2026-07-15
8
+
9
+ ## Added
10
+
11
+ - **`faa_search_registrations` / `faa_search_aircraft_types`** — `offset` input and `totalCount`/`nextOffset` enrichment fields for paging through capped result sets ([#4](https://github.com/cyanheads/faa-aircraft-registry-mcp-server/issues/4)).
12
+
13
+ ## Changed
14
+
15
+ - **`faa_search_registrations` / `faa_search_aircraft_types`** — `truncated` now means "more results remain beyond this page" instead of "the result set was capped." Identical for every existing `offset=0` caller; only pagination walkers observe the new meaning ([#4](https://github.com/cyanheads/faa-aircraft-registry-mcp-server/issues/4)).
16
+ - **Docs** — `search-registrations.tool.ts` and `docs/design.md` corrected from "bundled registry"/"bundled on disk" to "local registry index"/"indexed on disk," matching the README's existing "not bundled" framing ([#2](https://github.com/cyanheads/faa-aircraft-registry-mcp-server/issues/2)).
17
+ - **Framework** — `@cyanheads/mcp-ts-core` `^0.10.9` → `^0.10.14`; re-synced 12 agent skills and 4 devcheck scripts to match.
18
+ - **`bunfig.toml`** — added a supply-chain guard: `install.minimumReleaseAge` blocks packages published under 3 days old (first-party `@cyanheads/mcp-ts-core` excluded), and `install.security.scanner` wires in `@socketsecurity/bun-security-scanner`.
19
+
20
+ ## Security
21
+
22
+ - **`faa_search_registrations`** — `makeModel` and `ownerName` free-text search is now column-scoped (`make`/`model` only; `owner_name`/`other_names` only) instead of matching every indexed FTS column. A `makeModel` query previously also matched `city` and `owner_name`, letting search probe fields the owner-PII redaction gate is meant to withhold; a search term that escapes to an empty FTS clause now returns zero results instead of silently matching every row ([#3](https://github.com/cyanheads/faa-aircraft-registry-mcp-server/issues/3)).
23
+
24
+ ## Dependencies
25
+
26
+ - `@cyanheads/mcp-ts-core` `^0.10.9` → `^0.10.14`
27
+ - `@biomejs/biome` `2.5.0` → `2.5.2`
28
+ - `@types/node` `26.0.0` → `26.1.1`
29
+ - `tsc-alias` `^1.8.17` → `^1.9.0`
30
+ - `js-yaml` `3.14.2` → `3.15.0` (transitive via `depcheck`; clears GHSA-h67p-54hq-rp68 — not from the core bump)
31
+ - Added `@socketsecurity/bun-security-scanner` `^1.1.2`
@@ -0,0 +1,15 @@
1
+ ---
2
+ summary: "Bounds registry rebuild peak memory to the largest single file via lazy ZIP inflation, streamed line parsing, and chunked auxiliary transactions (measured ~2.35 GiB to ~0.74 GiB); syncs the Dockerfile OCI description label to package.json."
3
+ breaking: false
4
+ security: false
5
+ ---
6
+
7
+ # 0.1.5 — 2026-07-16
8
+
9
+ ## Changed
10
+
11
+ - **Dockerfile** — `org.opencontainers.image.description` OCI label synced to `package.json`'s current description (previously carried older wording).
12
+
13
+ ## Fixed
14
+
15
+ - **Registry rebuild** — full mirror rebuild (`mirror:init`/`mirror:refresh`) peak memory now scales with the **largest single file** in the FAA archive instead of the sum of all files, via lazy per-entry ZIP inflation (`zip.ts`'s `openZipArchive`/`readEntry`, replacing eager `readZipEntries`), streamed latin1 line decoding (`csv.ts`'s `parseCsv` now takes the raw entry `Buffer`), and `PAGE_SIZE`-chunked auxiliary-table transactions. Measured peak RSS on a real `mirror:refresh` dropped from ~2.35 GiB to ~0.74 GiB, with identical row counts ([#6](https://github.com/cyanheads/faa-aircraft-registry-mcp-server/issues/6)).
@@ -15,9 +15,11 @@ summary: ""
15
15
  # usage. Flagged as `Breaking` in the rollup.
16
16
  breaking: false
17
17
 
18
- # Set `true` if this release contains any security fix. Pairs with the
19
- # `## Security` section below. Flagged as `Security` in the rollup so
20
- # users can triage upgrade urgency at a glance.
18
+ # Set `true` ONLY for a security fix in THIS project's own source code — a
19
+ # vulnerability or hardening in code you ship. A dependency or transitive CVE
20
+ # bump is routine maintenance, NOT a security release: record it under
21
+ # `## Dependencies` (with the advisory ID) and leave this `false`. When true,
22
+ # pairs with the `## Security` section below and flags `Security` in the rollup.
21
23
  security: false
22
24
 
23
25
  # Optional free-form notes for maintenance agents processing this release.
@@ -140,6 +140,7 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
140
140
  aircraftType: import("zod").ZodOptional<import("zod").ZodString>;
141
141
  category: import("zod").ZodOptional<import("zod").ZodString>;
142
142
  limit: import("zod").ZodDefault<import("zod").ZodNumber>;
143
+ offset: import("zod").ZodDefault<import("zod").ZodNumber>;
143
144
  }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
144
145
  aircraftTypes: import("zod").ZodArray<import("zod").ZodObject<{
145
146
  code: import("zod").ZodString;
@@ -162,6 +163,8 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
162
163
  readonly when: "No search filter was supplied.";
163
164
  readonly recovery: "Provide a query (manufacturer/model name), an aircraftType code, or a category code to search.";
164
165
  }], {
166
+ readonly totalCount: import("zod").ZodNumber;
167
+ readonly nextOffset: import("zod").ZodOptional<import("zod").ZodNumber>;
165
168
  readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
166
169
  readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
167
170
  readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
@@ -173,6 +176,7 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
173
176
  aircraftType: import("zod").ZodOptional<import("zod").ZodString>;
174
177
  modeSCode: import("zod").ZodOptional<import("zod").ZodString>;
175
178
  limit: import("zod").ZodDefault<import("zod").ZodNumber>;
179
+ offset: import("zod").ZodDefault<import("zod").ZodNumber>;
176
180
  }, import("zod/v4/core").$strip>, import("zod").ZodObject<{
177
181
  registrations: import("zod").ZodArray<import("zod").ZodObject<{
178
182
  nNumber: import("zod").ZodString;
@@ -204,6 +208,8 @@ export declare const allToolDefinitions: (import("@cyanheads/mcp-ts-core").ToolD
204
208
  readonly when: "No search filter was supplied.";
205
209
  readonly recovery: "Provide at least one of makeModel, state, aircraftType, or modeSCode (or ownerName when owner PII is unredacted).";
206
210
  }], {
211
+ readonly totalCount: import("zod").ZodNumber;
212
+ readonly nextOffset: import("zod").ZodOptional<import("zod").ZodNumber>;
207
213
  readonly truncated: import("zod").ZodOptional<import("zod").ZodBoolean>;
208
214
  readonly shown: import("zod").ZodOptional<import("zod").ZodNumber>;
209
215
  readonly cap: import("zod").ZodOptional<import("zod").ZodNumber>;
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAM9B,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAM9B,CAAC"}
@@ -2,7 +2,7 @@
2
2
  * @fileoverview faa_search_aircraft_types — search the aircraft reference table by
3
3
  * manufacturer/model name, aircraft type, or category to discover the 7-char
4
4
  * manufacturer/model codes and browse specs. Fills the discovery gap before
5
- * faa_get_aircraft_type. Discloses truncation when the result set hits the limit.
5
+ * faa_get_aircraft_type. Discloses the total match count and pages via offset.
6
6
  * @module mcp-server/tools/definitions/search-aircraft-types.tool
7
7
  */
8
8
  import { z } from '@cyanheads/mcp-ts-core';
@@ -12,6 +12,7 @@ export declare const searchAircraftTypesTool: import("@cyanheads/mcp-ts-core").T
12
12
  aircraftType: z.ZodOptional<z.ZodString>;
13
13
  category: z.ZodOptional<z.ZodString>;
14
14
  limit: z.ZodDefault<z.ZodNumber>;
15
+ offset: z.ZodDefault<z.ZodNumber>;
15
16
  }, z.core.$strip>, z.ZodObject<{
16
17
  aircraftTypes: z.ZodArray<z.ZodObject<{
17
18
  code: z.ZodString;
@@ -34,6 +35,8 @@ export declare const searchAircraftTypesTool: import("@cyanheads/mcp-ts-core").T
34
35
  readonly when: "No search filter was supplied.";
35
36
  readonly recovery: "Provide a query (manufacturer/model name), an aircraftType code, or a category code to search.";
36
37
  }], {
38
+ readonly totalCount: z.ZodNumber;
39
+ readonly nextOffset: z.ZodOptional<z.ZodNumber>;
37
40
  readonly truncated: z.ZodOptional<z.ZodBoolean>;
38
41
  readonly shown: z.ZodOptional<z.ZodNumber>;
39
42
  readonly cap: z.ZodOptional<z.ZodNumber>;
@@ -1 +1 @@
1
- {"version":3,"file":"search-aircraft-types.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-aircraft-types.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAwBjE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA8GlC,CAAC"}
1
+ {"version":3,"file":"search-aircraft-types.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-aircraft-types.tool.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAwBjE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAgJlC,CAAC"}
@@ -2,7 +2,7 @@
2
2
  * @fileoverview faa_search_aircraft_types — search the aircraft reference table by
3
3
  * manufacturer/model name, aircraft type, or category to discover the 7-char
4
4
  * manufacturer/model codes and browse specs. Fills the discovery gap before
5
- * faa_get_aircraft_type. Discloses truncation when the result set hits the limit.
5
+ * faa_get_aircraft_type. Discloses the total match count and pages via offset.
6
6
  * @module mcp-server/tools/definitions/search-aircraft-types.tool
7
7
  */
8
8
  import { tool, z } from '@cyanheads/mcp-ts-core';
@@ -26,7 +26,7 @@ const aircraftTypeSummarySchema = z
26
26
  .describe('A decoded aircraft-reference summary; use code with faa_get_aircraft_type for full specs.');
27
27
  export const searchAircraftTypesTool = tool('faa_search_aircraft_types', {
28
28
  title: 'faa-aircraft-registry-mcp-server: search aircraft types',
29
- description: 'Search the FAA aircraft reference table by manufacturer/model name (full-text), aircraft type code, or category code to discover 7-character manufacturer/model/series codes and browse specifications. Use this before faa_get_aircraft_type to find a code by name. At least one filter is required. When the result count hits the limit, the response discloses truncation.',
29
+ description: 'Search the FAA aircraft reference table by manufacturer/model name (full-text), aircraft type code, or category code to discover 7-character manufacturer/model/series codes and browse specifications. Use this before faa_get_aircraft_type to find a code by name. At least one filter is required. Every response reports totalCount (all matches, not just this page); when more remain, it returns nextOffset — pass it back as offset to page forward.',
30
30
  annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
31
31
  input: z.object({
32
32
  query: z.string().optional().describe('Manufacturer and/or model name to match (full-text).'),
@@ -45,23 +45,42 @@ export const searchAircraftTypesTool = tool('faa_search_aircraft_types', {
45
45
  .max(200)
46
46
  .default(25)
47
47
  .describe('Maximum number of results to return (1–200, default 25).'),
48
+ offset: z
49
+ .number()
50
+ .int()
51
+ .min(0)
52
+ .default(0)
53
+ .describe('Zero-based index of the first result to return — pass the nextOffset from a previous response, with identical filters, to page forward (default 0).'),
48
54
  }),
49
55
  output: z.object({
50
56
  aircraftTypes: z
51
57
  .array(aircraftTypeSummarySchema)
52
- .describe('Matching aircraft-reference summaries (up to limit).'),
58
+ .describe('Matching aircraft-reference summaries for this page (up to limit).'),
53
59
  }),
54
60
  enrichment: {
61
+ totalCount: z
62
+ .number()
63
+ .describe('Total aircraft types matching the filters, across all pages. Always present.'),
64
+ nextOffset: z
65
+ .number()
66
+ .optional()
67
+ .describe('Offset to request the next page; absent when this page reached the end of the matches.'),
55
68
  truncated: z
56
69
  .boolean()
57
70
  .optional()
58
- .describe('Present and true only when the result set was capped at the limit — more matches exist.'),
59
- shown: z.number().optional().describe('Number of results returned (present only when capped).'),
60
- cap: z.number().optional().describe('The limit that was applied (present only when capped).'),
71
+ .describe('Present and true only when matches remain beyond this page.'),
72
+ shown: z
73
+ .number()
74
+ .optional()
75
+ .describe('Number of results on this page (present only when truncated is set).'),
76
+ cap: z
77
+ .number()
78
+ .optional()
79
+ .describe('The limit that was applied (present only when truncated is set).'),
61
80
  notice: z
62
81
  .string()
63
82
  .optional()
64
- .describe('Guidance when no aircraft types matched the supplied filters.'),
83
+ .describe('Guidance when no aircraft types matched, or when more matches remain.'),
65
84
  },
66
85
  errors: [
67
86
  {
@@ -86,12 +105,25 @@ export const searchAircraftTypesTool = tool('faa_search_aircraft_types', {
86
105
  ...(aircraftType ? { aircraftType } : {}),
87
106
  ...(category ? { category } : {}),
88
107
  limit: input.limit,
108
+ offset: input.offset,
89
109
  }, ctx);
110
+ // Always populated — a required enrichment field must survive every success
111
+ // path, including the zero-result one.
112
+ ctx.enrich.total(page.totalCount);
113
+ const nextOffset = input.offset + page.items.length;
114
+ if (page.truncated)
115
+ ctx.enrich({ nextOffset });
90
116
  if (page.items.length === 0) {
91
- ctx.enrich.notice('No aircraft types matched the supplied filters. Broaden the name query or verify the type/category code.');
117
+ ctx.enrich.notice(page.totalCount > 0
118
+ ? `Offset ${input.offset} is past the end of this result set — ${page.totalCount} aircraft types match, but none remain at that offset. Retry with a lower offset.`
119
+ : 'No aircraft types matched the supplied filters. Broaden the name query or verify the type/category code.');
92
120
  }
93
121
  if (page.truncated) {
94
- ctx.enrich.truncated({ shown: page.items.length, cap: page.cap });
122
+ ctx.enrich.truncated({
123
+ shown: page.items.length,
124
+ cap: page.cap,
125
+ guidance: `Showing ${page.items.length} of ${page.totalCount} matching aircraft types. Call faa_search_aircraft_types again with the same filters and offset: ${nextOffset} for the next page.`,
126
+ });
95
127
  }
96
128
  return { aircraftTypes: page.items };
97
129
  },
@@ -1 +1 @@
1
- {"version":3,"file":"search-aircraft-types.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-aircraft-types.tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"search-aircraft-types.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-aircraft-types.tool.ts"],"names":[],"mappings":"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"}
@@ -1,10 +1,11 @@
1
1
  /**
2
2
  * @fileoverview faa_search_registrations — search active registrations by owner
3
- * name, make/model, state, aircraft type, or Mode S code. FTS5 over the bundled
4
- * index; results are decoded summaries carrying N-numbers for follow-up
5
- * faa_lookup_registration calls. Owner-name search is disabled when owner-PII
6
- * redaction is on (so the search input can't be used to confirm a person↔aircraft
7
- * link). Discloses truncation when the result set hits the limit.
3
+ * name, make/model, state, aircraft type, or Mode S code. FTS5 over the local
4
+ * on-disk index; results are decoded summaries carrying N-numbers for follow-up
5
+ * faa_lookup_registration calls. Free-text terms are column-scoped, so makeModel
6
+ * matches make/model only and never owner or city. Owner-name search is disabled
7
+ * when owner-PII redaction is on (so the search input can't be used to confirm a
8
+ * person↔aircraft link). Discloses the total match count and pages via offset.
8
9
  * @module mcp-server/tools/definitions/search-registrations.tool
9
10
  */
10
11
  import { z } from '@cyanheads/mcp-ts-core';
@@ -16,6 +17,7 @@ export declare const searchRegistrationsTool: import("@cyanheads/mcp-ts-core").T
16
17
  aircraftType: z.ZodOptional<z.ZodString>;
17
18
  modeSCode: z.ZodOptional<z.ZodString>;
18
19
  limit: z.ZodDefault<z.ZodNumber>;
20
+ offset: z.ZodDefault<z.ZodNumber>;
19
21
  }, z.core.$strip>, z.ZodObject<{
20
22
  registrations: z.ZodArray<z.ZodObject<{
21
23
  nNumber: z.ZodString;
@@ -47,6 +49,8 @@ export declare const searchRegistrationsTool: import("@cyanheads/mcp-ts-core").T
47
49
  readonly when: "No search filter was supplied.";
48
50
  readonly recovery: "Provide at least one of makeModel, state, aircraftType, or modeSCode (or ownerName when owner PII is unredacted).";
49
51
  }], {
52
+ readonly totalCount: z.ZodNumber;
53
+ readonly nextOffset: z.ZodOptional<z.ZodNumber>;
50
54
  readonly truncated: z.ZodOptional<z.ZodBoolean>;
51
55
  readonly shown: z.ZodOptional<z.ZodNumber>;
52
56
  readonly cap: z.ZodOptional<z.ZodNumber>;
@@ -1 +1 @@
1
- {"version":3,"file":"search-registrations.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-registrations.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAyBjE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA2IlC,CAAC"}
1
+ {"version":3,"file":"search-registrations.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-registrations.tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAyBjE,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA6KlC,CAAC"}
@@ -1,10 +1,11 @@
1
1
  /**
2
2
  * @fileoverview faa_search_registrations — search active registrations by owner
3
- * name, make/model, state, aircraft type, or Mode S code. FTS5 over the bundled
4
- * index; results are decoded summaries carrying N-numbers for follow-up
5
- * faa_lookup_registration calls. Owner-name search is disabled when owner-PII
6
- * redaction is on (so the search input can't be used to confirm a person↔aircraft
7
- * link). Discloses truncation when the result set hits the limit.
3
+ * name, make/model, state, aircraft type, or Mode S code. FTS5 over the local
4
+ * on-disk index; results are decoded summaries carrying N-numbers for follow-up
5
+ * faa_lookup_registration calls. Free-text terms are column-scoped, so makeModel
6
+ * matches make/model only and never owner or city. Owner-name search is disabled
7
+ * when owner-PII redaction is on (so the search input can't be used to confirm a
8
+ * person↔aircraft link). Discloses the total match count and pages via offset.
8
9
  * @module mcp-server/tools/definitions/search-registrations.tool
9
10
  */
10
11
  import { tool, z } from '@cyanheads/mcp-ts-core';
@@ -31,7 +32,7 @@ const registrationSummarySchema = z
31
32
  .describe('A decoded registration summary; use nNumber with faa_lookup_registration for full detail.');
32
33
  export const searchRegistrationsTool = tool('faa_search_registrations', {
33
34
  title: 'faa-aircraft-registry-mcp-server: search registrations',
34
- description: 'Search active US civil aircraft registrations by owner name, make/model, state, aircraft type, or Mode S (hex) code. Full-text search over the bundled registry; returns decoded summaries with N-numbers to drill into via faa_lookup_registration. At least one filter is required. Owner-name search is unavailable when this deployment redacts owner PII — search by make/model, state, aircraft type, or Mode S code instead. When the result count hits the limit, the response discloses truncation.',
35
+ description: 'Search active US civil aircraft registrations by owner name, make/model, state, aircraft type, or Mode S (hex) code. Full-text search over the local registry index; returns decoded summaries with N-numbers to drill into via faa_lookup_registration. At least one filter is required. Owner-name search is unavailable when this deployment redacts owner PII — search by make/model, state, aircraft type, or Mode S code instead. Every response reports totalCount (all matches, not just this page); when more remain, it returns nextOffset — pass it back as offset to page forward.',
35
36
  annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
36
37
  input: z.object({
37
38
  ownerName: z
@@ -55,23 +56,42 @@ export const searchRegistrationsTool = tool('faa_search_registrations', {
55
56
  .max(200)
56
57
  .default(25)
57
58
  .describe('Maximum number of results to return (1–200, default 25).'),
59
+ offset: z
60
+ .number()
61
+ .int()
62
+ .min(0)
63
+ .default(0)
64
+ .describe('Zero-based index of the first result to return — pass the nextOffset from a previous response, with identical filters, to page forward (default 0).'),
58
65
  }),
59
66
  output: z.object({
60
67
  registrations: z
61
68
  .array(registrationSummarySchema)
62
- .describe('Matching registration summaries (up to limit).'),
69
+ .describe('Matching registration summaries for this page (up to limit).'),
63
70
  }),
64
71
  enrichment: {
72
+ totalCount: z
73
+ .number()
74
+ .describe('Total registrations matching the filters, across all pages. Always present.'),
75
+ nextOffset: z
76
+ .number()
77
+ .optional()
78
+ .describe('Offset to request the next page; absent when this page reached the end of the matches.'),
65
79
  truncated: z
66
80
  .boolean()
67
81
  .optional()
68
- .describe('Present and true only when the result set was capped at the limit — more matches exist.'),
69
- shown: z.number().optional().describe('Number of results returned (present only when capped).'),
70
- cap: z.number().optional().describe('The limit that was applied (present only when capped).'),
82
+ .describe('Present and true only when matches remain beyond this page.'),
83
+ shown: z
84
+ .number()
85
+ .optional()
86
+ .describe('Number of results on this page (present only when truncated is set).'),
87
+ cap: z
88
+ .number()
89
+ .optional()
90
+ .describe('The limit that was applied (present only when truncated is set).'),
71
91
  notice: z
72
92
  .string()
73
93
  .optional()
74
- .describe('Guidance when no registrations matched the supplied filters.'),
94
+ .describe('Guidance when no registrations matched, or when more matches remain.'),
75
95
  },
76
96
  errors: [
77
97
  {
@@ -111,12 +131,25 @@ export const searchRegistrationsTool = tool('faa_search_registrations', {
111
131
  ...(aircraftType ? { aircraftType } : {}),
112
132
  ...(modeSCode ? { modeSCode } : {}),
113
133
  limit: input.limit,
134
+ offset: input.offset,
114
135
  }, ctx);
136
+ // Always populated — a required enrichment field must survive every success
137
+ // path, including the zero-result one.
138
+ ctx.enrich.total(page.totalCount);
139
+ const nextOffset = input.offset + page.items.length;
140
+ if (page.truncated)
141
+ ctx.enrich({ nextOffset });
115
142
  if (page.items.length === 0) {
116
- ctx.enrich.notice('No registrations matched the supplied filters. Broaden the make/model terms, verify the state or Mode S code, or remove a filter.');
143
+ ctx.enrich.notice(page.totalCount > 0
144
+ ? `Offset ${input.offset} is past the end of this result set — ${page.totalCount} registrations match, but none remain at that offset. Retry with a lower offset.`
145
+ : 'No registrations matched the supplied filters. Broaden the make/model terms, verify the state or Mode S code, or remove a filter.');
117
146
  }
118
147
  if (page.truncated) {
119
- ctx.enrich.truncated({ shown: page.items.length, cap: page.cap });
148
+ ctx.enrich.truncated({
149
+ shown: page.items.length,
150
+ cap: page.cap,
151
+ guidance: `Showing ${page.items.length} of ${page.totalCount} matching registrations. Call faa_search_registrations again with the same filters and offset: ${nextOffset} for the next page.`,
152
+ });
120
153
  }
121
154
  return { registrations: page.items };
122
155
  },
@@ -1 +1 @@
1
- {"version":3,"file":"search-registrations.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-registrations.tool.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"search-registrations.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-registrations.tool.ts"],"names":[],"mappings":"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"}