@hotmeshio/long-tail 0.1.6 → 0.1.8

package/build/sdk/index.d.ts

@@ -0,0 +1,338 @@
+import * as tasksApi from '../api/tasks';
+import * as escalationsApi from '../api/escalations';
+import * as workflowsApi from '../api/workflows';
+import * as yamlWorkflowsApi from '../api/yaml-workflows';
+import * as usersApi from '../api/users';
+import * as rolesApi from '../api/roles';
+import * as authApi from '../api/auth';
+import * as mcpApi from '../api/mcp';
+import * as mcpRunsApi from '../api/mcp-runs';
+import * as insightApi from '../api/insight';
+import * as settingsApi from '../api/settings';
+import * as exportsApi from '../api/exports';
+import * as controlplaneApi from '../api/controlplane';
+import * as botAccountsApi from '../api/bot-accounts';
+import * as workflowSetsApi from '../api/workflow-sets';
+import * as dbaApi from '../api/dba';
+import * as namespacesApi from '../api/namespaces';
+import * as maintenanceApi from '../api/maintenance';
+import type { LTApiAuth, LTApiResult } from '../types/sdk';
+import type { LTEvent, LTEventType } from '../types/events';
+/**
+ * Options for createClient.
+ */
+export interface LTClientOptions {
+    /** Default auth context bound to every API call. Override per-call if needed. */
+    auth?: LTApiAuth;
+}
+/**
+ * Create a Long Tail SDK client for direct in-process API calls.
+ *
+ * All operations go through the same API layer as HTTP routes —
+ * same validation, same RBAC, same event publishing — without
+ * HTTP transport overhead.
+ *
+ * ```typescript
+ * import { createClient } from '@hotmeshio/long-tail/sdk';
+ *
+ * const lt = createClient({ auth: { userId: 'system' } });
+ *
+ * const result = await lt.escalations.claim({ id: 'esc_123', durationMinutes: 30 });
+ * // { status: 200, data: { escalation: {...}, isExtension: false } }
+ *
+ * lt.events.on('escalation.claimed', (event) => {
+ *   console.log('claimed:', event.escalationId);
+ * });
+ * ```
+ */
+export declare function createClient(options?: LTClientOptions): {
+    tasks: {
+        list: typeof tasksApi.listTasks;
+        get: typeof tasksApi.getTask;
+        listProcesses: typeof tasksApi.listProcesses;
+        getProcess: typeof tasksApi.getProcess;
+        getProcessStats: typeof tasksApi.getProcessStats;
+    };
+    escalations: {
+        create: (input: {
+            type: string;
+            subtype?: string;
+            role: string;
+            description?: string;
+            priority?: number;
+            envelope?: string;
+            metadata?: Record<string, any>;
+            escalation_payload?: string;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        list: (input: {
+            status?: string;
+            role?: string;
+            type?: string;
+            subtype?: string;
+            assigned_to?: string;
+            priority?: number;
+            limit?: number;
+            offset?: number;
+            sort_by?: string;
+            order?: string;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        listAvailable: (input: {
+            role?: string;
+            type?: string;
+            subtype?: string;
+            priority?: number;
+            limit?: number;
+            offset?: number;
+            sort_by?: string;
+            order?: string;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        listTypes: typeof escalationsApi.listDistinctTypes;
+        getStats: (input: {
+            period?: string;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        get: (input: {
+            id: string;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        getByWorkflowId: typeof escalationsApi.getEscalationsByWorkflowId;
+        escalate: (input: {
+            id: string;
+            targetRole: string;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        claim: (input: {
+            id: string;
+            durationMinutes?: number;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        release: (input: {
+            id: string;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        resolve: (input: {
+            id: string;
+            resolverPayload: Record<string, any>;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        releaseExpired: typeof escalationsApi.releaseExpiredClaims;
+        updatePriority: (input: {
+            ids: string[];
+            priority: number;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        bulkClaim: (input: {
+            ids: string[];
+            durationMinutes?: number;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        bulkAssign: (input: {
+            ids: string[];
+            targetUserId: string;
+            durationMinutes?: number;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        bulkEscalate: (input: {
+            ids: string[];
+            targetRole: string;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        bulkTriage: (input: {
+            ids: string[];
+            hint?: string;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+    };
+    workflows: {
+        invoke: (input: {
+            type: string;
+            data?: Record<string, any>;
+            metadata?: Record<string, any>;
+            execute_as?: string;
+            options?: Record<string, any>;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        getStatus: typeof workflowsApi.getWorkflowStatus;
+        getResult: typeof workflowsApi.getWorkflowResult;
+        terminate: typeof workflowsApi.terminateWorkflow;
+        export: typeof workflowsApi.exportWorkflow;
+        listWorkers: typeof workflowsApi.listWorkers;
+        listDiscovered: typeof workflowsApi.listDiscoveredWorkflows;
+        getCronStatus: typeof workflowsApi.getCronStatus;
+        listConfigs: typeof workflowsApi.listWorkflowConfigs;
+        getConfig: typeof workflowsApi.getWorkflowConfig;
+        upsertConfig: typeof workflowsApi.upsertWorkflowConfig;
+        deleteConfig: typeof workflowsApi.deleteWorkflowConfig;
+    };
+    yamlWorkflows: {
+        list: typeof yamlWorkflowsApi.listYamlWorkflows;
+        create: typeof yamlWorkflowsApi.createYamlWorkflow;
+        createDirect: typeof yamlWorkflowsApi.createYamlWorkflowDirect;
+        getAppIds: typeof yamlWorkflowsApi.getAppIds;
+        get: typeof yamlWorkflowsApi.getYamlWorkflow;
+        update: typeof yamlWorkflowsApi.updateYamlWorkflow;
+        regenerate: typeof yamlWorkflowsApi.regenerateYamlWorkflow;
+        delete: typeof yamlWorkflowsApi.deleteYamlWorkflow;
+        deploy: typeof yamlWorkflowsApi.deployYamlWorkflow;
+        activate: typeof yamlWorkflowsApi.activateYamlWorkflow;
+        invoke: (input: {
+            id: string;
+            data?: any;
+            sync?: boolean;
+            timeout?: number;
+            execute_as?: string;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        archive: typeof yamlWorkflowsApi.archiveYamlWorkflow;
+        getVersionHistory: typeof yamlWorkflowsApi.getVersionHistory;
+        getVersionSnapshot: typeof yamlWorkflowsApi.getVersionSnapshot;
+        getYamlContent: typeof yamlWorkflowsApi.getYamlContent;
+        setCronSchedule: typeof yamlWorkflowsApi.setCronSchedule;
+        clearCronSchedule: typeof yamlWorkflowsApi.clearCronSchedule;
+        getCronStatus: typeof yamlWorkflowsApi.getCronStatus;
+    };
+    users: {
+        list: typeof usersApi.listUsers;
+        get: typeof usersApi.getUser;
+        create: typeof usersApi.createUser;
+        update: typeof usersApi.updateUser;
+        delete: typeof usersApi.deleteUser;
+        getRoles: typeof usersApi.getUserRoles;
+        addRole: typeof usersApi.addUserRole;
+        removeRole: typeof usersApi.removeUserRole;
+    };
+    roles: {
+        list: typeof rolesApi.listRoles;
+        listWithDetails: typeof rolesApi.listRolesWithDetails;
+        create: typeof rolesApi.createRole;
+        delete: typeof rolesApi.deleteRole;
+        getEscalationChains: typeof rolesApi.getEscalationChains;
+        addEscalationChain: typeof rolesApi.addEscalationChain;
+        removeEscalationChain: typeof rolesApi.removeEscalationChain;
+        getEscalationTargets: typeof rolesApi.getEscalationTargets;
+        replaceEscalationTargets: typeof rolesApi.replaceEscalationTargets;
+    };
+    auth: {
+        login: typeof authApi.login;
+    };
+    mcp: {
+        listServers: typeof mcpApi.listMcpServers;
+        createServer: typeof mcpApi.createMcpServer;
+        testConnection: typeof mcpApi.testConnection;
+        getServer: typeof mcpApi.getMcpServer;
+        updateServer: typeof mcpApi.updateMcpServer;
+        deleteServer: typeof mcpApi.deleteMcpServer;
+        connectServer: typeof mcpApi.connectMcpServer;
+        disconnectServer: typeof mcpApi.disconnectMcpServer;
+        getCredentialStatus: (input: {
+            id: string;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        listTools: typeof mcpApi.listMcpServerTools;
+        callTool: (input: {
+            id: string;
+            toolName: string;
+            arguments?: Record<string, any>;
+            execute_as?: string;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+    };
+    mcpRuns: {
+        listEntities: typeof mcpRunsApi.listEntities;
+        listJobs: typeof mcpRunsApi.listJobs;
+        getExecution: typeof mcpRunsApi.getJobExecution;
+    };
+    insight: {
+        mcpQuery: (input: {
+            prompt: string;
+            tags?: string[];
+            wait?: boolean;
+            direct?: boolean;
+            context?: any;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        buildWorkflow: (input: {
+            prompt: string;
+            tags?: string[];
+            wait?: boolean;
+            feedback?: string;
+            prior_yaml?: string;
+            answers?: any;
+            prior_questions?: any;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        refineWorkflow: (input: {
+            prompt: string;
+            prior_yaml: string;
+            feedback: string;
+            tags?: string[];
+            wait?: boolean;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        describeWorkflow: typeof insightApi.describeWorkflow;
+    };
+    settings: {
+        get: typeof settingsApi.getSettings;
+    };
+    exports: {
+        listJobs: typeof exportsApi.listJobs;
+        exportState: typeof exportsApi.exportWorkflowState;
+        exportExecution: typeof exportsApi.exportWorkflowExecution;
+        getStatus: typeof exportsApi.getWorkflowStatus;
+        getState: typeof exportsApi.getWorkflowState;
+    };
+    controlplane: {
+        listApps: typeof controlplaneApi.listApps;
+        rollCall: typeof controlplaneApi.rollCall;
+        throttle: typeof controlplaneApi.applyThrottle;
+        getStreamStats: typeof controlplaneApi.getStreamStats;
+        subscribe: typeof controlplaneApi.subscribeMesh;
+    };
+    botAccounts: {
+        list: typeof botAccountsApi.listBots;
+        get: typeof botAccountsApi.getBot;
+        create: (input: {
+            name: string;
+            description?: string;
+            display_name?: string;
+            roles?: {
+                role: string;
+                type: string;
+            }[];
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        update: typeof botAccountsApi.updateBot;
+        delete: typeof botAccountsApi.deleteBot;
+        getRoles: typeof botAccountsApi.getBotRoles;
+        addRole: typeof botAccountsApi.addBotRole;
+        removeRole: typeof botAccountsApi.removeBotRole;
+        listKeys: typeof botAccountsApi.listBotKeys;
+        createKey: typeof botAccountsApi.createBotKey;
+        revokeKey: typeof botAccountsApi.revokeBotKey;
+    };
+    workflowSets: {
+        create: (input: {
+            name: string;
+            description?: string;
+            specification: string;
+        }, auth?: LTApiAuth) => Promise<LTApiResult<any>>;
+        list: typeof workflowSetsApi.listWorkflowSets;
+        get: typeof workflowSetsApi.getWorkflowSet;
+        updatePlan: typeof workflowSetsApi.updateWorkflowSetPlanApi;
+        build: typeof workflowSetsApi.buildWorkflowSet;
+        deploy: typeof workflowSetsApi.deployWorkflowSet;
+    };
+    dba: {
+        prune: typeof dbaApi.prune;
+        deploy: typeof dbaApi.deploy;
+    };
+    namespaces: {
+        list: typeof namespacesApi.listNamespaces;
+        register: typeof namespacesApi.registerNamespace;
+    };
+    maintenance: {
+        getConfig: typeof maintenanceApi.getMaintenanceConfig;
+        updateConfig: typeof maintenanceApi.updateMaintenanceConfig;
+    };
+    events: {
+        /**
+         * Subscribe to Long Tail events.
+         *
+         * Supports exact types (`'task.created'`), category wildcards (`'task.*'`),
+         * and global wildcard (`'*'`).
+         *
+         * Returns an unsubscribe function.
+         *
+         * ```typescript
+         * const unsub = lt.events.on('escalation.claimed', (event) => {
+         *   console.log('claimed:', event.escalationId);
+         * });
+         * // Later: unsub();
+         * ```
+         */
+        on: (pattern: LTEventType | "*" | (string & {}), callback: (event: LTEvent) => void) => (() => void);
+    };
+};
+/** The return type of createClient(). */
+export type LTClient = ReturnType<typeof createClient>;

package/build/sdk/index.js

@@ -0,0 +1,299 @@
+"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.createClient = createClient;
+const tasksApi = __importStar(require("../api/tasks"));
+const escalationsApi = __importStar(require("../api/escalations"));
+const workflowsApi = __importStar(require("../api/workflows"));
+const yamlWorkflowsApi = __importStar(require("../api/yaml-workflows"));
+const usersApi = __importStar(require("../api/users"));
+const rolesApi = __importStar(require("../api/roles"));
+const authApi = __importStar(require("../api/auth"));
+const mcpApi = __importStar(require("../api/mcp"));
+const mcpRunsApi = __importStar(require("../api/mcp-runs"));
+const insightApi = __importStar(require("../api/insight"));
+const settingsApi = __importStar(require("../api/settings"));
+const exportsApi = __importStar(require("../api/exports"));
+const controlplaneApi = __importStar(require("../api/controlplane"));
+const botAccountsApi = __importStar(require("../api/bot-accounts"));
+const workflowSetsApi = __importStar(require("../api/workflow-sets"));
+const dbaApi = __importStar(require("../api/dba"));
+const namespacesApi = __importStar(require("../api/namespaces"));
+const maintenanceApi = __importStar(require("../api/maintenance"));
+const events_1 = require("../lib/events");
+const callback_1 = require("../lib/events/callback");
+/** Bind auth context to a function that expects it as the last argument. */
+function bindAuth(fn, defaultAuth) {
+    return (input, auth) => {
+        const resolvedAuth = auth ?? defaultAuth;
+        if (!resolvedAuth) {
+            return Promise.resolve({ status: 401, error: 'Auth context required' });
+        }
+        return fn(input, resolvedAuth);
+    };
+}
+/** Bind optional auth context — passes undefined if not available. */
+function bindOptionalAuth(fn, defaultAuth) {
+    return (input, auth) => fn(input, auth ?? defaultAuth);
+}
+/**
+ * Create a Long Tail SDK client for direct in-process API calls.
+ *
+ * All operations go through the same API layer as HTTP routes —
+ * same validation, same RBAC, same event publishing — without
+ * HTTP transport overhead.
+ *
+ * ```typescript
+ * import { createClient } from '@hotmeshio/long-tail/sdk';
+ *
+ * const lt = createClient({ auth: { userId: 'system' } });
+ *
+ * const result = await lt.escalations.claim({ id: 'esc_123', durationMinutes: 30 });
+ * // { status: 200, data: { escalation: {...}, isExtension: false } }
+ *
+ * lt.events.on('escalation.claimed', (event) => {
+ *   console.log('claimed:', event.escalationId);
+ * });
+ * ```
+ */
+function createClient(options = {}) {
+    const auth = options.auth;
+    // Get or create the CallbackEventAdapter singleton
+    let callbackAdapter = events_1.eventRegistry.getAdapter(callback_1.CallbackEventAdapter);
+    if (!callbackAdapter) {
+        callbackAdapter = new callback_1.CallbackEventAdapter();
+        events_1.eventRegistry.register(callbackAdapter);
+        callbackAdapter.connect();
+    }
+    return {
+        // ── Tasks ──────────────────────────────────────────────────────────────
+        tasks: {
+            list: tasksApi.listTasks,
+            get: tasksApi.getTask,
+            listProcesses: tasksApi.listProcesses,
+            getProcess: tasksApi.getProcess,
+            getProcessStats: tasksApi.getProcessStats,
+        },
+        // ── Escalations ────────────────────────────────────────────────────────
+        escalations: {
+            create: bindAuth(escalationsApi.createEscalation, auth),
+            list: bindAuth(escalationsApi.listEscalations, auth),
+            listAvailable: bindAuth(escalationsApi.listAvailableEscalations, auth),
+            listTypes: escalationsApi.listDistinctTypes,
+            getStats: bindAuth(escalationsApi.getEscalationStats, auth),
+            get: bindAuth(escalationsApi.getEscalation, auth),
+            getByWorkflowId: escalationsApi.getEscalationsByWorkflowId,
+            escalate: bindAuth(escalationsApi.escalateToRole, auth),
+            claim: bindAuth(escalationsApi.claimEscalation, auth),
+            release: bindAuth(escalationsApi.releaseEscalation, auth),
+            resolve: bindAuth(escalationsApi.resolveEscalation, auth),
+            releaseExpired: escalationsApi.releaseExpiredClaims,
+            updatePriority: bindAuth(escalationsApi.updatePriority, auth),
+            bulkClaim: bindAuth(escalationsApi.bulkClaim, auth),
+            bulkAssign: bindAuth(escalationsApi.bulkAssign, auth),
+            bulkEscalate: bindAuth(escalationsApi.bulkEscalate, auth),
+            bulkTriage: bindAuth(escalationsApi.bulkTriage, auth),
+        },
+        // ── Workflows ──────────────────────────────────────────────────────────
+        workflows: {
+            invoke: bindAuth(workflowsApi.invokeWorkflow, auth),
+            getStatus: workflowsApi.getWorkflowStatus,
+            getResult: workflowsApi.getWorkflowResult,
+            terminate: workflowsApi.terminateWorkflow,
+            export: workflowsApi.exportWorkflow,
+            listWorkers: workflowsApi.listWorkers,
+            listDiscovered: workflowsApi.listDiscoveredWorkflows,
+            getCronStatus: workflowsApi.getCronStatus,
+            listConfigs: workflowsApi.listWorkflowConfigs,
+            getConfig: workflowsApi.getWorkflowConfig,
+            upsertConfig: workflowsApi.upsertWorkflowConfig,
+            deleteConfig: workflowsApi.deleteWorkflowConfig,
+        },
+        // ── YAML Workflows ─────────────────────────────────────────────────────
+        yamlWorkflows: {
+            list: yamlWorkflowsApi.listYamlWorkflows,
+            create: yamlWorkflowsApi.createYamlWorkflow,
+            createDirect: yamlWorkflowsApi.createYamlWorkflowDirect,
+            getAppIds: yamlWorkflowsApi.getAppIds,
+            get: yamlWorkflowsApi.getYamlWorkflow,
+            update: yamlWorkflowsApi.updateYamlWorkflow,
+            regenerate: yamlWorkflowsApi.regenerateYamlWorkflow,
+            delete: yamlWorkflowsApi.deleteYamlWorkflow,
+            deploy: yamlWorkflowsApi.deployYamlWorkflow,
+            activate: yamlWorkflowsApi.activateYamlWorkflow,
+            invoke: bindOptionalAuth(yamlWorkflowsApi.invokeYamlWorkflow, auth),
+            archive: yamlWorkflowsApi.archiveYamlWorkflow,
+            getVersionHistory: yamlWorkflowsApi.getVersionHistory,
+            getVersionSnapshot: yamlWorkflowsApi.getVersionSnapshot,
+            getYamlContent: yamlWorkflowsApi.getYamlContent,
+            setCronSchedule: yamlWorkflowsApi.setCronSchedule,
+            clearCronSchedule: yamlWorkflowsApi.clearCronSchedule,
+            getCronStatus: yamlWorkflowsApi.getCronStatus,
+        },
+        // ── Users ──────────────────────────────────────────────────────────────
+        users: {
+            list: usersApi.listUsers,
+            get: usersApi.getUser,
+            create: usersApi.createUser,
+            update: usersApi.updateUser,
+            delete: usersApi.deleteUser,
+            getRoles: usersApi.getUserRoles,
+            addRole: usersApi.addUserRole,
+            removeRole: usersApi.removeUserRole,
+        },
+        // ── Roles ──────────────────────────────────────────────────────────────
+        roles: {
+            list: rolesApi.listRoles,
+            listWithDetails: rolesApi.listRolesWithDetails,
+            create: rolesApi.createRole,
+            delete: rolesApi.deleteRole,
+            getEscalationChains: rolesApi.getEscalationChains,
+            addEscalationChain: rolesApi.addEscalationChain,
+            removeEscalationChain: rolesApi.removeEscalationChain,
+            getEscalationTargets: rolesApi.getEscalationTargets,
+            replaceEscalationTargets: rolesApi.replaceEscalationTargets,
+        },
+        // ── Auth ───────────────────────────────────────────────────────────────
+        auth: {
+            login: authApi.login,
+        },
+        // ── MCP ────────────────────────────────────────────────────────────────
+        mcp: {
+            listServers: mcpApi.listMcpServers,
+            createServer: mcpApi.createMcpServer,
+            testConnection: mcpApi.testConnection,
+            getServer: mcpApi.getMcpServer,
+            updateServer: mcpApi.updateMcpServer,
+            deleteServer: mcpApi.deleteMcpServer,
+            connectServer: mcpApi.connectMcpServer,
+            disconnectServer: mcpApi.disconnectMcpServer,
+            getCredentialStatus: bindAuth(mcpApi.getCredentialStatus, auth),
+            listTools: mcpApi.listMcpServerTools,
+            callTool: bindOptionalAuth(mcpApi.callMcpTool, auth),
+        },
+        // ── MCP Runs ───────────────────────────────────────────────────────────
+        mcpRuns: {
+            listEntities: mcpRunsApi.listEntities,
+            listJobs: mcpRunsApi.listJobs,
+            getExecution: mcpRunsApi.getJobExecution,
+        },
+        // ── Insight ────────────────────────────────────────────────────────────
+        insight: {
+            mcpQuery: bindOptionalAuth(insightApi.mcpQuery, auth),
+            buildWorkflow: bindOptionalAuth(insightApi.buildWorkflow, auth),
+            refineWorkflow: bindOptionalAuth(insightApi.refineWorkflow, auth),
+            describeWorkflow: insightApi.describeWorkflow,
+        },
+        // ── Settings ───────────────────────────────────────────────────────────
+        settings: {
+            get: settingsApi.getSettings,
+        },
+        // ── Exports ────────────────────────────────────────────────────────────
+        exports: {
+            listJobs: exportsApi.listJobs,
+            exportState: exportsApi.exportWorkflowState,
+            exportExecution: exportsApi.exportWorkflowExecution,
+            getStatus: exportsApi.getWorkflowStatus,
+            getState: exportsApi.getWorkflowState,
+        },
+        // ── Control Plane ──────────────────────────────────────────────────────
+        controlplane: {
+            listApps: controlplaneApi.listApps,
+            rollCall: controlplaneApi.rollCall,
+            throttle: controlplaneApi.applyThrottle,
+            getStreamStats: controlplaneApi.getStreamStats,
+            subscribe: controlplaneApi.subscribeMesh,
+        },
+        // ── Bot Accounts ───────────────────────────────────────────────────────
+        botAccounts: {
+            list: botAccountsApi.listBots,
+            get: botAccountsApi.getBot,
+            create: bindOptionalAuth(botAccountsApi.createBot, auth),
+            update: botAccountsApi.updateBot,
+            delete: botAccountsApi.deleteBot,
+            getRoles: botAccountsApi.getBotRoles,
+            addRole: botAccountsApi.addBotRole,
+            removeRole: botAccountsApi.removeBotRole,
+            listKeys: botAccountsApi.listBotKeys,
+            createKey: botAccountsApi.createBotKey,
+            revokeKey: botAccountsApi.revokeBotKey,
+        },
+        // ── Workflow Sets ──────────────────────────────────────────────────────
+        workflowSets: {
+            create: bindOptionalAuth(workflowSetsApi.createWorkflowSet, auth),
+            list: workflowSetsApi.listWorkflowSets,
+            get: workflowSetsApi.getWorkflowSet,
+            updatePlan: workflowSetsApi.updateWorkflowSetPlanApi,
+            build: workflowSetsApi.buildWorkflowSet,
+            deploy: workflowSetsApi.deployWorkflowSet,
+        },
+        // ── DBA ────────────────────────────────────────────────────────────────
+        dba: {
+            prune: dbaApi.prune,
+            deploy: dbaApi.deploy,
+        },
+        // ── Namespaces ─────────────────────────────────────────────────────────
+        namespaces: {
+            list: namespacesApi.listNamespaces,
+            register: namespacesApi.registerNamespace,
+        },
+        // ── Maintenance ────────────────────────────────────────────────────────
+        maintenance: {
+            getConfig: maintenanceApi.getMaintenanceConfig,
+            updateConfig: maintenanceApi.updateMaintenanceConfig,
+        },
+        // ── Events ─────────────────────────────────────────────────────────────
+        events: {
+            /**
+             * Subscribe to Long Tail events.
+             *
+             * Supports exact types (`'task.created'`), category wildcards (`'task.*'`),
+             * and global wildcard (`'*'`).
+             *
+             * Returns an unsubscribe function.
+             *
+             * ```typescript
+             * const unsub = lt.events.on('escalation.claimed', (event) => {
+             *   console.log('claimed:', event.escalationId);
+             * });
+             * // Later: unsub();
+             * ```
+             */
+            on: (pattern, callback) => {
+                return callbackAdapter.on(pattern, callback);
+            },
+        },
+    };
+}

package/build/services/controlplane/index.d.ts

@@ -9,8 +9,7 @@ export type { QuorumProfile, ThrottleOptions };
  */
 export declare function getEngine(appId: string): Promise<HotMesh>;
 /**
- * List all HotMesh application IDs from the `hotmesh_applications` table.
- * Excludes soft-deleted (expired) entries.
+ * List all active HotMesh application IDs from the `hmsh_applications` table.
  */
 export declare function listApps(): Promise<ControlPlaneApp[]>;
 /**

package/build/services/controlplane/index.js

@@ -35,14 +35,14 @@ async function getEngine(appId) {
 }
 // ─── Application discovery ──────────────────────────────────────────────────
 /**
- * List all HotMesh application IDs from the `hotmesh_applications` table.
- * Excludes soft-deleted (expired) entries.
+ * List all active HotMesh application IDs from the `hmsh_applications` table.
  */
 async function listApps() {
     const pool = (0, db_1.getPool)();
     const { rows } = await pool.query(sql_1.LIST_APPS);
     return rows.map((r) => ({
-        appId: r.key.replace('hmsh:a:', ''),
+        appId: r.app_id,
+        version: r.version,
     }));
 }
 // ─── Roll call ──────────────────────────────────────────────────────────────

package/build/services/controlplane/sql.d.ts

@@ -1,8 +1,8 @@
 /**
  * List all HotMesh applications from the global registry.
- * Keys follow the pattern `hmsh:a:{appId}`. Non-expired only.
+ * Active apps only.
  */
-export declare const LIST_APPS = "\n  SELECT DISTINCT key FROM hotmesh_applications\n  WHERE key LIKE 'hmsh:a:%'\n    AND (expiry IS NULL OR expiry > NOW())\n  ORDER BY key";
+export declare const LIST_APPS = "\n  SELECT app_id, version FROM hmsh_applications\n  WHERE active = TRUE\n  ORDER BY app_id";
 /**
  * Count pending (unprocessed) stream messages across both tables.
  * expired_at IS NULL = message has not been consumed yet.