@hotmeshio/long-tail 0.22.1 → 0.22.3

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

@@ -153,10 +153,11 @@ exports.upsertWorkflowConfigSchema = zod_1.z.object({
     input_lookups: zod_1.z.array(zod_1.z.object({
         domain: zod_1.z.string(),
         key: zod_1.z.string(),
-        version: zod_1.z.number().int().min(1),
+        version: zod_1.z.union([zod_1.z.number().int().min(1), zod_1.z.literal('current')]).optional()
+            .describe("An edition to pin, or 'current' (or absent) to follow the newest"),
         as: zod_1.z.string().optional(),
     })).nullable().optional().default(null)
-        .describe('Versioned knowledge refs the invoke form reads as lookup.<as ?? key>'),
+        .describe('Knowledge refs the invoke form reads as lookup.<as ?? key>'),
     icon: zod_1.z.string().nullable().optional().default(null)
         .describe('Curated icon name (WORKFLOW_ICONS); unknown names are refused'),
     read_safe: zod_1.z.boolean().optional().default(false)
@@ -778,6 +779,11 @@ exports.executeScanCodeSchema = zod_1.z.object({
     code: zod_1.z.string().min(1).describe('Raw scan string, e.g. "10:1:SN123" or "10175433211"'),
     actingToken: zod_1.z.string().optional().describe('An acting-identity grant (eph:v1:acting_identity:*) — verbs run as the badged person'),
     previousActingToken: zod_1.z.string().optional().describe('The grant an identity scan replaces — best-effort revoked on mint'),
+    subject: zod_1.z.object({
+        code: zod_1.z.string().describe('The raw code that held the subject'),
+        escalationId: zod_1.z.string().describe('The row the hold returned'),
+    }).optional().describe('The subject the station is holding (from a prior "held" outcome); subject steps act on it'),
+    stationRole: zod_1.z.string().optional().describe("The role the device is locked to; a badge scan mints under that role's properties.badge_grant"),
 });
 exports.executeScanChoiceSchema = zod_1.z.object({
     schemeVersion: zod_1.z.number().int().min(10).max(99),
@@ -796,10 +802,45 @@ const scanStepParamsSchema = zod_1.z.object({
     description: zod_1.z.string().optional(),
     closeCurrent: zod_1.z.enum(['resolve', 'cancel']).optional(),
     durationMinutes: zod_1.z.number().int().min(1).optional(),
+    itemKey: zod_1.z.string().optional().describe("accumulate: item key template, e.g. '{subject.itemId}'"),
+    accumulate: zod_1.z.object({
+        containerFacet: zod_1.z.string().optional().describe('Item mode: the scan names the item; the container shares this facet'),
+        containerRoles: zod_1.z.array(zod_1.z.string()).optional(),
+        container: zod_1.z.object({
+            roles: zod_1.z.array(zod_1.z.string()).optional(),
+            types: zod_1.z.array(zod_1.z.string()).optional(),
+            subtypes: zod_1.z.array(zod_1.z.string()).optional(),
+            facets: zod_1.z.record(zod_1.z.any()).optional(),
+        }).optional().describe('Which pending accumulator may be the container'),
+        reciprocal: zod_1.z.boolean().optional(),
+        from: zod_1.z.literal('subject').optional().describe('The held subject joins the scanned container (its row is the reciprocal)'),
+        into: zod_1.z.literal('subject').optional().describe("The held subject's row collects the scanned code"),
+        item: zod_1.z.object({
+            roles: zod_1.z.array(zod_1.z.string()).optional(),
+            types: zod_1.z.array(zod_1.z.string()).optional(),
+            subtypes: zod_1.z.array(zod_1.z.string()).optional(),
+            facets: zod_1.z.record(zod_1.z.any()).optional(),
+        }).optional().describe("Into-subject: the scanned code's own pending row, written as the reciprocal in the same statement"),
+    }).optional(),
+    hold: zod_1.z.object({
+        ttlSeconds: zod_1.z.number().int().min(5).max(600).optional().describe('Seconds the station holds the subject (default 45)'),
+        label: zod_1.z.string().optional().describe('What the station calls the subject (template)'),
+        headline: zod_1.z.string().optional().describe("Where the item goes, shown largest, e.g. '{item.containerCode}' (template)"),
+        subline: zod_1.z.string().optional().describe("The line under the headline, e.g. '{item.locationName}' (template)"),
+        expect: zod_1.z.object({
+            schemes: zod_1.z.array(zod_1.z.number().int().min(10).max(99)),
+            prompt: zod_1.z.string().optional().describe('Markdown asking for the next scan (template)'),
+        }).optional(),
+    }).optional().describe('hold verb options'),
+    fill: zod_1.z.object({
+        into: zod_1.z.enum(['subject', 'scanned']),
+        separator: zod_1.z.string().length(1).optional().describe("Between a code and its ordinal in batch keys (default '#')"),
+        payload: zod_1.z.record(zod_1.z.any()).optional(),
+    }).optional().describe('fill verb options'),
 });
 const scanChoiceSchema = zod_1.z.object({
     label: zod_1.z.string().describe('Button text the associate reads'),
-    verb: zod_1.z.enum(['show-detail', 'claim', 'claim-show-detail', 'release', 'resolve', 'escalate', 'cancel']),
+    verb: zod_1.z.enum(['show-detail', 'claim', 'claim-show-detail', 'release', 'resolve', 'escalate', 'cancel', 'hold']),
     params: scanStepParamsSchema.optional(),
     confirm: zod_1.z.object({ prompt: zod_1.z.string() }).optional(),
     requireActingIdentity: zod_1.z.boolean().optional().describe('The choice executes only under a real acting identity (badge or a write-capable login)'),
@@ -810,12 +851,13 @@ 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']).optional().describe('fixed = digits only (UPC), delimited = text with separators'),
+    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'),
     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 scan requests'),
+    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"),
     enabled: zod_1.z.boolean().optional(),
 });
 exports.upsertScanRuleSchema = zod_1.z.object({
@@ -828,14 +870,38 @@ exports.upsertScanRuleSchema = zod_1.z.object({
             status: zod_1.z.enum(['pending', 'resolved', 'cancelled']).optional(),
             availability: zod_1.z.enum(['available', 'claimed', 'mine', 'any']).optional(),
             facets: zod_1.z.record(zod_1.z.any()).optional().describe('Extra metadata guards'),
+            types: zod_1.z.array(zod_1.z.string()).optional().describe('Escalation types the located row must have (locate-then-act-by-id steps)'),
+            subtypes: zod_1.z.array(zod_1.z.string()).optional().describe("Escalation subtypes the located row must have, e.g. ['packing']"),
         }),
         cardinality: zod_1.z.enum(['first', 'many']).optional(),
-        verb: zod_1.z.enum(['show-detail', 'show-list', 'claim', 'claim-show-detail', 'release', 'resolve', 'escalate', 'cancel', 'present']),
+        verb: zod_1.z.enum(['show-detail', 'show-list', 'claim', 'claim-show-detail', 'release', 'resolve', 'escalate', 'cancel', 'accumulate', 'present', 'hold', 'fill']),
         confirm: zod_1.z.object({ prompt: zod_1.z.string() }).optional(),
         params: scanStepParamsSchema.optional(),
         requireActingIdentity: zod_1.z.boolean().optional().describe('The step executes only under a real acting identity — a badge grant, or a login whose own write scope covers the step'),
         choices: zod_1.z.array(scanChoiceSchema).optional().describe("present verb only: the labeled choice set rendered under the located reality"),
+        facts: zod_1.z.array(zod_1.z.object({
+            label: zod_1.z.string(),
+            value: zod_1.z.string().describe("Template, e.g. '{item.binCode}'"),
+        })).optional().describe('present verb only: the facts the station states about the located row, in order'),
         autoSelectSingle: zod_1.z.boolean().optional().describe('present verb with exactly one confirm-less choice: the scan executes it directly — one scan, one action; an unsatisfied identity requirement still presents the badge stop-over'),
+        subject: zod_1.z.object({
+            schemes: zod_1.z.array(zod_1.z.number().int().min(10).max(99)),
+            claimedByOther: zod_1.z.enum(['refuse', 'allow']).optional(),
+            facets: zod_1.z.record(zod_1.z.union([zod_1.z.string(), zod_1.z.number(), zod_1.z.boolean()])).optional()
+                .describe("The held row must carry these facet values, else the step is skipped, e.g. { placement: 'unassigned' }"),
+        }).optional().describe('The step acts on the held subject and runs only while one from these schemes is held'),
+        match: zod_1.z.object({
+            target: zod_1.z.array(zod_1.z.string()).optional().describe("The scanned target must equal one of these, e.g. ['{subject.containerCode}']; a lone token naming a list facet ('{subject.offeredContainers}') allows every entry"),
+            facets: zod_1.z.array(zod_1.z.string()).optional().describe('The located container must share these facets with the subject'),
+        }).optional().describe('Checked before the write; a miss refuses with nothing written'),
+        refuse: zod_1.z.object({
+            markdown: zod_1.z.string().describe('What the station says on a failed match (template; may read {container.*})'),
+            conflict: zod_1.z.string().optional().describe('What the station says when the write loses a race'),
+            missing: zod_1.z.string().optional().describe("Subject accumulate: what the station says when the pairing holds but the row the scan names is not found (from-subject: no open container; into-subject with item: no waiting item row). Else the next step runs"),
+        }).optional(),
+        done: zod_1.z.object({
+            markdown: zod_1.z.string().describe("What the station says once the write lands, e.g. 'Place it in **{container.containerCode}**.' (template)"),
+        }).optional(),
     })).describe('Ordered condition/action steps — first match wins'),
     fallback: zod_1.z.object({
         markdown: zod_1.z.string().optional(),

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

@@ -69,12 +69,12 @@ export declare const resolveBatchItemSchema: z.ZodObject<{
     item_key: z.ZodString;
     payload: z.ZodRecord<z.ZodString, z.ZodAny>;
 }, "strip", z.ZodTypeAny, {
-    item_key: string;
     payload: Record<string, any>;
+    item_key: string;
     escalation_id: string;
 }, {
-    item_key: string;
     payload: Record<string, any>;
+    item_key: string;
     escalation_id: string;
 }>;
 export declare const accumulateItemSchema: z.ZodObject<{
@@ -91,14 +91,14 @@ export declare const accumulateItemSchema: z.ZodObject<{
         key?: string | undefined;
         value?: string | undefined;
         id?: string | undefined;
-        signalKey?: string | undefined;
         payload?: Record<string, any> | undefined;
+        signalKey?: string | undefined;
     }, {
         key?: string | undefined;
         value?: string | undefined;
         id?: string | undefined;
-        signalKey?: string | undefined;
         payload?: Record<string, any> | undefined;
+        signalKey?: string | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     item_key: string;
@@ -108,8 +108,8 @@ export declare const accumulateItemSchema: z.ZodObject<{
         key?: string | undefined;
         value?: string | undefined;
         id?: string | undefined;
-        signalKey?: string | undefined;
         payload?: Record<string, any> | undefined;
+        signalKey?: string | undefined;
     } | undefined;
 }, {
     item_key: string;
@@ -119,8 +119,8 @@ export declare const accumulateItemSchema: z.ZodObject<{
         key?: string | undefined;
         value?: string | undefined;
         id?: string | undefined;
-        signalKey?: string | undefined;
         payload?: Record<string, any> | undefined;
+        signalKey?: string | undefined;
     } | undefined;
 }>;
 export declare const removeItemSchema: z.ZodObject<{