@hotmeshio/long-tail 0.20.0 → 0.21.1

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

@@ -218,6 +218,50 @@ function registerEscalationTools(server) {
         }
         return { content: [{ type: 'text', text: JSON.stringify(result.data) }] };
     });
+    // mirrors POST /api/escalations/:id/accumulate
+    server.registerTool('accumulate_item', {
+        title: 'Accumulate Item',
+        description: 'Add ONE item to an open accumulator escalation. Interim adds answer outcome "accepted" with the ' +
+            'count held and remaining slots; the add that reaches max completes the row and wakes the waiting ' +
+            'workflow with the ordered collection. A reciprocal row is written in the same statement, both or neither.',
+        inputSchema: schemas_1.accumulateItemSchema,
+    }, async (args) => {
+        const result = await escalationApi.accumulateItem({ id: args.id, itemKey: args.itemKey, payload: args.payload, metadata: args.metadata, reciprocal: args.reciprocal }, await systemAuth());
+        if (result.error) {
+            return { content: [{ type: 'text', text: JSON.stringify({ error: result.error, ...(result.data ?? {}) }) }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(result.data) }] };
+    });
+    // mirrors POST /api/escalations/:id/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.',
+        inputSchema: schemas_1.removeItemSchema,
+    }, async (args) => {
+        const result = await escalationApi.removeItem({ id: args.id, itemKey: args.itemKey, reciprocal: args.reciprocal }, await systemAuth());
+        if (result.error) {
+            return { content: [{ type: 'text', text: JSON.stringify({ error: result.error, ...(result.data ?? {}) }) }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(result.data) }] };
+    });
+    // mirrors GET /api/escalations/:id/items
+    server.registerTool('get_escalation_items', {
+        title: 'Get Escalation Items',
+        description: 'The held items of an accumulator or batch escalation in arrival order, with the count and max.',
+        inputSchema: schemas_1.getEscalationItemsSchema,
+    }, async (args) => {
+        if (!args.id && !args.signalKey) {
+            return { content: [{ type: 'text', text: JSON.stringify({ error: 'id or signalKey is required' }) }], isError: true };
+        }
+        const result = args.id
+            ? await escalationApi.getEscalationItems({ id: args.id }, await systemAuth())
+            : await escalationApi.getEscalationItemsBySignalKey({ signalKey: args.signalKey }, await systemAuth());
+        if (result.error) {
+            return { content: [{ type: 'text', text: JSON.stringify({ error: result.error }) }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(result.data) }] };
+    });
     // mirrors POST /api/escalations/resolve-by-signal-key
     server.registerTool('resolve_by_signal_key', {
         title: 'Resolve by Signal Key',

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

@@ -195,6 +195,104 @@ export declare const resolveBySignalKeySchema: z.ZodObject<{
     signalKey: string;
     resolverPayload: Record<string, any>;
 }>;
+export declare const accumulateItemSchema: z.ZodObject<{
+    id: z.ZodString;
+    itemKey: z.ZodString;
+    payload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    metadata: 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, {
+    id: string;
+    itemKey: string;
+    metadata?: Record<string, any> | undefined;
+    payload?: Record<string, any> | undefined;
+    reciprocal?: {
+        key?: string | undefined;
+        value?: string | undefined;
+        id?: string | undefined;
+        signalKey?: string | undefined;
+        payload?: Record<string, any> | undefined;
+    } | undefined;
+}, {
+    id: string;
+    itemKey: string;
+    metadata?: Record<string, any> | undefined;
+    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<{
+    id: z.ZodString;
+    itemKey: 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, {
+    id: string;
+    itemKey: string;
+    reciprocal?: {
+        key?: string | undefined;
+        value?: string | undefined;
+        id?: string | undefined;
+        signalKey?: string | undefined;
+    } | undefined;
+}, {
+    id: string;
+    itemKey: string;
+    reciprocal?: {
+        key?: string | undefined;
+        value?: string | undefined;
+        id?: string | undefined;
+        signalKey?: string | undefined;
+    } | undefined;
+}>;
+export declare const getEscalationItemsSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    signalKey: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id?: string | undefined;
+    signalKey?: string | undefined;
+}, {
+    id?: string | undefined;
+    signalKey?: string | undefined;
+}>;
 export declare const escalateEscalationSchema: z.ZodObject<{
     id: z.ZodString;
     targetRole: z.ZodString;
@@ -509,8 +607,8 @@ export declare const invokeYamlWorkflowSchema: z.ZodObject<{
     timeout?: number | undefined;
 }, {
     id: string;
-    data?: Record<string, any> | undefined;
     timeout?: number | undefined;
+    data?: Record<string, any> | undefined;
     sync?: boolean | undefined;
 }>;
 export declare const listUsersSchema: z.ZodObject<{
@@ -666,6 +764,62 @@ export declare const updateRoleSchema: z.ZodObject<{
         label: string;
         badge?: boolean | undefined;
     }>, "many">>>;
+    portals: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        label: z.ZodString;
+        rows: z.ZodArray<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            url: z.ZodString;
+            badge: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            url: string;
+            label: string;
+            badge?: boolean | undefined;
+        }, {
+            url: string;
+            label: string;
+            badge?: boolean | undefined;
+        }>, "many">, "many">;
+        counts: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            url: z.ZodString;
+            blurb: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            url: string;
+            label: string;
+            blurb?: string | undefined;
+        }, {
+            url: string;
+            label: string;
+            blurb?: string | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        key: string;
+        rows: {
+            url: string;
+            label: string;
+            badge?: boolean | undefined;
+        }[][];
+        label: string;
+        counts?: {
+            url: string;
+            label: string;
+            blurb?: string | undefined;
+        }[] | undefined;
+    }, {
+        key: string;
+        rows: {
+            url: string;
+            label: string;
+            badge?: boolean | undefined;
+        }[][];
+        label: string;
+        counts?: {
+            url: string;
+            label: string;
+            blurb?: string | undefined;
+        }[] | undefined;
+    }>, "many">>>;
     change_summary: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     role: string;
@@ -680,6 +834,20 @@ export declare const updateRoleSchema: z.ZodObject<{
         label: string;
         badge?: boolean | undefined;
     }[] | null | undefined;
+    portals?: {
+        key: string;
+        rows: {
+            url: string;
+            label: string;
+            badge?: boolean | undefined;
+        }[][];
+        label: string;
+        counts?: {
+            url: string;
+            label: string;
+            blurb?: string | undefined;
+        }[] | undefined;
+    }[] | null | undefined;
     ops_visible?: boolean | undefined;
     ops_home_default?: boolean | undefined;
     parent_role?: string | null | undefined;
@@ -706,6 +874,20 @@ export declare const updateRoleSchema: z.ZodObject<{
         label: string;
         badge?: boolean | undefined;
     }[] | null | undefined;
+    portals?: {
+        key: string;
+        rows: {
+            url: string;
+            label: string;
+            badge?: boolean | undefined;
+        }[][];
+        label: string;
+        counts?: {
+            url: string;
+            label: string;
+            blurb?: string | undefined;
+        }[] | undefined;
+    }[] | null | undefined;
     ops_visible?: boolean | undefined;
     ops_home_default?: boolean | undefined;
     parent_role?: string | null | undefined;
@@ -1498,13 +1680,13 @@ export declare const diagnoseJobSchema: z.ZodObject<{
     workflow_id: string;
     max_events: number;
     include?: ("streams" | "events")[] | undefined;
-    verbosity?: "summary" | "full" | undefined;
+    verbosity?: "full" | "summary" | undefined;
 }, {
     workflow_id: string;
     app_id?: string | undefined;
     max_events?: number | undefined;
     include?: ("streams" | "events")[] | undefined;
-    verbosity?: "summary" | "full" | undefined;
+    verbosity?: "full" | "summary" | undefined;
 }>;
 export declare const findStalledJobsSchema: z.ZodObject<{
     app_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -2354,7 +2536,7 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
             code: z.ZodOptional<z.ZodString>;
         }, "strip", z.ZodTypeAny, {
             label: string;
-            verb: "show-detail" | "claim" | "claim-show-detail" | "release" | "resolve" | "escalate" | "cancel";
+            verb: "resolve" | "show-detail" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel";
             code?: string | undefined;
             params?: {
                 description?: string | undefined;
@@ -2371,7 +2553,7 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
             requireActingIdentity?: boolean | undefined;
         }, {
             label: string;
-            verb: "show-detail" | "claim" | "claim-show-detail" | "release" | "resolve" | "escalate" | "cancel";
+            verb: "resolve" | "show-detail" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel";
             code?: string | undefined;
             params?: {
                 description?: string | undefined;
@@ -2395,10 +2577,10 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
             facets?: Record<string, any> | undefined;
             availability?: "available" | "claimed" | "mine" | "any" | undefined;
         };
-        verb: "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "resolve" | "escalate" | "cancel" | "present";
+        verb: "resolve" | "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "present";
         choices?: {
             label: string;
-            verb: "show-detail" | "claim" | "claim-show-detail" | "release" | "resolve" | "escalate" | "cancel";
+            verb: "resolve" | "show-detail" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel";
             code?: string | undefined;
             params?: {
                 description?: string | undefined;
@@ -2436,10 +2618,10 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
             facets?: Record<string, any> | undefined;
             availability?: "available" | "claimed" | "mine" | "any" | undefined;
         };
-        verb: "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "resolve" | "escalate" | "cancel" | "present";
+        verb: "resolve" | "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "present";
         choices?: {
             label: string;
-            verb: "show-detail" | "claim" | "claim-show-detail" | "release" | "resolve" | "escalate" | "cancel";
+            verb: "resolve" | "show-detail" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel";
             code?: string | undefined;
             params?: {
                 description?: string | undefined;
@@ -2503,10 +2685,10 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
             facets?: Record<string, any> | undefined;
             availability?: "available" | "claimed" | "mine" | "any" | undefined;
         };
-        verb: "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "resolve" | "escalate" | "cancel" | "present";
+        verb: "resolve" | "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "present";
         choices?: {
             label: string;
-            verb: "show-detail" | "claim" | "claim-show-detail" | "release" | "resolve" | "escalate" | "cancel";
+            verb: "resolve" | "show-detail" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel";
             code?: string | undefined;
             params?: {
                 description?: string | undefined;
@@ -2558,10 +2740,10 @@ export declare const upsertScanRuleSchema: z.ZodObject<{
             facets?: Record<string, any> | undefined;
             availability?: "available" | "claimed" | "mine" | "any" | undefined;
         };
-        verb: "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "resolve" | "escalate" | "cancel" | "present";
+        verb: "resolve" | "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel" | "present";
         choices?: {
             label: string;
-            verb: "show-detail" | "claim" | "claim-show-detail" | "release" | "resolve" | "escalate" | "cancel";
+            verb: "resolve" | "show-detail" | "claim" | "claim-show-detail" | "release" | "escalate" | "cancel";
             code?: string | undefined;
             params?: {
                 description?: string | undefined;

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

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.linkPersonaRoleSchema = exports.deletePersonaSchema = exports.updatePersonaSchema = exports.createPersonaSchema = exports.getPersonaSchema = exports.listPersonasSchema = exports.listRoleSchemaVersionsSchema = exports.getRoleSchemaSchema = exports.updateRoleSchema = exports.addEscalationChainSchema = exports.createRoleSchema = exports.listRolesSchema = exports.patchUserPropertiesSchema = exports.removeUserRoleSchema = exports.addUserRoleSchema = exports.createUserSchema = exports.listUsersSchema = exports.invokeYamlWorkflowSchema = exports.deployYamlWorkflowSchema = exports.createYamlWorkflowSchema = exports.getYamlWorkflowSchema = exports.listYamlWorkflowsSchema = exports.disconnectMcpServerSchema = exports.connectMcpServerSchema = exports.updateMcpServerSchema = exports.listMcpServersSchema = exports.getDomainContextSchema = exports.terminateWorkflowSchema = exports.getWorkflowStatusSchema = exports.invokeWorkflowSchema = exports.listDiscoveredWorkflowsSchema = exports.deleteWorkflowConfigSchema = exports.upsertWorkflowConfigSchema = exports.getWorkflowConfigSchema = exports.listWorkflowConfigsSchema = exports.bulkTriageSchema = exports.releaseExpiredClaimsSchema = exports.bulkCancelSchema = exports.cancelEscalationSchema = exports.escalateEscalationSchema = exports.resolveBySignalKeySchema = exports.resolveEscalationSchema = exports.releaseEscalationSchema = exports.claimEscalationSchema = exports.getEscalationStatsSchema = exports.getEscalationsByWorkflowSchema = exports.getEscalationSchema = exports.findEscalationsSchema = exports.getProcessDetailSchema = exports.findTasksSchema = void 0;
-exports.findStalledJobsSchema = exports.diagnoseJobSchema = exports.getWorkflowEnvelopesSchema = exports.getExportStatusSchema = exports.exportWorkflowExecutionSchema = exports.exportWorkflowStateSchema = exports.listExportJobsSchema = exports.getSettingsSchema = exports.updatePrioritySchema = exports.bulkEscalateSchema = exports.bulkUnassignSchema = exports.bulkAssignSchema = exports.bulkClaimSchema = exports.resolveByMetadataSchema = exports.claimByMetadataSchema = exports.findByMetadataSchema = exports.deleteTopicSchema = exports.updateTopicSchema = exports.createTopicSchema = exports.getTopicSchema = exports.listTopicsSchema = exports.interruptJobSchema = exports.getJobExecutionSchema = exports.listPipelineJobsSchema = exports.listPipelineEntitiesSchema = exports.listStreamMessagesSchema = exports.getStreamStatsSchema = exports.applyThrottleSchema = exports.rollCallSchema = exports.listAppsSchema = exports.revokeBotKeySchema = exports.createBotApiKeySchema = exports.deleteBotSchema = exports.updateBotSchema = exports.createBotSchema = exports.getBotSchema = exports.listBotsSchema = exports.deleteAgentSubscriptionSchema = exports.createAgentSubscriptionSchema = exports.listAgentSubscriptionsSchema = exports.deleteAgentSchema = exports.updateAgentSchema = exports.createAgentSchema = exports.getAgentSchema = exports.listAgentsSchema = exports.pruneSchema = exports.getUserPersonasSchema = exports.unassignPersonaSchema = exports.assignPersonaSchema = exports.unlinkPersonaRoleSchema = void 0;
-exports.deleteScanRuleSchema = exports.upsertScanRuleSchema = exports.upsertScanSchemeSchema = exports.listScanSchemesSchema = exports.executeScanChoiceSchema = exports.executeScanCodeSchema = exports.timelineByFacetSchema = exports.aggregateByFacetsSchema = exports.claimByFacetsSchema = exports.claimGroupsSchema = exports.searchByFacetsSchema = exports.resolveByIdsSchema = exports.facetQuerySchema = exports.findOrphanedSignalsSchema = void 0;
+exports.createPersonaSchema = exports.getPersonaSchema = exports.listPersonasSchema = exports.listRoleSchemaVersionsSchema = exports.getRoleSchemaSchema = exports.updateRoleSchema = exports.addEscalationChainSchema = exports.createRoleSchema = exports.listRolesSchema = exports.patchUserPropertiesSchema = exports.removeUserRoleSchema = exports.addUserRoleSchema = exports.createUserSchema = exports.listUsersSchema = exports.invokeYamlWorkflowSchema = exports.deployYamlWorkflowSchema = exports.createYamlWorkflowSchema = exports.getYamlWorkflowSchema = exports.listYamlWorkflowsSchema = exports.disconnectMcpServerSchema = exports.connectMcpServerSchema = exports.updateMcpServerSchema = exports.listMcpServersSchema = exports.getDomainContextSchema = exports.terminateWorkflowSchema = exports.getWorkflowStatusSchema = exports.invokeWorkflowSchema = exports.listDiscoveredWorkflowsSchema = exports.deleteWorkflowConfigSchema = exports.upsertWorkflowConfigSchema = exports.getWorkflowConfigSchema = exports.listWorkflowConfigsSchema = exports.bulkTriageSchema = exports.releaseExpiredClaimsSchema = exports.bulkCancelSchema = exports.cancelEscalationSchema = exports.escalateEscalationSchema = exports.getEscalationItemsSchema = exports.removeItemSchema = exports.accumulateItemSchema = exports.resolveBySignalKeySchema = exports.resolveEscalationSchema = exports.releaseEscalationSchema = exports.claimEscalationSchema = exports.getEscalationStatsSchema = exports.getEscalationsByWorkflowSchema = exports.getEscalationSchema = exports.findEscalationsSchema = exports.getProcessDetailSchema = exports.findTasksSchema = void 0;
+exports.getExportStatusSchema = exports.exportWorkflowExecutionSchema = exports.exportWorkflowStateSchema = exports.listExportJobsSchema = exports.getSettingsSchema = exports.updatePrioritySchema = exports.bulkEscalateSchema = exports.bulkUnassignSchema = exports.bulkAssignSchema = exports.bulkClaimSchema = exports.resolveByMetadataSchema = exports.claimByMetadataSchema = exports.findByMetadataSchema = exports.deleteTopicSchema = exports.updateTopicSchema = exports.createTopicSchema = exports.getTopicSchema = exports.listTopicsSchema = exports.interruptJobSchema = exports.getJobExecutionSchema = exports.listPipelineJobsSchema = exports.listPipelineEntitiesSchema = exports.listStreamMessagesSchema = exports.getStreamStatsSchema = exports.applyThrottleSchema = exports.rollCallSchema = exports.listAppsSchema = exports.revokeBotKeySchema = exports.createBotApiKeySchema = exports.deleteBotSchema = exports.updateBotSchema = exports.createBotSchema = exports.getBotSchema = exports.listBotsSchema = exports.deleteAgentSubscriptionSchema = exports.createAgentSubscriptionSchema = exports.listAgentSubscriptionsSchema = exports.deleteAgentSchema = exports.updateAgentSchema = exports.createAgentSchema = exports.getAgentSchema = exports.listAgentsSchema = exports.pruneSchema = exports.getUserPersonasSchema = exports.unassignPersonaSchema = exports.assignPersonaSchema = exports.unlinkPersonaRoleSchema = exports.linkPersonaRoleSchema = exports.deletePersonaSchema = exports.updatePersonaSchema = void 0;
+exports.deleteScanRuleSchema = exports.upsertScanRuleSchema = exports.upsertScanSchemeSchema = exports.listScanSchemesSchema = exports.executeScanChoiceSchema = exports.executeScanCodeSchema = exports.timelineByFacetSchema = exports.aggregateByFacetsSchema = exports.claimByFacetsSchema = exports.claimGroupsSchema = exports.searchByFacetsSchema = exports.resolveByIdsSchema = exports.facetQuerySchema = exports.findOrphanedSignalsSchema = exports.findStalledJobsSchema = exports.diagnoseJobSchema = exports.getWorkflowEnvelopesSchema = void 0;
 /**
  * Zod schemas for the admin MCP server tools.
  *
@@ -84,6 +84,29 @@ exports.resolveBySignalKeySchema = zod_1.z.object({
     signalKey: zod_1.z.string().describe('Deterministic signal_key of an efficient escalation'),
     resolverPayload: zod_1.z.record(zod_1.z.any()).describe('Resolution payload'),
 });
+const adminReciprocalSchema = zod_1.z.object({
+    id: zod_1.z.string().optional(),
+    signalKey: zod_1.z.string().optional(),
+    key: zod_1.z.string().optional(),
+    value: zod_1.z.string().optional(),
+    payload: zod_1.z.record(zod_1.z.any()).optional(),
+}).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({
+    id: zod_1.z.string().describe('Accumulator escalation UUID (the container)'),
+    itemKey: zod_1.z.string().describe('The key this item is held under'),
+    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(),
+});
+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(),
+});
+exports.getEscalationItemsSchema = zod_1.z.object({
+    id: zod_1.z.string().optional().describe('Accumulator or batch escalation UUID'),
+    signalKey: zod_1.z.string().optional().describe('The row signal_key, when the caller knows the home signal id rather than the row id'),
+});
 exports.escalateEscalationSchema = zod_1.z.object({
     id: zod_1.z.string().describe('Escalation UUID'),
     targetRole: zod_1.z.string().describe('Role to route the escalation to'),
@@ -296,6 +319,20 @@ exports.updateRoleSchema = zod_1.z.object({
         url: zod_1.z.string().describe('Dashboard-relative deep link (must start with /)'),
         badge: zod_1.z.boolean().optional().describe('Render a live count beside the label (escalations-list URLs)'),
     })).nullable().optional().describe('Pinned-view seeds handed to every member of this role. Members promote, hide, or reorder them via their own preferences. Null clears.'),
+    portals: zod_1.z.array(zod_1.z.object({
+        key: zod_1.z.string().describe('Slug, unique within the role; the portal\'s address segment'),
+        label: zod_1.z.string().describe('Portal name shown in the global menu and the nav'),
+        rows: zod_1.z.array(zod_1.z.array(zod_1.z.object({
+            label: zod_1.z.string().describe('Panel title'),
+            url: zod_1.z.string().describe('Dashboard-relative escalations-list deep link (must start with /)'),
+            badge: zod_1.z.boolean().optional(),
+        })).min(1).max(6)).min(1).max(4).describe('Rows of pin cells; up to 4 rows of up to 6 cells'),
+        counts: zod_1.z.array(zod_1.z.object({
+            label: zod_1.z.string().describe('Tile title'),
+            url: zod_1.z.string().describe('Dashboard-relative escalations-list deep link whose total the tile shows'),
+            blurb: zod_1.z.string().optional().describe('One line under the number'),
+        })).max(8).optional().describe('Count tiles above the panels'),
+    })).min(1).max(12).nullable().optional().describe('The role\'s named portal views, each a matrix of pin cells rendered as one page of live list panels at /portal/:role/:key. Null clears.'),
     change_summary: zod_1.z.string().optional().describe('Recorded on the schema version snapshot when this update changes form_schema or metadata_schema'),
 });
 exports.getRoleSchemaSchema = zod_1.z.object({

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

@@ -248,6 +248,7 @@ function registerUserTools(server) {
             upstream_roles: args.upstream_roles,
             list_schema: args.list_schema,
             default_pins: args.default_pins,
+            portals: args.portals,
             change_summary: args.change_summary,
         });
         if (!updated) {

package/build/system/mcp-servers/docs.js

@@ -52,12 +52,16 @@ function docsDir() {
     }
     return candidates[0];
 }
+/** Folders kept out of the published package; the served set matches it. */
+const UNPUBLISHED_DOC_DIRS = new Set(['donotcommit', 'donotpublish', 'img']);
 function listMarkdownFiles(dir, prefix = '') {
     if (!fs.existsSync(dir))
         return [];
     const results = [];
     for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
         const rel = prefix ? `${prefix}/${entry.name}` : entry.name;
+        if (entry.isDirectory() && !prefix && UNPUBLISHED_DOC_DIRS.has(entry.name))
+            continue;
         if (entry.isDirectory()) {
             results.push(...listMarkdownFiles(path.join(dir, entry.name), rel));
         }

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