botmux 2.33.0 → 2.34.0

package/dist/workflows/hostExecutors/botmux-schedule.js

@@ -0,0 +1,121 @@
+import { z } from 'zod';
+import { createTask, getTask, IdempotencyConflictError, } from '../../services/schedule-store.js';
+const ParsedScheduleSchema = z.object({
+    kind: z.enum(['once', 'interval', 'cron']),
+    runAt: z.string().optional(),
+    minutes: z.number().optional(),
+    expr: z.string().optional(),
+    display: z.string(),
+});
+const ScheduleInputSchema = z.object({
+    name: z.string().min(1),
+    schedule: z.string().min(1),
+    parsed: ParsedScheduleSchema,
+    prompt: z.string(),
+    workingDir: z.string().min(1),
+    chatId: z.string().min(1),
+    rootMessageId: z.string().optional(),
+    scope: z.enum(['thread', 'chat']).optional(),
+    larkAppId: z.string().optional(),
+    repeat: z.object({ times: z.number().int().nonnegative().nullable() }).optional(),
+    deliver: z.enum(['origin', 'local']).optional(),
+});
+export function parseScheduleInput(input) {
+    return ScheduleInputSchema.parse(input);
+}
+/**
+ * `botmux-schedule` hostExecutor.  Calls `schedule-store.createTask`
+ * passing the runtime-derived `idempotencyKey` as the deterministic
+ * task id; schedule-store applies create-or-return-identical semantics
+ * (Step 5).
+ *
+ * Provider TTL is effectively infinite for schedule (the task entry
+ * lives until removed), so dangling effectAttempted reconcile uses
+ * readOnlyLookup (`getTask(idempotencyKey)`) — no TTL boundary.
+ */
+export const botmuxScheduleExecutor = {
+    provider: 'botmux-schedule',
+    idempotencyTtlMs: Number.MAX_SAFE_INTEGER,
+    canonicalInput(input) {
+        // Mirrors schedule-store's `canonicalScheduleInput`.  Keeping them in
+        // sync is critical: if they diverge, two callers can produce the
+        // same idempotencyKey but disagree on canonicality and trip the
+        // IdempotencyConflict path on every retry.
+        return {
+            name: input.name,
+            schedule: input.schedule,
+            parsed: {
+                kind: input.parsed.kind,
+                runAt: input.parsed.runAt,
+                minutes: input.parsed.minutes,
+                expr: input.parsed.expr,
+            },
+            prompt: input.prompt,
+            workingDir: input.workingDir,
+            chatId: input.chatId,
+            rootMessageId: input.rootMessageId,
+            scope: input.scope,
+            larkAppId: input.larkAppId,
+            repeat: input.repeat ? { times: input.repeat.times } : undefined,
+            deliver: input.deliver ?? 'origin',
+        };
+    },
+    async invoke(input, idempotencyKey) {
+        const task = createTask({
+            id: idempotencyKey,
+            name: input.name,
+            schedule: input.schedule,
+            parsed: input.parsed,
+            prompt: input.prompt,
+            workingDir: input.workingDir,
+            chatId: input.chatId,
+            rootMessageId: input.rootMessageId,
+            scope: input.scope,
+            larkAppId: input.larkAppId,
+            repeat: input.repeat ? { times: input.repeat.times, completed: 0 } : undefined,
+            deliver: input.deliver,
+        });
+        return {
+            output: { taskId: task.id },
+            externalRefs: { taskId: task.id },
+        };
+    },
+    classifyError(err) {
+        if (err instanceof IdempotencyConflictError) {
+            return {
+                errorCode: 'IdempotencyConflict',
+                errorClass: 'fatal',
+                errorMessage: err.message,
+            };
+        }
+        return null;
+    },
+};
+export const botmuxScheduleReconciler = {
+    provider: 'botmux-schedule',
+    // Schedule reconciler doesn't load effect input (idempotencyKey is
+    // self-sufficient), so the resume-side hash guard never fires.  We
+    // still expose `canonicalInput` for interface uniformity — anyone
+    // re-using the reconciler in a context that DOES load sidecars (e.g.
+    // future ScheduleStore variants requiring body verification) gets the
+    // same check for free.
+    canonicalInput(input) {
+        return botmuxScheduleExecutor.canonicalInput(input);
+    },
+    async readOnlyLookup(idempotencyKey) {
+        const task = getTask(idempotencyKey);
+        if (!task) {
+            return {
+                found: false,
+                evidence: { source: 'getTask', returned: 'undefined' },
+            };
+        }
+        const externalRefs = { taskId: task.id };
+        return {
+            found: true,
+            externalRefs,
+            evidence: { source: 'getTask', externalRefs },
+        };
+    },
+};
+//# sourceMappingURL=botmux-schedule.js.map

package/dist/workflows/hostExecutors/botmux-schedule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"botmux-schedule.js","sourceRoot":"","sources":["../../../src/workflows/hostExecutors/botmux-schedule.ts"],"names":[],"mappings":"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"}

package/dist/workflows/hostExecutors/feishu-im.d.ts

@@ -0,0 +1,12 @@
+import type { ProviderReconciler } from '../resume.js';
+/**
+ * Single Feishu IM provider reconciler.
+ *
+ * `effectAttempted.provider` is intentionally `feishu-im` for both
+ * `feishu-send` and `feishu-reply` because Feishu's idempotency surface
+ * is the IM uuid field.  The executor id identifies the author-facing
+ * operation; resume only sees the provider, so it dispatches by the
+ * recovered effect input shape.
+ */
+export declare const feishuImReconciler: ProviderReconciler;
+//# sourceMappingURL=feishu-im.d.ts.map

package/dist/workflows/hostExecutors/feishu-im.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feishu-im.d.ts","sourceRoot":"","sources":["../../../src/workflows/hostExecutors/feishu-im.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAIvD;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,EAAE,kBAoChC,CAAC"}

package/dist/workflows/hostExecutors/feishu-im.js

@@ -0,0 +1,49 @@
+import { feishuReplyReconciler } from './feishu-reply.js';
+import { feishuSendReconciler } from './feishu-send.js';
+/**
+ * Single Feishu IM provider reconciler.
+ *
+ * `effectAttempted.provider` is intentionally `feishu-im` for both
+ * `feishu-send` and `feishu-reply` because Feishu's idempotency surface
+ * is the IM uuid field.  The executor id identifies the author-facing
+ * operation; resume only sees the provider, so it dispatches by the
+ * recovered effect input shape.
+ */
+export const feishuImReconciler = {
+    provider: 'feishu-im',
+    requiresEffectInput: true,
+    canonicalInput(input) {
+        // The hash guard in resume needs to canonicalize via the SAME shape
+        // the original executor used.  Dispatch by input discriminator —
+        // identical logic to idempotentSubmit's routing.
+        if (isRecord(input) && Object.prototype.hasOwnProperty.call(input, 'rootMessageId')) {
+            return feishuReplyReconciler.canonicalInput(input);
+        }
+        if (isRecord(input) && Object.prototype.hasOwnProperty.call(input, 'chatId')) {
+            return feishuSendReconciler.canonicalInput(input);
+        }
+        // Unknown shape: return the input verbatim so the recomputed hash
+        // ends up SHA-stable but different from the original; the guard
+        // surfaces this as a mismatch rather than swallowing it.
+        return input;
+    },
+    async idempotentSubmit(idempotencyKey, input) {
+        if (isRecord(input) && Object.prototype.hasOwnProperty.call(input, 'rootMessageId')) {
+            return feishuReplyReconciler.idempotentSubmit(idempotencyKey, input);
+        }
+        if (isRecord(input) && Object.prototype.hasOwnProperty.call(input, 'chatId')) {
+            return feishuSendReconciler.idempotentSubmit(idempotencyKey, input);
+        }
+        return {
+            ok: false,
+            errorCode: 'InputValidationFailed',
+            errorClass: 'manual',
+            errorMessage: "Feishu IM effect input must include either 'chatId' (send) or 'rootMessageId' (reply)",
+            evidence: { source: 'idempotentSubmit', reason: 'unknown_feishu_im_input' },
+        };
+    },
+};
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=feishu-im.js.map

package/dist/workflows/hostExecutors/feishu-im.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feishu-im.js","sourceRoot":"","sources":["../../../src/workflows/hostExecutors/feishu-im.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAExD;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAuB;IACpD,QAAQ,EAAE,WAAW;IACrB,mBAAmB,EAAE,IAAI;IAEzB,cAAc,CAAC,KAAK;QAClB,oEAAoE;QACpE,iEAAiE;QACjE,iDAAiD;QACjD,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC,EAAE,CAAC;YACpF,OAAO,qBAAqB,CAAC,cAAe,CAAC,KAAK,CAAC,CAAC;QACtD,CAAC;QACD,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC7E,OAAO,oBAAoB,CAAC,cAAe,CAAC,KAAK,CAAC,CAAC;QACrD,CAAC;QACD,kEAAkE;QAClE,gEAAgE;QAChE,yDAAyD;QACzD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,cAAc,EAAE,KAAK;QAC1C,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC,EAAE,CAAC;YACpF,OAAO,qBAAqB,CAAC,gBAAiB,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;YAC7E,OAAO,oBAAoB,CAAC,gBAAiB,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;QACvE,CAAC;QACD,OAAO;YACL,EAAE,EAAE,KAAK;YACT,SAAS,EAAE,uBAAuB;YAClC,UAAU,EAAE,QAAQ;YACpB,YAAY,EACV,uFAAuF;YACzF,QAAQ,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,yBAAyB,EAAE;SAC5E,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/workflows/hostExecutors/feishu-reply.d.ts

@@ -0,0 +1,24 @@
+import type { ProviderReconciler } from '../resume.js';
+import type { SideEffectingExecutor } from './types.js';
+export type FeishuReplyInput = {
+    larkAppId: string;
+    /** Parent message id (om_xxx) being replied to. */
+    rootMessageId: string;
+    content: string;
+    msgType?: string;
+    replyInThread?: boolean;
+};
+export type FeishuReplyOutput = {
+    messageId: string;
+};
+export declare function parseFeishuReplyInput(input: unknown): FeishuReplyInput;
+/**
+ * `feishu-reply` is similar to `feishu-send` but the canonical input
+ * additionally pins `rootMessageId` — spike Test 3c proved that Feishu
+ * uuid dedupe IGNORES `parent_id` mismatches, so we must lock the parent
+ * into the inputHash; otherwise a retry against a different parent would
+ * silently land on the original parent.
+ */
+export declare const feishuReplyExecutor: SideEffectingExecutor<FeishuReplyInput, FeishuReplyOutput>;
+export declare const feishuReplyReconciler: ProviderReconciler;
+//# sourceMappingURL=feishu-reply.d.ts.map

package/dist/workflows/hostExecutors/feishu-reply.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feishu-reply.d.ts","sourceRoot":"","sources":["../../../src/workflows/hostExecutors/feishu-reply.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGxD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAUF,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAEtE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,EAAE,qBAAqB,CAAC,gBAAgB,EAAE,iBAAiB,CA8B1F,CAAC;AAEF,eAAO,MAAM,qBAAqB,EAAE,kBAsCnC,CAAC"}

package/dist/workflows/hostExecutors/feishu-reply.js

@@ -0,0 +1,88 @@
+import { z } from 'zod';
+import { replyMessage } from '../../im/lark/client.js';
+import { PROVIDER_TTL_MS } from '../events/schema.js';
+import { classifyFeishuError } from './feishu-send.js';
+const FeishuReplyInputSchema = z.object({
+    larkAppId: z.string().min(1),
+    rootMessageId: z.string().min(1),
+    content: z.string(),
+    msgType: z.string().min(1).optional(),
+    replyInThread: z.boolean().optional(),
+}).strict();
+export function parseFeishuReplyInput(input) {
+    return FeishuReplyInputSchema.parse(input);
+}
+/**
+ * `feishu-reply` is similar to `feishu-send` but the canonical input
+ * additionally pins `rootMessageId` — spike Test 3c proved that Feishu
+ * uuid dedupe IGNORES `parent_id` mismatches, so we must lock the parent
+ * into the inputHash; otherwise a retry against a different parent would
+ * silently land on the original parent.
+ */
+export const feishuReplyExecutor = {
+    provider: 'feishu-im',
+    idempotencyTtlMs: PROVIDER_TTL_MS['feishu-im'],
+    canonicalInput(input) {
+        return {
+            root_message_id: input.rootMessageId,
+            msg_type: input.msgType ?? 'text',
+            content: input.content,
+            reply_in_thread: input.replyInThread ?? false,
+            larkAppId: input.larkAppId,
+        };
+    },
+    async invoke(input, idempotencyKey) {
+        const messageId = await replyMessage(input.larkAppId, input.rootMessageId, input.content, input.msgType ?? 'text', input.replyInThread ?? false, idempotencyKey);
+        return {
+            output: { messageId },
+            externalRefs: { messageId },
+        };
+    },
+    classifyError: classifyFeishuError,
+};
+export const feishuReplyReconciler = {
+    provider: 'feishu-im',
+    requiresEffectInput: true,
+    canonicalInput(input) {
+        return feishuReplyExecutor.canonicalInput(input);
+    },
+    async idempotentSubmit(idempotencyKey, input) {
+        let parsed;
+        try {
+            parsed = parseFeishuReplyInput(input);
+        }
+        catch (err) {
+            return {
+                ok: false,
+                errorCode: 'InputValidationFailed',
+                errorClass: 'manual',
+                errorMessage: err instanceof Error ? err.message : String(err),
+                evidence: { source: 'idempotentSubmit', reason: 'invalid_effect_input' },
+            };
+        }
+        try {
+            const { externalRefs } = await feishuReplyExecutor.invoke(parsed, idempotencyKey);
+            return {
+                ok: true,
+                externalRefs,
+                evidence: { source: 'idempotentSubmit', externalRefs },
+            };
+        }
+        catch (err) {
+            const classification = classifyFeishuError(err) ?? defaultFeishuClassification(err);
+            return {
+                ok: false,
+                ...classification,
+                evidence: { source: 'idempotentSubmit' },
+            };
+        }
+    },
+};
+function defaultFeishuClassification(err) {
+    return {
+        errorCode: 'UnknownProviderError',
+        errorClass: 'manual',
+        errorMessage: err instanceof Error ? err.message : String(err),
+    };
+}
+//# sourceMappingURL=feishu-reply.js.map

package/dist/workflows/hostExecutors/feishu-reply.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feishu-reply.js","sourceRoot":"","sources":["../../../src/workflows/hostExecutors/feishu-reply.ts"],"names":[],"mappings":"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"}

package/dist/workflows/hostExecutors/feishu-send.d.ts

@@ -0,0 +1,23 @@
+import type { ProviderReconciler } from '../resume.js';
+import type { ExecutorErrorClassification, SideEffectingExecutor } from './types.js';
+/**
+ * Input for the `feishu-send` hostExecutor.  Mirrors the surface area of
+ * `client.sendMessage`; the canonical hash covers every field that
+ * participates in the external effect (spike report §1.5 / events doc
+ * v0.1.2 §3.2).
+ */
+export type FeishuSendInput = {
+    larkAppId: string;
+    chatId: string;
+    content: string;
+    /** Defaults to 'text'. */
+    msgType?: string;
+};
+export type FeishuSendOutput = {
+    messageId: string;
+};
+export declare function parseFeishuSendInput(input: unknown): FeishuSendInput;
+export declare const feishuSendExecutor: SideEffectingExecutor<FeishuSendInput, FeishuSendOutput>;
+export declare const feishuSendReconciler: ProviderReconciler;
+export declare function classifyFeishuError(err: unknown): ExecutorErrorClassification | null;
+//# sourceMappingURL=feishu-send.d.ts.map

package/dist/workflows/hostExecutors/feishu-send.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feishu-send.d.ts","sourceRoot":"","sources":["../../../src/workflows/hostExecutors/feishu-send.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EACV,2BAA2B,EAC3B,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AASF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,eAAe,CAEpE;AAED,eAAO,MAAM,kBAAkB,EAAE,qBAAqB,CAAC,eAAe,EAAE,gBAAgB,CAqCvF,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,kBAsClC,CAAC;AAIF,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,GAAG,2BAA2B,GAAG,IAAI,CAuCpF"}

package/dist/workflows/hostExecutors/feishu-send.js

@@ -0,0 +1,124 @@
+import { z } from 'zod';
+import { sendMessage, MessageWithdrawnError } from '../../im/lark/client.js';
+import { PROVIDER_TTL_MS } from '../events/schema.js';
+const FeishuSendInputSchema = z.object({
+    larkAppId: z.string().min(1),
+    chatId: z.string().min(1),
+    content: z.string(),
+    msgType: z.string().min(1).optional(),
+}).strict();
+export function parseFeishuSendInput(input) {
+    return FeishuSendInputSchema.parse(input);
+}
+export const feishuSendExecutor = {
+    provider: 'feishu-im',
+    idempotencyTtlMs: PROVIDER_TTL_MS['feishu-im'],
+    canonicalInput(input) {
+        return {
+            // receive_id + receive_id_type fully identify the destination.  We
+            // pin receive_id_type to 'chat_id' because that's all
+            // `client.sendMessage` supports today; future variants would extend
+            // this canonical shape.
+            receive_id: input.chatId,
+            receive_id_type: 'chat_id',
+            msg_type: input.msgType ?? 'text',
+            content: input.content,
+            // larkAppId is part of "who sends" — different bots writing the
+            // same content to the same chat are distinct effects.
+            larkAppId: input.larkAppId,
+        };
+    },
+    async invoke(input, idempotencyKey) {
+        const messageId = await sendMessage(input.larkAppId, input.chatId, input.content, input.msgType ?? 'text', idempotencyKey);
+        return {
+            output: { messageId },
+            externalRefs: { messageId },
+        };
+    },
+    classifyError(err) {
+        return classifyFeishuError(err);
+    },
+};
+export const feishuSendReconciler = {
+    provider: 'feishu-im',
+    requiresEffectInput: true,
+    canonicalInput(input) {
+        return feishuSendExecutor.canonicalInput(input);
+    },
+    async idempotentSubmit(idempotencyKey, input) {
+        let parsed;
+        try {
+            parsed = parseFeishuSendInput(input);
+        }
+        catch (err) {
+            return {
+                ok: false,
+                errorCode: 'InputValidationFailed',
+                errorClass: 'manual',
+                errorMessage: err instanceof Error ? err.message : String(err),
+                evidence: { source: 'idempotentSubmit', reason: 'invalid_effect_input' },
+            };
+        }
+        try {
+            const { externalRefs } = await feishuSendExecutor.invoke(parsed, idempotencyKey);
+            return {
+                ok: true,
+                externalRefs,
+                evidence: { source: 'idempotentSubmit', externalRefs },
+            };
+        }
+        catch (err) {
+            const classification = classifyFeishuError(err) ?? defaultFeishuClassification(err);
+            return {
+                ok: false,
+                ...classification,
+                evidence: { source: 'idempotentSubmit' },
+            };
+        }
+    },
+};
+// ─── Error classification (shared with feishu-reply) ────────────────────────
+export function classifyFeishuError(err) {
+    if (err instanceof MessageWithdrawnError) {
+        return {
+            errorCode: 'UnknownProviderError',
+            // Withdrawn message means the parent or target is gone — the user
+            // would need to retarget (effectively manual).  Could be refined
+            // to a dedicated WithdrawnTarget code later.
+            errorClass: 'manual',
+            errorMessage: err.message,
+        };
+    }
+    if (err instanceof Error) {
+        const status = err?.response?.status ?? err?.status;
+        const code = err?.response?.data?.code ?? err?.code;
+        // Rate-limited
+        if (status === 429 || code === 99991663 /* feishu rate-limited */) {
+            return {
+                errorCode: 'ProviderRateLimited',
+                errorClass: 'retryable',
+                errorMessage: err.message,
+            };
+        }
+        // Generic network — connection refused / DNS / 5xx
+        if (status >= 500 ||
+            /ECONNREFUSED|ETIMEDOUT|EHOSTUNREACH|ENOTFOUND|getaddrinfo/i.test(err.message)) {
+            return {
+                errorCode: 'NetworkError',
+                errorClass: 'retryable',
+                errorMessage: err.message,
+            };
+        }
+    }
+    // Unknown — fall through to protocol default (UnknownProviderError /
+    // manual) by returning null.
+    return null;
+}
+function defaultFeishuClassification(err) {
+    return {
+        errorCode: 'UnknownProviderError',
+        errorClass: 'manual',
+        errorMessage: err instanceof Error ? err.message : String(err),
+    };
+}
+//# sourceMappingURL=feishu-send.js.map

package/dist/workflows/hostExecutors/feishu-send.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feishu-send.js","sourceRoot":"","sources":["../../../src/workflows/hostExecutors/feishu-send.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAyBtD,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;CACtC,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,qBAAqB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAA6D;IAC1F,QAAQ,EAAE,WAAW;IACrB,gBAAgB,EAAE,eAAe,CAAC,WAAW,CAAC;IAE9C,cAAc,CAAC,KAAK;QAClB,OAAO;YACL,mEAAmE;YACnE,sDAAsD;YACtD,oEAAoE;YACpE,wBAAwB;YACxB,UAAU,EAAE,KAAK,CAAC,MAAM;YACxB,eAAe,EAAE,SAAS;YAC1B,QAAQ,EAAE,KAAK,CAAC,OAAO,IAAI,MAAM;YACjC,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,gEAAgE;YAChE,sDAAsD;YACtD,SAAS,EAAE,KAAK,CAAC,SAAS;SAC3B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,cAAc;QAChC,MAAM,SAAS,GAAG,MAAM,WAAW,CACjC,KAAK,CAAC,SAAS,EACf,KAAK,CAAC,MAAM,EACZ,KAAK,CAAC,OAAO,EACb,KAAK,CAAC,OAAO,IAAI,MAAM,EACvB,cAAc,CACf,CAAC;QACF,OAAO;YACL,MAAM,EAAE,EAAE,SAAS,EAAE;YACrB,YAAY,EAAE,EAAE,SAAS,EAAE;SAC5B,CAAC;IACJ,CAAC;IAED,aAAa,CAAC,GAAG;QACf,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC;IAClC,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAuB;IACtD,QAAQ,EAAE,WAAW;IACrB,mBAAmB,EAAE,IAAI;IAEzB,cAAc,CAAC,KAAK;QAClB,OAAO,kBAAkB,CAAC,cAAc,CAAC,KAAwB,CAAC,CAAC;IACrE,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,cAAc,EAAE,KAAK;QAC1C,IAAI,MAAuB,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,SAAS,EAAE,uBAAuB;gBAClC,UAAU,EAAE,QAAQ;gBACpB,YAAY,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;gBAC9D,QAAQ,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,MAAM,EAAE,sBAAsB,EAAE;aACzE,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,kBAAkB,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;YACjF,OAAO;gBACL,EAAE,EAAE,IAAI;gBACR,YAAY;gBACZ,QAAQ,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,YAAY,EAAE;aACvD,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,cAAc,GAAG,mBAAmB,CAAC,GAAG,CAAC,IAAI,2BAA2B,CAAC,GAAG,CAAC,CAAC;YACpF,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,GAAG,cAAc;gBACjB,QAAQ,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;aACzC,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC;AAEF,+EAA+E;AAE/E,MAAM,UAAU,mBAAmB,CAAC,GAAY;IAC9C,IAAI,GAAG,YAAY,qBAAqB,EAAE,CAAC;QACzC,OAAO;YACL,SAAS,EAAE,sBAAsB;YACjC,kEAAkE;YAClE,iEAAiE;YACjE,6CAA6C;YAC7C,UAAU,EAAE,QAAQ;YACpB,YAAY,EAAE,GAAG,CAAC,OAAO;SAC1B,CAAC;IACJ,CAAC;IAED,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QACzB,MAAM,MAAM,GAAI,GAAW,EAAE,QAAQ,EAAE,MAAM,IAAK,GAAW,EAAE,MAAM,CAAC;QACtE,MAAM,IAAI,GAAI,GAAW,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,IAAK,GAAW,EAAE,IAAI,CAAC;QAEtE,eAAe;QACf,IAAI,MAAM,KAAK,GAAG,IAAI,IAAI,KAAK,QAAQ,CAAC,yBAAyB,EAAE,CAAC;YAClE,OAAO;gBACL,SAAS,EAAE,qBAAqB;gBAChC,UAAU,EAAE,WAAW;gBACvB,YAAY,EAAE,GAAG,CAAC,OAAO;aAC1B,CAAC;QACJ,CAAC;QACD,mDAAmD;QACnD,IACE,MAAM,IAAI,GAAG;YACb,4DAA4D,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAC9E,CAAC;YACD,OAAO;gBACL,SAAS,EAAE,cAAc;gBACzB,UAAU,EAAE,WAAW;gBACvB,YAAY,EAAE,GAAG,CAAC,OAAO;aAC1B,CAAC;QACJ,CAAC;IACH,CAAC;IACD,qEAAqE;IACrE,6BAA6B;IAC7B,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,2BAA2B,CAAC,GAAY;IAC/C,OAAO;QACL,SAAS,EAAE,sBAAsB;QACjC,UAAU,EAAE,QAAQ;QACpB,YAAY,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;KAC/D,CAAC;AACJ,CAAC"}

package/dist/workflows/hostExecutors/index.d.ts

@@ -0,0 +1,8 @@
+export * from './types.js';
+export * from './protocol.js';
+export * from './feishu-send.js';
+export * from './feishu-reply.js';
+export * from './feishu-im.js';
+export * from './botmux-schedule.js';
+export * from './registry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/workflows/hostExecutors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/workflows/hostExecutors/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC"}

package/dist/workflows/hostExecutors/index.js

@@ -0,0 +1,8 @@
+export * from './types.js';
+export * from './protocol.js';
+export * from './feishu-send.js';
+export * from './feishu-reply.js';
+export * from './feishu-im.js';
+export * from './botmux-schedule.js';
+export * from './registry.js';
+//# sourceMappingURL=index.js.map

package/dist/workflows/hostExecutors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/workflows/hostExecutors/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC"}

package/dist/workflows/hostExecutors/protocol.d.ts

@@ -0,0 +1,42 @@
+import type { ActivityFailedEvent, ActivitySucceededEvent } from '../events/types.js';
+import type { ExecutorErrorClassification, HostExecutorContext, SideEffectingExecutor } from './types.js';
+export type SideEffectingResult<Output> = {
+    ok: true;
+    event: ActivitySucceededEvent;
+    output: Output;
+    externalRefs: Record<string, unknown>;
+} | {
+    ok: false;
+    event: ActivityFailedEvent;
+    error: ExecutorErrorClassification;
+};
+/**
+ * Drive the side-effecting protocol for one attempt (events doc v0.1.2
+ * §2.3, §4.3).  Writes three events in order:
+ *
+ *   1. `effectAttempted` — written **before** invoking the provider so a
+ *      crash mid-call leaves a dangling intent that resume can reconcile.
+ *   2. provider invocation (via `executor.invoke`).
+ *   3. `activitySucceeded` OR `activityFailed` — terminal event for this
+ *      attempt; carries `externalRefs` on success or classified error on
+ *      failure.
+ *
+ * The protocol does NOT write `attemptCreated/leaseSigned/activityRunning`
+ * — those are the scheduler/worker layer's responsibility.  This function
+ * assumes the caller has already advanced the activity to `running`.
+ *
+ * The protocol does NOT do retry/backoff — that's the scheduler's job
+ * (Step 7+).  A failed invocation is reported via `ok: false` and the
+ * caller decides whether to spawn a new `attemptCreated`.
+ *
+ * Idempotency contract:
+ *   - `idempotencyKey` is deterministic per attempt (5-tuple hash), so
+ *     re-running the same attempt with the same input produces the same
+ *     uuid → Feishu/schedule provider returns the original ref.
+ *   - `inputHash` is recorded for the resume path to detect attempt
+ *     mutability violations (Step 7).  This function doesn't enforce
+ *     immutability across calls — Step 7 reads recorded inputHash and
+ *     fails if a future attempt re-derives a different one.
+ */
+export declare function executeSideEffect<I, O>(ctx: HostExecutorContext, input: I, executor: SideEffectingExecutor<I, O>): Promise<SideEffectingResult<O>>;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/workflows/hostExecutors/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/workflows/hostExecutors/protocol.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,mBAAmB,EACnB,sBAAsB,EAEvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAI1G,MAAM,MAAM,mBAAmB,CAAC,MAAM,IAClC;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,sBAAsB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAClG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,mBAAmB,CAAC;IAAC,KAAK,EAAE,2BAA2B,CAAA;CAAE,CAAC;AAIlF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EAAE,CAAC,EAC1C,GAAG,EAAE,mBAAmB,EACxB,KAAK,EAAE,CAAC,EACR,QAAQ,EAAE,qBAAqB,CAAC,CAAC,EAAE,CAAC,CAAC,GACpC,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAwFjC"}