@actalk/inkos-core 1.3.6 → 1.3.7

package/dist/utils/config-loader.js

@@ -1,256 +1,16 @@
-import { readFile, access } from "node:fs/promises";
-import { homedir } from "node:os";
-import { join } from "node:path";
-import { ProjectConfigSchema } from "../models/project.js";
-import { getServiceApiKey } from "../llm/secrets.js";
-import { resolveServicePreset, resolveServiceProviderFamily } from "../llm/service-presets.js";
-export const GLOBAL_CONFIG_DIR = join(homedir(), ".inkos");
-export const GLOBAL_ENV_PATH = join(GLOBAL_CONFIG_DIR, ".env");
-export function isApiKeyOptionalForEndpoint(params) {
-    if (params.provider === "anthropic") {
-        return false;
-    }
-    if (!params.baseUrl) {
-        return false;
-    }
-    try {
-        const url = new URL(params.baseUrl);
-        const hostname = url.hostname.toLowerCase();
-        return (hostname === "localhost"
-            || hostname === "127.0.0.1"
-            || hostname === "::1"
-            || hostname === "0.0.0.0"
-            || hostname === "host.docker.internal"
-            || hostname.endsWith(".local")
-            || isPrivateIpv4(hostname));
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Load project config from inkos.json with .env overrides.
- * Shared by CLI and Studio — single source of truth for config loading.
- */
+import { resolveEffectiveLLMConfig, } from "./effective-llm-config.js";
+import { loadLLMEnvLayers, GLOBAL_CONFIG_DIR, GLOBAL_ENV_PATH } from "./llm-env.js";
+import { isApiKeyOptionalForEndpoint } from "./llm-endpoint-auth.js";
+export { GLOBAL_CONFIG_DIR, GLOBAL_ENV_PATH, isApiKeyOptionalForEndpoint };
 export async function loadProjectConfig(root, options) {
-    // Load global ~/.inkos/.env first, then project .env overrides
-    const { config: loadEnv } = await import("dotenv");
-    loadEnv({ path: GLOBAL_ENV_PATH });
-    loadEnv({ path: join(root, ".env"), override: true });
-    const configPath = join(root, "inkos.json");
-    try {
-        await access(configPath);
-    }
-    catch {
-        throw new Error(`inkos.json not found in ${root}.\nMake sure you are inside an InkOS project directory (cd into the project created by 'inkos init').`);
-    }
-    const raw = await readFile(configPath, "utf-8");
-    let config;
-    try {
-        config = JSON.parse(raw);
-    }
-    catch {
-        throw new Error(`inkos.json in ${root} is not valid JSON. Check the file for syntax errors.`);
-    }
-    // llm.configSource controls whether INKOS_LLM_* env vars override project config
-    const env = process.env;
-    const llm = (config.llm ?? {});
-    const configSource = resolveConfigSource(llm.configSource);
-    llm.configSource = configSource;
-    const normalizedServices = normalizeServiceEntries(llm.services);
-    if (normalizedServices.length > 0) {
-        llm.services = normalizedServices;
-        const selectedEntry = selectServiceEntry(normalizedServices, llm.service);
-        const selectedServiceId = selectedEntry ? serviceEntryKey(selectedEntry) : undefined;
-        if (selectedEntry) {
-            llm.service = selectedEntry.service;
-            if (!(typeof llm.model === "string" && llm.model.length > 0) && typeof llm.defaultModel === "string" && llm.defaultModel.length > 0) {
-                llm.model = llm.defaultModel;
-            }
-            if (!(typeof llm.baseUrl === "string" && llm.baseUrl.length > 0)) {
-                llm.baseUrl = selectedEntry.baseUrl ?? resolveServicePreset(selectedEntry.service)?.baseUrl ?? "";
-            }
-            if (!(typeof llm.provider === "string" && llm.provider.length > 0)) {
-                llm.provider = deriveProviderFromService(selectedEntry.service);
-            }
-            if (llm.temperature === undefined && selectedEntry.temperature !== undefined) {
-                llm.temperature = selectedEntry.temperature;
-            }
-            if (llm.maxTokens === undefined && selectedEntry.maxTokens !== undefined) {
-                llm.maxTokens = selectedEntry.maxTokens;
-            }
-            if (selectedEntry.apiFormat !== undefined) {
-                llm.apiFormat = selectedEntry.apiFormat;
-            }
-            if (selectedEntry.stream !== undefined) {
-                llm.stream = selectedEntry.stream;
-            }
-            if (selectedServiceId && (configSource !== "env" || !env.INKOS_LLM_API_KEY)) {
-                const secretApiKey = await getServiceApiKey(root, selectedServiceId);
-                if (secretApiKey) {
-                    llm.apiKey = secretApiKey;
-                }
-            }
-        }
-    }
-    const shouldBootstrapStudioFallbackToEnv = configSource === "studio"
-        && normalizedServices.length === 0
-        && !(typeof llm.apiKey === "string" && llm.apiKey.length > 0)
-        && !(typeof llm.model === "string" && llm.model.length > 0)
-        && !(typeof llm.baseUrl === "string" && llm.baseUrl.length > 0);
-    if (configSource === "env" || shouldBootstrapStudioFallbackToEnv) {
-        if (env.INKOS_LLM_PROVIDER)
-            llm.provider = env.INKOS_LLM_PROVIDER;
-        if (env.INKOS_LLM_BASE_URL)
-            llm.baseUrl = env.INKOS_LLM_BASE_URL;
-        if (env.INKOS_LLM_MODEL)
-            llm.model = env.INKOS_LLM_MODEL;
-        if (env.INKOS_LLM_TEMPERATURE)
-            llm.temperature = parseFloat(env.INKOS_LLM_TEMPERATURE);
-        if (env.INKOS_LLM_MAX_TOKENS)
-            llm.maxTokens = parseInt(env.INKOS_LLM_MAX_TOKENS, 10);
-        if (env.INKOS_LLM_THINKING_BUDGET)
-            llm.thinkingBudget = parseInt(env.INKOS_LLM_THINKING_BUDGET, 10);
-    }
-    // Extra params from env: INKOS_LLM_EXTRA_<key>=<value>
-    const extraFromEnv = {};
-    if (configSource === "env" || shouldBootstrapStudioFallbackToEnv) {
-        for (const [key, value] of Object.entries(env)) {
-            if (key.startsWith("INKOS_LLM_EXTRA_") && value) {
-                const paramName = key.slice("INKOS_LLM_EXTRA_".length);
-                // Auto-coerce: numbers, booleans, JSON objects
-                if (/^\d+(\.\d+)?$/.test(value))
-                    extraFromEnv[paramName] = parseFloat(value);
-                else if (value === "true")
-                    extraFromEnv[paramName] = true;
-                else if (value === "false")
-                    extraFromEnv[paramName] = false;
-                else if (value.startsWith("{") || value.startsWith("[")) {
-                    try {
-                        extraFromEnv[paramName] = JSON.parse(value);
-                    }
-                    catch {
-                        extraFromEnv[paramName] = value;
-                    }
-                }
-                else
-                    extraFromEnv[paramName] = value;
-            }
-        }
-    }
-    if (Object.keys(extraFromEnv).length > 0) {
-        llm.extra = { ...(llm.extra ?? {}), ...extraFromEnv };
-    }
-    if ((configSource === "env" || shouldBootstrapStudioFallbackToEnv) && env.INKOS_LLM_API_FORMAT)
-        llm.apiFormat = env.INKOS_LLM_API_FORMAT;
-    config.llm = llm;
-    // Global language override
-    if (env.INKOS_DEFAULT_LANGUAGE)
-        config.language = env.INKOS_DEFAULT_LANGUAGE;
-    // API key ONLY from env — never stored in inkos.json
-    const apiKey = (configSource === "env" || shouldBootstrapStudioFallbackToEnv)
-        ? env.INKOS_LLM_API_KEY || (typeof llm.apiKey === "string" ? llm.apiKey : "")
-        : (typeof llm.apiKey === "string" ? llm.apiKey : "");
-    const provider = typeof llm.provider === "string" ? llm.provider : undefined;
-    const baseUrl = typeof llm.baseUrl === "string" ? llm.baseUrl : undefined;
-    const apiKeyOptional = isApiKeyOptionalForEndpoint({ provider, baseUrl });
-    if (!apiKey && options?.requireApiKey !== false && !apiKeyOptional) {
-        throw new Error("INKOS_LLM_API_KEY not set. Run 'inkos config set-global' or add it to project .env file.");
-    }
-    if (options?.requireApiKey === false) {
-        llm.provider = typeof llm.provider === "string" && llm.provider.length > 0
-            ? llm.provider
-            : "openai";
-        llm.baseUrl = typeof llm.baseUrl === "string" && llm.baseUrl.length > 0
-            ? llm.baseUrl
-            : "https://example.invalid/v1";
-        llm.model = typeof llm.model === "string" && llm.model.length > 0
-            ? llm.model
-            : "noop-model";
-    }
-    llm.apiKey = apiKey ?? "";
-    return ProjectConfigSchema.parse(config);
-}
-function resolveConfigSource(value) {
-    return value === "studio" ? "studio" : "env";
-}
-function normalizeServiceEntries(raw) {
-    if (Array.isArray(raw)) {
-        return raw
-            .filter((entry) => Boolean(entry) && typeof entry === "object")
-            .map((entry) => ({
-            service: typeof entry.service === "string" && entry.service.length > 0 ? entry.service : "custom",
-            ...(typeof entry.name === "string" && entry.name.length > 0 ? { name: entry.name } : {}),
-            ...(typeof entry.baseUrl === "string" && entry.baseUrl.length > 0 ? { baseUrl: entry.baseUrl } : {}),
-            ...(typeof entry.temperature === "number" ? { temperature: entry.temperature } : {}),
-            ...(typeof entry.maxTokens === "number" ? { maxTokens: entry.maxTokens } : {}),
-            ...(entry.apiFormat === "chat" || entry.apiFormat === "responses" ? { apiFormat: entry.apiFormat } : {}),
-            ...(typeof entry.stream === "boolean" ? { stream: entry.stream } : {}),
-        }));
-    }
-    if (raw && typeof raw === "object") {
-        return Object.entries(raw)
-            .filter(([, value]) => value && typeof value === "object")
-            .map(([serviceId, value]) => normalizeServiceEntryFromPatch(serviceId, value));
-    }
-    return [];
-}
-function normalizeServiceEntryFromPatch(serviceId, value) {
-    if (serviceId.startsWith("custom:")) {
-        return {
-            service: "custom",
-            name: decodeURIComponent(serviceId.slice("custom:".length)),
-            ...(typeof value.baseUrl === "string" && value.baseUrl.length > 0 ? { baseUrl: value.baseUrl } : {}),
-            ...(typeof value.temperature === "number" ? { temperature: value.temperature } : {}),
-            ...(typeof value.maxTokens === "number" ? { maxTokens: value.maxTokens } : {}),
-            ...(value.apiFormat === "chat" || value.apiFormat === "responses" ? { apiFormat: value.apiFormat } : {}),
-            ...(typeof value.stream === "boolean" ? { stream: value.stream } : {}),
-        };
-    }
-    if (serviceId === "custom") {
-        return {
-            service: "custom",
-            ...(typeof value.name === "string" && value.name.length > 0 ? { name: value.name } : {}),
-            ...(typeof value.baseUrl === "string" && value.baseUrl.length > 0 ? { baseUrl: value.baseUrl } : {}),
-            ...(typeof value.temperature === "number" ? { temperature: value.temperature } : {}),
-            ...(typeof value.maxTokens === "number" ? { maxTokens: value.maxTokens } : {}),
-            ...(value.apiFormat === "chat" || value.apiFormat === "responses" ? { apiFormat: value.apiFormat } : {}),
-            ...(typeof value.stream === "boolean" ? { stream: value.stream } : {}),
-        };
-    }
-    return {
-        service: serviceId,
-        ...(typeof value.temperature === "number" ? { temperature: value.temperature } : {}),
-        ...(typeof value.maxTokens === "number" ? { maxTokens: value.maxTokens } : {}),
-        ...(value.apiFormat === "chat" || value.apiFormat === "responses" ? { apiFormat: value.apiFormat } : {}),
-        ...(typeof value.stream === "boolean" ? { stream: value.stream } : {}),
-    };
-}
-function selectServiceEntry(services, configuredService) {
-    if (typeof configuredService === "string" && configuredService.length > 0) {
-        return services.find((entry) => entry.service === configuredService || serviceEntryKey(entry) === configuredService) ?? services[0];
-    }
-    return services[0];
-}
-function serviceEntryKey(entry) {
-    return entry.service === "custom" ? `custom:${entry.name ?? "Custom"}` : entry.service;
-}
-function deriveProviderFromService(service) {
-    if (service === "custom")
-        return "custom";
-    return resolveServiceProviderFamily(service) ?? "openai";
-}
-function isPrivateIpv4(hostname) {
-    const parts = hostname.split(".").map((segment) => Number.parseInt(segment, 10));
-    if (parts.length !== 4 || parts.some((part) => Number.isNaN(part) || part < 0 || part > 255)) {
-        return false;
-    }
-    if (parts[0] === 10)
-        return true;
-    if (parts[0] === 192 && parts[1] === 168)
-        return true;
-    if (parts[0] === 172 && parts[1] >= 16 && parts[1] <= 31)
-        return true;
-    return false;
+    const envLayers = await loadLLMEnvLayers(root);
+    const result = await resolveEffectiveLLMConfig({
+        consumer: options?.consumer ?? "cli",
+        projectRoot: root,
+        envLayers,
+        cli: options?.cli,
+        requireApiKey: options?.requireApiKey,
+    });
+    return result.config;
 }
 //# sourceMappingURL=config-loader.js.map

package/dist/utils/config-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"config-loader.js","sourceRoot":"","sources":["../../src/utils/config-loader.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config-loader.js","sourceRoot":"","sources":["../../src/utils/config-loader.ts"],"names":[],"mappings":"AACA,OAAO,EACL,yBAAyB,GAG1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpF,OAAO,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAErE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,2BAA2B,EAAE,CAAC;AAE3E,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,IAAY,EACZ,OAIC;IAED,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC;QAC7C,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,KAAK;QACpC,WAAW,EAAE,IAAI;QACjB,SAAS;QACT,GAAG,EAAE,OAAO,EAAE,GAAG;QACjB,aAAa,EAAE,OAAO,EAAE,aAAa;KACtC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC"}

package/dist/utils/context-assembly.d.ts

@@ -0,0 +1,24 @@
+import type { ChapterTrace, ContextPackage, RuleStack } from "../models/input-governance.js";
+import type { PlanChapterOutput } from "../agents/planner.js";
+/**
+ * Compose the per-chapter rule stack used by writer / continuity / reviser
+ * prompts. Source names follow the Phase 5 layout (story_frame, volume_map,
+ * roles/) and activeOverrides are derived from the planner's intent so the
+ * "Governed Control Stack" block surfaces the actual gating in effect for
+ * the current chapter — it used to be a static stub that ignored both
+ * `plan` and `chapterNumber`.
+ *
+ * Phase hotfix 6 (Option A): make this honestly dynamic instead of deleting
+ * it, because writer.ts (~L820/L900), continuity.ts (~L590), and
+ * reviser.ts (~L600) all render ruleStack.sections / activeOverrides into
+ * the model prompt. Removing the function would require a much larger
+ * prompt refactor; making it real fixes the lie at the source.
+ */
+export declare function buildGovernedRuleStack(plan: PlanChapterOutput, chapterNumber: number): RuleStack;
+export declare function buildGovernedTrace(params: {
+    readonly chapterNumber: number;
+    readonly plan: PlanChapterOutput;
+    readonly contextPackage: ContextPackage;
+    readonly composerInputs: ReadonlyArray<string>;
+}): ChapterTrace;
+//# sourceMappingURL=context-assembly.d.ts.map

package/dist/utils/context-assembly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-assembly.d.ts","sourceRoot":"","sources":["../../src/utils/context-assembly.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,YAAY,EACZ,cAAc,EACd,SAAS,EACV,MAAM,+BAA+B,CAAC;AAKvC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAW9D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,GAAG,SAAS,CA+ChG;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE;IACzC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,cAAc,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CAChD,GAAG,YAAY,CAQf"}

package/dist/utils/context-assembly.js

@@ -0,0 +1,77 @@
+import { ChapterTraceSchema, RuleStackSchema, } from "../models/input-governance.js";
+const MAX_OVERRIDE_REASON_CHARS = 80;
+function truncateForOverrideReason(value) {
+    const collapsed = value.replace(/\s+/g, " ").trim();
+    return collapsed.length > MAX_OVERRIDE_REASON_CHARS
+        ? `${collapsed.slice(0, MAX_OVERRIDE_REASON_CHARS - 1)}…`
+        : collapsed;
+}
+/**
+ * Compose the per-chapter rule stack used by writer / continuity / reviser
+ * prompts. Source names follow the Phase 5 layout (story_frame, volume_map,
+ * roles/) and activeOverrides are derived from the planner's intent so the
+ * "Governed Control Stack" block surfaces the actual gating in effect for
+ * the current chapter — it used to be a static stub that ignored both
+ * `plan` and `chapterNumber`.
+ *
+ * Phase hotfix 6 (Option A): make this honestly dynamic instead of deleting
+ * it, because writer.ts (~L820/L900), continuity.ts (~L590), and
+ * reviser.ts (~L600) all render ruleStack.sections / activeOverrides into
+ * the model prompt. Removing the function would require a much larger
+ * prompt refactor; making it real fixes the lie at the source.
+ */
+export function buildGovernedRuleStack(plan, chapterNumber) {
+    const activeOverrides = [];
+    // L4 → L3: per-chapter prohibitions narrow the planning layer for this
+    // chapter only. mustAvoid items come from rules-reader prohibitions +
+    // current_focus avoid section (planner.collectMustAvoid).
+    for (const item of plan.intent.mustAvoid) {
+        activeOverrides.push({
+            from: "L4",
+            to: "L3",
+            target: `chapter:${chapterNumber}/mustAvoid`,
+            reason: truncateForOverrideReason(item),
+        });
+    }
+    // L4 → L3: planner-issued style emphasis is also a per-chapter override
+    // on the planning layer. Style emphasis surfaces things like POV tightness
+    // or character-conflict focus that the writer must honor this chapter.
+    for (const item of plan.intent.styleEmphasis) {
+        activeOverrides.push({
+            from: "L4",
+            to: "L3",
+            target: `chapter:${chapterNumber}/styleEmphasis`,
+            reason: truncateForOverrideReason(item),
+        });
+    }
+    return RuleStackSchema.parse({
+        layers: [
+            { id: "L1", name: "hard_facts", precedence: 100, scope: "global" },
+            { id: "L2", name: "author_intent", precedence: 80, scope: "book" },
+            { id: "L3", name: "planning", precedence: 60, scope: "arc" },
+            { id: "L4", name: "current_task", precedence: 70, scope: "local" },
+        ],
+        sections: {
+            // Phase 5 authoritative source names (was: story_bible, volume_outline).
+            hard: ["story_frame", "current_state", "book_rules", "roles"],
+            soft: ["author_intent", "current_focus", "volume_map"],
+            diagnostic: ["anti_ai_checks", "continuity_audit", "style_regression_checks"],
+        },
+        overrideEdges: [
+            { from: "L4", to: "L3", allowed: true, scope: "current_chapter" },
+            { from: "L4", to: "L2", allowed: false, scope: "current_chapter" },
+            { from: "L4", to: "L1", allowed: false, scope: "current_chapter" },
+        ],
+        activeOverrides,
+    });
+}
+export function buildGovernedTrace(params) {
+    return ChapterTraceSchema.parse({
+        chapter: params.chapterNumber,
+        plannerInputs: params.plan.plannerInputs,
+        composerInputs: params.composerInputs,
+        selectedSources: params.contextPackage.selectedContext.map((entry) => entry.source),
+        notes: [],
+    });
+}
+//# sourceMappingURL=context-assembly.js.map

package/dist/utils/context-assembly.js.map

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

package/dist/utils/effective-llm-config.d.ts

@@ -0,0 +1,34 @@
+import { type LLMConfig, type ProjectConfig } from "../models/project.js";
+import { type LLMEnvLayers } from "./llm-env.js";
+export type LLMConsumer = "studio" | "cli" | "daemon" | "deploy";
+export type LLMConfigMode = "studio-project" | "cli-project" | "legacy-env";
+export type LLMValueSource = "project" | "studio-secret" | "env" | "cli" | "default";
+export interface LLMConfigCliOverrides {
+    readonly service?: string;
+    readonly model?: string;
+    readonly apiKeyEnv?: string;
+    readonly baseUrl?: string;
+    readonly apiFormat?: "chat" | "responses";
+    readonly stream?: boolean;
+}
+export interface ResolveEffectiveLLMConfigInput {
+    readonly consumer: LLMConsumer;
+    readonly projectRoot: string;
+    readonly envLayers: LLMEnvLayers;
+    readonly cli?: LLMConfigCliOverrides;
+    readonly requireApiKey?: boolean;
+}
+export interface EffectiveLLMDiagnostics {
+    readonly configMode: LLMConfigMode;
+    readonly serviceSource: LLMValueSource;
+    readonly modelSource: LLMValueSource;
+    readonly apiKeySource: LLMValueSource;
+    readonly warnings: readonly string[];
+}
+export interface EffectiveLLMConfigResult {
+    readonly config: ProjectConfig;
+    readonly llm: LLMConfig;
+    readonly diagnostics: EffectiveLLMDiagnostics;
+}
+export declare function resolveEffectiveLLMConfig(input: ResolveEffectiveLLMConfigInput): Promise<EffectiveLLMConfigResult>;
+//# sourceMappingURL=effective-llm-config.d.ts.map

package/dist/utils/effective-llm-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effective-llm-config.d.ts","sourceRoot":"","sources":["../../src/utils/effective-llm-config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuB,KAAK,SAAS,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAK/F,OAAO,EAA8C,KAAK,YAAY,EAAkB,MAAM,cAAc,CAAC;AAE7G,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACjE,MAAM,MAAM,aAAa,GAAG,gBAAgB,GAAG,aAAa,GAAG,YAAY,CAAC;AAC5E,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,eAAe,GAAG,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;AAErF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC1C,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,qBAAqB,CAAC;IACrC,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,cAAc,CAAC;IACvC,QAAQ,CAAC,WAAW,EAAE,cAAc,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,cAAc,CAAC;IACtC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,uBAAuB,CAAC;CAC/C;AAoBD,wBAAsB,yBAAyB,CAC7C,KAAK,EAAE,8BAA8B,GACpC,OAAO,CAAC,wBAAwB,CAAC,CAsDnC"}