@jterrats/open-orchestra 0.4.0 → 0.4.2-beta.1

package/dist/runtime-commands.js

@@ -0,0 +1,156 @@
+import { readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { requireArg } from "./args.js";
+import { removeUndefined, parseCsv, stringOption } from "./command-utils.js";
+import { listCommandManifest } from "./command-manifest.js";
+import { resolveWorkspaceWritePath } from "./fs-utils.js";
+import { listRuntimeAdapters, parseRuntimeTarget } from "./runtime-adapters.js";
+import { renderRuntimeBootstrap, upsertRuntimeBootstrapBlock, } from "./runtime-bootstrap.js";
+import { recordRuntimeHandoff, renderRuntimeBrief, renderRuntimeDelegationPacket, } from "./runtime-execution.js";
+import { renderSubagentProtocol, upsertSubagentProtocolBlock, } from "./subagent-protocol.js";
+export async function commandsManifestCommand(options, io) {
+    const manifest = listCommandManifest();
+    if (options.json) {
+        io.log(JSON.stringify(manifest, null, 2));
+        return;
+    }
+    for (const command of manifest) {
+        io.log(command.command + " - " + command.summary);
+    }
+}
+export async function runtimeAdaptersCommand(options, io) {
+    const adapters = listRuntimeAdapters();
+    if (options.json) {
+        io.log(JSON.stringify(adapters, null, 2));
+        return;
+    }
+    for (const adapter of adapters) {
+        io.log(adapter.target +
+            " - " +
+            adapter.label +
+            " (" +
+            adapter.defaultInstructionFiles.join(", ") +
+            ")");
+    }
+}
+export async function runtimeBriefCommand(options, io) {
+    const taskId = requireArg(options, "task");
+    const runtime = stringOption(options.runtime);
+    const brief = await renderRuntimeBrief({
+        taskId,
+        ...(runtime ? { runtime } : {}),
+    });
+    if (options.json) {
+        io.log(JSON.stringify(brief, null, 2));
+        return;
+    }
+    io.log(brief.content);
+    io.log(`\nArtifact: ${brief.artifact}`);
+}
+export async function runtimeDelegatePlanCommand(options, io) {
+    const taskId = requireArg(options, "task");
+    const roles = parseCsv(options.roles);
+    if (roles.length === 0) {
+        throw new Error("runtime delegate-plan requires --roles");
+    }
+    const runtime = stringOption(options.runtime);
+    const packet = await renderRuntimeDelegationPacket({
+        taskId,
+        ...(runtime ? { runtime } : {}),
+        roles,
+    });
+    if (options.json) {
+        io.log(JSON.stringify(packet, null, 2));
+        return;
+    }
+    io.log(packet.content);
+    io.log(`\nArtifact: ${packet.artifact}`);
+}
+export async function runtimeHandoffCommand(options, io) {
+    const taskId = requireArg(options, "task");
+    const runtime = requireArg(options, "runtime");
+    const artifact = stringOption(options.artifact);
+    const summary = stringOption(options.summary);
+    const sessionId = stringOption(options["session-id"]);
+    const event = await recordRuntimeHandoff({
+        taskId,
+        runtime,
+        ...(artifact ? { artifact } : {}),
+        ...(summary ? { summary } : {}),
+        ...(sessionId ? { sessionId } : {}),
+    });
+    if (options.json) {
+        io.log(JSON.stringify(event, null, 2));
+        return;
+    }
+    io.log(`Runtime handoff recorded: ${event.id}`);
+}
+export async function runtimeBootstrapCommand(options, io) {
+    const target = parseSkillRenderTarget(stringOption(options.target) ?? "generic");
+    const bootstrap = renderRuntimeBootstrap(target);
+    const filePath = stringOption(options.file);
+    if (filePath) {
+        const resolvedFilePath = resolveWorkspaceWritePath(process.cwd(), path.normalize(filePath));
+        const existing = await readFile(resolvedFilePath, "utf8").catch(() => "");
+        const result = upsertRuntimeBootstrapBlock(existing, bootstrap, {
+            force: Boolean(options.force),
+        });
+        if (!options.check && !options["dry-run"] && !result.drift) {
+            await writeFile(resolvedFilePath, result.content);
+        }
+        if (options.json) {
+            io.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        io.log(result.changed
+            ? "Runtime bootstrap changed"
+            : "Runtime bootstrap unchanged");
+        return;
+    }
+    if (options.json) {
+        io.log(JSON.stringify(bootstrap, null, 2));
+        return;
+    }
+    io.log(bootstrap.content);
+}
+export async function protocolRenderCommand(options, io) {
+    const protocol = await renderSubagentProtocol(removeUndefined({
+        target: parseSkillRenderTarget(stringOption(options.target) ?? "generic"),
+        taskId: stringOption(options.task),
+    }));
+    if (options.json) {
+        io.log(JSON.stringify(protocol, null, 2));
+        return;
+    }
+    io.log(protocol.content);
+}
+export async function protocolBlockCommand(options, io) {
+    const filePath = requireArg(options, "file");
+    const protocol = await renderSubagentProtocol(removeUndefined({
+        target: parseSkillRenderTarget(stringOption(options.target) ?? "generic"),
+        taskId: stringOption(options.task),
+    }));
+    const existing = await readFile(filePath, "utf8").catch(() => "");
+    const result = upsertSubagentProtocolBlock(existing, protocol, {
+        force: Boolean(options.force),
+    });
+    const shouldWrite = !options.check && !options["dry-run"] && !result.drift && result.changed;
+    if (shouldWrite) {
+        await writeFile(filePath, result.content);
+    }
+    if (options.json) {
+        io.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    if (result.drift) {
+        io.log("Drift detected for subagent protocol block");
+        return;
+    }
+    io.log(result.changed
+        ? "Subagent protocol block changed"
+        : "Subagent protocol block unchanged");
+}
+function parseSkillRenderTarget(value) {
+    return parseRuntimeTarget(value);
+}
+//# sourceMappingURL=runtime-commands.js.map

package/dist/runtime-commands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-commands.js","sourceRoot":"","sources":["../src/runtime-commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChF,OAAO,EACL,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,6BAA6B,GAC9B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAGhC,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAmB,EACnB,EAAS;IAET,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAC;IACvC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1C,OAAO;IACT,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,GAAG,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAmB,EACnB,EAAS;IAET,MAAM,QAAQ,GAAG,mBAAmB,EAAE,CAAC;IACvC,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1C,OAAO;IACT,CAAC;IACD,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,EAAE,CAAC,GAAG,CACJ,OAAO,CAAC,MAAM;YACZ,KAAK;YACL,OAAO,CAAC,KAAK;YACb,IAAI;YACJ,OAAO,CAAC,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC;YAC1C,GAAG,CACN,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAmB,EACnB,EAAS;IAET,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC;QACrC,MAAM;QACN,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChC,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,OAAO;IACT,CAAC;IACD,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACtB,EAAE,CAAC,GAAG,CAAC,eAAe,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,OAAmB,EACnB,EAAS;IAET,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACtC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,MAAM,6BAA6B,CAAC;QACjD,MAAM;QACN,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,KAAK;KACN,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACxC,OAAO;IACT,CAAC;IACD,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACvB,EAAE,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAmB,EACnB,EAAS;IAET,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,MAAM,oBAAoB,CAAC;QACvC,MAAM;QACN,OAAO;QACP,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/B,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACpC,CAAC,CAAC;IACH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACvC,OAAO;IACT,CAAC;IACD,EAAE,CAAC,GAAG,CAAC,6BAA6B,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAmB,EACnB,EAAS;IAET,MAAM,MAAM,GAAG,sBAAsB,CACnC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,SAAS,CAC1C,CAAC;IACF,MAAM,SAAS,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,gBAAgB,GAAG,yBAAyB,CAChD,OAAO,CAAC,GAAG,EAAE,EACb,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CACzB,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,2BAA2B,CAAC,QAAQ,EAAE,SAAS,EAAE;YAC9D,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;SAC9B,CAAC,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;YAC3D,MAAM,SAAS,CAAC,gBAAgB,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACxC,OAAO;QACT,CAAC;QACD,EAAE,CAAC,GAAG,CACJ,MAAM,CAAC,OAAO;YACZ,CAAC,CAAC,2BAA2B;YAC7B,CAAC,CAAC,6BAA6B,CAClC,CAAC;QACF,OAAO;IACT,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IACD,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAmB,EACnB,EAAS;IAET,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAC3C,eAAe,CAAC;QACd,MAAM,EAAE,sBAAsB,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC;QACzE,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC;KACnC,CAAC,CACH,CAAC;IACF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC1C,OAAO;IACT,CAAC;IACD,EAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,OAAmB,EACnB,EAAS;IAET,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC7C,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAC3C,eAAe,CAAC;QACd,MAAM,EAAE,sBAAsB,CAAC,YAAY,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC;QACzE,MAAM,EAAE,YAAY,CAAC,OAAO,CAAC,IAAI,CAAC;KACnC,CAAC,CACH,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,2BAA2B,CAAC,QAAQ,EAAE,QAAQ,EAAE;QAC7D,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC;KAC9B,CAAC,CAAC;IACH,MAAM,WAAW,GACf,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC;IAC3E,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACxC,OAAO;IACT,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,EAAE,CAAC,GAAG,CAAC,4CAA4C,CAAC,CAAC;QACrD,OAAO;IACT,CAAC;IACD,EAAE,CAAC,GAAG,CACJ,MAAM,CAAC,OAAO;QACZ,CAAC,CAAC,iCAAiC;QACnC,CAAC,CAAC,mCAAmC,CACxC,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAa;IAC3C,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;AACnC,CAAC"}

package/dist/runtime-execution-adapters.d.ts

@@ -0,0 +1,2 @@
+import type { RuntimeExecutionAdapter } from "./types.js";
+export declare const runtimeExecutionAdapters: RuntimeExecutionAdapter[];

package/dist/runtime-execution-adapters.js

@@ -0,0 +1,163 @@
+export const runtimeExecutionAdapters = [
+    {
+        id: "claude-cli",
+        target: "claude",
+        label: "Claude CLI",
+        kind: "cli",
+        summary: "Use the authenticated Claude CLI session as the executor.",
+        execution: {
+            nonInteractive: false,
+            promptInjection: true,
+            structuredOutput: false,
+            fileEdits: true,
+            testExecution: true,
+            evidenceReturn: true,
+            requiresTty: true,
+            requiresUserApproval: true,
+            resumeSession: true,
+        },
+        subagents: {
+            runtimeNative: true,
+            parallel: true,
+            namedRoles: true,
+            forkedContext: true,
+            structuredHandoff: true,
+            fileOwnership: true,
+            requiresParentApproval: true,
+        },
+        briefOnlyFallback: true,
+        directProviderApiAllowed: false,
+        guidance: "Render a task brief or delegation packet and let Claude CLI execute with its active auth/session.",
+    },
+    {
+        id: "codex-cli",
+        target: "codex",
+        label: "Codex CLI",
+        kind: "cli",
+        summary: "Use the authenticated Codex CLI session as the executor.",
+        execution: {
+            nonInteractive: false,
+            promptInjection: true,
+            structuredOutput: false,
+            fileEdits: true,
+            testExecution: true,
+            evidenceReturn: true,
+            requiresTty: true,
+            requiresUserApproval: true,
+            resumeSession: true,
+        },
+        subagents: {
+            runtimeNative: true,
+            parallel: true,
+            namedRoles: true,
+            forkedContext: true,
+            structuredHandoff: true,
+            fileOwnership: true,
+            requiresParentApproval: true,
+        },
+        briefOnlyFallback: true,
+        directProviderApiAllowed: false,
+        guidance: "Render a task brief or delegation packet for Codex to execute locally without vendor API keys in Orchestra.",
+    },
+    {
+        id: "cursor-cli",
+        target: "cursor",
+        label: "Cursor CLI",
+        kind: "cli",
+        summary: "Use Cursor's agent runtime when available.",
+        execution: runtimeExecutionCapabilities({ resumeSession: false }),
+        subagents: runtimeSubagentCapabilities({ forkedContext: false }),
+        briefOnlyFallback: true,
+        directProviderApiAllowed: false,
+        guidance: "Render Cursor-oriented packets and keep execution inside the active Cursor runtime.",
+    },
+    {
+        id: "vscode-agent",
+        target: "vscode",
+        label: "VS Code Agent",
+        kind: "ide",
+        summary: "Use a VS Code agent extension/runtime as the executor.",
+        execution: runtimeExecutionCapabilities({
+            structuredOutput: true,
+            requiresTty: false,
+            resumeSession: false,
+        }),
+        subagents: runtimeSubagentCapabilities({
+            runtimeNative: false,
+            parallel: false,
+            forkedContext: false,
+        }),
+        briefOnlyFallback: true,
+        directProviderApiAllowed: false,
+        guidance: "Expose structured delegation packets for VS Code extensions; do not fall back to vendor APIs automatically.",
+    },
+    {
+        id: "windsurf-agent",
+        target: "windsurf",
+        label: "Windsurf Agent",
+        kind: "ide",
+        summary: "Use the active Windsurf agent runtime as the executor.",
+        execution: runtimeExecutionCapabilities({
+            requiresTty: false,
+            resumeSession: false,
+        }),
+        subagents: runtimeSubagentCapabilities({ forkedContext: false }),
+        briefOnlyFallback: true,
+        directProviderApiAllowed: false,
+        guidance: "Render Windsurf-oriented runtime packets and keep execution inside Windsurf.",
+    },
+    {
+        id: "generic-runtime",
+        target: "generic",
+        label: "Generic Runtime",
+        kind: "llm",
+        summary: "Produce portable briefs for a runtime with unknown execution hooks.",
+        execution: {
+            nonInteractive: false,
+            promptInjection: false,
+            structuredOutput: false,
+            fileEdits: false,
+            testExecution: false,
+            evidenceReturn: false,
+            requiresTty: false,
+            requiresUserApproval: true,
+            resumeSession: false,
+        },
+        subagents: runtimeSubagentCapabilities({
+            runtimeNative: false,
+            parallel: false,
+            namedRoles: false,
+            forkedContext: false,
+        }),
+        briefOnlyFallback: true,
+        directProviderApiAllowed: false,
+        guidance: "Render a portable brief only. Ask the user before any runtime-specific or API-backed execution.",
+    },
+];
+function runtimeExecutionCapabilities(overrides = {}) {
+    return {
+        nonInteractive: false,
+        promptInjection: true,
+        structuredOutput: false,
+        fileEdits: true,
+        testExecution: true,
+        evidenceReturn: true,
+        requiresTty: true,
+        requiresUserApproval: true,
+        resumeSession: true,
+        ...overrides,
+    };
+}
+function runtimeSubagentCapabilities(overrides = {}) {
+    return {
+        runtimeNative: true,
+        parallel: true,
+        namedRoles: true,
+        forkedContext: true,
+        structuredHandoff: true,
+        fileOwnership: true,
+        requiresParentApproval: true,
+        ...overrides,
+    };
+}
+//# sourceMappingURL=runtime-execution-adapters.js.map

package/dist/runtime-execution-adapters.js.map

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

package/dist/runtime-execution-renderer.d.ts

@@ -0,0 +1,10 @@
+import type { RuntimeDelegationAssignment, RuntimeDelegationPacket, RuntimeExecutionAdapter, Task, TaskContext } from "./types.js";
+export declare function runtimeBriefContent(context: TaskContext, runtime: RuntimeExecutionAdapter): string;
+export declare function runtimeDelegationContent({ context, runtime, assignments, mode, allowDirectProviderApi, }: {
+    context: TaskContext;
+    runtime: RuntimeExecutionAdapter;
+    assignments: RuntimeDelegationAssignment[];
+    mode: RuntimeDelegationPacket["mode"];
+    allowDirectProviderApi: boolean;
+}): string;
+export declare function delegationAssignment(role: string, task: Task): RuntimeDelegationAssignment;

package/dist/runtime-execution-renderer.js

@@ -0,0 +1,113 @@
+import { renderMemoryPacket } from "./memory.js";
+const DEFAULT_ALLOWED_COMMANDS = [
+    "npm run format",
+    "npm run build",
+    "npm run precommit",
+];
+export function runtimeBriefContent(context, runtime) {
+    const task = context.task;
+    return [
+        `# Runtime Execution Brief: ${task.id}`,
+        "",
+        `- Runtime: ${runtime.label} (${runtime.id})`,
+        `- Owner role: ${task.ownerRole}`,
+        "- Mode: brief-only",
+        "- Direct provider API calls: forbidden",
+        "",
+        "## Goal",
+        task.goal ?? task.title,
+        "",
+        "## Scope",
+        task.scope ?? "Use the task paths and acceptance criteria as scope.",
+        "",
+        "## Paths",
+        ...listOrNone(task.paths),
+        "",
+        "## Acceptance Criteria",
+        ...listOrNone(task.acceptanceCriteria),
+        "",
+        "## Required Workflow",
+        "- Load Orchestra context before editing.",
+        "- Respect locks and file ownership.",
+        "- Make code changes locally in this workspace.",
+        "- Run focused tests first, then `npm run precommit` before handoff.",
+        "- Record evidence and handoff back to Orchestra.",
+        "- Use `orchestra commands manifest --json` for supported commands and flags.",
+        "",
+        "## Selected Skills",
+        ...skillLines(context),
+        "",
+        renderMemoryPacket(context.memory),
+        "",
+        "## Active Locks",
+        ...lockLines(context),
+        "",
+        "## Delegation Decision",
+        ...delegationLines(context),
+        "",
+        "## Runtime Guidance",
+        runtime.guidance,
+    ].join("\n");
+}
+export function runtimeDelegationContent({ context, runtime, assignments, mode, allowDirectProviderApi, }) {
+    return [
+        `# Runtime Subagent Delegation Packet: ${context.task.id}`,
+        "",
+        `- Runtime: ${runtime.label} (${runtime.id})`,
+        `- Delegation mode: ${mode}`,
+        `- Runtime-native subagents supported: ${runtime.subagents.runtimeNative}`,
+        `- Direct provider API calls allowed: ${allowDirectProviderApi}`,
+        "",
+        "## Parent Task",
+        context.task.goal ?? context.task.title,
+        "",
+        "## Subagent Assignments",
+        ...assignments.flatMap((assignment) => [
+            `### ${assignment.role}`,
+            `- Ownership paths: ${assignment.paths.join(", ") || "none declared"}`,
+            `- Allowed commands: ${assignment.allowedCommands.join(", ")}`,
+            `- Expected artifacts: ${assignment.expectedArtifacts.join(", ")}`,
+            "- Handoff must include touched files, evidence, risks, and remaining work.",
+            "",
+        ]),
+        "## Guardrails",
+        "- Do not call OpenAI, Anthropic, or other vendor APIs from Orchestra for this delegation.",
+        "- Use the active runtime's own authenticated agent/subagent mechanism.",
+        "- If runtime-native delegation is unsupported, stop at this packet and ask the user for approval.",
+        "- Avoid overlapping writes; respect ownership paths and active locks.",
+        "- Use `orchestra commands manifest --json` for supported commands and flags.",
+    ].join("\n");
+}
+export function delegationAssignment(role, task) {
+    return {
+        role,
+        paths: task.paths ?? [],
+        allowedCommands: DEFAULT_ALLOWED_COMMANDS,
+        expectedArtifacts: ["code diff", "test evidence", "handoff notes"],
+    };
+}
+function listOrNone(items) {
+    if (!items || items.length === 0)
+        return ["- none declared"];
+    return items.map((item) => `- ${item}`);
+}
+function skillLines(context) {
+    if (context.skills.selected.length === 0)
+        return ["- none selected"];
+    return context.skills.selected.map((item) => `- ${item.skill.id}: ${item.rationale.join("; ")}`);
+}
+function lockLines(context) {
+    if (context.locks.length === 0)
+        return ["- none active"];
+    return context.locks.map((lock) => `- ${lock.id}: ${lock.path} owned by ${lock.ownerRole} for ${lock.taskId}`);
+}
+function delegationLines(context) {
+    if (!context.delegation)
+        return ["- no recorded delegation decision"];
+    return [
+        `- Recommendation: ${context.delegation.recommendation}`,
+        `- Disjoint write scopes: ${context.delegation.disjointWriteScopes}`,
+        ...context.delegation.delegates.map((delegate) => `- ${delegate.role}: ${delegate.mode} over ${delegate.writeScopes.join(", ") || "no declared scope"}`),
+    ];
+}
+//# sourceMappingURL=runtime-execution-renderer.js.map

package/dist/runtime-execution-renderer.js.map

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

package/dist/runtime-execution.d.ts

@@ -0,0 +1,27 @@
+import type { RuntimeBrief, RuntimeDelegationPacket, RuntimeSelection } from "./types.js";
+export interface RuntimeSelectionInput {
+    taskId: string;
+    role?: string;
+    runtime?: string;
+    root?: string;
+}
+export declare function selectRuntimeExecutionAdapter({ taskId, role, runtime, root, }: RuntimeSelectionInput): Promise<RuntimeSelection>;
+export declare function renderRuntimeBrief({ taskId, runtime, root, }: {
+    taskId: string;
+    runtime?: string;
+    root?: string;
+}): Promise<RuntimeBrief>;
+export declare function renderRuntimeDelegationPacket({ taskId, runtime, roles, root, }: {
+    taskId: string;
+    runtime?: string;
+    roles: string[];
+    root?: string;
+}): Promise<RuntimeDelegationPacket>;
+export declare function recordRuntimeHandoff({ taskId, runtime, artifact, summary, sessionId, root, }: {
+    taskId: string;
+    runtime: string;
+    artifact?: string;
+    summary?: string;
+    sessionId?: string;
+    root?: string;
+}): Promise<import("./types.js").EventEntry>;

package/dist/runtime-execution.js

@@ -0,0 +1,153 @@
+import path from "node:path";
+import { getRuntimeExecutionAdapter, parseRuntimeExecutionId, } from "./runtime-adapters.js";
+import { appendEvent, writeArtifact } from "./workspace.js";
+import { getTaskContext, getWorkflowConfig } from "./workflow-services.js";
+import { delegationAssignment, runtimeBriefContent, runtimeDelegationContent, } from "./runtime-execution-renderer.js";
+export async function selectRuntimeExecutionAdapter({ taskId, role, runtime, root = process.cwd(), }) {
+    const config = await getWorkflowConfig(root);
+    const policy = normalizedRuntimePolicy(config.runtimePolicy);
+    if (runtime) {
+        return selection(taskId, role ?? "parent", parseRuntimeExecutionId(runtime), "explicit");
+    }
+    const taskExecutor = policy.byTask[taskId]?.executor;
+    if (taskExecutor) {
+        return selection(taskId, role ?? "parent", taskExecutor, "task");
+    }
+    if (role && policy.byRole[role]?.executor) {
+        return selection(taskId, role, policy.byRole[role].executor, "role");
+    }
+    const defaultExecutor = policy.defaults?.executor ?? "generic-runtime";
+    return selection(taskId, role ?? "parent", defaultExecutor, "default");
+}
+export async function renderRuntimeBrief({ taskId, runtime, root = process.cwd(), }) {
+    const context = await getTaskContext(taskId, root);
+    const runtimeOption = runtime ? { runtime } : {};
+    const selected = await selectRuntimeExecutionAdapter({
+        taskId,
+        role: context.task.ownerRole,
+        root,
+        ...runtimeOption,
+    });
+    const content = runtimeBriefContent(context, selected.runtime);
+    const artifact = await writeArtifact(root, "runs", `${taskId}-runtime-${selected.runtime.id}-brief.md`, content);
+    await appendEvent(root, {
+        type: "RUNTIME_EXECUTION_BRIEF_RENDERED",
+        taskId,
+        actor: "parent",
+        summary: `Runtime brief rendered: ${selected.runtime.id}`,
+        artifacts: [artifact],
+        metadata: {
+            runtime: selected.runtime.id,
+            selectionSource: selected.source,
+            directProviderApiAllowed: false,
+            memory: {
+                hook: context.memory.hook,
+                estimatedTokens: context.memory.estimatedTokens,
+                lessonCount: context.memory.lessons.length,
+                promptCount: context.memory.prompts.length,
+            },
+        },
+    });
+    return {
+        taskId,
+        runtime: selected.runtime.id,
+        artifact,
+        content,
+        mode: "brief-only",
+        directProviderApiAllowed: false,
+    };
+}
+export async function renderRuntimeDelegationPacket({ taskId, runtime, roles, root = process.cwd(), }) {
+    const context = await getTaskContext(taskId, root);
+    const runtimeOption = runtime ? { runtime } : {};
+    const selected = await selectRuntimeExecutionAdapter({
+        taskId,
+        role: context.task.ownerRole,
+        root,
+        ...runtimeOption,
+    });
+    const config = await getWorkflowConfig(root);
+    const policy = normalizedRuntimePolicy(config.runtimePolicy);
+    const assignments = roles.map((role) => delegationAssignment(role, context.task));
+    const mode = selected.runtime.subagents.runtimeNative
+        ? policy.delegation.mode
+        : "brief-only";
+    const content = runtimeDelegationContent({
+        context,
+        runtime: selected.runtime,
+        assignments,
+        mode,
+        allowDirectProviderApi: policy.delegation.allowDirectProviderApi,
+    });
+    const artifact = await writeArtifact(root, "runs", `${taskId}-runtime-${selected.runtime.id}-delegation.md`, content);
+    await appendEvent(root, {
+        type: "RUNTIME_DELEGATION_PACKET_RENDERED",
+        taskId,
+        actor: "parent",
+        summary: `Runtime delegation packet rendered: ${selected.runtime.id}`,
+        artifacts: [artifact],
+        metadata: {
+            runtime: selected.runtime.id,
+            mode,
+            roles,
+            directProviderApiAllowed: false,
+            runtimeNativeSupported: selected.runtime.subagents.runtimeNative,
+        },
+    });
+    return {
+        taskId,
+        runtime: selected.runtime.id,
+        artifact,
+        content,
+        mode,
+        directProviderApiAllowed: false,
+        assignments,
+        requiresApproval: !selected.runtime.subagents.runtimeNative,
+    };
+}
+export async function recordRuntimeHandoff({ taskId, runtime, artifact, summary, sessionId, root = process.cwd(), }) {
+    const runtimeId = parseRuntimeExecutionId(runtime);
+    if (artifact)
+        assertWorkflowArtifactPath(artifact);
+    return appendEvent(root, {
+        type: "RUNTIME_EXECUTION_HANDOFF_RECORDED",
+        taskId,
+        actor: "parent",
+        summary: summary ?? `Runtime execution handoff recorded: ${runtimeId}`,
+        artifacts: artifact ? [artifact] : [],
+        metadata: {
+            runtime: runtimeId,
+            ...(sessionId ? { sessionId } : {}),
+            directProviderApiAllowed: false,
+        },
+    });
+}
+function selection(taskId, role, runtimeId, source) {
+    return {
+        taskId,
+        role,
+        runtime: getRuntimeExecutionAdapter(runtimeId),
+        source,
+        directProviderApiAllowed: false,
+    };
+}
+function normalizedRuntimePolicy(policy) {
+    return {
+        defaults: policy?.defaults ?? { executor: "generic-runtime" },
+        byRole: policy?.byRole ?? {},
+        byTask: policy?.byTask ?? {},
+        delegation: {
+            mode: policy?.delegation?.mode ?? "runtime-native",
+            allowDirectProviderApi: policy?.delegation?.allowDirectProviderApi ?? false,
+        },
+    };
+}
+function assertWorkflowArtifactPath(artifact) {
+    const normalized = path.normalize(artifact);
+    if (normalized.startsWith("..") ||
+        path.isAbsolute(normalized) ||
+        !normalized.startsWith(".agent-workflow")) {
+        throw new Error("runtime artifact must be workspace workflow-local");
+    }
+}
+//# sourceMappingURL=runtime-execution.js.map

package/dist/runtime-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-execution.js","sourceRoot":"","sources":["../src/runtime-execution.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,GACxB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3E,OAAO,EACL,oBAAoB,EACpB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,iCAAiC,CAAC;AAgBzC,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,EAClD,MAAM,EACN,IAAI,EACJ,OAAO,EACP,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,GACE;IACtB,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,uBAAuB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC7D,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,SAAS,CACd,MAAM,EACN,IAAI,IAAI,QAAQ,EAChB,uBAAuB,CAAC,OAAO,CAAC,EAChC,UAAU,CACX,CAAC;IACJ,CAAC;IACD,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC;IACrD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,SAAS,CAAC,MAAM,EAAE,IAAI,IAAI,QAAQ,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;IACnE,CAAC;IACD,IAAI,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAE,CAAC,QAAS,EAAE,MAAM,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,eAAe,GAAG,MAAM,CAAC,QAAQ,EAAE,QAAQ,IAAI,iBAAiB,CAAC;IACvE,OAAO,SAAS,CAAC,MAAM,EAAE,IAAI,IAAI,QAAQ,EAAE,eAAe,EAAE,SAAS,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,EACvC,MAAM,EACN,OAAO,EACP,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,GAKrB;IACC,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACnD,MAAM,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM,6BAA6B,CAAC;QACnD,MAAM;QACN,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS;QAC5B,IAAI;QACJ,GAAG,aAAa;KACjB,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,mBAAmB,CAAC,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,MAAM,aAAa,CAClC,IAAI,EACJ,MAAM,EACN,GAAG,MAAM,YAAY,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,EACnD,OAAO,CACR,CAAC;IACF,MAAM,WAAW,CAAC,IAAI,EAAE;QACtB,IAAI,EAAE,kCAAkC;QACxC,MAAM;QACN,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,2BAA2B,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE;QACzD,SAAS,EAAE,CAAC,QAAQ,CAAC;QACrB,QAAQ,EAAE;YACR,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE;YAC5B,eAAe,EAAE,QAAQ,CAAC,MAAM;YAChC,wBAAwB,EAAE,KAAK;YAC/B,MAAM,EAAE;gBACN,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI;gBACzB,eAAe,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe;gBAC/C,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM;gBAC1C,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM;aAC3C;SACF;KACF,CAAC,CAAC;IACH,OAAO;QACL,MAAM;QACN,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE;QAC5B,QAAQ;QACR,OAAO;QACP,IAAI,EAAE,YAAY;QAClB,wBAAwB,EAAE,KAAK;KAChC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,EAClD,MAAM,EACN,OAAO,EACP,KAAK,EACL,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,GAMrB;IACC,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACnD,MAAM,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACjD,MAAM,QAAQ,GAAG,MAAM,6BAA6B,CAAC;QACnD,MAAM;QACN,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,SAAS;QAC5B,IAAI;QACJ,GAAG,aAAa;KACjB,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,uBAAuB,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC7D,MAAM,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACrC,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CACzC,CAAC;IACF,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,aAAa;QACnD,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI;QACxB,CAAC,CAAC,YAAY,CAAC;IACjB,MAAM,OAAO,GAAG,wBAAwB,CAAC;QACvC,OAAO;QACP,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,WAAW;QACX,IAAI;QACJ,sBAAsB,EAAE,MAAM,CAAC,UAAU,CAAC,sBAAsB;KACjE,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,MAAM,aAAa,CAClC,IAAI,EACJ,MAAM,EACN,GAAG,MAAM,YAAY,QAAQ,CAAC,OAAO,CAAC,EAAE,gBAAgB,EACxD,OAAO,CACR,CAAC;IACF,MAAM,WAAW,CAAC,IAAI,EAAE;QACtB,IAAI,EAAE,oCAAoC;QAC1C,MAAM;QACN,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,uCAAuC,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE;QACrE,SAAS,EAAE,CAAC,QAAQ,CAAC;QACrB,QAAQ,EAAE;YACR,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE;YAC5B,IAAI;YACJ,KAAK;YACL,wBAAwB,EAAE,KAAK;YAC/B,sBAAsB,EAAE,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,aAAa;SACjE;KACF,CAAC,CAAC;IACH,OAAO;QACL,MAAM;QACN,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,EAAE;QAC5B,QAAQ;QACR,OAAO;QACP,IAAI;QACJ,wBAAwB,EAAE,KAAK;QAC/B,WAAW;QACX,gBAAgB,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,aAAa;KAC5D,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,EACzC,MAAM,EACN,OAAO,EACP,QAAQ,EACR,OAAO,EACP,SAAS,EACT,IAAI,GAAG,OAAO,CAAC,GAAG,EAAE,GAQrB;IACC,MAAM,SAAS,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,QAAQ;QAAE,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IACnD,OAAO,WAAW,CAAC,IAAI,EAAE;QACvB,IAAI,EAAE,oCAAoC;QAC1C,MAAM;QACN,KAAK,EAAE,QAAQ;QACf,OAAO,EAAE,OAAO,IAAI,uCAAuC,SAAS,EAAE;QACtE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE;QACrC,QAAQ,EAAE;YACR,OAAO,EAAE,SAAS;YAClB,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnC,wBAAwB,EAAE,KAAK;SAChC;KACF,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAChB,MAAc,EACd,IAAY,EACZ,SAA6B,EAC7B,MAAkC;IAElC,OAAO;QACL,MAAM;QACN,IAAI;QACJ,OAAO,EAAE,0BAA0B,CAAC,SAAS,CAAC;QAC9C,MAAM;QACN,wBAAwB,EAAE,KAAK;KAChC,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAC9B,MAA0C;IAE1C,OAAO;QACL,QAAQ,EAAE,MAAM,EAAE,QAAQ,IAAI,EAAE,QAAQ,EAAE,iBAAiB,EAAE;QAC7D,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE;QAC5B,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,EAAE;QAC5B,UAAU,EAAE;YACV,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,IAAI,gBAAgB;YAClD,sBAAsB,EACpB,MAAM,EAAE,UAAU,EAAE,sBAAsB,IAAI,KAAK;SACtD;KACF,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CAAC,QAAgB;IAClD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC5C,IACE,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC;QAC3B,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;QAC3B,CAAC,UAAU,CAAC,UAAU,CAAC,iBAAiB,CAAC,EACzC,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC,CAAC;IACvE,CAAC;AACH,CAAC"}