@hotmeshio/long-tail 0.3.0 → 0.3.1

package/build/api/topics.d.ts

@@ -0,0 +1,22 @@
+import type { LTApiResult } from '../types/sdk';
+export declare function listTopics(input: {
+    category?: string;
+    search?: string;
+    limit?: number;
+    offset?: number;
+}): Promise<LTApiResult>;
+export declare function getTopic(input: {
+    topic: string;
+}): Promise<LTApiResult>;
+export declare function createTopic(input: {
+    topic: string;
+    category: string;
+    [key: string]: any;
+}): Promise<LTApiResult>;
+export declare function updateTopic(input: {
+    topic: string;
+    [key: string]: any;
+}): Promise<LTApiResult>;
+export declare function deleteTopic(input: {
+    topic: string;
+}): Promise<LTApiResult>;

package/build/api/topics.js

@@ -0,0 +1,104 @@
+"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.listTopics = listTopics;
+exports.getTopic = getTopic;
+exports.createTopic = createTopic;
+exports.updateTopic = updateTopic;
+exports.deleteTopic = deleteTopic;
+const topicService = __importStar(require("../services/topics"));
+async function listTopics(input) {
+    try {
+        const result = await topicService.listTopics(input);
+        return { status: 200, data: result };
+    }
+    catch (err) {
+        return { status: 500, error: err.message };
+    }
+}
+async function getTopic(input) {
+    try {
+        const topic = await topicService.getTopic(input.topic);
+        if (!topic) {
+            return { status: 404, error: 'Topic not found' };
+        }
+        return { status: 200, data: topic };
+    }
+    catch (err) {
+        return { status: 500, error: err.message };
+    }
+}
+async function createTopic(input) {
+    try {
+        const topic = await topicService.createTopic(input);
+        return { status: 201, data: topic };
+    }
+    catch (err) {
+        if (err.code === '23505') {
+            return { status: 409, error: `Topic "${input.topic}" already exists` };
+        }
+        return { status: 500, error: err.message };
+    }
+}
+async function updateTopic(input) {
+    try {
+        const { topic, ...data } = input;
+        const updated = await topicService.updateTopic(topic, data);
+        if (!updated) {
+            return { status: 404, error: 'Topic not found' };
+        }
+        return { status: 200, data: updated };
+    }
+    catch (err) {
+        return { status: 500, error: err.message };
+    }
+}
+async function deleteTopic(input) {
+    try {
+        // Check if it exists and if it's a system topic
+        const existing = await topicService.getTopic(input.topic);
+        if (!existing) {
+            return { status: 404, error: 'Topic not found' };
+        }
+        if (existing.source === 'system') {
+            return { status: 403, error: 'System topics cannot be deleted' };
+        }
+        await topicService.deleteTopic(input.topic);
+        return { status: 200, data: { deleted: true } };
+    }
+    catch (err) {
+        return { status: 500, error: err.message };
+    }
+}

package/build/index.d.ts

@@ -10,12 +10,14 @@ export * as TaskService from './services/task';
 export * as EscalationService from './services/escalation';
 export * as ConfigService from './services/config';
 export * as UserService from './services/user';
+export * as TopicService from './services/topics';
+export { seedSystemTopics, seedConfigTopics } from './services/topics/system-topics';
 export { ltConfig } from './modules/ltconfig';
 export { eventRegistry } from './lib/events';
 export { NatsEventAdapter } from './lib/events/nats';
 export { InMemoryEventAdapter } from './lib/events/memory';
 export { SocketIOEventAdapter, type SocketIOAuthenticator } from './lib/events/socketio';
-export { publishMilestoneEvent, publishTaskEvent, publishEscalationEvent, publishWorkflowEvent, publishAgentEvent, publishKnowledgeEvent } from './lib/events/publish';
+export { publishMilestoneEvent, publishTaskEvent, publishEscalationEvent, publishActivityEvent, publishWorkflowEvent, publishAgentEvent, publishKnowledgeEvent } from './lib/events/publish';
 export { telemetryRegistry } from './lib/telemetry';
 export { HoneycombTelemetryAdapter } from './lib/telemetry/honeycomb';
 export { loggerRegistry } from './lib/logger';

package/build/index.js

@@ -36,8 +36,8 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createClient = exports.CallbackEventAdapter = exports.builtinMcpServerFactories = exports.getSystemAgents = exports.getSystemWorkers = exports.registerMcpTool = exports.getToolContext = exports.getActivityIdentity = exports.McpEscalationStrategy = exports.DefaultEscalationStrategy = exports.escalationStrategyRegistry = exports.McpVisionServer = exports.McpTranslationServer = exports.McpServer = exports.McpClient = exports.McpService = exports.BuiltInMcpAdapter = exports.mcpRegistry = exports.defaultMaintenanceConfig = exports.maintenanceRegistry = exports.PinoLoggerAdapter = exports.loggerRegistry = exports.HoneycombTelemetryAdapter = exports.telemetryRegistry = exports.publishKnowledgeEvent = exports.publishAgentEvent = exports.publishWorkflowEvent = exports.publishEscalationEvent = exports.publishTaskEvent = exports.publishMilestoneEvent = exports.SocketIOEventAdapter = exports.InMemoryEventAdapter = exports.NatsEventAdapter = exports.eventRegistry = exports.ltConfig = exports.UserService = exports.ConfigService = exports.EscalationService = exports.TaskService = exports.signToken = exports.requireAdmin = exports.requireAuth = exports.createAuthMiddleware = exports.JwtAuthAdapter = exports.conditionLT = exports.executeLT = exports.createLTActivityInterceptor = exports.createLTInterceptor = exports.registerLT = exports.start = void 0;
-exports.api = exports.KnowledgeApi = exports.resolveCredential = exports.mimeFromPath = exports.getStorageBackend = exports.listOAuthConnections = exports.getFreshAccessToken = void 0;
+exports.getSystemWorkers = exports.registerMcpTool = exports.getToolContext = exports.getActivityIdentity = exports.McpEscalationStrategy = exports.DefaultEscalationStrategy = exports.escalationStrategyRegistry = exports.McpVisionServer = exports.McpTranslationServer = exports.McpServer = exports.McpClient = exports.McpService = exports.BuiltInMcpAdapter = exports.mcpRegistry = exports.defaultMaintenanceConfig = exports.maintenanceRegistry = exports.PinoLoggerAdapter = exports.loggerRegistry = exports.HoneycombTelemetryAdapter = exports.telemetryRegistry = exports.publishKnowledgeEvent = exports.publishAgentEvent = exports.publishWorkflowEvent = exports.publishActivityEvent = exports.publishEscalationEvent = exports.publishTaskEvent = exports.publishMilestoneEvent = exports.SocketIOEventAdapter = exports.InMemoryEventAdapter = exports.NatsEventAdapter = exports.eventRegistry = exports.ltConfig = exports.seedConfigTopics = exports.seedSystemTopics = exports.TopicService = exports.UserService = exports.ConfigService = exports.EscalationService = exports.TaskService = exports.signToken = exports.requireAdmin = exports.requireAuth = exports.createAuthMiddleware = exports.JwtAuthAdapter = exports.conditionLT = exports.executeLT = exports.createLTActivityInterceptor = exports.createLTInterceptor = exports.registerLT = exports.start = void 0;
+exports.api = exports.KnowledgeApi = exports.resolveCredential = exports.mimeFromPath = exports.getStorageBackend = exports.listOAuthConnections = exports.getFreshAccessToken = exports.createClient = exports.CallbackEventAdapter = exports.builtinMcpServerFactories = exports.getSystemAgents = void 0;
 const config_1 = require("./modules/config");
 const logger_1 = require("./lib/logger");
 const start_1 = require("./start");
@@ -64,6 +64,10 @@ exports.TaskService = __importStar(require("./services/task"));
 exports.EscalationService = __importStar(require("./services/escalation"));
 exports.ConfigService = __importStar(require("./services/config"));
 exports.UserService = __importStar(require("./services/user"));
+exports.TopicService = __importStar(require("./services/topics"));
+var system_topics_1 = require("./services/topics/system-topics");
+Object.defineProperty(exports, "seedSystemTopics", { enumerable: true, get: function () { return system_topics_1.seedSystemTopics; } });
+Object.defineProperty(exports, "seedConfigTopics", { enumerable: true, get: function () { return system_topics_1.seedConfigTopics; } });
 var ltconfig_1 = require("./modules/ltconfig");
 Object.defineProperty(exports, "ltConfig", { enumerable: true, get: function () { return ltconfig_1.ltConfig; } });
 var events_1 = require("./lib/events");
@@ -78,6 +82,7 @@ var publish_1 = require("./lib/events/publish");
 Object.defineProperty(exports, "publishMilestoneEvent", { enumerable: true, get: function () { return publish_1.publishMilestoneEvent; } });
 Object.defineProperty(exports, "publishTaskEvent", { enumerable: true, get: function () { return publish_1.publishTaskEvent; } });
 Object.defineProperty(exports, "publishEscalationEvent", { enumerable: true, get: function () { return publish_1.publishEscalationEvent; } });
+Object.defineProperty(exports, "publishActivityEvent", { enumerable: true, get: function () { return publish_1.publishActivityEvent; } });
 Object.defineProperty(exports, "publishWorkflowEvent", { enumerable: true, get: function () { return publish_1.publishWorkflowEvent; } });
 Object.defineProperty(exports, "publishAgentEvent", { enumerable: true, get: function () { return publish_1.publishAgentEvent; } });
 Object.defineProperty(exports, "publishKnowledgeEvent", { enumerable: true, get: function () { return publish_1.publishKnowledgeEvent; } });

package/build/lib/db/schemas/007_topic_catalog.sql

@@ -0,0 +1,27 @@
+-- Topic catalog — persistent registry of known event topics with metadata.
+-- Each row describes a topic: what it means, what payload shape it carries,
+-- and who publishes it. System topics are seeded at startup; app topics
+-- are auto-registered on first publish.
+
+CREATE TABLE IF NOT EXISTS lt_topic_catalog (
+  topic           TEXT PRIMARY KEY,
+  description     TEXT,
+  category        TEXT NOT NULL CHECK (category IN (
+    'task','workflow','escalation','activity','knowledge','agent','app','milestone'
+  )),
+  payload_schema  JSONB,
+  example_payload JSONB,
+  source          TEXT NOT NULL DEFAULT 'system',
+  tags            TEXT[] NOT NULL DEFAULT '{}',
+  managed         BOOLEAN NOT NULL DEFAULT false,
+  last_seen_at    TIMESTAMPTZ,
+  created_at      TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  updated_at      TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);
+
+CREATE INDEX IF NOT EXISTS idx_lt_topic_catalog_category ON lt_topic_catalog (category);
+CREATE INDEX IF NOT EXISTS idx_lt_topic_catalog_tags ON lt_topic_catalog USING GIN (tags);
+
+CREATE OR REPLACE TRIGGER trg_lt_topic_catalog_updated_at
+  BEFORE UPDATE ON lt_topic_catalog
+  FOR EACH ROW EXECUTE FUNCTION lt_set_updated_at();

package/build/routes/index.js

@@ -31,6 +31,7 @@ const workflow_sets_1 = __importDefault(require("./workflow-sets"));
 const knowledge_1 = __importDefault(require("./knowledge"));
 const agents_1 = __importDefault(require("./agents"));
 const capabilities_1 = __importDefault(require("./capabilities"));
+const topics_1 = __importDefault(require("./topics"));
 const nats_credentials_1 = __importDefault(require("./nats-credentials"));
 const router = (0, express_1.Router)();
 // Public routes (no auth required — they handle their own auth)
@@ -63,4 +64,5 @@ router.use('/workflow-sets', workflow_sets_1.default);
 router.use('/knowledge', knowledge_1.default);
 router.use('/agents', agents_1.default);
 router.use('/capabilities', capabilities_1.default);
+router.use('/topics', topics_1.default);
 exports.default = router;

package/build/routes/topics.d.ts

@@ -0,0 +1,2 @@
+declare const router: import("express-serve-static-core").Router;
+export default router;

package/build/routes/topics.js

@@ -0,0 +1,90 @@
+"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 });
+const express_1 = require("express");
+const api = __importStar(require("../api/topics"));
+const router = (0, express_1.Router)();
+/**
+ * GET /api/topics
+ * List topics with optional filters.
+ * Query: ?category=task&search=...&limit=50&offset=0
+ */
+router.get('/', async (req, res) => {
+    const result = await api.listTopics({
+        category: req.query.category || undefined,
+        search: req.query.search || undefined,
+        limit: req.query.limit ? parseInt(req.query.limit, 10) : undefined,
+        offset: req.query.offset ? parseInt(req.query.offset, 10) : undefined,
+    });
+    res.status(result.status).json(result.data ?? { error: result.error });
+});
+/**
+ * POST /api/topics
+ * Register a new topic in the catalog.
+ */
+router.post('/', async (req, res) => {
+    const { topic, category } = req.body;
+    if (!topic || !category) {
+        res.status(400).json({ error: 'topic and category are required' });
+        return;
+    }
+    const result = await api.createTopic(req.body);
+    res.status(result.status).json(result.data ?? { error: result.error });
+});
+/**
+ * GET /api/topics/by-name/:topic
+ * Get a single topic by key. Client must encodeURIComponent the topic.
+ */
+router.get('/by-name/:topic', async (req, res) => {
+    const result = await api.getTopic({ topic: decodeURIComponent(req.params.topic) });
+    res.status(result.status).json(result.data ?? { error: result.error });
+});
+/**
+ * PUT /api/topics/by-name/:topic
+ * Update a topic in the catalog.
+ */
+router.put('/by-name/:topic', async (req, res) => {
+    const result = await api.updateTopic({ topic: decodeURIComponent(req.params.topic), ...req.body });
+    res.status(result.status).json(result.data ?? { error: result.error });
+});
+/**
+ * DELETE /api/topics/by-name/:topic
+ * Delete a topic from the catalog (system topics are protected).
+ */
+router.delete('/by-name/:topic', async (req, res) => {
+    const result = await api.deleteTopic({ topic: decodeURIComponent(req.params.topic) });
+    res.status(result.status).json(result.data ?? { error: result.error });
+});
+exports.default = router;

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

@@ -0,0 +1,77 @@
+export interface TopicCatalogEntry {
+    topic: string;
+    description?: string;
+    category: string;
+    payload_schema?: Record<string, any>;
+    example_payload?: Record<string, any>;
+    source: string;
+    tags: string[];
+    /** When true, this topic is managed by static config (reset: true). Dashboard edits would be overwritten on next boot. */
+    managed: boolean;
+    last_seen_at?: string;
+    subscriber_count?: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface TopicSubscriber {
+    id: string;
+    agent_id: string;
+    agent_name: string;
+    topic: string;
+    reaction_type: string;
+}
+export declare function listTopics(filters?: {
+    category?: string;
+    search?: string;
+    limit?: number;
+    offset?: number;
+}): Promise<{
+    topics: TopicCatalogEntry[];
+    total: number;
+}>;
+export declare function getTopic(topic: string): Promise<(TopicCatalogEntry & {
+    subscribers: TopicSubscriber[];
+}) | null>;
+export declare function createTopic(data: {
+    topic: string;
+    description?: string;
+    category: string;
+    payload_schema?: Record<string, any>;
+    example_payload?: Record<string, any>;
+    source?: string;
+    tags?: string[];
+}): Promise<TopicCatalogEntry>;
+export declare function updateTopic(topic: string, data: Partial<TopicCatalogEntry>): Promise<TopicCatalogEntry | null>;
+export declare function deleteTopic(topic: string): Promise<boolean>;
+/**
+ * Auto-register or update a topic on publish (learn-on-first-use).
+ * Creates the entry on first publish; updates last_seen on subsequent publishes.
+ */
+export declare function upsertTopicOnPublish(topic: string, data?: Record<string, any>, source?: string): Promise<void>;
+/**
+ * Seed a topic at startup (insert-if-absent).
+ * Conflict on topic — DB is source of truth after first boot.
+ */
+export declare function seedTopic(data: {
+    topic: string;
+    description: string;
+    category: string;
+    payload_schema?: Record<string, any>;
+    example_payload?: Record<string, any>;
+    source?: string;
+    tags?: string[];
+}): Promise<boolean>;
+/**
+ * Reset a topic at startup — config is source of truth.
+ * Overwrites description, category, schema, tags on every boot.
+ * Used when `reset: true` is set in static topic config.
+ */
+export declare function resetTopic(data: {
+    topic: string;
+    description: string;
+    category: string;
+    payload_schema?: Record<string, any>;
+    example_payload?: Record<string, any>;
+    source?: string;
+    tags?: string[];
+}): Promise<void>;

package/build/services/topics/index.js

@@ -0,0 +1,116 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listTopics = listTopics;
+exports.getTopic = getTopic;
+exports.createTopic = createTopic;
+exports.updateTopic = updateTopic;
+exports.deleteTopic = deleteTopic;
+exports.upsertTopicOnPublish = upsertTopicOnPublish;
+exports.seedTopic = seedTopic;
+exports.resetTopic = resetTopic;
+const db_1 = require("../../lib/db");
+const matching_1 = require("../../lib/events/matching");
+const sql_1 = require("./sql");
+async function listTopics(filters = {}) {
+    const pool = (0, db_1.getPool)();
+    const limit = filters.limit ?? 50;
+    const offset = filters.offset ?? 0;
+    const category = filters.category ?? null;
+    const search = filters.search ?? null;
+    const [dataResult, countResult] = await Promise.all([
+        pool.query(sql_1.LIST_TOPICS, [category, search, limit, offset]),
+        pool.query(sql_1.COUNT_TOPICS, [category, search]),
+    ]);
+    return {
+        topics: dataResult.rows,
+        total: countResult.rows[0]?.total ?? 0,
+    };
+}
+async function getTopic(topic) {
+    const pool = (0, db_1.getPool)();
+    const { rows } = await pool.query(sql_1.GET_TOPIC, [topic]);
+    if (!rows[0])
+        return null;
+    // Find all active subscriptions whose pattern matches this topic
+    const { rows: allSubs } = await pool.query(sql_1.LIST_SUBSCRIBERS);
+    const subscribers = allSubs.filter((sub) => (0, matching_1.subjectMatchesPattern)(topic, sub.topic));
+    return { ...rows[0], subscribers };
+}
+async function createTopic(data) {
+    const pool = (0, db_1.getPool)();
+    const { rows } = await pool.query(sql_1.INSERT_TOPIC, [
+        data.topic,
+        data.description ?? null,
+        data.category,
+        data.payload_schema ? JSON.stringify(data.payload_schema) : null,
+        data.example_payload ? JSON.stringify(data.example_payload) : null,
+        data.source ?? 'app',
+        data.tags ?? [],
+    ]);
+    return rows[0];
+}
+async function updateTopic(topic, data) {
+    const pool = (0, db_1.getPool)();
+    const { rows } = await pool.query(sql_1.UPDATE_TOPIC, [
+        topic,
+        data.description ?? null,
+        data.category ?? null,
+        data.payload_schema ? JSON.stringify(data.payload_schema) : null,
+        data.example_payload ? JSON.stringify(data.example_payload) : null,
+        data.tags ?? null,
+    ]);
+    return rows[0] ?? null;
+}
+async function deleteTopic(topic) {
+    const pool = (0, db_1.getPool)();
+    const { rowCount } = await pool.query(sql_1.DELETE_TOPIC, [topic]);
+    return (rowCount ?? 0) > 0;
+}
+/**
+ * Auto-register or update a topic on publish (learn-on-first-use).
+ * Creates the entry on first publish; updates last_seen on subsequent publishes.
+ */
+async function upsertTopicOnPublish(topic, data, source) {
+    const pool = (0, db_1.getPool)();
+    const category = topic.startsWith('app.') ? 'app' : topic.split('.')[0];
+    await pool.query(sql_1.UPSERT_ON_PUBLISH, [
+        topic,
+        category,
+        source ?? 'mcp-tool',
+        data ? JSON.stringify(data) : null,
+    ]);
+}
+/**
+ * Seed a topic at startup (insert-if-absent).
+ * Conflict on topic — DB is source of truth after first boot.
+ */
+async function seedTopic(data) {
+    const pool = (0, db_1.getPool)();
+    const { rowCount } = await pool.query(sql_1.SEED_TOPIC, [
+        data.topic,
+        data.description,
+        data.category,
+        data.payload_schema ? JSON.stringify(data.payload_schema) : null,
+        data.example_payload ? JSON.stringify(data.example_payload) : null,
+        data.source ?? 'system',
+        data.tags ?? [],
+    ]);
+    return (rowCount ?? 0) > 0;
+}
+/**
+ * Reset a topic at startup — config is source of truth.
+ * Overwrites description, category, schema, tags on every boot.
+ * Used when `reset: true` is set in static topic config.
+ */
+async function resetTopic(data) {
+    const pool = (0, db_1.getPool)();
+    await pool.query(sql_1.RESET_TOPIC, [
+        data.topic,
+        data.description,
+        data.category,
+        data.payload_schema ? JSON.stringify(data.payload_schema) : null,
+        data.example_payload ? JSON.stringify(data.example_payload) : null,
+        data.source ?? 'config',
+        data.tags ?? [],
+    ]);
+}

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

@@ -0,0 +1,10 @@
+export declare const LIST_TOPICS = "\n  SELECT t.*,\n    COALESCE(s.sub_count, 0)::int AS subscriber_count\n  FROM lt_topic_catalog t\n  LEFT JOIN LATERAL (\n    SELECT COUNT(*)::int AS sub_count\n    FROM lt_agent_subscriptions\n    WHERE enabled = true\n      AND (topic = t.topic OR topic LIKE '%>%' OR topic LIKE '%*%')\n  ) s ON true\n  WHERE ($1::text IS NULL OR t.category = $1)\n    AND ($2::text IS NULL OR t.topic ILIKE '%' || $2 || '%' OR t.description ILIKE '%' || $2 || '%')\n  ORDER BY t.category, t.topic\n  LIMIT $3 OFFSET $4\n";
+export declare const COUNT_TOPICS = "\n  SELECT COUNT(*)::int AS total FROM lt_topic_catalog\n  WHERE ($1::text IS NULL OR category = $1)\n    AND ($2::text IS NULL OR topic ILIKE '%' || $2 || '%' OR description ILIKE '%' || $2 || '%')\n";
+export declare const GET_TOPIC = "\n  SELECT * FROM lt_topic_catalog WHERE topic = $1\n";
+export declare const INSERT_TOPIC = "\n  INSERT INTO lt_topic_catalog\n    (topic, description, category, payload_schema, example_payload, source, tags)\n  VALUES ($1, $2, $3, $4, $5, $6, $7)\n  RETURNING *\n";
+export declare const UPDATE_TOPIC = "\n  UPDATE lt_topic_catalog SET\n    description = COALESCE($2, description),\n    category = COALESCE($3, category),\n    payload_schema = COALESCE($4, payload_schema),\n    example_payload = COALESCE($5, example_payload),\n    tags = COALESCE($6, tags)\n  WHERE topic = $1\n  RETURNING *\n";
+export declare const DELETE_TOPIC = "\n  DELETE FROM lt_topic_catalog WHERE topic = $1 AND source != 'system'\n";
+export declare const UPSERT_ON_PUBLISH = "\n  INSERT INTO lt_topic_catalog\n    (topic, category, source, example_payload, last_seen_at)\n  VALUES ($1, $2, $3, $4, NOW())\n  ON CONFLICT (topic) DO UPDATE SET\n    last_seen_at = NOW(),\n    example_payload = COALESCE(EXCLUDED.example_payload, lt_topic_catalog.example_payload)\n";
+export declare const SEED_TOPIC = "\n  INSERT INTO lt_topic_catalog\n    (topic, description, category, payload_schema, example_payload, source, tags)\n  VALUES ($1, $2, $3, $4, $5, $6, $7)\n  ON CONFLICT (topic) DO NOTHING\n";
+export declare const RESET_TOPIC = "\n  INSERT INTO lt_topic_catalog\n    (topic, description, category, payload_schema, example_payload, source, tags, managed)\n  VALUES ($1, $2, $3, $4, $5, $6, $7, true)\n  ON CONFLICT (topic) DO UPDATE SET\n    description = EXCLUDED.description,\n    category = EXCLUDED.category,\n    payload_schema = EXCLUDED.payload_schema,\n    example_payload = EXCLUDED.example_payload,\n    source = EXCLUDED.source,\n    tags = EXCLUDED.tags,\n    managed = true\n";
+export declare const LIST_SUBSCRIBERS = "\n  SELECT s.id, s.agent_id, s.topic, s.reaction_type,\n    a.name AS agent_name\n  FROM lt_agent_subscriptions s\n  JOIN lt_agents a ON s.agent_id = a.id\n  WHERE s.enabled = true AND a.status = 'active'\n  ORDER BY s.created_at\n";

package/build/services/topics/sql.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LIST_SUBSCRIBERS = exports.RESET_TOPIC = exports.SEED_TOPIC = exports.UPSERT_ON_PUBLISH = exports.DELETE_TOPIC = exports.UPDATE_TOPIC = exports.INSERT_TOPIC = exports.GET_TOPIC = exports.COUNT_TOPICS = exports.LIST_TOPICS = void 0;
+exports.LIST_TOPICS = `
+  SELECT t.*,
+    COALESCE(s.sub_count, 0)::int AS subscriber_count
+  FROM lt_topic_catalog t
+  LEFT JOIN LATERAL (
+    SELECT COUNT(*)::int AS sub_count
+    FROM lt_agent_subscriptions
+    WHERE enabled = true
+      AND (topic = t.topic OR topic LIKE '%>%' OR topic LIKE '%*%')
+  ) s ON true
+  WHERE ($1::text IS NULL OR t.category = $1)
+    AND ($2::text IS NULL OR t.topic ILIKE '%' || $2 || '%' OR t.description ILIKE '%' || $2 || '%')
+  ORDER BY t.category, t.topic
+  LIMIT $3 OFFSET $4
+`;
+exports.COUNT_TOPICS = `
+  SELECT COUNT(*)::int AS total FROM lt_topic_catalog
+  WHERE ($1::text IS NULL OR category = $1)
+    AND ($2::text IS NULL OR topic ILIKE '%' || $2 || '%' OR description ILIKE '%' || $2 || '%')
+`;
+exports.GET_TOPIC = `
+  SELECT * FROM lt_topic_catalog WHERE topic = $1
+`;
+exports.INSERT_TOPIC = `
+  INSERT INTO lt_topic_catalog
+    (topic, description, category, payload_schema, example_payload, source, tags)
+  VALUES ($1, $2, $3, $4, $5, $6, $7)
+  RETURNING *
+`;
+exports.UPDATE_TOPIC = `
+  UPDATE lt_topic_catalog SET
+    description = COALESCE($2, description),
+    category = COALESCE($3, category),
+    payload_schema = COALESCE($4, payload_schema),
+    example_payload = COALESCE($5, example_payload),
+    tags = COALESCE($6, tags)
+  WHERE topic = $1
+  RETURNING *
+`;
+exports.DELETE_TOPIC = `
+  DELETE FROM lt_topic_catalog WHERE topic = $1 AND source != 'system'
+`;
+exports.UPSERT_ON_PUBLISH = `
+  INSERT INTO lt_topic_catalog
+    (topic, category, source, example_payload, last_seen_at)
+  VALUES ($1, $2, $3, $4, NOW())
+  ON CONFLICT (topic) DO UPDATE SET
+    last_seen_at = NOW(),
+    example_payload = COALESCE(EXCLUDED.example_payload, lt_topic_catalog.example_payload)
+`;
+exports.SEED_TOPIC = `
+  INSERT INTO lt_topic_catalog
+    (topic, description, category, payload_schema, example_payload, source, tags)
+  VALUES ($1, $2, $3, $4, $5, $6, $7)
+  ON CONFLICT (topic) DO NOTHING
+`;
+exports.RESET_TOPIC = `
+  INSERT INTO lt_topic_catalog
+    (topic, description, category, payload_schema, example_payload, source, tags, managed)
+  VALUES ($1, $2, $3, $4, $5, $6, $7, true)
+  ON CONFLICT (topic) DO UPDATE SET
+    description = EXCLUDED.description,
+    category = EXCLUDED.category,
+    payload_schema = EXCLUDED.payload_schema,
+    example_payload = EXCLUDED.example_payload,
+    source = EXCLUDED.source,
+    tags = EXCLUDED.tags,
+    managed = true
+`;
+exports.LIST_SUBSCRIBERS = `
+  SELECT s.id, s.agent_id, s.topic, s.reaction_type,
+    a.name AS agent_name
+  FROM lt_agent_subscriptions s
+  JOIN lt_agents a ON s.agent_id = a.id
+  WHERE s.enabled = true AND a.status = 'active'
+  ORDER BY s.created_at
+`;

package/build/services/topics/system-topics.d.ts

@@ -0,0 +1,11 @@
+import type { LTTopicConfig } from '../../types';
+/**
+ * Seed all 22 built-in system topics into the catalog.
+ * Called once at startup after migrations.
+ */
+export declare function seedSystemTopics(): Promise<void>;
+/**
+ * Seed user-declared topics from startConfig.topics[].
+ * Respects `reset: true` — overwrites DB from config on every boot.
+ */
+export declare function seedConfigTopics(topics: LTTopicConfig[]): Promise<void>;