@hotmeshio/long-tail 0.1.3 → 0.1.5

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

@@ -0,0 +1,411 @@
+/**
+ * Zod schemas for the admin MCP server tools.
+ *
+ * Each schema mirrors the exact parameter shape of the corresponding
+ * REST API route handler. When a route accepts `req.query.status`,
+ * the schema has `status: z.string().optional()`. When a route
+ * reads `req.body.roles`, the schema has `roles: z.array(...)`.
+ *
+ * Schemas are extracted here (rather than inline) to avoid TS2589
+ * deep-instantiation errors in the registerTool() generic.
+ */
+import { z } from 'zod';
+export declare const findTasksSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodString>;
+    workflow_type: z.ZodOptional<z.ZodString>;
+    workflow_id: z.ZodOptional<z.ZodString>;
+    origin_id: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+    status?: string | undefined;
+    workflow_type?: string | undefined;
+    workflow_id?: string | undefined;
+    origin_id?: string | undefined;
+}, {
+    status?: string | undefined;
+    workflow_type?: string | undefined;
+    limit?: number | undefined;
+    workflow_id?: string | undefined;
+    origin_id?: string | undefined;
+    offset?: number | undefined;
+}>;
+export declare const getProcessDetailSchema: z.ZodObject<{
+    origin_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    origin_id: string;
+}, {
+    origin_id: string;
+}>;
+export declare const findEscalationsSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodEnum<["pending", "resolved"]>>;
+    role: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodString>;
+    priority: z.ZodOptional<z.ZodNumber>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+    role?: string | undefined;
+    status?: "pending" | "resolved" | undefined;
+    type?: string | undefined;
+    priority?: number | undefined;
+}, {
+    role?: string | undefined;
+    status?: "pending" | "resolved" | undefined;
+    type?: string | undefined;
+    priority?: number | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+export declare const getEscalationStatsSchema: z.ZodObject<{
+    period: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    period?: string | undefined;
+}, {
+    period?: string | undefined;
+}>;
+export declare const claimEscalationSchema: z.ZodObject<{
+    id: z.ZodString;
+    duration_minutes: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    duration_minutes: number;
+}, {
+    id: string;
+    duration_minutes?: number | undefined;
+}>;
+export declare const releaseExpiredClaimsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const bulkTriageSchema: z.ZodObject<{
+    ids: z.ZodArray<z.ZodString, "many">;
+    hint: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    ids: string[];
+    hint?: string | undefined;
+}, {
+    ids: string[];
+    hint?: string | undefined;
+}>;
+export declare const listWorkflowConfigsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const upsertWorkflowConfigSchema: z.ZodObject<{
+    workflow_type: z.ZodString;
+    invocable: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    task_queue: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    default_role: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    description: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    execute_as: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    roles: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    invocation_roles: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    consumes: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    tool_tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString, "many">>>;
+    envelope_schema: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>>;
+    resolver_schema: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodAny>>>>;
+    cron_schedule: z.ZodDefault<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+}, "strip", z.ZodTypeAny, {
+    workflow_type: string;
+    invocable: boolean;
+    task_queue: string | null;
+    default_role: string;
+    description: string | null;
+    roles: string[];
+    invocation_roles: string[];
+    consumes: string[];
+    tool_tags: string[];
+    envelope_schema: Record<string, any> | null;
+    resolver_schema: Record<string, any> | null;
+    cron_schedule: string | null;
+    execute_as: string | null;
+}, {
+    workflow_type: string;
+    invocable?: boolean | undefined;
+    task_queue?: string | null | undefined;
+    default_role?: string | undefined;
+    description?: string | null | undefined;
+    roles?: string[] | undefined;
+    invocation_roles?: string[] | undefined;
+    consumes?: string[] | undefined;
+    tool_tags?: string[] | undefined;
+    envelope_schema?: Record<string, any> | null | undefined;
+    resolver_schema?: Record<string, any> | null | undefined;
+    cron_schedule?: string | null | undefined;
+    execute_as?: string | null | undefined;
+}>;
+export declare const deleteWorkflowConfigSchema: z.ZodObject<{
+    workflow_type: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    workflow_type: string;
+}, {
+    workflow_type: string;
+}>;
+export declare const listDiscoveredWorkflowsSchema: z.ZodObject<{
+    include_system: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    include_system: boolean;
+}, {
+    include_system?: boolean | undefined;
+}>;
+export declare const invokeWorkflowSchema: z.ZodObject<{
+    workflow_type: z.ZodString;
+    data: z.ZodRecord<z.ZodString, z.ZodAny>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    execute_as: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    data: Record<string, any>;
+    workflow_type: string;
+    execute_as?: string | undefined;
+    metadata?: Record<string, any> | undefined;
+}, {
+    data: Record<string, any>;
+    workflow_type: string;
+    execute_as?: string | undefined;
+    metadata?: Record<string, any> | undefined;
+}>;
+export declare const getWorkflowStatusSchema: z.ZodObject<{
+    workflow_id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    workflow_id: string;
+}, {
+    workflow_id: string;
+}>;
+export declare const listMcpServersSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodString>;
+    search: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+    status?: string | undefined;
+    search?: string | undefined;
+    tags?: string | undefined;
+}, {
+    status?: string | undefined;
+    search?: string | undefined;
+    tags?: string | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+export declare const updateMcpServerSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    auto_connect: z.ZodOptional<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    name?: string | undefined;
+    description?: string | undefined;
+    auto_connect?: boolean | undefined;
+    tags?: string[] | undefined;
+}, {
+    id: string;
+    name?: string | undefined;
+    description?: string | undefined;
+    auto_connect?: boolean | undefined;
+    tags?: string[] | undefined;
+}>;
+export declare const connectMcpServerSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export declare const disconnectMcpServerSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export declare const listYamlWorkflowsSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodString>;
+    app_id: z.ZodOptional<z.ZodString>;
+    search: z.ZodOptional<z.ZodString>;
+    source_workflow_id: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+    status?: string | undefined;
+    search?: string | undefined;
+    app_id?: string | undefined;
+    source_workflow_id?: string | undefined;
+}, {
+    status?: string | undefined;
+    search?: string | undefined;
+    limit?: number | undefined;
+    app_id?: string | undefined;
+    source_workflow_id?: string | undefined;
+    offset?: number | undefined;
+}>;
+export declare const getYamlWorkflowSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export declare const createYamlWorkflowSchema: z.ZodObject<{
+    workflow_id: z.ZodString;
+    task_queue: z.ZodString;
+    workflow_name: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    app_id: z.ZodOptional<z.ZodString>;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    compilation_feedback: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    task_queue: string;
+    workflow_id: string;
+    workflow_name: string;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    app_id?: string | undefined;
+    compilation_feedback?: string | undefined;
+}, {
+    name: string;
+    task_queue: string;
+    workflow_id: string;
+    workflow_name: string;
+    description?: string | undefined;
+    tags?: string[] | undefined;
+    app_id?: string | undefined;
+    compilation_feedback?: string | undefined;
+}>;
+export declare const deployYamlWorkflowSchema: z.ZodObject<{
+    id: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+}, {
+    id: string;
+}>;
+export declare const invokeYamlWorkflowSchema: z.ZodObject<{
+    id: z.ZodString;
+    data: z.ZodDefault<z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>>;
+    sync: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    data: Record<string, any>;
+    id: string;
+    sync: boolean;
+    timeout?: number | undefined;
+}, {
+    id: string;
+    data?: Record<string, any> | undefined;
+    timeout?: number | undefined;
+    sync?: boolean | undefined;
+}>;
+export declare const listUsersSchema: z.ZodObject<{
+    role: z.ZodOptional<z.ZodString>;
+    status: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    offset: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    limit: number;
+    offset: number;
+    role?: string | undefined;
+    status?: string | undefined;
+}, {
+    role?: string | undefined;
+    status?: string | undefined;
+    limit?: number | undefined;
+    offset?: number | undefined;
+}>;
+export declare const createUserSchema: z.ZodObject<{
+    external_id: z.ZodString;
+    display_name: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    roles: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodObject<{
+        role: z.ZodString;
+        type: z.ZodEnum<["superadmin", "admin", "member"]>;
+    }, "strip", z.ZodTypeAny, {
+        role: string;
+        type: "superadmin" | "admin" | "member";
+    }, {
+        role: string;
+        type: "superadmin" | "admin" | "member";
+    }>, "many">>>;
+}, "strip", z.ZodTypeAny, {
+    roles: {
+        role: string;
+        type: "superadmin" | "admin" | "member";
+    }[];
+    external_id: string;
+    email?: string | undefined;
+    display_name?: string | undefined;
+}, {
+    external_id: string;
+    roles?: {
+        role: string;
+        type: "superadmin" | "admin" | "member";
+    }[] | undefined;
+    email?: string | undefined;
+    display_name?: string | undefined;
+}>;
+export declare const addUserRoleSchema: z.ZodObject<{
+    user_id: z.ZodString;
+    role: z.ZodString;
+    type: z.ZodEnum<["superadmin", "admin", "member"]>;
+}, "strip", z.ZodTypeAny, {
+    role: string;
+    type: "superadmin" | "admin" | "member";
+    user_id: string;
+}, {
+    role: string;
+    type: "superadmin" | "admin" | "member";
+    user_id: string;
+}>;
+export declare const removeUserRoleSchema: z.ZodObject<{
+    user_id: z.ZodString;
+    role: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    role: string;
+    user_id: string;
+}, {
+    role: string;
+    user_id: string;
+}>;
+export declare const listRolesSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const createRoleSchema: z.ZodObject<{
+    role: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    role: string;
+}, {
+    role: string;
+}>;
+export declare const addEscalationChainSchema: z.ZodObject<{
+    source_role: z.ZodString;
+    target_role: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    source_role: string;
+    target_role: string;
+}, {
+    source_role: string;
+    target_role: string;
+}>;
+export declare const pruneSchema: z.ZodObject<{
+    expire: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    jobs: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    streams: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    entities: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    prune_transient: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    streams: boolean;
+    jobs: boolean;
+    expire: string;
+    prune_transient: boolean;
+    entities?: string[] | undefined;
+}, {
+    streams?: boolean | undefined;
+    jobs?: boolean | undefined;
+    expire?: string | undefined;
+    entities?: string[] | undefined;
+    prune_transient?: boolean | undefined;
+}>;

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

@@ -0,0 +1,177 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pruneSchema = 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.claimEscalationSchema = exports.getEscalationStatsSchema = exports.findEscalationsSchema = exports.getProcessDetailSchema = exports.findTasksSchema = void 0;
+/**
+ * Zod schemas for the admin MCP server tools.
+ *
+ * Each schema mirrors the exact parameter shape of the corresponding
+ * REST API route handler. When a route accepts `req.query.status`,
+ * the schema has `status: z.string().optional()`. When a route
+ * reads `req.body.roles`, the schema has `roles: z.array(...)`.
+ *
+ * Schemas are extracted here (rather than inline) to avoid TS2589
+ * deep-instantiation errors in the registerTool() generic.
+ */
+const zod_1 = require("zod");
+// ── tasks (routes/tasks.ts) ─────────────────────────────────────────────────
+exports.findTasksSchema = zod_1.z.object({
+    status: zod_1.z.string().optional().describe('Filter: pending, completed, etc.'),
+    workflow_type: zod_1.z.string().optional().describe('Filter by workflow type name'),
+    workflow_id: zod_1.z.string().optional().describe('Filter by workflow execution ID'),
+    origin_id: zod_1.z.string().optional().describe('Filter by origin/process ID'),
+    limit: zod_1.z.number().int().min(1).max(100).optional().default(25),
+    offset: zod_1.z.number().int().min(0).optional().default(0),
+});
+exports.getProcessDetailSchema = zod_1.z.object({
+    origin_id: zod_1.z.string().describe('The origin ID (process ID) to look up'),
+});
+// ── escalations (routes/escalations/) ───────────────────────────────────────
+exports.findEscalationsSchema = zod_1.z.object({
+    status: zod_1.z.enum(['pending', 'resolved']).optional().describe('Filter by status'),
+    role: zod_1.z.string().optional().describe('Filter by target role'),
+    type: zod_1.z.string().optional().describe('Filter by escalation type'),
+    priority: zod_1.z.number().int().min(1).max(4).optional().describe('Filter by priority (1=critical, 4=low)'),
+    limit: zod_1.z.number().int().min(1).max(100).optional().default(25),
+    offset: zod_1.z.number().int().min(0).optional().default(0),
+});
+exports.getEscalationStatsSchema = zod_1.z.object({
+    period: zod_1.z.string().optional().describe('Time period: 1h, 24h, 7d, 30d'),
+});
+exports.claimEscalationSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Escalation UUID'),
+    duration_minutes: zod_1.z.number().int().optional().default(30)
+        .describe('Lock duration in minutes'),
+});
+exports.releaseExpiredClaimsSchema = zod_1.z.object({});
+exports.bulkTriageSchema = zod_1.z.object({
+    ids: zod_1.z.array(zod_1.z.string()).min(1).describe('Escalation UUIDs to triage'),
+    hint: zod_1.z.string().optional().describe('Remediation hint for the triage agent'),
+});
+// ── workflow config (routes/workflows/config.ts) ────────────────────────────
+exports.listWorkflowConfigsSchema = zod_1.z.object({});
+exports.upsertWorkflowConfigSchema = zod_1.z.object({
+    workflow_type: zod_1.z.string().describe('Workflow function name'),
+    invocable: zod_1.z.boolean().optional().default(false),
+    task_queue: zod_1.z.string().nullable().optional().default(null),
+    default_role: zod_1.z.string().optional().default('reviewer'),
+    description: zod_1.z.string().nullable().optional().default(null),
+    execute_as: zod_1.z.string().nullable().optional().default(null)
+        .describe('Bot external_id to run as'),
+    roles: zod_1.z.array(zod_1.z.string()).optional().default([]),
+    invocation_roles: zod_1.z.array(zod_1.z.string()).optional().default([]),
+    consumes: zod_1.z.array(zod_1.z.string()).optional().default([]),
+    tool_tags: zod_1.z.array(zod_1.z.string()).optional().default([]),
+    envelope_schema: zod_1.z.record(zod_1.z.any()).nullable().optional().default(null),
+    resolver_schema: zod_1.z.record(zod_1.z.any()).nullable().optional().default(null),
+    cron_schedule: zod_1.z.string().nullable().optional().default(null),
+});
+exports.deleteWorkflowConfigSchema = zod_1.z.object({
+    workflow_type: zod_1.z.string().describe('Workflow type to de-certify'),
+});
+// ── workflows (routes/workflows/invocation.ts + discovery.ts) ───────────────
+exports.listDiscoveredWorkflowsSchema = zod_1.z.object({
+    include_system: zod_1.z.boolean().optional().default(false),
+});
+exports.invokeWorkflowSchema = zod_1.z.object({
+    workflow_type: zod_1.z.string().describe('Registered workflow type name'),
+    data: zod_1.z.record(zod_1.z.any()).describe('Business data for envelope.data'),
+    metadata: zod_1.z.record(zod_1.z.any()).optional().describe('Control flow metadata'),
+    execute_as: zod_1.z.string().optional().describe('Bot external_id override (admin only)'),
+});
+exports.getWorkflowStatusSchema = zod_1.z.object({
+    workflow_id: zod_1.z.string().describe('HotMesh workflow ID'),
+});
+// ── mcp servers (routes/mcp.ts) ─────────────────────────────────────────────
+exports.listMcpServersSchema = zod_1.z.object({
+    status: zod_1.z.string().optional().describe('Filter: registered, connected, error, disconnected'),
+    tags: zod_1.z.string().optional().describe('Comma-separated tag filter'),
+    search: zod_1.z.string().optional().describe('Search name, description, or tool names'),
+    limit: zod_1.z.number().int().min(1).max(100).optional().default(50),
+    offset: zod_1.z.number().int().min(0).optional().default(0),
+});
+exports.updateMcpServerSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Server UUID'),
+    name: zod_1.z.string().optional(),
+    description: zod_1.z.string().optional(),
+    tags: zod_1.z.array(zod_1.z.string()).optional(),
+    auto_connect: zod_1.z.boolean().optional(),
+});
+exports.connectMcpServerSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Server UUID to connect'),
+});
+exports.disconnectMcpServerSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Server UUID to disconnect'),
+});
+// ── yaml workflows (routes/yaml-workflows/) ─────────────────────────────────
+exports.listYamlWorkflowsSchema = zod_1.z.object({
+    status: zod_1.z.string().optional().describe('Filter: draft, deployed, active, archived'),
+    app_id: zod_1.z.string().optional().describe('Filter by namespace'),
+    search: zod_1.z.string().optional().describe('Search name, topic, description'),
+    source_workflow_id: zod_1.z.string().optional(),
+    limit: zod_1.z.number().int().min(1).max(100).optional().default(50),
+    offset: zod_1.z.number().int().min(0).optional().default(0),
+});
+exports.getYamlWorkflowSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('YAML workflow UUID'),
+});
+exports.createYamlWorkflowSchema = zod_1.z.object({
+    workflow_id: zod_1.z.string().describe('Source execution workflow ID'),
+    task_queue: zod_1.z.string().describe('Task queue of the source execution'),
+    workflow_name: zod_1.z.string().describe('Source workflow type name'),
+    name: zod_1.z.string().describe('Name for the new compiled workflow'),
+    description: zod_1.z.string().optional(),
+    app_id: zod_1.z.string().optional().describe('Namespace (auto-generated if omitted)'),
+    tags: zod_1.z.array(zod_1.z.string()).optional().describe('Discovery tags'),
+    compilation_feedback: zod_1.z.string().optional().describe('Extra instructions for the compiler'),
+});
+exports.deployYamlWorkflowSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('YAML workflow UUID to deploy'),
+});
+exports.invokeYamlWorkflowSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('YAML workflow UUID'),
+    data: zod_1.z.record(zod_1.z.any()).optional().default({}).describe('Input matching the workflow input_schema'),
+    sync: zod_1.z.boolean().optional().default(false).describe('Wait for result'),
+    timeout: zod_1.z.number().int().optional().describe('Timeout in ms for sync mode'),
+});
+// ── users (routes/users.ts) ─────────────────────────────────────────────────
+exports.listUsersSchema = zod_1.z.object({
+    role: zod_1.z.string().optional().describe('Filter by role name'),
+    status: zod_1.z.string().optional().describe('Filter: active, inactive, suspended'),
+    limit: zod_1.z.number().int().min(1).max(100).optional().default(50),
+    offset: zod_1.z.number().int().min(0).optional().default(0),
+});
+exports.createUserSchema = zod_1.z.object({
+    external_id: zod_1.z.string().describe('Stable user identifier'),
+    display_name: zod_1.z.string().optional(),
+    email: zod_1.z.string().optional(),
+    roles: zod_1.z.array(zod_1.z.object({
+        role: zod_1.z.string(),
+        type: zod_1.z.enum(['superadmin', 'admin', 'member']),
+    })).optional().default([]).describe('Roles to assign on creation'),
+});
+exports.addUserRoleSchema = zod_1.z.object({
+    user_id: zod_1.z.string().describe('User UUID'),
+    role: zod_1.z.string().describe('Role name'),
+    type: zod_1.z.enum(['superadmin', 'admin', 'member']).describe('Permission level'),
+});
+exports.removeUserRoleSchema = zod_1.z.object({
+    user_id: zod_1.z.string().describe('User UUID'),
+    role: zod_1.z.string().describe('Role to remove'),
+});
+// ── roles (routes/roles.ts) ─────────────────────────────────────────────────
+exports.listRolesSchema = zod_1.z.object({});
+exports.createRoleSchema = zod_1.z.object({
+    role: zod_1.z.string().describe('Lowercase alphanumeric role name (a-z, 0-9, hyphens, underscores)'),
+});
+exports.addEscalationChainSchema = zod_1.z.object({
+    source_role: zod_1.z.string().describe('Originating role'),
+    target_role: zod_1.z.string().describe('Destination role for escalation'),
+});
+// ── maintenance (routes/dba.ts) ─────────────────────────────────────────────
+exports.pruneSchema = zod_1.z.object({
+    expire: zod_1.z.string().optional().default('7 days').describe('Retention period (PostgreSQL interval)'),
+    jobs: zod_1.z.boolean().optional().default(true).describe('Hard-delete expired jobs'),
+    streams: zod_1.z.boolean().optional().default(true).describe('Hard-delete expired streams'),
+    entities: zod_1.z.array(zod_1.z.string()).optional().describe('Entity allowlist'),
+    prune_transient: zod_1.z.boolean().optional().default(false).describe('Delete transient jobs'),
+});

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

@@ -0,0 +1,5 @@
+/**
+ * Task query tools — mirrors routes/tasks.ts
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerTaskTools(server: McpServer): void;