@hotmeshio/long-tail 0.3.2 → 0.4.0

package/build/api/agents.d.ts

@@ -9,7 +9,7 @@ export declare function getAgent(input: {
     id: string;
 }): Promise<LTApiResult>;
 export declare function createAgent(input: {
-    name: string;
+    id: string;
     [key: string]: any;
 }, _auth?: LTApiAuth): Promise<LTApiResult>;
 export declare function updateAgent(input: {

package/build/api/agents.js

@@ -68,7 +68,7 @@ async function createAgent(input, _auth) {
     }
     catch (err) {
         if (err.code === '23505') {
-            return { status: 409, error: `Agent "${input.name}" already exists` };
+            return { status: 409, error: `Agent "${input.id}" already exists` };
         }
         return { status: 500, error: err.message };
     }

package/build/api/controlplane.d.ts

@@ -1,4 +1,5 @@
 import type { LTApiResult } from '../types/sdk';
+import type { StreamMessageStatus } from '../services/controlplane/types';
 /**
  * List all registered application namespaces.
  *
@@ -66,3 +67,35 @@ export declare function getStreamStats(input: {
 export declare function subscribeMesh(input: {
     appId?: string;
 }): Promise<LTApiResult>;
+/**
+ * Browse stream messages across engine and worker streams.
+ *
+ * Returns paginated, filterable, sortable results from the Postgres
+ * engine_streams and worker_streams tables. Messages are schema-isolated
+ * by namespace.
+ *
+ * @param input.namespace — Postgres schema (required, e.g. "durable")
+ * @param input.limit — page size (1–100, default 25)
+ * @param input.offset — pagination offset (default 0)
+ * @param input.sort_by — sort column: created_at, stream_name, priority, id
+ * @param input.order — sort direction: asc | desc (default desc)
+ * @param input.source — filter by source: engine | worker (default all)
+ * @param input.status — filter by status: pending | claimed | processed | dead_lettered
+ * @param input.stream_name — partial match on stream name (ILIKE)
+ * @param input.msg_type — filter by message type (worker streams only)
+ */
+export declare function listStreamMessages(input: {
+    namespace: string;
+    source: string;
+    limit?: number;
+    offset?: number;
+    sort_by?: string;
+    order?: 'asc' | 'desc';
+    status?: StreamMessageStatus | null;
+    stream_name?: string | null;
+    msg_type?: string | null;
+    topic?: string | null;
+    workflow_name?: string | null;
+    jid?: string | null;
+    aid?: string | null;
+}): Promise<LTApiResult>;

package/build/api/controlplane.js

@@ -38,6 +38,7 @@ exports.rollCall = rollCall;
 exports.applyThrottle = applyThrottle;
 exports.getStreamStats = getStreamStats;
 exports.subscribeMesh = subscribeMesh;
+exports.listStreamMessages = listStreamMessages;
 const controlplane = __importStar(require("../services/controlplane"));
 const events_1 = require("../lib/events");
 /**
@@ -156,3 +157,48 @@ async function subscribeMesh(input) {
         return { status: 500, error: err.message };
     }
 }
+/**
+ * Browse stream messages across engine and worker streams.
+ *
+ * Returns paginated, filterable, sortable results from the Postgres
+ * engine_streams and worker_streams tables. Messages are schema-isolated
+ * by namespace.
+ *
+ * @param input.namespace — Postgres schema (required, e.g. "durable")
+ * @param input.limit — page size (1–100, default 25)
+ * @param input.offset — pagination offset (default 0)
+ * @param input.sort_by — sort column: created_at, stream_name, priority, id
+ * @param input.order — sort direction: asc | desc (default desc)
+ * @param input.source — filter by source: engine | worker (default all)
+ * @param input.status — filter by status: pending | claimed | processed | dead_lettered
+ * @param input.stream_name — partial match on stream name (ILIKE)
+ * @param input.msg_type — filter by message type (worker streams only)
+ */
+async function listStreamMessages(input) {
+    try {
+        if (!input.namespace) {
+            return { status: 400, error: 'namespace is required' };
+        }
+        if (input.source !== 'engine' && input.source !== 'worker') {
+            return { status: 400, error: 'source is required (engine or worker)' };
+        }
+        const result = await controlplane.getStreamMessages(input.namespace, {
+            source: input.source,
+            limit: input.limit,
+            offset: input.offset,
+            sort_by: input.sort_by,
+            order: input.order,
+            status: input.status,
+            stream_name: input.stream_name,
+            msg_type: input.msg_type,
+            topic: input.topic,
+            workflow_name: input.workflow_name,
+            jid: input.jid,
+            aid: input.aid,
+        });
+        return { status: 200, data: result };
+    }
+    catch (err) {
+        return { status: 500, error: err.message };
+    }
+}

package/build/bin/ltc.js

@@ -54,6 +54,7 @@ const pip = __importStar(require("../lib/cli/commands/pipelines"));
 const kb = __importStar(require("../lib/cli/commands/knowledge"));
 const mcp = __importStar(require("../lib/cli/commands/mcp"));
 const usr = __importStar(require("../lib/cli/commands/users"));
+const streams = __importStar(require("../lib/cli/commands/streams"));
 const pkg = require('../package.json');
 const envPath = path.resolve(process.cwd(), '.env');
 const envLoaded = fs.existsSync(envPath);
@@ -216,5 +217,20 @@ usrCmd.command('list')
 usrCmd.command('get <id>')
     .option('--json', 'JSON output')
     .action(wrap(usr.getUser));
+// ── Streams ─────────────────────────────────────────────────────────────
+const streamsCmd = commander_1.program.command('streams').description('Browse stream messages (admin)');
+streamsCmd.command('list')
+    .requiredOption('-n, --namespace <ns>', 'Schema namespace (e.g. durable)')
+    .requiredOption('-s, --source <source>', 'Stream type (engine or worker)')
+    .option('--status <status>', 'Filter by status (pending, claimed, processed, dead_lettered)')
+    .option('--stream <name>', 'Filter by stream name (partial match)')
+    .option('--type <type>', 'Filter by message type (worker only)')
+    .option('--limit <n>', 'Max results (default 25)')
+    .option('--offset <n>', 'Pagination offset')
+    .option('--sort <col>', 'Sort column (created_at, stream_name, priority, id)')
+    .option('--order <dir>', 'Sort direction (asc, desc)')
+    .option('--json', 'JSON output')
+    .option('-q, --quiet', 'IDs only')
+    .action(wrap(streams.listMessages));
 // ── Parse ────────────────────────────────────────────────────────────────
 commander_1.program.parse();

package/build/lib/cli/commands/streams.d.ts

@@ -0,0 +1,20 @@
+interface ListOptions {
+    namespace: string;
+    source: string;
+    status?: string;
+    stream?: string;
+    type?: string;
+    limit?: string;
+    offset?: string;
+    sort?: string;
+    order?: string;
+    json?: boolean;
+    quiet?: boolean;
+}
+export declare function listMessages(opts: ListOptions): Promise<void>;
+interface GetOptions {
+    namespace: string;
+    json?: boolean;
+}
+export declare function getMessage(id: string, opts: GetOptions): Promise<void>;
+export {};

package/build/lib/cli/commands/streams.js

@@ -0,0 +1,134 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.listMessages = listMessages;
+exports.getMessage = getMessage;
+const picocolors_1 = __importDefault(require("picocolors"));
+const client_1 = require("../client");
+const format_1 = require("../format");
+function formatStreamStatus(status) {
+    switch (status) {
+        case 'pending': return picocolors_1.default.dim(status);
+        case 'claimed': return picocolors_1.default.yellow(status);
+        case 'processed': return picocolors_1.default.green(status);
+        case 'dead_lettered': return picocolors_1.default.red('dead-letter');
+        default: return status;
+    }
+}
+const COLUMNS = [
+    { key: 'id', label: 'ID', width: 8, align: 'right' },
+    { key: 'source', label: 'Source', width: 8 },
+    { key: 'status', label: 'Status', width: 12, format: formatStreamStatus },
+    { key: 'stream_name', label: 'Stream', width: 30, format: (v) => v?.length > 30 ? v.slice(0, 29) + '…' : v },
+    { key: 'msg_type', label: 'Type', width: 10, format: (v) => v || '—' },
+    { key: 'priority', label: 'Pri', width: 4, align: 'right' },
+    { key: 'retry_attempt', label: 'Retry', width: 6, format: (v, row) => row ? `${v}/${row.max_retry_attempts}` : String(v) },
+    { key: 'created_at', label: 'Created', width: 12, format: format_1.formatTime },
+];
+async function listMessages(opts) {
+    if (!opts.namespace) {
+        console.error(`\n  ${picocolors_1.default.red('✗')} --namespace is required\n`);
+        process.exit(1);
+    }
+    if (opts.source !== 'engine' && opts.source !== 'worker') {
+        console.error(`\n  ${picocolors_1.default.red('✗')} --source is required (engine or worker)\n`);
+        process.exit(1);
+    }
+    const params = new URLSearchParams();
+    params.set('namespace', opts.namespace);
+    params.set('source', opts.source);
+    if (opts.status)
+        params.set('status', opts.status);
+    if (opts.stream)
+        params.set('stream_name', opts.stream);
+    if (opts.type)
+        params.set('msg_type', opts.type);
+    if (opts.limit)
+        params.set('limit', opts.limit);
+    if (opts.offset)
+        params.set('offset', opts.offset);
+    if (opts.sort)
+        params.set('sort_by', opts.sort);
+    if (opts.order)
+        params.set('order', opts.order);
+    const data = await (0, client_1.apiFetch)(`/controlplane/stream-messages?${params}`);
+    if (opts.json) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    if (opts.quiet) {
+        for (const msg of data.messages || []) {
+            console.log(`${msg.source}:${msg.id}`);
+        }
+        return;
+    }
+    const messages = data.messages || [];
+    const total = data.total ?? messages.length;
+    // Build retry column with access to the full row
+    const columns = COLUMNS.map((col) => {
+        if (col.key === 'retry_attempt') {
+            return {
+                ...col,
+                format: (v) => v, // raw value — formatted in printTable
+            };
+        }
+        return col;
+    });
+    (0, format_1.output)(data, messages, columns, opts);
+    if (!opts.json && !opts.quiet && total > messages.length) {
+        const showing = messages.length;
+        console.log(`  ${picocolors_1.default.dim(`Showing ${showing} of ${total} messages`)}\n`);
+    }
+}
+async function getMessage(id, opts) {
+    if (!opts.namespace) {
+        console.error(`\n  ${picocolors_1.default.red('✗')} --namespace is required\n`);
+        process.exit(1);
+    }
+    // Fetch the message by ID — use list with a narrow filter
+    const params = new URLSearchParams();
+    params.set('namespace', opts.namespace);
+    params.set('limit', '1');
+    const data = await (0, client_1.apiFetch)(`/controlplane/stream-messages?${params}`);
+    const messages = data.messages || [];
+    // Find by ID in the results (ID search not directly supported, show the detail)
+    if (opts.json) {
+        console.log(JSON.stringify(data, null, 2));
+        return;
+    }
+    if (messages.length === 0) {
+        console.log(`\n  ${picocolors_1.default.dim('No messages found.')}\n`);
+        return;
+    }
+    const msg = messages[0];
+    console.log(`\n  ${picocolors_1.default.bold('Stream Message')} ${picocolors_1.default.dim(`${msg.source}:${msg.id}`)}`);
+    console.log(`  Status: ${formatStreamStatus(msg.status)}  Source: ${msg.source}  Priority: ${msg.priority}`);
+    console.log(`  Stream: ${msg.stream_name}`);
+    if (msg.msg_type)
+        console.log(`  Type: ${msg.msg_type}`);
+    if (msg.workflow_name)
+        console.log(`  Workflow: ${msg.workflow_name}`);
+    if (msg.jid)
+        console.log(`  Job ID: ${msg.jid}`);
+    if (msg.aid)
+        console.log(`  Activity: ${msg.aid}`);
+    console.log(`  Created: ${(0, format_1.formatTime)(msg.created_at)}`);
+    if (msg.reserved_at)
+        console.log(`  Reserved: ${(0, format_1.formatTime)(msg.reserved_at)} by ${msg.reserved_by || '—'}`);
+    if (msg.expired_at)
+        console.log(`  Expired: ${(0, format_1.formatTime)(msg.expired_at)}`);
+    if (msg.dead_lettered_at)
+        console.log(`  Dead-lettered: ${(0, format_1.formatTime)(msg.dead_lettered_at)}`);
+    console.log(`  Retries: ${msg.retry_attempt}/${msg.max_retry_attempts}`);
+    try {
+        const parsed = JSON.parse(msg.message);
+        console.log(`\n  ${picocolors_1.default.bold('Payload:')}`);
+        console.log(JSON.stringify(parsed, null, 2).split('\n').map((l) => `  ${l}`).join('\n'));
+    }
+    catch {
+        console.log(`\n  ${picocolors_1.default.bold('Payload:')} ${msg.message}`);
+    }
+    console.log();
+}

package/build/lib/db/schemas/003_agents.sql

@@ -3,8 +3,7 @@
 -- behaviors, and goals atop existing primitives.
 
 CREATE TABLE IF NOT EXISTS lt_agents (
-  id                UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-  name              TEXT UNIQUE NOT NULL,
+  id                TEXT PRIMARY KEY,
   description       TEXT,
   status            TEXT NOT NULL DEFAULT 'inactive'
                       CHECK (status IN ('inactive', 'active', 'paused', 'error')),

package/build/lib/db/schemas/004_agent_subscriptions.sql

@@ -3,7 +3,7 @@
 
 CREATE TABLE IF NOT EXISTS lt_agent_subscriptions (
   id              UUID PRIMARY KEY DEFAULT gen_random_uuid(),
-  agent_id        UUID NOT NULL REFERENCES lt_agents(id) ON DELETE CASCADE,
+  agent_id        TEXT NOT NULL REFERENCES lt_agents(id) ON DELETE CASCADE,
 
   -- What to listen for
   topic           TEXT NOT NULL,

package/build/routes/agents.js

@@ -64,9 +64,9 @@ router.get('/:id', async (req, res) => {
  * Create a new agent.
  */
 router.post('/', async (req, res) => {
-    const { name } = req.body;
-    if (!name) {
-        res.status(400).json({ error: 'name is required' });
+    const { id } = req.body;
+    if (!id) {
+        res.status(400).json({ error: 'id is required (kebab-case agent name, e.g. "content-triage")' });
         return;
     }
     const auth = { userId: req.userId, roles: req.roles };

package/build/routes/controlplane.js

@@ -87,6 +87,34 @@ router.get('/streams', auth_1.requireAdmin, async (req, res) => {
     });
     res.status(result.status).json(result.data ?? { error: result.error });
 });
+/**
+ * GET /api/controlplane/stream-messages?namespace=durable&source=worker
+ *     &limit=25&offset=0&sort_by=created_at&order=desc
+ *     &status=pending&stream_name=hmsh:durable:w:&msg_type=WORKER
+ *
+ * Browse stream messages with pagination, filtering, and sorting.
+ * Both namespace and source are required — engine and worker streams
+ * are separate tables with different schemas.
+ * Admin-only.
+ */
+router.get('/stream-messages', auth_1.requireAdmin, async (req, res) => {
+    const result = await api.listStreamMessages({
+        namespace: req.query.namespace,
+        source: req.query.source,
+        limit: req.query.limit ? parseInt(req.query.limit, 10) : undefined,
+        offset: req.query.offset ? parseInt(req.query.offset, 10) : undefined,
+        sort_by: req.query.sort_by || undefined,
+        order: req.query.order || undefined,
+        status: req.query.status || undefined,
+        stream_name: req.query.stream_name || undefined,
+        msg_type: req.query.msg_type || undefined,
+        topic: req.query.topic || undefined,
+        workflow_name: req.query.workflow_name || undefined,
+        jid: req.query.jid || undefined,
+        aid: req.query.aid || undefined,
+    });
+    res.status(result.status).json(result.data ?? { error: result.error });
+});
 /**
  * POST /api/controlplane/subscribe
  * Start the quorum→NATS bridge for an appId.

package/build/sdk/index.d.ts

@@ -287,6 +287,7 @@ export declare function createClient(options?: LTClientOptions): {
         rollCall: typeof controlplaneApi.rollCall;
         throttle: typeof controlplaneApi.applyThrottle;
         getStreamStats: typeof controlplaneApi.getStreamStats;
+        listStreamMessages: typeof controlplaneApi.listStreamMessages;
         subscribe: typeof controlplaneApi.subscribeMesh;
     };
     botAccounts: {

package/build/sdk/index.js

@@ -239,6 +239,7 @@ function createClient(options = {}) {
             rollCall: controlplaneApi.rollCall,
             throttle: controlplaneApi.applyThrottle,
             getStreamStats: controlplaneApi.getStreamStats,
+            listStreamMessages: controlplaneApi.listStreamMessages,
             subscribe: controlplaneApi.subscribeMesh,
         },
         // ── Bot Accounts ───────────────────────────────────────────────────────

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

@@ -10,9 +10,8 @@ export declare function listAgents(filters?: ListAgentsFilters): Promise<{
     total: number;
 }>;
 export declare function getAgent(id: string): Promise<LTAgent | null>;
-export declare function getAgentByName(name: string): Promise<LTAgent | null>;
 export declare function createAgent(data: Partial<LTAgent> & {
-    name: string;
+    id: string;
 }): Promise<LTAgent>;
 export declare function updateAgent(id: string, data: Partial<LTAgent>): Promise<LTAgent | null>;
 export declare function deleteAgent(id: string): Promise<boolean>;
@@ -22,7 +21,7 @@ export declare function deleteAgent(id: string): Promise<boolean>;
  * but do not overwrite.
  */
 export declare function seedAgent(data: Partial<LTAgent> & {
-    name: string;
+    id: string;
 }): Promise<boolean>;
 /**
  * Aggregate stats for an agent: knowledge entry count, pending escalation count,

package/build/services/agent/index.js

@@ -35,7 +35,6 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.listAgents = listAgents;
 exports.getAgent = getAgent;
-exports.getAgentByName = getAgentByName;
 exports.createAgent = createAgent;
 exports.updateAgent = updateAgent;
 exports.deleteAgent = deleteAgent;
@@ -65,15 +64,10 @@ async function getAgent(id) {
     const { rows } = await pool.query(sql_1.GET_AGENT, [id]);
     return rows[0] ?? null;
 }
-async function getAgentByName(name) {
-    const pool = (0, db_1.getPool)();
-    const { rows } = await pool.query(sql_1.GET_AGENT_BY_NAME, [name]);
-    return rows[0] ?? null;
-}
 async function createAgent(data) {
     const pool = (0, db_1.getPool)();
     const { rows } = await pool.query(sql_1.INSERT_AGENT, [
-        data.name,
+        data.id,
         data.description ?? null,
         data.status ?? 'inactive',
         data.user_id ?? null,
@@ -94,7 +88,6 @@ async function updateAgent(id, data) {
     const oldAgent = data.status ? await getAgent(id) : null;
     const { rows } = await pool.query(sql_1.UPDATE_AGENT, [
         id,
-        data.name ?? null,
         data.description ?? null,
         data.status ?? null,
         data.user_id ?? null,
@@ -113,7 +106,7 @@ async function updateAgent(id, data) {
         (0, publish_1.publishAgentEvent)({
             type: 'agent.status_changed',
             agentId: updated.id,
-            agentName: updated.name,
+            agentName: updated.id,
             status: updated.status,
             data: { previous: oldAgent.status },
         });
@@ -141,7 +134,7 @@ async function deleteAgent(id) {
 async function seedAgent(data) {
     const pool = (0, db_1.getPool)();
     const { rowCount } = await pool.query(sql_1.SEED_AGENT, [
-        data.name,
+        data.id,
         data.description ?? null,
         data.status ?? 'inactive',
         data.user_id ?? null,
@@ -156,7 +149,7 @@ async function seedAgent(data) {
     ]);
     const inserted = (rowCount ?? 0) > 0;
     if (!inserted) {
-        const existing = await getAgentByName(data.name);
+        const existing = await getAgent(data.id);
         if (existing) {
             const drifts = [];
             if (data.description && existing.description !== data.description)
@@ -166,7 +159,7 @@ async function seedAgent(data) {
             if (data.knowledge_domain && existing.knowledge_domain !== data.knowledge_domain)
                 drifts.push('knowledge_domain');
             if (drifts.length) {
-                logger_1.loggerRegistry.warn(`[long-tail] agent drift: ${data.name} — ${drifts.join(', ')} differ between code and DB`);
+                logger_1.loggerRegistry.warn(`[long-tail] agent drift: ${data.id} — ${drifts.join(', ')} differ between code and DB`);
             }
         }
     }

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

@@ -1,10 +1,9 @@
 export declare const LIST_AGENTS = "\n  SELECT a.*,\n    COALESCE(s.sub_count, 0)::int AS subscription_count,\n    s.sub_topics\n  FROM lt_agents a\n  LEFT JOIN LATERAL (\n    SELECT COUNT(*)::int AS sub_count,\n           array_agg(topic ORDER BY created_at) AS sub_topics\n    FROM lt_agent_subscriptions\n    WHERE agent_id = a.id AND enabled = true\n  ) s ON true\n  WHERE ($1::text IS NULL OR a.status = $1)\n    AND ($2::text IS NULL OR a.knowledge_domain = $2)\n  ORDER BY a.updated_at DESC\n  LIMIT $3 OFFSET $4\n";
 export declare const COUNT_AGENTS = "\n  SELECT COUNT(*)::int AS total FROM lt_agents\n  WHERE ($1::text IS NULL OR status = $1)\n    AND ($2::text IS NULL OR knowledge_domain = $2)\n";
 export declare const GET_AGENT = "\n  SELECT * FROM lt_agents WHERE id = $1\n";
-export declare const GET_AGENT_BY_NAME = "\n  SELECT * FROM lt_agents WHERE name = $1\n";
-export declare const INSERT_AGENT = "\n  INSERT INTO lt_agents (name, description, status, user_id, knowledge_domain,\n    capabilities, behaviors, goals, rules, workflow_type, pipeline_id, metadata)\n  VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12)\n  RETURNING *\n";
-export declare const UPDATE_AGENT = "\n  UPDATE lt_agents SET\n    name = COALESCE($2, name),\n    description = COALESCE($3, description),\n    status = COALESCE($4, status),\n    user_id = COALESCE($5, user_id),\n    knowledge_domain = COALESCE($6, knowledge_domain),\n    capabilities = COALESCE($7, capabilities),\n    behaviors = COALESCE($8, behaviors),\n    goals = COALESCE($9, goals),\n    rules = COALESCE($10, rules),\n    workflow_type = COALESCE($11, workflow_type),\n    pipeline_id = COALESCE($12, pipeline_id),\n    metadata = COALESCE($13, metadata),\n    last_run_at = COALESCE($14, last_run_at)\n  WHERE id = $1\n  RETURNING *\n";
+export declare const INSERT_AGENT = "\n  INSERT INTO lt_agents (id, description, status, user_id, knowledge_domain,\n    capabilities, behaviors, goals, rules, workflow_type, pipeline_id, metadata)\n  VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12)\n  RETURNING *\n";
+export declare const UPDATE_AGENT = "\n  UPDATE lt_agents SET\n    description = COALESCE($2, description),\n    status = COALESCE($3, status),\n    user_id = COALESCE($4, user_id),\n    knowledge_domain = COALESCE($5, knowledge_domain),\n    capabilities = COALESCE($6, capabilities),\n    behaviors = COALESCE($7, behaviors),\n    goals = COALESCE($8, goals),\n    rules = COALESCE($9, rules),\n    workflow_type = COALESCE($10, workflow_type),\n    pipeline_id = COALESCE($11, pipeline_id),\n    metadata = COALESCE($12, metadata),\n    last_run_at = COALESCE($13, last_run_at)\n  WHERE id = $1\n  RETURNING *\n";
 export declare const DELETE_AGENT = "\n  DELETE FROM lt_agents WHERE id = $1\n";
-export declare const SEED_AGENT = "\n  INSERT INTO lt_agents (name, description, status, user_id, knowledge_domain,\n    capabilities, behaviors, goals, rules, workflow_type, pipeline_id, metadata)\n  VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12)\n  ON CONFLICT (name) DO NOTHING\n";
+export declare const SEED_AGENT = "\n  INSERT INTO lt_agents (id, description, status, user_id, knowledge_domain,\n    capabilities, behaviors, goals, rules, workflow_type, pipeline_id, metadata)\n  VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12)\n  ON CONFLICT (id) DO NOTHING\n";
 export declare const KNOWLEDGE_COUNT = "\n  SELECT COUNT(*)::int AS count FROM lt_knowledge WHERE domain = $1\n";
 export declare const ESCALATION_COUNT = "\n  SELECT COUNT(*)::int AS count FROM lt_escalations\n  WHERE status = 'pending' AND created_by = $1\n";

package/build/services/agent/sql.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ESCALATION_COUNT = exports.KNOWLEDGE_COUNT = exports.SEED_AGENT = exports.DELETE_AGENT = exports.UPDATE_AGENT = exports.INSERT_AGENT = exports.GET_AGENT_BY_NAME = exports.GET_AGENT = exports.COUNT_AGENTS = exports.LIST_AGENTS = void 0;
+exports.ESCALATION_COUNT = exports.KNOWLEDGE_COUNT = exports.SEED_AGENT = exports.DELETE_AGENT = exports.UPDATE_AGENT = exports.INSERT_AGENT = exports.GET_AGENT = exports.COUNT_AGENTS = exports.LIST_AGENTS = void 0;
 exports.LIST_AGENTS = `
   SELECT a.*,
     COALESCE(s.sub_count, 0)::int AS subscription_count,
@@ -25,30 +25,26 @@ exports.COUNT_AGENTS = `
 exports.GET_AGENT = `
   SELECT * FROM lt_agents WHERE id = $1
 `;
-exports.GET_AGENT_BY_NAME = `
-  SELECT * FROM lt_agents WHERE name = $1
-`;
 exports.INSERT_AGENT = `
-  INSERT INTO lt_agents (name, description, status, user_id, knowledge_domain,
+  INSERT INTO lt_agents (id, description, status, user_id, knowledge_domain,
     capabilities, behaviors, goals, rules, workflow_type, pipeline_id, metadata)
   VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12)
   RETURNING *
 `;
 exports.UPDATE_AGENT = `
   UPDATE lt_agents SET
-    name = COALESCE($2, name),
-    description = COALESCE($3, description),
-    status = COALESCE($4, status),
-    user_id = COALESCE($5, user_id),
-    knowledge_domain = COALESCE($6, knowledge_domain),
-    capabilities = COALESCE($7, capabilities),
-    behaviors = COALESCE($8, behaviors),
-    goals = COALESCE($9, goals),
-    rules = COALESCE($10, rules),
-    workflow_type = COALESCE($11, workflow_type),
-    pipeline_id = COALESCE($12, pipeline_id),
-    metadata = COALESCE($13, metadata),
-    last_run_at = COALESCE($14, last_run_at)
+    description = COALESCE($2, description),
+    status = COALESCE($3, status),
+    user_id = COALESCE($4, user_id),
+    knowledge_domain = COALESCE($5, knowledge_domain),
+    capabilities = COALESCE($6, capabilities),
+    behaviors = COALESCE($7, behaviors),
+    goals = COALESCE($8, goals),
+    rules = COALESCE($9, rules),
+    workflow_type = COALESCE($10, workflow_type),
+    pipeline_id = COALESCE($11, pipeline_id),
+    metadata = COALESCE($12, metadata),
+    last_run_at = COALESCE($13, last_run_at)
   WHERE id = $1
   RETURNING *
 `;
@@ -56,10 +52,10 @@ exports.DELETE_AGENT = `
   DELETE FROM lt_agents WHERE id = $1
 `;
 exports.SEED_AGENT = `
-  INSERT INTO lt_agents (name, description, status, user_id, knowledge_domain,
+  INSERT INTO lt_agents (id, description, status, user_id, knowledge_domain,
     capabilities, behaviors, goals, rules, workflow_type, pipeline_id, metadata)
   VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12)
-  ON CONFLICT (name) DO NOTHING
+  ON CONFLICT (id) DO NOTHING
 `;
 exports.KNOWLEDGE_COUNT = `
   SELECT COUNT(*)::int AS count FROM lt_knowledge WHERE domain = $1

package/build/services/agent/subscription-sql.d.ts

@@ -4,4 +4,4 @@ export declare const INSERT_SUBSCRIPTION = "\n  INSERT INTO lt_agent_subscriptio
 export declare const UPDATE_SUBSCRIPTION = "\n  UPDATE lt_agent_subscriptions SET\n    topic = COALESCE($2, topic),\n    filter = COALESCE($3, filter),\n    reaction_type = COALESCE($4, reaction_type),\n    workflow_type = COALESCE($5, workflow_type),\n    pipeline_id = COALESCE($6, pipeline_id),\n    mcp_prompt = COALESCE($7, mcp_prompt),\n    input_mapping = COALESCE($8, input_mapping),\n    execute_as = COALESCE($9, execute_as),\n    enabled = COALESCE($10, enabled)\n  WHERE id = $1\n  RETURNING *\n";
 export declare const DELETE_SUBSCRIPTION = "\n  DELETE FROM lt_agent_subscriptions WHERE id = $1\n";
 export declare const SEED_SUBSCRIPTION = "\n  INSERT INTO lt_agent_subscriptions\n    (agent_id, topic, filter, reaction_type, workflow_type, pipeline_id, mcp_prompt,\n     input_mapping, execute_as, enabled)\n  VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, true)\n  ON CONFLICT (agent_id, topic) DO NOTHING\n";
-export declare const LIST_ACTIVE_SUBSCRIPTIONS = "\n  SELECT s.*, a.name AS agent_name, a.user_id AS agent_user_id\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";
+export declare const LIST_ACTIVE_SUBSCRIPTIONS = "\n  SELECT s.*, a.id AS agent_name, a.user_id AS agent_user_id\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/agent/subscription-sql.js

@@ -41,7 +41,7 @@ exports.SEED_SUBSCRIPTION = `
   ON CONFLICT (agent_id, topic) DO NOTHING
 `;
 exports.LIST_ACTIVE_SUBSCRIPTIONS = `
-  SELECT s.*, a.name AS agent_name, a.user_id AS agent_user_id
+  SELECT s.*, a.id AS agent_name, a.user_id AS agent_user_id
   FROM lt_agent_subscriptions s
   JOIN lt_agents a ON s.agent_id = a.id
   WHERE s.enabled = true AND a.status = 'active'

package/build/services/agent/trigger-registry.js

@@ -188,7 +188,7 @@ class AgentTriggerRegistry {
             .update(`${event.timestamp}:${event.type}:${JSON.stringify(event.data ?? {})}`)
             .digest('hex')
             .slice(0, 12);
-        return `agent-${sub.agent_id.slice(0, 8)}-${sub.id.slice(0, 8)}-${uniquePart}`;
+        return `agent-${sub.agent_id}-${sub.id.slice(0, 8)}-${uniquePart}`;
     }
     async executeReaction(sub, mapped, deterministicId) {
         switch (sub.reaction_type) {

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

@@ -1,6 +1,6 @@
 import { HotMesh } from '@hotmeshio/hotmesh';
 import type { QuorumProfile, ThrottleOptions } from '@hotmeshio/hotmesh/build/types/quorum';
-import type { ControlPlaneApp, StreamStats } from './types';
+import type { ControlPlaneApp, StreamStats, StreamMessagesParams, StreamMessagesResult } from './types';
 export type { QuorumProfile, ThrottleOptions };
 /**
  * Get or create a read-only HotMesh engine for control plane operations.
@@ -34,6 +34,14 @@ export declare function applyThrottle(appId: string, options: ThrottleOptions):
  * @param streamName — optional: filter to a specific stream (task queue topic)
  */
 export declare function getStreamStats(schema: string, duration?: string, streamName?: string | null): Promise<StreamStats>;
+/**
+ * Browse stream messages across engine_streams and worker_streams tables
+ * with pagination, filtering, and sorting.
+ *
+ * @param schema — the Postgres schema (namespace, e.g. "durable")
+ * @param params — pagination, filter, and sort options
+ */
+export declare function getStreamMessages(schema: string, params: StreamMessagesParams): Promise<StreamMessagesResult>;
 /**
  * Start the quorum→NATS bridge for an appId.
  * Subscribes to the HotMesh quorum channel and republishes