pulseed 0.4.15 → 0.4.17

package/dist/base/config/tool-metadata.js

@@ -1,114 +0,0 @@
-// ─── Tool Metadata ───
-//
-// Rich metadata for config keys and mutation tools. Injected into LLM tool
-// descriptions so the LLM can generate thorough explanations before acting.
-export const CONFIG_METADATA = {
-    daemon_mode: {
-        label: "Daemon Mode",
-        description: "CoreLoopをバックグラウンドdaemonとして実行するモード",
-        type: "boolean",
-        effects: [
-            "CoreLoopがバックグラウンドdaemonプロセスとして常時動作する",
-            "TUIを閉じてもゴールの実行が継続する",
-            "TUIは「ウィンドウ」として何度でも再接続可能になる",
-            "複数クライアント（TUIや通知チャネル）が同時にダエモンを監視できる",
-        ],
-        requirements: [
-            "常時起動のPC（スリープしないこと）",
-            "ポート41700が空いていること",
-            "エージェント専用PCでの使用を推奨",
-        ],
-        risks: [
-            "バックグラウンドでLLM APIを呼び続けるため、APIコストが継続的に発生する",
-            "停止は pulseed daemon stop で明示的に行う必要がある",
-            "PCがスリープするとdaemonも停止し、再起動が必要",
-        ],
-        revert: "pulseed config set daemon_mode false、または TUI内で /settings からOFFに切り替え",
-        appliesAt: "next_session",
-        requiresExplicitApproval: true,
-    },
-    no_flicker: {
-        label: "No Flicker UI",
-        description: "TUIの描画更新を抑えて端末のちらつきを減らす表示設定",
-        type: "boolean",
-        effects: [
-            "TUIの描画挙動が変わる",
-            "端末によってはちらつきが減る",
-        ],
-        requirements: [
-            "TUIセッションで使用すること",
-        ],
-        risks: [
-            "端末によっては体感差がない場合がある",
-        ],
-        revert: "pulseed config set no_flicker false",
-        appliesAt: "immediate",
-        requiresExplicitApproval: false,
-    },
-};
-export function configChangeRequiresApproval(key) {
-    return CONFIG_METADATA[key]?.requiresExplicitApproval ?? false;
-}
-/** Build a rich description string for a single config key. */
-export function buildConfigKeyDescription(key) {
-    const m = CONFIG_METADATA[key];
-    if (!m)
-        return `Unknown config key: ${key}`;
-    const bullet = (arr) => arr.map(s => `- ${s}`).join("\n");
-    const timing = m.appliesAt === "next_session" ? "次のセッション（再起動後）から適用" : "即座に適用";
-    const approval = m.requiresExplicitApproval ? "明示的なユーザー確認が必要" : "通常は即時変更してよい";
-    return [`## ${m.label} (${key})`, m.description, "", "### 効果", bullet(m.effects), "",
-        "### 必要な環境", bullet(m.requirements), "", "### リスク", bullet(m.risks), "",
-        "### 元に戻す方法", m.revert, "", "### 適用タイミング", timing, "",
-        "### 承認要件", approval].join("\n");
-}
-/** Build the full tool description with all config keys' metadata injected. */
-export function buildConfigToolDescription() {
-    const descs = Object.keys(CONFIG_METADATA).map(k => buildConfigKeyDescription(k)).join("\n\n---\n\n");
-    return ["PulSeedの設定を変更する。", "",
-        "【重要ルール】このツールを呼ぶ前に、以下を守ること：",
-        "1. 変更する設定の『効果』『必要な環境』『リスク』『元に戻す方法』『適用タイミング』を説明する",
-        "2. 承認要件が『明示的なユーザー確認が必要』の設定では、同意を得てから呼び出す",
-        "3. 低リスク設定は簡潔に説明したうえで、そのまま実行してよい",
-        "4. ランタイムが追加の承認を要求した場合はそれに従う", "",
-        "【利用可能な設定キー】", "", descs].join("\n");
-}
-export const MUTATION_TOOL_METADATA = {
-    delete_goal: {
-        label: "Delete Goal",
-        description: "Permanently removes a goal and all associated state (observations, trust scores, session history)",
-        effects: [
-            "Goal and all children are permanently deleted",
-            "Active agent sessions for this goal are terminated",
-            "If daemon is running, the goal is removed from the active loop immediately",
-            "Historical observation data is lost",
-        ],
-        risks: [
-            "Cannot be undone — goal ID cannot be reused",
-            "If the goal has running sessions, they will be force-terminated",
-            "Child goals are also deleted recursively",
-        ],
-        revert: "Goal must be re-created manually with set_goal. Historical data cannot be recovered.",
-    },
-};
-/** Build a rich description string for a mutation tool. */
-export function buildMutationToolDescription(toolName) {
-    const m = MUTATION_TOOL_METADATA[toolName];
-    if (!m)
-        return `Unknown mutation tool: ${toolName}`;
-    const bullet = (arr) => arr.map(s => `- ${s}`).join("\n");
-    return [
-        `## ${m.label}`,
-        m.description, "",
-        "重要: このツールを呼び出す前に、必ず以下を行ってください:",
-        "1. 削除・影響の対象を具体的に説明する",
-        "2. リスクを一覧で提示する",
-        "3. この操作は元に戻せないことを明示する",
-        "4. ユーザーの明示的な確認を得る",
-        "ユーザーが確認するまでこのツールを呼び出さないでください。", "",
-        "### 影響", bullet(m.effects), "",
-        "### リスク", bullet(m.risks), "",
-        "### 復元", m.revert,
-    ].join("\n");
-}
-//# sourceMappingURL=tool-metadata.js.map

package/dist/base/config/tool-metadata.js.map

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

package/dist/base/llm/base-llm-client.d.ts

@@ -1,83 +0,0 @@
-import type { ZodSchema } from "zod";
-/** Selects which model to use for a given LLM call. Defaults to 'main'. */
-export type ModelTier = "main" | "light";
-export declare const DEFAULT_MAX_TOKENS = 4096;
-/** Default LLM request timeout in milliseconds */
-export declare const DEFAULT_LLM_TIMEOUT_MS = 60000;
-/** Maximum number of retry attempts on transient errors */
-export declare const MAX_RETRY_ATTEMPTS = 3;
-/** Exponential backoff delays in milliseconds: 1s, 2s, 4s */
-export declare const RETRY_DELAYS_MS: number[];
-/** Extended backoff delays for HTTP 429 rate-limit responses (up to 5 retries) */
-export declare const RATE_LIMIT_RETRY_DELAYS_MS: number[];
-/**
- * Returns true if the error represents an HTTP 429 rate-limit response.
- */
-export declare function isRateLimitError(err: unknown): boolean;
-/**
- * Returns the retry delay in milliseconds for a rate-limit error.
- * Respects the Retry-After header when present, otherwise falls back to
- * RATE_LIMIT_RETRY_DELAYS_MS[attemptIndex].
- * Adds jitter (±50%) to avoid thundering-herd.
- */
-export declare function getRateLimitRetryDelay(err: unknown, attemptIndex: number): number;
-/**
- * Extract JSON from a string that may contain markdown code blocks or prose.
- *
- * Strategies (first match wins):
- * 1. Fast path — already valid JSON, return as-is
- * 2. Code fence extraction — ```json ... ``` or ``` ... ```
- * 3. Brace matching — find first { or [ and last matching } or ]
- */
-export declare function extractJSON(text: string): string;
-export interface ParseJSONMessage {
-    role: string;
-    content: string;
-}
-/** Options for parseJSON(). Pass `retry` to enable a single re-prompt on failure. */
-export interface ParseJSONOptions {
-    retry?: {
-        /** Original messages used to produce the first LLM response. */
-        messages: ParseJSONMessage[];
-        /** Optional system prompt for the retry call. */
-        systemPrompt?: string;
-    };
-}
-/**
- * Abstract base for all LLM clients.
- * Provides a shared parseJSON() implementation with safeParse-based validation,
- * and model-tier routing (main vs light model selection).
- */
-export declare abstract class BaseLLMClient {
-    /** Optional light model for routine tasks. Set by subclasses via constructor. */
-    protected lightModel?: string;
-    /**
-     * Resolve the effective model name based on model_tier and configured light_model.
-     * When model_tier is 'light' and lightModel is set, returns lightModel.
-     * Otherwise returns the default model passed in. Ensures backward compatibility
-     * when light_model is not configured.
-     */
-    protected resolveEffectiveModel(defaultModel: string, tier?: ModelTier): string;
-    /**
-     * Send messages to the LLM and return the response text.
-     * Used internally by parseJSON retry logic.
-     * Subclasses that support retry must override this method.
-     */
-    protected callLLMRaw(_messages: ParseJSONMessage[], _systemPrompt?: string): Promise<string>;
-    /**
-     * Attempt to parse and validate a single content string against the schema.
-     * Returns the parsed value on success, or throws LLMError on failure.
-     */
-    private attemptParse;
-    /**
-     * Extract JSON from LLM response text (handles markdown code blocks)
-     * and validate against the given Zod schema.
-     * Throws on parse failure or schema validation failure with detailed messages.
-     *
-     * When `options.retry` is provided, a single retry is attempted on first failure:
-     * the original messages are re-sent with an error feedback message appended.
-     */
-    parseJSON<T>(content: string, schema: ZodSchema<T>, options?: ParseJSONOptions): Promise<T>;
-    parseJSON<T>(content: string, schema: ZodSchema<T>): T;
-}
-//# sourceMappingURL=base-llm-client.d.ts.map

package/dist/base/llm/base-llm-client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"base-llm-client.d.ts","sourceRoot":"","sources":["../../../src/base/llm/base-llm-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAMrC,2EAA2E;AAC3E,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAIzC,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,kDAAkD;AAClD,eAAO,MAAM,sBAAsB,QAAS,CAAC;AAE7C,2DAA2D;AAC3D,eAAO,MAAM,kBAAkB,IAAI,CAAC;AAEpC,6DAA6D;AAC7D,eAAO,MAAM,eAAe,UAAqB,CAAC;AAElD,kFAAkF;AAClF,eAAO,MAAM,0BAA0B,UAAoC,CAAC;AAE5E;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAMtD;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAejF;AAID;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA2DhD;AAID,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qFAAqF;AACrF,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE;QACN,gEAAgE;QAChE,QAAQ,EAAE,gBAAgB,EAAE,CAAC;QAC7B,iDAAiD;QACjD,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,CAAC;CACH;AAID;;;;GAIG;AACH,8BAAsB,aAAa;IACjC,iFAAiF;IACjF,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;;OAKG;IACH,SAAS,CAAC,qBAAqB,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM;IAO/E;;;;OAIG;cAEa,UAAU,CAAC,SAAS,EAAE,gBAAgB,EAAE,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlG;;;OAGG;IACH,OAAO,CAAC,YAAY;IAoBpB;;;;;;;OAOG;IACG,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,CAAC,CAAC;IACjG,SAAS,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;CAmCvD"}

package/dist/base/llm/base-llm-client.js

@@ -1,210 +0,0 @@
-import { LLMError } from "../utils/errors.js";
-import { sanitizeLLMJson } from "./json-sanitizer.js";
-// ─── Shared constants ───
-export const DEFAULT_MAX_TOKENS = 4096;
-/** Default LLM request timeout in milliseconds */
-export const DEFAULT_LLM_TIMEOUT_MS = 60_000;
-/** Maximum number of retry attempts on transient errors */
-export const MAX_RETRY_ATTEMPTS = 3;
-/** Exponential backoff delays in milliseconds: 1s, 2s, 4s */
-export const RETRY_DELAYS_MS = [1000, 2000, 4000];
-/** Extended backoff delays for HTTP 429 rate-limit responses (up to 5 retries) */
-export const RATE_LIMIT_RETRY_DELAYS_MS = [2000, 8000, 16000, 32000, 60000];
-/**
- * Returns true if the error represents an HTTP 429 rate-limit response.
- */
-export function isRateLimitError(err) {
-    if (err != null && typeof err === "object" && "status" in err) {
-        if (err.status === 429)
-            return true;
-    }
-    const msg = err instanceof Error ? err.message : String(err);
-    return msg.includes("429") || /rate.?limit/i.test(msg);
-}
-/**
- * Returns the retry delay in milliseconds for a rate-limit error.
- * Respects the Retry-After header when present, otherwise falls back to
- * RATE_LIMIT_RETRY_DELAYS_MS[attemptIndex].
- * Adds jitter (±50%) to avoid thundering-herd.
- */
-export function getRateLimitRetryDelay(err, attemptIndex) {
-    // Check for Retry-After header
-    if (err != null && typeof err === "object" && "headers" in err) {
-        const headers = err.headers;
-        if (headers != null && typeof headers === "object" && "retry-after" in headers) {
-            const retryAfter = headers["retry-after"];
-            const seconds = typeof retryAfter === "string" ? parseFloat(retryAfter) : Number(retryAfter);
-            if (!isNaN(seconds) && seconds > 0) {
-                const delay = seconds * 1000;
-                return delay * (0.5 + Math.random());
-            }
-        }
-    }
-    const base = RATE_LIMIT_RETRY_DELAYS_MS[attemptIndex] ?? RATE_LIMIT_RETRY_DELAYS_MS[RATE_LIMIT_RETRY_DELAYS_MS.length - 1];
-    return base * (0.5 + Math.random());
-}
-// ─── JSON extraction utility ───
-/**
- * Extract JSON from a string that may contain markdown code blocks or prose.
- *
- * Strategies (first match wins):
- * 1. Fast path — already valid JSON, return as-is
- * 2. Code fence extraction — ```json ... ``` or ``` ... ```
- * 3. Brace matching — find first { or [ and last matching } or ]
- */
-export function extractJSON(text) {
-    const trimmed = text.trim();
-    // 1. Fast path: already valid JSON
-    try {
-        JSON.parse(trimmed);
-        return trimmed;
-    }
-    catch {
-        // not bare JSON, continue
-    }
-    // 2. Code fence extraction
-    const jsonBlock = trimmed.match(/```json\s*([\s\S]*?)```/);
-    if (jsonBlock) {
-        return jsonBlock[1].trim();
-    }
-    const genericBlock = trimmed.match(/```(?:[a-zA-Z0-9_-]+)?\s*([\s\S]*?)```/);
-    if (genericBlock) {
-        return genericBlock[1].trim();
-    }
-    // 3. Depth-aware brace matching: scan from first { or [ to its matching close
-    const firstBrace = trimmed.indexOf("{");
-    const firstBracket = trimmed.indexOf("[");
-    let start = -1;
-    let openChar;
-    let closeChar;
-    if (firstBrace === -1 && firstBracket === -1) {
-        return trimmed;
-    }
-    else if (firstBrace === -1 || (firstBracket !== -1 && firstBracket < firstBrace)) {
-        start = firstBracket;
-        openChar = "[";
-        closeChar = "]";
-    }
-    else {
-        start = firstBrace;
-        openChar = "{";
-        closeChar = "}";
-    }
-    let depth = 0;
-    let inString = false;
-    let escape = false;
-    for (let i = start; i < trimmed.length; i++) {
-        const ch = trimmed[i];
-        if (escape) {
-            escape = false;
-            continue;
-        }
-        if (ch === "\\" && inString) {
-            escape = true;
-            continue;
-        }
-        if (ch === '"') {
-            inString = !inString;
-            continue;
-        }
-        if (inString)
-            continue;
-        if (ch === openChar) {
-            depth++;
-        }
-        else if (ch === closeChar) {
-            depth--;
-            if (depth === 0) {
-                return trimmed.slice(start, i + 1);
-            }
-        }
-    }
-    return trimmed;
-}
-// ─── BaseLLMClient ───
-/**
- * Abstract base for all LLM clients.
- * Provides a shared parseJSON() implementation with safeParse-based validation,
- * and model-tier routing (main vs light model selection).
- */
-export class BaseLLMClient {
-    /** Optional light model for routine tasks. Set by subclasses via constructor. */
-    lightModel;
-    /**
-     * Resolve the effective model name based on model_tier and configured light_model.
-     * When model_tier is 'light' and lightModel is set, returns lightModel.
-     * Otherwise returns the default model passed in. Ensures backward compatibility
-     * when light_model is not configured.
-     */
-    resolveEffectiveModel(defaultModel, tier) {
-        const effectiveModel = (tier === "light" && this.lightModel)
-            ? this.lightModel
-            : defaultModel;
-        return effectiveModel;
-    }
-    /**
-     * Send messages to the LLM and return the response text.
-     * Used internally by parseJSON retry logic.
-     * Subclasses that support retry must override this method.
-     */
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
-    async callLLMRaw(_messages, _systemPrompt) {
-        throw new LLMError("callLLMRaw not implemented — override in subclass to enable parseJSON retry");
-    }
-    /**
-     * Attempt to parse and validate a single content string against the schema.
-     * Returns the parsed value on success, or throws LLMError on failure.
-     */
-    attemptParse(content, schema) {
-        const jsonText = sanitizeLLMJson(extractJSON(content));
-        let raw;
-        try {
-            raw = JSON.parse(jsonText);
-        }
-        catch (err) {
-            const msg = `LLM response JSON parse failed — ${String(err)}`;
-            console.warn(`[parseJSON] ${msg} | raw(200): ${content.slice(0, 200)}`);
-            throw new LLMError(`${msg}\nContent: ${content}`);
-        }
-        const result = schema.safeParse(raw);
-        if (!result.success) {
-            const issues = result.error.issues.map((i) => i.message).join(", ");
-            const msg = `LLM response validation failed: ${issues}`;
-            console.warn(`[parseJSON] ${msg} | raw(200): ${JSON.stringify(raw).slice(0, 200)}`);
-            throw new LLMError(`${msg}. Raw: ${JSON.stringify(raw).slice(0, 200)}`);
-        }
-        return result.data;
-    }
-    parseJSON(content, schema, options) {
-        if (!options?.retry) {
-            return this.attemptParse(content, schema);
-        }
-        // Async path: retry enabled
-        return (async () => {
-            let firstError;
-            try {
-                return this.attemptParse(content, schema);
-            }
-            catch (err) {
-                firstError = err;
-            }
-            console.warn(`[parseJSON] first attempt failed, retrying... Error: ${firstError.message}`);
-            const retryMessages = [
-                ...options.retry.messages,
-                {
-                    role: "user",
-                    content: `Your previous response was not valid JSON. Error: ${firstError.message}. Please respond with ONLY valid JSON matching the required schema, no other text.`,
-                },
-            ];
-            const retryContent = await this.callLLMRaw(retryMessages, options.retry.systemPrompt);
-            try {
-                return this.attemptParse(retryContent, schema);
-            }
-            catch (err) {
-                console.warn(`[parseJSON] retry also failed`);
-                throw err;
-            }
-        })();
-    }
-}
-//# sourceMappingURL=base-llm-client.js.map

package/dist/base/llm/base-llm-client.js.map

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

package/dist/base/llm/codex-llm-client.d.ts

@@ -1,45 +0,0 @@
-import { BaseLLMClient } from "./base-llm-client.js";
-import { type ILLMClient, type LLMMessage, type LLMRequestOptions, type LLMResponse } from "./llm-client.js";
-export interface CodexLLMClientConfig {
-    /** Path to the codex CLI executable. Default: "codex" */
-    cliPath?: string;
-    /** Model to pass via --model flag. Default: uses codex's default (OPENAI_MODEL env or codex config) */
-    model?: string;
-    /** Light model for routine/cheap calls (model_tier: 'light'). Optional. */
-    lightModel?: string;
-    /** Repository path passed to Codex for workspace-aware execution. Default: "." */
-    repoPath?: string;
-    /** Timeout per call in milliseconds. Default: 120000 (2 minutes) */
-    timeoutMs?: number;
-}
-/**
- * ILLMClient implementation that uses the `codex exec` CLI for LLM calls.
- * Routes all PulSeed internal LLM calls through the Codex CLI, which uses
- * the ChatGPT subscription (no separate API key needed).
- *
- * Uses `codex exec -s danger-full-access -o <tmpfile> "PROMPT"` per call.
- * The -o flag writes the final response to a temp file for clean output.
- * Usage stats are not available from the CLI and will always be 0.
- *
- * Set PULSEED_LLM_PROVIDER=codex to activate via CLIRunner / provider-factory.
- */
-export declare class CodexLLMClient extends BaseLLMClient implements ILLMClient {
-    private readonly cliPath;
-    private readonly model;
-    private readonly repoPath;
-    private readonly timeoutMs;
-    constructor(config?: CodexLLMClientConfig);
-    /**
-     * Send a message to the Codex CLI with retry logic.
-     * Retries up to MAX_RETRY_ATTEMPTS times with exponential backoff on spawn failures.
-     */
-    sendMessage(messages: LLMMessage[], options?: LLMRequestOptions): Promise<LLMResponse>;
-    /** CodexLLMClient does not support native provider function/tool calling. */
-    supportsToolCalling(): boolean;
-    /**
-     * Spawn `codex exec -s danger-full-access [-o <tmpfile>] [--model <model>] "PROMPT"`
-     * and return the response content read from the temp output file.
-     */
-    private _spawnCodex;
-}
-//# sourceMappingURL=codex-llm-client.d.ts.map

package/dist/base/llm/codex-llm-client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"codex-llm-client.d.ts","sourceRoot":"","sources":["../../../src/base/llm/codex-llm-client.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,aAAa,EAAuC,MAAM,sBAAsB,CAAC;AAC1F,OAAO,EACL,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAC;AAkCzB,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uGAAuG;IACvG,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;GAUG;AACH,qBAAa,cAAe,SAAQ,aAAc,YAAW,UAAU;IACrE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,MAAM,GAAE,oBAAyB;IAS7C;;;OAGG;IACG,WAAW,CACf,QAAQ,EAAE,UAAU,EAAE,EACtB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,WAAW,CAAC;IA8BvB,6EAA6E;IAC7E,mBAAmB,IAAI,OAAO;IAE9B;;;OAGG;YACW,WAAW;CAkH1B"}