@hotmeshio/long-tail 0.30.1 → 0.30.3

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/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 ────────────────────────────────────────────────────