botmux 2.33.0 → 2.33.1

package/dist/workflows/events/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/workflows/events/schema.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAAmD,CAAC;AAE5E,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AACxD,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;AAItD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAS7E;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAiBjF;AAED;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,aAAa,GAAG,MAAM,GAAG,IAAI,CAWnF;AAiCD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CAKtD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,OAAO,GAEV;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE,GACtC;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAA;CAAE,CAMxC;AAID;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,OAAO,CAAC;AAE7C;;;;;GAKG;AACH,eAAO,MAAM,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGlD,CAAC;AAIF,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/workflows/events/schema.js

@@ -0,0 +1,295 @@
+import { z } from 'zod';
+import { ActorEnum, Sha256Schema, Sha256Pattern, RunCreatedPayload, RunStartedPayload, RunSucceededPayload, RunFailedPayload, RunCanceledPayload, NodeWaitingPayload, NodeRetryingPayload, NodeSucceededPayload, NodeFailedPayload, NodeSkippedPayload, NodeCanceledPayload, ActivityRunningPayload, ActivityWaitingPayload, ActivityTimedOutPayload, ConditionEvaluatedPayload, LeaseSignedPayload, AttemptCreatedPayload, BackoffScheduledPayload, BackoffElapsedPayload, EffectAttemptedPayload, ActivitySucceededPayload, ActivityFailedPayload, WaitCreatedPayload, WaitResolvedPayload, WaitDeadlineExceededPayload, CancelRequestedPayload, CancelDeliveredPayload, ActivityCanceledPayload, WorkerLostPayload, ResumeStartedPayload, ReconcileResultPayload, } from './payloads.js';
+// ─── Payload ref / inline ───────────────────────────────────────────────────
+export const PayloadRefSchema = z.object({
+    ref: z.string().min(1),
+    bytes: z.number().int().positive(),
+    schemaVersion: z.number().int().positive(),
+});
+export function isPayloadRef(p) {
+    return (typeof p === 'object' &&
+        p !== null &&
+        'ref' in p &&
+        'bytes' in p &&
+        'schemaVersion' in p &&
+        !('eventId' in p) // sanity: payload object, not envelope
+    );
+}
+// ─── Envelope ───────────────────────────────────────────────────────────────
+// eventId = `<runId>-<seq>`, seq is a positive integer.  We allow runIds that
+// contain dashes themselves (uuidv4/uuidv7 do), so the format check only
+// asserts: must end with `-<positive-integer>`.
+export const EventIdSchema = z
+    .string()
+    .regex(/^.+-[1-9]\d*$/, 'eventId must be <runId>-<seq> with positive integer seq');
+const EnvelopeBase = {
+    eventId: EventIdSchema,
+    runId: z.string().min(1),
+    timestamp: z.number().int().positive(),
+    schemaVersion: z.literal(1),
+    actor: ActorEnum,
+    payloadHash: z.string().regex(Sha256Pattern).optional(),
+};
+/**
+ * Build a single event schema by wrapping the envelope around a literal
+ * `type` and the type's payload schema.  The payload can be inline (the
+ * payload zod object) OR a ref to a blob file when it exceeds the inline
+ * size cap (see INLINE_PAYLOAD_MAX_BYTES below).
+ *
+ * Note the generic constraint `L extends string`: without it, callers
+ * passing `'runCreated'` would have the literal widened to `string`, which
+ * destroys discriminator narrowing on `z.infer<>` and breaks exhaustive
+ * `switch (e.type)` checks downstream (replay, dispatchers, etc.).
+ */
+function event(typeLiteral, payloadSchema) {
+    return z.object({
+        ...EnvelopeBase,
+        type: z.literal(typeLiteral),
+        payload: z.union([payloadSchema, PayloadRefSchema]),
+    });
+}
+// ─── The 31 event schemas ───────────────────────────────────────────────────
+// Group 1 — Lifecycle (14)
+export const RunCreatedEventSchema = event('runCreated', RunCreatedPayload);
+export const RunStartedEventSchema = event('runStarted', RunStartedPayload);
+export const RunSucceededEventSchema = event('runSucceeded', RunSucceededPayload);
+export const RunFailedEventSchema = event('runFailed', RunFailedPayload);
+export const RunCanceledEventSchema = event('runCanceled', RunCanceledPayload);
+export const NodeWaitingEventSchema = event('nodeWaiting', NodeWaitingPayload);
+export const NodeRetryingEventSchema = event('nodeRetrying', NodeRetryingPayload);
+export const NodeSucceededEventSchema = event('nodeSucceeded', NodeSucceededPayload);
+export const NodeFailedEventSchema = event('nodeFailed', NodeFailedPayload);
+export const NodeSkippedEventSchema = event('nodeSkipped', NodeSkippedPayload);
+export const NodeCanceledEventSchema = event('nodeCanceled', NodeCanceledPayload);
+export const ActivityRunningEventSchema = event('activityRunning', ActivityRunningPayload);
+export const ActivityWaitingEventSchema = event('activityWaiting', ActivityWaitingPayload);
+export const ActivityTimedOutEventSchema = event('activityTimedOut', ActivityTimedOutPayload);
+// Group 2 — Scheduling (5)
+export const ConditionEvaluatedEventSchema = event('conditionEvaluated', ConditionEvaluatedPayload);
+export const LeaseSignedEventSchema = event('leaseSigned', LeaseSignedPayload);
+export const AttemptCreatedEventSchema = event('attemptCreated', AttemptCreatedPayload);
+export const BackoffScheduledEventSchema = event('backoffScheduled', BackoffScheduledPayload);
+export const BackoffElapsedEventSchema = event('backoffElapsed', BackoffElapsedPayload);
+// Group 3 — Side Effect (3)
+export const EffectAttemptedEventSchema = event('effectAttempted', EffectAttemptedPayload);
+export const ActivitySucceededEventSchema = event('activitySucceeded', ActivitySucceededPayload);
+export const ActivityFailedEventSchema = event('activityFailed', ActivityFailedPayload);
+// Group 4 — Wait / Human (3)
+export const WaitCreatedEventSchema = event('waitCreated', WaitCreatedPayload);
+export const WaitResolvedEventSchema = event('waitResolved', WaitResolvedPayload);
+export const WaitDeadlineExceededEventSchema = event('waitDeadlineExceeded', WaitDeadlineExceededPayload);
+// Group 5 — Control (3)
+export const CancelRequestedEventSchema = event('cancelRequested', CancelRequestedPayload);
+export const CancelDeliveredEventSchema = event('cancelDelivered', CancelDeliveredPayload);
+export const ActivityCanceledEventSchema = event('activityCanceled', ActivityCanceledPayload);
+// Group 6 — System / Recovery (3)
+export const WorkerLostEventSchema = event('workerLost', WorkerLostPayload);
+export const ResumeStartedEventSchema = event('resumeStarted', ResumeStartedPayload);
+export const ReconcileResultEventSchema = event('reconcileResult', ReconcileResultPayload);
+// ─── Discriminated union over all 31 ────────────────────────────────────────
+const EVENT_SCHEMAS = [
+    RunCreatedEventSchema,
+    RunStartedEventSchema,
+    RunSucceededEventSchema,
+    RunFailedEventSchema,
+    RunCanceledEventSchema,
+    NodeWaitingEventSchema,
+    NodeRetryingEventSchema,
+    NodeSucceededEventSchema,
+    NodeFailedEventSchema,
+    NodeSkippedEventSchema,
+    NodeCanceledEventSchema,
+    ActivityRunningEventSchema,
+    ActivityWaitingEventSchema,
+    ActivityTimedOutEventSchema,
+    ConditionEvaluatedEventSchema,
+    LeaseSignedEventSchema,
+    AttemptCreatedEventSchema,
+    BackoffScheduledEventSchema,
+    BackoffElapsedEventSchema,
+    EffectAttemptedEventSchema,
+    ActivitySucceededEventSchema,
+    ActivityFailedEventSchema,
+    WaitCreatedEventSchema,
+    WaitResolvedEventSchema,
+    WaitDeadlineExceededEventSchema,
+    CancelRequestedEventSchema,
+    CancelDeliveredEventSchema,
+    ActivityCanceledEventSchema,
+    WorkerLostEventSchema,
+    ResumeStartedEventSchema,
+    ReconcileResultEventSchema,
+];
+/**
+ * The discriminated union over all 31 event types — pure, no refinements.
+ *
+ * Why pure: zod's `.superRefine` wraps the union in `ZodEffects`, which
+ * breaks `z.infer<>` narrowing on the discriminator at compile time
+ * (`switch (e.type)` won't exhaustively narrow).  The payloadHash
+ * invariant (events doc §1.1) lives in `parseEvent` / `safeParseEvent`
+ * instead, applied as a post-parse check.
+ */
+export const EventSchema = z.discriminatedUnion('type', [...EVENT_SCHEMAS]);
+// ─── payloadHash invariant + canonical parse helpers ────────────────────────
+/**
+ * Check the payloadHash <-> payload-ref invariant from events doc §1.1:
+ *   - inline payload: payloadHash MUST be absent
+ *   - ref payload:    payloadHash MUST be present
+ *
+ * Returns `null` if the event respects the invariant; otherwise a human
+ * readable reason string.  Pure function — no side effects, no throws.
+ */
+export function checkPayloadHashInvariant(event) {
+    const isRef = isPayloadRef(event.payload);
+    if (isRef && !event.payloadHash) {
+        return 'payloadHash required when payload is a ref';
+    }
+    if (!isRef && event.payloadHash !== undefined) {
+        return 'payloadHash must be absent when payload is inline';
+    }
+    return null;
+}
+/**
+ * `reconcileResult.capability` × `decision` legal combinations (events
+ * doc v0.1.2 §4.3.1 — table updated per spec freeze; the codex round 4
+ * variant of this invariant pinned `completedByIdempotentSubmit` to
+ * `idempotentSubmit` only, but the spec explicitly allows the
+ * `readOnlyLookup → found → completedByIdempotentSubmit` path for
+ * schedule, so we widen accordingly):
+ *
+ *   | decision                       | allowed capability        |
+ *   |--------------------------------|---------------------------|
+ *   | replayed                       | none                      |
+ *   | completedByIdempotentSubmit    | readOnlyLookup OR         |
+ *   |                                |   idempotentSubmit        |
+ *   | freshRetry                     | readOnlyLookup            |
+ *   | manual                         | any                       |
+ *
+ * Rationale:
+ *   - `replayed` means the event log already had a terminal — resume
+ *     scans the log, no provider call, capability is `none`.
+ *   - `completedByIdempotentSubmit` covers BOTH "ROL found the effect"
+ *     (schedule case) and "IS re-submit returned the original ref"
+ *     (Feishu case).  The `capability` field disambiguates which path
+ *     was taken; the decision name reflects the outcome.
+ *   - `freshRetry` requires `readOnlyLookup`: the only way to confirm
+ *     "provider definitely doesn't have it, safe to retry" is a
+ *     side-effect-free read.  IS by itself cannot produce freshRetry —
+ *     a re-submit either lands or fails, no "definitely-not-yet" state.
+ *   - `manual` is the catch-all; capability records what was tried.
+ *
+ * Returns `null` if legal, otherwise a reason string.
+ */
+export function checkReconcileResultInvariant(event) {
+    if (event.type !== 'reconcileResult')
+        return null;
+    if (isPayloadRef(event.payload))
+        return null; // can't inspect ref payload
+    const { capability, decision } = event.payload;
+    const allowed = {
+        replayed: ['none'],
+        completedByIdempotentSubmit: ['readOnlyLookup', 'idempotentSubmit'],
+        freshRetry: ['readOnlyLookup'],
+        manual: ['none', 'readOnlyLookup', 'idempotentSubmit'],
+    };
+    if (!allowed[decision].includes(capability)) {
+        return `reconcileResult: decision='${decision}' requires capability ∈ {${allowed[decision].join(', ')}}, got '${capability}'`;
+    }
+    return null;
+}
+/**
+ * `waitCreated` shape invariant: `prompt` (inline) and `promptRef` (blob
+ * spill) are mutually exclusive, and any spill MUST carry `promptPreview`
+ * so cards / dashboard can render without reading the blob file.
+ *
+ * Schema keeps `prompt` as `z.string().optional()` (no `.max()`) so that
+ * historical events with multi-KB inline prompts still parse / replay.
+ * The producer (runtime.dispatchGate) is responsible for the 1024-byte
+ * split policy.
+ */
+export function checkWaitCreatedPromptInvariant(event) {
+    if (event.type !== 'waitCreated')
+        return null;
+    if (isPayloadRef(event.payload))
+        return null; // ref payloads opaque here
+    const p = event.payload;
+    if (p.prompt !== undefined && p.promptRef !== undefined) {
+        return 'waitCreated: prompt and promptRef are mutually exclusive';
+    }
+    if (p.promptRef !== undefined && p.promptPreview === undefined) {
+        return 'waitCreated: promptRef requires promptPreview for card / dashboard display';
+    }
+    return null;
+}
+/**
+ * Run every post-parse invariant against a WorkflowEvent.  Each entry is
+ * a `(event) => string | null` checker; the first failure wins and gets
+ * surfaced as a ZodIssue.  Adding new invariants here means they apply
+ * uniformly to parseEvent / safeParseEvent / append paths.
+ */
+const POST_PARSE_INVARIANTS = [
+    { path: ['payloadHash'], check: checkPayloadHashInvariant },
+    { path: ['payload'], check: checkReconcileResultInvariant },
+    { path: ['payload'], check: checkWaitCreatedPromptInvariant },
+];
+function applyInvariants(event) {
+    for (const { path, check } of POST_PARSE_INVARIANTS) {
+        const reason = check(event);
+        if (reason) {
+            return new z.ZodError([
+                {
+                    code: z.ZodIssueCode.custom,
+                    path,
+                    message: reason,
+                },
+            ]);
+        }
+    }
+    return null;
+}
+/**
+ * Parse + validate an unknown value as a WorkflowEvent.  Combines the
+ * discriminated-union schema check with the post-parse invariants
+ * (payloadHash, reconcileResult capability×decision).  Throws ZodError
+ * on failure.
+ */
+export function parseEvent(raw) {
+    const event = EventSchema.parse(raw);
+    const err = applyInvariants(event);
+    if (err)
+        throw err;
+    return event;
+}
+/**
+ * Safe variant of `parseEvent`: returns a result object instead of throwing.
+ * Mirrors `ZodType.safeParse` API for ergonomic call sites.
+ */
+export function safeParseEvent(raw) {
+    const parsed = EventSchema.safeParse(raw);
+    if (!parsed.success)
+        return { success: false, error: parsed.error };
+    const err = applyInvariants(parsed.data);
+    if (err)
+        return { success: false, error: err };
+    return { success: true, data: parsed.data };
+}
+// ─── Constants ──────────────────────────────────────────────────────────────
+/**
+ * Inline payload size cap.  Payloads larger than this must be written as a
+ * content-addressed blob and referenced via `PayloadRef`.  v0 value is a
+ * pragmatic default; verify and tune after dogfooding (see events doc §6.2).
+ */
+export const INLINE_PAYLOAD_MAX_BYTES = 4096;
+/**
+ * Per-provider TTL (ms) within which `idempotentSubmit` is safe.  Used by
+ * the reconcile path to decide whether a dangling `effectAttempted` can
+ * still be safely retried with the same uuid.  Feishu's documented uuid
+ * dedupe window is 1 hour (spike report §1.2).
+ */
+export const PROVIDER_TTL_MS = {
+    'feishu-im': 60 * 60 * 1000,
+    'botmux-schedule': Number.MAX_SAFE_INTEGER, // schedule entry id is permanent
+};
+// ─── Re-export Sha256Schema for callers ─────────────────────────────────────
+export { Sha256Schema };
+//# sourceMappingURL=schema.js.map

package/dist/workflows/events/schema.js.map

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

package/dist/workflows/events/types.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import { RunCreatedEventSchema, RunStartedEventSchema, RunSucceededEventSchema, RunFailedEventSchema, RunCanceledEventSchema, NodeWaitingEventSchema, NodeRetryingEventSchema, NodeSucceededEventSchema, NodeFailedEventSchema, NodeSkippedEventSchema, NodeCanceledEventSchema, ActivityRunningEventSchema, ActivityWaitingEventSchema, ActivityTimedOutEventSchema, ConditionEvaluatedEventSchema, LeaseSignedEventSchema, AttemptCreatedEventSchema, BackoffScheduledEventSchema, BackoffElapsedEventSchema, EffectAttemptedEventSchema, ActivitySucceededEventSchema, ActivityFailedEventSchema, WaitCreatedEventSchema, WaitResolvedEventSchema, WaitDeadlineExceededEventSchema, CancelRequestedEventSchema, CancelDeliveredEventSchema, ActivityCanceledEventSchema, WorkerLostEventSchema, ResumeStartedEventSchema, ReconcileResultEventSchema } from './schema.js';
+export type RunCreatedEvent = z.infer<typeof RunCreatedEventSchema>;
+export type RunStartedEvent = z.infer<typeof RunStartedEventSchema>;
+export type RunSucceededEvent = z.infer<typeof RunSucceededEventSchema>;
+export type RunFailedEvent = z.infer<typeof RunFailedEventSchema>;
+export type RunCanceledEvent = z.infer<typeof RunCanceledEventSchema>;
+export type NodeWaitingEvent = z.infer<typeof NodeWaitingEventSchema>;
+export type NodeRetryingEvent = z.infer<typeof NodeRetryingEventSchema>;
+export type NodeSucceededEvent = z.infer<typeof NodeSucceededEventSchema>;
+export type NodeFailedEvent = z.infer<typeof NodeFailedEventSchema>;
+export type NodeSkippedEvent = z.infer<typeof NodeSkippedEventSchema>;
+export type NodeCanceledEvent = z.infer<typeof NodeCanceledEventSchema>;
+export type ActivityRunningEvent = z.infer<typeof ActivityRunningEventSchema>;
+export type ActivityWaitingEvent = z.infer<typeof ActivityWaitingEventSchema>;
+export type ActivityTimedOutEvent = z.infer<typeof ActivityTimedOutEventSchema>;
+export type ConditionEvaluatedEvent = z.infer<typeof ConditionEvaluatedEventSchema>;
+export type LeaseSignedEvent = z.infer<typeof LeaseSignedEventSchema>;
+export type AttemptCreatedEvent = z.infer<typeof AttemptCreatedEventSchema>;
+export type BackoffScheduledEvent = z.infer<typeof BackoffScheduledEventSchema>;
+export type BackoffElapsedEvent = z.infer<typeof BackoffElapsedEventSchema>;
+export type EffectAttemptedEvent = z.infer<typeof EffectAttemptedEventSchema>;
+export type ActivitySucceededEvent = z.infer<typeof ActivitySucceededEventSchema>;
+export type ActivityFailedEvent = z.infer<typeof ActivityFailedEventSchema>;
+export type WaitCreatedEvent = z.infer<typeof WaitCreatedEventSchema>;
+export type WaitResolvedEvent = z.infer<typeof WaitResolvedEventSchema>;
+export type WaitDeadlineExceededEvent = z.infer<typeof WaitDeadlineExceededEventSchema>;
+export type CancelRequestedEvent = z.infer<typeof CancelRequestedEventSchema>;
+export type CancelDeliveredEvent = z.infer<typeof CancelDeliveredEventSchema>;
+export type ActivityCanceledEvent = z.infer<typeof ActivityCanceledEventSchema>;
+export type WorkerLostEvent = z.infer<typeof WorkerLostEventSchema>;
+export type ResumeStartedEvent = z.infer<typeof ResumeStartedEventSchema>;
+export type ReconcileResultEvent = z.infer<typeof ReconcileResultEventSchema>;
+//# sourceMappingURL=types.d.ts.map

package/dist/workflows/events/types.d.ts.map

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

package/dist/workflows/events/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/workflows/events/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/workflows/events/types.ts"],"names":[],"mappings":""}

package/dist/workflows/fanout.d.ts

@@ -0,0 +1,36 @@
+import { EventLog } from './events/append.js';
+import type { WorkflowEvent } from './events/schema.js';
+import { type Snapshot } from './events/replay.js';
+import { type RunChatBinding } from './loader.js';
+export type WorkflowEventCallback = (event: WorkflowEvent) => void | Promise<void>;
+export type WorkflowEventWatcherOptions = {
+    runsDir?: string;
+    onError?: (err: unknown) => void;
+    pollIntervalMs?: number;
+    useFsWatch?: boolean;
+};
+export declare class WorkflowEventWatcher {
+    private readonly onNewEvent;
+    private readonly opts;
+    readonly runId: string;
+    readonly log: EventLog;
+    readonly ready: Promise<void>;
+    private watcher?;
+    private pollTimer?;
+    private lastSeq;
+    private draining;
+    private pendingDrain;
+    private closed;
+    constructor(runId: string, onNewEvent: WorkflowEventCallback, opts?: WorkflowEventWatcherOptions);
+    close(): void;
+    drain(): Promise<void>;
+    private start;
+}
+export type WorkflowFanoutDeps = {
+    runsDir?: string;
+    binding?: RunChatBinding;
+    snapshot?: Snapshot;
+    sendCard?: (larkAppId: string, chatId: string, cardJson: string, msgType: 'interactive') => Promise<string>;
+};
+export declare function handleWorkflowFanoutEvent(event: WorkflowEvent, deps?: WorkflowFanoutDeps): Promise<string | undefined>;
+//# sourceMappingURL=fanout.d.ts.map

package/dist/workflows/fanout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fanout.d.ts","sourceRoot":"","sources":["../../src/workflows/fanout.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAU,KAAK,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAI3D,OAAO,EAAsB,KAAK,cAAc,EAAE,MAAM,aAAa,CAAC;AAKtE,MAAM,MAAM,qBAAqB,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnF,MAAM,MAAM,2BAA2B,GAAG;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,qBAAa,oBAAoB;IAc7B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAdvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9B,OAAO,CAAC,OAAO,CAAC,CAAY;IAC5B,OAAO,CAAC,SAAS,CAAC,CAAiB;IACnC,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,MAAM,CAAS;gBAGrB,KAAK,EAAE,MAAM,EACI,UAAU,EAAE,qBAAqB,EACjC,IAAI,GAAE,2BAAgC;IAOzD,KAAK,IAAI,IAAI;IAQP,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YA+Bd,KAAK;CAgBpB;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,QAAQ,CAAC,EAAE,CACT,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,aAAa,KACnB,OAAO,CAAC,MAAM,CAAC,CAAC;CACtB,CAAC;AAEF,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,aAAa,EACpB,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAgB7B"}

package/dist/workflows/fanout.js

@@ -0,0 +1,114 @@
+import { existsSync } from 'node:fs';
+import { mkdir, writeFile } from 'node:fs/promises';
+import { dirname } from 'node:path';
+import { watch } from 'node:fs';
+import { EventLog } from './events/append.js';
+import { replay } from './events/replay.js';
+import { isPayloadRef } from './events/schema.js';
+import { getRunsDir } from './runs-dir.js';
+import { readRunChatBinding } from './loader.js';
+import { buildWorkflowApprovalCard } from '../im/lark/workflow-cards.js';
+import { sendMessage } from '../im/lark/client.js';
+import { logger } from '../utils/logger.js';
+export class WorkflowEventWatcher {
+    onNewEvent;
+    opts;
+    runId;
+    log;
+    ready;
+    watcher;
+    pollTimer;
+    lastSeq = 0;
+    draining = false;
+    pendingDrain = false;
+    closed = false;
+    constructor(runId, onNewEvent, opts = {}) {
+        this.onNewEvent = onNewEvent;
+        this.opts = opts;
+        this.runId = runId;
+        this.log = new EventLog(runId, opts.runsDir ?? getRunsDir());
+        this.ready = this.start();
+    }
+    close() {
+        this.closed = true;
+        this.watcher?.close();
+        this.watcher = undefined;
+        if (this.pollTimer)
+            clearInterval(this.pollTimer);
+        this.pollTimer = undefined;
+    }
+    async drain() {
+        if (this.closed)
+            return;
+        if (this.draining) {
+            this.pendingDrain = true;
+            return;
+        }
+        this.draining = true;
+        try {
+            do {
+                this.pendingDrain = false;
+                const events = await this.log.readAll();
+                for (const event of events) {
+                    const seq = eventSeq(event);
+                    if (seq <= this.lastSeq)
+                        continue;
+                    try {
+                        await this.onNewEvent(event);
+                    }
+                    catch (err) {
+                        this.opts.onError?.(err);
+                        // At-least-once delivery: do not advance the cursor when a
+                        // downstream card/send/update fails.  A later fs.watch event or
+                        // polling tick will retry the same event before newer events.
+                        return;
+                    }
+                    this.lastSeq = seq;
+                }
+            } while (this.pendingDrain && !this.closed);
+        }
+        finally {
+            this.draining = false;
+        }
+    }
+    async start() {
+        await mkdir(dirname(this.log.eventsFile), { recursive: true });
+        if (!existsSync(this.log.eventsFile)) {
+            await writeFile(this.log.eventsFile, '', { flag: 'a' });
+        }
+        this.lastSeq = await this.log.currentSeq();
+        if (this.opts.useFsWatch !== false) {
+            this.watcher = watch(this.log.eventsFile, { persistent: false }, () => {
+                void this.drain();
+            });
+        }
+        this.pollTimer = setInterval(() => {
+            void this.drain();
+        }, this.opts.pollIntervalMs ?? 5_000);
+        this.pollTimer.unref?.();
+    }
+}
+export async function handleWorkflowFanoutEvent(event, deps = {}) {
+    if (event.type !== 'waitCreated')
+        return undefined;
+    const waitEvent = event;
+    if (isPayloadRef(waitEvent.payload) || waitEvent.payload.waitKind !== 'human-gate') {
+        return undefined;
+    }
+    const runsDir = deps.runsDir ?? getRunsDir();
+    const binding = deps.binding ?? (await readRunChatBinding(event.runId, { runsDir }));
+    const snapshot = deps.snapshot ?? replay(await new EventLog(event.runId, runsDir).readAll());
+    const cardJson = buildWorkflowApprovalCard(waitEvent, snapshot);
+    const sendCard = deps.sendCard ?? defaultSendWorkflowCard;
+    const messageId = await sendCard(binding.larkAppId, binding.chatId, cardJson, 'interactive');
+    logger.info(`[workflow:${event.runId}] approval card sent to ${binding.chatId}: ${messageId}`);
+    return messageId;
+}
+async function defaultSendWorkflowCard(larkAppId, chatId, cardJson, msgType) {
+    return sendMessage(larkAppId, chatId, cardJson, msgType);
+}
+function eventSeq(event) {
+    const match = event.eventId.match(/-(\d+)$/);
+    return match ? Number(match[1]) : 0;
+}
+//# sourceMappingURL=fanout.js.map

package/dist/workflows/fanout.js.map

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

package/dist/workflows/hostExecutors/botmux-schedule.d.ts

@@ -0,0 +1,41 @@
+import type { ParsedSchedule } from '../../types.js';
+import type { ProviderReconciler } from '../resume.js';
+import type { SideEffectingExecutor } from './types.js';
+export type ScheduleInput = {
+    name: string;
+    schedule: string;
+    /** Pre-resolved schedule (parser output).  Required for relative
+     *  schedules (`30m`, `2h`, `明天9:00`) to keep canonical input frozen
+     *  against re-parse drift (codex round 4 finding 4). */
+    parsed: ParsedSchedule;
+    prompt: string;
+    workingDir: string;
+    chatId: string;
+    rootMessageId?: string;
+    scope?: 'thread' | 'chat';
+    larkAppId?: string;
+    /** `repeat.completed` is intentionally absent — it's a runtime counter
+     *  and must not be part of canonical input.  See schedule-store
+     *  canonicalScheduleInput. */
+    repeat?: {
+        times: number | null;
+    };
+    deliver?: 'origin' | 'local';
+};
+export type ScheduleOutput = {
+    taskId: string;
+};
+export declare function parseScheduleInput(input: unknown): ScheduleInput;
+/**
+ * `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 declare const botmuxScheduleExecutor: SideEffectingExecutor<ScheduleInput, ScheduleOutput>;
+export declare const botmuxScheduleReconciler: ProviderReconciler;
+//# sourceMappingURL=botmux-schedule.d.ts.map

package/dist/workflows/hostExecutors/botmux-schedule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"botmux-schedule.d.ts","sourceRoot":"","sources":["../../../src/workflows/hostExecutors/botmux-schedule.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB;;4DAEwD;IACxD,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;kCAE8B;IAC9B,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAClC,OAAO,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAwBF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CAEhE;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,EAAE,qBAAqB,CAAC,aAAa,EAAE,cAAc,CA4DvF,CAAC;AAEF,eAAO,MAAM,wBAAwB,EAAE,kBA4BtC,CAAC"}