@aicalas/loopy 0.1.0

package/dist/temporal/schedules.js

@@ -0,0 +1,200 @@
+import { ScheduleAlreadyRunning, ScheduleOverlapPolicy, } from "@temporalio/client";
+import { instanceIdPrefix, ownsScheduleId, pollRunWorkflowId, pollScheduleId, scheduledRunWorkflowId, scheduledScheduleId, } from "../identifiers.js";
+import { POLL_WORKFLOW_TYPE } from "./contracts.js";
+export async function syncSchedules(client, options) {
+    const { settings } = options;
+    const desired = new Map(options.workflows.flatMap((workflow) => scheduleDefinitions(workflow, options)));
+    // Every loopy Schedule this repository owns, not just the poll prefix: a Schedule a removed
+    // feature left behind (the reverted workspace sweep's `loopy:sweep:<slug>`) is owned-but-not-
+    // desired, so the reconciliation below reaps it instead of leaving it firing forever.
+    const existing = new Set();
+    for await (const schedule of client.list()) {
+        if (ownsScheduleId(settings.repository, schedule.scheduleId))
+            existing.add(schedule.scheduleId);
+    }
+    for (const [scheduleId, definition] of desired) {
+        if (!existing.has(scheduleId)) {
+            try {
+                await client.create({ scheduleId, ...definition });
+                continue;
+            }
+            catch (error) {
+                if (!(error instanceof ScheduleAlreadyRunning))
+                    throw error;
+            }
+        }
+        await update(client.getHandle(scheduleId), definition);
+    }
+    for (const scheduleId of existing) {
+        if (!desired.has(scheduleId))
+            await client.getHandle(scheduleId).delete();
+    }
+}
+function scheduleDefinitions(workflow, options) {
+    if (workflow.schedule !== undefined) {
+        return [
+            [
+                scheduledScheduleId(options.settings.repository, workflow.name),
+                scheduledWorkflowSchedule(workflow, options),
+            ],
+            [
+                pollScheduleId(options.settings.repository, workflow.name),
+                observerSchedule(workflow, options),
+            ],
+        ];
+    }
+    if (workflow.watcher === undefined || workflow.attention === undefined) {
+        throw new Error(`watcher workflow ${JSON.stringify(workflow.name)} is incomplete`);
+    }
+    const { settings } = options;
+    const input = {
+        workflow: workflow.name,
+        repository: settings.repository,
+        defaultBranch: settings.defaultBranch,
+        watcher: workflow.watcher,
+        attention: workflow.attention,
+        agentTaskQueue: settings.temporal.agentTaskQueue,
+        instanceIdPrefix: instanceIdPrefix(settings.repository),
+    };
+    return [
+        [
+            pollScheduleId(settings.repository, workflow.name),
+            intervalSchedule({
+                intervalSeconds: settings.pollIntervalSeconds,
+                workflowType: POLL_WORKFLOW_TYPE,
+                taskQueue: options.controlTaskQueue,
+                workflowId: pollRunWorkflowId(settings.repository, workflow.name),
+                args: [input],
+            }),
+        ],
+    ];
+}
+function scheduledWorkflowSchedule(workflow, options) {
+    const { settings } = options;
+    if (workflow.schedule === undefined)
+        throw new Error(`scheduled workflow ${workflow.name} has no schedule`);
+    const trigger = {
+        source: "schedule",
+        digest: `schedule:${workflow.name}`,
+        repository: settings.repository,
+        kind: "schedule",
+        id: workflow.name,
+        data: {},
+    };
+    const input = {
+        workflow: workflow.name,
+        repository: settings.repository,
+        defaultBranch: settings.defaultBranch,
+        trigger,
+        agentTaskQueue: settings.temporal.agentTaskQueue,
+        ...(workflow.attention === undefined ? {} : { attention: workflow.attention }),
+    };
+    return declaredSchedule({
+        schedule: workflow.schedule,
+        workflowType: workflow.name,
+        taskQueue: options.controlTaskQueue,
+        workflowId: scheduledRunWorkflowId(settings.repository, workflow.name),
+        args: [input],
+    });
+}
+/** The regular control tick observes scheduled instances for stuck runs and pending answers. */
+function observerSchedule(workflow, options) {
+    const { settings } = options;
+    const input = {
+        workflow: workflow.name,
+        repository: settings.repository,
+        defaultBranch: settings.defaultBranch,
+        agentTaskQueue: settings.temporal.agentTaskQueue,
+        instanceIdPrefix: instanceIdPrefix(settings.repository),
+        ...(workflow.attention === undefined ? {} : { attention: workflow.attention }),
+    };
+    return intervalSchedule({
+        intervalSeconds: settings.pollIntervalSeconds,
+        workflowType: POLL_WORKFLOW_TYPE,
+        taskQueue: options.controlTaskQueue,
+        workflowId: pollRunWorkflowId(settings.repository, workflow.name),
+        args: [input],
+    });
+}
+/** `paused: false` is the creation default only; `update` carries the live pause through instead. */
+function intervalSchedule(request) {
+    return {
+        spec: { intervals: [{ every: `${request.intervalSeconds}s` }] },
+        action: {
+            type: "startWorkflow",
+            workflowType: request.workflowType,
+            taskQueue: request.taskQueue,
+            workflowId: request.workflowId,
+            args: request.args,
+        },
+        policies: { overlap: ScheduleOverlapPolicy.SKIP },
+        state: { paused: false },
+    };
+}
+function declaredSchedule(request) {
+    const schedule = request.schedule;
+    return {
+        spec: schedule.cron === undefined
+            ? { intervals: [{ every: `${schedule.intervalSeconds}s` }] }
+            : {
+                cronExpressions: [schedule.cron],
+                ...(schedule.timezone === undefined ? {} : { timezone: schedule.timezone }),
+            },
+        action: {
+            type: "startWorkflow",
+            workflowType: request.workflowType,
+            taskQueue: request.taskQueue,
+            workflowId: request.workflowId,
+            args: request.args,
+        },
+        policies: { overlap: schedule.overlap ?? ScheduleOverlapPolicy.SKIP },
+        state: { paused: false },
+    };
+}
+/**
+ * Reconcile the spec and action to code, but carry the live pause through. Paused is an operator
+ * decision - it is how a deployment drains - and a restart is exactly when it used to be lost.
+ */
+async function update(handle, definition) {
+    await handle.update((current) => ({
+        ...definition,
+        state: { paused: current.state.paused, note: current.state.note },
+    }));
+}
+/**
+ * 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 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 async function pauseOwnedSchedules(client, repository, note) {
+    const paused = [];
+    for await (const handle of ownedSchedules(client, repository)) {
+        await handle.pause(note);
+        paused.push(handle.scheduleId);
+    }
+    return paused;
+}
+/** Lift only the pauses this deployment's own drain set; anything else stays paused. */
+export async function resumeDrainedSchedules(client, repository) {
+    const resumed = [];
+    for await (const handle of ownedSchedules(client, repository)) {
+        const { state } = await handle.describe();
+        if (!state.paused || state.note !== DRAIN_PAUSE_NOTE)
+            continue;
+        await handle.unpause("loopy loop started");
+        resumed.push(handle.scheduleId);
+    }
+    return resumed;
+}
+/** Every Schedule this repository owns: a poll per workflow, plus any orphan awaiting reaping. */
+async function* ownedSchedules(client, repository) {
+    for await (const schedule of client.list()) {
+        if (ownsScheduleId(repository, schedule.scheduleId))
+            yield client.getHandle(schedule.scheduleId);
+    }
+}
+//# sourceMappingURL=schedules.js.map

package/dist/temporal/schedules.js.map

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

package/dist/temporal/status.d.ts

@@ -0,0 +1,63 @@
+import { type CleanupResult, type InstanceState, type JsonValue, type TriggerCandidate } from "../core/wire.js";
+/** Domain status enriched with the states only status inspection can observe. */
+export type ViewDomainStatus = InstanceState["domainStatus"] | "completed" | "stuck" | "unavailable";
+export interface InstanceView {
+    workflowId: string;
+    runId: string;
+    workflowType: string;
+    taskQueue: string;
+    temporalStatus: string;
+    domainStatus: ViewDomainStatus;
+    trigger?: TriggerCandidate;
+    parked?: string[];
+    callsUsed?: number;
+    callLimit?: number;
+    reason?: string;
+    value?: JsonValue;
+    cleanup?: CleanupResult;
+}
+/** The subset of a Temporal `WorkflowExecutionInfo` that status inspection reads. */
+export interface StatusExecutionInfo {
+    workflowId: string;
+}
+/** The subset of a Temporal `WorkflowExecutionDescription` that status inspection reads. */
+export interface StatusDescription {
+    runId: string;
+    type: string;
+    taskQueue: string;
+    status: {
+        name: string;
+    };
+    raw?: {
+        pendingWorkflowTask?: {
+            attempt?: number | {
+                toNumber(): number;
+            } | null;
+        } | null;
+    };
+}
+export interface StatusWorkflowHandle {
+    describe(): Promise<StatusDescription>;
+    query(queryName: string): Promise<unknown>;
+    result(): Promise<unknown>;
+}
+export interface StatusWorkflowClient {
+    list(options: {
+        query: string;
+    }): AsyncIterable<StatusExecutionInfo>;
+    getHandle(workflowId: string): StatusWorkflowHandle;
+}
+export interface StatusOptions {
+    queryTimeoutMs?: number;
+}
+/**
+ * List every loopy instance. Each user workflow is its own Workflow Type now, so the Workflow ID
+ * prefix - not the type - is what selects loopy's executions, filtered server-side so the listing
+ * pages loopy's instances rather than every Execution retained in a shared Namespace.
+ */
+export declare function listInstances(client: StatusWorkflowClient, options?: StatusOptions): Promise<InstanceView[]>;
+/** Resolve one instance Execution to its Temporal and loopy domain state. */
+export declare function describeInstance(client: StatusWorkflowClient, workflowId: string, options?: StatusOptions): Promise<InstanceView>;
+/** A Running Execution whose next Workflow Task has already failed is stuck, not progressing. */
+export declare function isStuck(description: StatusDescription): boolean;
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/temporal/status.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,aAAa,EAClB,KAAK,SAAS,EAGd,KAAK,gBAAgB,EACtB,MAAM,iBAAiB,CAAC;AAgBzB,iFAAiF;AACjF,MAAM,MAAM,gBAAgB,GACxB,aAAa,CAAC,cAAc,CAAC,GAC7B,WAAW,GACX,OAAO,GACP,aAAa,CAAC;AAElB,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,gBAAgB,CAAC;IAC/B,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,qFAAqF;AACrF,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,4FAA4F;AAC5F,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACzB,GAAG,CAAC,EAAE;QAAE,mBAAmB,CAAC,EAAE;YAAE,OAAO,CAAC,EAAE,MAAM,GAAG;gBAAE,QAAQ,IAAI,MAAM,CAAA;aAAE,GAAG,IAAI,CAAA;SAAE,GAAG,IAAI,CAAA;KAAE,CAAC;CAC7F;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACvC,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,OAAO,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,aAAa,CAAC,mBAAmB,CAAC,CAAC;IACrE,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,oBAAoB,CAAC;CACrD;AAED,MAAM,WAAW,aAAa;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,oBAAoB,EAC5B,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,EAAE,CAAC,CAazB;AAED,6EAA6E;AAC7E,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,oBAAoB,EAC5B,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,CA2CvB;AA6BD,iGAAiG;AACjG,wBAAgB,OAAO,CAAC,WAAW,EAAE,iBAAiB,GAAG,OAAO,CAI/D"}

package/dist/temporal/status.js

@@ -0,0 +1,153 @@
+import { QueryNotRegisteredError, QueryRejectedError, ServiceError } from "@temporalio/client";
+import { WorkflowNotFoundError } from "@temporalio/common";
+import { parkedCallIds } from "../core/calls.js";
+import { parseInstanceResult, parseInstanceState, } from "../core/wire.js";
+import { INSTANCE_ID_PREFIX, INSTANCE_STATE_QUERY } from "./contracts.js";
+const DEFAULT_QUERY_TIMEOUT_MS = 5_000;
+/**
+ * gRPC FAILED_PRECONDITION. The server answers a Query against an Execution whose Workflow Task is
+ * failing with this code, which is the Execution reporting that it cannot serve one - not a defect
+ * on this side. Transport codes are deliberately excluded: an unreachable server must stay loud
+ * rather than turn one outage into an "unavailable" row per Execution.
+ *
+ * The code is not unique to that refusal - `NamespaceNotActive` carries it too, so a global
+ * Namespace failover reads as every instance being stuck. That is a display artefact and clears
+ * with the failover; nothing destructive reads this.
+ */
+const GRPC_FAILED_PRECONDITION = 9;
+/**
+ * List every loopy instance. Each user workflow is its own Workflow Type now, so the Workflow ID
+ * prefix - not the type - is what selects loopy's executions, filtered server-side so the listing
+ * pages loopy's instances rather than every Execution retained in a shared Namespace.
+ */
+export async function listInstances(client, options = {}) {
+    const views = [];
+    // Visibility yields one entry per Run, and a Workflow ID is reused across every re-fire of the
+    // same trigger. Status reports current state, so collapse to one row per Workflow ID; the handle
+    // resolves to the latest Run. Earlier Runs stay in Event History for anyone who needs them.
+    const seen = new Set();
+    const query = `WorkflowId STARTS_WITH ${JSON.stringify(INSTANCE_ID_PREFIX)}`;
+    for await (const info of client.list({ query })) {
+        if (seen.has(info.workflowId))
+            continue;
+        seen.add(info.workflowId);
+        views.push(await describeInstance(client, info.workflowId, options));
+    }
+    return views;
+}
+/** Resolve one instance Execution to its Temporal and loopy domain state. */
+export async function describeInstance(client, workflowId, options = {}) {
+    const handle = client.getHandle(workflowId);
+    const description = await handle.describe();
+    const base = {
+        workflowId,
+        runId: description.runId,
+        workflowType: description.type,
+        taskQueue: description.taskQueue,
+        temporalStatus: description.status.name,
+    };
+    if (base.temporalStatus === "RUNNING") {
+        const state = await queryState(handle, options.queryTimeoutMs ?? DEFAULT_QUERY_TIMEOUT_MS);
+        if (state !== undefined)
+            return fromState(base, state);
+        const domainStatus = isStuck(description) ? "stuck" : "unavailable";
+        return domainStatus === "stuck"
+            ? { ...base, domainStatus, reason: "workflow-task-failing" }
+            : { ...base, domainStatus };
+    }
+    if (base.temporalStatus === "COMPLETED") {
+        let result;
+        try {
+            result = parseInstanceResult(await handle.result());
+        }
+        catch (error) {
+            // A closed Execution outlives the build that wrote its result, and Namespace retention keeps
+            // it listed for days afterwards, so a shape this build does not recognise is a version gap
+            // rather than a defect. Keep the row and name the gap. Query state gets no such latitude: it
+            // comes from the bundle running right now, so a mismatch there is this build's bug.
+            return {
+                ...base,
+                domainStatus: "unavailable",
+                reason: `result-unreadable:${message(error)}`,
+            };
+        }
+        const view = {
+            ...base,
+            domainStatus: result.domainStatus,
+            cleanup: result.cleanup,
+        };
+        if (result.domainStatus === "halted")
+            view.reason = result.reason;
+        else
+            view.value = result.value;
+        return view;
+    }
+    return { ...base, domainStatus: "unavailable" };
+}
+function fromState(base, state) {
+    const view = {
+        ...base,
+        domainStatus: state.domainStatus,
+        trigger: state.trigger,
+        parked: parkedCallIds(state.calls),
+        callsUsed: state.callsUsed,
+        callLimit: state.callLimit,
+    };
+    if (state.terminal !== undefined)
+        view.reason = state.terminal.reason;
+    return view;
+}
+async function queryState(handle, timeoutMs) {
+    let value;
+    try {
+        value = await withTimeout(handle.query(INSTANCE_STATE_QUERY), timeoutMs);
+    }
+    catch (error) {
+        if (isUnavailableQuery(error))
+            return undefined;
+        throw error;
+    }
+    return parseInstanceState(value);
+}
+/** A Running Execution whose next Workflow Task has already failed is stuck, not progressing. */
+export function isStuck(description) {
+    const attempt = description.raw?.pendingWorkflowTask?.attempt;
+    const count = typeof attempt === "number" ? attempt : (attempt?.toNumber() ?? 0);
+    return count > 1;
+}
+function withTimeout(operation, timeoutMs) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => reject(new QueryTimeoutError()), timeoutMs);
+        timer.unref();
+        operation.then(resolve, reject).finally(() => clearTimeout(timer));
+    });
+}
+class QueryTimeoutError extends Error {
+}
+function isUnavailableQuery(error) {
+    return (error instanceof QueryTimeoutError ||
+        error instanceof QueryNotRegisteredError ||
+        error instanceof QueryRejectedError ||
+        error instanceof WorkflowNotFoundError ||
+        refusedQuery(error));
+}
+/**
+ * The refusal arrives as a `ServiceError` wrapping the one that carries the gRPC code, so walk the
+ * cause chain rather than inspecting only the error thrown to the caller.
+ */
+function refusedQuery(error) {
+    for (let current = error; current instanceof Error; current = current.cause) {
+        if (current instanceof ServiceError && grpcCode(current) === GRPC_FAILED_PRECONDITION) {
+            return true;
+        }
+    }
+    return false;
+}
+function message(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function grpcCode(error) {
+    const code = error.code;
+    return typeof code === "number" ? code : undefined;
+}
+//# sourceMappingURL=status.js.map

package/dist/temporal/status.js.map

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

package/dist/temporal/stuck.d.ts

@@ -0,0 +1,58 @@
+import { type InstanceWorkflowInput } from "../core/wire.js";
+import { type StatusDescription } from "./status.js";
+/**
+ * The client surface the stuck scan needs. 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 StuckScanClient {
+    list(options: {
+        query: string;
+    }): AsyncIterable<{
+        workflowId: string;
+    }>;
+    getHandle(workflowId: string): StuckScanHandle;
+    workflowService: {
+        getWorkflowExecutionHistory(request: {
+            namespace: string;
+            execution: {
+                workflowId: string;
+                runId: string;
+            };
+            maximumPageSize: number;
+        }): Promise<{
+            history?: StartHistory | null;
+        }>;
+    };
+    options: {
+        namespace: string;
+    };
+}
+export interface StuckScanHandle {
+    describe(): Promise<StatusDescription>;
+}
+/** The one slice of an Event History the scan reads: the start event's input payload. */
+export interface StartHistory {
+    events?: readonly StartEvent[] | null;
+}
+interface StartEvent {
+    workflowExecutionStartedEventAttributes?: {
+        input?: {
+            payloads?: readonly unknown[] | null;
+        } | null;
+    } | null;
+}
+export interface StuckInstance {
+    workflowId: string;
+    runId: string;
+    input: InstanceWorkflowInput;
+}
+/**
+ * Find this workflow's open instances that are failing Workflow Tasks. A stuck instance's own code
+ * no longer runs, so it cannot surface itself — this control-side scan is how `stuck` reaches the
+ * attention port. The trigger comes from the Execution's own start input, because the trigger
+ * object may no longer match any watcher (its intake label was consumed before the code broke).
+ */
+export declare function findStuckInstances(client: StuckScanClient, repository: string, workflow: string): Promise<StuckInstance[]>;
+export {};
+//# sourceMappingURL=stuck.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stuck.d.ts","sourceRoot":"","sources":["../../src/temporal/stuck.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,qBAAqB,EAA8B,MAAM,iBAAiB,CAAC;AAGzF,OAAO,EAAW,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,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,eAAe,CAAC;IAC/C,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,eAAe;IAC9B,QAAQ,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACxC;AAED,yFAAyF;AACzF,MAAM,WAAW,YAAY;IAC3B,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,GAAG,IAAI,CAAC;CACvC;AAED,UAAU,UAAU;IAClB,uCAAuC,CAAC,EAAE;QACxC,KAAK,CAAC,EAAE;YAAE,QAAQ,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,IAAI,CAAA;SAAE,GAAG,IAAI,CAAC;KACzD,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,qBAAqB,CAAC;CAC9B;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,eAAe,EACvB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,EAAE,CAAC,CAsB1B"}

package/dist/temporal/stuck.js

@@ -0,0 +1,53 @@
+import { defaultPayloadConverter } from "@temporalio/common";
+import { parseInstanceWorkflowInput } from "../core/wire.js";
+import { instanceIdPrefix } from "../identifiers.js";
+import { log } from "../log.js";
+import { isStuck } from "./status.js";
+/**
+ * Find this workflow's open instances that are failing Workflow Tasks. A stuck instance's own code
+ * no longer runs, so it cannot surface itself — this control-side scan is how `stuck` reaches the
+ * attention port. The trigger comes from the Execution's own start input, because the trigger
+ * object may no longer match any watcher (its intake label was consumed before the code broke).
+ */
+export async function findStuckInstances(client, repository, workflow) {
+    const prefix = `${instanceIdPrefix(repository)}${workflow}:`;
+    const query = `ExecutionStatus="Running" AND WorkflowId STARTS_WITH ${JSON.stringify(prefix)}`;
+    const stuck = [];
+    for await (const info of client.list({ query })) {
+        const description = await client.getHandle(info.workflowId).describe();
+        // Visibility lags the live Execution, so re-check status on the authoritative Describe.
+        if (description.status.name !== "RUNNING" || !isStuck(description))
+            continue;
+        let input;
+        try {
+            input = parseInstanceWorkflowInput(decodeStartInput(await fetchStartHistory(client, info.workflowId, description.runId)));
+        }
+        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;
+        }
+        stuck.push({ workflowId: info.workflowId, runId: description.runId, input });
+    }
+    return stuck;
+}
+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=stuck.js.map

package/dist/temporal/stuck.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stuck.js","sourceRoot":"","sources":["../../src/temporal/stuck.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAgB,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAA8B,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAChC,OAAO,EAAE,OAAO,EAA0B,MAAM,aAAa,CAAC;AAyC9D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,MAAuB,EACvB,UAAkB,EAClB,QAAgB;IAEhB,MAAM,MAAM,GAAG,GAAG,gBAAgB,CAAC,UAAU,CAAC,GAAG,QAAQ,GAAG,CAAC;IAC7D,MAAM,KAAK,GAAG,wDAAwD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;IAC/F,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAChD,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE,CAAC;QACvE,wFAAwF;QACxF,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;YAAE,SAAS;QAC7E,IAAI,KAA4B,CAAC;QACjC,IAAI,CAAC;YACH,KAAK,GAAG,0BAA0B,CAChC,gBAAgB,CAAC,MAAM,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CACtF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,0FAA0F;YAC1F,iFAAiF;YACjF,GAAG,CAAC,OAAO,CAAC,kBAAkB,IAAI,CAAC,UAAU,8BAA8B,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC7F,SAAS;QACX,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,KAAK,UAAU,iBAAiB,CAC9B,MAAuB,EACvB,UAAkB,EAClB,KAAa;IAEb,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,2BAA2B,CAAC;QACxE,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,SAAS;QACnC,SAAS,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE;QAChC,eAAe,EAAE,CAAC;KACnB,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,OAAO,IAAI,EAAE,CAAC;AAChC,CAAC;AAED,SAAS,gBAAgB,CAAC,OAAqB;IAC7C,MAAM,OAAO,GACX,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,uCAAuC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;IACrF,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IACD,OAAO,uBAAuB,CAAC,WAAW,CAAC,OAAkB,CAAC,CAAC;AACjE,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/supervisor.d.ts

@@ -0,0 +1,11 @@
+import type { WorkflowDefinition } from "../authoring/types.js";
+import { type InstanceResult, type InstanceState, type JsonValue } from "../core/wire.js";
+/** A fixed safety bound until a real workflow demonstrates the need for configuration. */
+export declare const MAX_CALLS_PER_INSTANCE = 200;
+/** Reserved: the engine's own intake claim occupies this effect identifier. */
+export declare const INTAKE_EFFECT_ID = "intake";
+export declare const instanceStateQuery: import("@temporalio/workflow").QueryDefinition<InstanceState, [], string>;
+export declare const resolveInstanceUpdate: import("@temporalio/common").UpdateDefinition<InstanceState, [unknown], string>;
+export declare const answerInstanceUpdate: import("@temporalio/common").UpdateDefinition<InstanceState, [unknown], string>;
+export declare function runSupervised<R extends JsonValue>(definition: WorkflowDefinition<R>, input: unknown): Promise<InstanceResult>;
+//# sourceMappingURL=supervisor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"supervisor.d.ts","sourceRoot":"","sources":["../../src/temporal/supervisor.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAIV,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAc/B,OAAO,EAcL,KAAK,cAAc,EACnB,KAAK,aAAa,EAElB,KAAK,SAAS,EAcf,MAAM,iBAAiB,CAAC;AAiCzB,0FAA0F;AAC1F,eAAO,MAAM,sBAAsB,MAAM,CAAC;AAE1C,+EAA+E;AAC/E,eAAO,MAAM,gBAAgB,WAAW,CAAC;AAKzC,eAAO,MAAM,kBAAkB,2EAAmD,CAAC;AACnF,eAAO,MAAM,qBAAqB,iFAEjC,CAAC;AACF,eAAO,MAAM,oBAAoB,iFAAiE,CAAC;AAsBnG,wBAAgB,aAAa,CAAC,CAAC,SAAS,SAAS,EAC/C,UAAU,EAAE,kBAAkB,CAAC,CAAC,CAAC,EACjC,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,cAAc,CAAC,CAEzB"}