botmux 2.43.0 → 2.45.0

package/dist/workflows/trigger-from-envelope.js

@@ -0,0 +1,67 @@
+/**
+ * Workflow thin layer for the shared `/api/trigger` boundary.
+ *
+ * When an external trigger targets `kind=workflow`, map its untrusted event
+ * envelope to a workflow run via the existing `triggerWorkflowRun`. The whole
+ * event is passed as a single **string** param named `event` (a JSON string),
+ * so a webhook-triggerable workflow just declares an `event: string` param and
+ * its first subagent reads `${params.event}` as untrusted event data — same
+ * pass-through philosophy as turns (the model understands the payload; we don't
+ * pre-map per-platform fields here).
+ *
+ * Pure + deps-injected: the daemon wires `runWorkflow` (the already-configured
+ * `triggerWorkflowRun` closure) so this stays unit-testable without the daemon.
+ */
+import { randomUUID } from 'node:crypto';
+/** The well-known param name a webhook-triggerable workflow must declare (type string). */
+export const EVENT_PARAM_NAME = 'event';
+export async function triggerWorkflowFromEnvelope(req, deps) {
+    const triggerId = (deps.makeTriggerId ?? (() => `trg_${randomUUID().slice(0, 12)}`))();
+    const workflowId = req.target.workflowId;
+    const chatId = req.target.chatId;
+    if (!workflowId) {
+        return { ok: false, triggerId, errorCode: 'target_required', error: 'workflow target requires workflowId' };
+    }
+    // chatBinding needs a chat to post the workflow's messages into.
+    if (!chatId) {
+        return { ok: false, triggerId, errorCode: 'target_required', error: 'workflow target requires chatId for chat binding' };
+    }
+    // The untrusted external event, serialized as a string param. Workflow nodes
+    // must treat it as event data, never as instructions.
+    const eventJson = JSON.stringify({
+        triggerId,
+        source: req.source,
+        envelope: req.envelope,
+        options: req.options ?? {},
+    });
+    if (req.options?.dryRun) {
+        return {
+            ok: true,
+            triggerId,
+            action: 'dry_run',
+            target: { kind: 'workflow', chatId },
+            message: `dry run: would start workflow "${workflowId}" with param "${EVENT_PARAM_NAME}" (${eventJson.length} bytes)`,
+        };
+    }
+    const result = await deps.runWorkflow({
+        workflowId,
+        rawParams: { [EVENT_PARAM_NAME]: { kind: 'string', value: eventJson } },
+        chatBinding: { chatId, larkAppId: deps.larkAppId },
+        initiator: req.source.connectorId ? `webhook:${req.source.connectorId}` : `external:${req.source.type}`,
+    });
+    if (result.ok) {
+        return {
+            ok: true,
+            triggerId,
+            action: 'queued',
+            target: { kind: 'workflow', workflowRunId: result.runId, chatId },
+            message: `workflow "${workflowId}" run ${result.runId} started`,
+        };
+    }
+    // Map workflow failure → stable trigger errorCode for the UI.
+    const errorCode = result.error === 'unknown_workflow' || result.error === 'invalid_params'
+        ? 'bad_request'
+        : 'trigger_failed';
+    return { ok: false, triggerId, errorCode, error: result.message };
+}
+//# sourceMappingURL=trigger-from-envelope.js.map

package/dist/workflows/trigger-from-envelope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trigger-from-envelope.js","sourceRoot":"","sources":["../../src/workflows/trigger-from-envelope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAYzC,2FAA2F;AAC3F,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,GAAmB,EACnB,IAA0B;IAE1B,MAAM,SAAS,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,GAAG,EAAE,CAAC,OAAO,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;IACvF,MAAM,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC;IACzC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC;IAEjC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;IAC9G,CAAC;IACD,iEAAiE;IACjE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,iBAAiB,EAAE,KAAK,EAAE,kDAAkD,EAAE,CAAC;IAC3H,CAAC;IAED,6EAA6E;IAC7E,sDAAsD;IACtD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAC/B,SAAS;QACT,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE;KAC3B,CAAC,CAAC;IAEH,IAAI,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;QACxB,OAAO;YACL,EAAE,EAAE,IAAI;YACR,SAAS;YACT,MAAM,EAAE,SAAS;YACjB,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE;YACpC,OAAO,EAAE,kCAAkC,UAAU,iBAAiB,gBAAgB,MAAM,SAAS,CAAC,MAAM,SAAS;SACtH,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC;QACpC,UAAU;QACV,SAAS,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE;QACvE,WAAW,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE;QAClD,SAAS,EAAE,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE;KACxG,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,OAAO;YACL,EAAE,EAAE,IAAI;YACR,SAAS;YACT,MAAM,EAAE,QAAQ;YAChB,MAAM,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE;YACjE,OAAO,EAAE,aAAa,UAAU,SAAS,MAAM,CAAC,KAAK,UAAU;SAChE,CAAC;IACJ,CAAC;IAED,8DAA8D;IAC9D,MAAM,SAAS,GACb,MAAM,CAAC,KAAK,KAAK,kBAAkB,IAAI,MAAM,CAAC,KAAK,KAAK,gBAAgB;QACtE,CAAC,CAAC,aAAa;QACf,CAAC,CAAC,gBAAgB,CAAC;IACvB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;AACpE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "botmux",
-  "version": "2.43.0",
+  "version": "2.45.0",
   "description": "Bridge between IM platforms and AI coding CLIs — one topic, one CLI session with live streaming",
   "type": "module",
   "main": "dist/index-daemon.js",