@hotmeshio/long-tail 0.10.11 → 0.10.14

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

@@ -26,6 +26,7 @@ exports.stopAdminServer = stopAdminServer;
  *   topics.ts              — routes/topics.ts
  *   settings.ts            — routes/settings.ts
  *   exports.ts             — routes/exports.ts
+ *   scan-codes.ts          — routes/scan-codes.ts
  *
  * This server replaces three previously separate servers:
  *   - long-tail-db-query (read-only task/escalation/health queries)
@@ -58,7 +59,8 @@ const exports_1 = require("./exports");
 const overview_1 = require("./overview");
 const diagnostics_1 = require("./diagnostics");
 const ortho_1 = require("./ortho");
-const TOOL_COUNT = 100;
+const scan_codes_1 = require("./scan-codes");
+const TOOL_COUNT = 105;
 let server = null;
 async function createAdminServer(options) {
     if (server && !options?.fresh)
@@ -88,7 +90,8 @@ async function createAdminServer(options) {
     (0, overview_1.registerOverviewTools)(instance); //  1 tool
     (0, diagnostics_1.registerDiagnosticsTools)(instance); //  3 tools
     (0, ortho_1.registerOrthoTools)(instance); //  4 tools
-    // Total: 100
+    (0, scan_codes_1.registerScanCodeTools)(instance); //  5 tools (scan schemes + rules + execute)
+    // Total: 105
     logger_1.loggerRegistry.info(`[lt-mcp:admin] ${name} ready (${TOOL_COUNT} tools registered)`);
     return instance;
 }

package/build/system/mcp-servers/admin/scan-codes.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Scan-code tools — mirrors routes/scan-codes.ts
+ *
+ * Schemes map a code's leading two digits (10-99) to a target metadata facet
+ * and parse shape; rules map a single-digit category (0-9) to ordered
+ * condition/action steps over the escalation surface. execute_scan_code runs a raw code as
+ * the lt-system principal (see escalations.ts for the principal rationale).
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerScanCodeTools(server: McpServer): void;

package/build/system/mcp-servers/admin/scan-codes.js

@@ -0,0 +1,111 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerScanCodeTools = registerScanCodeTools;
+const scanCodesApi = __importStar(require("../../../api/scan-codes"));
+const iam_1 = require("../../../services/iam");
+const schemas_1 = require("./schemas");
+let systemPrincipalId = null;
+async function systemAuth() {
+    if (!systemPrincipalId)
+        systemPrincipalId = await (0, iam_1.ensureSystemBot)();
+    return { userId: systemPrincipalId, role: 'superadmin' };
+}
+function asText(payload) {
+    return { content: [{ type: 'text', text: JSON.stringify(payload) }] };
+}
+function registerScanCodeTools(server) {
+    // mirrors POST /api/scan-codes/execute
+    server.registerTool('execute_scan_code', {
+        title: 'Execute Scan Code',
+        description: 'Execute a raw scan code (version:category:target). Parses against the ' +
+            'configured schemes, walks the rule\'s condition/action steps, and returns ' +
+            'a structured outcome (executed, confirm_required, matched_list, ' +
+            'no_match_fallback, unconfigured, invalid_code, forbidden, conflict).',
+        inputSchema: schemas_1.executeScanCodeSchema,
+    }, async (args) => {
+        const result = await scanCodesApi.executeScanCode({ code: args.code }, await systemAuth());
+        return asText(result.data ?? { error: result.error });
+    });
+    // mirrors GET /api/scan-codes/schemes
+    server.registerTool('list_scan_schemes', {
+        title: 'List Scan Schemes',
+        description: 'List all scan-code schemes (version, name, target facet, encoding).',
+        inputSchema: schemas_1.listScanSchemesSchema,
+    }, async (_args) => {
+        const result = await scanCodesApi.listScanSchemes();
+        return asText(result.data ?? { error: result.error });
+    });
+    // mirrors PUT /api/scan-codes/schemes/:version
+    server.registerTool('upsert_scan_scheme', {
+        title: 'Upsert Scan Scheme',
+        description: 'Create or replace a scan scheme: which metadata facet the scanned target ' +
+            'resolves against and how the code string parses (fixed digits or delimited text).',
+        inputSchema: schemas_1.upsertScanSchemeSchema,
+    }, async (args) => {
+        const result = await scanCodesApi.upsertScanScheme(args);
+        return asText(result.data ?? { error: result.error });
+    });
+    // mirrors PUT /api/scan-codes/schemes/:version/actions/:category
+    server.registerTool('upsert_scan_rule', {
+        title: 'Upsert Scan Rule',
+        description: 'Create or replace a scan rule for a scheme category: a friendly name, ' +
+            'ordered condition/action steps (first matching query wins its verb), and ' +
+            'a fallback screen when nothing matches.',
+        inputSchema: schemas_1.upsertScanRuleSchema,
+    }, async (args) => {
+        const result = await scanCodesApi.upsertScanRule({
+            scheme_version: args.scheme_version,
+            category: args.category,
+            name: args.name,
+            steps: args.steps,
+            fallback: args.fallback,
+            enabled: args.enabled,
+        });
+        return asText(result.data ?? { error: result.error });
+    });
+    // mirrors DELETE /api/scan-codes/schemes/:version/actions/:category
+    server.registerTool('delete_scan_rule', {
+        title: 'Delete Scan Rule',
+        description: 'Delete one scan rule (scheme version + two-digit category).',
+        inputSchema: schemas_1.deleteScanRuleSchema,
+    }, async (args) => {
+        const result = await scanCodesApi.deleteScanRule({
+            version: args.scheme_version,
+            category: args.category,
+        });
+        return asText(result.data ?? { error: result.error });
+    });
+}

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

@@ -87,6 +87,7 @@ export declare const findEscalationsSchema: z.ZodObject<{
     offset: number;
     role?: string | undefined;
     status?: "pending" | "cancelled" | "resolved" | "expired" | undefined;
+    available?: boolean | undefined;
     roles?: string[] | undefined;
     type?: string | undefined;
     search?: string | undefined;
@@ -98,7 +99,6 @@ export declare const findEscalationsSchema: z.ZodObject<{
     }[] | undefined;
     assigned_to?: string | undefined;
     subtype?: string | undefined;
-    available?: boolean | undefined;
     sort_by?: "created_at" | "updated_at" | "priority" | undefined;
     order?: "asc" | "desc" | undefined;
     facets?: Record<string, any> | undefined;
@@ -112,6 +112,7 @@ export declare const findEscalationsSchema: z.ZodObject<{
 }, {
     role?: string | undefined;
     status?: "pending" | "cancelled" | "resolved" | "expired" | undefined;
+    available?: boolean | undefined;
     roles?: string[] | undefined;
     type?: string | undefined;
     search?: string | undefined;
@@ -125,7 +126,6 @@ export declare const findEscalationsSchema: z.ZodObject<{
     }[] | undefined;
     assigned_to?: string | undefined;
     subtype?: string | undefined;
-    available?: boolean | undefined;
     sort_by?: "created_at" | "updated_at" | "priority" | undefined;
     order?: "asc" | "desc" | undefined;
     facets?: Record<string, any> | undefined;
@@ -1444,24 +1444,24 @@ export declare const facetQuerySchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     role: string;
     status?: string | undefined;
+    available?: boolean | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
     orderBy?: {
         column: string;
         direction: "asc" | "desc";
     }[] | undefined;
-    available?: boolean | undefined;
     facets?: Record<string, any> | undefined;
 }, {
     role: string;
     status?: string | undefined;
+    available?: boolean | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
     orderBy?: {
         column: string;
         direction: "asc" | "desc";
     }[] | undefined;
-    available?: boolean | undefined;
     facets?: Record<string, any> | undefined;
 }>;
 export declare const resolveByIdsSchema: z.ZodObject<{
@@ -1497,24 +1497,24 @@ export declare const searchByFacetsSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     role: string;
     status?: string | undefined;
+    available?: boolean | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
     orderBy?: {
         column: string;
         direction: "asc" | "desc";
     }[] | undefined;
-    available?: boolean | undefined;
     facets?: Record<string, any> | undefined;
 }, {
     role: string;
     status?: string | undefined;
+    available?: boolean | undefined;
     limit?: number | undefined;
     offset?: number | undefined;
     orderBy?: {
         column: string;
         direction: "asc" | "desc";
     }[] | undefined;
-    available?: boolean | undefined;
     facets?: Record<string, any> | undefined;
 }>;
 export declare const claimGroupsSchema: z.ZodObject<{
@@ -1538,24 +1538,24 @@ export declare const claimGroupsSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         role: string;
         status?: string | undefined;
+        available?: boolean | undefined;
         limit?: number | undefined;
         offset?: number | undefined;
         orderBy?: {
             column: string;
             direction: "asc" | "desc";
         }[] | undefined;
-        available?: boolean | undefined;
         facets?: Record<string, any> | undefined;
     }, {
         role: string;
         status?: string | undefined;
+        available?: boolean | undefined;
         limit?: number | undefined;
         offset?: number | undefined;
         orderBy?: {
             column: string;
             direction: "asc" | "desc";
         }[] | undefined;
-        available?: boolean | undefined;
         facets?: Record<string, any> | undefined;
     }>;
     limit: z.ZodOptional<z.ZodNumber>;
@@ -1565,13 +1565,13 @@ export declare const claimGroupsSchema: z.ZodObject<{
     query: {
         role: string;
         status?: string | undefined;
+        available?: boolean | undefined;
         limit?: number | undefined;
         offset?: number | undefined;
         orderBy?: {
             column: string;
             direction: "asc" | "desc";
         }[] | undefined;
-        available?: boolean | undefined;
         facets?: Record<string, any> | undefined;
     };
     limit?: number | undefined;
@@ -1581,13 +1581,13 @@ export declare const claimGroupsSchema: z.ZodObject<{
     query: {
         role: string;
         status?: string | undefined;
+        available?: boolean | undefined;
         limit?: number | undefined;
         offset?: number | undefined;
         orderBy?: {
             column: string;
             direction: "asc" | "desc";
         }[] | undefined;
-        available?: boolean | undefined;
         facets?: Record<string, any> | undefined;
     };
     limit?: number | undefined;
@@ -1615,24 +1615,24 @@ export declare const claimByFacetsSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         role: string;
         status?: string | undefined;
+        available?: boolean | undefined;
         limit?: number | undefined;
         offset?: number | undefined;
         orderBy?: {
             column: string;
             direction: "asc" | "desc";
         }[] | undefined;
-        available?: boolean | undefined;
         facets?: Record<string, any> | undefined;
     }, {
         role: string;
         status?: string | undefined;
+        available?: boolean | undefined;
         limit?: number | undefined;
         offset?: number | undefined;
         orderBy?: {
             column: string;
             direction: "asc" | "desc";
         }[] | undefined;
-        available?: boolean | undefined;
         facets?: Record<string, any> | undefined;
     }>;
     limit: z.ZodOptional<z.ZodNumber>;
@@ -1642,13 +1642,13 @@ export declare const claimByFacetsSchema: z.ZodObject<{
     query: {
         role: string;
         status?: string | undefined;
+        available?: boolean | undefined;
         limit?: number | undefined;
         offset?: number | undefined;
         orderBy?: {
             column: string;
             direction: "asc" | "desc";
         }[] | undefined;
-        available?: boolean | undefined;
         facets?: Record<string, any> | undefined;
     };
     limit?: number | undefined;
@@ -1658,16 +1658,234 @@ export declare const claimByFacetsSchema: z.ZodObject<{
     query: {
         role: string;
         status?: string | undefined;
+        available?: boolean | undefined;
         limit?: number | undefined;
         offset?: number | undefined;
         orderBy?: {
             column: string;
             direction: "asc" | "desc";
         }[] | undefined;
-        available?: boolean | undefined;
         facets?: Record<string, any> | undefined;
     };
     limit?: number | undefined;
     durationMinutes?: number | undefined;
     allOrNone?: boolean | undefined;
 }>;
+export declare const executeScanCodeSchema: z.ZodObject<{
+    code: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+}, {
+    code: string;
+}>;
+export declare const listScanSchemesSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const upsertScanSchemeSchema: z.ZodObject<{
+    version: z.ZodNumber;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    target_facet: z.ZodString;
+    encoding: z.ZodOptional<z.ZodEnum<["fixed", "delimited"]>>;
+    delimiter: z.ZodOptional<z.ZodString>;
+    target_length: z.ZodOptional<z.ZodNumber>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    version: number;
+    target_facet: string;
+    description?: string | undefined;
+    enabled?: boolean | undefined;
+    encoding?: "fixed" | "delimited" | undefined;
+    delimiter?: string | undefined;
+    target_length?: number | undefined;
+}, {
+    name: string;
+    version: number;
+    target_facet: string;
+    description?: string | undefined;
+    enabled?: boolean | undefined;
+    encoding?: "fixed" | "delimited" | undefined;
+    delimiter?: string | undefined;
+    target_length?: number | undefined;
+}>;
+export declare const upsertScanRuleSchema: z.ZodObject<{
+    scheme_version: z.ZodNumber;
+    category: z.ZodString;
+    name: z.ZodString;
+    steps: z.ZodArray<z.ZodObject<{
+        query: z.ZodObject<{
+            roles: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            status: z.ZodOptional<z.ZodEnum<["pending", "resolved", "cancelled"]>>;
+            availability: z.ZodOptional<z.ZodEnum<["available", "claimed", "mine", "any"]>>;
+            facets: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+        }, "strip", z.ZodTypeAny, {
+            status?: "pending" | "cancelled" | "resolved" | undefined;
+            roles?: string[] | undefined;
+            facets?: Record<string, any> | undefined;
+            availability?: "available" | "claimed" | "mine" | "any" | undefined;
+        }, {
+            status?: "pending" | "cancelled" | "resolved" | undefined;
+            roles?: string[] | undefined;
+            facets?: Record<string, any> | undefined;
+            availability?: "available" | "claimed" | "mine" | "any" | undefined;
+        }>;
+        cardinality: z.ZodOptional<z.ZodEnum<["first", "many"]>>;
+        verb: z.ZodEnum<["show-detail", "show-list", "claim", "claim-show-detail", "release", "resolve", "escalate", "cancel"]>;
+        confirm: z.ZodOptional<z.ZodObject<{
+            prompt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            prompt: string;
+        }, {
+            prompt: string;
+        }>>;
+        params: z.ZodOptional<z.ZodObject<{
+            resolverPayload: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+            targetRole: z.ZodOptional<z.ZodString>;
+            escalationType: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodString>;
+            closeCurrent: z.ZodOptional<z.ZodEnum<["resolve", "cancel"]>>;
+            durationMinutes: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            description?: string | undefined;
+            metadata?: Record<string, any> | undefined;
+            resolverPayload?: Record<string, any> | undefined;
+            targetRole?: string | undefined;
+            durationMinutes?: number | undefined;
+            escalationType?: string | undefined;
+            closeCurrent?: "resolve" | "cancel" | undefined;
+        }, {
+            description?: string | undefined;
+            metadata?: Record<string, any> | undefined;
+            resolverPayload?: Record<string, any> | undefined;
+            targetRole?: string | undefined;
+            durationMinutes?: number | undefined;
+            escalationType?: string | undefined;
+            closeCurrent?: "resolve" | "cancel" | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        query: {
+            status?: "pending" | "cancelled" | "resolved" | undefined;
+            roles?: string[] | undefined;
+            facets?: Record<string, any> | undefined;
+            availability?: "available" | "claimed" | "mine" | "any" | undefined;
+        };
+        verb: "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "resolve" | "escalate" | "cancel";
+        params?: {
+            description?: string | undefined;
+            metadata?: Record<string, any> | undefined;
+            resolverPayload?: Record<string, any> | undefined;
+            targetRole?: string | undefined;
+            durationMinutes?: number | undefined;
+            escalationType?: string | undefined;
+            closeCurrent?: "resolve" | "cancel" | undefined;
+        } | undefined;
+        cardinality?: "first" | "many" | undefined;
+        confirm?: {
+            prompt: string;
+        } | undefined;
+    }, {
+        query: {
+            status?: "pending" | "cancelled" | "resolved" | undefined;
+            roles?: string[] | undefined;
+            facets?: Record<string, any> | undefined;
+            availability?: "available" | "claimed" | "mine" | "any" | undefined;
+        };
+        verb: "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "resolve" | "escalate" | "cancel";
+        params?: {
+            description?: string | undefined;
+            metadata?: Record<string, any> | undefined;
+            resolverPayload?: Record<string, any> | undefined;
+            targetRole?: string | undefined;
+            durationMinutes?: number | undefined;
+            escalationType?: string | undefined;
+            closeCurrent?: "resolve" | "cancel" | undefined;
+        } | undefined;
+        cardinality?: "first" | "many" | undefined;
+        confirm?: {
+            prompt: string;
+        } | undefined;
+    }>, "many">;
+    fallback: z.ZodOptional<z.ZodObject<{
+        markdown: z.ZodOptional<z.ZodString>;
+        route: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        route?: string | undefined;
+        markdown?: string | undefined;
+    }, {
+        route?: string | undefined;
+        markdown?: string | undefined;
+    }>>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    category: string;
+    scheme_version: number;
+    steps: {
+        query: {
+            status?: "pending" | "cancelled" | "resolved" | undefined;
+            roles?: string[] | undefined;
+            facets?: Record<string, any> | undefined;
+            availability?: "available" | "claimed" | "mine" | "any" | undefined;
+        };
+        verb: "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "resolve" | "escalate" | "cancel";
+        params?: {
+            description?: string | undefined;
+            metadata?: Record<string, any> | undefined;
+            resolverPayload?: Record<string, any> | undefined;
+            targetRole?: string | undefined;
+            durationMinutes?: number | undefined;
+            escalationType?: string | undefined;
+            closeCurrent?: "resolve" | "cancel" | undefined;
+        } | undefined;
+        cardinality?: "first" | "many" | undefined;
+        confirm?: {
+            prompt: string;
+        } | undefined;
+    }[];
+    enabled?: boolean | undefined;
+    fallback?: {
+        route?: string | undefined;
+        markdown?: string | undefined;
+    } | undefined;
+}, {
+    name: string;
+    category: string;
+    scheme_version: number;
+    steps: {
+        query: {
+            status?: "pending" | "cancelled" | "resolved" | undefined;
+            roles?: string[] | undefined;
+            facets?: Record<string, any> | undefined;
+            availability?: "available" | "claimed" | "mine" | "any" | undefined;
+        };
+        verb: "show-detail" | "show-list" | "claim" | "claim-show-detail" | "release" | "resolve" | "escalate" | "cancel";
+        params?: {
+            description?: string | undefined;
+            metadata?: Record<string, any> | undefined;
+            resolverPayload?: Record<string, any> | undefined;
+            targetRole?: string | undefined;
+            durationMinutes?: number | undefined;
+            escalationType?: string | undefined;
+            closeCurrent?: "resolve" | "cancel" | undefined;
+        } | undefined;
+        cardinality?: "first" | "many" | undefined;
+        confirm?: {
+            prompt: string;
+        } | undefined;
+    }[];
+    enabled?: boolean | undefined;
+    fallback?: {
+        route?: string | undefined;
+        markdown?: string | undefined;
+    } | undefined;
+}>;
+export declare const deleteScanRuleSchema: z.ZodObject<{
+    scheme_version: z.ZodNumber;
+    category: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    category: string;
+    scheme_version: number;
+}, {
+    category: string;
+    scheme_version: number;
+}>;

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

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getUserPersonasSchema = exports.unassignPersonaSchema = exports.assignPersonaSchema = exports.unlinkPersonaRoleSchema = 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.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.getWorkflowStatusSchema = exports.invokeWorkflowSchema = exports.listDiscoveredWorkflowsSchema = exports.deleteWorkflowConfigSchema = exports.upsertWorkflowConfigSchema = 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.claimByFacetsSchema = exports.claimGroupsSchema = exports.searchByFacetsSchema = exports.resolveByIdsSchema = exports.facetQuerySchema = exports.findOrphanedSignalsSchema = exports.findStalledJobsSchema = exports.diagnoseJobSchema = exports.getExportStatusSchema = exports.exportWorkflowExecutionSchema = exports.exportWorkflowStateSchema = exports.listExportJobsSchema = exports.getSettingsSchema = exports.updatePrioritySchema = exports.bulkEscalateSchema = 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 = void 0;
+exports.deleteScanRuleSchema = exports.upsertScanRuleSchema = exports.upsertScanSchemeSchema = exports.listScanSchemesSchema = exports.executeScanCodeSchema = void 0;
 /**
  * Zod schemas for the admin MCP server tools.
  *
@@ -605,3 +606,52 @@ exports.claimByFacetsSchema = zod_1.z.object({
     durationMinutes: zod_1.z.number().int().min(1).optional().describe('Claim TTL in minutes'),
     allOrNone: zod_1.z.boolean().optional().describe('Commit only if the full limit was acquired'),
 });
+// ── Scan codes ──────────────────────────────────────────────────────────────
+exports.executeScanCodeSchema = zod_1.z.object({
+    code: zod_1.z.string().min(1).describe('Raw scan string, e.g. "1:01:SN123" or "10175433211"'),
+});
+exports.listScanSchemesSchema = zod_1.z.object({});
+exports.upsertScanSchemeSchema = zod_1.z.object({
+    version: zod_1.z.number().int().min(1).max(9).describe('Scheme version digit (1-9)'),
+    name: zod_1.z.string().describe('Scheme display name'),
+    description: zod_1.z.string().optional(),
+    target_facet: zod_1.z.string().describe('Escalation metadata key the scanned target resolves against'),
+    encoding: zod_1.z.enum(['fixed', 'delimited']).optional().describe('fixed = digits only (UPC), delimited = text with separators'),
+    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'),
+    enabled: zod_1.z.boolean().optional(),
+});
+exports.upsertScanRuleSchema = zod_1.z.object({
+    scheme_version: zod_1.z.number().int().min(1).max(9),
+    category: zod_1.z.string().regex(/^[0-9]{2}$/).describe('Two-digit category (00-99)'),
+    name: zod_1.z.string().describe('Friendly label — printed next to the physical code'),
+    steps: zod_1.z.array(zod_1.z.object({
+        query: zod_1.z.object({
+            roles: zod_1.z.array(zod_1.z.string()).optional().describe('Expected queue(s)'),
+            status: zod_1.z.enum(['pending', 'resolved', 'cancelled']).optional(),
+            availability: zod_1.z.enum(['available', 'claimed', 'mine', 'any']).optional(),
+            facets: zod_1.z.record(zod_1.z.any()).optional().describe('Extra metadata guards'),
+        }),
+        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']),
+        confirm: zod_1.z.object({ prompt: zod_1.z.string() }).optional(),
+        params: zod_1.z.object({
+            resolverPayload: zod_1.z.record(zod_1.z.any()).optional(),
+            metadata: zod_1.z.record(zod_1.z.any()).optional(),
+            targetRole: zod_1.z.string().optional(),
+            escalationType: zod_1.z.string().optional(),
+            description: zod_1.z.string().optional(),
+            closeCurrent: zod_1.z.enum(['resolve', 'cancel']).optional(),
+            durationMinutes: zod_1.z.number().int().min(1).optional(),
+        }).optional(),
+    })).describe('Ordered condition/action steps — first match wins'),
+    fallback: zod_1.z.object({
+        markdown: zod_1.z.string().optional(),
+        route: zod_1.z.string().optional(),
+    }).optional().describe('Rendered when no step matches'),
+    enabled: zod_1.z.boolean().optional(),
+});
+exports.deleteScanRuleSchema = zod_1.z.object({
+    scheme_version: zod_1.z.number().int().min(1).max(9),
+    category: zod_1.z.string().regex(/^[0-9]{2}$/),
+});