@hotmeshio/long-tail 0.22.0 → 0.22.2

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

@@ -97,11 +97,13 @@ exports.accumulateItemSchema = zod_1.z.object({
     payload: zod_1.z.record(zod_1.z.any()).optional().describe('Optional item payload, delivered inside $accumulated'),
     metadata: zod_1.z.record(zod_1.z.any()).optional().describe('Merge patch for the container metadata, same statement'),
     reciprocal: adminReciprocalSchema.optional(),
+    initiatedBy: zod_1.z.string().optional().describe('lt_users.id of the person the add is for; recorded as the entry actor (attribution only)'),
 });
 exports.removeItemSchema = zod_1.z.object({
     id: zod_1.z.string().describe('Accumulator escalation UUID'),
     itemKey: zod_1.z.string().describe('The held item key to remove'),
     reciprocal: adminReciprocalSchema.omit({ payload: true }).optional(),
+    initiatedBy: zod_1.z.string().optional().describe('lt_users.id of the person the removal is for; recorded as the entry actor (attribution only)'),
 });
 exports.getEscalationItemsSchema = zod_1.z.object({
     id: zod_1.z.string().optional().describe('Accumulator or batch escalation UUID'),
@@ -664,6 +666,8 @@ exports.findOrphanedSignalsSchema = zod_1.z.object({
 /** A faceted query over a pond — filter/sort by columns and metadata facets. */
 exports.facetQuerySchema = zod_1.z.object({
     role: zod_1.z.string().describe('Pond role to target (the escalation role)'),
+    types: zod_1.z.array(zod_1.z.string()).optional().describe('Only rows whose escalation type is one of these'),
+    subtypes: zod_1.z.array(zod_1.z.string()).optional().describe('Only rows whose escalation subtype is one of these'),
     status: zod_1.z.string().optional().describe("Status filter (e.g. 'pending')"),
     available: zod_1.z.boolean().optional().describe('Only rows not currently claimed'),
     facets: zod_1.z.record(zod_1.z.any()).optional().describe('Metadata facet equality filters'),
@@ -774,6 +778,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),
@@ -792,10 +801,39 @@ 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"),
+    }).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)'),
@@ -806,12 +844,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({
@@ -826,12 +865,30 @@ exports.upsertScanRuleSchema = zod_1.z.object({
             facets: zod_1.z.record(zod_1.z.any()).optional().describe('Extra metadata guards'),
         }),
         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"),
         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('From-subject accumulate: what the station says when the pairing holds but no open container carries the scanned code (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/admin/workflows.js

@@ -38,6 +38,7 @@ const configService = __importStar(require("../../../services/config"));
 const registry_1 = require("../../../services/workers/registry");
 const workflow_invocation_1 = require("../../../services/workflow-invocation");
 const workflowApi = __importStar(require("../../../api/workflows"));
+const workflow_state_1 = require("../../../shared/workflow-state");
 const schemas_1 = require("./schemas");
 function registerWorkflowTools(server) {
     // mirrors GET /api/workflows/discovered
@@ -173,46 +174,34 @@ function registerWorkflowTools(server) {
     server.registerTool('get_workflow_status', {
         title: 'Get Workflow Status',
         description: 'Check the status and result of a workflow execution. Returns ' +
-            'status (running | complete) and the result if complete. ' +
+            'status (running | complete | failed) and the result if complete; a ' +
+            'failed run carries terminated (true when an interrupt ended it) and error. ' +
             'Resolution is namespace-aware: pass app_id to read a workflow (e.g. a ' +
             'child) running in a non-default HotMesh namespace.',
         inputSchema: schemas_1.getWorkflowStatusSchema,
     }, async (args) => {
-        const statusResult = await workflowApi.getWorkflowStatus({
-            workflowId: args.workflow_id,
-            appId: args.app_id,
+        const reply = (body, isError = false) => ({
+            content: [{ type: 'text', text: JSON.stringify(body) }],
+            ...(isError ? { isError: true } : {}),
         });
-        if (statusResult.error) {
-            return {
-                content: [{ type: 'text', text: JSON.stringify({ error: statusResult.error }) }],
-                isError: true,
-            };
-        }
-        // HotMesh status: 0 = complete, positive = running.
-        if (statusResult.data?.status !== 0) {
-            return {
-                content: [{
-                        type: 'text',
-                        text: JSON.stringify({ workflow_id: args.workflow_id, status: 'running' }),
-                    }],
-            };
-        }
-        const resultResult = await workflowApi.getWorkflowResult({
+        const found = await workflowApi.getWorkflowResult({
             workflowId: args.workflow_id,
             appId: args.app_id,
         });
-        if (resultResult.error) {
-            return {
-                content: [{ type: 'text', text: JSON.stringify({ error: resultResult.error }) }],
-                isError: true,
-            };
+        if (found.error)
+            return reply({ error: found.error }, true);
+        const data = found.data;
+        if (found.status === 202)
+            return reply({ workflow_id: args.workflow_id, status: 'running' });
+        if (data.state === workflow_state_1.WORKFLOW_STATES.FAILED) {
+            return reply({
+                workflow_id: args.workflow_id,
+                status: workflow_state_1.WORKFLOW_STATES.FAILED,
+                terminated: data.terminated === true,
+                ...(data.error ? { error: data.error } : {}),
+            });
         }
-        return {
-            content: [{
-                    type: 'text',
-                    text: JSON.stringify({ workflow_id: args.workflow_id, status: 'complete', result: resultResult.data?.result }),
-                }],
-        };
+        return reply({ workflow_id: args.workflow_id, status: 'complete', result: data.result });
     });
     // mirrors POST /api/workflows/:workflowId/terminate — the COMPLETE kill.
     // Terminates the handle AND cancels the workflow's escalations (the engine's

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<{