@aicalas/loopy 0.1.0

package/dist/temporal/history.js

@@ -0,0 +1,310 @@
+import { defaultPayloadConverter } from "@temporalio/common";
+import proto from "@temporalio/proto";
+import { isJsonValue } from "../core/wire.js";
+const ENUMS = proto.temporal.api.enums.v1;
+const ATTRIBUTES_SUFFIX = "EventAttributes";
+/** Workflow Task scheduling machinery: three events per task, none carrying audit information. */
+const MACHINERY_EVENTS = new Set([
+    "workflowTaskScheduled",
+    "workflowTaskStarted",
+    "workflowTaskCompleted",
+]);
+/** Render the Event History of the latest Run behind one Workflow ID. */
+export async function fetchExecutionHistory(client, workflowId) {
+    return renderHistory(await client.getHandle(workflowId).fetchHistory());
+}
+export function renderHistory(history) {
+    const views = [];
+    for (const event of history.events ?? []) {
+        const view = renderEvent(event);
+        if (view !== undefined)
+            views.push(view);
+    }
+    return views;
+}
+/**
+ * An event type this build does not recognise still renders as a bare line — an audit that silently
+ * dropped events would read as "nothing happened" exactly when something new did.
+ */
+function renderEvent(event) {
+    const attribute = Object.keys(event).find((key) => key.endsWith(ATTRIBUTES_SUFFIX) && event[key] != null);
+    if (attribute === undefined)
+        return { ...base(event), event: "unrecognized" };
+    const name = attribute.slice(0, -ATTRIBUTES_SUFFIX.length);
+    if (MACHINERY_EVENTS.has(name))
+        return undefined;
+    const view = { ...base(event), event: kebab(name) };
+    enrich(view, name, event[attribute]);
+    return view;
+}
+function enrich(view, name, attributes) {
+    switch (name) {
+        case "workflowExecutionStarted": {
+            const a = attributes;
+            setName(view, "workflowType", a.workflowType);
+            setAttempt(view, a.attempt);
+            const parent = workflowLink(a.parentWorkflowExecution, undefined);
+            if (parent !== undefined)
+                view.parent = parent;
+            decodeValue(view, "input", a.input);
+            break;
+        }
+        case "activityTaskScheduled": {
+            const a = attributes;
+            if (nonEmpty(a.activityId))
+                view.activityId = a.activityId;
+            if (a.activityType?.name != null && a.activityType.name !== "") {
+                view.activityType = a.activityType.name;
+            }
+            decodeValue(view, "input", a.input);
+            break;
+        }
+        case "activityTaskStarted": {
+            const a = attributes;
+            setScheduledEventId(view, a.scheduledEventId);
+            setAttempt(view, a.attempt);
+            if (a.lastFailure != null)
+                view.failure = renderFailure(a.lastFailure);
+            break;
+        }
+        case "activityTaskCompleted": {
+            const a = attributes;
+            setScheduledEventId(view, a.scheduledEventId);
+            decodeValue(view, "result", a.result);
+            break;
+        }
+        case "activityTaskFailed":
+        case "activityTaskTimedOut": {
+            const a = attributes;
+            setScheduledEventId(view, a.scheduledEventId);
+            setFailure(view, a.failure);
+            break;
+        }
+        case "activityTaskCancelRequested":
+        case "activityTaskCanceled": {
+            const a = attributes;
+            setScheduledEventId(view, a.scheduledEventId);
+            break;
+        }
+        case "workflowTaskFailed": {
+            const a = attributes;
+            setCause(view, a.cause, ENUMS.WorkflowTaskFailedCause, "WORKFLOW_TASK_FAILED_CAUSE_");
+            setFailure(view, a.failure);
+            break;
+        }
+        case "workflowExecutionUpdateAccepted": {
+            const a = attributes;
+            const update = {};
+            const id = a.acceptedRequest?.meta?.updateId;
+            if (nonEmpty(id))
+                update.id = id;
+            const updateName = a.acceptedRequest?.input?.name;
+            if (nonEmpty(updateName))
+                update.name = updateName;
+            view.update = update;
+            decodeValue(view, "input", a.acceptedRequest?.input?.args);
+            break;
+        }
+        case "workflowExecutionUpdateCompleted": {
+            const a = attributes;
+            const id = a.meta?.updateId;
+            if (nonEmpty(id))
+                view.update = { id };
+            decodeValue(view, "result", a.outcome?.success);
+            setFailure(view, a.outcome?.failure);
+            break;
+        }
+        case "startChildWorkflowExecutionInitiated": {
+            const a = attributes;
+            const child = workflowLink({ workflowId: a.workflowId }, a.workflowType);
+            if (child !== undefined)
+                view.child = child;
+            decodeValue(view, "input", a.input);
+            break;
+        }
+        case "startChildWorkflowExecutionFailed": {
+            const a = attributes;
+            const child = workflowLink({ workflowId: a.workflowId }, a.workflowType);
+            if (child !== undefined)
+                view.child = child;
+            setCause(view, a.cause, ENUMS.StartChildWorkflowExecutionFailedCause, "START_CHILD_WORKFLOW_EXECUTION_FAILED_CAUSE_");
+            break;
+        }
+        case "childWorkflowExecutionStarted":
+        case "childWorkflowExecutionCompleted":
+        case "childWorkflowExecutionFailed": {
+            const a = attributes;
+            const child = workflowLink(a.workflowExecution, a.workflowType);
+            if (child !== undefined)
+                view.child = child;
+            decodeValue(view, "result", a.result);
+            setFailure(view, a.failure);
+            break;
+        }
+        case "workflowExecutionCompleted": {
+            const a = attributes;
+            decodeValue(view, "result", a.result);
+            break;
+        }
+        case "workflowExecutionFailed": {
+            const a = attributes;
+            setFailure(view, a.failure);
+            break;
+        }
+        case "workflowExecutionTerminated": {
+            const a = attributes;
+            if (nonEmpty(a.reason))
+                view.reason = a.reason;
+            decodeValue(view, "details", a.details);
+            break;
+        }
+        case "workflowExecutionCanceled": {
+            const a = attributes;
+            decodeValue(view, "details", a.details);
+            break;
+        }
+        case "workflowExecutionContinuedAsNew": {
+            const a = attributes;
+            if (nonEmpty(a.newExecutionRunId))
+                view.newRunId = a.newExecutionRunId;
+            decodeValue(view, "input", a.input);
+            break;
+        }
+        case "workflowExecutionSignaled": {
+            const a = attributes;
+            if (nonEmpty(a.signalName))
+                view.signal = a.signalName;
+            decodeValue(view, "input", a.input);
+            break;
+        }
+        default:
+            break;
+    }
+}
+function base(event) {
+    const view = {};
+    const eventId = toInteger(event.eventId);
+    if (eventId !== undefined)
+        view.eventId = eventId;
+    const time = isoTime(event.eventTime);
+    if (time !== undefined)
+        view.time = time;
+    return view;
+}
+/**
+ * A payload the default converter cannot read becomes a note instead of aborting the rendering:
+ * one foreign payload must not hide the rest of the history.
+ */
+function decodeValue(view, field, payloads) {
+    const entries = payloads?.payloads;
+    if (entries == null || entries.length === 0)
+        return;
+    try {
+        const values = entries.map(decodePayload);
+        const [first] = values;
+        view[field] = values.length === 1 && first !== undefined ? first : values;
+    }
+    catch (error) {
+        view.note = `payload-undecodable:${message(error)}`;
+    }
+}
+function decodePayload(payload) {
+    const value = defaultPayloadConverter.fromPayload(payload);
+    if (!isJsonValue(value))
+        throw new Error("payload is not a JSON value");
+    return value;
+}
+function renderFailure(failure) {
+    const view = {};
+    const type = failureType(failure);
+    if (type !== undefined)
+        view.type = type;
+    if (nonEmpty(failure.message))
+        view.message = failure.message;
+    if (nonEmpty(failure.stackTrace))
+        view.stackTrace = failure.stackTrace;
+    if (failure.cause != null)
+        view.cause = renderFailure(failure.cause);
+    return view;
+}
+/** An application failure keeps its declared type; other variants are named by their info field. */
+function failureType(failure) {
+    const application = failure.applicationFailureInfo;
+    if (application != null) {
+        return nonEmpty(application.type) ? application.type : "application-failure";
+    }
+    const info = Object.keys(failure).find((key) => key.endsWith("FailureInfo") && failure[key] != null);
+    return info === undefined ? undefined : kebab(info.slice(0, -"Info".length));
+}
+function setFailure(view, failure) {
+    if (failure != null)
+        view.failure = renderFailure(failure);
+}
+function setName(view, field, type) {
+    if (type?.name != null && type.name !== "")
+        view[field] = type.name;
+}
+function setAttempt(view, attempt) {
+    if (typeof attempt === "number" && attempt > 0)
+        view.attempt = attempt;
+}
+function setScheduledEventId(view, value) {
+    const scheduledEventId = toInteger(value);
+    if (scheduledEventId !== undefined)
+        view.scheduledEventId = scheduledEventId;
+}
+function setCause(view, value, names, prefix) {
+    if (value == null || value === 0)
+        return;
+    const name = typeof value === "string" ? value : names[value];
+    // An enum value newer than this build's proto still surfaces, as its number.
+    if (name === undefined) {
+        view.cause = String(value);
+        return;
+    }
+    view.cause = kebab(name.startsWith(prefix) ? name.slice(prefix.length) : name);
+}
+function workflowLink(execution, type) {
+    const link = {};
+    const workflowId = execution?.workflowId;
+    if (nonEmpty(workflowId))
+        link.workflowId = workflowId;
+    const runId = execution?.runId;
+    if (nonEmpty(runId))
+        link.runId = runId;
+    if (type?.name != null && type.name !== "")
+        link.workflowType = type.name;
+    return Object.keys(link).length === 0 ? undefined : link;
+}
+function isoTime(timestamp) {
+    if (timestamp == null)
+        return undefined;
+    const seconds = toInteger(timestamp.seconds);
+    if (seconds === undefined)
+        return undefined;
+    return new Date(seconds * 1_000 + Math.floor((timestamp.nanos ?? 0) / 1e6)).toISOString();
+}
+function toInteger(value) {
+    if (value == null)
+        return undefined;
+    if (typeof value === "number")
+        return value;
+    if (typeof value === "string") {
+        const parsed = Number(value);
+        return Number.isFinite(parsed) ? parsed : undefined;
+    }
+    return value.toNumber();
+}
+function nonEmpty(value) {
+    return typeof value === "string" && value !== "";
+}
+function kebab(name) {
+    return name
+        .replaceAll(/([a-z0-9])([A-Z])/g, "$1-$2")
+        .replaceAll("_", "-")
+        .toLowerCase();
+}
+function message(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=history.js.map

package/dist/temporal/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../src/temporal/history.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAgB,MAAM,oBAAoB,CAAC;AAC3E,OAAO,KAAK,MAAM,mBAAmB,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAkB,MAAM,iBAAiB,CAAC;AAE9D,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;AAC1C,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAC5C,kGAAkG;AAClG,MAAM,gBAAgB,GAAwB,IAAI,GAAG,CAAC;IACpD,uBAAuB;IACvB,qBAAqB;IACrB,uBAAuB;CACxB,CAAC,CAAC;AAkGH,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAA6B,EAC7B,UAAkB;IAElB,OAAO,aAAa,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;AAC1E,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAyB;IACrD,MAAM,KAAK,GAAuB,EAAE,CAAC;IACrC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QACzC,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;QAChC,IAAI,IAAI,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,KAAmB;IACtC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CACvC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,iBAAiB,CAAC,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,CAC/D,CAAC;IACF,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC;IAC9E,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC3D,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACjD,MAAM,IAAI,GAAqB,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;IACtE,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,MAAM,CAAC,IAAsB,EAAE,IAAY,EAAE,UAAmB;IACvE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,0BAA0B,EAAE,CAAC;YAChC,MAAM,CAAC,GAAG,UAKT,CAAC;YACF,OAAO,CAAC,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC;YAC9C,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;YAC5B,MAAM,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC,uBAAuB,EAAE,SAAS,CAAC,CAAC;YAClE,IAAI,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;YAC/C,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM;QACR,CAAC;QACD,KAAK,uBAAuB,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,UAIT,CAAC;YACF,IAAI,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;gBAAE,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC;YAC3D,IAAI,CAAC,CAAC,YAAY,EAAE,IAAI,IAAI,IAAI,IAAI,CAAC,CAAC,YAAY,CAAC,IAAI,KAAK,EAAE,EAAE,CAAC;gBAC/D,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC;YAC1C,CAAC;YACD,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM;QACR,CAAC;QACD,KAAK,qBAAqB,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,UAIT,CAAC;YACF,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC,gBAAgB,CAAC,CAAC;YAC9C,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;YAC5B,IAAI,CAAC,CAAC,WAAW,IAAI,IAAI;gBAAE,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;YACvE,MAAM;QACR,CAAC;QACD,KAAK,uBAAuB,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,UAGT,CAAC;YACF,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC,gBAAgB,CAAC,CAAC;YAC9C,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;YACtC,MAAM;QACR,CAAC;QACD,KAAK,oBAAoB,CAAC;QAC1B,KAAK,sBAAsB,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,UAGT,CAAC;YACF,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC,gBAAgB,CAAC,CAAC;YAC9C,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;YAC5B,MAAM;QACR,CAAC;QACD,KAAK,6BAA6B,CAAC;QACnC,KAAK,sBAAsB,EAAE,CAAC;YAC5B,MAAM,CAAC,GAAG,UAAwD,CAAC;YACnE,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC,gBAAgB,CAAC,CAAC;YAC9C,MAAM;QACR,CAAC;QACD,KAAK,oBAAoB,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,UAAiF,CAAC;YAC5F,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,CAAC,uBAAuB,EAAE,6BAA6B,CAAC,CAAC;YACtF,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;YAC5B,MAAM;QACR,CAAC;QACD,KAAK,iCAAiC,EAAE,CAAC;YACvC,MAAM,CAAC,GAAG,UAKT,CAAC;YACF,MAAM,MAAM,GAAe,EAAE,CAAC;YAC9B,MAAM,EAAE,GAAG,CAAC,CAAC,eAAe,EAAE,IAAI,EAAE,QAAQ,CAAC;YAC7C,IAAI,QAAQ,CAAC,EAAE,CAAC;gBAAE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;YACjC,MAAM,UAAU,GAAG,CAAC,CAAC,eAAe,EAAE,KAAK,EAAE,IAAI,CAAC;YAClD,IAAI,QAAQ,CAAC,UAAU,CAAC;gBAAE,MAAM,CAAC,IAAI,GAAG,UAAU,CAAC;YACnD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;YACrB,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,eAAe,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YAC3D,MAAM;QACR,CAAC;QACD,KAAK,kCAAkC,EAAE,CAAC;YACxC,MAAM,CAAC,GAAG,UAGT,CAAC;YACF,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC;YAC5B,IAAI,QAAQ,CAAC,EAAE,CAAC;gBAAE,IAAI,CAAC,MAAM,GAAG,EAAE,EAAE,EAAE,CAAC;YACvC,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAChD,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YACrC,MAAM;QACR,CAAC;QACD,KAAK,sCAAsC,EAAE,CAAC;YAC5C,MAAM,CAAC,GAAG,UAIT,CAAC;YACF,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC;YACzE,IAAI,KAAK,KAAK,SAAS;gBAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YAC5C,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM;QACR,CAAC;QACD,KAAK,mCAAmC,EAAE,CAAC;YACzC,MAAM,CAAC,GAAG,UAIT,CAAC;YACF,MAAM,KAAK,GAAG,YAAY,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC;YACzE,IAAI,KAAK,KAAK,SAAS;gBAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YAC5C,QAAQ,CACN,IAAI,EACJ,CAAC,CAAC,KAAK,EACP,KAAK,CAAC,sCAAsC,EAC5C,8CAA8C,CAC/C,CAAC;YACF,MAAM;QACR,CAAC;QACD,KAAK,+BAA+B,CAAC;QACrC,KAAK,iCAAiC,CAAC;QACvC,KAAK,8BAA8B,EAAE,CAAC;YACpC,MAAM,CAAC,GAAG,UAKT,CAAC;YACF,MAAM,KAAK,GAAG,YAAY,CAAC,CAAC,CAAC,iBAAiB,EAAE,CAAC,CAAC,YAAY,CAAC,CAAC;YAChE,IAAI,KAAK,KAAK,SAAS;gBAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YAC5C,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;YACtC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;YAC5B,MAAM;QACR,CAAC;QACD,KAAK,4BAA4B,EAAE,CAAC;YAClC,MAAM,CAAC,GAAG,UAAiD,CAAC;YAC5D,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;YACtC,MAAM;QACR,CAAC;QACD,KAAK,yBAAyB,EAAE,CAAC;YAC/B,MAAM,CAAC,GAAG,UAAiD,CAAC;YAC5D,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;YAC5B,MAAM;QACR,CAAC;QACD,KAAK,6BAA6B,EAAE,CAAC;YACnC,MAAM,CAAC,GAAG,UAA0E,CAAC;YACrF,IAAI,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC;gBAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;YAC/C,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM;QACR,CAAC;QACD,KAAK,2BAA2B,EAAE,CAAC;YACjC,MAAM,CAAC,GAAG,UAAkD,CAAC;YAC7D,WAAW,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;YACxC,MAAM;QACR,CAAC;QACD,KAAK,iCAAiC,EAAE,CAAC;YACvC,MAAM,CAAC,GAAG,UAAmF,CAAC;YAC9F,IAAI,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC;gBAAE,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAC,iBAAiB,CAAC;YACvE,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM;QACR,CAAC;QACD,KAAK,2BAA2B,EAAE,CAAC;YACjC,MAAM,CAAC,GAAG,UAA4E,CAAC;YACvF,IAAI,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;gBAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,UAAU,CAAC;YACvD,WAAW,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM;QACR,CAAC;QACD;YACE,MAAM;IACV,CAAC;AACH,CAAC;AAWD,SAAS,IAAI,CAAC,KAAmB;IAC/B,MAAM,IAAI,GAAwC,EAAE,CAAC;IACrD,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACzC,IAAI,OAAO,KAAK,SAAS;QAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IAClD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACtC,IAAI,IAAI,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACzC,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAClB,IAAsB,EACtB,KAAqC,EACrC,QAA4C;IAE5C,MAAM,OAAO,GAAG,QAAQ,EAAE,QAAQ,CAAC;IACnC,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IACpD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC;QACvB,IAAI,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAC5E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;IACtD,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,OAAuB;IAC5C,MAAM,KAAK,GAAY,uBAAuB,CAAC,WAAW,CAAC,OAAkB,CAAC,CAAC;IAC/E,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACxE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,aAAa,CAAC,OAAuB;IAC5C,MAAM,IAAI,GAAgB,EAAE,CAAC;IAC7B,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,IAAI,KAAK,SAAS;QAAE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACzC,IAAI,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAC9D,IAAI,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC;QAAE,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACvE,IAAI,OAAO,CAAC,KAAK,IAAI,IAAI;QAAE,IAAI,CAAC,KAAK,GAAG,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACrE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oGAAoG;AACpG,SAAS,WAAW,CAAC,OAAuB;IAC1C,MAAM,WAAW,GAAG,OAAO,CAAC,sBAAsB,CAAC;IACnD,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;QACxB,OAAO,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,qBAAqB,CAAC;IAC/E,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CACpC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,CAC7D,CAAC;IACF,OAAO,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,UAAU,CAAC,IAAsB,EAAE,OAA0C;IACpF,IAAI,OAAO,IAAI,IAAI;QAAE,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,OAAO,CACd,IAAsB,EACtB,KAAqB,EACrB,IAAiC;IAEjC,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,EAAE;QAAE,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC;AACtE,CAAC;AAED,SAAS,UAAU,CAAC,IAAsB,EAAE,OAAkC;IAC5E,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC;QAAE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;AACzE,CAAC;AAED,SAAS,mBAAmB,CAAC,IAAsB,EAAE,KAAsC;IACzF,MAAM,gBAAgB,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,gBAAgB,KAAK,SAAS;QAAE,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;AAC/E,CAAC;AAED,SAAS,QAAQ,CACf,IAAsB,EACtB,KAAyC,EACzC,KAAa,EACb,MAAc;IAEd,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO;IACzC,MAAM,IAAI,GACR,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,KAA4C,CAAC,KAAK,CAAC,CAAC;IAC3F,6EAA6E;IAC7E,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3B,OAAO;IACT,CAAC;IACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,YAAY,CACnB,SAA0C,EAC1C,IAAiC;IAEjC,MAAM,IAAI,GAAiB,EAAE,CAAC;IAC9B,MAAM,UAAU,GAAG,SAAS,EAAE,UAAU,CAAC;IACzC,IAAI,QAAQ,CAAC,UAAU,CAAC;QAAE,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IACvD,MAAM,KAAK,GAAG,SAAS,EAAE,KAAK,CAAC;IAC/B,IAAI,QAAQ,CAAC,KAAK,CAAC;QAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACxC,IAAI,IAAI,EAAE,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,EAAE;QAAE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC;IAC1E,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3D,CAAC;AAED,SAAS,OAAO,CAAC,SAA4C;IAC3D,IAAI,SAAS,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,OAAO,GAAG,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC5C,OAAO,IAAI,IAAI,CAAC,OAAO,GAAG,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;AAC5F,CAAC;AAED,SAAS,SAAS,CAAC,KAAsC;IACvD,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,SAAS,CAAC;IACpC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7B,OAAO,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACtD,CAAC;IACD,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;AAC1B,CAAC;AAED,SAAS,QAAQ,CAAC,KAAgC;IAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,EAAE,CAAC;AACnD,CAAC;AAED,SAAS,KAAK,CAAC,IAAY;IACzB,OAAO,IAAI;SACR,UAAU,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACzC,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC;SACpB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED,SAAS,OAAO,CAAC,KAAc;IAC7B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/temporal/observe.d.ts

@@ -0,0 +1,85 @@
+import type { ChannelAdapterSpec } from "../adapters.js";
+import { type InstanceWorkflowInput, type JsonValue } from "../core/wire.js";
+import { type StatusDescription } from "./status.js";
+/**
+ * The client surface the observer needs: list this workflow's open instances, Describe and Query
+ * each, deliver an answer as a Workflow Update, and read one history slice. A real `WorkflowClient`
+ * satisfies it - including the raw `workflowService` handle, which is used instead of
+ * `fetchHistory()` because a stuck Execution's history grows on every failed Workflow Task and the
+ * scan only ever needs event one.
+ */
+export interface InstanceObserverClient {
+    list(options: {
+        query: string;
+    }): AsyncIterable<{
+        workflowId: string;
+    }>;
+    getHandle(workflowId: string): InstanceObserverHandle;
+    workflowService: {
+        getWorkflowExecutionHistory(request: {
+            namespace: string;
+            execution: {
+                workflowId: string;
+                runId: string;
+            };
+            maximumPageSize: number;
+        }): Promise<{
+            history?: StartHistory | null;
+        }>;
+    };
+    options: {
+        namespace: string;
+    };
+}
+export interface InstanceObserverHandle {
+    describe(): Promise<StatusDescription>;
+    query(queryName: string): Promise<unknown>;
+    executeUpdate(updateName: string, options: {
+        args: unknown[];
+        updateId?: string;
+    }): Promise<unknown>;
+}
+/** The one slice of an Event History the scan reads: the start event's input payload. */
+export interface StartHistory {
+    events?: readonly {
+        workflowExecutionStartedEventAttributes?: {
+            input?: {
+                payloads?: readonly unknown[] | null;
+            } | null;
+        } | null;
+    }[] | null;
+}
+export interface ObservedStuckInstance {
+    workflowId: string;
+    runId: string;
+    input: InstanceWorkflowInput;
+}
+export interface ObservedAwaitingInstance {
+    workflowId: string;
+    calls: {
+        callId: string;
+        channel: string;
+        correlation: JsonValue;
+    }[];
+}
+/**
+ * List this workflow's open instances once and classify each as stuck or healthy. A stuck
+ * instance's own code no longer runs, so it cannot surface itself: its trigger and attention route
+ * come from the Execution's own start input, because the trigger object may no longer match any
+ * watcher. A healthy instance is Queried for calls parked in `awaiting_answer`; a stuck one is
+ * not - its Query cannot be served. Every per-instance failure is isolated: the condition is
+ * level-triggered and the next tick re-observes whatever this scan missed.
+ */
+export declare function observeInstances(client: InstanceObserverClient, repository: string, workflow: string): Promise<{
+    stuck: ObservedStuckInstance[];
+    awaiting: ObservedAwaitingInstance[];
+}>;
+/**
+ * Poll each awaiting call's channel for a reply and deliver any answer as an `answer_instance`
+ * Update. Every instance and call is isolated in its own try/catch: a channel error, a rejected
+ * Update (the call was already answered), or a closed Execution fails that one item and the scan
+ * continues, returning partial results rather than re-driving the whole set. The Update ID is
+ * derived from the workflow and call so an Activity retry dedups against the server.
+ */
+export declare function pollObservedAnswers(client: InstanceObserverClient, channels: ReadonlyMap<string, ChannelAdapterSpec>, awaiting: readonly ObservedAwaitingInstance[]): Promise<string[]>;
+//# sourceMappingURL=observe.d.ts.map

package/dist/temporal/observe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe.d.ts","sourceRoot":"","sources":["../../src/temporal/observe.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAGL,KAAK,qBAAqB,EAC1B,KAAK,SAAS,EAIf,MAAM,iBAAiB,CAAC;AAIzB,OAAO,EAAW,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,IAAI,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,aAAa,CAAC;QAAE,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxE,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,sBAAsB,CAAC;IACtD,eAAe,EAAE;QACf,2BAA2B,CAAC,OAAO,EAAE;YACnC,SAAS,EAAE,MAAM,CAAC;YAClB,SAAS,EAAE;gBAAE,UAAU,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAA;aAAE,CAAC;YACjD,eAAe,EAAE,MAAM,CAAC;SACzB,GAAG,OAAO,CAAC;YAAE,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAAA;SAAE,CAAC,CAAC;KAChD,CAAC;IACF,OAAO,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAChC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACvC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,aAAa,CACX,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE;QAAE,IAAI,EAAE,OAAO,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC9C,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AAED,yFAAyF;AACzF,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EACH,SAAS;QACP,uCAAuC,CAAC,EAAE;YACxC,KAAK,CAAC,EAAE;gBAAE,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAAA;aAAE,GAAG,IAAI,CAAC;SACzD,GAAG,IAAI,CAAC;KACV,EAAE,GACH,IAAI,CAAC;CACV;AAID,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,qBAAqB,CAAC;CAC9B;AAED,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,SAAS,CAAA;KAAE,EAAE,CAAC;CACtE;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,sBAAsB,EAC9B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC;IAAC,QAAQ,EAAE,wBAAwB,EAAE,CAAA;CAAE,CAAC,CA0CnF;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,sBAAsB,EAC9B,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,kBAAkB,CAAC,EACjD,QAAQ,EAAE,SAAS,wBAAwB,EAAE,GAC5C,OAAO,CAAC,MAAM,EAAE,CAAC,CA0BnB"}

package/dist/temporal/observe.js

@@ -0,0 +1,110 @@
+import { defaultPayloadConverter } from "@temporalio/common";
+import { parseChannelPollResult, parseInstanceState, parseInstanceWorkflowInput, } from "../core/wire.js";
+import { instanceIdPrefix } from "../identifiers.js";
+import { log } from "../log.js";
+import { ANSWER_INSTANCE_UPDATE, INSTANCE_STATE_QUERY } from "./contracts.js";
+import { isStuck } from "./status.js";
+/**
+ * List this workflow's open instances once and classify each as stuck or healthy. A stuck
+ * instance's own code no longer runs, so it cannot surface itself: its trigger and attention route
+ * come from the Execution's own start input, because the trigger object may no longer match any
+ * watcher. A healthy instance is Queried for calls parked in `awaiting_answer`; a stuck one is
+ * not - its Query cannot be served. Every per-instance failure is isolated: the condition is
+ * level-triggered and the next tick re-observes whatever this scan missed.
+ */
+export async function observeInstances(client, repository, workflow) {
+    const prefix = `${instanceIdPrefix(repository)}${workflow}:`;
+    const query = `ExecutionStatus="Running" AND WorkflowId STARTS_WITH ${JSON.stringify(prefix)}`;
+    const stuck = [];
+    const awaiting = [];
+    for await (const info of client.list({ query })) {
+        const handle = client.getHandle(info.workflowId);
+        let description;
+        try {
+            description = await handle.describe();
+        }
+        catch (error) {
+            log.warning(`instance observer: cannot describe ${info.workflowId}: ${message(error)}`);
+            continue;
+        }
+        // Visibility lags the live Execution, so re-check status on the authoritative Describe.
+        if (description.status.name !== "RUNNING")
+            continue;
+        if (isStuck(description)) {
+            try {
+                const input = parseInstanceWorkflowInput(decodeStartInput(await fetchStartHistory(client, info.workflowId, description.runId)));
+                stuck.push({ workflowId: info.workflowId, runId: description.runId, input });
+            }
+            catch (error) {
+                // Without the start input there is no trigger to surface the event on. A shape this build
+                // cannot read is a version gap; say so and leave the instance to `loopy status`.
+                log.warning(`stuck instance ${info.workflowId}: cannot read start input: ${message(error)}`);
+            }
+            continue;
+        }
+        try {
+            const state = parseInstanceState(await handle.query(INSTANCE_STATE_QUERY));
+            const calls = state.calls
+                .filter((call) => call.kind === "awaiting_answer")
+                .map(({ callId, channel, correlation }) => ({ callId, channel, correlation }));
+            if (calls.length > 0)
+                awaiting.push({ workflowId: info.workflowId, calls });
+        }
+        catch (error) {
+            log.warning(`ask poll: cannot read state for ${info.workflowId}: ${message(error)}`);
+        }
+    }
+    return { stuck, awaiting };
+}
+/**
+ * Poll each awaiting call's channel for a reply and deliver any answer as an `answer_instance`
+ * Update. Every instance and call is isolated in its own try/catch: a channel error, a rejected
+ * Update (the call was already answered), or a closed Execution fails that one item and the scan
+ * continues, returning partial results rather than re-driving the whole set. The Update ID is
+ * derived from the workflow and call so an Activity retry dedups against the server.
+ */
+export async function pollObservedAnswers(client, channels, awaiting) {
+    const answered = [];
+    for (const instance of awaiting) {
+        for (const call of instance.calls) {
+            try {
+                const spec = channels.get(call.channel);
+                if (spec === undefined) {
+                    log.warning(`ask poll: unknown channel ${JSON.stringify(call.channel)} for ${instance.workflowId} ${call.callId}`);
+                    continue;
+                }
+                const result = parseChannelPollResult(await spec.poll({ correlation: call.correlation }));
+                if (result.status !== "answered")
+                    continue;
+                const answer = { callId: call.callId, answer: result.answer };
+                await client.getHandle(instance.workflowId).executeUpdate(ANSWER_INSTANCE_UPDATE, {
+                    args: [answer],
+                    updateId: `answer:${instance.workflowId}:${call.callId}`,
+                });
+                answered.push(`${instance.workflowId}:${call.callId}`);
+            }
+            catch (error) {
+                log.warning(`ask poll: ${instance.workflowId} ${call.callId}: ${message(error)}`);
+            }
+        }
+    }
+    return answered;
+}
+async function fetchStartHistory(client, workflowId, runId) {
+    const response = await client.workflowService.getWorkflowExecutionHistory({
+        namespace: client.options.namespace,
+        execution: { workflowId, runId },
+        maximumPageSize: 1,
+    });
+    return response.history ?? {};
+}
+function decodeStartInput(history) {
+    const payload = history.events?.[0]?.workflowExecutionStartedEventAttributes?.input?.payloads?.[0];
+    if (payload === undefined || payload === null)
+        throw new Error("start event carries no input payload");
+    return defaultPayloadConverter.fromPayload(payload);
+}
+function message(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=observe.js.map

package/dist/temporal/observe.js.map

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

package/dist/temporal/schedules.d.ts

@@ -0,0 +1,26 @@
+import { type ScheduleClient } from "@temporalio/client";
+import type { DiscoveredWorkflow } from "../build/discover.js";
+import type { Settings } from "../settings.js";
+type ManagedScheduleClient = Pick<ScheduleClient, "create" | "getHandle" | "list">;
+/** The Schedule surface pause control needs, kept narrow so tests can supply a fake. */
+export type ScheduleClientLike = Pick<ScheduleClient, "getHandle" | "list">;
+export interface ScheduleSyncOptions {
+    settings: Settings;
+    workflows: readonly DiscoveredWorkflow[];
+    controlTaskQueue: string;
+}
+export declare function syncSchedules(client: ManagedScheduleClient, options: ScheduleSyncOptions): Promise<void>;
+/**
+ * Marks a pause as loopy's own, so startup can lift it without touching a pause an operator set for
+ * their own reasons. Without the distinction, every restart would clear a deliberate pause.
+ */
+export declare const DRAIN_PAUSE_NOTE = "loopy: drained for shutdown";
+/**
+ * Stop every Schedule this deployment owns, so nothing new starts while the drain waits on the
+ * Executions already running.
+ */
+export declare function pauseOwnedSchedules(client: ScheduleClientLike, repository: string, note: string): Promise<string[]>;
+/** Lift only the pauses this deployment's own drain set; anything else stays paused. */
+export declare function resumeDrainedSchedules(client: ScheduleClientLike, repository: string): Promise<string[]>;
+export {};
+//# sourceMappingURL=schedules.d.ts.map

package/dist/temporal/schedules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schedules.d.ts","sourceRoot":"","sources":["../../src/temporal/schedules.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EAGpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAU/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG/C,KAAK,qBAAqB,GAAG,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,WAAW,GAAG,MAAM,CAAC,CAAC;AAEnF,wFAAwF;AACxF,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,MAAM,CAAC,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACzC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAoKD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,gCAAgC,CAAC;AAE9D;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,kBAAkB,EAC1B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,EAAE,CAAC,CAOnB;AAED,wFAAwF;AACxF,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,kBAAkB,EAC1B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,EAAE,CAAC,CASnB"}