@jterrats/open-orchestra 1.0.8 → 1.0.9

package/dist/runtime-lifecycle-watch.js

@@ -0,0 +1,391 @@
+import { resolveWorkspaceWritePath, exists } from "./fs-utils.js";
+import { getRuntimeExecutionAdapter } from "./runtime-adapters.js";
+import { normalizeRuntimeDelegationGuardrails, summarizeRuntimeDelegationOperations, } from "./runtime-guardrails.js";
+import { listPendingRuntimeParentActions } from "./runtime-parent-actions.js";
+import { recordRuntimeSpawnLifecycle, } from "./runtime-spawn-bridge.js";
+import { listActiveAutonomousRuns, listAutonomousRuns, } from "./autonomous-workflow.js";
+import { readEvents } from "./workspace.js";
+import { getWorkflowConfig } from "./workflow-services.js";
+import { runWorkflowRun } from "./workflow-run-commands.js";
+import { removeUndefined } from "./command-utils.js";
+export async function inspectRuntimeLifecycleWatch({ root, taskId, now = Date.now(), }) {
+    const config = await getWorkflowConfig(root);
+    const policy = normalizeRuntimeDelegationGuardrails(config.runtimePolicy?.delegation?.guardrails);
+    const events = await readEvents(root);
+    const report = summarizeRuntimeDelegationOperations({
+        policy,
+        events,
+        includeClosed: true,
+        now,
+        ...(taskId ? { taskId } : {}),
+    });
+    const active = report.sessions.filter((session) => session.active);
+    const transitions = await Promise.all(active.map((session) => inspectSession({
+        root,
+        session,
+        now,
+        timeoutMs: policy.timeoutMs,
+        ...optionalExpectedArtifact(expectedResultArtifact(events, session.sessionId)),
+    })));
+    return {
+        generatedAt: new Date(now).toISOString(),
+        inspected: active.length,
+        transitions,
+    };
+}
+export async function dispatchRuntimeParentActionsUntilIdle({ root, taskId, runtime, untilIdle, timeoutMs, idleTimeoutMs, intervalMs, now = Date.now, io, jsonOutput, }) {
+    const startedAt = now();
+    let lastProgressAt = startedAt;
+    let attempts = 0;
+    let stopReason = untilIdle
+        ? "idle"
+        : "once";
+    const passes = [];
+    while (true) {
+        attempts += 1;
+        const pass = await dispatchRuntimeParentActionPass(removeUndefined({
+            root,
+            taskId,
+            runtime,
+            now,
+            io,
+            jsonOutput,
+            passNumber: attempts,
+        }));
+        passes.push(pass);
+        if (runtimeDispatchPassMadeProgress(pass)) {
+            lastProgressAt = now();
+        }
+        if (!untilIdle) {
+            break;
+        }
+        const nextStopReason = runtimeDispatchStopReason({
+            now: now(),
+            startedAt,
+            lastProgressAt,
+            timeoutMs,
+            idleTimeoutMs,
+        });
+        if (nextStopReason) {
+            stopReason = nextStopReason;
+            break;
+        }
+        await sleep(Math.max(1, intervalMs));
+    }
+    return {
+        generatedAt: new Date(now()).toISOString(),
+        mode: untilIdle ? "until-idle" : "once",
+        ...(taskId ? { taskId } : {}),
+        ...(runtime ? { runtime } : {}),
+        attempts,
+        timeoutMs,
+        idleTimeoutMs,
+        intervalMs,
+        stopReason,
+        passes,
+    };
+}
+export async function applyRuntimeWatchTransition(root, transition, { io, jsonOutput, }) {
+    const lifecycleStatus = transition.status === "timed_out" ? "timed_out" : "completed";
+    const event = await recordRuntimeSpawnLifecycle({
+        root,
+        sessionId: transition.sessionId,
+        status: lifecycleStatus,
+        spawnedAgentId: `watcher:${transition.sessionId}`,
+        ...(transition.artifact ? { artifact: transition.artifact } : {}),
+        summary: `Runtime watch ${lifecycleStatus}: ${transition.reason}`,
+    });
+    if (lifecycleStatus === "completed") {
+        await attemptRuntimeLifecycleAutoResume({
+            root,
+            sessionId: transition.sessionId,
+            status: "completed",
+            disabled: false,
+            jsonOutput,
+            io,
+        });
+    }
+    return { sessionId: transition.sessionId, status: event.type, applied: true };
+}
+export async function attemptRuntimeLifecycleAutoResume({ root, sessionId, status, disabled, jsonOutput, io, }) {
+    if (disabled) {
+        return { status: "skipped", reason: "disabled by --no-auto-resume" };
+    }
+    if (status !== "completed" && status !== "closed") {
+        return {
+            status: "skipped",
+            reason: `lifecycle status ${status} does not auto-resume workflow`,
+        };
+    }
+    const run = await findPausedRunForRuntimeSession(root, sessionId);
+    if (!run) {
+        return {
+            status: "skipped",
+            reason: "no paused workflow run is waiting on this runtime session",
+        };
+    }
+    const resumeOutput = [];
+    const resumeIo = jsonOutput
+        ? { log: (line) => resumeOutput.push(line) }
+        : io;
+    await runWorkflowRun(removeUndefined({
+        task: run.taskId,
+        resume: run.id,
+        "phase-execution": run.phaseExecutionMode ?? "auto",
+        json: jsonOutput,
+    }), resumeIo, root);
+    const resumed = await findRunById(root, run.id);
+    return {
+        status: "resumed",
+        runId: run.id,
+        taskId: run.taskId,
+        transition: workflowResumeTransition(resumed),
+        output: resumeOutput,
+    };
+}
+async function dispatchRuntimeParentActionPass({ root, taskId, runtime, now, io, jsonOutput, passNumber, }) {
+    const actionResults = await dispatchPendingParentActions(removeUndefined({
+        root,
+        taskId,
+        runtime,
+    }));
+    const watch = await inspectRuntimeLifecycleWatch({
+        root,
+        ...(taskId ? { taskId } : {}),
+        now: now(),
+    });
+    const applied = await applyRuntimeWatchTransitions({
+        root,
+        transitions: watch.transitions,
+        io,
+        jsonOutput,
+    });
+    return {
+        pass: passNumber,
+        actions: actionResults,
+        watch: { ...watch, applied },
+    };
+}
+async function dispatchPendingParentActions({ root, taskId, runtime, }) {
+    const actions = listPendingRuntimeParentActions({
+        events: await readEvents(root),
+        ...(taskId ? { taskId } : {}),
+    });
+    return Promise.all(actions.map((action) => dispatchParentAction(removeUndefined({ root, action, runtime }))));
+}
+async function applyRuntimeWatchTransitions({ root, transitions, io, jsonOutput, }) {
+    const applied = [];
+    for (const transition of transitions) {
+        if (!isTerminalWatchTransition(transition)) {
+            continue;
+        }
+        applied.push(await applyRuntimeWatchTransition(root, transition, {
+            io,
+            jsonOutput,
+        }));
+    }
+    return applied;
+}
+function isTerminalWatchTransition(transition) {
+    return transition.status === "completed" || transition.status === "timed_out";
+}
+function runtimeDispatchPassMadeProgress({ actions, watch, }) {
+    return (actions.some((result) => result.status === "dispatched") ||
+        watch.applied.length > 0);
+}
+function runtimeDispatchStopReason({ now, startedAt, lastProgressAt, timeoutMs, idleTimeoutMs, }) {
+    if (timeoutMs > 0 && now - startedAt >= timeoutMs) {
+        return "timeout";
+    }
+    if (now - lastProgressAt >= idleTimeoutMs) {
+        return "idle";
+    }
+    return undefined;
+}
+function workflowResumeTransition(run) {
+    if (run?.status === "done") {
+        return "done";
+    }
+    if (run?.status === "paused") {
+        return "blocked";
+    }
+    return "forward";
+}
+async function dispatchParentAction({ root, action, runtime, }) {
+    const base = {
+        sessionId: action.sessionId,
+        taskId: action.taskId,
+        runtime: action.runtime,
+        phase: action.phase,
+        role: action.role,
+    };
+    const reason = await blockedDispatchReason(removeUndefined({ root, action, runtime }));
+    if (reason) {
+        return { ...base, status: "skipped", reason };
+    }
+    const agentId = `dispatcher:${action.sessionId}`;
+    await recordRuntimeSpawnLifecycle({
+        root,
+        sessionId: action.sessionId,
+        status: "spawned",
+        spawnedAgentId: agentId,
+        summary: `Runtime parent action dispatched: ${action.action.kind}`,
+    });
+    return {
+        ...base,
+        status: "dispatched",
+        agentId,
+        reason: `dispatched ${action.action.kind} through active parent runtime`,
+    };
+}
+async function blockedDispatchReason({ root, action, runtime, }) {
+    if (!action.actionable)
+        return action.rationale;
+    if (runtime && action.runtime !== runtime) {
+        return `active runtime ${runtime} does not match action runtime ${action.runtime}`;
+    }
+    const sessions = await runtimeSessions(root, action.taskId);
+    const session = sessions.find((candidate) => candidate.sessionId === action.sessionId);
+    if (session?.status === "suspended") {
+        return "session is explicitly suspended";
+    }
+    if (session && !session.active) {
+        return `session status ${session.status} is not dispatchable`;
+    }
+    const adapter = safeRuntimeAdapter(action.runtime);
+    if (!adapter)
+        return `runtime ${action.runtime} is not available`;
+    if (adapter.subagents.spawn.mode === "unsupported") {
+        return `runtime ${action.runtime} does not support safe parent dispatch`;
+    }
+    if (!adapter.subagents.spawn.requiresParentRuntime) {
+        return `runtime ${action.runtime} does not expose a parent runtime action`;
+    }
+    if (action.action.kind === "manual-runtime-request") {
+        return "manual runtime requests are not auto-dispatchable";
+    }
+    if (adapter.subagents.spawn.tool !== action.action.tool) {
+        return `action tool ${action.action.tool} does not match runtime tool ${adapter.subagents.spawn.tool}`;
+    }
+    return undefined;
+}
+async function runtimeSessions(root, taskId) {
+    const config = await getWorkflowConfig(root);
+    const policy = normalizeRuntimeDelegationGuardrails(config.runtimePolicy?.delegation?.guardrails);
+    return summarizeRuntimeDelegationOperations({
+        policy,
+        events: await readEvents(root),
+        taskId,
+        includeClosed: true,
+    }).sessions;
+}
+function safeRuntimeAdapter(runtime) {
+    try {
+        return getRuntimeExecutionAdapter(runtime);
+    }
+    catch {
+        return undefined;
+    }
+}
+async function inspectSession({ root, session, now, timeoutMs, expectedArtifact, }) {
+    const base = {
+        sessionId: session.sessionId,
+        taskId: session.taskId,
+        ...(session.runtime ? { runtime: session.runtime } : {}),
+        ...(session.phase ? { phase: session.phase } : {}),
+        ...(session.role ? { role: session.role } : {}),
+        currentStatus: session.status,
+    };
+    if (session.status === "requested") {
+        return {
+            ...base,
+            status: "waiting",
+            reason: "session is requested but has not been spawned",
+        };
+    }
+    if (session.status === "queued" || session.status === "suspended") {
+        return {
+            ...base,
+            status: "skipped",
+            reason: `session status ${session.status} is not watchable`,
+        };
+    }
+    const ageMs = Math.max(0, now - Date.parse(session.updatedAt));
+    if (ageMs > timeoutMs) {
+        return {
+            ...base,
+            status: "timed_out",
+            reason: `session exceeded timeout ${timeoutMs}ms`,
+        };
+    }
+    if (!expectedArtifact) {
+        return {
+            ...base,
+            status: "waiting",
+            reason: "no expected result artifact is known yet",
+        };
+    }
+    if (!isSafeHandoffArtifact(expectedArtifact)) {
+        return {
+            ...base,
+            status: "skipped",
+            artifact: expectedArtifact,
+            reason: "expected artifact is not a safe workflow handoff path",
+        };
+    }
+    if (await exists(resolveWorkspaceWritePath(root, expectedArtifact))) {
+        return {
+            ...base,
+            status: "completed",
+            artifact: expectedArtifact,
+            reason: "expected handoff artifact exists",
+        };
+    }
+    return {
+        ...base,
+        status: "waiting",
+        artifact: expectedArtifact,
+        reason: "expected handoff artifact is not present yet",
+    };
+}
+function expectedResultArtifact(events, sessionId) {
+    for (const event of [...events].sort((left, right) => right.timestamp.localeCompare(left.timestamp))) {
+        if (event.metadata.sessionId !== sessionId)
+            continue;
+        const direct = event.metadata.expectedResultArtifact;
+        if (typeof direct === "string")
+            return direct;
+        const action = event.metadata.parentRuntimeAction;
+        if (!action || typeof action !== "object")
+            continue;
+        const payload = action.payload;
+        if (!payload || typeof payload !== "object")
+            continue;
+        const artifact = payload
+            .expectedResultArtifact;
+        if (typeof artifact === "string")
+            return artifact;
+    }
+    return undefined;
+}
+function isSafeHandoffArtifact(artifact) {
+    return (artifact.startsWith(".agent-workflow/handoffs/") && !artifact.includes(".."));
+}
+function optionalExpectedArtifact(expectedArtifact) {
+    return expectedArtifact ? { expectedArtifact } : {};
+}
+async function findPausedRunForRuntimeSession(root, sessionId) {
+    return (await listActiveAutonomousRuns(root)).find((run) => run.status === "paused" &&
+        run.phases.some((phase) => phase.status === "blocked" &&
+            phase.executor?.executor === "runtime-native-subagent" &&
+            phase.executor.sessionId === sessionId));
+}
+async function findRunById(root, runId) {
+    return (await listAutonomousRuns(root)).find((run) => run.id === runId);
+}
+function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+//# sourceMappingURL=runtime-lifecycle-watch.js.map

package/dist/runtime-lifecycle-watch.js.map

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

package/dist/runtime-parent-actions.d.ts

@@ -1,10 +1,15 @@
-import type { RuntimeDelegationAssignment, RuntimeExecutionAdapter, RuntimeParentAction } from "./types.js";
-export declare function buildRuntimeParentAction({ runtime, sessionId, phase, role, assignment, promptArtifact, expectedResultArtifact, }: {
+import type { EventEntry, PendingRuntimeParentAction, RuntimeDelegationAssignment, RuntimeExecutionAdapter, RuntimeParentAction } from "./types.js";
+export declare function buildRuntimeParentAction({ runtime, sessionId, phase, role, assignment, promptArtifact, contextManifestArtifact, expectedResultArtifact, }: {
     runtime: RuntimeExecutionAdapter;
     sessionId: string;
     phase: string;
     role: string;
     assignment: RuntimeDelegationAssignment;
     promptArtifact: string;
+    contextManifestArtifact?: string;
     expectedResultArtifact: string;
 }): RuntimeParentAction;
+export declare function listPendingRuntimeParentActions({ events, taskId, }: {
+    events: EventEntry[];
+    taskId?: string;
+}): PendingRuntimeParentAction[];

package/dist/runtime-parent-actions.js

@@ -1,4 +1,4 @@
-export function buildRuntimeParentAction({ runtime, sessionId, phase, role, assignment, promptArtifact, expectedResultArtifact, }) {
+export function buildRuntimeParentAction({ runtime, sessionId, phase, role, assignment, promptArtifact, contextManifestArtifact, expectedResultArtifact, }) {
     const tool = runtime.subagents.spawn.tool ?? "native-subagent-tool";
     return {
         kind: parentActionKind(runtime.id),
@@ -11,6 +11,7 @@ export function buildRuntimeParentAction({ runtime, sessionId, phase, role, assi
         instructions: parentActionInstructions(runtime.id, tool),
         payload: {
             promptArtifact,
+            ...(contextManifestArtifact ? { contextManifestArtifact } : {}),
             expectedResultArtifact,
             ownershipPaths: assignment.paths,
             allowedCommands: assignment.allowedCommands,
@@ -23,6 +24,64 @@ export function buildRuntimeParentAction({ runtime, sessionId, phase, role, assi
         },
     };
 }
+export function listPendingRuntimeParentActions({ events, taskId, }) {
+    const latestPendingBySession = new Map();
+    const terminalSessionTimestamps = new Map();
+    for (const event of events) {
+        if (taskId && event.taskId !== taskId)
+            continue;
+        const sessionId = stringMetadata(event, "sessionId");
+        if (!sessionId)
+            continue;
+        if (isSpawnLifecycleEvent(event)) {
+            setLatestSessionTimestamp(terminalSessionTimestamps, sessionId, event.timestamp);
+            continue;
+        }
+        if (!parentActionStatus(event))
+            continue;
+        setLatestPendingSessionEvent(latestPendingBySession, sessionId, event);
+    }
+    return [...latestPendingBySession.values()]
+        .filter((event) => isPendingAfterTerminalSessionEvent(event, terminalSessionTimestamps))
+        .map(parentActionFromEvent)
+        .filter((action) => Boolean(action))
+        .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
+}
+function setLatestSessionTimestamp(timestampsBySession, sessionId, timestamp) {
+    const previousTimestamp = timestampsBySession.get(sessionId);
+    if (isLaterTimestamp(timestamp, previousTimestamp)) {
+        timestampsBySession.set(sessionId, timestamp);
+    }
+}
+function setLatestPendingSessionEvent(eventsBySession, sessionId, event) {
+    const previousEvent = eventsBySession.get(sessionId);
+    if (isLaterTimestamp(event.timestamp, previousEvent?.timestamp)) {
+        eventsBySession.set(sessionId, mergePendingSessionEvent(event, previousEvent));
+    }
+}
+function mergePendingSessionEvent(event, previousEvent) {
+    if (runtimeParentActionMetadata(event) || !previousEvent) {
+        return event;
+    }
+    return {
+        ...event,
+        metadata: {
+            ...previousEvent.metadata,
+            ...event.metadata,
+        },
+    };
+}
+function isPendingAfterTerminalSessionEvent(event, terminalSessionTimestamps) {
+    const sessionId = stringMetadata(event, "sessionId");
+    if (!sessionId) {
+        return true;
+    }
+    const terminalTimestamp = terminalSessionTimestamps.get(sessionId);
+    return isLaterTimestamp(event.timestamp, terminalTimestamp);
+}
+function isLaterTimestamp(timestamp, previousTimestamp) {
+    return !previousTimestamp || previousTimestamp.localeCompare(timestamp) < 0;
+}
 function parentActionKind(runtimeId) {
     if (runtimeId === "codex-cli")
         return "codex-spawn-agent";
@@ -60,4 +119,76 @@ function parentActionInstructions(runtimeId, tool) {
         "Record lifecycle state before resuming the workflow.",
     ];
 }
+function parentActionFromEvent(event) {
+    const status = parentActionStatus(event);
+    if (!status || !event.taskId)
+        return undefined;
+    const action = runtimeParentActionMetadata(event);
+    if (!action)
+        return undefined;
+    const runtime = stringMetadata(event, "runtime") ?? action.runtime;
+    const phase = stringMetadata(event, "phase") ?? action.phase;
+    const role = stringMetadata(event, "role") ?? action.role;
+    return {
+        taskId: event.taskId,
+        sessionId: action.sessionId,
+        runtime,
+        phase,
+        role,
+        status,
+        action,
+        artifacts: event.artifacts ?? [],
+        updatedAt: event.timestamp,
+        actionable: status === "requested",
+        rationale: parentActionRationale(status),
+    };
+}
+function parentActionRationale(status) {
+    if (status === "requested") {
+        return "parent runtime should execute the native action now";
+    }
+    return "request is queued until delegation capacity is available";
+}
+function parentActionStatus(event) {
+    if (event.type === "RUNTIME_SPAWN_REQUEST_RENDERED")
+        return "requested";
+    if (event.type === "RUNTIME_DELEGATION_SESSION_QUEUED")
+        return "queued";
+    return undefined;
+}
+function isSpawnLifecycleEvent(event) {
+    return (event.type === "RUNTIME_DELEGATION_SESSION_SPAWNED" ||
+        event.type === "RUNTIME_DELEGATION_SESSION_HEARTBEAT" ||
+        event.type === "RUNTIME_DELEGATION_SESSION_COMPLETED" ||
+        event.type === "RUNTIME_DELEGATION_SESSION_FAILED" ||
+        event.type === "RUNTIME_DELEGATION_SESSION_TIMED_OUT" ||
+        event.type === "RUNTIME_DELEGATION_SESSION_CANCELED" ||
+        event.type === "RUNTIME_DELEGATION_SESSION_CLOSED");
+}
+function runtimeParentActionMetadata(event) {
+    const value = event.metadata.parentRuntimeAction;
+    if (!isRuntimeParentAction(value))
+        return undefined;
+    return value;
+}
+function isRuntimeParentAction(value) {
+    if (!value || typeof value !== "object")
+        return false;
+    const candidate = value;
+    return Boolean(typeof candidate.kind === "string" &&
+        typeof candidate.runtime === "string" &&
+        typeof candidate.tool === "string" &&
+        typeof candidate.sessionId === "string" &&
+        typeof candidate.phase === "string" &&
+        typeof candidate.role === "string" &&
+        candidate.payload &&
+        typeof candidate.payload.promptArtifact === "string" &&
+        typeof candidate.payload.expectedResultArtifact === "string" &&
+        candidate.lifecycleCommands &&
+        typeof candidate.lifecycleCommands.spawned === "string");
+}
+function stringMetadata(event, key) {
+    const value = event.metadata[key];
+    return typeof value === "string" && value.trim() ? value : undefined;
+}
 //# sourceMappingURL=runtime-parent-actions.js.map

package/dist/runtime-parent-actions.js.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-parent-actions.js","sourceRoot":"","sources":["../src/runtime-parent-actions.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,wBAAwB,CAAC,EACvC,OAAO,EACP,SAAS,EACT,KAAK,EACL,IAAI,EACJ,UAAU,EACV,cAAc,EACd,sBAAsB,GASvB;IACC,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,IAAI,sBAAsB,CAAC;IACpE,OAAO;QACL,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,OAAO,CAAC,EAAE;QACnB,IAAI;QACJ,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI;QAClC,SAAS;QACT,KAAK;QACL,IAAI;QACJ,YAAY,EAAE,wBAAwB,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC;QACxD,OAAO,EAAE;YACP,cAAc;YACd,sBAAsB;YACtB,cAAc,EAAE,UAAU,CAAC,KAAK;YAChC,eAAe,EAAE,UAAU,CAAC,eAAe;YAC3C,iBAAiB,EAAE,UAAU,CAAC,iBAAiB;SAChD;QACD,iBAAiB,EAAE;YACjB,OAAO,EAAE,+CAA+C,SAAS,yCAAyC;YAC1G,SAAS,EAAE,+CAA+C,SAAS,wDAAwD,sBAAsB,EAAE;YACnJ,MAAM,EAAE,+CAA+C,SAAS,2EAA2E;SAC5I;KACF,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CACvB,SAAwC;IAExC,IAAI,SAAS,KAAK,WAAW;QAAE,OAAO,mBAAmB,CAAC;IAC1D,IAAI,SAAS,KAAK,YAAY;QAAE,OAAO,sBAAsB,CAAC;IAC9D,IAAI,SAAS,KAAK,YAAY;QAAE,OAAO,yBAAyB,CAAC;IACjE,OAAO,wBAAwB,CAAC;AAClC,CAAC;AAED,SAAS,wBAAwB,CAC/B,SAAwC,EACxC,IAAY;IAEZ,IAAI,SAAS,KAAK,WAAW,EAAE,CAAC;QAC9B,OAAO;YACL,QAAQ,IAAI,yFAAyF;YACrG,uFAAuF;YACvF,0EAA0E;SAC3E,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,KAAK,YAAY,EAAE,CAAC;QAC/B,OAAO;YACL,kFAAkF,IAAI,IAAI;YAC1F,+FAA+F;YAC/F,gGAAgG;SACjG,CAAC;IACJ,CAAC;IACD,IAAI,SAAS,KAAK,YAAY,EAAE,CAAC;QAC/B,OAAO;YACL,4DAA4D,IAAI,IAAI;YACpE,kGAAkG;YAClG,uFAAuF;SACxF,CAAC;IACJ,CAAC;IACD,OAAO;QACL,OAAO,IAAI,8EAA8E;QACzF,uFAAuF;QACvF,sDAAsD;KACvD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"runtime-parent-actions.js","sourceRoot":"","sources":["../src/runtime-parent-actions.ts"],"names":[],"mappings":"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"}