lorenz 0.1.0

package/packages/agent-runner/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "@lorenz/agent-runner",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "dependencies": {
+    "@lorenz/config": "file:../config",
+    "@lorenz/dispatch": "file:../dispatch",
+    "@lorenz/domain": "file:../domain",
+    "@lorenz/issue": "file:../issue",
+    "@lorenz/mcp": "file:../mcp",
+    "@lorenz/prompt": "file:../prompt"
+  }
+}

package/packages/agent-sdk/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { AgentExecutorRegistry, defaultAgentExecutorRegistry, type AgentExecutorProvider, } from "./provider.js";
+//# sourceMappingURL=index.d.ts.map

package/packages/agent-sdk/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,4BAA4B,EAC5B,KAAK,qBAAqB,GAC3B,MAAM,eAAe,CAAC"}

package/packages/agent-sdk/dist/index.js

@@ -0,0 +1,2 @@
+export { AgentExecutorRegistry, defaultAgentExecutorRegistry, } from "./provider.js";
+//# sourceMappingURL=index.js.map

package/packages/agent-sdk/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,EACrB,4BAA4B,GAE7B,MAAM,eAAe,CAAC"}

package/packages/agent-sdk/dist/provider.d.ts

@@ -0,0 +1,66 @@
+import type { AgentConfig, AgentExecutor, AgentKind, Settings } from "@lorenz/domain";
+/**
+ * Everything Symphony needs to know about one way of running agents, bundled as a single
+ * extension point. An executor provider owns the runtime driver behind one value of
+ * `agents.<kind>.executor` (e.g. `"acp"` drives a bridge subprocess over the Agent Client
+ * Protocol) and the validation of agent records that select it.
+ *
+ * The core (config validation, agent-runner, CLI) resolves executors exclusively through
+ * an {@link AgentExecutorRegistry}; adding a new way to run agents means implementing this
+ * interface and registering it at the composition root - no core package changes.
+ */
+export interface AgentExecutorProvider {
+    /** Executor selector matched against `agents.<kind>.executor`. */
+    readonly executor: string;
+    /**
+     * snake_case → camelCase alias map for this executor's keys in an `agents.<kind>` config
+     * record (e.g. `{ bridge_command: "bridgeCommand" }`). Applied before {@link parseOptions}.
+     */
+    readonly configAliases?: Readonly<Record<string, string>> | undefined;
+    /**
+     * Validate and normalize the executor-specific keys of an `agents.<kind>` config record
+     * (aliases already applied). Called at config-parse time; throw with a message naming the
+     * offending option on invalid input. The returned record becomes the record's
+     * `AgentConfig.options`.
+     */
+    parseOptions?(options: Record<string, unknown>, context: {
+        env: NodeJS.ProcessEnv;
+        /**
+         * Config-layer secret resolution (`$VAR` and `op://` references, with an optional
+         * env-var fallback) for executor option values. Present when invoked by the config
+         * parser.
+         */
+        resolveSecret?: (value: string | undefined, fallbackEnvVar?: string) => string | undefined;
+    }): Record<string, unknown>;
+    /**
+     * Throw when an agent record selecting this executor is not runnable (missing command,
+     * invalid combination, ...). Called once at startup by `validateDispatchConfig`.
+     */
+    validateAgent?(kind: AgentKind, config: AgentConfig, settings: Settings): void;
+    /** Build the executor that drives sessions for the given agent kind. */
+    createExecutor(kind: AgentKind, settings: Settings): AgentExecutor | Promise<AgentExecutor>;
+    /**
+     * Workspace-relative directory this executor's agent reads skills from (e.g. `.codex/skills`
+     * for Codex, `.claude/skills` for Claude). The composition root overlays the resolved
+     * `agent.skills` (plus mounted tool packs' bundled skills) into this directory before launch.
+     * Defaults to `.codex/skills` when a provider does not implement it.
+     */
+    skillsDir?(kind: AgentKind, config: AgentConfig): string;
+}
+/** Lookup table of {@link AgentExecutorProvider}s keyed by their `executor` selector. */
+export declare class AgentExecutorRegistry {
+    private readonly providers;
+    /** Register a provider. Throws when a different provider already claims the selector. */
+    register(provider: AgentExecutorProvider): void;
+    get(executor: string | undefined): AgentExecutorProvider | undefined;
+    /** Like {@link get} but throws an error listing the known executor selectors. */
+    require(executor: string): AgentExecutorProvider;
+    executors(): string[];
+}
+/**
+ * Process-wide registry used as the default by config validation and the CLI. Registration
+ * happens at the composition root; library code only reads from it. Call sites that need
+ * isolation can construct their own {@link AgentExecutorRegistry} and pass it explicitly.
+ */
+export declare const defaultAgentExecutorRegistry: AgentExecutorRegistry;
+//# sourceMappingURL=provider.d.ts.map

package/packages/agent-sdk/dist/provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.d.ts","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEtF;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IACtE;;;;;OAKG;IACH,YAAY,CAAC,CACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE;QACP,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;QACvB;;;;WAIG;QACH,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,cAAc,CAAC,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;KAC5F,GACA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3B;;;OAGG;IACH,aAAa,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAAC;IAC/E,wEAAwE;IACxE,cAAc,CAAC,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,GAAG,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAC5F;;;;;OAKG;IACH,SAAS,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,MAAM,CAAC;CAC1D;AAED,yFAAyF;AACzF,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA4C;IAEtE,yFAAyF;IACzF,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,GAAG,IAAI;IAU/C,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,qBAAqB,GAAG,SAAS;IAIpE,iFAAiF;IACjF,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB;IAUhD,SAAS,IAAI,MAAM,EAAE;CAGtB;AAED;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,uBAA8B,CAAC"}

package/packages/agent-sdk/dist/provider.js

@@ -0,0 +1,38 @@
+/** Lookup table of {@link AgentExecutorProvider}s keyed by their `executor` selector. */
+export class AgentExecutorRegistry {
+    providers = new Map();
+    /** Register a provider. Throws when a different provider already claims the selector. */
+    register(provider) {
+        const executor = provider.executor.trim();
+        if (!executor)
+            throw new Error("agent executor selector must not be blank");
+        const existing = this.providers.get(executor);
+        if (existing && existing !== provider) {
+            throw new Error(`agent executor provider already registered: ${executor}`);
+        }
+        this.providers.set(executor, provider);
+    }
+    get(executor) {
+        return executor === undefined ? undefined : this.providers.get(executor);
+    }
+    /** Like {@link get} but throws an error listing the known executor selectors. */
+    require(executor) {
+        const provider = this.providers.get(executor);
+        if (!provider) {
+            const known = this.executors();
+            const hint = known.length > 0 ? ` (known executors: ${known.join(", ")})` : "";
+            throw new Error(`unsupported agent executor: ${executor}${hint}`);
+        }
+        return provider;
+    }
+    executors() {
+        return [...this.providers.keys()].sort();
+    }
+}
+/**
+ * Process-wide registry used as the default by config validation and the CLI. Registration
+ * happens at the composition root; library code only reads from it. Call sites that need
+ * isolation can construct their own {@link AgentExecutorRegistry} and pass it explicitly.
+ */
+export const defaultAgentExecutorRegistry = new AgentExecutorRegistry();
+//# sourceMappingURL=provider.js.map

package/packages/agent-sdk/dist/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../src/provider.ts"],"names":[],"mappings":"AAsDA,yFAAyF;AACzF,MAAM,OAAO,qBAAqB;IACf,SAAS,GAAG,IAAI,GAAG,EAAiC,CAAC;IAEtE,yFAAyF;IACzF,QAAQ,CAAC,QAA+B;QACtC,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC5E,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,QAAQ,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,+CAA+C,QAAQ,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,GAAG,CAAC,QAA4B;QAC9B,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3E,CAAC;IAED,iFAAiF;IACjF,OAAO,CAAC,QAAgB;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YAC/B,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,sBAAsB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/E,MAAM,IAAI,KAAK,CAAC,+BAA+B,QAAQ,GAAG,IAAI,EAAE,CAAC,CAAC;QACpE,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,SAAS;QACP,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC3C,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,IAAI,qBAAqB,EAAE,CAAC"}

package/packages/agent-sdk/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@lorenz/agent-sdk",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "dependencies": {
+    "@lorenz/domain": "file:../domain"
+  }
+}

package/packages/cli-kit/dist/index.d.ts

@@ -0,0 +1,20 @@
+import type { Command } from "commander";
+export type ParseResult<T> = {
+    status: "ok";
+    options: T;
+} | {
+    status: "help";
+    message: string;
+} | {
+    status: "error";
+    message: string;
+};
+export declare function configureCommandForParse(command: Command): Command;
+export declare function configureCommandForMain(command: Command): Command;
+export declare function hasHelpFlag(args: string[]): boolean;
+export declare function parseNonNegativeInteger(option: string): (value: string) => number;
+export declare function parsePositiveInteger(option: string): (value: string) => number;
+export declare function parseRequiredValue(option: string, label?: string): (value: string) => string;
+export declare function commanderErrorMessage(error: unknown): string;
+export declare function isCommanderHelp(error: unknown): boolean;
+//# sourceMappingURL=index.d.ts.map

package/packages/cli-kit/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGzC,MAAM,MAAM,WAAW,CAAC,CAAC,IACrB;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,CAAC,CAAA;CAAE,GAC5B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAMlE;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAMjE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAEnD;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAOjF;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAO9E;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,SAAU,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAM7F;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAgB5D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAEvD"}

package/packages/cli-kit/dist/index.js

@@ -0,0 +1,72 @@
+import { InvalidArgumentError } from "commander";
+export function configureCommandForParse(command) {
+    return command.exitOverride().configureOutput({
+        writeErr: () => undefined,
+        writeOut: () => undefined,
+        outputError: () => undefined,
+    });
+}
+export function configureCommandForMain(command) {
+    return command.exitOverride().configureOutput({
+        writeOut: (value) => process.stdout.write(value),
+        writeErr: () => undefined,
+        outputError: () => undefined,
+    });
+}
+export function hasHelpFlag(args) {
+    return args.includes("--help") || args.includes("-h");
+}
+export function parseNonNegativeInteger(option) {
+    return (value) => {
+        const parsed = Number(value);
+        if (!Number.isInteger(parsed) || parsed < 0)
+            throw new InvalidArgumentError(`${option} must be a non-negative integer`);
+        return parsed;
+    };
+}
+export function parsePositiveInteger(option) {
+    return (value) => {
+        const parsed = Number(value);
+        if (!Number.isInteger(parsed) || parsed <= 0)
+            throw new InvalidArgumentError(`${option} must be a positive integer`);
+        return parsed;
+    };
+}
+export function parseRequiredValue(option, label = "value") {
+    return (value) => {
+        if (!value || value.trim() === "")
+            throw new InvalidArgumentError(`${option} requires a ${label}`);
+        return value;
+    };
+}
+export function commanderErrorMessage(error) {
+    const code = commanderErrorCode(error);
+    const message = error instanceof Error ? error.message : String(error);
+    if (code === "commander.unknownOption") {
+        const option = /unknown option '([^']+)'/.exec(message)?.[1];
+        return `Unknown option: ${option ?? message}`;
+    }
+    if (code === "commander.optionMissingArgument") {
+        const option = /option '([^' <]+)/.exec(message)?.[1];
+        if (option === "--limit")
+            return "--limit must be a positive integer";
+        if (option === "--port")
+            return "--port must be a non-negative integer";
+        if (option === "--logs-root")
+            return "--logs-root requires a path";
+        if (option)
+            return `${option} requires a value`;
+    }
+    if (code === "commander.invalidArgument")
+        return message.split(". ").at(-1) ?? message;
+    return message;
+}
+export function isCommanderHelp(error) {
+    return commanderErrorCode(error) === "commander.helpDisplayed";
+}
+function commanderErrorCode(error) {
+    return typeof error === "object" && error !== null && "code" in error
+        ? String(error.code)
+        : undefined;
+}
+//# sourceMappingURL=index.js.map

package/packages/cli-kit/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAOjD,MAAM,UAAU,wBAAwB,CAAC,OAAgB;IACvD,OAAO,OAAO,CAAC,YAAY,EAAE,CAAC,eAAe,CAAC;QAC5C,QAAQ,EAAE,GAAG,EAAE,CAAC,SAAS;QACzB,QAAQ,EAAE,GAAG,EAAE,CAAC,SAAS;QACzB,WAAW,EAAE,GAAG,EAAE,CAAC,SAAS;KAC7B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO,OAAO,CAAC,YAAY,EAAE,CAAC,eAAe,CAAC;QAC5C,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC;QAChD,QAAQ,EAAE,GAAG,EAAE,CAAC,SAAS;QACzB,WAAW,EAAE,GAAG,EAAE,CAAC,SAAS;KAC7B,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAc;IACxC,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,MAAc;IACpD,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC;YACzC,MAAM,IAAI,oBAAoB,CAAC,GAAG,MAAM,iCAAiC,CAAC,CAAC;QAC7E,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC;YAC1C,MAAM,IAAI,oBAAoB,CAAC,GAAG,MAAM,6BAA6B,CAAC,CAAC;QACzE,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,KAAK,GAAG,OAAO;IAChE,OAAO,CAAC,KAAK,EAAE,EAAE;QACf,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;YAC/B,MAAM,IAAI,oBAAoB,CAAC,GAAG,MAAM,eAAe,KAAK,EAAE,CAAC,CAAC;QAClE,OAAO,KAAK,CAAC;IACf,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,MAAM,IAAI,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,IAAI,IAAI,KAAK,yBAAyB,EAAE,CAAC;QACvC,MAAM,MAAM,GAAG,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7D,OAAO,mBAAmB,MAAM,IAAI,OAAO,EAAE,CAAC;IAChD,CAAC;IACD,IAAI,IAAI,KAAK,iCAAiC,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,mBAAmB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACtD,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,oCAAoC,CAAC;QACtE,IAAI,MAAM,KAAK,QAAQ;YAAE,OAAO,uCAAuC,CAAC;QACxE,IAAI,MAAM,KAAK,aAAa;YAAE,OAAO,6BAA6B,CAAC;QACnE,IAAI,MAAM;YAAE,OAAO,GAAG,MAAM,mBAAmB,CAAC;IAClD,CAAC;IACD,IAAI,IAAI,KAAK,2BAA2B;QAAE,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;IACvF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,kBAAkB,CAAC,KAAK,CAAC,KAAK,yBAAyB,CAAC;AACjE,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,MAAM,IAAI,KAAK;QACnE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC;QACpB,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC"}

package/packages/cli-kit/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "@lorenz/cli-kit",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "dependencies": {
+    "commander": "^14.0.3"
+  }
+}

package/packages/config/dist/aliases.d.ts

@@ -0,0 +1,10 @@
+export declare const hooksAliases: {
+    after_create: string;
+    before_run: string;
+    after_run: string;
+    before_remove: string;
+    timeout_ms: string;
+};
+export declare function normalizeWorkflowConfig(value: unknown): unknown;
+export declare function normalizeAliases(raw: Record<string, unknown>, aliases: Record<string, string>): Record<string, unknown>;
+//# sourceMappingURL=aliases.d.ts.map

package/packages/config/dist/aliases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aliases.d.ts","sourceRoot":"","sources":["../src/aliases.ts"],"names":[],"mappings":"AAuCA,eAAO,MAAM,YAAY;;;;;;CAMxB,CAAC;AAmCF,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAqE/D;AAUD,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CASzB"}

package/packages/config/dist/aliases.js

@@ -0,0 +1,153 @@
+import { isRecord as isPlainRecord } from "@lorenz/domain";
+// Common tracker keys only; provider-specific aliases (e.g. project_slug) are declared by
+// each tracker provider via `TrackerProvider.configAliases` and applied during parsing.
+const trackerAliases = {
+    api_key: "apiKey",
+    active_states: "activeStates",
+    terminal_states: "terminalStates",
+};
+const dispatchAliases = {
+    accept_unrouted: "acceptUnrouted",
+    only_routes: "onlyRoutes",
+    route_label_prefix: "routeLabelPrefix",
+};
+const pollingAliases = { interval_ms: "intervalMs" };
+const workspaceAliases = {};
+const workerAliases = {
+    ssh_hosts: "sshHosts",
+    ssh_timeout_ms: "sshTimeoutMs",
+    max_concurrent_agents_per_host: "maxConcurrentAgentsPerHost",
+    worker_pool: "workerPool",
+};
+const workerPoolAliases = {
+    max_in_flight: "maxInFlight",
+    ttl_ms: "ttlMs",
+    idle_reap_ms: "idleReapMs",
+    acquire_timeout_ms: "acquireTimeoutMs",
+    reap_interval_ms: "reapIntervalMs",
+    stale_heartbeat_ms: "staleHeartbeatMs",
+    drain_deadline_ms: "drainDeadlineMs",
+    max_workers_per_issue: "maxWorkersPerIssue",
+    co_residence: "coResidence",
+    max_concurrent_tunnels: "maxConcurrentTunnels",
+};
+const workerPoolSpendAliases = {
+    max_concurrent_workers: "maxConcurrentWorkers",
+    max_worker_seconds: "maxWorkerSeconds",
+    daily_worker_seconds: "dailyWorkerSeconds",
+};
+export const hooksAliases = {
+    after_create: "afterCreate",
+    before_run: "beforeRun",
+    after_run: "afterRun",
+    before_remove: "beforeRemove",
+    timeout_ms: "timeoutMs",
+};
+const agentAliases = {
+    max_concurrent_agents: "maxConcurrentAgents",
+    max_turns: "maxTurns",
+    max_retry_backoff_ms: "maxRetryBackoffMs",
+    ensemble_size: "ensembleSize",
+};
+const agentsAliases = {
+    turn_timeout_ms: "turnTimeoutMs",
+    stall_timeout_ms: "stallTimeoutMs",
+};
+const codexAliases = {
+    turn_timeout_ms: "turnTimeoutMs",
+    stall_timeout_ms: "stallTimeoutMs",
+};
+const claudeAliases = {
+    turn_timeout_ms: "turnTimeoutMs",
+    stall_timeout_ms: "stallTimeoutMs",
+    strict_mcp_config: "strictMcpConfig",
+    provider_config: "providerConfig",
+};
+// Shared agent-record keys only; executor-specific aliases (e.g. bridge_command) are
+// declared by each executor provider via `AgentExecutorProvider.configAliases` and applied
+// during parsing.
+const agentRecordAliases = {
+    turn_timeout_ms: "turnTimeoutMs",
+    stall_timeout_ms: "stallTimeoutMs",
+};
+const observabilityAliases = {
+    dashboard_enabled: "dashboardEnabled",
+    refresh_ms: "refreshMs",
+    render_interval_ms: "renderIntervalMs",
+};
+const loggingAliases = { log_file: "logFile" };
+export function normalizeWorkflowConfig(value) {
+    if (!isPlainRecord(value))
+        return value;
+    const raw = normalizeAliases(value, { status_overrides: "statusOverrides" });
+    const normalized = { ...raw };
+    normalizeNested(normalized, "tracker", trackerAliases);
+    normalizeNested(normalized, "polling", pollingAliases);
+    normalizeNested(normalized, "workspace", workspaceAliases);
+    normalizeNested(normalized, "worker", workerAliases);
+    normalizeNested(normalized, "hooks", hooksAliases);
+    normalizeNested(normalized, "agent", agentAliases);
+    normalizeNested(normalized, "agents", agentsAliases);
+    normalizeNested(normalized, "codex", codexAliases);
+    normalizeNested(normalized, "claude", claudeAliases);
+    normalizeNested(normalized, "observability", observabilityAliases);
+    normalizeNested(normalized, "server", {});
+    normalizeNested(normalized, "logging", loggingAliases);
+    if (isPlainRecord(normalized.tracker)) {
+        normalizeNested(normalized.tracker, "dispatch", dispatchAliases);
+    }
+    if (isPlainRecord(normalized.worker)) {
+        normalizeNested(normalized.worker, "workerPool", workerPoolAliases);
+        if (isPlainRecord(normalized.worker.workerPool)) {
+            normalizeNested(normalized.worker.workerPool, "spend", workerPoolSpendAliases);
+        }
+    }
+    if (isPlainRecord(normalized.trackers)) {
+        normalized.trackers = Object.fromEntries(Object.entries(normalized.trackers).map(([name, tracker]) => {
+            if (!isPlainRecord(tracker))
+                return [name, tracker];
+            const normalizedTracker = normalizeAliases(tracker, trackerAliases);
+            normalizeNested(normalizedTracker, "dispatch", dispatchAliases);
+            return [name, normalizedTracker];
+        }));
+    }
+    if (isPlainRecord(normalized.agents)) {
+        normalized.agents = Object.fromEntries(Object.entries(normalized.agents).map(([name, agent]) => [
+            name,
+            isPlainRecord(agent) ? normalizeAliases(agent, agentRecordAliases) : agent,
+        ]));
+    }
+    if (isPlainRecord(normalized.statusOverrides)) {
+        normalized.statusOverrides = Object.fromEntries(Object.entries(normalized.statusOverrides).map(([state, override]) => {
+            if (!isPlainRecord(override))
+                return [state, override];
+            const normalizedOverride = { ...override };
+            normalizeNested(normalizedOverride, "agent", agentAliases);
+            normalizeNested(normalizedOverride, "codex", codexAliases);
+            normalizeNested(normalizedOverride, "claude", claudeAliases);
+            if (isPlainRecord(normalizedOverride.agents)) {
+                normalizedOverride.agents = Object.fromEntries(Object.entries(normalizedOverride.agents).map(([name, agent]) => [
+                    name,
+                    isPlainRecord(agent) ? normalizeAliases(agent, agentRecordAliases) : agent,
+                ]));
+            }
+            return [state, normalizedOverride];
+        }));
+    }
+    return normalized;
+}
+function normalizeNested(raw, key, aliases) {
+    if (isPlainRecord(raw[key]))
+        raw[key] = normalizeAliases(raw[key], aliases);
+}
+export function normalizeAliases(raw, aliases) {
+    const out = { ...raw };
+    for (const [alias, canonical] of Object.entries(aliases)) {
+        if (Object.prototype.hasOwnProperty.call(raw, alias)) {
+            out[canonical] = raw[alias];
+            delete out[alias];
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=aliases.js.map

package/packages/config/dist/aliases.js.map

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

package/packages/config/dist/defaults.d.ts

@@ -0,0 +1,12 @@
+import type { AgentConfig, Settings } from "@lorenz/domain";
+export interface DefaultSettingsOptions {
+    tmpdir?: string | undefined;
+    configDir?: string | undefined;
+}
+export declare const defaultSettings: (options?: DefaultSettingsOptions) => Settings;
+/**
+ * Built-in agent records. The option bags are interpreted by the ACP executor provider;
+ * config owns these literals only as parse-time defaults for the well-known kinds.
+ */
+export declare function defaultAgentRecords(): Record<string, AgentConfig>;
+//# sourceMappingURL=defaults.d.ts.map

package/packages/config/dist/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAI5D,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAKD,eAAO,MAAM,eAAe,GAAI,UAAS,sBAA2B,KAAG,QAyCtE,CAAC;AAEF;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CA0BjE"}

package/packages/config/dist/defaults.js

@@ -0,0 +1,78 @@
+import { homedir } from "node:os";
+import { joinPath } from "./leaf-utils.js";
+/** Model id Claude sessions are pinned to unless overridden via `claude.model` or a provider config. */
+const DEFAULT_CLAUDE_MODEL = "claude-opus-4-6[1m]";
+export const defaultSettings = (options = {}) => {
+    const tmpdir = options.tmpdir ?? "/tmp";
+    const workspaceRoot = joinPath(tmpdir, "symphony_workspaces");
+    return {
+        tracker: {
+            kind: undefined,
+            activeStates: ["Todo", "In Progress"],
+            terminalStates: ["Closed", "Cancelled", "Canceled", "Duplicate", "Done"],
+            dispatch: {
+                acceptUnrouted: true,
+                onlyRoutes: null,
+                routeLabelPrefix: "Symphony:",
+            },
+            options: {},
+        },
+        polling: { intervalMs: 30_000 },
+        workspace: {
+            root: workspaceRoot,
+            rootExpression: workspaceRoot,
+            isolation: "per-agent",
+        },
+        worker: { sshHosts: [], sshTimeoutMs: 60_000 },
+        hooks: { timeoutMs: 60_000 },
+        agent: {
+            kind: "codex",
+            maxConcurrentAgents: 10,
+            maxTurns: 20,
+            maxRetryBackoffMs: 300_000,
+            ensembleSize: 1,
+            skills: [],
+        },
+        agents: defaultAgentRecords(),
+        observability: {
+            dashboardEnabled: true,
+            refreshMs: 1_000,
+            renderIntervalMs: 16,
+        },
+        server: { host: "127.0.0.1", port: 4040, traceDir: joinPath(homedir(), ".symphony/issues") },
+        logging: { logFile: joinPath(homedir(), ".symphony/log/symphony.log") },
+        statusOverrides: new Map(),
+    };
+};
+/**
+ * Built-in agent records. The option bags are interpreted by the ACP executor provider;
+ * config owns these literals only as parse-time defaults for the well-known kinds.
+ */
+export function defaultAgentRecords() {
+    return {
+        codex: {
+            executor: "acp",
+            turnTimeoutMs: 3_600_000,
+            stallTimeoutMs: 300_000,
+            options: {
+                bridgeCommand: "codex-acp",
+                usageAccounting: "per-turn",
+            },
+        },
+        claude: {
+            executor: "acp",
+            turnTimeoutMs: 3_600_000,
+            stallTimeoutMs: 300_000,
+            options: {
+                bridgeCommand: "claude-agent-acp",
+                usageAccounting: "per-turn",
+                providerConfig: {
+                    model: DEFAULT_CLAUDE_MODEL,
+                    permissions: { defaultMode: "dontAsk" },
+                },
+                strictMcpConfig: true,
+            },
+        },
+    };
+}
+//# sourceMappingURL=defaults.js.map

package/packages/config/dist/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../src/defaults.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAIlC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAO3C,wGAAwG;AACxG,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;AAEnD,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,UAAkC,EAAE,EAAY,EAAE;IAChF,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC;IACxC,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC;IAC9D,OAAO;QACL,OAAO,EAAE;YACP,IAAI,EAAE,SAAS;YACf,YAAY,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC;YACrC,cAAc,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,CAAC;YACxE,QAAQ,EAAE;gBACR,cAAc,EAAE,IAAI;gBACpB,UAAU,EAAE,IAAI;gBAChB,gBAAgB,EAAE,WAAW;aAC9B;YACD,OAAO,EAAE,EAAE;SACZ;QACD,OAAO,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE;QAC/B,SAAS,EAAE;YACT,IAAI,EAAE,aAAa;YACnB,cAAc,EAAE,aAAa;YAC7B,SAAS,EAAE,WAAW;SACvB;QACD,MAAM,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE;QAC9C,KAAK,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE;QAC5B,KAAK,EAAE;YACL,IAAI,EAAE,OAAO;YACb,mBAAmB,EAAE,EAAE;YACvB,QAAQ,EAAE,EAAE;YACZ,iBAAiB,EAAE,OAAO;YAC1B,YAAY,EAAE,CAAC;YACf,MAAM,EAAE,EAAE;SACX;QACD,MAAM,EAAE,mBAAmB,EAAE;QAC7B,aAAa,EAAE;YACb,gBAAgB,EAAE,IAAI;YACtB,SAAS,EAAE,KAAK;YAChB,gBAAgB,EAAE,EAAE;SACrB;QACD,MAAM,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE,kBAAkB,CAAC,EAAE;QAC5F,OAAO,EAAE,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,EAAE,4BAA4B,CAAC,EAAE;QACvE,eAAe,EAAE,IAAI,GAAG,EAAE;KAC3B,CAAC;AACJ,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO;QACL,KAAK,EAAE;YACL,QAAQ,EAAE,KAAK;YACf,aAAa,EAAE,SAAS;YACxB,cAAc,EAAE,OAAO;YACvB,OAAO,EAAE;gBACP,aAAa,EAAE,WAAW;gBAC1B,eAAe,EAAE,UAAU;aAC5B;SACF;QACD,MAAM,EAAE;YACN,QAAQ,EAAE,KAAK;YACf,aAAa,EAAE,SAAS;YACxB,cAAc,EAAE,OAAO;YACvB,OAAO,EAAE;gBACP,aAAa,EAAE,kBAAkB;gBACjC,eAAe,EAAE,UAAU;gBAC3B,cAAc,EAAE;oBACd,KAAK,EAAE,oBAAoB;oBAC3B,WAAW,EAAE,EAAE,WAAW,EAAE,SAAS,EAAE;iBACxC;gBACD,eAAe,EAAE,IAAI;aACtB;SACF;KACF,CAAC;AACJ,CAAC"}

package/packages/config/dist/errors.d.ts

@@ -0,0 +1,3 @@
+import type { z } from "zod";
+export declare function configErrorMessage(error: z.ZodError, baseLabel?: string): string;
+//# sourceMappingURL=errors.d.ts.map

package/packages/config/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CA8BhF"}

package/packages/config/dist/errors.js

@@ -0,0 +1,56 @@
+export function configErrorMessage(error, baseLabel) {
+    const issue = error.issues[0];
+    if (!issue)
+        return `${baseLabel ?? "workflow"} is invalid`;
+    const label = pathLabel(issue.path, baseLabel);
+    switch (issue.code) {
+        case "unrecognized_keys":
+            return `${label} contains unsupported keys: ${issue.keys.join(", ")}`;
+        case "invalid_type": {
+            const expected = issue.expected;
+            const messages = {
+                string: `${label} must be a string`,
+                number: integerMessageForLabel(label),
+                array: `${label} must be a list of strings`,
+            };
+            return messages[expected ?? ""] ?? `${label} must be a map`;
+        }
+        case "too_small":
+            return integerMessageForLabel(label);
+        case "custom":
+            return `${label} ${issue.message}`;
+        case "invalid_union": {
+            const innerErrors = issue.errors;
+            const firstInner = innerErrors?.[0]?.[0];
+            if (firstInner?.expected === "boolean")
+                return `expected a boolean`;
+            if (firstInner?.expected === "number")
+                return integerMessageForLabel(label);
+            return `${label} is invalid: ${issue.message}`;
+        }
+        default:
+            return `${label} is invalid: ${issue.message}`;
+    }
+}
+function integerMessageForLabel(label) {
+    const field = label.split(".").pop() ?? "";
+    if (field === "port")
+        return `${label} must be a valid port number (0-65535)`;
+    const kind = field === "stall_timeout_ms" ? "a non-negative integer" : "a positive integer";
+    return `${label} must be ${kind}`;
+}
+function camelToSnake(s) {
+    return s
+        .replace(/([A-Z]+)([A-Z][a-z])/g, "$1_$2")
+        .replace(/([a-z0-9])([A-Z])/g, "$1_$2")
+        .toLowerCase();
+}
+function pathLabel(pathSegments, baseLabel) {
+    const suffix = pathSegments.map((seg) => camelToSnake(String(seg))).join(".");
+    if (suffix && baseLabel)
+        return `${baseLabel}.${suffix}`;
+    if (suffix)
+        return suffix;
+    return baseLabel ?? "workflow";
+}
+//# sourceMappingURL=errors.js.map

package/packages/config/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,kBAAkB,CAAC,KAAiB,EAAE,SAAkB;IACtE,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK;QAAE,OAAO,GAAG,SAAS,IAAI,UAAU,aAAa,CAAC;IAC3D,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC/C,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;QACnB,KAAK,mBAAmB;YACtB,OAAO,GAAG,KAAK,+BAA+B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACxE,KAAK,cAAc,CAAC,CAAC,CAAC;YACpB,MAAM,QAAQ,GAAI,KAA+B,CAAC,QAAQ,CAAC;YAC3D,MAAM,QAAQ,GAA2B;gBACvC,MAAM,EAAE,GAAG,KAAK,mBAAmB;gBACnC,MAAM,EAAE,sBAAsB,CAAC,KAAK,CAAC;gBACrC,KAAK,EAAE,GAAG,KAAK,4BAA4B;aAC5C,CAAC;YACF,OAAO,QAAQ,CAAC,QAAQ,IAAI,EAAE,CAAC,IAAI,GAAG,KAAK,gBAAgB,CAAC;QAC9D,CAAC;QACD,KAAK,WAAW;YACd,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;QACvC,KAAK,QAAQ;YACX,OAAO,GAAG,KAAK,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACrC,KAAK,eAAe,CAAC,CAAC,CAAC;YACrB,MAAM,WAAW,GAAI,KAAkC,CAAC,MAAM,CAAC;YAC/D,MAAM,UAAU,GAAG,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAsC,CAAC;YAC9E,IAAI,UAAU,EAAE,QAAQ,KAAK,SAAS;gBAAE,OAAO,oBAAoB,CAAC;YACpE,IAAI,UAAU,EAAE,QAAQ,KAAK,QAAQ;gBAAE,OAAO,sBAAsB,CAAC,KAAK,CAAC,CAAC;YAC5E,OAAO,GAAG,KAAK,gBAAgB,KAAK,CAAC,OAAO,EAAE,CAAC;QACjD,CAAC;QACD;YACE,OAAO,GAAG,KAAK,gBAAgB,KAAK,CAAC,OAAO,EAAE,CAAC;IACnD,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAa;IAC3C,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IAC3C,IAAI,KAAK,KAAK,MAAM;QAAE,OAAO,GAAG,KAAK,wCAAwC,CAAC;IAC9E,MAAM,IAAI,GAAG,KAAK,KAAK,kBAAkB,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,oBAAoB,CAAC;IAC5F,OAAO,GAAG,KAAK,YAAY,IAAI,EAAE,CAAC;AACpC,CAAC;AAED,SAAS,YAAY,CAAC,CAAS;IAC7B,OAAO,CAAC;SACL,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC;SACzC,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC;SACtC,WAAW,EAAE,CAAC;AACnB,CAAC;AAED,SAAS,SAAS,CAChB,YAAmD,EACnD,SAAkB;IAElB,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9E,IAAI,MAAM,IAAI,SAAS;QAAE,OAAO,GAAG,SAAS,IAAI,MAAM,EAAE,CAAC;IACzD,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,OAAO,SAAS,IAAI,UAAU,CAAC;AACjC,CAAC"}