@exaudeus/workrail 3.24.3 → 3.25.0

package/dist/manifest.json

@@ -238,8 +238,8 @@
       "bytes": 31
     },
     "cli.js": {
-      "sha256": "4fa91d141cb398a7ba46ea2dadbf47bb2fba3cd30425137e740ae4f4dea6c353",
-      "bytes": 8027
+      "sha256": "aaaa221e1e23720c0c62f3ac2a17308fb30c3355bfc752f277171605ab8dd91c",
+      "bytes": 11866
     },
     "cli/commands/cleanup.d.ts": {
       "sha256": "efe1f9e2ecd58e92007ed38b9581a3852c2babe4b3f2a97237dccd878eebe7ec",
@@ -250,12 +250,12 @@
       "bytes": 745
     },
     "cli/commands/index.d.ts": {
-      "sha256": "d9060f00f6f9431c2dae86e1b9cce72b332a8207a4e697e0188f2528db682e37",
-      "bytes": 856
+      "sha256": "a5045789481f435d99e8e0eda80f37d9190a787ae50817a2b1dd45c500706869",
+      "bytes": 935
     },
     "cli/commands/index.js": {
-      "sha256": "a6786e4f60ed6729a14b84f69df4afbf6cff3f09d7a03bc8738e1b2fa7550a82",
-      "bytes": 2436
+      "sha256": "db2f4d050324decbb425a3b5917d647b991544d6d971a29ca9657f8750ea70d5",
+      "bytes": 2656
     },
     "cli/commands/init.d.ts": {
       "sha256": "b5f8b88a072c68509dab3938ba1d6b4a949ad32f8fc55e91c5039b8c77301c1b",
@@ -305,6 +305,14 @@
       "sha256": "abfe2dede282853df7242b52e52f96364e692b6e65707ca0db581668708c9b09",
       "bytes": 3481
     },
+    "cli/commands/version.d.ts": {
+      "sha256": "b1dfb758b202ea230bc35688794a08edad78001eec0e7088a01d1b6b921bb34b",
+      "bytes": 267
+    },
+    "cli/commands/version.js": {
+      "sha256": "bd6ca78870fdafe5ce36b41404c49ad15b60092f117c9f74cb8156f2bed0445c",
+      "bytes": 538
+    },
     "cli/interpret-result.d.ts": {
       "sha256": "255f04350df9c8cf8d5e65ed2fc11d41fa60a7b5ccc818e7728b1c081340a66a",
       "bytes": 315
@@ -369,16 +377,16 @@
       "sha256": "5fe866e54f796975dec5d8ba9983aefd86074db212d3fccd64eed04bc9f0b3da",
       "bytes": 8011
     },
-    "console/assets/index-BXRk3te_.css": {
-      "sha256": "2151b10aedd5da99f5bac5cdb54c4cb73894b9069eab0fb859db50b9aa71fba2",
-      "bytes": 59906
+    "console/assets/index-8dh0Psu-.css": {
+      "sha256": "cf9d09641f1c31fffe6c7835b30bbbad52572befec1acab7fb9a0c188431af36",
+      "bytes": 60355
     },
-    "console/assets/index-TMfptYpQ.js": {
-      "sha256": "475c71c4cca93f8ed30139569638b9ec272b43eb44feccb4ce08c6f7e2064dc7",
-      "bytes": 744551
+    "console/assets/index-HhtarvD5.js": {
+      "sha256": "08f261e8ee93433485c04dfceb497517787ffa0c9e871415a7a0aca5d05fe731",
+      "bytes": 754653
     },
     "console/index.html": {
-      "sha256": "1ff870763f5df29998d56597a3b138e07e23b8fb054c93f6ce9f7f5ae4a0c9a5",
+      "sha256": "c9d211c6ed52bc75fb22ae55d4e9bb349f22dcde4a03911603749fb0a68facdf",
       "bytes": 417
     },
     "core/error-handler.d.ts": {
@@ -389,6 +397,22 @@
       "sha256": "a3c7ee47d37f111561e2b73f7487670bb4dc894d45931a0745c26fe5acd8c759",
       "bytes": 3493
     },
+    "daemon/pi-mono-loader.d.ts": {
+      "sha256": "e04d7244df5eb05522e7da115376b543cdd8a7a31a9deab511718b0ffb6b31f0",
+      "bytes": 331
+    },
+    "daemon/pi-mono-loader.js": {
+      "sha256": "d15e69b30ab83280471be3b8cd478aaf15b38b8545e47de3e2ceb793def5ba0d",
+      "bytes": 2635
+    },
+    "daemon/workflow-runner.d.ts": {
+      "sha256": "e33759a1e9063d178f2c0a1775b4da316bbbaa94a5ce3aa38aa45d0997bfb8de",
+      "bytes": 2101
+    },
+    "daemon/workflow-runner.js": {
+      "sha256": "f44cd08bbed6cb9e3596fcf4216d3020dc4ece29625e79ce0d2f54586018910c",
+      "bytes": 24092
+    },
     "di/container.d.ts": {
       "sha256": "003bb7fb7478d627524b9b1e76bd0a963a243794a687ff233b96dc0e33a06d9f",
       "bytes": 620
@@ -546,8 +570,8 @@
       "bytes": 2025
     },
     "infrastructure/session/HttpServer.js": {
-      "sha256": "5d526849ef6e97e5341df73fb9b9789a4bfa7e132f2751b9892f3cbfe09aa2c9",
-      "bytes": 31215
+      "sha256": "cb3c733c5dfd4e998e0170d60e1689390454afdeb9c8a5838fd9af3a9da2fa56",
+      "bytes": 31241
     },
     "infrastructure/session/SessionDataNormalizer.d.ts": {
       "sha256": "c89bb5e00d7d01fb4aa6d0095602541de53c425c6b99b67fa8367eb29cb63e9e",
@@ -918,12 +942,12 @@
       "bytes": 11397
     },
     "mcp/handlers/v2-execution/start.d.ts": {
-      "sha256": "2deb05345e125667576ede3bb20756a1b22ec86f18028d242b5d9b54dd25afaf",
-      "bytes": 3405
+      "sha256": "3d93d6119b89d6cabf8bebbaafd24d8de53d84dd671440d221dda5a238ba4fc4",
+      "bytes": 3519
     },
     "mcp/handlers/v2-execution/start.js": {
-      "sha256": "68e95c6414807f6e069961b176f7ddc220c1fe248433b8d6d2a929f102532fb4",
-      "bytes": 21109
+      "sha256": "f57771c4baa31204fc683615802a02c4c9cf65e8727426210fc656d173e9fe51",
+      "bytes": 21208
     },
     "mcp/handlers/v2-execution/workflow-object-cache.d.ts": {
       "sha256": "7e58a2a020fd8443821dbe4e6a2702a9882c517f032a340c1b393cdebf4af907",
@@ -1034,8 +1058,8 @@
       "bytes": 960
     },
     "mcp/server.js": {
-      "sha256": "a54d39ce8d7282abe16d140abbe1011e67cd3f9d9353f40727c44c1c212a90c2",
-      "bytes": 16152
+      "sha256": "b60d150f98355033ef172a58e7c2b12f01848f0bbb4a2b633276791ffce96637",
+      "bytes": 16178
     },
     "mcp/step-content-envelope.d.ts": {
       "sha256": "19bd63c4d4de1d5d93393d346625d28ffd1bebdc320d4ba4e694cb740ec97d3b",
@@ -1098,7 +1122,7 @@
       "bytes": 70
     },
     "mcp/transports/http-entry.js": {
-      "sha256": "fdebcd58e111f3051081003599e8608fa1becf20abf97a666a957f8048c95334",
+      "sha256": "29de54000abc8c0f5aae334c1866bf4ac4198ba29e8ce5a3f0e61a7f0128eb40",
       "bytes": 3314
     },
     "mcp/transports/http-listener.d.ts": {
@@ -1389,6 +1413,46 @@
       "sha256": "d43aa81f5bc89faa359e0f97c814ba25155591ff078fbb9bfd40f8c7c9683230",
       "bytes": 77
     },
+    "trigger/index.d.ts": {
+      "sha256": "ac0df6f84ff1ca493f28870b4303e5d68c3bfb2e8109678a10c1cfe11c28c802",
+      "bytes": 471
+    },
+    "trigger/index.js": {
+      "sha256": "c4bfc4c4e9845fb5570badbdfbf133919b71aa513f1ad8fdbe51682450b03359",
+      "bytes": 749
+    },
+    "trigger/trigger-listener.d.ts": {
+      "sha256": "dc0f1d359ef4f6052c360ba2f6464388e526c6b566a0a627517c9a39ae160b21",
+      "bytes": 1137
+    },
+    "trigger/trigger-listener.js": {
+      "sha256": "92579deef666a588d19167e96b881410dd1cb7c791c3682c149f7bd040001043",
+      "bytes": 7034
+    },
+    "trigger/trigger-router.d.ts": {
+      "sha256": "bb7d7c369bc4c3c7018fd7a272b04522937c6aad575aa3198f3002cf69edea89",
+      "bytes": 1304
+    },
+    "trigger/trigger-router.js": {
+      "sha256": "f277e81e4512617dce597105ec34bab5ce0c809d877eaa772eb5c2df3b766689",
+      "bytes": 7457
+    },
+    "trigger/trigger-store.d.ts": {
+      "sha256": "7ce8f2fe7cc80b1b15568dabd3e508acd9ee4a2fbf4bcb2810f44f5a6927f266",
+      "bytes": 1232
+    },
+    "trigger/trigger-store.js": {
+      "sha256": "a35fd740f08804b6057f946d507cdc8d7c3f7d8aaf7e21f12a9940680e6297e0",
+      "bytes": 18505
+    },
+    "trigger/types.d.ts": {
+      "sha256": "b087d72c41e3292882fee49bc3a0048e7e790e4113f609b27f3ca498f8773a98",
+      "bytes": 1433
+    },
+    "trigger/types.js": {
+      "sha256": "c2f56c08d47a76344a5acce16fdfec723da9302232480dcf200a462ad7859f4f",
+      "bytes": 162
+    },
     "types/server.d.ts": {
       "sha256": "2a6e466b41f7263563cddddd3aaffcd786925dfd878bde3871d5681167eac5d8",
       "bytes": 97
@@ -2157,6 +2221,22 @@
       "sha256": "15a8f8b7dac5ab4449f389c75ce7c13a163f639ade481c3890a7f527d23f500d",
       "bytes": 3441
     },
+    "v2/infra/in-memory/daemon-registry/index.d.ts": {
+      "sha256": "874c4ce17fa901640737fce7cdb70eb288d1ab3620c1d9615cdddb5afd27c208",
+      "bytes": 521
+    },
+    "v2/infra/in-memory/daemon-registry/index.js": {
+      "sha256": "f79b1593176dc042afa8fc621698f529be478084891bb1c45b9b76fae3d8c761",
+      "bytes": 910
+    },
+    "v2/infra/in-memory/keyed-async-queue/index.d.ts": {
+      "sha256": "1a5c59ec29f35532b34579ea3d03817b7cda369807a0a0e48a15a30ee72d13c4",
+      "bytes": 167
+    },
+    "v2/infra/in-memory/keyed-async-queue/index.js": {
+      "sha256": "831885209d746693488c7331db137edd5c9a43a012ef3d87dfcea850ebf97426",
+      "bytes": 863
+    },
     "v2/infra/in-memory/managed-source-store/index.d.ts": {
       "sha256": "fe06e50f66f9b542704884e0a4dd491e0380270ee41c52feb1217d327c37604e",
       "bytes": 544
@@ -2662,24 +2742,24 @@
       "bytes": 4795
     },
     "v2/usecases/console-routes.d.ts": {
-      "sha256": "1afd41269475fecd4a27ac1c5faccf1e369ec8bd8c9a9c36d38ed92c79e4ec51",
-      "bytes": 508
+      "sha256": "41cfffc165d2f98327b78ca86c92d69269cc399f6239ee394377af538ace4df1",
+      "bytes": 697
     },
     "v2/usecases/console-routes.js": {
-      "sha256": "315a10a46cacd8bf279ecdc72b2cfac912f6d6ab5f606419d16fd734c9406718",
-      "bytes": 15503
+      "sha256": "33426b2538cc35f1380531f2be4a6b8078349c8ec3e5473c39b4af5e8557ec39",
+      "bytes": 20254
     },
     "v2/usecases/console-service.d.ts": {
-      "sha256": "489a44091dc1b15ff938a60f9cf3ac28363614b9f0446286f0914157528c7eb3",
-      "bytes": 1572
+      "sha256": "fc8fe65427fa9f4f3535344b385b36f66ca06b7e3bfaea708931817a3edcad2b",
+      "bytes": 1701
     },
     "v2/usecases/console-service.js": {
-      "sha256": "99f25ac6595cddccb6941c99e9773b075c665eed8b820303efd41a1da1d95e05",
-      "bytes": 30332
+      "sha256": "bb394fbad8dd703896aa1593f87487d742a090016e4debe9c8527b984ccd6a1d",
+      "bytes": 31112
     },
     "v2/usecases/console-types.d.ts": {
-      "sha256": "9f1060c1689eb1fa6e23e6fbba00ad406c1956e196110c8eab7f95e8ceae81c9",
-      "bytes": 7386
+      "sha256": "a7b7ecd30ef7532f6b71aa1280c1bc150225d0558b89a19858a9b760ff834d8a",
+      "bytes": 7452
     },
     "v2/usecases/console-types.js": {
       "sha256": "d43aa81f5bc89faa359e0f97c814ba25155591ff078fbb9bfd40f8c7c9683230",

package/dist/mcp/handlers/v2-execution/start.d.ts

@@ -45,6 +45,7 @@ export declare function buildInitialEvents(args: {
         readonly mintEventId: () => string;
     };
     readonly goal: string;
+    readonly extraContext?: Readonly<Record<string, string>>;
 }): readonly DomainEventV1[];
 export declare function mintStartTokens(args: {
     readonly sessionId: SessionId;
@@ -59,4 +60,4 @@ export declare function mintStartTokens(args: {
     readonly continueToken: string;
     readonly checkpointToken: string;
 }, StartWorkflowError>;
-export declare function executeStartWorkflow(input: import('../../v2/tools.js').V2StartWorkflowInput, ctx: V2ToolContext): RA<StartWorkflowResult, StartWorkflowError>;
+export declare function executeStartWorkflow(input: import('../../v2/tools.js').V2StartWorkflowInput, ctx: V2ToolContext, internalContext?: Readonly<Record<string, string>>): RA<StartWorkflowResult, StartWorkflowError>;

package/dist/mcp/handlers/v2-execution/start.js

@@ -109,7 +109,7 @@ function loadAndPinWorkflow(args) {
     });
 }
 function buildInitialEvents(args) {
-    const { sessionId, runId, nodeId, workflowId, workflowHash, workflowSourceKind, workflowSourceRef, snapshotRef, observations, idFactory, goal, } = args;
+    const { sessionId, runId, nodeId, workflowId, workflowHash, workflowSourceKind, workflowSourceRef, snapshotRef, observations, idFactory, goal, extraContext, } = args;
     const evtSessionCreated = idFactory.mintEventId();
     const evtRunStarted = idFactory.mintEventId();
     const evtNodeCreated = idFactory.mintEventId();
@@ -191,7 +191,7 @@ function buildInitialEvents(args) {
             scope: { runId: String(runId) },
             data: {
                 contextId,
-                context: { goal },
+                context: { ...extraContext, goal },
                 source: 'initial',
             },
         });
@@ -229,7 +229,7 @@ function mintStartTokens(args) {
         cause: failure,
     }));
 }
-function executeStartWorkflow(input, ctx) {
+function executeStartWorkflow(input, ctx, internalContext) {
     const { gate, sessionStore, snapshotStore, pinnedStore, crypto, tokenCodecPorts, idFactory, validationPipelineDeps, tokenAliasStore, entropy } = ctx.v2;
     const shouldUseRequestReader = ctx.featureFlags != null && (0, request_workflow_reader_js_1.hasRequestWorkspaceSignal)({
         workspacePath: input.workspacePath,
@@ -313,6 +313,7 @@ function executeStartWorkflow(input, ctx) {
                     observations,
                     idFactory,
                     goal: input.goal,
+                    extraContext: internalContext,
                 });
                 const emptyTruth = { manifest: [], events: [] };
                 return gate.withHealthySessionLock(sessionId, (lock) => sessionStore.append(lock, {

package/dist/mcp/server.js

@@ -188,7 +188,7 @@ async function composeServer() {
             snapshotStore: ctx.v2.snapshotStore,
             pinnedWorkflowStore: ctx.v2.pinnedStore,
         });
-        ctx.httpServer.mountRoutes((app) => mountConsoleRoutes(app, consoleService, ctx.workflowService, timingRingBuffer, toolCallsPerfFile ?? undefined, serverVersion));
+        ctx.httpServer.mountRoutes((app) => mountConsoleRoutes(app, consoleService, ctx.workflowService, timingRingBuffer, toolCallsPerfFile ?? undefined, serverVersion, ctx.v2 ? ctx : undefined));
         console.error('[Console] v2 Console API routes mounted at /api/v2/');
     }
     ctx.httpServer?.finalize();

package/dist/mcp/transports/http-entry.js

@@ -56,10 +56,10 @@ async function startHttpServer(port) {
     listener.app.post('/mcp', (req, res) => transport.handleRequest(req, res, req.body));
     listener.app.get('/mcp', (req, res) => transport.handleRequest(req, res));
     listener.app.delete('/mcp', (req, res) => transport.handleRequest(req, res));
+    await server.connect(transport);
     listener.app.get('/workrail-health', (_req, res) => {
         res.json({ service: 'workrail' });
     });
-    await server.connect(transport);
     const boundPort = listener.getBoundPort();
     console.error('[Transport] WorkRail MCP Server running on HTTP');
     console.error(`[Transport] MCP endpoint: http://localhost:${boundPort}/mcp`);

package/dist/trigger/index.d.ts

@@ -0,0 +1,5 @@
+export { startTriggerListener } from './trigger-listener.js';
+export type { TriggerListenerHandle, TriggerListenerError, StartTriggerListenerOptions } from './trigger-listener.js';
+export { loadTriggerConfig, loadTriggerConfigFromFile } from './trigger-store.js';
+export type { TriggerStoreError } from './trigger-store.js';
+export type { TriggerId, TriggerDefinition, TriggerConfig, TriggerSource, WebhookEvent, ContextMapping, ContextMappingEntry, } from './types.js';

package/dist/trigger/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadTriggerConfigFromFile = exports.loadTriggerConfig = exports.startTriggerListener = void 0;
+var trigger_listener_js_1 = require("./trigger-listener.js");
+Object.defineProperty(exports, "startTriggerListener", { enumerable: true, get: function () { return trigger_listener_js_1.startTriggerListener; } });
+var trigger_store_js_1 = require("./trigger-store.js");
+Object.defineProperty(exports, "loadTriggerConfig", { enumerable: true, get: function () { return trigger_store_js_1.loadTriggerConfig; } });
+Object.defineProperty(exports, "loadTriggerConfigFromFile", { enumerable: true, get: function () { return trigger_store_js_1.loadTriggerConfigFromFile; } });

package/dist/trigger/trigger-listener.d.ts

@@ -0,0 +1,30 @@
+import 'reflect-metadata';
+import express from 'express';
+import type { V2ToolContext } from '../mcp/types.js';
+import type { TriggerStoreError } from './trigger-store.js';
+import { TriggerRouter, type RunWorkflowFn } from './trigger-router.js';
+export type TriggerListenerError = TriggerStoreError | {
+    readonly kind: 'port_conflict';
+    readonly port: number;
+} | {
+    readonly kind: 'feature_disabled';
+} | {
+    readonly kind: 'missing_api_key';
+};
+export interface TriggerListenerHandle {
+    readonly port: number;
+    readonly router: TriggerRouter;
+    stop(): Promise<void>;
+}
+export interface StartTriggerListenerOptions {
+    readonly workspacePath: string;
+    readonly apiKey?: string;
+    readonly port?: number;
+    readonly env?: Record<string, string | undefined>;
+    readonly runWorkflowFn?: RunWorkflowFn;
+}
+export declare function createTriggerApp(router: TriggerRouter): express.Application;
+export declare function startTriggerListener(ctx: V2ToolContext, options: StartTriggerListenerOptions): Promise<TriggerListenerHandle | null | {
+    readonly _kind: 'err';
+    readonly error: TriggerListenerError;
+}>;

package/dist/trigger/trigger-listener.js

@@ -0,0 +1,166 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTriggerApp = createTriggerApp;
+exports.startTriggerListener = startTriggerListener;
+require("reflect-metadata");
+const express_1 = __importDefault(require("express"));
+const http = __importStar(require("node:http"));
+const trigger_store_js_1 = require("./trigger-store.js");
+const trigger_router_js_1 = require("./trigger-router.js");
+const workflow_runner_js_1 = require("../daemon/workflow-runner.js");
+const types_js_1 = require("./types.js");
+const DEFAULT_TRIGGER_PORT = 3200;
+function createTriggerApp(router) {
+    const app = (0, express_1.default)();
+    app.use('/webhook', express_1.default.raw({ type: 'application/json', limit: '1mb' }));
+    app.get('/health', (_req, res) => {
+        res.status(200).json({ status: 'ok' });
+    });
+    app.post('/webhook/:triggerId', (req, res) => {
+        const triggerId = (0, types_js_1.asTriggerId)(req.params['triggerId'] ?? '');
+        if (!triggerId) {
+            res.status(400).json({ error: 'Missing triggerId' });
+            return;
+        }
+        const rawBody = Buffer.isBuffer(req.body) ? req.body : Buffer.from('');
+        let payload;
+        try {
+            const bodyStr = rawBody.toString('utf8');
+            if (bodyStr) {
+                payload = JSON.parse(bodyStr);
+                if (typeof payload !== 'object' || payload === null || Array.isArray(payload)) {
+                    res.status(400).json({ error: 'Payload must be a JSON object' });
+                    return;
+                }
+            }
+            else {
+                payload = {};
+            }
+        }
+        catch {
+            res.status(400).json({ error: 'Invalid JSON body' });
+            return;
+        }
+        const signature = req.headers['x-workrail-signature'];
+        const event = {
+            triggerId,
+            rawBody,
+            payload,
+            ...(signature !== undefined ? { signature } : {}),
+        };
+        const result = router.route(event);
+        if (result._tag === 'error') {
+            switch (result.error.kind) {
+                case 'not_found':
+                    res.status(404).json({ error: `Unknown trigger: ${result.error.triggerId}` });
+                    return;
+                case 'hmac_invalid':
+                    res.status(401).json({ error: 'Invalid signature' });
+                    return;
+                case 'payload_error':
+                    res.status(400).json({ error: result.error.message });
+                    return;
+            }
+        }
+        res.status(202).json({ status: 'accepted', triggerId });
+    });
+    return app;
+}
+async function startTriggerListener(ctx, options) {
+    const env = options.env ?? process.env;
+    if (env['WORKRAIL_TRIGGERS_ENABLED'] !== 'true') {
+        return null;
+    }
+    const apiKey = options.apiKey ?? env['ANTHROPIC_API_KEY'];
+    if (!apiKey) {
+        return { _kind: 'err', error: { kind: 'missing_api_key' } };
+    }
+    const configResult = await (0, trigger_store_js_1.loadTriggerConfigFromFile)(options.workspacePath, env);
+    let triggerIndex;
+    if (configResult.kind === 'err') {
+        if (configResult.error.kind === 'file_not_found') {
+            console.warn(`[TriggerListener] triggers.yml not found at ${options.workspacePath}. ` +
+                `Listener will start with 0 triggers. ` +
+                `Create triggers.yml in that directory to configure triggers.`);
+            triggerIndex = new Map();
+        }
+        else {
+            return { _kind: 'err', error: configResult.error };
+        }
+    }
+    else {
+        const indexResult = (0, trigger_store_js_1.buildTriggerIndex)(configResult.value);
+        if (indexResult.kind === 'err') {
+            return { _kind: 'err', error: indexResult.error };
+        }
+        triggerIndex = indexResult.value;
+        console.log(`[TriggerListener] Loaded ${configResult.value.triggers.length} trigger(s) from triggers.yml`);
+    }
+    const runWorkflowFn = options.runWorkflowFn ?? workflow_runner_js_1.runWorkflow;
+    const router = new trigger_router_js_1.TriggerRouter(triggerIndex, ctx, apiKey, runWorkflowFn);
+    const app = createTriggerApp(router);
+    await (0, workflow_runner_js_1.runStartupRecovery)().catch((err) => {
+        console.warn('[TriggerListener] Startup recovery encountered an unexpected error:', err instanceof Error ? err.message : String(err));
+    });
+    const portEnv = env['WORKRAIL_TRIGGER_PORT'];
+    const port = options.port ?? (portEnv ? parseInt(portEnv, 10) : DEFAULT_TRIGGER_PORT);
+    return new Promise((resolve) => {
+        const server = http.createServer(app);
+        server.on('error', (error) => {
+            if (error.code === 'EADDRINUSE') {
+                resolve({ _kind: 'err', error: { kind: 'port_conflict', port } });
+            }
+            else {
+                resolve({ _kind: 'err', error: { kind: 'io_error', message: error.message } });
+            }
+        });
+        server.listen(port, '127.0.0.1', () => {
+            const addr = server.address();
+            const actualPort = (addr && typeof addr === 'object') ? addr.port : port;
+            console.log(`[TriggerListener] Webhook server listening on port ${actualPort}`);
+            resolve({
+                port: actualPort,
+                router,
+                stop: () => new Promise((res, rej) => {
+                    server.close((e) => (e ? rej(e) : res()));
+                }),
+            });
+        });
+    });
+}

package/dist/trigger/trigger-router.d.ts

@@ -0,0 +1,32 @@
+import type { WorkflowTrigger, WorkflowRunResult } from '../daemon/workflow-runner.js';
+import type { V2ToolContext } from '../mcp/types.js';
+import type { TriggerDefinition, WebhookEvent } from './types.js';
+export type RouteError = {
+    readonly kind: 'not_found';
+    readonly triggerId: string;
+} | {
+    readonly kind: 'hmac_invalid';
+} | {
+    readonly kind: 'payload_error';
+    readonly message: string;
+};
+export type RouteResult = {
+    readonly _tag: 'enqueued';
+    readonly triggerId: string;
+} | {
+    readonly _tag: 'error';
+    readonly error: RouteError;
+};
+export type RunWorkflowFn = (trigger: WorkflowTrigger, ctx: V2ToolContext, apiKey: string) => Promise<WorkflowRunResult>;
+export declare function interpolateGoalTemplate(template: string, staticGoal: string, payload: Readonly<Record<string, unknown>>): string;
+export declare class TriggerRouter {
+    private readonly index;
+    private readonly ctx;
+    private readonly apiKey;
+    private readonly runWorkflowFn;
+    private readonly queue;
+    constructor(index: ReadonlyMap<string, TriggerDefinition>, ctx: V2ToolContext, apiKey: string, runWorkflowFn: RunWorkflowFn);
+    route(event: WebhookEvent): RouteResult;
+    dispatch(workflowTrigger: WorkflowTrigger): string;
+    listTriggers(): readonly TriggerDefinition[];
+}