@ultimat3/query 22.9.0 → 22.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/query",
-  "version": "22.9.0",
+  "version": "22.10.0",
   "description": "The query primitive: a policy-checked read, optionally live, with cursor pagination and an incremental matcher",
   "license": "MIT",
   "type": "module",
@@ -36,11 +36,11 @@
     "test": "bun test"
   },
   "dependencies": {
-    "@ultimat3/cache": "22.9.0",
-    "@ultimat3/core": "22.9.0",
-    "@ultimat3/entity": "22.9.0",
-    "@ultimat3/http": "22.9.0",
-    "@ultimat3/policy": "22.9.0",
-    "@ultimat3/schema": "22.9.0"
+    "@ultimat3/cache": "22.10.0",
+    "@ultimat3/core": "22.10.0",
+    "@ultimat3/entity": "22.10.0",
+    "@ultimat3/http": "22.10.0",
+    "@ultimat3/policy": "22.10.0",
+    "@ultimat3/schema": "22.10.0"
   }
 }

package/src/errors.ts

@@ -1,5 +1,5 @@
 /** Every failure @ultimat3/query can produce, one subclass per stable code. */
-import { assertNever, registerErrorCodes, UltimateError } from '@ultimat3/core';
+import { assertNever, deniedCallerFix, registerErrorCodes, UltimateError } from '@ultimat3/core';
 import type { SurfaceDenial } from '@ultimat3/policy';
 
 // No `docs:` on the classes below.
@@ -87,6 +87,7 @@ export class QueryDeniedError extends UltimateError {
       code,
       cause: `${query} denied: ${denialReason(denial)}`,
       fix: `x policy explain ${query} --json   # shows which clause decided and why`,
+      callerFix: deniedCallerFix(),
     });
     this.denial = denial;
   }

package/src/index.ts

@@ -142,6 +142,7 @@ export type {
   QueryListFilterOp,
   QueryListParams,
   QueryMcp,
+  QueryMcpAnnotations,
   QueryOptions,
   QueryRateLimit,
   SourceOptions,

package/src/query.ts

@@ -62,6 +62,21 @@ export interface QueryMcp {
    * implements them; `manage_resource` refuses anything outside the whitelist before it runs.
    */
   readonly listParams?: QueryListParams;
+  /** The tool's display name in an MCP client. See `ActionMcp.title`. */
+  readonly title?: string;
+  /**
+   * MCP tool annotations, overriding the derived `readOnlyHint: true` key by key — `openWorldHint:
+   * true` for a read that reaches outside the app. See `ActionMcp.annotations`.
+   */
+  readonly annotations?: QueryMcpAnnotations;
+}
+
+/** Structural twin of `@ultimat3/action`'s `McpAnnotationHints` (siblings cannot import). */
+export interface QueryMcpAnnotations {
+  readonly readOnlyHint?: boolean;
+  readonly destructiveHint?: boolean;
+  readonly idempotentHint?: boolean;
+  readonly openWorldHint?: boolean;
 }
 
 /** One comparison a list filter accepts. A filter key is `<field><op>`: `status_eq`. */