@hotmeshio/long-tail 0.30.2 → 0.30.4

package/build/system/mcp-servers/admin/schemas.d.ts

@@ -2468,13 +2468,16 @@ export declare const upsertScanSchemeSchema: z.ZodObject<{
     name: z.ZodString;
     description: z.ZodOptional<z.ZodString>;
     target_facet: z.ZodString;
-    encoding: z.ZodOptional<z.ZodEnum<["fixed", "delimited", "gtin"]>>;
+    encoding: z.ZodOptional<z.ZodEnum<["fixed", "delimited", "gtin", "pattern"]>>;
     delimiter: z.ZodOptional<z.ZodString>;
     target_length: z.ZodOptional<z.ZodNumber>;
     kind: z.ZodOptional<z.ZodEnum<["action", "identity"]>>;
     grant_ttl_seconds: z.ZodOptional<z.ZodNumber>;
     grant_max_uses: z.ZodOptional<z.ZodNumber>;
     grant_scope: z.ZodOptional<z.ZodEnum<["action", "subject"]>>;
+    patterns: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    precedes_gtin: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+    target_match: z.ZodOptional<z.ZodEnum<["value", "member"]>>;
     enabled: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     version: number;
@@ -2483,9 +2486,12 @@ export declare const upsertScanSchemeSchema: z.ZodObject<{
     kind?: "action" | "identity" | undefined;
     enabled?: boolean | undefined;
     description?: string | undefined;
-    encoding?: "fixed" | "delimited" | "gtin" | undefined;
+    encoding?: "fixed" | "delimited" | "gtin" | "pattern" | undefined;
     target_length?: number | undefined;
     delimiter?: string | undefined;
+    patterns?: string[] | undefined;
+    precedes_gtin?: boolean | null | undefined;
+    target_match?: "value" | "member" | undefined;
     grant_ttl_seconds?: number | undefined;
     grant_max_uses?: number | undefined;
     grant_scope?: "action" | "subject" | undefined;
@@ -2496,9 +2502,12 @@ export declare const upsertScanSchemeSchema: z.ZodObject<{
     kind?: "action" | "identity" | undefined;
     enabled?: boolean | undefined;
     description?: string | undefined;
-    encoding?: "fixed" | "delimited" | "gtin" | undefined;
+    encoding?: "fixed" | "delimited" | "gtin" | "pattern" | undefined;
     target_length?: number | undefined;
     delimiter?: string | undefined;
+    patterns?: string[] | undefined;
+    precedes_gtin?: boolean | null | undefined;
+    target_match?: "value" | "member" | undefined;
     grant_ttl_seconds?: number | undefined;
     grant_max_uses?: number | undefined;
     grant_scope?: "action" | "subject" | undefined;
@@ -2671,6 +2680,11 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
                 separator?: string | undefined;
             }>>;
         }, "strip", z.ZodTypeAny, {
+            fill?: {
+                into: "subject" | "scanned";
+                payload?: Record<string, any> | undefined;
+                separator?: string | undefined;
+            } | undefined;
             accumulate?: {
                 item?: {
                     roles?: string[] | undefined;
@@ -2700,11 +2714,6 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
                 headline?: string | undefined;
                 subline?: string | undefined;
             } | undefined;
-            fill?: {
-                into: "subject" | "scanned";
-                payload?: Record<string, any> | undefined;
-                separator?: string | undefined;
-            } | undefined;
             metadata?: Record<string, any> | undefined;
             description?: string | undefined;
             itemKey?: string | undefined;
@@ -2714,6 +2723,11 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
             escalationType?: string | undefined;
             closeCurrent?: "resolve" | "cancel" | undefined;
         }, {
+            fill?: {
+                into: "subject" | "scanned";
+                payload?: Record<string, any> | undefined;
+                separator?: string | undefined;
+            } | undefined;
             accumulate?: {
                 item?: {
                     roles?: string[] | undefined;
@@ -2743,11 +2757,6 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
                 headline?: string | undefined;
                 subline?: string | undefined;
             } | undefined;
-            fill?: {
-                into: "subject" | "scanned";
-                payload?: Record<string, any> | undefined;
-                separator?: string | undefined;
-            } | undefined;
             metadata?: Record<string, any> | undefined;
             description?: string | undefined;
             itemKey?: string | undefined;
@@ -2893,6 +2902,11 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
                     separator?: string | undefined;
                 }>>;
             }, "strip", z.ZodTypeAny, {
+                fill?: {
+                    into: "subject" | "scanned";
+                    payload?: Record<string, any> | undefined;
+                    separator?: string | undefined;
+                } | undefined;
                 accumulate?: {
                     item?: {
                         roles?: string[] | undefined;
@@ -2922,11 +2936,6 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
                     headline?: string | undefined;
                     subline?: string | undefined;
                 } | undefined;
-                fill?: {
-                    into: "subject" | "scanned";
-                    payload?: Record<string, any> | undefined;
-                    separator?: string | undefined;
-                } | undefined;
                 metadata?: Record<string, any> | undefined;
                 description?: string | undefined;
                 itemKey?: string | undefined;
@@ -2936,6 +2945,11 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
                 escalationType?: string | undefined;
                 closeCurrent?: "resolve" | "cancel" | undefined;
             }, {
+                fill?: {
+                    into: "subject" | "scanned";
+                    payload?: Record<string, any> | undefined;
+                    separator?: string | undefined;
+                } | undefined;
                 accumulate?: {
                     item?: {
                         roles?: string[] | undefined;
@@ -2965,11 +2979,6 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
                     headline?: string | undefined;
                     subline?: string | undefined;
                 } | undefined;
-                fill?: {
-                    into: "subject" | "scanned";
-                    payload?: Record<string, any> | undefined;
-                    separator?: string | undefined;
-                } | undefined;
                 metadata?: Record<string, any> | undefined;
                 description?: string | undefined;
                 itemKey?: string | undefined;
@@ -2996,6 +3005,11 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
                 prompt: string;
             } | undefined;
             params?: {
+                fill?: {
+                    into: "subject" | "scanned";
+                    payload?: Record<string, any> | undefined;
+                    separator?: string | undefined;
+                } | undefined;
                 accumulate?: {
                     item?: {
                         roles?: string[] | undefined;
@@ -3025,11 +3039,6 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
                     headline?: string | undefined;
                     subline?: string | undefined;
                 } | undefined;
-                fill?: {
-                    into: "subject" | "scanned";
-                    payload?: Record<string, any> | undefined;
-                    separator?: string | undefined;
-                } | undefined;
                 metadata?: Record<string, any> | undefined;
                 description?: string | undefined;
                 itemKey?: string | undefined;
@@ -3048,6 +3057,11 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
                 prompt: string;
             } | undefined;
             params?: {
+                fill?: {
+                    into: "subject" | "scanned";
+                    payload?: Record<string, any> | undefined;
+                    separator?: string | undefined;
+                } | undefined;
                 accumulate?: {
                     item?: {
                         roles?: string[] | undefined;
@@ -3077,11 +3091,6 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
                     headline?: string | undefined;
                     subline?: string | undefined;
                 } | undefined;
-                fill?: {
-                    into: "subject" | "scanned";
-                    payload?: Record<string, any> | undefined;
-                    separator?: string | undefined;
-                } | undefined;
                 metadata?: Record<string, any> | undefined;
                 description?: string | undefined;
                 itemKey?: string | undefined;
@@ -3148,7 +3157,7 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
             markdown: string;
         }>>;
     }, "strip", z.ZodTypeAny, {
-        verb: "resolve" | "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "accumulate" | "present" | "hold" | "fill";
+        verb: "resolve" | "fill" | "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "accumulate" | "present" | "hold";
         query: {
             status?: "pending" | "resolved" | "cancelled" | undefined;
             roles?: string[] | undefined;
@@ -3170,6 +3179,11 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
                 prompt: string;
             } | undefined;
             params?: {
+                fill?: {
+                    into: "subject" | "scanned";
+                    payload?: Record<string, any> | undefined;
+                    separator?: string | undefined;
+                } | undefined;
                 accumulate?: {
                     item?: {
                         roles?: string[] | undefined;
@@ -3199,11 +3213,6 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
                     headline?: string | undefined;
                     subline?: string | undefined;
                 } | undefined;
-                fill?: {
-                    into: "subject" | "scanned";
-                    payload?: Record<string, any> | undefined;
-                    separator?: string | undefined;
-                } | undefined;
                 metadata?: Record<string, any> | undefined;
                 description?: string | undefined;
                 itemKey?: string | undefined;
@@ -3231,6 +3240,11 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
             prompt: string;
         } | undefined;
         params?: {
+            fill?: {
+                into: "subject" | "scanned";
+                payload?: Record<string, any> | undefined;
+                separator?: string | undefined;
+            } | undefined;
             accumulate?: {
                 item?: {
                     roles?: string[] | undefined;
@@ -3260,11 +3274,6 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
                 headline?: string | undefined;
                 subline?: string | undefined;
             } | undefined;
-            fill?: {
-                into: "subject" | "scanned";
-                payload?: Record<string, any> | undefined;
-                separator?: string | undefined;
-            } | undefined;
             metadata?: Record<string, any> | undefined;
             description?: string | undefined;
             itemKey?: string | undefined;
@@ -3282,7 +3291,7 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
         }[] | undefined;
         autoSelectSingle?: boolean | undefined;
     }, {
-        verb: "resolve" | "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "accumulate" | "present" | "hold" | "fill";
+        verb: "resolve" | "fill" | "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "accumulate" | "present" | "hold";
         query: {
             status?: "pending" | "resolved" | "cancelled" | undefined;
             roles?: string[] | undefined;
@@ -3304,6 +3313,11 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
                 prompt: string;
             } | undefined;
             params?: {
+                fill?: {
+                    into: "subject" | "scanned";
+                    payload?: Record<string, any> | undefined;
+                    separator?: string | undefined;
+                } | undefined;
                 accumulate?: {
                     item?: {
                         roles?: string[] | undefined;
@@ -3333,11 +3347,6 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
                     headline?: string | undefined;
                     subline?: string | undefined;
                 } | undefined;
-                fill?: {
-                    into: "subject" | "scanned";
-                    payload?: Record<string, any> | undefined;
-                    separator?: string | undefined;
-                } | undefined;
                 metadata?: Record<string, any> | undefined;
                 description?: string | undefined;
                 itemKey?: string | undefined;
@@ -3365,6 +3374,11 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
             prompt: string;
         } | undefined;
         params?: {
+            fill?: {
+                into: "subject" | "scanned";
+                payload?: Record<string, any> | undefined;
+                separator?: string | undefined;
+            } | undefined;
             accumulate?: {
                 item?: {
                     roles?: string[] | undefined;
@@ -3394,11 +3408,6 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
                 headline?: string | undefined;
                 subline?: string | undefined;
             } | undefined;
-            fill?: {
-                into: "subject" | "scanned";
-                payload?: Record<string, any> | undefined;
-                separator?: string | undefined;
-            } | undefined;
             metadata?: Record<string, any> | undefined;
             description?: string | undefined;
             itemKey?: string | undefined;
@@ -3442,7 +3451,7 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
     category: string;
     scheme_version: number;
     steps: {
-        verb: "resolve" | "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "accumulate" | "present" | "hold" | "fill";
+        verb: "resolve" | "fill" | "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "accumulate" | "present" | "hold";
         query: {
             status?: "pending" | "resolved" | "cancelled" | undefined;
             roles?: string[] | undefined;
@@ -3464,6 +3473,11 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
                 prompt: string;
             } | undefined;
             params?: {
+                fill?: {
+                    into: "subject" | "scanned";
+                    payload?: Record<string, any> | undefined;
+                    separator?: string | undefined;
+                } | undefined;
                 accumulate?: {
                     item?: {
                         roles?: string[] | undefined;
@@ -3493,11 +3507,6 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
                     headline?: string | undefined;
                     subline?: string | undefined;
                 } | undefined;
-                fill?: {
-                    into: "subject" | "scanned";
-                    payload?: Record<string, any> | undefined;
-                    separator?: string | undefined;
-                } | undefined;
                 metadata?: Record<string, any> | undefined;
                 description?: string | undefined;
                 itemKey?: string | undefined;
@@ -3525,6 +3534,11 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
             prompt: string;
         } | undefined;
         params?: {
+            fill?: {
+                into: "subject" | "scanned";
+                payload?: Record<string, any> | undefined;
+                separator?: string | undefined;
+            } | undefined;
             accumulate?: {
                 item?: {
                     roles?: string[] | undefined;
@@ -3554,11 +3568,6 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
                 headline?: string | undefined;
                 subline?: string | undefined;
             } | undefined;
-            fill?: {
-                into: "subject" | "scanned";
-                payload?: Record<string, any> | undefined;
-                separator?: string | undefined;
-            } | undefined;
             metadata?: Record<string, any> | undefined;
             description?: string | undefined;
             itemKey?: string | undefined;
@@ -3590,7 +3599,7 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
     category: string;
     scheme_version: number;
     steps: {
-        verb: "resolve" | "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "accumulate" | "present" | "hold" | "fill";
+        verb: "resolve" | "fill" | "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "accumulate" | "present" | "hold";
         query: {
             status?: "pending" | "resolved" | "cancelled" | undefined;
             roles?: string[] | undefined;
@@ -3612,6 +3621,11 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
                 prompt: string;
             } | undefined;
             params?: {
+                fill?: {
+                    into: "subject" | "scanned";
+                    payload?: Record<string, any> | undefined;
+                    separator?: string | undefined;
+                } | undefined;
                 accumulate?: {
                     item?: {
                         roles?: string[] | undefined;
@@ -3641,11 +3655,6 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
                     headline?: string | undefined;
                     subline?: string | undefined;
                 } | undefined;
-                fill?: {
-                    into: "subject" | "scanned";
-                    payload?: Record<string, any> | undefined;
-                    separator?: string | undefined;
-                } | undefined;
                 metadata?: Record<string, any> | undefined;
                 description?: string | undefined;
                 itemKey?: string | undefined;
@@ -3673,6 +3682,11 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
             prompt: string;
         } | undefined;
         params?: {
+            fill?: {
+                into: "subject" | "scanned";
+                payload?: Record<string, any> | undefined;
+                separator?: string | undefined;
+            } | undefined;
             accumulate?: {
                 item?: {
                     roles?: string[] | undefined;
@@ -3702,11 +3716,6 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
                 headline?: string | undefined;
                 subline?: string | undefined;
             } | undefined;
-            fill?: {
-                into: "subject" | "scanned";
-                payload?: Record<string, any> | undefined;
-                separator?: string | undefined;
-            } | undefined;
             metadata?: Record<string, any> | undefined;
             description?: string | undefined;
             itemKey?: string | undefined;

package/build/system/mcp-servers/admin/schemas.js

@@ -851,13 +851,16 @@ exports.upsertScanSchemeSchema = zod_1.z.object({
     name: zod_1.z.string().describe('Scheme display name'),
     description: zod_1.z.string().optional(),
     target_facet: zod_1.z.string().describe("The metadata key the target resolves against: an escalation metadata key for action schemes, an lt_users.metadata key (e.g. badge_id) for identity schemes"),
-    encoding: zod_1.z.enum(['fixed', 'delimited', 'gtin']).optional().describe('fixed = digits only with a scheme prefix, delimited = text with separators, gtin = manufacturer barcodes (UPC-A/EAN-13/EAN-8/GTIN-14) with no prefix; one rule, category 0'),
+    encoding: zod_1.z.enum(['fixed', 'delimited', 'gtin', 'pattern']).optional().describe('fixed = digits only with a scheme prefix, delimited = text with separators, gtin = manufacturer barcodes (UPC-A/EAN-13/EAN-8/GTIN-14) with no prefix; one rule, category 0; pattern = codes matched by declared regular expressions with no prefix, the code is the target; one rule, category 0'),
     delimiter: zod_1.z.string().optional().describe('Separator character for delimited encoding (default ":")'),
     target_length: zod_1.z.number().int().min(1).optional().describe('Target digit count for fixed encoding'),
     kind: zod_1.z.enum(['action', 'identity']).optional().describe("action = ECA steps over escalations (default); identity = a badge that mints a short-lived acting-identity grant"),
     grant_ttl_seconds: zod_1.z.number().int().min(1).max(86400).optional().describe('Identity kind: how long a minted acting grant lives'),
     grant_max_uses: zod_1.z.number().int().min(0).optional().describe('Identity kind: 0 = TTL-bound; n = the grant covers n acts'),
     grant_scope: zod_1.z.enum(['action', 'subject']).optional().describe("Identity kind: 'action' spends a use per act (default); 'subject' binds to the first held subject it acts on and acts on it freely"),
+    patterns: zod_1.z.array(zod_1.z.string()).max(10).optional().describe('Pattern encoding: 1-10 regular expressions over the whole code, e.g. "1Z[0-9A-Z]{16}"'),
+    precedes_gtin: zod_1.z.boolean().nullable().optional().describe('Pattern encoding: which reads a digits-only code first beside an enabled gtin scheme; true = these patterns, false = the gtin scheme. Required while an enabled gtin scheme exists'),
+    target_match: zod_1.z.enum(['value', 'member']).optional().describe("'value' = the target facet holds one value (default); 'member' = the facet holds a list and a row matches when the list contains the target (action schemes)"),
     enabled: zod_1.z.boolean().optional(),
 });
 exports.upsertScanRuleSchema = zod_1.z.object({

package/build/system/mcp-servers/human-queue-lookups.d.ts

@@ -0,0 +1,7 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * get_escalation_lookups: the editions pinned on a row, for anyone who may read
+ * the row. Runs the same read check as GET /api/escalations/:id/lookups, as the
+ * /mcp caller, else lt-system for an internal call.
+ */
+export declare function registerEscalationLookupsTool(server: McpServer): void;

package/build/system/mcp-servers/human-queue-lookups.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerEscalationLookupsTool = registerEscalationLookupsTool;
+const lookups_1 = require("../../api/escalations/lookups");
+const caller_auth_1 = require("./caller-auth");
+const human_queue_schemas_1 = require("./human-queue-schemas");
+/**
+ * get_escalation_lookups: the editions pinned on a row, for anyone who may read
+ * the row. Runs the same read check as GET /api/escalations/:id/lookups, as the
+ * /mcp caller, else lt-system for an internal call.
+ */
+function registerEscalationLookupsTool(server) {
+    server.registerTool('get_escalation_lookups', {
+        title: 'Get Escalation Lookups',
+        description: 'Resolve the versioned knowledge lookups pinned on an escalation (envelope.lookups), ' +
+            'for a caller who may read the escalation. Each ref answers with its edition; a ref ' +
+            'whose snapshot does not exist answers with missing: true.',
+        inputSchema: human_queue_schemas_1.getEscalationLookupsSchema,
+    }, async (args, extra) => {
+        const result = await (0, lookups_1.getEscalationLookups)({ id: args.escalation_id }, await (0, caller_auth_1.callerAuth)(extra));
+        if (result.error) {
+            return { content: [{ type: 'text', text: JSON.stringify({ error: result.error }) }], isError: true };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ escalation_id: args.escalation_id, ...result.data }),
+                }],
+        };
+    });
+}

package/build/system/mcp-servers/human-queue-schemas.d.ts

@@ -31,6 +31,13 @@ export declare const checkResolutionSchema: z.ZodObject<{
 }, {
     escalation_id: string;
 }>;
+export declare const getEscalationLookupsSchema: z.ZodObject<{
+    escalation_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    escalation_id: string;
+}, {
+    escalation_id: string;
+}>;
 export declare const getAvailableWorkSchema: z.ZodObject<{
     role: z.ZodString;
     limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;

package/build/system/mcp-servers/human-queue-schemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.escalateAndWaitSchema = exports.removeItemSchema = exports.accumulateItemSchema = exports.resolveBatchItemSchema = exports.resolveEscalationSchema = exports.claimAndResolveSchema = exports.getAvailableWorkSchema = exports.checkResolutionSchema = exports.escalateSchema = void 0;
+exports.escalateAndWaitSchema = exports.removeItemSchema = exports.accumulateItemSchema = exports.resolveBatchItemSchema = exports.resolveEscalationSchema = exports.claimAndResolveSchema = exports.getAvailableWorkSchema = exports.getEscalationLookupsSchema = exports.checkResolutionSchema = exports.escalateSchema = void 0;
 const zod_1 = require("zod");
 // ── Schemas (extracted to break TS2589 deep-instantiation in registerTool generics) ──
 exports.escalateSchema = zod_1.z.object({
@@ -17,6 +17,9 @@ exports.escalateSchema = zod_1.z.object({
 exports.checkResolutionSchema = zod_1.z.object({
     escalation_id: zod_1.z.string().describe('The escalation ID to check'),
 });
+exports.getEscalationLookupsSchema = zod_1.z.object({
+    escalation_id: zod_1.z.string().describe('The escalation whose pinned knowledge lookups to resolve'),
+});
 exports.getAvailableWorkSchema = zod_1.z.object({
     role: zod_1.z.string().describe('Role to filter by'),
     limit: zod_1.z.number().optional().default(10).describe('Max results to return'),

package/build/system/mcp-servers/human-queue.d.ts

@@ -5,6 +5,7 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
  * Registers the tools that expose the escalation API:
  * - escalate_to_human — create a new escalation (fire-and-forget)
  * - check_resolution — check escalation status
+ * - get_escalation_lookups — read the knowledge editions pinned on an escalation the caller may read
  * - get_available_work — list available escalations by role
  * - claim_and_resolve — claim + resolve in one step
  * - resolve_escalation — resolve an already-claimed escalation

package/build/system/mcp-servers/human-queue.js

@@ -41,6 +41,7 @@ const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const logger_1 = require("../../lib/logger");
 const caller_auth_1 = require("./caller-auth");
 const registered_tools_1 = require("../../services/mcp/registered-tools");
+const human_queue_lookups_1 = require("./human-queue-lookups");
 const escalationService = __importStar(require("../../services/escalation"));
 const resolver_validation_1 = require("../../services/escalation/resolver-validation");
 const enforcement_cache_1 = require("../../services/role/enforcement-cache");
@@ -78,6 +79,7 @@ async function checkResolveToolPayload(escalationId, payload) {
  * Registers the tools that expose the escalation API:
  * - escalate_to_human — create a new escalation (fire-and-forget)
  * - check_resolution — check escalation status
+ * - get_escalation_lookups — read the knowledge editions pinned on an escalation the caller may read
  * - get_available_work — list available escalations by role
  * - claim_and_resolve — claim + resolve in one step
  * - resolve_escalation — resolve an already-claimed escalation
@@ -172,6 +174,7 @@ async function createHumanQueueServer(options) {
             content: [{ type: 'text', text: JSON.stringify(result) }],
         };
     });
+    (0, human_queue_lookups_1.registerEscalationLookupsTool)(server);
     // ── get_available_work ──────────────────────────────────────────────
     server.registerTool('get_available_work', {
         title: 'Get Available Work',

package/build/system/seed/tool-manifests-admin.js

@@ -139,7 +139,7 @@ exports.ADMIN_TOOLS = [
     { name: 'execute_scan_code', gate: 'caller', description: 'Execute a raw scan code (version:category:target): parse against the configured schemes, walk the rule\'s condition/action steps, and return a structured outcome. Identity-kind schemes mint an acting-identity grant; with actingToken, mutating verbs attribute to the badged person.', read_safe: false, inputSchema: { type: 'object', properties: { code: { type: 'string' }, actingToken: { type: 'string' }, previousActingToken: { type: 'string' }, subject: { type: 'object', properties: { code: { type: 'string' }, escalationId: { type: 'string' } }, required: ['code', 'escalationId'] }, stationRole: { type: 'string' } }, required: ['code'] } },
     { name: 'execute_scan_choice', gate: 'caller', description: 'Execute one choice presented by a PRESENT step (the info-choice screen). The pointer is re-validated against live config, row state, the acting-identity gate, and RBAC before the verb runs.', read_safe: false, inputSchema: { type: 'object', properties: { schemeVersion: { type: 'integer' }, category: { type: 'string' }, stepIndex: { type: 'integer' }, choiceIndex: { type: 'integer' }, escalationId: { type: 'string' }, actingToken: { type: 'string' } }, required: ['schemeVersion', 'category', 'stepIndex', 'choiceIndex', 'escalationId'] } },
     { name: 'list_scan_schemes', gate: 'caller', description: 'List all scan-code schemes: version digit, name, target metadata facet, and encoding (fixed digits or delimited text).', read_safe: true, inputSchema: { type: 'object', properties: {} } },
-    { name: 'upsert_scan_scheme', gate: 'roleManager', description: 'Create or replace a scan scheme: which metadata facet the scanned target resolves against and how the code string parses. kind=identity turns the scheme into a badge layer minting acting-identity grants.', read_safe: false, inputSchema: { type: 'object', properties: { version: { type: 'integer' }, name: { type: 'string' }, target_facet: { type: 'string' }, encoding: { type: 'string', enum: ['fixed', 'delimited'] }, delimiter: { type: 'string' }, target_length: { type: 'integer' }, kind: { type: 'string', enum: ['action', 'identity'] }, grant_ttl_seconds: { type: 'integer' }, grant_max_uses: { type: 'integer' }, enabled: { type: 'boolean' } }, required: ['version', 'name', 'target_facet'] } },
+    { name: 'upsert_scan_scheme', gate: 'roleManager', description: 'Create or replace a scan scheme: which metadata facet the scanned target resolves against and how the code string parses. kind=identity turns the scheme into a badge layer minting acting-identity grants.', read_safe: false, inputSchema: { type: 'object', properties: { version: { type: 'integer' }, name: { type: 'string' }, target_facet: { type: 'string' }, encoding: { type: 'string', enum: ['fixed', 'delimited', 'gtin', 'pattern'] }, delimiter: { type: 'string' }, target_length: { type: 'integer' }, patterns: { type: 'array', items: { type: 'string' } }, precedes_gtin: { type: 'boolean' }, target_match: { type: 'string', enum: ['value', 'member'] }, kind: { type: 'string', enum: ['action', 'identity'] }, grant_ttl_seconds: { type: 'integer' }, grant_max_uses: { type: 'integer' }, grant_scope: { type: 'string', enum: ['action', 'subject'] }, enabled: { type: 'boolean' } }, required: ['version', 'name', 'target_facet'] } },
     { name: 'upsert_scan_rule', gate: 'roleManager', description: 'Create or replace a scan rule for a scheme category: friendly name, ordered condition/action steps (first matching query wins), a no-match fallback screen, and a not-primed screen for identity-required steps. present-verb steps carry a labeled choice set.', read_safe: false, inputSchema: { type: 'object', properties: { scheme_version: { type: 'integer' }, category: { type: 'string' }, name: { type: 'string' }, steps: { type: 'array', items: { type: 'object' } }, fallback: { type: 'object' }, notPrimed: { type: 'object' }, enabled: { type: 'boolean' } }, required: ['scheme_version', 'category', 'name', 'steps'] } },
     { name: 'delete_scan_rule', gate: 'roleManager', description: 'Delete one scan rule (scheme version + single-digit category).', read_safe: false, inputSchema: { type: 'object', properties: { scheme_version: { type: 'integer' }, category: { type: 'string' } }, required: ['scheme_version', 'category'] } },
     // ── announcements.ts ────────────────────────────────────────────────────

package/build/system/seed/tool-manifests-escalation.js

@@ -36,8 +36,8 @@ exports.HUMAN_QUEUE_TOOLS = [
     },
     {
         name: 'get_escalation_lookups',
-        gate: 'superadmin',
-        description: 'Resolve the versioned knowledge lookups pinned on an escalation (envelope.lookups). Each ref answers with its immutable edition; a ref whose snapshot does not exist answers with missing: true.',
+        gate: 'caller',
+        description: 'Resolve the versioned knowledge lookups pinned on an escalation (envelope.lookups), for a caller who may read the escalation. Each ref answers with its edition; a ref whose snapshot does not exist answers with missing: true.',
         read_safe: true,
         inputSchema: {
             type: 'object',