@winspan/claude-forge 8.54.4 → 9.2.0

package/dist/core/queue/index.js

@@ -19,8 +19,8 @@ import { randomUUID } from 'node:crypto';
 import { logger } from '../utils/logger.js';
 import { FORGE_PATHS } from '../constants.js';
 // ── Constants ──────────────────────────────────────────────────────────────
-export const QUEUE_DIR = FORGE_PATHS.queue();
-export const DEAD_DIR = FORGE_PATHS.queueDead();
+const QUEUE_DIR = FORGE_PATHS.queue();
+const DEAD_DIR = FORGE_PATHS.queueDead();
 export const MAX_FILES = 500;
 export const TTL_DAYS = 7;
 const TTL_MS = TTL_DAYS * 24 * 60 * 60 * 1000;
@@ -87,7 +87,7 @@ export function enqueueEvent(event) {
  *     - Other error → move to dead-letter, dead++
  *   - Bad JSON → move to dead-letter, dead++
  */
-export async function replayQueue(storage) {
+export async function replayQueue(storage, options = {}) {
     ensureDirs();
     const files = listQueueFiles();
     if (files.length === 0) {
@@ -131,6 +131,17 @@ export async function replayQueue(storage) {
             storage.writeEvent(event);
             rmSync(filePath);
             replayed++;
+            // Re-run the normal handleEvent side effects (TaskSegmenter etc.). A
+            // throw here must NOT undo the replay accounting or strand the file —
+            // the event is already durably in storage.
+            if (options.onReplayed) {
+                try {
+                    options.onReplayed(event);
+                }
+                catch (hookErr) {
+                    logger.warn(`[Queue] onReplayed hook threw for ${filename}: ${hookErr}`);
+                }
+            }
         }
         catch (err) {
             const msg = err instanceof Error ? err.message : String(err);

package/dist/core/queue/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/queue/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC9F,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,8EAA8E;AAC9E,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC;AAC7C,MAAM,CAAC,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC;AAChD,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC;AAC7B,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC;AAE1B,MAAM,MAAM,GAAG,QAAQ,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAE9C,8EAA8E;AAE9E,SAAS,UAAU;IACjB,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,sEAAsE;AACtE,SAAS,cAAc;IACrB,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,SAAS,CAAC;aAC1B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;aAClC,IAAI,EAAE,CAAC,CAAC,uDAAuD;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAC/B,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS;QAAE,OAAO;IAErC,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC;IAC9D,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;QACtD,CAAC;IACH,CAAC;AACH,CAAC;AAED,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,KAAiB;IAC5C,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,CAAC;IAEb,MAAM,OAAO,GAAG,KAAK,CAAC,QAAQ,IAAI,UAAU,EAAE,CAAC;IAC/C,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC5E,MAAM,QAAQ,GAAG,GAAG,EAAE,IAAI,OAAO,OAAO,CAAC;IACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAE3C,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,GAAG,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;AACnF,CAAC;AAQD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,OAAsB;IACtD,UAAU,EAAE,CAAC;IAEb,MAAM,KAAK,GAAG,cAAc,EAAE,CAAC;IAC/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;IAC9C,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,qBAAqB,KAAK,CAAC,MAAM,mBAAmB,CAAC,CAAC;IAElE,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEvB,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAE3C,0EAA0E;QAC1E,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAChC,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,GAAG,MAAM,EAAE,CAAC;gBAChC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBACrC,IAAI,EAAE,CAAC;gBACP,MAAM,CAAC,IAAI,CAAC,uCAAuC,QAAQ,EAAE,CAAC,CAAC;gBAC/D,SAAS;YACX,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CAAC,uBAAuB,QAAQ,eAAe,GAAG,EAAE,CAAC,CAAC;YACjE,SAAS;QACX,CAAC;QAED,0EAA0E;QAC1E,IAAI,KAAiB,CAAC;QACtB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YAC7C,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACrC,IAAI,EAAE,CAAC;YACP,MAAM,CAAC,IAAI,CAAC,oCAAoC,QAAQ,EAAE,CAAC,CAAC;YAC5D,SAAS;QACX,CAAC;QAED,0EAA0E;QAC1E,IAAI,CAAC;YACH,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAC1B,MAAM,CAAC,QAAQ,CAAC,CAAC;YACjB,QAAQ,EAAE,CAAC;QACb,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,IAAI,uBAAuB,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjC,iDAAiD;gBACjD,IAAI,CAAC;oBAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;gBAChD,OAAO,EAAE,CAAC;YACZ,CAAC;iBAAM,CAAC;gBACN,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBACrC,IAAI,EAAE,CAAC;gBACP,MAAM,CAAC,IAAI,CAAC,4CAA4C,QAAQ,KAAK,GAAG,EAAE,CAAC,CAAC;YAC9E,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACrC,CAAC;AAED,8EAA8E;AAE9E,SAAS,gBAAgB,CAAC,QAAgB,EAAE,QAAgB;IAC1D,IAAI,CAAC;QACH,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACzC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CAAC,0BAA0B,QAAQ,oBAAoB,GAAG,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC;YAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC;IAClD,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAS,uBAAuB,CAAC,OAAe;IAC9C,OAAO,OAAO,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAC;AACtD,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/queue/index.ts"],"names":[],"mappings":"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"}

package/dist/core/storage/base.d.ts

@@ -14,6 +14,41 @@ export declare class SQLiteBase {
     protected db: Database.Database;
     protected dbPath: string;
     constructor(dbPath: string);
+    /**
+     * One-shot migration: convert auto_vacuum from NONE (0) to INCREMENTAL (2)
+     * on existing DBs.
+     *
+     * Why this exists
+     * ---------------
+     * Setting `PRAGMA auto_vacuum = INCREMENTAL` in the constructor only takes
+     * effect on a *new* DB (before any table is created). On an existing DB it
+     * silently no-ops, so we must detect mode=0 and run a one-time `VACUUM`
+     * (which rewrites the whole file and flips the persistent header bit).
+     *
+     * Cost: O(DB size). For a 269 MB DB this is a few seconds of writer-lock.
+     * We log around it so an operator notices.
+     *
+     * Idempotent: after the first successful run, `auto_vacuum` reads as 2 and
+     * the migration short-circuits.
+     *
+     * Errors are warn-logged and swallowed — daemon startup must not fail.
+     * Worst case the DB stays on auto_vacuum=0 and the incremental_vacuum calls
+     * elsewhere become no-ops; freelist still grows but nothing breaks.
+     */
+    private migrateAutoVacuumIfNeeded;
+    /**
+     * Reclaim up to `maxPages` free pages from the auto_vacuum=INCREMENTAL
+     * freelist back to the OS. Returns the number of pages reclaimed.
+     *
+     * Called by the event-ttl-sweep service after TTL deletes accumulate free
+     * pages. Safe to call when auto_vacuum != INCREMENTAL — SQLite just returns
+     * 0 pages reclaimed.
+     *
+     * NOTE: not on the public SQLiteStorage facade by default — the daemon
+     * calls through `MaintenanceOperations.incrementalVacuum`. Kept here as a
+     * protected helper so any *Operations subclass can invoke it.
+     */
+    protected incrementalVacuumPages(maxPages: number): number;
     private initSchema;
     protected hasTable(name: string): boolean;
     protected hasColumn(table: string, column: string): boolean;
@@ -45,6 +80,129 @@ export declare class SQLiteBase {
      * One-shot data migrations + deprecated table cleanup.
      */
     private runPostMigrations;
+    /**
+     * Task-tracking overhaul (2026-05-27): one-shot back-fill of `tasks.is_noise`
+     * from existing title heuristics. Idempotent — runs every startup but the
+     * WHERE clause restricts to rows that don't yet match the new state. We do
+     * NOT include the semantic blocklist ('批准', 'approve', '好', 'ok', '可以'
+     * …) intentionally; those are real human acknowledgements and the Bug 1
+     * spec-approval path now absorbs them — see spec § 3.2.
+     *
+     * Backfill only sets is_noise=1; rows already marked stay marked. We never
+     * flip 1→0 here (a future writer change could reclassify a legacy noise
+     * row; that case is best handled by a one-shot script, not boot-time).
+     *
+     * Errors are warn-logged and swallowed — daemon startup must not fail on
+     * data backfill. Worst case the column stays 0 and the Web filter shows
+     * extra rows (which the user can spot and report).
+     */
+    private backfillTasksIsNoiseIfNeeded;
+    /**
+     * spec b1480935 (2026-06-01 Option A § OQ Q3): one-shot back-fill of
+     * `tasks.task_kind` from existing title prefixes. The is_noise column
+     * is deprecated but we keep its backfill running first so legacy rows
+     * still have a usable filter signal during the transition window.
+     *
+     * Mapping (mirrors NOISE_PREFIX_TO_KIND in core/utils/noise-prompt.ts):
+     *   - title LIKE '<task-notification>%'  → 'agent-callback'
+     *   - title LIKE '[Image #%'             → 'image'
+     *   - title LIKE '<system-reminder>%' / '<local-command-stdout>%' /
+     *     '<command-message>%' / '<command-name>%'  → 'system'
+     *   - everything else                    → stays 'user' (default)
+     *
+     * Idempotent: WHERE task_kind = 'user' AND title LIKE ... so a second
+     * boot only touches rows that haven't been promoted yet. We never demote
+     * (1→0 for is_noise had the same invariant) — a row already classified as
+     * 'agent-callback' stays put even if a future writer would have called it
+     * 'system'.
+     *
+     * Errors are warn-logged and swallowed — daemon startup must not fail on
+     * a backfill. Worst case the column stays 'user' on a few legacy envelopes
+     * and they surface in the default Web view (cosmetic only).
+     */
+    private backfillTasksTaskKindIfNeeded;
+    /**
+     * Migration (Spec 2 § B1): drop the rerank-related columns from
+     * `kb_query_log` (strategy / rerank_cache_hit / rerank_failed) and the
+     * compound index that referenced `strategy`. Idempotent — new DBs created
+     * from the current schema.sql skip this entirely; legacy DBs lose the dead
+     * columns on next boot.
+     *
+     * SQLite ≥ 3.35 supports ALTER TABLE DROP COLUMN; better-sqlite3 12.x ships
+     * 3.46 so we use that directly. Errors are warn-logged but never thrown —
+     * worst case the columns linger and the writer just stops populating them.
+     */
+    private dropDeadKbQueryLogColumnsIfNeeded;
+    /**
+     * Migration (Spec 2 § B2): drop the unused `token_usage` table + indexes.
+     * 7d evidence showed 0 rows; the only "live" writer path was never wired
+     * through TokenTracker, so deleting is safe. Idempotent — DROP TABLE IF
+     * EXISTS noops on new DBs (schema.sql no longer declares the table).
+     */
+    private dropTokenUsageIfNeeded;
+    /**
+     * Migration (Spec 2 § B3): drop `routing_events.is_forced`. 7d evidence
+     * showed 0 rows with is_forced=1 — the field was reserved for a feature
+     * (forced/fallback routing) that was never wired. ALTER TABLE DROP COLUMN
+     * lands the column removal in-place; SQLite ≥ 3.35 required.
+     */
+    private dropRoutingIsForcedIfNeeded;
+    /**
+     * Migration (Spec 2 § B4): backfill `routing_events.routed_to_type='pending'`
+     * for the historical rows that user-prompt.ts wrote with NULL placeholder.
+     * 7d evidence showed 297/555 (54%) rows had NULL; with the new write-side
+     * default already minting 'pending', this one-shot UPDATE realigns history.
+     */
+    private backfillRoutingRoutedToTypePending;
+    /**
+     * Migration 010: widen workflow_recommendations.outcome CHECK to include
+     * 'partial_accepted'. SQLite cannot ALTER a CHECK constraint in place — we
+     * detect legacy tables (CHECK string does NOT contain 'partial_accepted')
+     * and rebuild via temp-table copy/drop/rename. Idempotent — new DBs
+     * already created by schema.sql carry the new CHECK and skip.
+     *
+     * Errors are warn-logged but never thrown — daemon startup must not fail
+     * on a migration; worst case the new outcome value just gets rejected at
+     * write time and the calling code's try/catch swallows it (writes here are
+     * fire-and-forget observability).
+     */
+    private rebuildWorkflowRecommendationsCheckIfNeeded;
+    /**
+     * Migration 011 (spec 1100 Option C, 2026-06-02): widen the `outcome` CHECK
+     * on `sessions` + `tasks` from the fixed value enum
+     * `IN ('success','partial','failed','abandoned')` to a non-empty-string
+     * guard `length(outcome) > 0`. This lets the classifier emit the new
+     * `answered` outcome (and any future value) WITHOUT a table rebuild per
+     * value. The rebuild here is the ONE-TIME widening for existing live DBs.
+     *
+     * Why a rebuild: SQLite cannot ALTER a CHECK constraint in place. We mirror
+     * the migration-010 pattern: CREATE *_new → INSERT SELECT → DROP old →
+     * RENAME → recreate indexes.
+     *
+     * Robustness choices:
+     *   - **Idempotent**: detected by sniffing the stored CREATE TABLE `sql`. If
+     *     it no longer contains the old enum fragment (`outcome IN (`) we skip —
+     *     a second boot is a no-op. New DBs created from current schema.sql carry
+     *     the relaxed CHECK already and skip.
+     *   - **Data-preserving**: we don't hand-write the new column list. We take
+     *     the table's existing CREATE statement and string-replace ONLY the
+     *     outcome CHECK fragment, so every column (incl. migration-added ones
+     *     like task_kind / intercept_count) is preserved verbatim, then copy all
+     *     rows with `INSERT INTO new SELECT * FROM old`.
+     *   - **Index-preserving**: we snapshot every non-autoindex on the table
+     *     from sqlite_master BEFORE the drop and replay each `sql` after rename.
+     *   - **FK-safe**: tasks is referenced by task_events(task_id) FK. We run the
+     *     whole rebuild inside a transaction with foreign_keys temporarily OFF so
+     *     the DROP/RENAME doesn't cascade-delete task_events rows. (PRAGMA
+     *     foreign_keys is a no-op inside a transaction in SQLite, so we toggle it
+     *     around the transaction.)
+     *
+     * Errors are warn-logged, never thrown — daemon startup must not fail. Worst
+     * case the old enum CHECK lingers and writing `answered` is rejected at write
+     * time (callers swallow the throw); the operator can re-run after the next
+     * build.
+     */
+    private rebuildOutcomeCheckIfNeeded;
     /**
      * 将 events 表按 session_id 聚合回填到 sessions 表，仅在 sessions 尚未对齐
      * （没有任何一行带 first_prompt）时触发。

package/dist/core/storage/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/core/storage/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAOtC,qBAAa,UAAU;IACrB,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAChC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEb,MAAM,EAAE,MAAM;IAqC1B,OAAO,CAAC,UAAU;IAclB,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAWzC,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAS3D,SAAS,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAerF,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAWzC;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAgD1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAoDhC;;;;;;;;OAQG;IACH,WAAW,IAAI,QAAQ,CAAC,QAAQ;IAIhC,SAAS,IAAI,MAAM;IAInB,SAAS,CAAC,WAAW,IAAI,MAAM;CAIhC"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../src/core/storage/base.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAOtC,qBAAa,UAAU;IACrB,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;IAChC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEb,MAAM,EAAE,MAAM;IAqD1B;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,yBAAyB;IAwBjC;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAa1D,OAAO,CAAC,UAAU;IAclB,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAWzC,SAAS,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAS3D,SAAS,CAAC,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAerF,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAWzC;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IAgJ3B;;;;;;;;OAQG;IACH,OAAO,CAAC,kBAAkB;IAwG1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAoBzB;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,4BAA4B;IAyCpC;;;;;;;;;;;;;;;;;;;;;;OAsBG;IACH,OAAO,CAAC,6BAA6B;IAmCrC;;;;;;;;;;OAUG;IACH,OAAO,CAAC,iCAAiC;IAmBzC;;;;;OAKG;IACH,OAAO,CAAC,sBAAsB;IAU9B;;;;;OAKG;IACH,OAAO,CAAC,2BAA2B;IAWnC;;;;;OAKG;IACH,OAAO,CAAC,kCAAkC;IAc1C;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,2CAA2C;IAsDnD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAkCG;IACH,OAAO,CAAC,2BAA2B;IA8EnC;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAoDhC;;;;;;;;OAQG;IACH,WAAW,IAAI,QAAQ,CAAC,QAAQ;IAIhC,SAAS,IAAI,MAAM;IAInB,SAAS,CAAC,WAAW,IAAI,MAAM;CAIhC"}