@vectros-ai/mcp-server 0.11.0 → 0.13.0

package/CHANGELOG.md

@@ -3,6 +3,72 @@
 All notable changes to `@vectros-ai/mcp-server` are documented here.
 This project adheres to [Semantic Versioning](https://semver.org).
 
+## 0.13.0
+
+### Added
+
+- **`record_query` can now look up a record by several fields at once — for a
+  type whose schema declares a lookup over those fields together** (not any
+  two fields you pick; see the type's schema, e.g. via `list_schemas`). Pass
+  the comma-joined field names (e.g. `"status,area"`) with one value per field
+  in the new `values` array — or a single `value`, which is exactly a
+  one-element `values` (matches the first named field, grouping by the rest).
+  Supplying fewer values than the lookup declares — as long as they're a
+  leading run of its fields — returns records grouped by the fields left
+  unspecified; `from`/`to`/`prefix` are not valid on a composite field
+  (exact-match only). Also new: `sortFrom`/`sortTo` narrow an exact-match
+  (`value` or a full `values`) lookup to a window of the field's sort key
+  instead of paging the whole match. Record lookups only; document lookups
+  are unchanged.
+- **`current_identity` (and the `identity` resource) now report `mcpServerVersion` and
+  `sdkVersion`**, so you can tell exactly which server build and bundled SDK version a
+  running instance is talking with.
+
+### Fixed
+
+- **`list_schemas` (and the `schemas` resource) no longer risk hanging on an unusual
+  empty-page response.** Draining the schema catalog now stops with a clear error
+  instead of paging forever if the backend ever returns an empty page alongside a
+  cursor that keeps claiming more remain.
+
+### Changed
+
+- **Dependency maintenance** — repinned the bundled `@vectros-ai/sdk` to `0.38.0`.
+  This pulls in a **Vectros API-side** pagination fix (distinct from the client-side
+  guard above): a listing or lookup could previously report itself complete while
+  results remained on a large page read; the API itself now always pages correctly,
+  and every tool here that pages already trusted the cursor rather than the page
+  size, so this is inherited automatically.
+
+## 0.12.0
+
+### Fixed
+
+- **`document_get`/`document_update` selector errors now name the right parameter.**
+  Calling either tool with a bad or missing selector previously told you to
+  "provide `id`" — but their actual parameter is `documentId`; `id` isn't
+  recognized at all. A caller reasonably assuming symmetry with `record_get`
+  (which genuinely does use `id`) got an error message that appeared to confirm
+  the wrong fix. Both selector-validation messages now say `documentId`;
+  `record_get`/`record_update` are unchanged (their parameter really is `id`).
+
+### Changed
+
+- **`hybrid_search` results now carry `externalId` per hit, and the response
+  includes `hasMore`.** `externalId` lets you correlate a hit back to your own
+  record/document identity without a follow-up lookup (null if the item was
+  ingested without one, or indexed before this field existed). `hasMore` tells
+  you explicitly whether more results are available past the current page.
+- **The `textLegEmpty` diagnostic no longer fires on every non-empty TEXT-mode
+  search.** It's based on each hit's keyword-relevance score, which the API
+  previously reported as `0` for every TEXT-mode result regardless of actual
+  relevance; TEXT-mode now returns a real, meaningful score, so the diagnostic
+  only fires when the keyword leg genuinely contributed nothing.
+- **Dependency maintenance** — repinned the bundled `@vectros-ai/sdk` to `0.37.0`
+  (additive `basedOn` schema customization, `specificityRank` on namespaces, and
+  the search/RAG response fields above). The server bundles the SDK into its
+  published output, so this is a rebuild against the current SDK.
+
 ## 0.11.0
 
 Refreshed to the 0.36.0 Vectros API, with clearer, more actionable errors and a

package/README.md

@@ -184,7 +184,7 @@ available.
 | Tool | What it does |
 |---|---|
 | `list_schemas` | List the record-schema catalog the credential can see (filter by `surface` or resolve one by `recordType`). Makes `record_query` / `record_create` discoverable. |
-| `record_query` | Query records by lookup field (equality / range / prefix, with `asc`/`desc` ordering) or list mode (filter by ownership + type). |
+| `record_query` | Query records by lookup field — equality (`value`), range, or prefix, with `asc`/`desc` ordering and an optional `sortFrom`/`sortTo` window — or list mode (filter by ownership + type). Also supports composite equality across 2-3 fields (`values`), but only against a lookup the *schema* declares over those fields together (see `list_schemas`) — not any two fields you pick. |
 | `record_get` | Fetch one record by id, including its full payload (large payloads truncated to protect the agent context window). |
 | `record_create` | Create a record of a given type; idempotent by `externalId`; optional per-record `indexMode`. |
 | `record_update` | Patch a record's payload (deep-merged; `null` deletes a key); optimistic concurrency via `expectedVersion`. |
@@ -213,7 +213,7 @@ available.
 
 | Tool | What it does |
 |---|---|
-| `current_identity` | Describe the credential: tenantId, environment, principalType, principalKeyId, and (for scoped credentials) allowedActions + dataScope. |
+| `current_identity` | Describe the credential: tenantId, environment, principalType, principalKeyId, and (for scoped credentials) allowedActions + dataScope. Also reports this server's own version and the bundled SDK version (`mcpServerVersion`, `sdkVersion`). |
 | `lookup_principal` | Resolve a user / org / client by your own `externalId` (→ its Vectros UUID, for the ownership filters) or by a schema lookup field. Read-only. |
 | `version_history` | Read the audit/version trail (CREATE/UPDATE/DELETE, with actor + diff) for one record or document. Read-only. |