npm - @hotmeshio/long-tail - Versions diffs - 0.10.9 → 0.10.11 - Mend

@hotmeshio/long-tail 0.10.9 → 0.10.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (301) hide show

package/build/system/mcp-servers/admin/personas.js ADDED Viewed

@@ -0,0 +1,186 @@
+"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.registerPersonaTools = registerPersonaTools;
+const personaService = __importStar(require("../../../services/persona"));
+const schemas_1 = require("./schemas");
+const PERSONA_KEY = /^[a-z][a-z0-9_-]*$/;
+function errorResult(message) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify({ error: message }) }],
+        isError: true,
+    };
+}
+function jsonResult(data) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(data) }],
+    };
+}
+function registerPersonaTools(server) {
+    // mirrors GET /api/personas
+    server.registerTool('list_personas', {
+        title: 'List Personas',
+        description: 'List all personas — named role bundles with per-role relationship ' +
+            'scope — with their role links and holder counts.',
+        inputSchema: schemas_1.listPersonasSchema,
+    }, async (_args) => {
+        const personas = await personaService.listPersonas();
+        return jsonResult({ personas });
+    });
+    // mirrors GET /api/personas/:key
+    server.registerTool('get_persona', {
+        title: 'Get Persona',
+        description: 'Fetch one persona with its role links and current assignees.',
+        inputSchema: schemas_1.getPersonaSchema,
+    }, async (args) => {
+        const persona = await personaService.getPersona(args.key);
+        if (!persona)
+            return errorResult(`Persona '${args.key}' not found`);
+        return jsonResult(persona);
+    });
+    // mirrors POST /api/personas
+    server.registerTool('create_persona', {
+        title: 'Create Persona',
+        description: 'Create a persona. Link roles with link_persona_role, then assign ' +
+            'users with assign_persona.',
+        inputSchema: schemas_1.createPersonaSchema,
+    }, async (args) => {
+        const key = args.key.trim().toLowerCase();
+        if (!PERSONA_KEY.test(key)) {
+            return errorResult('key must start with a letter and contain only lowercase letters, numbers, hyphens, and underscores');
+        }
+        const persona = await personaService.createPersona({
+            key,
+            title: args.title,
+            description: args.description,
+        });
+        return jsonResult(persona);
+    });
+    // mirrors PATCH /api/personas/:key
+    server.registerTool('update_persona', {
+        title: 'Update Persona',
+        description: 'Update a persona\'s title/description with PATCH semantics — omitted fields keep their values; null clears.',
+        inputSchema: schemas_1.updatePersonaSchema,
+    }, async (args) => {
+        const persona = await personaService.updatePersona(args.key, {
+            title: args.title,
+            description: args.description,
+        });
+        if (!persona)
+            return errorResult(`Persona '${args.key}' not found`);
+        return jsonResult(persona);
+    });
+    // mirrors DELETE /api/personas/:key
+    server.registerTool('delete_persona', {
+        title: 'Delete Persona',
+        description: 'Delete a persona. Memberships it sustains are removed (or re-homed ' +
+            'to a sibling persona the user still holds); direct grants are never touched.',
+        inputSchema: schemas_1.deletePersonaSchema,
+    }, async (args) => {
+        const result = await personaService.deletePersona(args.key);
+        if (!result.deleted)
+            return errorResult(`Persona '${args.key}' not found`);
+        return jsonResult({ deleted: true, recompute: result.recompute });
+    });
+    // mirrors PUT /api/personas/:key/roles/:role
+    server.registerTool('link_persona_role', {
+        title: 'Link Persona Role',
+        description: 'Link a role to a persona (or change the link\'s relationship). Every ' +
+            'current holder\'s memberships are reconciled in the same transaction.',
+        inputSchema: schemas_1.linkPersonaRoleSchema,
+    }, async (args) => {
+        const relationship = personaService.normalizeRelationship(args.relationship);
+        if (!relationship) {
+            return errorResult('relationship must be write-all, write-self, or read-all (write-none is accepted as read-all)');
+        }
+        const result = await personaService.linkPersonaRole(args.key, args.role.trim().toLowerCase(), relationship);
+        if (!result)
+            return errorResult(`Persona '${args.key}' not found`);
+        return jsonResult(result);
+    });
+    // mirrors DELETE /api/personas/:key/roles/:role
+    server.registerTool('unlink_persona_role', {
+        title: 'Unlink Persona Role',
+        description: 'Remove a role link from a persona and reconcile every holder\'s memberships.',
+        inputSchema: schemas_1.unlinkPersonaRoleSchema,
+    }, async (args) => {
+        const result = await personaService.unlinkPersonaRole(args.key, args.role);
+        if (!result.personaFound)
+            return errorResult(`Persona '${args.key}' not found`);
+        if (!result.unlinked)
+            return errorResult(`Persona '${args.key}' does not link role '${args.role}'`);
+        return jsonResult({ unlinked: true, recompute: result.recompute });
+    });
+    // mirrors POST /api/users/:id/personas
+    server.registerTool('assign_persona', {
+        title: 'Assign Persona',
+        description: 'Assign a persona to a user — shorthand for adding the user to each ' +
+            'linked role at the linked scope. Idempotent: re-assigning overlays ' +
+            'fresh from the persona\'s current links. Highest allowance wins when ' +
+            'bundles overlap; direct grants are only ever raised, never lowered.',
+        inputSchema: schemas_1.assignPersonaSchema,
+    }, async (args) => {
+        const recompute = await personaService.assignPersona(args.user_id, args.key);
+        if (!recompute)
+            return errorResult(`Persona '${args.key}' not found`);
+        return jsonResult({ assigned: true, recompute });
+    });
+    // mirrors DELETE /api/users/:id/personas/:key
+    server.registerTool('unassign_persona', {
+        title: 'Unassign Persona',
+        description: 'Unassign a persona from a user. Removes only memberships the persona ' +
+            'sustains — rows another held persona still grants are re-homed to it, ' +
+            'and direct grants are never touched.',
+        inputSchema: schemas_1.unassignPersonaSchema,
+    }, async (args) => {
+        const result = await personaService.unassignPersona(args.user_id, args.key);
+        if (!result.personaFound)
+            return errorResult(`Persona '${args.key}' not found`);
+        if (!result.unassigned)
+            return errorResult(`User does not hold persona '${args.key}'`);
+        return jsonResult({ unassigned: true, recompute: result.recompute });
+    });
+    // mirrors GET /api/users/:id/personas
+    server.registerTool('get_user_personas', {
+        title: 'Get User Personas',
+        description: 'The personas a user holds plus the composed role/scope map their ' +
+            'memberships form (each row names the sustaining persona, or null for ' +
+            'a direct grant).',
+        inputSchema: schemas_1.getUserPersonasSchema,
+    }, async (args) => {
+        const result = await personaService.getUserPersonas(args.user_id);
+        return jsonResult(result);
+    });
+}

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

@@ -561,6 +561,7 @@ export declare const updateRoleSchema: z.ZodObject<{
     metadata_schema: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
     properties: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>;
     ops_visible: z.ZodOptional<z.ZodBoolean>;
+    ops_home_default: z.ZodOptional<z.ZodBoolean>;
     parent_role: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     sla_minutes: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
     target_per_hour: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
@@ -598,6 +599,7 @@ export declare const updateRoleSchema: z.ZodObject<{
         badge?: boolean | undefined;
     }[] | null | undefined;
     ops_visible?: boolean | undefined;
+    ops_home_default?: boolean | undefined;
     parent_role?: string | null | undefined;
     sla_minutes?: number | null | undefined;
     target_per_hour?: number | null | undefined;
@@ -621,6 +623,7 @@ export declare const updateRoleSchema: z.ZodObject<{
         badge?: boolean | undefined;
     }[] | null | undefined;
     ops_visible?: boolean | undefined;
+    ops_home_default?: boolean | undefined;
     parent_role?: string | null | undefined;
     sla_minutes?: number | null | undefined;
     target_per_hour?: number | null | undefined;
@@ -648,6 +651,97 @@ export declare const listRoleSchemaVersionsSchema: z.ZodObject<{
 }, {
     role: string;
 }>;
+export declare const listPersonasSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const getPersonaSchema: z.ZodObject<{
+    key: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+}, {
+    key: string;
+}>;
+export declare const createPersonaSchema: z.ZodObject<{
+    key: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    description?: string | undefined;
+    title?: string | undefined;
+}, {
+    key: string;
+    description?: string | undefined;
+    title?: string | undefined;
+}>;
+export declare const updatePersonaSchema: z.ZodObject<{
+    key: z.ZodString;
+    title: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    description: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    description?: string | null | undefined;
+    title?: string | null | undefined;
+}, {
+    key: string;
+    description?: string | null | undefined;
+    title?: string | null | undefined;
+}>;
+export declare const deletePersonaSchema: z.ZodObject<{
+    key: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+}, {
+    key: string;
+}>;
+export declare const linkPersonaRoleSchema: z.ZodObject<{
+    key: z.ZodString;
+    role: z.ZodString;
+    relationship: z.ZodEnum<["write-all", "write-self", "read-all", "write-none"]>;
+}, "strip", z.ZodTypeAny, {
+    role: string;
+    key: string;
+    relationship: "write-all" | "write-self" | "read-all" | "write-none";
+}, {
+    role: string;
+    key: string;
+    relationship: "write-all" | "write-self" | "read-all" | "write-none";
+}>;
+export declare const unlinkPersonaRoleSchema: z.ZodObject<{
+    key: z.ZodString;
+    role: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    role: string;
+    key: string;
+}, {
+    role: string;
+    key: string;
+}>;
+export declare const assignPersonaSchema: z.ZodObject<{
+    user_id: z.ZodString;
+    key: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    user_id: string;
+}, {
+    key: string;
+    user_id: string;
+}>;
+export declare const unassignPersonaSchema: z.ZodObject<{
+    user_id: z.ZodString;
+    key: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    key: string;
+    user_id: string;
+}, {
+    key: string;
+    user_id: string;
+}>;
+export declare const getUserPersonasSchema: z.ZodObject<{
+    user_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    user_id: string;
+}, {
+    user_id: string;
+}>;
 export declare const pruneSchema: z.ZodObject<{
     app_id: z.ZodDefault<z.ZodOptional<z.ZodString>>;
     expire: z.ZodDefault<z.ZodOptional<z.ZodString>>;

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

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.listBotsSchema = exports.deleteAgentSubscriptionSchema = exports.createAgentSubscriptionSchema = exports.listAgentSubscriptionsSchema = exports.deleteAgentSchema = exports.updateAgentSchema = exports.createAgentSchema = exports.getAgentSchema = exports.listAgentsSchema = exports.pruneSchema = 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 = void 0;
+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;
 /**
  * Zod schemas for the admin MCP server tools.
  *
@@ -243,6 +243,7 @@ exports.updateRoleSchema = zod_1.z.object({
     metadata_schema: zod_1.z.record(zod_1.z.any()).nullable().optional().describe('JSON Schema declaring the expected shape of lt_escalations.metadata for this role. Drives creation-time validation and faceted-query key autocomplete.'),
     properties: zod_1.z.record(zod_1.z.any()).nullable().optional().describe('Free user-owned bag (icon, color, tags, etc.). No reserved keys — use the typed columns below for operational values.'),
     ops_visible: zod_1.z.boolean().optional().describe('When true, role appears as a station on the /operations view'),
+    ops_home_default: zod_1.z.boolean().optional().describe('Make this role\'s sequence the home Pace Board\'s default segment. Single-holder — setting it true clears the flag on every other role.'),
     parent_role: zod_1.z.string().nullable().optional().describe('Parent role in the process dependency graph (nullable; roots have no parent)'),
     sla_minutes: zod_1.z.number().nullable().optional().describe('Target resolution time in minutes. One of the capacity settings: target_per_hour = worker_count / (sla_minutes / 60)'),
     target_per_hour: zod_1.z.number().nullable().optional().describe('Intended throughput (items resolved per hour). Drives the station pace baseline on the Operations view.'),
@@ -266,6 +267,46 @@ exports.getRoleSchemaSchema = zod_1.z.object({
 exports.listRoleSchemaVersionsSchema = zod_1.z.object({
     role: zod_1.z.string().describe('Role whose schema version history to list'),
 });
+// ── personas (routes/personas.ts + routes/users.ts persona sub-routes) ──────
+const personaRelationship = zod_1.z.enum(['write-all', 'write-self', 'read-all', 'write-none'])
+    .describe('Membership scope the persona grants on the role: write-all = full worker (claim/resolve), write-self = acts only on own assignments, read-all = observer (sees the pond, cannot act). write-none is a synonym for read-all.');
+exports.listPersonasSchema = zod_1.z.object({});
+exports.getPersonaSchema = zod_1.z.object({
+    key: zod_1.z.string().describe('Persona key'),
+});
+exports.createPersonaSchema = zod_1.z.object({
+    key: zod_1.z.string().describe('Stable kebab-case key (a-z, 0-9, hyphens, underscores; letter-first)'),
+    title: zod_1.z.string().optional().describe('Display title, e.g. "Print Manager"'),
+    description: zod_1.z.string().optional().describe('The day-in-the-life, one paragraph'),
+});
+exports.updatePersonaSchema = zod_1.z.object({
+    key: zod_1.z.string().describe('Persona key to update'),
+    title: zod_1.z.string().nullable().optional().describe('New display title (null clears)'),
+    description: zod_1.z.string().nullable().optional().describe('New description (null clears)'),
+});
+exports.deletePersonaSchema = zod_1.z.object({
+    key: zod_1.z.string().describe('Persona key to delete. Memberships it sustains are removed or re-homed; direct grants are never touched.'),
+});
+exports.linkPersonaRoleSchema = zod_1.z.object({
+    key: zod_1.z.string().describe('Persona key'),
+    role: zod_1.z.string().describe('Role to link (created if absent)'),
+    relationship: personaRelationship,
+});
+exports.unlinkPersonaRoleSchema = zod_1.z.object({
+    key: zod_1.z.string().describe('Persona key'),
+    role: zod_1.z.string().describe('Role link to remove'),
+});
+exports.assignPersonaSchema = zod_1.z.object({
+    user_id: zod_1.z.string().describe('User UUID'),
+    key: zod_1.z.string().describe('Persona key. Idempotent — re-assigning overlays fresh from the persona\'s current role links.'),
+});
+exports.unassignPersonaSchema = zod_1.z.object({
+    user_id: zod_1.z.string().describe('User UUID'),
+    key: zod_1.z.string().describe('Persona key. Removes only memberships the persona sustains.'),
+});
+exports.getUserPersonasSchema = zod_1.z.object({
+    user_id: zod_1.z.string().describe('User UUID'),
+});
 // ── maintenance (routes/dba.ts) ─────────────────────────────────────────────
 exports.pruneSchema = zod_1.z.object({
     app_id: zod_1.z.string().optional().default('durable').describe('HotMesh application namespace (default: durable)'),

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

@@ -209,6 +209,7 @@ function registerUserTools(server) {
             metadata_schema: args.metadata_schema,
             properties: args.properties,
             ops_visible: args.ops_visible,
+            ops_home_default: args.ops_home_default,
             parent_role: args.parent_role,
             sla_minutes: args.sla_minutes,
             target_per_hour: args.target_per_hour,