@hotmeshio/long-tail 0.20.0 → 0.21.0

package/build/shared/form-validation/x-lt-bind.d.ts

@@ -1,16 +1,3 @@
-/**
- * x-lt-bind — maps the escalation FORM (flat field values the user edits) to and
- * from the PAYLOAD (the nested JSON the workflow consumes). A form_schema property
- * may declare `x-lt-bind: "a.b[0].c"`, the path its value occupies in the payload;
- * a property with no bind sits at its own name at the root (1:1). This module is
- * isomorphic — the dashboard renders forms with it, and the API layer inverts a
- * submitted payload through it to validate against the form contract. One
- * implementation, both sides.
- *
- *   mapPayloadToForm  — payload → flat form values, to PREFILL/display the form
- *                       (server-side: to validate a submitted payload)
- *   mapFormToPayload  — flat form values → payload, the shape submitted/stored
- */
 type PathSeg = {
     key: string;
 } | {
@@ -27,7 +14,8 @@ export declare function bindPathFor(propName: string, propDef: Record<string, an
 /**
  * Assemble the payload from the form's flat values. A field absent from
  * `formValues` is omitted (so clearing/deleting a field drops it from the
- * payload). Unknown keys not declared in the schema are dropped. With no schema
+ * payload). Unknown keys not declared in the schema are dropped, and so are
+ * display-only widget fields, which carry no answer. With no schema
  * properties, values pass through unchanged.
  */
 export declare function mapFormToPayload(formValues: Record<string, any>, formSchema: Record<string, any> | null | undefined): Record<string, any>;

package/build/shared/form-validation/x-lt-bind.js

@@ -1,4 +1,11 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parsePath = parsePath;
+exports.setDeep = setDeep;
+exports.getDeep = getDeep;
+exports.bindPathFor = bindPathFor;
+exports.mapFormToPayload = mapFormToPayload;
+exports.mapPayloadToForm = mapPayloadToForm;
 /**
  * x-lt-bind — maps the escalation FORM (flat field values the user edits) to and
  * from the PAYLOAD (the nested JSON the workflow consumes). A form_schema property
@@ -12,13 +19,7 @@
  *                       (server-side: to validate a submitted payload)
  *   mapFormToPayload  — flat form values → payload, the shape submitted/stored
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parsePath = parsePath;
-exports.setDeep = setDeep;
-exports.getDeep = getDeep;
-exports.bindPathFor = bindPathFor;
-exports.mapFormToPayload = mapFormToPayload;
-exports.mapPayloadToForm = mapPayloadToForm;
+const display_only_widgets_1 = require("./display-only-widgets");
 const BLOCKED_KEYS = new Set(['__proto__', 'constructor', 'prototype']);
 /** Parse a bind path — dot keys with optional `[n]` indices. Rejects pollution keys. */
 function parsePath(path) {
@@ -75,7 +76,8 @@ function bindPathFor(propName, propDef) {
 /**
  * Assemble the payload from the form's flat values. A field absent from
  * `formValues` is omitted (so clearing/deleting a field drops it from the
- * payload). Unknown keys not declared in the schema are dropped. With no schema
+ * payload). Unknown keys not declared in the schema are dropped, and so are
+ * display-only widget fields, which carry no answer. With no schema
  * properties, values pass through unchanged.
  */
 function mapFormToPayload(formValues, formSchema) {
@@ -86,6 +88,8 @@ function mapFormToPayload(formValues, formSchema) {
     for (const [name, def] of Object.entries(props)) {
         if (!(name in formValues))
             continue;
+        if ((0, display_only_widgets_1.isDisplayOnlyField)(def))
+            continue;
         setDeep(payload, bindPathFor(name, def), formValues[name]);
     }
     return payload;

package/build/shared/form-validation/x-lt-invoke.d.ts

@@ -0,0 +1,38 @@
+export declare const X_LT_INVOKE = "x-lt-invoke";
+export declare const INVOKE_WIDGET: "invoke";
+export declare const INVOKE_VARIANTS: {
+    readonly LINK: "link";
+    readonly BUTTON: "button";
+};
+export type InvokeVariant = (typeof INVOKE_VARIANTS)[keyof typeof INVOKE_VARIANTS];
+export interface InvokeConfig {
+    /** The workflow_type to start. */
+    workflow: string;
+    /** Nested invoke `data` template; leaves interpolate against the context. */
+    data: Record<string, unknown>;
+    /** Extra run metadata template, merged over the workflow's declared metadata. */
+    metadata: Record<string, unknown>;
+    /** Open the workflow's input form prefilled instead of posting directly. */
+    modal: boolean;
+    /** Direct mode only: a prompt to confirm before posting; tokens interpolate. */
+    confirm: string | null;
+    variant: InvokeVariant;
+    /** Lead the label with the workflow's registered icon. */
+    icon: boolean;
+}
+export interface InvokePayload {
+    data: Record<string, unknown>;
+    metadata: Record<string, unknown>;
+}
+type Ctx = Record<string, unknown> | null | undefined;
+/** The field's invoke declaration, or null when it names no workflow. */
+export declare function readInvokeConfig(fieldSchema: Record<string, unknown> | null | undefined): InvokeConfig | null;
+/**
+ * Resolve one template value against the context, keeping the type of a
+ * whole-token leaf. Returns undefined for a token with no value so the
+ * caller omits the key.
+ */
+export declare function interpolateInvokeValue(value: unknown, ctx: Ctx): unknown;
+/** The invoke payload for one context: `data` and `metadata` fully resolved. */
+export declare function resolveInvokePayload(config: InvokeConfig, ctx: Ctx): InvokePayload;
+export {};

package/build/shared/form-validation/x-lt-invoke.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.INVOKE_VARIANTS = exports.INVOKE_WIDGET = exports.X_LT_INVOKE = void 0;
+exports.readInvokeConfig = readInvokeConfig;
+exports.interpolateInvokeValue = interpolateInvokeValue;
+exports.resolveInvokePayload = resolveInvokePayload;
+/**
+ * x-lt-invoke: start a workflow from inside a form. A display-only field
+ * declares the target workflow and how the form's context maps into the
+ * invoke payload:
+ *
+ *   "x-lt-widget": "invoke",
+ *   "x-lt-invoke": {
+ *     "workflow": "printPamphlet",
+ *     "data": { "order": { "id": "{{metadata.orderId}}" }, "copies": 1 },
+ *     "metadata": { "escalationId": "{{escalation.id}}" },
+ *     "modal": true,
+ *     "confirm": "Print a pamphlet for {{metadata.orderId}}?",
+ *     "variant": "link",
+ *     "icon": true
+ *   }
+ *
+ * `data` is the nested payload the invoke API receives. In direct mode it is
+ * posted as resolved; in modal mode it prefills the workflow's own input form
+ * through the x-lt-bind inversion. One declaration serves both.
+ *
+ * Interpolation keeps types: a leaf that is exactly one `{{domain.path}}`
+ * token becomes the raw context value (a number stays a number); a leaf that
+ * mixes text and tokens becomes a string; a token with no value drops its key
+ * so the target's own defaults apply. Objects and arrays recurse; every other
+ * leaf passes through unchanged.
+ */
+const display_only_widgets_1 = require("./display-only-widgets");
+const ctx_path_1 = require("./ctx-path");
+exports.X_LT_INVOKE = 'x-lt-invoke';
+exports.INVOKE_WIDGET = display_only_widgets_1.DISPLAY_ONLY_WIDGET_NAMES.INVOKE;
+exports.INVOKE_VARIANTS = {
+    LINK: 'link',
+    BUTTON: 'button',
+};
+const WHOLE_TOKEN_PATTERN = /^\{\{\s*([^{}]+?)\s*\}\}$/;
+function isPlainObject(value) {
+    return !!value && typeof value === 'object' && !Array.isArray(value);
+}
+function isVariant(value) {
+    return value === exports.INVOKE_VARIANTS.LINK || value === exports.INVOKE_VARIANTS.BUTTON;
+}
+/** The field's invoke declaration, or null when it names no workflow. */
+function readInvokeConfig(fieldSchema) {
+    const raw = fieldSchema?.[exports.X_LT_INVOKE];
+    if (!isPlainObject(raw))
+        return null;
+    const workflow = raw.workflow;
+    if (typeof workflow !== 'string' || workflow.trim().length === 0)
+        return null;
+    const confirm = raw.confirm;
+    return {
+        workflow: workflow.trim(),
+        data: isPlainObject(raw.data) ? raw.data : {},
+        metadata: isPlainObject(raw.metadata) ? raw.metadata : {},
+        modal: raw.modal === true,
+        confirm: typeof confirm === 'string' && confirm.trim().length > 0 ? confirm : null,
+        variant: isVariant(raw.variant) ? raw.variant : exports.INVOKE_VARIANTS.LINK,
+        icon: raw.icon !== false,
+    };
+}
+/**
+ * Resolve one template value against the context, keeping the type of a
+ * whole-token leaf. Returns undefined for a token with no value so the
+ * caller omits the key.
+ */
+function interpolateInvokeValue(value, ctx) {
+    if (typeof value === 'string') {
+        const whole = WHOLE_TOKEN_PATTERN.exec(value);
+        if (whole) {
+            const resolved = (0, ctx_path_1.resolveCtxPath)(whole[1], ctx ?? undefined);
+            return resolved === null ? undefined : resolved;
+        }
+        if ((0, ctx_path_1.hasInterpolation)(value))
+            return (0, ctx_path_1.interpolatePath)(value, ctx ?? undefined) ?? undefined;
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value.map((v) => interpolateInvokeValue(v, ctx)).filter((v) => v !== undefined);
+    }
+    if (isPlainObject(value)) {
+        const out = {};
+        for (const [key, v] of Object.entries(value)) {
+            const resolved = interpolateInvokeValue(v, ctx);
+            if (resolved !== undefined)
+                out[key] = resolved;
+        }
+        return out;
+    }
+    return value;
+}
+/** The invoke payload for one context: `data` and `metadata` fully resolved. */
+function resolveInvokePayload(config, ctx) {
+    return {
+        data: interpolateInvokeValue(config.data, ctx),
+        metadata: interpolateInvokeValue(config.metadata, ctx),
+    };
+}

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

@@ -218,6 +218,45 @@ 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) => {
+        const result = await escalationApi.getEscalationItems({ id: args.id }, 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,101 @@ 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.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
 export declare const escalateEscalationSchema: z.ZodObject<{
     id: z.ZodString;
     targetRole: z.ZodString;
@@ -509,8 +604,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 +761,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 +831,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 +871,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 +1677,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 +2533,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 +2550,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 +2574,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 +2615,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 +2682,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 +2737,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,28 @@ 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().describe('Accumulator or batch escalation UUID'),
+});
 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 +318,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));
         }