opencarly 1.0.0

package/dist/config/schema.js

@@ -0,0 +1,208 @@
+/**
+ * OpenCarly Configuration Schemas
+ *
+ * Zod schemas for all configuration files:
+ * - manifest.json (domain registry, settings)
+ * - commands.json (star-command definitions)
+ * - context.json (context bracket thresholds and rules)
+ * - sessions/*.json (per-session state)
+ */
+import { z } from "zod";
+// ---------------------------------------------------------------------------
+// Domain Configuration (inside manifest.json)
+// ---------------------------------------------------------------------------
+export const DomainConfigSchema = z.object({
+    /** Whether this domain is active */
+    state: z.enum(["active", "inactive"]).default("active"),
+    /** If true, domain rules load on every prompt (no keyword matching) */
+    alwaysOn: z.boolean().default(false),
+    /** Keywords that trigger this domain (substring match, case-insensitive) */
+    recall: z.array(z.string()).default([]),
+    /** Keywords that prevent this domain from loading */
+    exclude: z.array(z.string()).default([]),
+    /** File paths/globs that trigger this domain (e.g., ["*.tsx", "src/components/*"]) */
+    paths: z.array(z.string()).default([]),
+    /** Path to the domain rule file, relative to .opencarly/ */
+    file: z.string(),
+});
+// ---------------------------------------------------------------------------
+// Manifest (manifest.json)
+// ---------------------------------------------------------------------------
+export const ManifestSchema = z.object({
+    /** Schema version for forward compatibility */
+    version: z.literal(1).default(1),
+    /** Enable DEVMODE debug output */
+    devmode: z.boolean().default(false),
+    /** Global exclusion keywords - if any match, skip ALL domain matching */
+    globalExclude: z.array(z.string()).default([]),
+    /** Domain definitions */
+    domains: z.record(z.string(), DomainConfigSchema).default({}),
+    /** Whether star-commands system is enabled */
+    commands: z
+        .object({
+        state: z.enum(["active", "inactive"]).default("active"),
+    })
+        .default({}),
+    /** Whether context bracket system is enabled */
+    context: z
+        .object({
+        state: z.enum(["active", "inactive"]).default("active"),
+    })
+        .default({}),
+});
+// ---------------------------------------------------------------------------
+// Star-Command (commands.json)
+// ---------------------------------------------------------------------------
+export const StarCommandSchema = z.object({
+    /** Description of what this command does */
+    description: z.string().optional(),
+    /** Rules injected when this command is invoked */
+    rules: z.array(z.string()),
+});
+export const CommandsFileSchema = z.record(z.string(), StarCommandSchema);
+// ---------------------------------------------------------------------------
+// Context Brackets (context.json)
+// ---------------------------------------------------------------------------
+export const ContextBracketSchema = z.object({
+    /** Whether this bracket is enabled */
+    enabled: z.boolean().default(true),
+    /** Rules injected when this bracket is active */
+    rules: z.array(z.string()).default([]),
+});
+// ---------------------------------------------------------------------------
+// Tool Output Trimming (inside context.json)
+// ---------------------------------------------------------------------------
+export const TrimmingConfigSchema = z.object({
+    /** Whether tool output trimming is enabled */
+    enabled: z.boolean().default(true),
+    /**
+     * Trimming aggressiveness mode:
+     * - conservative: only trims very stale/superseded outputs (threshold=20)
+     * - moderate: good balance of savings vs safety (threshold=40)
+     * - aggressive: trims most things beyond preserveLastN (threshold=60)
+     */
+    mode: z.enum(["conservative", "moderate", "aggressive"]).default("moderate"),
+    /** Hard floor: never trim tool outputs in the last N messages */
+    preserveLastN: z.number().min(1).default(3),
+});
+// ---------------------------------------------------------------------------
+// Stats Tracking (inside context.json)
+// ---------------------------------------------------------------------------
+export const StatsConfigSchema = z.object({
+    /**
+     * Duration to track stats:
+     * - "all": All sessions (default)
+     * - "month": Only sessions from last 30 days
+     * - "week": Only sessions from last 7 days
+     */
+    trackDuration: z.enum(["all", "month", "week"]).default("all"),
+});
+/** Map trimming mode to score threshold */
+export const TRIM_THRESHOLDS = {
+    conservative: 20,
+    moderate: 40,
+    aggressive: 60,
+};
+export const ContextFileSchema = z.object({
+    /** Prompt count thresholds for bracket transitions */
+    thresholds: z
+        .object({
+        moderate: z.number().default(15),
+        depleted: z.number().default(35),
+        critical: z.number().default(50),
+    })
+        .default({}),
+    /** Bracket definitions */
+    brackets: z
+        .object({
+        fresh: ContextBracketSchema.default({ enabled: true, rules: [] }),
+        moderate: ContextBracketSchema.default({ enabled: true, rules: [] }),
+        depleted: ContextBracketSchema.default({ enabled: true, rules: [] }),
+    })
+        .default({}),
+    /** Smart tool output trimming configuration */
+    trimming: TrimmingConfigSchema.default({}),
+    /** Token stats tracking configuration */
+    stats: StatsConfigSchema.default({}),
+});
+// ---------------------------------------------------------------------------
+// Token Stats (tracked per session, persisted in session file)
+// ---------------------------------------------------------------------------
+export const TokenStatsSchema = z.object({
+    /** Total tokens saved by selective rule injection (all rules minus loaded rules) */
+    tokensSkippedBySelection: z.number().default(0),
+    /** Total tokens of rules actually injected into the system prompt */
+    tokensInjected: z.number().default(0),
+    /** Total tokens trimmed from conversation history (tool outputs) */
+    tokensTrimmedFromHistory: z.number().default(0),
+    /** Total tokens trimmed from stale <carly-rules> blocks in history */
+    tokensTrimmedCarlyBlocks: z.number().default(0),
+    /** Number of prompts processed */
+    promptsProcessed: z.number().default(0),
+    /** Number of rules injected across all prompts */
+    rulesInjected: z.number().default(0),
+    /** Baseline: tokens that would be used if all rules loaded every prompt */
+    baselineTokensPerPrompt: z.number().default(0),
+});
+// ---------------------------------------------------------------------------
+// Cumulative Stats (persisted in stats.json)
+// ---------------------------------------------------------------------------
+export const CumulativeSessionSummarySchema = z.object({
+    sessionId: z.string(),
+    date: z.string(),
+    tokensSaved: z.number(),
+    promptsProcessed: z.number(),
+    tokensSkippedBySelection: z.number().default(0),
+    tokensTrimmedFromHistory: z.number().default(0),
+    tokensTrimmedCarlyBlocks: z.number().default(0),
+    tokensInjected: z.number().default(0),
+    rulesInjected: z.number().default(0),
+});
+export const CumulativeStatsSchema = z.object({
+    version: z.number().default(1),
+    cumulative: z
+        .object({
+        tokensSkippedBySelection: z.number().default(0),
+        tokensInjected: z.number().default(0),
+        tokensTrimmedFromHistory: z.number().default(0),
+        tokensTrimmedCarlyBlocks: z.number().default(0),
+        totalTokensSaved: z.number().default(0),
+    })
+        .default({}),
+    sessions: z.array(CumulativeSessionSummarySchema).default([]),
+});
+// ---------------------------------------------------------------------------
+// Session Override
+// ---------------------------------------------------------------------------
+export const SessionOverrideSchema = z.object({
+    /** Override DEVMODE for this session (null = inherit from manifest) */
+    devmode: z.boolean().nullable().default(null),
+    /** Per-domain state overrides (null = inherit from manifest) */
+    domainStates: z.record(z.string(), z.boolean().nullable()).default({}),
+});
+// ---------------------------------------------------------------------------
+// Session Config (sessions/*.json)
+// ---------------------------------------------------------------------------
+export const SessionConfigSchema = z.object({
+    /** Session ID from OpenCode */
+    id: z.string(),
+    /** ISO timestamp when session was created */
+    started: z.string(),
+    /** Working directory for this session */
+    cwd: z.string(),
+    /** Short label derived from cwd (project directory name) */
+    label: z.string(),
+    /** User-editable session title (auto-generated from first prompt) */
+    title: z.string().nullable().default(null),
+    /** Number of prompts processed in this session */
+    promptCount: z.number().default(0),
+    /** ISO timestamp of last activity */
+    lastActivity: z.string(),
+    /** Files recently read or edited by tools in this session */
+    activeFiles: z.array(z.string()).default([]),
+    /** Session-specific overrides */
+    overrides: SessionOverrideSchema.default({}),
+    /** Cumulative token savings stats for this session */
+    tokenStats: TokenStatsSchema.default({}),
+});
+//# sourceMappingURL=schema.js.map

package/dist/config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/config/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,8EAA8E;AAC9E,8CAA8C;AAC9C,8EAA8E;AAE9E,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,oCAAoC;IACpC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IAEvD,uEAAuE;IACvE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAEpC,4EAA4E;IAC5E,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAEvC,qDAAqD;IACrD,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAExC,sFAAsF;IACtF,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAEtC,4DAA4D;IAC5D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CACjB,CAAC,CAAC;AAIH,8EAA8E;AAC9E,2BAA2B;AAC3B,8EAA8E;AAE9E,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,+CAA+C;IAC/C,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAEhC,kCAAkC;IAClC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAEnC,yEAAyE;IACzE,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAE9C,yBAAyB;IACzB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAE7D,8CAA8C;IAC9C,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC;QACN,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;KACxD,CAAC;SACD,OAAO,CAAC,EAAE,CAAC;IAEd,gDAAgD;IAChD,OAAO,EAAE,CAAC;SACP,MAAM,CAAC;QACN,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;KACxD,CAAC;SACD,OAAO,CAAC,EAAE,CAAC;CACf,CAAC,CAAC;AAIH,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAE9E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,4CAA4C;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAElC,kDAAkD;IAClD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;CAC3B,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC,CAAC;AAI1E,8EAA8E;AAC9E,kCAAkC;AAClC,8EAA8E;AAE9E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,sCAAsC;IACtC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAElC,iDAAiD;IACjD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACvC,CAAC,CAAC;AAIH,8EAA8E;AAC9E,6CAA6C;AAC7C,8EAA8E;AAE9E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,8CAA8C;IAC9C,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAElC;;;;;OAKG;IACH,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAE5E,iEAAiE;IACjE,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;CAC5C,CAAC,CAAC;AAIH,8EAA8E;AAC9E,uCAAuC;AACvC,8EAA8E;AAE9E,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC;;;;;OAKG;IACH,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC;CAC/D,CAAC,CAAC;AAIH,2CAA2C;AAC3C,MAAM,CAAC,MAAM,eAAe,GAA2B;IACrD,YAAY,EAAE,EAAE;IAChB,QAAQ,EAAE,EAAE;IACZ,UAAU,EAAE,EAAE;CACf,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACxC,sDAAsD;IACtD,UAAU,EAAE,CAAC;SACV,MAAM,CAAC;QACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QAChC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;KACjC,CAAC;SACD,OAAO,CAAC,EAAE,CAAC;IAEd,0BAA0B;IAC1B,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC;QACN,KAAK,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACjE,QAAQ,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;QACpE,QAAQ,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;KACrE,CAAC;SACD,OAAO,CAAC,EAAE,CAAC;IAEd,+CAA+C;IAC/C,QAAQ,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC;IAE1C,yCAAyC;IACzC,KAAK,EAAE,iBAAiB,CAAC,OAAO,CAAC,EAAE,CAAC;CACrC,CAAC,CAAC;AAIH,8EAA8E;AAC9E,+DAA+D;AAC/D,8EAA8E;AAE9E,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,oFAAoF;IACpF,wBAAwB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAE/C,qEAAqE;IACrE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAErC,oEAAoE;IACpE,wBAAwB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAE/C,sEAAsE;IACtE,wBAAwB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAE/C,kCAAkC;IAClC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEvC,kDAAkD;IAClD,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEpC,2EAA2E;IAC3E,uBAAuB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;CAC/C,CAAC,CAAC;AAIH,8EAA8E;AAC9E,6CAA6C;AAC7C,8EAA8E;AAE9E,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC5B,wBAAwB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,wBAAwB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,wBAAwB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACrC,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;CACrC,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC9B,UAAU,EAAE,CAAC;SACV,MAAM,CAAC;QACN,wBAAwB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QACrC,wBAAwB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/C,wBAAwB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;QAC/C,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;KACxC,CAAC;SACD,OAAO,CAAC,EAAE,CAAC;IACd,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CAC9D,CAAC,CAAC;AAIH,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E;AAE9E,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,uEAAuE;IACvE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAE7C,gEAAgE;IAChE,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;CACvE,CAAC,CAAC;AAIH,8EAA8E;AAC9E,mCAAmC;AACnC,8EAA8E;AAE9E,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,+BAA+B;IAC/B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IAEd,6CAA6C;IAC7C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IAEnB,yCAAyC;IACzC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;IAEf,4DAA4D;IAC5D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IAEjB,qEAAqE;IACrE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAE1C,kDAAkD;IAClD,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAElC,qCAAqC;IACrC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;IAExB,6DAA6D;IAC7D,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAE5C,iCAAiC;IACjC,SAAS,EAAE,qBAAqB,CAAC,OAAO,CAAC,EAAE,CAAC;IAE5C,sDAAsD;IACtD,UAAU,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;CACzC,CAAC,CAAC"}

package/dist/engine/brackets.d.ts

@@ -0,0 +1,26 @@
+/**
+ * OpenCarly Context Bracket Resolution
+ *
+ * Maps prompt count to a context bracket (FRESH, MODERATE, DEPLETED, CRITICAL).
+ * Uses configurable thresholds from context.json.
+ */
+import type { ContextFile, BracketName } from "../config/schema";
+export interface BracketResult {
+    /** Current bracket name */
+    name: BracketName;
+    /** Rules for the current bracket */
+    rules: string[];
+    /** The threshold that was crossed (for display) */
+    threshold: number;
+}
+/**
+ * Determine the active context bracket based on prompt count.
+ *
+ * Brackets (from least to most urgent):
+ * - FRESH: promptCount < moderate threshold
+ * - MODERATE: promptCount >= moderate but < depleted
+ * - DEPLETED: promptCount >= depleted but < critical
+ * - CRITICAL: promptCount >= critical (uses DEPLETED rules + warning)
+ */
+export declare function getBracket(promptCount: number, context: ContextFile): BracketResult;
+//# sourceMappingURL=brackets.d.ts.map

package/dist/engine/brackets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"brackets.d.ts","sourceRoot":"","sources":["../../src/engine/brackets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAMjE,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,IAAI,EAAE,WAAW,CAAC;IAElB,oCAAoC;IACpC,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CACxB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,WAAW,GACnB,aAAa,CAiCf"}

package/dist/engine/brackets.js

@@ -0,0 +1,49 @@
+/**
+ * OpenCarly Context Bracket Resolution
+ *
+ * Maps prompt count to a context bracket (FRESH, MODERATE, DEPLETED, CRITICAL).
+ * Uses configurable thresholds from context.json.
+ */
+// ---------------------------------------------------------------------------
+// Bracket resolution
+// ---------------------------------------------------------------------------
+/**
+ * Determine the active context bracket based on prompt count.
+ *
+ * Brackets (from least to most urgent):
+ * - FRESH: promptCount < moderate threshold
+ * - MODERATE: promptCount >= moderate but < depleted
+ * - DEPLETED: promptCount >= depleted but < critical
+ * - CRITICAL: promptCount >= critical (uses DEPLETED rules + warning)
+ */
+export function getBracket(promptCount, context) {
+    const { thresholds, brackets } = context;
+    if (promptCount >= thresholds.critical) {
+        // CRITICAL uses depleted rules (same as CARL behavior)
+        return {
+            name: "CRITICAL",
+            rules: brackets.depleted.enabled ? brackets.depleted.rules : [],
+            threshold: thresholds.critical,
+        };
+    }
+    if (promptCount >= thresholds.depleted) {
+        return {
+            name: "DEPLETED",
+            rules: brackets.depleted.enabled ? brackets.depleted.rules : [],
+            threshold: thresholds.depleted,
+        };
+    }
+    if (promptCount >= thresholds.moderate) {
+        return {
+            name: "MODERATE",
+            rules: brackets.moderate.enabled ? brackets.moderate.rules : [],
+            threshold: thresholds.moderate,
+        };
+    }
+    return {
+        name: "FRESH",
+        rules: brackets.fresh.enabled ? brackets.fresh.rules : [],
+        threshold: 0,
+    };
+}
+//# sourceMappingURL=brackets.js.map

package/dist/engine/brackets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"brackets.js","sourceRoot":"","sources":["../../src/engine/brackets.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmBH,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E;;;;;;;;GAQG;AACH,MAAM,UAAU,UAAU,CACxB,WAAmB,EACnB,OAAoB;IAEpB,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC;IAEzC,IAAI,WAAW,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;QACvC,uDAAuD;QACvD,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;YAC/D,SAAS,EAAE,UAAU,CAAC,QAAQ;SAC/B,CAAC;IACJ,CAAC;IAED,IAAI,WAAW,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;QACvC,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;YAC/D,SAAS,EAAE,UAAU,CAAC,QAAQ;SAC/B,CAAC;IACJ,CAAC;IAED,IAAI,WAAW,IAAI,UAAU,CAAC,QAAQ,EAAE,CAAC;QACvC,OAAO;YACL,IAAI,EAAE,UAAU;YAChB,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;YAC/D,SAAS,EAAE,UAAU,CAAC,QAAQ;SAC/B,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;QACzD,SAAS,EAAE,CAAC;KACb,CAAC;AACJ,CAAC"}

package/dist/engine/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Engine module exports
+ */
+export { matchDomains, detectStarCommands, type MatchResult } from "./matcher";
+export { loadRules, calculateBaseline, type LoadedRules } from "./loader";
+export { getBracket, type BracketResult } from "./brackets";
+export { trimMessageHistory, type TrimStats } from "./trimmer";
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,KAAK,WAAW,EAAE,MAAM,UAAU,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,KAAK,aAAa,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,KAAK,SAAS,EAAE,MAAM,WAAW,CAAC"}

package/dist/engine/index.js

@@ -0,0 +1,8 @@
+/**
+ * Engine module exports
+ */
+export { matchDomains, detectStarCommands } from "./matcher";
+export { loadRules, calculateBaseline } from "./loader";
+export { getBracket } from "./brackets";
+export { trimMessageHistory } from "./trimmer";
+//# sourceMappingURL=index.js.map

package/dist/engine/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAoB,MAAM,WAAW,CAAC;AAC/E,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAoB,MAAM,UAAU,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAsB,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAkB,MAAM,WAAW,CAAC"}

package/dist/engine/loader.d.ts

@@ -0,0 +1,82 @@
+/**
+ * OpenCarly Rule Loader
+ *
+ * Loads rules from domain .md files, star-commands, and context brackets
+ * based on match results from the matcher.
+ */
+import type { CarlyConfig } from "../config/manifest";
+import type { MatchResult } from "./matcher";
+import type { BracketResult } from "./brackets";
+import type { BracketName } from "../config/schema";
+export interface LoadedRules {
+    /** Always-on domain rules: { domainName: rules[] } */
+    alwaysOn: Record<string, string[]>;
+    /** Keyword-matched domain rules: { domainName: rules[] } */
+    matched: Record<string, string[]>;
+    /** Star-command rules: { commandName: rules[] } */
+    commands: Record<string, string[]>;
+    /** Context bracket rules for the current bracket */
+    bracketRules: string[];
+    /** Current context bracket name */
+    bracket: BracketName;
+    /** Prompt count info for display */
+    promptCount: number;
+    /** Bracket threshold for display */
+    bracketThreshold: number;
+    /** Keywords that triggered each matched domain */
+    matchedKeywords: Record<string, string[]>;
+    /** File paths that triggered each matched domain */
+    matchedPaths: Record<string, string[]>;
+    /** Domains excluded and why */
+    excludedDomains: Record<string, string[]>;
+    /** Global exclusion keywords found */
+    globalExcluded: string[];
+    /** Whether DEVMODE is active */
+    devmode: boolean;
+    /** Whether context bracket system is enabled */
+    contextEnabled: boolean;
+    /** Whether commands system is enabled */
+    commandsEnabled: boolean;
+    /** Domains that are available but not loaded (for summary) */
+    availableDomains: Array<{
+        name: string;
+        recall: string[];
+    }>;
+    /** Injection stats for DEVMODE display (populated by plugin entry point) */
+    injectionStats: {
+        rulesThisPrompt: number;
+        totalRulesSession: number;
+        totalPromptsSession: number;
+        avgRulesPerPrompt: number;
+    } | null;
+    /** Cumulative token savings for the session (populated by plugin entry point) */
+    tokenSavings: {
+        /** Tokens saved by not loading all rules every prompt */
+        skippedBySelection: number;
+        /** Tokens trimmed from conversation history (tool outputs) */
+        trimmedFromHistory: number;
+        /** Tokens trimmed from stale carly-rules blocks */
+        trimmedCarlyBlocks: number;
+        /** Total tokens of rules actually injected this session */
+        tokensInjected: number;
+        /** Baseline: what all rules would cost per prompt */
+        baselinePerPrompt: number;
+        /** Total estimated savings */
+        totalSaved: number;
+        /** Prompts processed */
+        promptsProcessed: number;
+        /** Whether *stats command is active (show full report) */
+        showFullReport: boolean;
+    } | null;
+}
+/**
+ * Calculate the "all rules loaded every prompt" baseline.
+ * This is what you'd get if you put everything in AGENTS.md.
+ * Returns estimated tokens per prompt.
+ */
+export declare function calculateBaseline(config: CarlyConfig): number;
+/**
+ * Load all rules based on match results, config, and current bracket.
+ */
+export declare function loadRules(matchResult: MatchResult, config: CarlyConfig, bracket: BracketResult, promptCount: number): LoadedRules;
+//# sourceMappingURL=loader.d.ts.map

package/dist/engine/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../src/engine/loader.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAgB,MAAM,kBAAkB,CAAC;AAMlE,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAEnC,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAElC,mDAAmD;IACnD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAEnC,oDAAoD;IACpD,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB,mCAAmC;IACnC,OAAO,EAAE,WAAW,CAAC;IAErB,oCAAoC;IACpC,WAAW,EAAE,MAAM,CAAC;IAEpB,oCAAoC;IACpC,gBAAgB,EAAE,MAAM,CAAC;IAEzB,kDAAkD;IAClD,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAE1C,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAEvC,+BAA+B;IAC/B,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAE1C,sCAAsC;IACtC,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB,gCAAgC;IAChC,OAAO,EAAE,OAAO,CAAC;IAEjB,gDAAgD;IAChD,cAAc,EAAE,OAAO,CAAC;IAExB,yCAAyC;IACzC,eAAe,EAAE,OAAO,CAAC;IAEzB,8DAA8D;IAC9D,gBAAgB,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAE5D,4EAA4E;IAC5E,cAAc,EAAE;QACd,eAAe,EAAE,MAAM,CAAC;QACxB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,iBAAiB,EAAE,MAAM,CAAC;KAC3B,GAAG,IAAI,CAAC;IAET,iFAAiF;IACjF,YAAY,EAAE;QACZ,yDAAyD;QACzD,kBAAkB,EAAE,MAAM,CAAC;QAC3B,8DAA8D;QAC9D,kBAAkB,EAAE,MAAM,CAAC;QAC3B,mDAAmD;QACnD,kBAAkB,EAAE,MAAM,CAAC;QAC3B,2DAA2D;QAC3D,cAAc,EAAE,MAAM,CAAC;QACvB,qDAAqD;QACrD,iBAAiB,EAAE,MAAM,CAAC;QAC1B,8BAA8B;QAC9B,UAAU,EAAE,MAAM,CAAC;QACnB,wBAAwB;QACxB,gBAAgB,EAAE,MAAM,CAAC;QACzB,0DAA0D;QAC1D,cAAc,EAAE,OAAO,CAAC;KACzB,GAAG,IAAI,CAAC;CACV;AAsBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAgC7D;AAMD;;GAEG;AACH,wBAAgB,SAAS,CACvB,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,aAAa,EACtB,WAAW,EAAE,MAAM,GAClB,WAAW,CAwFb"}

package/dist/engine/loader.js

@@ -0,0 +1,147 @@
+/**
+ * OpenCarly Rule Loader
+ *
+ * Loads rules from domain .md files, star-commands, and context brackets
+ * based on match results from the matcher.
+ */
+import * as path from "path";
+import { parseDomainFile } from "../config/manifest";
+// ---------------------------------------------------------------------------
+// Domain rule loading
+// ---------------------------------------------------------------------------
+/**
+ * Load rules from a single domain's .md file.
+ */
+function loadDomainRules(_domainName, domain, configPath) {
+    const filePath = path.join(configPath, domain.file);
+    return parseDomainFile(filePath);
+}
+// ---------------------------------------------------------------------------
+// Baseline calculation
+// ---------------------------------------------------------------------------
+/**
+ * Calculate the "all rules loaded every prompt" baseline.
+ * This is what you'd get if you put everything in AGENTS.md.
+ * Returns estimated tokens per prompt.
+ */
+export function calculateBaseline(config) {
+    const { manifest, commands, configPath } = config;
+    let totalRuleText = 0;
+    // All domain rules
+    for (const [, domain] of Object.entries(manifest.domains)) {
+        if (domain.state === "inactive")
+            continue;
+        const filePath = path.join(configPath, domain.file);
+        const rules = parseDomainFile(filePath);
+        for (const rule of rules) {
+            totalRuleText += rule.length;
+        }
+    }
+    // All star-command rules
+    for (const [, cmd] of Object.entries(commands)) {
+        for (const rule of cmd.rules) {
+            totalRuleText += rule.length;
+        }
+    }
+    // All bracket rules
+    const { context } = config;
+    const bracketRuleLengths = [
+        context.brackets.fresh.rules.join("").length,
+        context.brackets.moderate.rules.join("").length,
+        context.brackets.depleted.rules.join("").length,
+    ];
+    totalRuleText += bracketRuleLengths.reduce((a, b) => a + b, 0);
+    // Convert chars to estimated tokens
+    return Math.ceil(totalRuleText / 4);
+}
+// ---------------------------------------------------------------------------
+// Main loader
+// ---------------------------------------------------------------------------
+/**
+ * Load all rules based on match results, config, and current bracket.
+ */
+export function loadRules(matchResult, config, bracket, promptCount) {
+    const { manifest, commands, configPath } = config;
+    const loaded = {
+        alwaysOn: {},
+        matched: {},
+        commands: {},
+        bracketRules: [],
+        bracket: bracket.name,
+        promptCount,
+        bracketThreshold: bracket.threshold,
+        matchedKeywords: matchResult.matched,
+        matchedPaths: matchResult.matchedPaths,
+        excludedDomains: matchResult.excluded,
+        globalExcluded: matchResult.globalExcluded,
+        devmode: manifest.devmode,
+        contextEnabled: manifest.context.state === "active",
+        commandsEnabled: manifest.commands.state === "active",
+        availableDomains: [],
+        injectionStats: null,
+        tokenSavings: null,
+    };
+    // Load always-on domain rules
+    for (const domainName of matchResult.alwaysOn) {
+        const domain = manifest.domains[domainName];
+        if (domain) {
+            const rules = loadDomainRules(domainName, domain, configPath);
+            if (rules.length > 0) {
+                loaded.alwaysOn[domainName] = rules;
+            }
+        }
+    }
+    // Load keyword-matched domain rules
+    for (const domainName of Object.keys(matchResult.matched)) {
+        const domain = manifest.domains[domainName];
+        if (domain) {
+            const rules = loadDomainRules(domainName, domain, configPath);
+            if (rules.length > 0) {
+                loaded.matched[domainName] = rules;
+            }
+        }
+    }
+    // Load path-matched domain rules
+    for (const domainName of Object.keys(matchResult.matchedPaths)) {
+        const domain = manifest.domains[domainName];
+        if (domain) {
+            const rules = loadDomainRules(domainName, domain, configPath);
+            if (rules.length > 0) {
+                // We put them in loaded.matched to be injected alongside keyword-matched rules
+                loaded.matched[domainName] = rules;
+            }
+        }
+    }
+    // Load star-command rules
+    if (manifest.commands.state === "active" && matchResult.starCommands.length > 0) {
+        for (const cmdName of matchResult.starCommands) {
+            const cmd = commands[cmdName];
+            if (cmd && cmd.rules.length > 0) {
+                loaded.commands[cmdName] = cmd.rules;
+            }
+        }
+    }
+    // Load context bracket rules
+    if (manifest.context.state === "active") {
+        loaded.bracketRules = bracket.rules;
+    }
+    // Collect available but not loaded domains (for summary)
+    for (const [name, domain] of Object.entries(manifest.domains)) {
+        if (domain.state === "inactive")
+            continue;
+        if (domain.alwaysOn)
+            continue;
+        // Skip if already matched or excluded
+        if (matchResult.matched[name])
+            continue;
+        if (matchResult.matchedPaths[name])
+            continue;
+        if (matchResult.excluded[name])
+            continue;
+        if (domain.recall.length > 0) {
+            loaded.availableDomains.push({ name, recall: domain.recall });
+        }
+    }
+    return loaded;
+}
+//# sourceMappingURL=loader.js.map

package/dist/engine/loader.js.map

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

package/dist/engine/matcher.d.ts

@@ -0,0 +1,43 @@
+/**
+ * OpenCarly Domain Matcher
+ *
+ * Scans user prompts for domain recall keywords and star-commands.
+ * Handles global and per-domain exclusions.
+ */
+import type { Manifest } from "../config/schema";
+export interface MatchResult {
+    /** Domains matched via recall keywords: { domainName: matchedKeywords[] } */
+    matched: Record<string, string[]>;
+    /** Domains matched via file paths: { domainName: matchedPaths[] } */
+    matchedPaths: Record<string, string[]>;
+    /** Domains excluded by per-domain exclusion: { domainName: excludingKeywords[] } */
+    excluded: Record<string, string[]>;
+    /** Global exclusion keywords that were found (blocks all matching) */
+    globalExcluded: string[];
+    /** Star-commands detected (lowercase, without asterisk) */
+    starCommands: string[];
+    /** Always-on domains that are active */
+    alwaysOn: string[];
+}
+/**
+ * Detect star-commands in the prompt.
+ * e.g. "*brief *dev explain this" -> ["brief", "dev"]
+ */
+export declare function detectStarCommands(prompt: string): string[];
+/**
+ * Check if a file path matches any of the given glob patterns.
+ */
+export declare function isPathMatch(filePath: string, patterns: string[]): boolean;
+/**
+ * Match domains against a user prompt.
+ *
+ * Algorithm:
+ * 1. Check globalExclude - if any match, skip all domain matching
+ * 2. Collect always-on active domains
+ * 3. For each active, non-alwaysOn domain:
+ *    a. Check per-domain exclude keywords
+ *    b. Check recall keywords
+ * 4. Detect star-commands
+ */
+export declare function matchDomains(prompt: string, manifest: Manifest, activeFiles?: string[]): MatchResult;
+//# sourceMappingURL=matcher.d.ts.map

package/dist/engine/matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../src/engine/matcher.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAMjD,MAAM,WAAW,WAAW;IAC1B,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAElC,qEAAqE;IACrE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAEvC,oFAAoF;IACpF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAEnC,sEAAsE;IACtE,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB,2DAA2D;IAC3D,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB,wCAAwC;IACxC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAMD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAU3D;AA0BD;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,OAAO,CAOzE;AAsDD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,QAAQ,EAClB,WAAW,GAAE,MAAM,EAAO,GACzB,WAAW,CA0Eb"}