@aicalas/loopy 0.1.0

package/dist/temporal/answers.js

@@ -0,0 +1,78 @@
+import { parseChannelPollResult, parseInstanceState, } from "../core/wire.js";
+import { instanceIdPrefix } from "../identifiers.js";
+import { log } from "../log.js";
+import { ANSWER_INSTANCE_UPDATE, INSTANCE_STATE_QUERY } from "./contracts.js";
+/**
+ * Find this workflow's open instances parked on an ask, and the opaque correlation each awaiting
+ * call carries. Discovery is query-each-open-instance — list by built-in attributes, Query each —
+ * rather than a custom Search Attribute: cheap at the low-tens scale asks reach, and it reuses the
+ * `report_stuck` enumeration. An instance whose Query cannot be read (stuck, or transiently
+ * unavailable) is skipped this scan; the level-triggered tick re-observes it next time.
+ */
+export async function findAwaitingInstances(client, repository, workflow) {
+    const prefix = `${instanceIdPrefix(repository)}${workflow}:`;
+    const query = `ExecutionStatus="Running" AND WorkflowId STARTS_WITH ${JSON.stringify(prefix)}`;
+    const awaiting = [];
+    for await (const info of client.list({ query })) {
+        let state;
+        try {
+            state = parseInstanceState(await client.getHandle(info.workflowId).query(INSTANCE_STATE_QUERY));
+        }
+        catch (error) {
+            log.warning(`ask poll: cannot read state for ${info.workflowId}: ${message(error)}`);
+            continue;
+        }
+        const calls = state.calls
+            .filter((call) => call.kind === "awaiting_answer")
+            .map((call) => ({
+            callId: call.callId,
+            channel: call.channel,
+            correlation: call.correlation,
+        }));
+        if (calls.length > 0)
+            awaiting.push({ workflowId: info.workflowId, calls });
+    }
+    return 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 pollAnswers(client, channels, repository, workflow) {
+    const awaiting = await findAwaitingInstances(client, repository, workflow);
+    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: answerUpdateId(instance.workflowId, call.callId),
+                });
+                answered.push(`${instance.workflowId}:${call.callId}`);
+            }
+            catch (error) {
+                log.warning(`ask poll: ${instance.workflowId} ${call.callId}: ${message(error)}`);
+            }
+        }
+    }
+    return answered;
+}
+function answerUpdateId(workflowId, callId) {
+    return `answer:${workflowId}:${callId}`;
+}
+function message(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=answers.js.map

package/dist/temporal/answers.js.map

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

package/dist/temporal/client.d.ts

@@ -0,0 +1,13 @@
+import { Client, type ClientOptions } from "@temporalio/client";
+import { NativeConnection } from "@temporalio/worker";
+import type { TemporalSettings } from "../settings.js";
+type Connect = typeof NativeConnection.connect;
+type ClientFactory = (options: ClientOptions) => Client;
+export interface TemporalClientConnection {
+    readonly nativeConnection: NativeConnection;
+    readonly client: Client;
+    close(): Promise<void>;
+}
+export declare function connectClient(settings: TemporalSettings, connect?: Connect, createClient?: ClientFactory): Promise<TemporalClientConnection>;
+export {};
+//# sourceMappingURL=client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/temporal/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,KAAK,OAAO,GAAG,OAAO,gBAAgB,CAAC,OAAO,CAAC;AAC/C,KAAK,aAAa,GAAG,CAAC,OAAO,EAAE,aAAa,KAAK,MAAM,CAAC;AAExD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,gBAAgB,EAE1B,OAAO,GAAE,OAAyD,EAElE,YAAY,GAAE,aAAgD,GAC7D,OAAO,CAAC,wBAAwB,CAAC,CAYnC"}

package/dist/temporal/client.js

@@ -0,0 +1,20 @@
+import { Client } from "@temporalio/client";
+import { NativeConnection } from "@temporalio/worker";
+export async function connectClient(settings, 
+/* istanbul ignore next -- production native connection boundary */
+connect = NativeConnection.connect.bind(NativeConnection), 
+/* istanbul ignore next -- production Client wiring; tests inject a deterministic factory */
+createClient = (options) => new Client(options)) {
+    const nativeConnection = await connect({
+        address: settings.address,
+        tls: settings.tls,
+        ...(settings.apiKey === undefined ? {} : { apiKey: settings.apiKey }),
+    });
+    const client = createClient({ connection: nativeConnection, namespace: settings.namespace });
+    return {
+        nativeConnection,
+        client,
+        close: () => nativeConnection.close(),
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/temporal/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/temporal/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAsB,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAatD,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAA0B;AAC1B,mEAAmE;AACnE,OAAO,GAAY,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC;AAClE,4FAA4F;AAC5F,YAAY,GAAkB,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC;IAE9D,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC;QACrC,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;KACtE,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,YAAY,CAAC,EAAE,UAAU,EAAE,gBAAgB,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC;IAC7F,OAAO;QACL,gBAAgB;QAChB,MAAM;QACN,KAAK,EAAE,GAAG,EAAE,CAAC,gBAAgB,CAAC,KAAK,EAAE;KACtC,CAAC;AACJ,CAAC"}

package/dist/temporal/contracts.d.ts

@@ -0,0 +1,19 @@
+export declare const RUN_AGENT_ACTIVITY_TYPE = "run_agent";
+export declare const RUN_WATCHER_ACTIVITY_TYPE = "run_watcher";
+export declare const EMIT_EFFECT_ACTIVITY_TYPE = "emit_effect";
+export declare const CLEANUP_WORKSPACE_ACTIVITY_TYPE = "cleanup_workspace";
+export declare const EMIT_ATTENTION_ACTIVITY_TYPE = "emit_attention";
+export declare const OBSERVE_INSTANCES_ACTIVITY_TYPE = "observe_instances";
+export declare const DELIVER_QUESTION_ACTIVITY_TYPE = "deliver_question";
+export declare const POLL_WORKFLOW_TYPE = "PollWorkflow";
+/** Every user workflow is its own Workflow Type, so status selects on this Workflow ID prefix. */
+export declare const INSTANCE_ID_PREFIX = "loopy:instance:";
+export declare const INSTANCE_STATE_QUERY = "loopy_instance_state";
+export declare const RESOLVE_INSTANCE_UPDATE = "loopy_resolve";
+export declare const ANSWER_INSTANCE_UPDATE = "loopy_answer_instance";
+export declare const AGENT_CONFIGURATION_FAILURE_TYPE = "AgentActivityConfigurationError";
+export declare const EFFECT_PERMANENT_FAILURE_TYPE = "EffectPermanentError";
+export declare const WORKSPACE_PROVISIONING_FAILURE_TYPE = "WorkspaceProvisioningError";
+export declare const UNEXPECTED_AGENT_FAILURE_TYPE = "UnexpectedAgentActivityError";
+export declare const DEFINITIVE_AGENT_ACTIVITY_FAILURE_TYPES: ReadonlySet<string>;
+//# sourceMappingURL=contracts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/temporal/contracts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,cAAc,CAAC;AACnD,eAAO,MAAM,yBAAyB,gBAAgB,CAAC;AACvD,eAAO,MAAM,yBAAyB,gBAAgB,CAAC;AACvD,eAAO,MAAM,+BAA+B,sBAAsB,CAAC;AACnE,eAAO,MAAM,4BAA4B,mBAAmB,CAAC;AAC7D,eAAO,MAAM,+BAA+B,sBAAsB,CAAC;AACnE,eAAO,MAAM,8BAA8B,qBAAqB,CAAC;AACjE,eAAO,MAAM,kBAAkB,iBAAiB,CAAC;AAEjD,kGAAkG;AAClG,eAAO,MAAM,kBAAkB,oBAAoB,CAAC;AAEpD,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAC3D,eAAO,MAAM,uBAAuB,kBAAkB,CAAC;AACvD,eAAO,MAAM,sBAAsB,0BAA0B,CAAC;AAE9D,eAAO,MAAM,gCAAgC,oCAAoC,CAAC;AAClF,eAAO,MAAM,6BAA6B,yBAAyB,CAAC;AACpE,eAAO,MAAM,mCAAmC,+BAA+B,CAAC;AAChF,eAAO,MAAM,6BAA6B,iCAAiC,CAAC;AAE5E,eAAO,MAAM,uCAAuC,EAAE,WAAW,CAAC,MAAM,CAGtE,CAAC"}

package/dist/temporal/contracts.js

@@ -0,0 +1,22 @@
+export const RUN_AGENT_ACTIVITY_TYPE = "run_agent";
+export const RUN_WATCHER_ACTIVITY_TYPE = "run_watcher";
+export const EMIT_EFFECT_ACTIVITY_TYPE = "emit_effect";
+export const CLEANUP_WORKSPACE_ACTIVITY_TYPE = "cleanup_workspace";
+export const EMIT_ATTENTION_ACTIVITY_TYPE = "emit_attention";
+export const OBSERVE_INSTANCES_ACTIVITY_TYPE = "observe_instances";
+export const DELIVER_QUESTION_ACTIVITY_TYPE = "deliver_question";
+export const POLL_WORKFLOW_TYPE = "PollWorkflow";
+/** Every user workflow is its own Workflow Type, so status selects on this Workflow ID prefix. */
+export const INSTANCE_ID_PREFIX = "loopy:instance:";
+export const INSTANCE_STATE_QUERY = "loopy_instance_state";
+export const RESOLVE_INSTANCE_UPDATE = "loopy_resolve";
+export const ANSWER_INSTANCE_UPDATE = "loopy_answer_instance";
+export const AGENT_CONFIGURATION_FAILURE_TYPE = "AgentActivityConfigurationError";
+export const EFFECT_PERMANENT_FAILURE_TYPE = "EffectPermanentError";
+export const WORKSPACE_PROVISIONING_FAILURE_TYPE = "WorkspaceProvisioningError";
+export const UNEXPECTED_AGENT_FAILURE_TYPE = "UnexpectedAgentActivityError";
+export const DEFINITIVE_AGENT_ACTIVITY_FAILURE_TYPES = new Set([
+    AGENT_CONFIGURATION_FAILURE_TYPE,
+    WORKSPACE_PROVISIONING_FAILURE_TYPE,
+]);
+//# sourceMappingURL=contracts.js.map

package/dist/temporal/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/temporal/contracts.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG,WAAW,CAAC;AACnD,MAAM,CAAC,MAAM,yBAAyB,GAAG,aAAa,CAAC;AACvD,MAAM,CAAC,MAAM,yBAAyB,GAAG,aAAa,CAAC;AACvD,MAAM,CAAC,MAAM,+BAA+B,GAAG,mBAAmB,CAAC;AACnE,MAAM,CAAC,MAAM,4BAA4B,GAAG,gBAAgB,CAAC;AAC7D,MAAM,CAAC,MAAM,+BAA+B,GAAG,mBAAmB,CAAC;AACnE,MAAM,CAAC,MAAM,8BAA8B,GAAG,kBAAkB,CAAC;AACjE,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC;AAEjD,kGAAkG;AAClG,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAEpD,MAAM,CAAC,MAAM,oBAAoB,GAAG,sBAAsB,CAAC;AAC3D,MAAM,CAAC,MAAM,uBAAuB,GAAG,eAAe,CAAC;AACvD,MAAM,CAAC,MAAM,sBAAsB,GAAG,uBAAuB,CAAC;AAE9D,MAAM,CAAC,MAAM,gCAAgC,GAAG,iCAAiC,CAAC;AAClF,MAAM,CAAC,MAAM,6BAA6B,GAAG,sBAAsB,CAAC;AACpE,MAAM,CAAC,MAAM,mCAAmC,GAAG,4BAA4B,CAAC;AAChF,MAAM,CAAC,MAAM,6BAA6B,GAAG,8BAA8B,CAAC;AAE5E,MAAM,CAAC,MAAM,uCAAuC,GAAwB,IAAI,GAAG,CAAC;IAClF,gCAAgC;IAChC,mCAAmC;CACpC,CAAC,CAAC"}

package/dist/temporal/drain.d.ts

@@ -0,0 +1,19 @@
+import type { Settings } from "../settings.js";
+import { type VisibilityClient } from "./executions.js";
+import { type ScheduleClientLike } from "./schedules.js";
+export interface DrainHandle {
+    /** Resolves when the drain finishes, times out, or a second signal aborts the wait. */
+    readonly stopped: Promise<void>;
+    /** Detach the signal handlers. Required, because `stopped` may never settle. */
+    release(): void;
+}
+/**
+ * Shut down by draining: pause polling so no new instance starts, then keep serving until the open
+ * Executions close. The drain has to run here, on the process that still holds the old bundle -
+ * once a new build is serving, the work being drained would finish under code it did not start on.
+ *
+ * On timeout the process exits with polling still paused, which is the safe half-state: no new work
+ * starts until an operator deliberately runs `loopy loop` again.
+ */
+export declare function drainOnSignal(settings: Settings, schedules: ScheduleClientLike, workflows: VisibilityClient): DrainHandle;
+//# sourceMappingURL=drain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"drain.d.ts","sourceRoot":"","sources":["../../src/temporal/drain.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAuB,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAyC,KAAK,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAkBhG,MAAM,WAAW,WAAW;IAC1B,uFAAuF;IACvF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,gFAAgF;IAChF,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,kBAAkB,EAC7B,SAAS,EAAE,gBAAgB,GAC1B,WAAW,CA2Bb"}

package/dist/temporal/drain.js

@@ -0,0 +1,109 @@
+import { log } from "../log.js";
+import { countOpenExecutions } from "./executions.js";
+import { DRAIN_PAUSE_NOTE, pauseOwnedSchedules } from "./schedules.js";
+const DRAIN_SIGNALS = ["SIGINT", "SIGTERM"];
+const DRAIN_POLL_INTERVAL_MS = 2_000;
+/**
+ * Zero has to hold across two reads. A poll completes as soon as it has started its children, and
+ * Visibility indexes those children asynchronously, so a single zero can land in the gap between
+ * the poll closing and its instance appearing - reporting drained while the instance it just
+ * started is still invisible.
+ */
+const DRAIN_CONFIRMATIONS = 2;
+/**
+ * Enough retries to ride out a blip, few enough that a Visibility store which cannot answer at all
+ * - one without advanced Visibility, where `CountWorkflowExecutions` is unimplemented - costs
+ * seconds at shutdown rather than the whole drain timeout.
+ */
+const MAX_COUNT_FAILURES = 5;
+/**
+ * Shut down by draining: pause polling so no new instance starts, then keep serving until the open
+ * Executions close. The drain has to run here, on the process that still holds the old bundle -
+ * once a new build is serving, the work being drained would finish under code it did not start on.
+ *
+ * On timeout the process exits with polling still paused, which is the safe half-state: no new work
+ * starts until an operator deliberately runs `loopy loop` again.
+ */
+export function drainOnSignal(settings, schedules, workflows) {
+    const stopped = Promise.withResolvers();
+    let draining = false;
+    const onSignal = () => {
+        if (draining) {
+            log.warning("second signal: stopping without finishing the drain");
+            stopped.resolve();
+            return;
+        }
+        draining = true;
+        void drain(settings, schedules, workflows).then(() => stopped.resolve(), (error) => {
+            log.error("drain failed; stopping anyway", error);
+            stopped.resolve();
+        });
+    };
+    for (const signal of DRAIN_SIGNALS)
+        process.on(signal, onSignal);
+    return {
+        stopped: stopped.promise,
+        // Not `stopped.promise.finally(…)`: a caller can stop waiting on a drain that never settles -
+        // a Worker rejecting ends the run - and the handlers would outlive it.
+        release: () => {
+            for (const signal of DRAIN_SIGNALS)
+                process.removeListener(signal, onSignal);
+        },
+    };
+}
+async function drain(settings, schedules, workflows) {
+    if (settings.drainTimeoutSeconds === 0)
+        return;
+    const paused = await pauseOwnedSchedules(schedules, settings.repository, DRAIN_PAUSE_NOTE);
+    log.info(`draining: paused ${paused.length} Schedule(s)`);
+    const deadline = Date.now() + settings.drainTimeoutSeconds * 1_000;
+    let confirmations = 0;
+    let failures = 0;
+    let last = "unknown";
+    for (;;) {
+        let open;
+        try {
+            open = await countOpenExecutions(workflows, settings.repository);
+            failures = 0;
+        }
+        catch (error) {
+            // Never abandon the drain on one unreadable answer. Visibility is the only thing that can say
+            // the deployment is empty, so a blip has to be retried rather than treated as a verdict - and
+            // stopping early is precisely the outcome the drain exists to avoid.
+            failures += 1;
+            confirmations = 0;
+            if (failures >= MAX_COUNT_FAILURES) {
+                // A store that cannot answer at all is not a blip, and retrying it to the deadline would
+                // make every shutdown wait the full timeout to learn what it knew in the first ten seconds.
+                log.warning(`drain giving up: open Executions could not be counted ${failures} times in a row; polling stays paused so no new work starts`, errorMessage(error));
+                return;
+            }
+            log.info("draining: could not count open Executions, retrying", errorMessage(error));
+        }
+        if (open === 0) {
+            confirmations += 1;
+            if (confirmations >= DRAIN_CONFIRMATIONS) {
+                log.info("drained: nothing open, polling stays paused until the next start");
+                return;
+            }
+        }
+        else if (open !== undefined) {
+            confirmations = 0;
+        }
+        if (open !== undefined)
+            last = `${open}`;
+        if (Date.now() >= deadline) {
+            log.warning(`drain timed out with ${last} Execution(s) still open; polling stays paused so no new work starts`);
+            return;
+        }
+        if (open !== 0)
+            log.info(`draining: ${last} Execution(s) still open`);
+        await new Promise((resolve) => {
+            setTimeout(resolve, DRAIN_POLL_INTERVAL_MS).unref();
+        });
+    }
+}
+function errorMessage(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=drain.js.map

package/dist/temporal/drain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drain.js","sourceRoot":"","sources":["../../src/temporal/drain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhC,OAAO,EAAE,mBAAmB,EAAyB,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAA2B,MAAM,gBAAgB,CAAC;AAEhG,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAU,CAAC;AACrD,MAAM,sBAAsB,GAAG,KAAK,CAAC;AACrC;;;;;GAKG;AACH,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAC9B;;;;GAIG;AACH,MAAM,kBAAkB,GAAG,CAAC,CAAC;AAS7B;;;;;;;GAOG;AACH,MAAM,UAAU,aAAa,CAC3B,QAAkB,EAClB,SAA6B,EAC7B,SAA2B;IAE3B,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,EAAQ,CAAC;IAC9C,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,IAAI,QAAQ,EAAE,CAAC;YACb,GAAG,CAAC,OAAO,CAAC,qDAAqD,CAAC,CAAC;YACnE,OAAO,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO;QACT,CAAC;QACD,QAAQ,GAAG,IAAI,CAAC;QAChB,KAAK,KAAK,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,IAAI,CAC7C,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EACvB,CAAC,KAAK,EAAE,EAAE;YACR,GAAG,CAAC,KAAK,CAAC,+BAA+B,EAAE,KAAK,CAAC,CAAC;YAClD,OAAO,CAAC,OAAO,EAAE,CAAC;QACpB,CAAC,CACF,CAAC;IACJ,CAAC,CAAC;IACF,KAAK,MAAM,MAAM,IAAI,aAAa;QAAE,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjE,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,8FAA8F;QAC9F,uEAAuE;QACvE,OAAO,EAAE,GAAG,EAAE;YACZ,KAAK,MAAM,MAAM,IAAI,aAAa;gBAAE,OAAO,CAAC,cAAc,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC/E,CAAC;KACF,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,KAAK,CAClB,QAAkB,EAClB,SAA6B,EAC7B,SAA2B;IAE3B,IAAI,QAAQ,CAAC,mBAAmB,KAAK,CAAC;QAAE,OAAO;IAC/C,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IAC3F,GAAG,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,MAAM,cAAc,CAAC,CAAC;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,CAAC,mBAAmB,GAAG,KAAK,CAAC;IACnE,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,IAAI,GAAG,SAAS,CAAC;IACrB,SAAS,CAAC;QACR,IAAI,IAAwB,CAAC;QAC7B,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,mBAAmB,CAAC,SAAS,EAAE,QAAQ,CAAC,UAAU,CAAC,CAAC;YACjE,QAAQ,GAAG,CAAC,CAAC;QACf,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,8FAA8F;YAC9F,8FAA8F;YAC9F,qEAAqE;YACrE,QAAQ,IAAI,CAAC,CAAC;YACd,aAAa,GAAG,CAAC,CAAC;YAClB,IAAI,QAAQ,IAAI,kBAAkB,EAAE,CAAC;gBACnC,yFAAyF;gBACzF,4FAA4F;gBAC5F,GAAG,CAAC,OAAO,CACT,yDAAyD,QAAQ,6DAA6D,EAC9H,YAAY,CAAC,KAAK,CAAC,CACpB,CAAC;gBACF,OAAO;YACT,CAAC;YACD,GAAG,CAAC,IAAI,CAAC,qDAAqD,EAAE,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC;QACvF,CAAC;QACD,IAAI,IAAI,KAAK,CAAC,EAAE,CAAC;YACf,aAAa,IAAI,CAAC,CAAC;YACnB,IAAI,aAAa,IAAI,mBAAmB,EAAE,CAAC;gBACzC,GAAG,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;gBAC7E,OAAO;YACT,CAAC;QACH,CAAC;aAAM,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9B,aAAa,GAAG,CAAC,CAAC;QACpB,CAAC;QACD,IAAI,IAAI,KAAK,SAAS;YAAE,IAAI,GAAG,GAAG,IAAI,EAAE,CAAC;QACzC,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;YAC3B,GAAG,CAAC,OAAO,CACT,wBAAwB,IAAI,sEAAsE,CACnG,CAAC;YACF,OAAO;QACT,CAAC;QACD,IAAI,IAAI,KAAK,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,0BAA0B,CAAC,CAAC;QACtE,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC5B,UAAU,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC,KAAK,EAAE,CAAC;QACtD,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC"}

package/dist/temporal/executions.d.ts

@@ -0,0 +1,18 @@
+/**
+ * The Visibility surface these readers need. A real `WorkflowClient` is assignable to it - the
+ * assignment in `cli.ts` is what proves that - while a test double only has to supply what is
+ * declared here, rather than construct the SDK's response classes.
+ */
+export interface VisibilityClient {
+    count(query: string): Promise<{
+        count: number;
+    }>;
+}
+/**
+ * Count everything this deployment is serving: its instances, and the control runs its own
+ * Schedules start. Pausing a Schedule does not stop a `PollWorkflow` already running, so a drain
+ * that waited only on instances could exit while a poll is mid-watcher and leave it to resume under
+ * the next build - the hazard the drain exists to prevent, applied to loopy's own control flow.
+ */
+export declare function countOpenExecutions(client: VisibilityClient, repository: string): Promise<number>;
+//# sourceMappingURL=executions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"executions.d.ts","sourceRoot":"","sources":["../../src/temporal/executions.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAClD;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,gBAAgB,EACxB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,MAAM,CAAC,CAMjB"}

package/dist/temporal/executions.js

@@ -0,0 +1,15 @@
+import { ownedWorkflowIdPrefixes } from "../identifiers.js";
+/**
+ * Count everything this deployment is serving: its instances, and the control runs its own
+ * Schedules start. Pausing a Schedule does not stop a `PollWorkflow` already running, so a drain
+ * that waited only on instances could exit while a poll is mid-watcher and leave it to resume under
+ * the next build - the hazard the drain exists to prevent, applied to loopy's own control flow.
+ */
+export async function countOpenExecutions(client, repository) {
+    const owned = ownedWorkflowIdPrefixes(repository)
+        .map((prefix) => `WorkflowId STARTS_WITH ${JSON.stringify(prefix)}`)
+        .join(" OR ");
+    // `count` is one RPC returning the number; listing would paginate every open Execution per tick.
+    return (await client.count(`ExecutionStatus="Running" AND (${owned})`)).count;
+}
+//# sourceMappingURL=executions.js.map

package/dist/temporal/executions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executions.js","sourceRoot":"","sources":["../../src/temporal/executions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAW5D;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAwB,EACxB,UAAkB;IAElB,MAAM,KAAK,GAAG,uBAAuB,CAAC,UAAU,CAAC;SAC9C,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,0BAA0B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;SACnE,IAAI,CAAC,MAAM,CAAC,CAAC;IAChB,iGAAiG;IACjG,OAAO,CAAC,MAAM,MAAM,CAAC,KAAK,CAAC,kCAAkC,KAAK,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;AAChF,CAAC"}

package/dist/temporal/handle.d.ts

@@ -0,0 +1,39 @@
+import type { AgentHandle, AgentRequest, InferOutput, OutputSchema } from "../authoring/types.js";
+import type { AgentCallResult, CallState, HarnessConfig, JsonObject, PromptPart } from "../core/wire.js";
+export declare const DEFAULT_AGENT_TIMEOUT_MS = 1800000;
+export interface AgentInvocation {
+    handleId: string;
+    callId: string;
+    ordinal: number;
+    invocation: number;
+    harness: HarnessConfig;
+    promptParts: PromptPart[];
+    schema: JsonObject;
+    timeoutMs: number;
+    resumeSessionId: string | undefined;
+}
+export interface AgentCallHost {
+    halt(reason: string): never;
+    consumeCall(): void;
+    setCall(state: CallState): void;
+    awaitResolution(callId: string): Promise<void>;
+    takeResolution(callId: string): "retry" | "halt";
+    /** Surface a parked call through the attention port; never throws on emission failure. */
+    reportParked(callId: string, reason: string): Promise<void>;
+    invokeAgent(invocation: AgentInvocation): Promise<AgentCallResult>;
+}
+export declare class SupervisedAgentHandle implements AgentHandle {
+    readonly id: string;
+    private readonly host;
+    private readonly harness;
+    private ordinal;
+    private sessionId;
+    private busy;
+    constructor(host: AgentCallHost, id: string, harness: HarnessConfig);
+    run<S extends OutputSchema>(request: AgentRequest<S>): Promise<InferOutput<S>>;
+    private invoke;
+    private describe;
+    private engineTask;
+    private settle;
+}
+//# sourceMappingURL=handle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handle.d.ts","sourceRoot":"","sources":["../../src/temporal/handle.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAQlG,OAAO,KAAK,EACV,eAAe,EACf,SAAS,EACT,aAAa,EACb,UAAU,EACV,UAAU,EACX,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,wBAAwB,UAAY,CAAC;AAElD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,aAAa,CAAC;IACvB,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;CACrC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;IAC5B,WAAW,IAAI,IAAI,CAAC;IACpB,OAAO,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAAC;IAChC,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACjD,0FAA0F;IAC1F,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5D,WAAW,CAAC,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CACpE;AAED,qBAAa,qBAAsB,YAAW,WAAW;IACvD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,IAAI,CAAS;IAErB,YAAY,IAAI,EAAE,aAAa,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAIlE;IAED,GAAG,CAAC,CAAC,SAAS,YAAY,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAE7E;YAEa,MAAM;IAWpB,OAAO,CAAC,QAAQ;YAiBF,UAAU;IAkCxB,OAAO,CAAC,MAAM;CAoBf"}

package/dist/temporal/handle.js

@@ -0,0 +1,95 @@
+import { msToNumber } from "@temporalio/common";
+import { toJsonSchema } from "../authoring/schema.js";
+import { agentDisposition, callAddress, concurrentCallReason, reconciliationHaltReason, } from "../core/calls.js";
+export const DEFAULT_AGENT_TIMEOUT_MS = 1_800_000;
+export class SupervisedAgentHandle {
+    id;
+    host;
+    harness;
+    ordinal = 0;
+    sessionId;
+    busy = false;
+    constructor(host, id, harness) {
+        this.host = host;
+        this.id = id;
+        this.harness = harness;
+    }
+    run(request) {
+        return this.invoke(request);
+    }
+    async invoke(request) {
+        if (this.busy)
+            throw new Error(concurrentCallReason(this.id));
+        this.busy = true;
+        try {
+            this.host.consumeCall();
+            return await this.engineTask(this.describe(request));
+        }
+        finally {
+            this.busy = false;
+        }
+    }
+    describe(request) {
+        this.ordinal += 1;
+        if (request.prompt.length === 0)
+            throw new Error("prompt must have at least one part");
+        return {
+            handleId: this.id,
+            callId: callAddress(this.id, this.ordinal),
+            ordinal: this.ordinal,
+            harness: this.harness,
+            promptParts: request.prompt.map((part) => (typeof part === "string" ? part : { ...part })),
+            schema: toJsonSchema(request.output),
+            timeoutMs: request.timeout === undefined ? DEFAULT_AGENT_TIMEOUT_MS : msToNumber(request.timeout),
+        };
+    }
+    async engineTask(detail) {
+        const { callId, handleId } = detail;
+        for (let invocation = 1;; invocation += 1) {
+            this.host.setCall({ kind: "running", callId, operation: "agent", handleId, invocation });
+            const result = await this.host.invokeAgent({
+                ...detail,
+                invocation,
+                resumeSessionId: this.sessionId,
+            });
+            if (result.status !== "indeterminate" && result.sessionId !== undefined) {
+                this.sessionId = result.sessionId;
+            }
+            const disposition = agentDisposition(result);
+            if (disposition.kind !== "indeterminate")
+                return this.settle(detail, disposition);
+            this.host.setCall({
+                kind: "parked",
+                callId,
+                operation: "agent",
+                handleId,
+                invocation,
+                reason: disposition.reason,
+            });
+            await this.host.reportParked(callId, disposition.reason);
+            await this.host.awaitResolution(callId);
+            if (this.host.takeResolution(callId) === "halt") {
+                this.host.halt(reconciliationHaltReason(callId));
+            }
+            // The lost invocation may hold a session identifier Temporal never received.
+            this.sessionId = undefined;
+        }
+    }
+    settle(detail, disposition) {
+        const { callId, handleId } = detail;
+        if (disposition.kind === "returned") {
+            this.host.setCall({
+                kind: "returned",
+                callId,
+                operation: "agent",
+                handleId,
+                ...(disposition.sessionId === undefined ? {} : { sessionId: disposition.sessionId }),
+            });
+            return disposition.value;
+        }
+        const reason = disposition.kind === "deadline_exceeded" ? "agent-deadline-exceeded" : disposition.reason;
+        this.host.setCall({ kind: "failed", callId, operation: "agent", handleId, reason });
+        this.host.halt(`agent-failed:${callId}:${reason}`);
+    }
+}
+//# sourceMappingURL=handle.js.map

package/dist/temporal/handle.js.map

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

package/dist/temporal/history.d.ts

@@ -0,0 +1,75 @@
+import { type JsonValue } from "../core/wire.js";
+/**
+ * One rendered Event History line. Call addresses ride on `activityId`
+ * (`agent:<handle>:call:<n>:invocation:<i>`, `effect:<id>:call:1`), so calls and attempts need no
+ * fields of their own beyond `attempt`.
+ */
+export interface HistoryEventView {
+    eventId?: number;
+    time?: string;
+    event: string;
+    workflowType?: string;
+    attempt?: number;
+    /** The PollWorkflow Execution that started this instance. */
+    parent?: WorkflowLink;
+    /** An instance this poll started, tried to start, or observed closing. */
+    child?: WorkflowLink;
+    activityId?: string;
+    activityType?: string;
+    /** Ties an activity outcome back to its `activity-task-scheduled` line. */
+    scheduledEventId?: number;
+    signal?: string;
+    update?: UpdateView;
+    cause?: string;
+    reason?: string;
+    newRunId?: string;
+    input?: JsonValue;
+    result?: JsonValue;
+    details?: JsonValue;
+    failure?: FailureView;
+    note?: string;
+}
+export interface WorkflowLink {
+    workflowId?: string;
+    runId?: string;
+    workflowType?: string;
+}
+export interface FailureView {
+    type?: string;
+    message?: string;
+    stackTrace?: string;
+    cause?: FailureView;
+}
+export interface UpdateView {
+    id?: string;
+    name?: string;
+}
+interface LongValue {
+    toNumber(): number;
+}
+type IntegerValue = number | string | LongValue;
+interface TimestampValue {
+    seconds?: IntegerValue | null;
+    nanos?: number | null;
+}
+/** The subset of a Temporal `HistoryEvent` that audit rendering reads. */
+export interface HistoryEvent {
+    eventId?: IntegerValue | null;
+    eventTime?: TimestampValue | null;
+    /** Exactly one `<type>EventAttributes` field is set; it is located by name. */
+    [attribute: string]: unknown;
+}
+export interface ExecutionHistory {
+    events?: HistoryEvent[] | null;
+}
+export interface HistoryWorkflowHandle {
+    fetchHistory(): Promise<ExecutionHistory>;
+}
+export interface HistoryWorkflowClient {
+    getHandle(workflowId: string): HistoryWorkflowHandle;
+}
+/** Render the Event History of the latest Run behind one Workflow ID. */
+export declare function fetchExecutionHistory(client: HistoryWorkflowClient, workflowId: string): Promise<HistoryEventView[]>;
+export declare function renderHistory(history: ExecutionHistory): HistoryEventView[];
+export {};
+//# sourceMappingURL=history.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/temporal/history.ts"],"names":[],"mappings":"AAGA,OAAO,EAAe,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAW9D;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,0EAA0E;IAC1E,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,UAAU,SAAS;IACjB,QAAQ,IAAI,MAAM,CAAC;CACpB;AACD,KAAK,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEhD,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAmBD,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC9B,SAAS,CAAC,EAAE,cAAc,GAAG,IAAI,CAAC;IAClC,+EAA+E;IAC/E,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,qBAAqB;IACpC,YAAY,IAAI,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,qBAAqB;IACpC,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,CAAC;CACtD;AAED,yEAAyE;AACzE,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,qBAAqB,EAC7B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAE7B;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,gBAAgB,EAAE,CAO3E"}