@hotmeshio/long-tail 0.4.3 → 0.4.5

package/build/api/agent-subscriptions.js

@@ -38,6 +38,15 @@ exports.createSubscription = createSubscription;
 exports.updateSubscription = updateSubscription;
 exports.deleteSubscription = deleteSubscription;
 const subService = __importStar(require("../services/agent/subscriptions"));
+const publish_1 = require("../lib/events/publish");
+function notifyTriggersChanged(agentId) {
+    (0, publish_1.publishAgentEvent)({
+        type: 'agent.triggers_changed',
+        agentId,
+        agentName: agentId,
+        data: { action: 'subscription_changed' },
+    });
+}
 async function listSubscriptions(input) {
     try {
         const subs = await subService.listSubscriptions(input.agentId);
@@ -51,6 +60,7 @@ async function createSubscription(input) {
     try {
         const { agentId, ...data } = input;
         const sub = await subService.createSubscription(agentId, data);
+        notifyTriggersChanged(agentId);
         return { status: 201, data: sub };
     }
     catch (err) {
@@ -63,6 +73,7 @@ async function updateSubscription(input) {
         const sub = await subService.updateSubscription(id, data);
         if (!sub)
             return { status: 404, error: 'Subscription not found' };
+        notifyTriggersChanged(sub.agent_id);
         return { status: 200, data: sub };
     }
     catch (err) {
@@ -71,9 +82,12 @@ async function updateSubscription(input) {
 }
 async function deleteSubscription(input) {
     try {
+        const sub = await subService.getSubscription(input.id);
         const deleted = await subService.deleteSubscription(input.id);
         if (!deleted)
             return { status: 404, error: 'Subscription not found' };
+        if (sub)
+            notifyTriggersChanged(sub.agent_id);
         return { status: 200, data: { deleted: true } };
     }
     catch (err) {

package/build/api/settings.js

@@ -6,6 +6,7 @@ const events_1 = require("../lib/events");
 const nats_1 = require("../lib/events/nats");
 const socketio_1 = require("../lib/events/socketio");
 const defaults_1 = require("../modules/defaults");
+const llm_1 = require("../services/llm");
 /**
  * Return platform settings for the current deployment.
  *
@@ -39,6 +40,9 @@ async function getSettings() {
                         ? (process.env.VITE_NATS_WS_URL || process.env.NATS_WS_URL || null)
                         : null,
                 },
+                ai: {
+                    enabled: (0, llm_1.hasLLMApiKey)(),
+                },
             },
         };
     }

package/build/lib/db/index.d.ts

@@ -8,11 +8,5 @@ export declare function closePool(): Promise<void>;
  */
 export declare function getConnection(): {
     class: typeof Client;
-    options: {
-        host: string;
-        port: number;
-        user: string;
-        password: string;
-        database: string;
-    };
+    options: Record<string, unknown>;
 };

package/build/lib/db/schemas/008_capability_reaction.sql

@@ -0,0 +1,12 @@
+-- Add 'capability' reaction type and server_id/tool_name columns
+-- for late-binding MCP tool invocation via agent subscriptions.
+
+ALTER TABLE lt_agent_subscriptions
+  DROP CONSTRAINT IF EXISTS lt_agent_subscriptions_reaction_type_check;
+
+ALTER TABLE lt_agent_subscriptions
+  ADD CONSTRAINT lt_agent_subscriptions_reaction_type_check
+  CHECK (reaction_type IN ('durable', 'pipeline', 'mcp_query', 'capability'));
+
+ALTER TABLE lt_agent_subscriptions ADD COLUMN IF NOT EXISTS server_id TEXT;
+ALTER TABLE lt_agent_subscriptions ADD COLUMN IF NOT EXISTS tool_name TEXT;

package/build/lib/db/schemas/009_file_topic_category.sql

@@ -0,0 +1,10 @@
+-- Add 'file' to the topic catalog category check constraint.
+
+ALTER TABLE lt_topic_catalog
+  DROP CONSTRAINT IF EXISTS lt_topic_catalog_category_check;
+
+ALTER TABLE lt_topic_catalog
+  ADD CONSTRAINT lt_topic_catalog_category_check
+  CHECK (category IN (
+    'task','workflow','escalation','activity','knowledge','file','agent','app','milestone'
+  ));

package/build/lib/events/index.d.ts

@@ -31,6 +31,15 @@ declare class LTEventRegistry {
      * Return the first registered adapter that matches the given type.
      */
     getAdapter<T extends LTEventAdapter>(ctor: new (...args: any[]) => T): T | undefined;
+    /**
+     * Bridge cross-container events to the in-process callback adapter.
+     *
+     * Iterates all registered adapters and calls `setCallbackBridge()` on
+     * any that implement it. This is the generic contract — any transport
+     * adapter (NATS, SNS, GCP Pub/Sub, Kafka) that supports cross-process
+     * delivery implements `setCallbackBridge` on the LTEventAdapter interface.
+     */
+    bridgeCallbackAdapter(callbackAdapter: LTEventAdapter): void;
 }
 /** Singleton event registry */
 export declare const eventRegistry: LTEventRegistry;

package/build/lib/events/index.js

@@ -59,6 +59,24 @@ class LTEventRegistry {
     getAdapter(ctor) {
         return this.adapters.find((a) => a instanceof ctor);
     }
+    /**
+     * Bridge cross-container events to the in-process callback adapter.
+     *
+     * Iterates all registered adapters and calls `setCallbackBridge()` on
+     * any that implement it. This is the generic contract — any transport
+     * adapter (NATS, SNS, GCP Pub/Sub, Kafka) that supports cross-process
+     * delivery implements `setCallbackBridge` on the LTEventAdapter interface.
+     */
+    bridgeCallbackAdapter(callbackAdapter) {
+        let bridged = 0;
+        for (const adapter of this.adapters) {
+            if (adapter !== callbackAdapter && typeof adapter.setCallbackBridge === 'function') {
+                adapter.setCallbackBridge(callbackAdapter);
+                bridged++;
+            }
+        }
+        logger_1.loggerRegistry.info(`[lt-events] callback bridge wired to ${bridged} transport adapter(s)`);
+    }
 }
 /** Singleton event registry */
 exports.eventRegistry = new LTEventRegistry();

package/build/lib/events/nats.d.ts

@@ -1,10 +1,16 @@
 import type { LTEvent, LTEventAdapter } from '../../types';
 /**
- * NATS event adapter — reference implementation.
+ * NATS event adapter — publish AND subscribe.
  *
  * Publishes LTEvent payloads as JSON to NATS subjects
  * following the pattern: `{subjectPrefix}.{event.type}`
  *
+ * When a CallbackEventAdapter is bridged via `setCallbackBridge()`,
+ * this adapter also subscribes to `{subjectPrefix}.>` and forwards
+ * events from other containers to the local callback adapter.
+ * An `_originId` field prevents the publishing container from
+ * re-dispatching its own events.
+ *
  * Usage:
  * ```typescript
  * import { eventRegistry, NatsEventAdapter } from '@hotmeshio/long-tail';
@@ -15,14 +21,22 @@ import type { LTEvent, LTEventAdapter } from '../../types';
  */
 export declare class NatsEventAdapter implements LTEventAdapter {
     private nc;
+    private sub;
     private url;
     private subjectPrefix;
     private token?;
+    private originId;
+    private callbackAdapter;
     constructor(options?: {
         url?: string;
         subjectPrefix?: string;
         token?: string;
     });
+    /**
+     * Bridge NATS → local callback adapter for cross-container dispatch.
+     * Part of the LTEventAdapter contract. Call before `connect()`.
+     */
+    setCallbackBridge(adapter: LTEventAdapter): void;
     connect(): Promise<void>;
     publish(event: LTEvent): Promise<void>;
     disconnect(): Promise<void>;

package/build/lib/events/nats.js

@@ -1,16 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NatsEventAdapter = void 0;
+const crypto_1 = require("crypto");
 const nats_1 = require("nats");
 const config_1 = require("../../modules/config");
 const logger_1 = require("../logger");
 const sc = (0, nats_1.StringCodec)();
 /**
- * NATS event adapter — reference implementation.
+ * NATS event adapter — publish AND subscribe.
  *
  * Publishes LTEvent payloads as JSON to NATS subjects
  * following the pattern: `{subjectPrefix}.{event.type}`
  *
+ * When a CallbackEventAdapter is bridged via `setCallbackBridge()`,
+ * this adapter also subscribes to `{subjectPrefix}.>` and forwards
+ * events from other containers to the local callback adapter.
+ * An `_originId` field prevents the publishing container from
+ * re-dispatching its own events.
+ *
  * Usage:
  * ```typescript
  * import { eventRegistry, NatsEventAdapter } from '@hotmeshio/long-tail';
@@ -22,24 +29,61 @@ const sc = (0, nats_1.StringCodec)();
 class NatsEventAdapter {
     constructor(options) {
         this.nc = null;
+        this.sub = null;
+        this.originId = (0, crypto_1.randomUUID)();
+        this.callbackAdapter = null;
         this.url = options?.url || config_1.config.NATS_URL;
         this.subjectPrefix = options?.subjectPrefix || 'lt.events';
         this.token = options?.token || process.env.NATS_TOKEN || 'dev_api_secret';
     }
+    /**
+     * Bridge NATS → local callback adapter for cross-container dispatch.
+     * Part of the LTEventAdapter contract. Call before `connect()`.
+     */
+    setCallbackBridge(adapter) {
+        this.callbackAdapter = adapter;
+    }
     async connect() {
         this.nc = await (0, nats_1.connect)({
             servers: this.url,
             token: this.token,
         });
         logger_1.loggerRegistry.info(`[lt-events:nats] connected to ${this.url}`);
+        // Subscribe to all events for cross-container bridging
+        if (this.callbackAdapter) {
+            const adapter = this.callbackAdapter;
+            this.sub = this.nc.subscribe(`${this.subjectPrefix}.>`);
+            logger_1.loggerRegistry.info(`[lt-events:nats] subscribed to ${this.subjectPrefix}.> for cross-container bridge`);
+            (async () => {
+                for await (const msg of this.sub) {
+                    try {
+                        const event = JSON.parse(sc.decode(msg.data));
+                        // Skip events that originated from this container
+                        if (event._originId === this.originId)
+                            continue;
+                        logger_1.loggerRegistry.info(`[lt-events:nats] bridge received: ${event.type} from ${event._originId?.slice(0, 8)}`);
+                        adapter.publish(event);
+                    }
+                    catch {
+                        // Malformed message — skip
+                    }
+                }
+            })();
+        }
     }
     async publish(event) {
         if (!this.nc)
             return;
         const subject = `${this.subjectPrefix}.${event.type}`;
-        this.nc.publish(subject, sc.encode(JSON.stringify(event)));
+        const enriched = { ...event, _originId: this.originId };
+        this.nc.publish(subject, sc.encode(JSON.stringify(enriched)));
+        logger_1.loggerRegistry.info(`[lt-events:nats] published: ${subject} (origin=${this.originId.slice(0, 8)})`);
     }
     async disconnect() {
+        if (this.sub) {
+            this.sub.unsubscribe();
+            this.sub = null;
+        }
         if (this.nc) {
             await this.nc.drain();
             this.nc = null;

package/build/lib/events/publish.d.ts

@@ -66,6 +66,16 @@ export declare function publishKnowledgeEvent(params: {
     domain: string;
     key: string;
 }): Promise<void>;
+/**
+ * Publish a file storage event (stored, deleted).
+ * Includes rich metadata: path, name, extension, mime type, size.
+ */
+export declare function publishFileEvent(params: {
+    type: 'file.stored' | 'file.deleted';
+    path: string;
+    size?: number;
+    mime?: string;
+}): Promise<void>;
 /**
  * Publish an agent lifecycle event.
  */

package/build/lib/events/publish.js

@@ -5,6 +5,7 @@ exports.publishTaskEvent = publishTaskEvent;
 exports.publishEscalationEvent = publishEscalationEvent;
 exports.publishActivityEvent = publishActivityEvent;
 exports.publishKnowledgeEvent = publishKnowledgeEvent;
+exports.publishFileEvent = publishFileEvent;
 exports.publishAgentEvent = publishAgentEvent;
 exports.publishWorkflowEvent = publishWorkflowEvent;
 const index_1 = require("./index");
@@ -105,6 +106,33 @@ function publishKnowledgeEvent(params) {
         timestamp: new Date().toISOString(),
     });
 }
+/**
+ * Publish a file storage event (stored, deleted).
+ * Includes rich metadata: path, name, extension, mime type, size.
+ */
+function publishFileEvent(params) {
+    const parsed = params.path.split('/');
+    const filename = parsed[parsed.length - 1] || '';
+    const dotIdx = filename.lastIndexOf('.');
+    const name = dotIdx > 0 ? filename.slice(0, dotIdx) : filename;
+    const extension = dotIdx > 0 ? filename.slice(dotIdx + 1) : '';
+    return fireAndForget({
+        type: params.type,
+        source: 'file-storage',
+        workflowId: '',
+        workflowName: '',
+        taskQueue: '',
+        data: {
+            path: params.path,
+            name,
+            extension,
+            filename,
+            mime: params.mime,
+            size: params.size,
+        },
+        timestamp: new Date().toISOString(),
+    });
+}
 /**
  * Publish an agent lifecycle event.
  */

package/build/modules/config.d.ts

@@ -10,10 +10,4 @@ export declare const config: {
     JWT_SECRET: string;
     HONEYCOMB_API_KEY: string;
 };
-export declare const postgres_options: {
-    host: string;
-    port: number;
-    user: string;
-    password: string;
-    database: string;
-};
+export declare const postgres_options: Record<string, unknown>;

package/build/services/agent/index.js

@@ -115,6 +115,13 @@ async function updateAgent(id, data) {
     if (updated && (data.status || data.behaviors)) {
         Promise.resolve().then(() => __importStar(require('./trigger-registry'))).then(({ agentTriggerRegistry }) => agentTriggerRegistry.restartAgent(id)).catch(() => { });
         Promise.resolve().then(() => __importStar(require('../cron'))).then(({ cronRegistry }) => cronRegistry.restartAgentCrons(updated)).catch(() => { });
+        // Signal other containers to re-arm triggers for this agent
+        (0, publish_1.publishAgentEvent)({
+            type: 'agent.triggers_changed',
+            agentId: id,
+            agentName: id,
+            data: { action: 'updated' },
+        });
     }
     return updated;
 }
@@ -122,6 +129,13 @@ async function deleteAgent(id) {
     // Stop event triggers and cron schedules before deleting
     Promise.resolve().then(() => __importStar(require('./trigger-registry'))).then(({ agentTriggerRegistry }) => agentTriggerRegistry.stopAgent(id)).catch(() => { });
     Promise.resolve().then(() => __importStar(require('../cron'))).then(({ cronRegistry }) => cronRegistry.stopAgentCrons(id)).catch(() => { });
+    // Signal other containers to stop triggers for this agent
+    (0, publish_1.publishAgentEvent)({
+        type: 'agent.triggers_changed',
+        agentId: id,
+        agentName: id,
+        data: { action: 'deleted' },
+    });
     const pool = (0, db_1.getPool)();
     const { rowCount } = await pool.query(sql_1.DELETE_AGENT, [id]);
     return (rowCount ?? 0) > 0;

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

@@ -1,7 +1,7 @@
 export declare const LIST_SUBSCRIPTIONS = "\n  SELECT * FROM lt_agent_subscriptions\n  WHERE agent_id = $1\n  ORDER BY created_at\n";
 export declare const GET_SUBSCRIPTION = "\n  SELECT * FROM lt_agent_subscriptions WHERE id = $1\n";
-export declare const INSERT_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, $10)\n  RETURNING *\n";
-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 INSERT_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, server_id, tool_name)\n  VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12)\n  RETURNING *\n";
+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    server_id = COALESCE($11, server_id),\n    tool_name = COALESCE($12, tool_name)\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 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, server_id, tool_name)\n  VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, true, $10, $11)\n  ON CONFLICT (agent_id, topic) DO NOTHING\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

@@ -12,8 +12,8 @@ exports.GET_SUBSCRIPTION = `
 exports.INSERT_SUBSCRIPTION = `
   INSERT INTO lt_agent_subscriptions
     (agent_id, topic, filter, reaction_type, workflow_type, pipeline_id, mcp_prompt,
-     input_mapping, execute_as, enabled)
-  VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10)
+     input_mapping, execute_as, enabled, server_id, tool_name)
+  VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11, $12)
   RETURNING *
 `;
 exports.UPDATE_SUBSCRIPTION = `
@@ -26,7 +26,9 @@ exports.UPDATE_SUBSCRIPTION = `
     mcp_prompt = COALESCE($7, mcp_prompt),
     input_mapping = COALESCE($8, input_mapping),
     execute_as = COALESCE($9, execute_as),
-    enabled = COALESCE($10, enabled)
+    enabled = COALESCE($10, enabled),
+    server_id = COALESCE($11, server_id),
+    tool_name = COALESCE($12, tool_name)
   WHERE id = $1
   RETURNING *
 `;
@@ -36,8 +38,8 @@ exports.DELETE_SUBSCRIPTION = `
 exports.SEED_SUBSCRIPTION = `
   INSERT INTO lt_agent_subscriptions
     (agent_id, topic, filter, reaction_type, workflow_type, pipeline_id, mcp_prompt,
-     input_mapping, execute_as, enabled)
-  VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, true)
+     input_mapping, execute_as, enabled, server_id, tool_name)
+  VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, true, $10, $11)
   ON CONFLICT (agent_id, topic) DO NOTHING
 `;
 exports.LIST_ACTIVE_SUBSCRIPTIONS = `

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

@@ -3,10 +3,12 @@ export interface AgentSubscription {
     agent_id: string;
     topic: string;
     filter?: Record<string, any>;
-    reaction_type: 'durable' | 'pipeline' | 'mcp_query';
+    reaction_type: 'durable' | 'pipeline' | 'mcp_query' | 'capability';
     workflow_type?: string;
     pipeline_id?: string;
     mcp_prompt?: string;
+    server_id?: string;
+    tool_name?: string;
     input_mapping: Record<string, any>;
     execute_as?: string;
     enabled: boolean;

package/build/services/agent/subscriptions.js

@@ -32,6 +32,8 @@ async function createSubscription(agentId, data) {
         JSON.stringify(data.input_mapping ?? {}),
         data.execute_as ?? null,
         data.enabled !== false,
+        data.server_id ?? null,
+        data.tool_name ?? null,
     ]);
     return rows[0];
 }
@@ -48,6 +50,8 @@ async function updateSubscription(id, data) {
         data.input_mapping ? JSON.stringify(data.input_mapping) : null,
         data.execute_as ?? null,
         data.enabled ?? null,
+        data.server_id ?? null,
+        data.tool_name ?? null,
     ]);
     return rows[0] ?? null;
 }
@@ -77,6 +81,8 @@ async function seedSubscription(agentId, data) {
         data.mcp_prompt ?? null,
         JSON.stringify(data.input_mapping ?? {}),
         data.execute_as ?? null,
+        data.server_id ?? null,
+        data.tool_name ?? null,
     ]);
     return (rowCount ?? 0) > 0;
 }

package/build/services/agent/trigger-registry.d.ts

@@ -12,6 +12,8 @@ declare class AgentTriggerRegistry {
     private connected;
     /**
      * Load all active subscriptions from DB and arm event listeners.
+     * Also subscribes to `agent.triggers_changed` so other containers
+     * can signal this one to re-arm after subscription CRUD.
      */
     connect(adapter: CallbackEventAdapter): Promise<void>;
     /**

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

@@ -55,13 +55,32 @@ class AgentTriggerRegistry {
     }
     /**
      * Load all active subscriptions from DB and arm event listeners.
+     * Also subscribes to `agent.triggers_changed` so other containers
+     * can signal this one to re-arm after subscription CRUD.
      */
     async connect(adapter) {
         this.adapter = adapter;
         const subs = await (0, subscriptions_1.listActiveSubscriptions)();
         for (const sub of subs) {
+            logger_1.loggerRegistry.info(`[long-tail] arming trigger: ${sub.agent_name}/${sub.topic} → ${sub.reaction_type}:${sub.tool_name || sub.workflow_type || sub.mcp_prompt?.slice(0, 20) || '?'}`);
             this.armSubscription(sub);
         }
+        // Listen for cross-container trigger sync signals
+        adapter.on('agent.triggers_changed', (event) => {
+            const agentId = event.data?.agentId;
+            const action = event.data?.action;
+            if (!agentId)
+                return;
+            if (action === 'deleted') {
+                this.stopAgent(agentId);
+                logger_1.loggerRegistry.info(`[long-tail] agent triggers stopped (remote): ${agentId}`);
+            }
+            else {
+                this.restartAgent(agentId).then(() => {
+                    logger_1.loggerRegistry.info(`[long-tail] agent triggers synced (remote): ${agentId}`);
+                }).catch(() => { });
+            }
+        });
         this.connected = true;
         logger_1.loggerRegistry.info(`[long-tail] agent trigger registry: ${subs.length} subscription(s) armed`);
     }
@@ -123,8 +142,10 @@ class AgentTriggerRegistry {
     buildHandler(sub) {
         return async (event) => {
             try {
+                logger_1.loggerRegistry.info(`[long-tail] trigger matched: ${sub.agent_name}/${sub.topic} for event ${event.type}`);
                 // 1. Evaluate optional filter
                 if (sub.filter && !this.matchesFilter(event, sub.filter)) {
+                    logger_1.loggerRegistry.info(`[long-tail] trigger filtered out: ${sub.agent_name}/${sub.topic}`);
                     return;
                 }
                 // 2. Derive deterministic workflow ID for distributed dedup
@@ -154,14 +175,22 @@ class AgentTriggerRegistry {
                 }).catch(() => { }); // best-effort
             }
             catch (err) {
-                (0, publish_1.publishAgentEvent)({
-                    type: 'agent.failed',
-                    agentId: sub.agent_id,
-                    agentName: sub.agent_name,
-                    status: 'error',
-                    data: { topic: sub.topic, error: err.message },
-                });
-                logger_1.loggerRegistry.warn(`[long-tail] agent trigger failed: ${sub.agent_name}/${sub.topic}: ${err.message}`);
+                // Duplicate job errors are expected in multi-container — another
+                // container won the race. Log as info and continue.
+                const isDuplicate = err.message?.includes('already exists');
+                if (isDuplicate) {
+                    logger_1.loggerRegistry.info(`[long-tail] agent trigger dedup (another container handled): ${sub.agent_name}/${sub.topic}`);
+                }
+                else {
+                    (0, publish_1.publishAgentEvent)({
+                        type: 'agent.failed',
+                        agentId: sub.agent_id,
+                        agentName: sub.agent_name,
+                        status: 'error',
+                        data: { topic: sub.topic, error: err.message },
+                    });
+                    logger_1.loggerRegistry.warn(`[long-tail] agent trigger failed: ${sub.agent_name}/${sub.topic}: ${err.message}`);
+                }
             }
         };
     }
@@ -214,6 +243,7 @@ class AgentTriggerRegistry {
                     data: mapped.data ?? mapped,
                     execute_as: sub.execute_as ?? sub.agent_user_id ?? undefined,
                     source: 'agent',
+                    jobId: deterministicId,
                 });
                 break;
             }
@@ -226,6 +256,23 @@ class AgentTriggerRegistry {
                 });
                 break;
             }
+            case 'capability': {
+                logger_1.loggerRegistry.info(`[long-tail] agent capability: ${sub.agent_name} → ${sub.tool_name} on ${sub.server_id} (id=${deterministicId})`);
+                const { invokeWorkflow } = await Promise.resolve().then(() => __importStar(require('../workflow-invocation')));
+                await invokeWorkflow({
+                    workflowType: 'capabilityInvoke',
+                    data: {
+                        serverId: sub.server_id,
+                        toolName: sub.tool_name,
+                        arguments: mapped,
+                    },
+                    metadata: { source: 'agent' },
+                    executeAs: sub.execute_as ?? sub.agent_user_id ?? undefined,
+                    options: { workflowId: deterministicId },
+                    auth: { userId: sub.agent_user_id || 'lt-system', role: 'admin' },
+                });
+                break;
+            }
         }
     }
 }

package/build/services/topics/system-topics.js

@@ -158,6 +158,35 @@ const SYSTEM_TOPICS = [
         example_payload: { domain: 'orders', key: 'order-12345' },
         tags: ['lifecycle', 'knowledge'],
     },
+    // File storage
+    {
+        topic: 'file.stored',
+        description: 'A file has been written to storage.',
+        category: 'file',
+        payload_schema: objectSchema({
+            path: { type: 'string', description: 'File path in storage' },
+            name: { type: 'string', description: 'File name without extension' },
+            extension: { type: 'string', description: 'File extension (without dot)' },
+            filename: { type: 'string', description: 'Full filename with extension' },
+            mime: { type: 'string', description: 'MIME type' },
+            size: { type: 'number', description: 'File size in bytes' },
+        }),
+        example_payload: { path: '/images/photo.jpg', name: 'photo', extension: 'jpg', filename: 'photo.jpg', mime: 'image/jpeg', size: 245760 },
+        tags: ['lifecycle', 'file', 'storage'],
+    },
+    {
+        topic: 'file.deleted',
+        description: 'A file has been removed from storage.',
+        category: 'file',
+        payload_schema: objectSchema({
+            path: { type: 'string', description: 'File path in storage' },
+            name: { type: 'string', description: 'File name without extension' },
+            extension: { type: 'string', description: 'File extension (without dot)' },
+            filename: { type: 'string', description: 'Full filename with extension' },
+        }),
+        example_payload: { path: '/images/photo.jpg', name: 'photo', extension: 'jpg', filename: 'photo.jpg' },
+        tags: ['lifecycle', 'file', 'storage'],
+    },
     // Agent lifecycle
     {
         topic: 'agent.started',

package/build/services/yaml-workflow/deployer.d.ts

@@ -30,7 +30,7 @@ export declare function activateYamlWorkflow(appId: string, version: string): Pr
 /**
  * Invoke a YAML workflow (fire-and-forget). Returns the job ID.
  */
-export declare function invokeYamlWorkflow(appId: string, topic: string, data: Record<string, unknown>, entity?: string): Promise<string>;
+export declare function invokeYamlWorkflow(appId: string, topic: string, data: Record<string, unknown>, entity?: string, context?: Record<string, any>): Promise<string>;
 /**
  * Invoke a YAML workflow and wait for the result.
  *

package/build/services/yaml-workflow/deployer.js

@@ -136,9 +136,9 @@ async function activateYamlWorkflow(appId, version) {
 /**
  * Invoke a YAML workflow (fire-and-forget). Returns the job ID.
  */
-async function invokeYamlWorkflow(appId, topic, data, entity) {
+async function invokeYamlWorkflow(appId, topic, data, entity, context) {
     const engine = await getEngine(appId);
-    return engine.pub(topic, data, undefined, entity ? { entity } : undefined);
+    return engine.pub(topic, data, context, entity ? { entity } : undefined);
 }
 /**
  * Invoke a YAML workflow and wait for the result.

package/build/services/yaml-workflow/invoke.d.ts

@@ -7,6 +7,8 @@ interface InvokeOptions {
     userId?: string;
     /** Source identifier for metadata injection (e.g., 'cron') */
     source?: string;
+    /** Deterministic job ID for idempotent execution (agent subscriptions) */
+    jobId?: string;
 }
 /**
  * Invoke a YAML workflow with scope injection.