@hotmeshio/long-tail 0.4.18 → 0.4.20

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

@@ -1,6 +1,7 @@
 "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;
+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.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;
+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 = void 0;
 /**
  * Zod schemas for the admin MCP server tools.
  *
@@ -175,3 +176,240 @@ exports.pruneSchema = zod_1.z.object({
     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'),
 });
+// ── agents (routes/agents.ts) ───────────────────────────────────────────────
+exports.listAgentsSchema = zod_1.z.object({
+    status: zod_1.z.string().optional().describe('Filter by agent status'),
+    knowledge_domain: zod_1.z.string().optional().describe('Filter by knowledge domain'),
+    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.getAgentSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Agent ID'),
+});
+exports.createAgentSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Unique agent identifier'),
+    description: zod_1.z.string().optional().describe('Agent description'),
+    goals: zod_1.z.array(zod_1.z.string()).optional().describe('Agent goals'),
+    rules: zod_1.z.array(zod_1.z.string()).optional().describe('Agent behavioral rules'),
+    status: zod_1.z.string().optional().describe('Initial status'),
+    knowledge_domain: zod_1.z.string().optional().describe('Knowledge domain'),
+    schedules: zod_1.z.array(zod_1.z.any()).optional().describe('Cron schedules for the agent'),
+    subscriptions: zod_1.z.array(zod_1.z.any()).optional().describe('Topic subscriptions for the agent'),
+});
+exports.updateAgentSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Agent ID to update'),
+    description: zod_1.z.string().optional().describe('Agent description'),
+    goals: zod_1.z.array(zod_1.z.string()).optional().describe('Agent goals'),
+    rules: zod_1.z.array(zod_1.z.string()).optional().describe('Agent behavioral rules'),
+    status: zod_1.z.string().optional().describe('Agent status'),
+    knowledge_domain: zod_1.z.string().optional().describe('Knowledge domain'),
+});
+exports.deleteAgentSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Agent ID to delete'),
+});
+// ── agent subscriptions (routes/agents.ts) ──────────────────────────────────
+exports.listAgentSubscriptionsSchema = zod_1.z.object({
+    agent_id: zod_1.z.string().describe('Agent ID to list subscriptions for'),
+});
+exports.createAgentSubscriptionSchema = zod_1.z.object({
+    agent_id: zod_1.z.string().describe('Agent ID to subscribe'),
+    topic: zod_1.z.string().describe('Topic to subscribe to'),
+    reaction_type: zod_1.z.string().describe('Reaction type (e.g. workflow, pipeline, prompt)'),
+    workflow_type: zod_1.z.string().optional().describe('Workflow type to invoke'),
+    pipeline_id: zod_1.z.string().optional().describe('Pipeline ID to invoke'),
+    mcp_prompt: zod_1.z.string().optional().describe('MCP prompt to execute'),
+    input_mapping: zod_1.z.record(zod_1.z.any()).optional().describe('Input mapping from event payload'),
+    filter: zod_1.z.record(zod_1.z.any()).optional().describe('Event filter criteria'),
+    execute_as: zod_1.z.string().optional().describe('Bot external_id to execute as'),
+});
+exports.deleteAgentSubscriptionSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Subscription ID to delete'),
+});
+// ── bot accounts (routes/bot-accounts.ts) ───────────────────────────────────
+exports.listBotsSchema = zod_1.z.object({
+    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.getBotSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Bot UUID'),
+});
+exports.createBotSchema = zod_1.z.object({
+    name: zod_1.z.string().describe('Unique bot name (slug)'),
+    description: zod_1.z.string().optional().describe('Bot description'),
+    display_name: zod_1.z.string().optional().describe('Human-readable display name'),
+    roles: zod_1.z.array(zod_1.z.object({
+        role: zod_1.z.string(),
+        type: zod_1.z.string(),
+    })).optional().describe('Roles to assign on creation'),
+});
+exports.updateBotSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Bot UUID'),
+    display_name: zod_1.z.string().optional().describe('Updated display name'),
+    description: zod_1.z.string().optional().describe('Updated description'),
+    status: zod_1.z.string().optional().describe('Bot status'),
+});
+exports.deleteBotSchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Bot UUID to delete'),
+});
+exports.createBotApiKeySchema = zod_1.z.object({
+    id: zod_1.z.string().describe('Bot UUID to create key for'),
+    name: zod_1.z.string().describe('Key name/label'),
+    scopes: zod_1.z.array(zod_1.z.string()).optional().describe('Permission scopes'),
+    expires_at: zod_1.z.string().optional().describe('Expiration timestamp (ISO 8601)'),
+});
+exports.revokeBotKeySchema = zod_1.z.object({
+    key_id: zod_1.z.string().describe('API key ID to revoke'),
+});
+// ── control plane (routes/controlplane.ts) ──────────────────────────────────
+exports.listAppsSchema = zod_1.z.object({});
+exports.rollCallSchema = zod_1.z.object({
+    app_id: zod_1.z.string().optional().describe('Namespace to query'),
+    delay: zod_1.z.number().int().optional().describe('Delay in ms before roll call'),
+});
+exports.applyThrottleSchema = zod_1.z.object({
+    appId: zod_1.z.string().optional().describe('Namespace to throttle'),
+    throttle: zod_1.z.number().int().describe('Throttle value (messages per second)'),
+    topic: zod_1.z.string().optional().describe('Topic to throttle'),
+    guid: zod_1.z.string().optional().describe('Specific GUID to throttle'),
+    scope: zod_1.z.string().optional().describe('Throttle scope'),
+});
+exports.getStreamStatsSchema = zod_1.z.object({
+    app_id: zod_1.z.string().optional().describe('Namespace to query'),
+    duration: zod_1.z.string().optional().describe('Stats duration window'),
+    stream: zod_1.z.string().optional().describe('Specific stream name'),
+});
+exports.listStreamMessagesSchema = zod_1.z.object({
+    namespace: zod_1.z.string().describe('App namespace'),
+    source: zod_1.z.string().describe('Message source'),
+    limit: zod_1.z.number().int().min(1).max(100).optional().default(25),
+    offset: zod_1.z.number().int().min(0).optional().default(0),
+    sort_by: zod_1.z.string().optional().describe('Sort field'),
+    order: zod_1.z.enum(['asc', 'desc']).optional().describe('Sort order'),
+    status: zod_1.z.string().optional().describe('Filter by message status'),
+    stream_name: zod_1.z.string().optional().describe('Filter by stream name'),
+    msg_type: zod_1.z.string().optional().describe('Filter by message type'),
+    topic: zod_1.z.string().optional().describe('Filter by topic'),
+    workflow_name: zod_1.z.string().optional().describe('Filter by workflow name'),
+    jid: zod_1.z.string().optional().describe('Filter by job ID'),
+    aid: zod_1.z.string().optional().describe('Filter by activity ID'),
+});
+// ── pipelines (routes/pipelines.ts) ─────────────────────────────────────────
+exports.listPipelineEntitiesSchema = zod_1.z.object({
+    app_id: zod_1.z.string().optional().describe('Namespace to query'),
+});
+exports.listPipelineJobsSchema = zod_1.z.object({
+    app_id: zod_1.z.string().optional().describe('Namespace to query'),
+    limit: zod_1.z.number().int().min(1).max(100).optional().default(25),
+    offset: zod_1.z.number().int().min(0).optional().default(0),
+    entity: zod_1.z.string().optional().describe('Filter by entity type'),
+    search: zod_1.z.string().optional().describe('Search term'),
+    status: zod_1.z.string().optional().describe('Filter by job status'),
+    sort_by: zod_1.z.string().optional().describe('Sort field'),
+    order: zod_1.z.enum(['asc', 'desc']).optional().describe('Sort order'),
+});
+exports.getJobExecutionSchema = zod_1.z.object({
+    job_id: zod_1.z.string().describe('Job ID to retrieve'),
+    app_id: zod_1.z.string().optional().describe('Namespace'),
+});
+exports.interruptJobSchema = zod_1.z.object({
+    job_id: zod_1.z.string().describe('Job ID to interrupt'),
+    topic: zod_1.z.string().describe('Topic of the job'),
+    app_id: zod_1.z.string().optional().describe('Namespace'),
+});
+// ── topics (routes/topics.ts) ───────────────────────────────────────────────
+exports.listTopicsSchema = zod_1.z.object({
+    category: zod_1.z.string().optional().describe('Filter by category'),
+    search: zod_1.z.string().optional().describe('Search term'),
+    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.getTopicSchema = zod_1.z.object({
+    topic: zod_1.z.string().describe('Topic name'),
+});
+exports.createTopicSchema = zod_1.z.object({
+    topic: zod_1.z.string().describe('Unique topic name'),
+    category: zod_1.z.string().describe('Topic category'),
+    description: zod_1.z.string().optional().describe('Topic description'),
+    payload_schema: zod_1.z.record(zod_1.z.any()).optional().describe('JSON Schema for event payloads'),
+    example_payload: zod_1.z.record(zod_1.z.any()).optional().describe('Example payload'),
+    tags: zod_1.z.array(zod_1.z.string()).optional().describe('Discovery tags'),
+});
+exports.updateTopicSchema = zod_1.z.object({
+    topic: zod_1.z.string().describe('Topic name to update'),
+    description: zod_1.z.string().optional().describe('Updated description'),
+    category: zod_1.z.string().optional().describe('Updated category'),
+    payload_schema: zod_1.z.record(zod_1.z.any()).optional().describe('Updated payload schema'),
+    example_payload: zod_1.z.record(zod_1.z.any()).optional().describe('Updated example payload'),
+    tags: zod_1.z.array(zod_1.z.string()).optional().describe('Updated tags'),
+});
+exports.deleteTopicSchema = zod_1.z.object({
+    topic: zod_1.z.string().describe('Topic name to delete'),
+});
+// ── escalation metadata/bulk (routes/escalations/) ──────────────────────────
+exports.findByMetadataSchema = zod_1.z.object({
+    key: zod_1.z.string().describe('Metadata key to search'),
+    value: zod_1.z.string().describe('Metadata value to match'),
+    status: zod_1.z.string().optional().describe('Filter by escalation status'),
+    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.claimByMetadataSchema = zod_1.z.object({
+    key: zod_1.z.string().describe('Metadata key to match'),
+    value: zod_1.z.string().describe('Metadata value to match'),
+    durationMinutes: zod_1.z.number().int().optional().describe('Lock duration in minutes'),
+    assignee: zod_1.z.string().optional().describe('Assignee user ID'),
+    metadata: zod_1.z.record(zod_1.z.any()).optional().describe('Additional metadata to attach'),
+});
+exports.resolveByMetadataSchema = zod_1.z.object({
+    key: zod_1.z.string().describe('Metadata key to match'),
+    value: zod_1.z.string().describe('Metadata value to match'),
+    resolverPayload: zod_1.z.record(zod_1.z.any()).describe('Resolution payload'),
+    assignee: zod_1.z.string().optional().describe('Assignee user ID'),
+    metadata: zod_1.z.record(zod_1.z.any()).optional().describe('Additional metadata to attach'),
+});
+exports.bulkClaimSchema = zod_1.z.object({
+    ids: zod_1.z.array(zod_1.z.string()).min(1).describe('Escalation UUIDs to claim'),
+    durationMinutes: zod_1.z.number().int().optional().describe('Lock duration in minutes'),
+});
+exports.bulkAssignSchema = zod_1.z.object({
+    ids: zod_1.z.array(zod_1.z.string()).min(1).describe('Escalation UUIDs to assign'),
+    targetUserId: zod_1.z.string().describe('User ID to assign to'),
+    durationMinutes: zod_1.z.number().int().optional().describe('Lock duration in minutes'),
+});
+exports.bulkEscalateSchema = zod_1.z.object({
+    ids: zod_1.z.array(zod_1.z.string()).min(1).describe('Escalation UUIDs to escalate'),
+    targetRole: zod_1.z.string().describe('Role to escalate to'),
+});
+exports.updatePrioritySchema = zod_1.z.object({
+    ids: zod_1.z.array(zod_1.z.string()).min(1).describe('Escalation UUIDs to update'),
+    priority: zod_1.z.number().int().min(1).max(4).describe('New priority (1=critical, 4=low)'),
+});
+// ── settings (routes/settings.ts) ───────────────────────────────────────────
+exports.getSettingsSchema = zod_1.z.object({});
+// ── exports (routes/exports.ts) ─────────────────────────────────────────────
+exports.listExportJobsSchema = zod_1.z.object({
+    limit: zod_1.z.number().int().min(1).max(100).optional().default(25),
+    offset: zod_1.z.number().int().min(0).optional().default(0),
+    entity: zod_1.z.string().optional().describe('Filter by entity type'),
+    search: zod_1.z.string().optional().describe('Search term'),
+    status: zod_1.z.string().optional().describe('Filter by export status'),
+    sort_by: zod_1.z.string().optional().describe('Sort field'),
+    order: zod_1.z.enum(['asc', 'desc']).optional().describe('Sort order'),
+    registered: zod_1.z.string().optional().describe('Filter by registered status'),
+});
+exports.exportWorkflowStateSchema = zod_1.z.object({
+    workflow_id: zod_1.z.string().describe('Workflow ID to export'),
+    allow: zod_1.z.array(zod_1.z.string()).optional().describe('Allowlisted field paths'),
+    block: zod_1.z.array(zod_1.z.string()).optional().describe('Blocklisted field paths'),
+    values: zod_1.z.record(zod_1.z.any()).optional().describe('Override values'),
+});
+exports.exportWorkflowExecutionSchema = zod_1.z.object({
+    workflow_id: zod_1.z.string().describe('Workflow ID to export'),
+    excludeSystem: zod_1.z.boolean().optional().describe('Exclude system activities'),
+    omitResults: zod_1.z.boolean().optional().describe('Omit activity results'),
+    mode: zod_1.z.string().optional().describe('Export mode'),
+    maxDepth: zod_1.z.number().int().optional().describe('Max traversal depth'),
+});
+exports.getExportStatusSchema = zod_1.z.object({
+    workflow_id: zod_1.z.string().describe('Workflow ID to check export status'),
+});

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

@@ -0,0 +1,5 @@
+/**
+ * Settings tool — mirrors routes/settings.ts
+ */
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerSettingsTools(server: McpServer): void;

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

@@ -0,0 +1,53 @@
+"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.registerSettingsTools = registerSettingsTools;
+const api = __importStar(require("../../../api/settings"));
+const schemas_1 = require("./schemas");
+function registerSettingsTools(server) {
+    // mirrors GET /api/settings
+    server.registerTool('get_settings', {
+        title: 'Get Settings',
+        description: 'Get frontend-relevant configuration (no secrets). Returns feature flags, ' +
+            'enabled capabilities, and system metadata.',
+        inputSchema: schemas_1.getSettingsSchema,
+    }, async (_args) => {
+        const result = await api.getSettings();
+        if (result.error) {
+            return { content: [{ type: 'text', text: JSON.stringify({ error: result.error }) }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(result.data) }] };
+    });
+}

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

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

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

@@ -0,0 +1,101 @@
+"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.registerTopicTools = registerTopicTools;
+const api = __importStar(require("../../../api/topics"));
+const schemas_1 = require("./schemas");
+function registerTopicTools(server) {
+    // mirrors GET /api/topics
+    server.registerTool('list_topics', {
+        title: 'List Topics',
+        description: 'List topics in the event catalog with optional category and search filters.',
+        inputSchema: schemas_1.listTopicsSchema,
+    }, async (args) => {
+        const result = await api.listTopics(args);
+        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 GET /api/topics/by-name/:topic
+    server.registerTool('get_topic', {
+        title: 'Get Topic',
+        description: 'Get a single topic by name, including schema and example payload.',
+        inputSchema: schemas_1.getTopicSchema,
+    }, async (args) => {
+        const result = await api.getTopic(args);
+        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/topics
+    server.registerTool('create_topic', {
+        title: 'Create Topic',
+        description: 'Register a new topic in the event catalog. Topics document what ' +
+            'events are published so agents can discover and subscribe.',
+        inputSchema: schemas_1.createTopicSchema,
+    }, async (args) => {
+        const result = await api.createTopic(args);
+        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 PUT /api/topics/by-name/:topic
+    server.registerTool('update_topic', {
+        title: 'Update Topic',
+        description: 'Update a topic in the event catalog.',
+        inputSchema: schemas_1.updateTopicSchema,
+    }, async (args) => {
+        const result = await api.updateTopic(args);
+        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 DELETE /api/topics/by-name/:topic
+    server.registerTool('delete_topic', {
+        title: 'Delete Topic',
+        description: 'Delete a topic from the catalog (system topics are protected).',
+        inputSchema: schemas_1.deleteTopicSchema,
+    }, async (args) => {
+        const result = await api.deleteTopic(args);
+        if (result.error) {
+            return { content: [{ type: 'text', text: JSON.stringify({ error: result.error }) }], isError: true };
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(result.data) }] };
+    });
+}