@hotmeshio/long-tail 0.20.0 → 0.21.0

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

@@ -77,6 +77,91 @@ export declare const resolveBatchItemSchema: z.ZodObject<{
     payload: Record<string, any>;
     escalation_id: string;
 }>;
+export declare const accumulateItemSchema: z.ZodObject<{
+    escalation_id: z.ZodString;
+    item_key: z.ZodString;
+    payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    reciprocal: z.ZodOptional<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        signalKey: z.ZodOptional<z.ZodString>;
+        key: z.ZodOptional<z.ZodString>;
+        value: z.ZodOptional<z.ZodString>;
+        payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, "strip", z.ZodTypeAny, {
+        key?: string | undefined;
+        value?: string | undefined;
+        id?: string | undefined;
+        signalKey?: string | undefined;
+        payload?: Record<string, any> | undefined;
+    }, {
+        key?: string | undefined;
+        value?: string | undefined;
+        id?: string | undefined;
+        signalKey?: string | undefined;
+        payload?: Record<string, any> | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    item_key: string;
+    escalation_id: string;
+    payload?: Record<string, any> | undefined;
+    reciprocal?: {
+        key?: string | undefined;
+        value?: string | undefined;
+        id?: string | undefined;
+        signalKey?: string | undefined;
+        payload?: Record<string, any> | undefined;
+    } | undefined;
+}, {
+    item_key: string;
+    escalation_id: string;
+    payload?: Record<string, any> | undefined;
+    reciprocal?: {
+        key?: string | undefined;
+        value?: string | undefined;
+        id?: string | undefined;
+        signalKey?: string | undefined;
+        payload?: Record<string, any> | undefined;
+    } | undefined;
+}>;
+export declare const removeItemSchema: z.ZodObject<{
+    escalation_id: z.ZodString;
+    item_key: z.ZodString;
+    reciprocal: z.ZodOptional<z.ZodObject<Omit<{
+        id: z.ZodOptional<z.ZodString>;
+        signalKey: z.ZodOptional<z.ZodString>;
+        key: z.ZodOptional<z.ZodString>;
+        value: z.ZodOptional<z.ZodString>;
+        payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, "payload">, "strip", z.ZodTypeAny, {
+        key?: string | undefined;
+        value?: string | undefined;
+        id?: string | undefined;
+        signalKey?: string | undefined;
+    }, {
+        key?: string | undefined;
+        value?: string | undefined;
+        id?: string | undefined;
+        signalKey?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    item_key: string;
+    escalation_id: string;
+    reciprocal?: {
+        key?: string | undefined;
+        value?: string | undefined;
+        id?: string | undefined;
+        signalKey?: string | undefined;
+    } | undefined;
+}, {
+    item_key: string;
+    escalation_id: string;
+    reciprocal?: {
+        key?: string | undefined;
+        value?: string | undefined;
+        id?: string | undefined;
+        signalKey?: string | undefined;
+    } | undefined;
+}>;
 export declare const escalateAndWaitSchema: z.ZodObject<{
     role: z.ZodString;
     message: z.ZodString;

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.escalateAndWaitSchema = 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.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({
@@ -42,6 +42,24 @@ exports.resolveBatchItemSchema = zod_1.z.object({
     item_key: zod_1.z.string().describe('The declared batch item key this submission fills'),
     payload: zod_1.z.record(zod_1.z.any()).describe(RESOLVER_PAYLOAD_DESC),
 });
+const reciprocalSchema = zod_1.z.object({
+    id: zod_1.z.string().optional().describe('Reciprocal escalation UUID'),
+    signalKey: zod_1.z.string().optional().describe('Reciprocal escalation signal_key'),
+    key: zod_1.z.string().optional().describe('Facet key selecting the reciprocal row'),
+    value: zod_1.z.string().optional().describe('Facet value selecting the reciprocal row'),
+    payload: zod_1.z.record(zod_1.z.any()).optional().describe('Stored as the reciprocal entry payload'),
+}).describe('A second accumulator row written in the same statement, both or neither. Exactly one of id, signalKey, or key/value.');
+exports.accumulateItemSchema = zod_1.z.object({
+    escalation_id: zod_1.z.string().describe('The accumulator escalation ID (the container)'),
+    item_key: zod_1.z.string().describe('The key this item is held under (an order id, a bag id)'),
+    payload: zod_1.z.record(zod_1.z.any()).optional().describe('Optional item payload, delivered inside $accumulated'),
+    reciprocal: reciprocalSchema.optional(),
+});
+exports.removeItemSchema = zod_1.z.object({
+    escalation_id: zod_1.z.string().describe('The accumulator escalation ID'),
+    item_key: zod_1.z.string().describe('The held item key to remove'),
+    reciprocal: reciprocalSchema.omit({ payload: true }).optional(),
+});
 exports.escalateAndWaitSchema = zod_1.z.object({
     role: zod_1.z.string().describe('Target role for the escalation (e.g., "reviewer")'),
     message: zod_1.z.string().describe('Description of what input is needed from the human'),

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

@@ -9,6 +9,8 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
  * - claim_and_resolve — claim + resolve in one step
  * - resolve_escalation — resolve an already-claimed escalation
  * - resolve_batch_item — submit one declared item of a batch escalation
+ * - accumulate_item — add one item to an open accumulator escalation
+ * - remove_item — remove one held item from an open accumulator escalation
  * - escalate_and_wait — create escalation and return signal for durable wait
  *
  * The server is created with tools registered but no transport

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

@@ -80,6 +80,8 @@ async function checkResolveToolPayload(escalationId, payload) {
  * - claim_and_resolve — claim + resolve in one step
  * - resolve_escalation — resolve an already-claimed escalation
  * - resolve_batch_item — submit one declared item of a batch escalation
+ * - accumulate_item — add one item to an open accumulator escalation
+ * - remove_item — remove one held item from an open accumulator escalation
  * - escalate_and_wait — create escalation and return signal for durable wait
  *
  * The server is created with tools registered but no transport
@@ -299,6 +301,81 @@ async function createHumanQueueServer(options) {
                 }],
         };
     });
+    // ── accumulate_item ────────────────────────────────────────────────
+    server.registerTool('accumulate_item', {
+        title: 'Accumulate Item',
+        description: 'Add ONE item to an open accumulator escalation (a wait declared with accumulate). '
+            + 'Interim adds return outcome "accepted" with the count held and the remaining slots; the add that '
+            + 'reaches max completes the escalation and wakes the waiting workflow with the ordered collection. '
+            + 'A key already held is rejected. Name a reciprocal to write a second accumulator row (for example '
+            + 'the item\'s own escalation) in the same statement, both or neither.',
+        inputSchema: human_queue_schemas_1.accumulateItemSchema,
+    }, async (args) => {
+        if (args.payload) {
+            const rejected = await checkResolveToolPayload(args.escalation_id, args.payload);
+            if (rejected)
+                return rejected;
+        }
+        const result = await escalationService.accumulateItem(args.escalation_id, {
+            itemKey: args.item_key,
+            payload: args.payload,
+            metadata: { source: 'mcp_server' },
+            actor: 'mcp_server',
+            reciprocal: args.reciprocal,
+        });
+        if (result.outcome !== 'accepted' && result.outcome !== 'completed') {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ error: `Item not accepted: ${result.outcome}`, outcome: result.outcome }),
+                    }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({
+                        escalation_id: args.escalation_id,
+                        outcome: result.outcome,
+                        count: result.count,
+                        remaining: result.remaining,
+                        status: result.escalation?.status,
+                        ...(result.reciprocal
+                            ? { reciprocal: { escalation_id: result.reciprocal.escalation.id, outcome: result.reciprocal.outcome, count: result.reciprocal.count } }
+                            : {}),
+                    }),
+                }],
+        };
+    });
+    // ── remove_item ────────────────────────────────────────────────────
+    server.registerTool('remove_item', {
+        title: 'Remove Item',
+        description: 'Remove ONE held item from a pending open accumulator escalation. The row stays pending and the '
+            + 'waiting workflow is never woken. Name a reciprocal to remove the container from that row in the same statement.',
+        inputSchema: human_queue_schemas_1.removeItemSchema,
+    }, async (args) => {
+        const result = await escalationService.removeAccumulatedItem(args.escalation_id, {
+            itemKey: args.item_key,
+            actor: 'mcp_server',
+            reciprocal: args.reciprocal,
+        });
+        if (result.outcome !== 'removed') {
+            return {
+                content: [{
+                        type: 'text',
+                        text: JSON.stringify({ error: `Item not removed: ${result.outcome}`, outcome: result.outcome }),
+                    }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{
+                    type: 'text',
+                    text: JSON.stringify({ escalation_id: args.escalation_id, outcome: 'removed', count: result.count }),
+                }],
+        };
+    });
     // ── escalate_and_wait ──────────────────────────────────────────────
     server.registerTool('escalate_and_wait', {
         title: 'Escalate and Wait',