basalt-ui 1.40.3 → 2.0.0

package/dist/agent/part-list.d.ts

@@ -46,21 +46,21 @@ export type AgentPartRenderers<TPart extends AgentPart = AgentPart> = {
     readonly error: ErrorPartRenderer<TPart>;
 };
 export type PartListProps<TPart extends AgentPart = AgentPart> = {
-    /** The parts accumulator from useAgentStream. */
+    /** The parts accumulator from useAgentThreadRuns. */
     readonly parts: TPart[];
     /**
      * Override individual part renderers. Omitted keys fall back to the headless defaults.
      * Pass `{ text: ({ part, settled }) => <Markdown streaming={!settled} contentTrust="untrusted" density="chat">{part.text}</Markdown> }`
      * to enable rich markdown rendering.
      */
-    readonly components?: Partial<AgentPartRenderers<TPart>>;
+    readonly components?: Partial<AgentPartRenderers<TPart>> | undefined;
     /**
      * `false` while the message these parts belong to is still streaming — forwarded to every
      * renderer so a text renderer can drop out of streaming mode (and a fenced mermaid/diagram can
      * upgrade) once the turn finishes. Defaults to `true`: a caller that knows nothing about a run
      * is rendering a finished list, and un-settled must be opted into by the thing that does know.
      */
-    readonly settled?: boolean;
+    readonly settled?: boolean | undefined;
 };
 /**
  * Renders a list of AgentPart values via an exhaustive switch over part.type.

package/dist/agent/part-list.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"part-list.d.ts","sourceRoot":"","sources":["../../src/agent/part-list.tsx"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAIhC,OAAO,KAAK,EACV,SAAS,EAMV,MAAM,SAAS,CAAA;AAIhB;;;;;;;GAOG;AACH,KAAK,cAAc,CAAC,KAAK,IAAI;IAC3B,IAAI,EAAE,KAAK,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,gBAAgB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CAClE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,KACpD,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAEvB,MAAM,MAAM,qBAAqB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CACvE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC,CAAC,KACzD,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAEvB,MAAM,MAAM,oBAAoB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CACtE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,KACpD,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAEvB,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CACpE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAC,KACtD,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAEvB,MAAM,MAAM,iBAAiB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CACnE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,KACrD,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAEvB;;;;;;;;;GASG;AACH,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI;IACpE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAA;IACtC,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAA;IAChD,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC,KAAK,CAAC,CAAA;IAC1C,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAA;IAC1C,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAA;CACzC,CAAA;AAqJD,MAAM,MAAM,aAAa,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI;IAC/D,iDAAiD;IACjD,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,CAAA;IACvB;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAA;IACxD;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAC3B,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,EAAE,EAC5D,KAAK,EACL,UAAU,EACV,OAAc,GACf,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,OAAO,CAqFpC"}
+{"version":3,"file":"part-list.d.ts","sourceRoot":"","sources":["../../src/agent/part-list.tsx"],"names":[],"mappings":"AA4BA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAIhC,OAAO,KAAK,EACV,SAAS,EAMV,MAAM,SAAS,CAAA;AAIhB;;;;;;;GAOG;AACH,KAAK,cAAc,CAAC,KAAK,IAAI;IAC3B,IAAI,EAAE,KAAK,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,gBAAgB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CAClE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,KACpD,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAEvB,MAAM,MAAM,qBAAqB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CACvE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC,CAAC,KACzD,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAEvB,MAAM,MAAM,oBAAoB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CACtE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,KACpD,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAEvB,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CACpE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,CAAC,CAAC,KACtD,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAEvB,MAAM,MAAM,iBAAiB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI,CACnE,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC,KACrD,GAAG,CAAC,OAAO,GAAG,IAAI,CAAA;AAEvB;;;;;;;;;GASG;AACH,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI;IACpE,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC,KAAK,CAAC,CAAA;IACtC,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC,KAAK,CAAC,CAAA;IAChD,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC,KAAK,CAAC,CAAA;IAC1C,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC,KAAK,CAAC,CAAA;IAC1C,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC,KAAK,CAAC,CAAA;CACzC,CAAA;AAqJD,MAAM,MAAM,aAAa,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,IAAI;IAC/D,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,CAAA;IACvB;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,KAAK,CAAC,CAAC,GAAG,SAAS,CAAA;IACpE;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACvC,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,SAAS,SAAS,GAAG,SAAS,EAAE,EAC5D,KAAK,EACL,UAAU,EACV,OAAc,GACf,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,OAAO,CAqFpC"}

package/dist/agent/parts.d.ts

@@ -8,10 +8,6 @@
  * but do NOT let the runtime throw, or one malformed chunk kills the whole transcript. See
  * `mergeToolPart`'s default branch for that shape.
  *
- * Eden #231 doctrine: the server-side Elysia route MUST declare `: AsyncGenerator<AgentPart>`
- * explicitly and carry NO t.Object/t.Union response schema. Validate at yield-time. See
- * agent/rules/basalt-agent.md for the full doctrine.
- *
  * Part identity: every variant carries a stable `id` (see `PartBase`). Transports are permitted to
  * yield a DRAFT — `id` omitted — via `AgentPartDraft`; the consuming hooks (or `withPartIds`)
  * normalize a draft into a fully-identified part before it is ever accumulated. `parseAgentPart`
@@ -43,38 +39,41 @@ type PartBase = {
 export type StartPart = PartBase & {
     readonly type: 'start';
     readonly runId: string;
-    readonly resumeToken?: string;
+    readonly resumeToken?: string | undefined;
 };
 /**
- * A streamed text fragment from the assistant. `offset` is the character position of this delta
- * inside its part (undefined = append at the tail) — the mechanism `mergePart` uses to splice a
- * replayed delta in place rather than duplicating it.
+ * A streamed text fragment from the assistant. `text` is a DELTA, not the cumulative text: parts
+ * sharing an `id` are merged into one, in order. `offset` is the character position in that
+ * accumulated text where this delta starts (undefined = append at the tail, which is what a plain
+ * transport emits; `aiSdkTransport` sets it to the length already seen). The merge writes `text`
+ * over `[offset, offset + text.length)`, so replaying a whole run from `offset: 0` rebuilds the same
+ * text instead of duplicating it. An out-of-range offset is clamped, never thrown on.
  */
 export type TextPart = PartBase & {
     readonly type: 'text';
     readonly text: string;
-    readonly offset?: number;
+    readonly offset?: number | undefined;
 };
 /** An internal reasoning/thinking fragment (may be hidden in the UI). Same `offset` mechanism as TextPart. */
 export type ReasoningPart = PartBase & {
     readonly type: 'reasoning';
     readonly text: string;
-    readonly offset?: number;
+    readonly offset?: number | undefined;
 };
 /** The nested approval envelope — mirrors the SDK's shape verbatim, never flattened. */
 type ToolApproval = {
     readonly id: string;
-    readonly approved?: boolean;
-    readonly reason?: string;
-    readonly isAutomatic?: boolean;
-    readonly signature?: string;
+    readonly approved?: boolean | undefined;
+    readonly reason?: string | undefined;
+    readonly isAutomatic?: boolean | undefined;
+    readonly signature?: string | undefined;
 };
 type ToolCallBase = PartBase & {
     readonly type: 'tool';
     readonly toolName: string;
     /** Wall-clock time from first sighting of this toolCallId to its terminal state. */
-    readonly durationMs?: number;
-    readonly providerExecuted?: boolean;
+    readonly durationMs?: number | undefined;
+    readonly providerExecuted?: boolean | undefined;
 };
 /**
  * The three IN-FLIGHT states (`input-streaming`, `input-available`, `approval-requested`) carry an
@@ -109,7 +108,7 @@ type Identified = ToolCallBase & {
  * normalizes one to absent at the wire boundary, so it never reaches the type or a consumer.
  */
 type MaybeIdentified = ToolCallBase & {
-    readonly toolCallId?: string;
+    readonly toolCallId?: string | undefined;
 };
 export type ToolCallPart = (Identified & {
     readonly state: 'input-streaming';
@@ -134,10 +133,10 @@ export type ToolCallPart = (Identified & {
     readonly state: 'output-available';
     readonly input: unknown;
     readonly output: unknown;
-    readonly preliminary?: boolean;
-    readonly approval?: ToolApproval & {
+    readonly preliminary?: boolean | undefined;
+    readonly approval?: (ToolApproval & {
         readonly approved?: true;
-    };
+    }) | undefined;
 }) | (MaybeIdentified & {
     readonly state: 'output-error';
     readonly input?: unknown;
@@ -145,9 +144,9 @@ export type ToolCallPart = (Identified & {
     readonly errorText: string;
     /** The only place the raw, un-parsed input survives — what lets a UI render a call whose input never validated. */
     readonly rawInput?: unknown;
-    readonly approval?: ToolApproval & {
+    readonly approval?: (ToolApproval & {
         readonly approved?: true;
-    };
+    }) | undefined;
 }) | (MaybeIdentified & {
     readonly state: 'output-denied';
     readonly input: unknown;
@@ -164,7 +163,7 @@ export declare function isToolCallSettled(part: ToolCallPart): boolean;
 export type SourcePart = PartBase & {
     readonly type: 'source';
     readonly url: string;
-    readonly title?: string;
+    readonly title?: string | undefined;
 };
 /** A fatal or recoverable error emitted in-stream by the agent. */
 export type ErrorPart = PartBase & {
@@ -186,7 +185,7 @@ export type AgentPart = StartPart | TextPart | ReasoningPart | ToolCallPart | So
  * (and wrong) shape.
  */
 export type Drafted<T> = T extends unknown ? Omit<T, 'id'> & {
-    readonly id?: string;
+    readonly id?: string | undefined;
 } : never;
 export type AgentPartDraft = Drafted<AgentPart>;
 /**

package/dist/agent/parts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parts.d.ts","sourceRoot":"","sources":["../../src/agent/parts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"parts.d.ts","sourceRoot":"","sources":["../../src/agent/parts.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAIH,wGAAwG;AACxG,KAAK,QAAQ,GAAG;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAA;AAIvC;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG;IACjC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAC1C,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACrC,CAAA;AAED,8GAA8G;AAC9G,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG;IACrC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACrC,CAAA;AAoBD,wFAAwF;AACxF,KAAK,YAAY,GAAG;IAClB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACvC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACpC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC1C,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACxC,CAAA;AAED,KAAK,YAAY,GAAG,QAAQ,GAAG;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,oFAAoF;IACpF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACxC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAChD,CAAA;AAED;;;;;;;;GAQG;AACH,KAAK,UAAU,GAAG,YAAY,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAA;AAEhE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,KAAK,eAAe,GAAG,YAAY,GAAG;IAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAA;AAElF,MAAM,MAAM,YAAY,GACpB,CAAC,UAAU,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC,GAC9E,CAAC,UAAU,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,GAC7E,CAAC,UAAU,GAAG;IACZ,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAA;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,CAAA;KAAE,CAAA;CACzF,CAAC,GACF,CAAC,eAAe,GAAG;IACjB,QAAQ,CAAC,KAAK,EAAE,oBAAoB,CAAA;IACpC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG;QAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAA;CACjE,CAAC,GACF,CAAC,eAAe,GAAG;IACjB,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAA;IAClC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IAC1C,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,YAAY,GAAG;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAA;KAAE,CAAC,GAAG,SAAS,CAAA;CAC9E,CAAC,GACF,CAAC,eAAe,GAAG;IACjB,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;IACxB,oFAAoF;IACpF,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,mHAAmH;IACnH,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,YAAY,GAAG;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAA;KAAE,CAAC,GAAG,SAAS,CAAA;CAC9E,CAAC,GACF,CAAC,eAAe,GAAG;IACjB,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAA;IAC/B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,QAAQ,EAAE,YAAY,GAAG;QAAE,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAA;KAAE,CAAA;CAC/D,CAAC,CAAA;AAEN,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC,OAAO,CAAC,CAAA;AAEjD,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,gEAAiE,CAAA;AAElG,qGAAqG;AACrG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAE7D;AAED,sDAAsD;AACtD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG;IAClC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CACpC,CAAA;AAED,mEAAmE;AACnE,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAEvF;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,aAAa,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,CAAA;AAIpG;;;;;;GAMG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,GACtC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GACpD,KAAK,CAAA;AACT,MAAM,MAAM,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;AAI/C;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAgD7D;AAsJD,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,SAAS,CAE5D"}

package/dist/agent/run-committer.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The commit side of a run: when accumulated parts reach `useAgentThreadRuns`' `runs` state.
+ * Mantine-free and React-free so it is testable on its own.
+ */
+import type { PartLike } from './merge.js';
+import type { LiveRunStatus } from './thread.js';
+export type RunCommitter<TPart> = {
+    /** Queue a commit; `immediate` (or `wait <= 0`) bypasses the window and drops any pending one. */
+    readonly push: (parts: TPart[], status: LiveRunStatus, immediate?: boolean) => void;
+    /** Commit the pending snapshot now, if any. */
+    readonly flush: () => void;
+    /** Drop the pending snapshot and its timer. */
+    readonly cancel: () => void;
+};
+/**
+ * Leading + trailing throttle over `runs` commits (the semantics of `useChat`'s stable
+ * `throttle`): the first push commits at once, pushes inside the window collapse into one trailing
+ * commit of the LATEST snapshot.
+ */
+export declare function createRunCommitter<TPart>(wait: number, commit: (parts: TPart[], status: LiveRunStatus) => void): RunCommitter<TPart>;
+/** True for the parts that end `'submitted'`: model output, not the synthetic start/source/error. */
+export declare function isContentPart(part: PartLike): boolean;
+//# sourceMappingURL=run-committer.d.ts.map

package/dist/agent/run-committer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-committer.d.ts","sourceRoot":"","sources":["../../src/agent/run-committer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AACvC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAE7C,MAAM,MAAM,YAAY,CAAC,KAAK,IAAI;IAChC,kGAAkG;IAClG,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,OAAO,KAAK,IAAI,CAAA;IACnF,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAA;IAC1B,+CAA+C;IAC/C,QAAQ,CAAC,MAAM,EAAE,MAAM,IAAI,CAAA;CAC5B,CAAA;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EACtC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,aAAa,KAAK,IAAI,GACtD,YAAY,CAAC,KAAK,CAAC,CAkCrB;AAED,qGAAqG;AACrG,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAErD"}

package/dist/agent/run-committer.js

@@ -0,0 +1,41 @@
+function createRunCommitter(wait, commit) {
+  let timer;
+  let lastCommitAt = Number.NEGATIVE_INFINITY;
+  let pending;
+  const clear = () => {
+    if (timer === void 0) return;
+    clearTimeout(timer);
+    timer = void 0;
+  };
+  const flush = () => {
+    clear();
+    if (pending === void 0) return;
+    const { parts, status } = pending;
+    pending = void 0;
+    lastCommitAt = Date.now();
+    commit(parts, status);
+  };
+  return {
+    push(parts, status, immediate = false) {
+      pending = { parts, status };
+      const windowOpen = timer === void 0 && Date.now() - lastCommitAt >= wait;
+      if (wait <= 0 || immediate || windowOpen) {
+        flush();
+        return;
+      }
+      timer ??= setTimeout(flush, Math.max(0, wait - (Date.now() - lastCommitAt)));
+    },
+    flush,
+    cancel() {
+      clear();
+      pending = void 0;
+    }
+  };
+}
+function isContentPart(part) {
+  return part.type === "text" || part.type === "reasoning" || part.type === "tool";
+}
+export {
+  createRunCommitter,
+  isContentPart
+};

package/dist/agent/run-records.d.ts

@@ -0,0 +1,77 @@
+/**
+ * The per-thread run lifecycle of `useAgentThreadRuns`, in ONE record per thread id.
+ *
+ * The hook used to keep a run's controller, live parts, "final message landed" flag and how it
+ * ended in four parallel maps, written at different places, and `runs` (React state, which only
+ * mirrors the last flushed render) was consulted for the rest. Every drift between those was a
+ * bug: `stop()` deciding from a stale `runs`, a second `stop()` appending twice. Here a run is
+ * begun, ended and swept through three functions, so the pieces change together.
+ *
+ * A record is LIVE while `ended === undefined`; `ended` is written synchronously where a run stops
+ * being driven, long before the `setRuns` it queues renders. That window is what the record
+ * covers: it outlives the run only until a render shows the outcome (`sweepFlushed`).
+ */
+/** The part of a rendered `runs` entry this module reads. */
+type RenderedRun<TPart> = {
+    readonly status: string;
+    readonly parts: TPart[];
+};
+export type RunEnd = 'settled' | 'failed' | 'stopped';
+export type RunRecord<TPart> = {
+    readonly controller: AbortController;
+    /** The unthrottled accumulator; `runs` may lag it by one throttle window. Emptied when the run ends. */
+    parts: TPart[];
+    /** The turn's terminal assistant message is in the thread. */
+    appended: boolean;
+    /** `consumeAndFinalize`'s own `resolveOutcome` is in flight. */
+    resolving: boolean;
+    ended: RunEnd | undefined;
+    /** A newer run began on the same thread (set by `beginRun` on the record it replaces). */
+    superseded: boolean;
+};
+export type RunRecords<TPart> = Map<string, RunRecord<TPart>>;
+/** Registers a live run for `threadId`, replacing whatever record the previous run left. */
+export declare function beginRun<TPart>(records: RunRecords<TPart>, threadId: string, controller: AbortController): RunRecord<TPart>;
+/** Marks a run as no longer driven and drops the content it held. */
+export declare function endRun<TPart>(record: RunRecord<TPart>, reason: RunEnd): void;
+/** True while `controller`'s run is still the thread's live one. */
+export declare function isLive<TPart>(records: RunRecords<TPart>, threadId: string, controller: AbortController): boolean;
+/** What `stop(threadId)` must do. */
+export type StopPlan<TPart> = {
+    readonly kind: 'noop';
+}
+/** A failed run: only its error entry goes. */
+ | {
+    readonly kind: 'dismiss';
+}
+/** A live run: abort it, persist its parts, settle the thread. */
+ | {
+    readonly kind: 'stop';
+    readonly record: RunRecord<TPart>;
+    readonly parts: TPart[];
+};
+/**
+ * True while `threadId` has a live (not yet ended) run.
+ */
+export declare function hasLiveRun<TPart>(records: RunRecords<TPart>, threadId: string): boolean;
+/**
+ * Decides `stop()` from the record, falling back to the rendered `entry` only when no record
+ * exists (an unmount re-run — StrictMode, `<Activity>` — clears records while `runs` state
+ * survives). A live `entry` with no record is a phantom nothing drives; it is settled once: the
+ * ended tombstone record this WRITES (the side effect in the name) makes a second `stop()` in the
+ * same tick a no-op.
+ */
+export declare function planStopWithTombstone<TPart>(records: RunRecords<TPart>, threadId: string, entry: RenderedRun<TPart> | undefined): StopPlan<TPart>;
+/** Thread ids whose failed entry `stopAll()` must dismiss: the records AND what `runs` shows. */
+export declare function failedThreadIds<TPart>(records: RunRecords<TPart>, runs: ReadonlyMap<string, RenderedRun<TPart>>): string[];
+/**
+ * A failed entry was dismissed: its record has nothing left to cover. (`sweepFlushed` cannot tell
+ * "dismissed" from "not rendered yet", so the dismissal itself drops it.)
+ */
+export declare function dismissRun<TPart>(records: RunRecords<TPart>, threadId: string): void;
+/** True unless a newer run has taken the thread over since `record` began. */
+export declare function isLatestRun<TPart>(record: RunRecord<TPart>): boolean;
+/** Drops the terminal records a render has already caught up with, so ids are not kept forever. */
+export declare function sweepFlushed<TPart>(records: RunRecords<TPart>, runs: ReadonlyMap<string, RenderedRun<TPart>>): void;
+export {};
+//# sourceMappingURL=run-records.d.ts.map

package/dist/agent/run-records.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-records.d.ts","sourceRoot":"","sources":["../../src/agent/run-records.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,6DAA6D;AAC7D,KAAK,WAAW,CAAC,KAAK,IAAI;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,CAAA;CAAE,CAAA;AAE9E,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAA;AAErD,MAAM,MAAM,SAAS,CAAC,KAAK,IAAI;IAC7B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAA;IACpC,wGAAwG;IACxG,KAAK,EAAE,KAAK,EAAE,CAAA;IACd,8DAA8D;IAC9D,QAAQ,EAAE,OAAO,CAAA;IACjB,gEAAgE;IAChE,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;IACzB,0FAA0F;IAC1F,UAAU,EAAE,OAAO,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,UAAU,CAAC,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAA;AAE7D,4FAA4F;AAC5F,wBAAgB,QAAQ,CAAC,KAAK,EAC5B,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,EAC1B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,eAAe,GAC1B,SAAS,CAAC,KAAK,CAAC,CAalB;AAED,qEAAqE;AACrE,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAG5E;AAED,oEAAoE;AACpE,wBAAgB,MAAM,CAAC,KAAK,EAC1B,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,EAC1B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,eAAe,GAC1B,OAAO,CAGT;AAED,qCAAqC;AACrC,MAAM,MAAM,QAAQ,CAAC,KAAK,IACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAC3B,+CAA+C;GAC7C;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;CAAE;AAC9B,kEAAkE;GAChE;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,CAAA;CAAE,CAAA;AAEzF;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGvF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EACzC,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,EAC1B,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,GAAG,SAAS,GACpC,QAAQ,CAAC,KAAK,CAAC,CAWjB;AAED,iGAAiG;AACjG,wBAAgB,eAAe,CAAC,KAAK,EACnC,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,EAC1B,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,GAC5C,MAAM,EAAE,CAKV;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAEpF;AAED,8EAA8E;AAC9E,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,GAAG,OAAO,CAEpE;AAED,mGAAmG;AACnG,wBAAgB,YAAY,CAAC,KAAK,EAChC,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,EAC1B,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,GAC5C,IAAI,CAQN"}

package/dist/agent/run-records.js

@@ -0,0 +1,69 @@
+function beginRun(records, threadId, controller) {
+  const record = {
+    controller,
+    parts: [],
+    appended: false,
+    resolving: false,
+    ended: void 0,
+    superseded: false
+  };
+  const previous = records.get(threadId);
+  if (previous !== void 0) previous.superseded = true;
+  records.set(threadId, record);
+  return record;
+}
+function endRun(record, reason) {
+  record.ended = reason;
+  record.parts = [];
+}
+function isLive(records, threadId, controller) {
+  const record = records.get(threadId);
+  return record?.controller === controller && record.ended === void 0;
+}
+function hasLiveRun(records, threadId) {
+  const record = records.get(threadId);
+  return record !== void 0 && record.ended === void 0;
+}
+function planStopWithTombstone(records, threadId, entry) {
+  const record = records.get(threadId);
+  if (record !== void 0) {
+    if (record.ended === void 0) return { kind: "stop", record, parts: record.parts };
+    return record.ended === "failed" ? { kind: "dismiss" } : { kind: "noop" };
+  }
+  if (entry === void 0) return { kind: "noop" };
+  if (entry.status === "error") return { kind: "dismiss" };
+  const tombstone = beginRun(records, threadId, new AbortController());
+  endRun(tombstone, "stopped");
+  return { kind: "stop", record: tombstone, parts: entry.parts };
+}
+function failedThreadIds(records, runs) {
+  const ids = /* @__PURE__ */ new Set();
+  for (const [threadId, record] of records) if (record.ended === "failed") ids.add(threadId);
+  for (const [threadId, entry] of runs) if (entry.status === "error") ids.add(threadId);
+  return [...ids];
+}
+function dismissRun(records, threadId) {
+  if (records.get(threadId)?.ended === "failed") records.delete(threadId);
+}
+function isLatestRun(record) {
+  return !record.superseded;
+}
+function sweepFlushed(records, runs) {
+  for (const [threadId, record] of records) {
+    if (record.ended === void 0 || record.resolving) continue;
+    const shown = runs.get(threadId);
+    const flushed = record.ended === "failed" ? shown?.status === "error" : shown === void 0;
+    if (flushed) records.delete(threadId);
+  }
+}
+export {
+  beginRun,
+  dismissRun,
+  endRun,
+  failedThreadIds,
+  hasLiveRun,
+  isLatestRun,
+  isLive,
+  planStopWithTombstone,
+  sweepFlushed
+};

package/dist/agent/thread.d.ts

@@ -1,3 +1,4 @@
+/** AgentThread / ThreadsStore — the thread contract a consumer-owned store implements. */
 import type { ChatMessage } from './history.js';
 import type { AgentOutcome } from './outcome.js';
 import type { AgentPart } from './parts.js';
@@ -8,9 +9,9 @@ import type { AgentPart } from './parts.js';
  * `'pending'`/`'streaming'` when `useAgentThreadRuns` mounts with no live run for it (e.g. after a
  * reload mid-stream) — see `useAgentThreadRuns`'s mount-reconciliation effect.
  *
- * This is one of THREE overlapping status-shaped unions in the agent layer: `StreamStatus`
- * (single-turn stream lifecycle, `./use-agent-stream`), this `ThreadStatus` (persisted thread
- * lifecycle), and `AgentOutcome['status']` (`./outcome` — the terminal `'done' | 'attention' |
+ * This is one of THREE overlapping status-shaped unions in the agent layer: the internal
+ * `StreamStatus` (single-turn stream lifecycle, below), this `ThreadStatus`
+ * (persisted thread lifecycle), and `AgentOutcome['status']` (`./outcome` — the terminal `'done' | 'attention' |
  * 'error'` subset of this union, once a turn has settled). Vocabulary note: `StreamStatus`'s
  * `'idle'` (no turn in flight) corresponds to this union's `'pending'` (thread created, no turn
  * started yet) — the literal rename is intentionally deferred, see `AgentOutcome['status']`'s doc.
@@ -44,7 +45,7 @@ export type AgentThread<TPart = AgentPart> = {
      * useAgentThreadRuns to attempt resumption after a disconnected reload. Cleared once the run
      * finalizes.
      */
-    readonly resumeToken?: string;
+    readonly resumeToken?: string | undefined;
     /**
      * Freeform consumer metadata (e.g. `{ source: 'sidebar' }`, `{ model: 'gpt-5' }`) — set once at
      * `create()` time and otherwise opaque to this store. Intentionally untyped: the framework has
@@ -59,24 +60,7 @@ export type AgentThread<TPart = AgentPart> = {
      * Revisit trigger: promote this to a `TMeta` generic only once a real consumer needs typed,
      * validated meta (not just a documented convention) — don't add the generic speculatively.
      */
-    readonly meta?: Record<string, unknown>;
-};
-export type ThreadsStoreOptions = {
-    /** localStorage key (namespaced as `basalt:<key>`). Stable — changes key lose history. */
-    readonly key: string;
-    /** Envelope version. Increment when the AgentThread shape changes to clear old data. */
-    readonly version: number;
-    /**
-     * Maximum number of threads to retain. Oldest threads (end of the newest-first array) are
-     * dropped when exceeded.
-     * @default 50
-     */
-    readonly maxThreads?: number;
-    /**
-     * Maximum number of messages to retain per thread. Oldest messages are dropped when exceeded.
-     * @default 100
-     */
-    readonly maxMessagesPerThread?: number;
+    readonly meta?: Record<string, unknown> | undefined;
 };
 export type ThreadsStore<TPart = AgentPart> = {
     /** All retained threads, newest first. */
@@ -87,7 +71,7 @@ export type ThreadsStore<TPart = AgentPart> = {
     readonly select: (id: string | null) => void;
     /** Create a new thread, prepend it, and return its id. Does not change activeId. */
     readonly create: (opts?: {
-        readonly meta?: Record<string, unknown>;
+        readonly meta?: Record<string, unknown> | undefined;
     }) => string;
     /** Append a message to a thread. Trims to maxMessagesPerThread (ring-buffer: drops oldest). */
     readonly appendMessage: (id: string, message: ChatMessage<TPart>) => void;
@@ -104,39 +88,31 @@ export type ThreadsStore<TPart = AgentPart> = {
     /** Remove all threads and clear the active selection. */
     readonly clear: () => void;
     /**
-     * Whether `threads` reflects the backing store yet. Always `true` for the localStorage store
-     * (createPersistedState resolves synchronously); meaningful only for an async, server-backed
-     * store built with `createAdapterThreadsStore` (./adapter), where it stays `false` until the
-     * first `listThreads` SUCCEEDS. Pair it with `error` — `!hydrated && error !== undefined` is a
+     * Whether `threads` reflects the backing store yet. Always `true` for a synchronous store;
+     * meaningful only for an async, server-backed store, where it stays `false` until the first
+     * `listThreads` SUCCEEDS. Pair it with `error` — `!hydrated && error !== undefined` is a
      * failed load, `!hydrated && error === undefined` is still loading.
      *
-     * Gating an empty state on this is the CALLER's job when hand-assembling `ThreadFeed` /
-     * `ThreadDetailPanel`; the shipped `ThreadWorkspace` already does it internally, so an
-     * async store never flashes "no threads yet" through it before it actually knows.
+     * Gating an empty state on this is the CALLER's job when rendering `ThreadFeed`, so an async
+     * store never flashes "no threads yet" before it actually knows.
      */
     readonly hydrated: boolean;
     /**
-     * The most recent persistence failure, or `undefined`. Always `undefined` for the localStorage
-     * store, which has no failure the caller can act on. An async store surfaces the rejected
+     * The most recent persistence failure, or `undefined`. Always `undefined` for a synchronous
+     * local store, which has no failure the caller can act on. An async store surfaces the rejected
      * load/write here after rolling its optimistic edit back.
      */
     readonly error: unknown;
 };
 /**
- * Creates a stable persisted multi-thread hook for the given key + version.
- *
- * Call this ONCE per module (not inside a component). The returned hook can be called in any
- * component that needs access to the same thread registry. All instances sharing the same key
- * stay in sync across tabs via the 'storage' event.
- *
- * @example
- * // src/chat/threads.ts — ONE stable creation per key:
- * export const useThreads = createThreadsStore({ key: 'main-threads', version: 1 })
- *
- * // In a component:
- * const { threads, activeId, select, create, appendMessage } = useThreads()
- * const id = create({ meta: { source: 'sidebar' } })
- * appendMessage(id, { id: crypto.randomUUID(), role: 'user', parts: [...], createdAt: Date.now() })
+ * The live status of one in-flight stream, as the chat rows render it. Not exported from the `./agent`
+ * barrel (the chat UI imports it from this module); consumers derive it from `ThreadFeedRow`'s `liveStatus` prop. `'submitted'` is a turn
+ * sent but not yet producing content: the chat rows treat it as live (Stop shows, the composer is
+ * gated) exactly like `'streaming'`.
  */
-export declare function createThreadsStore<TPart = AgentPart>(opts: ThreadsStoreOptions): () => ThreadsStore<TPart>;
+export type StreamStatus = 'idle' | 'submitted' | 'streaming' | 'done' | 'error';
+/** The two states a turn is in flight in. */
+export type LiveRunStatus = Extract<StreamStatus, 'submitted' | 'streaming'>;
+/** True while a turn is in flight (`'submitted'` or `'streaming'`); `'error'` and the rest are not. */
+export declare function isLiveStatus(status: StreamStatus | undefined): status is LiveRunStatus;
 //# sourceMappingURL=thread.d.ts.map

package/dist/agent/thread.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../src/agent/thread.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"thread.d.ts","sourceRoot":"","sources":["../../src/agent/thread.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAC5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAC7C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAIxC;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,GAAG,aAAa,CAAA;AAInG;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,WAAW,CAAC,KAAK,GAAG,SAAS,IAAI;IAC3C,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAA;IACvC,QAAQ,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI,CAAA;IACrC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACzC;;;;;;;;;;;;;OAaG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;CACpD,CAAA;AAID,MAAM,MAAM,YAAY,CAAC,KAAK,GAAG,SAAS,IAAI;IAC5C,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,CAAA;IACtC,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,KAAK,IAAI,CAAA;IAC5C,oFAAoF;IACpF,QAAQ,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAA;KAAE,KAAK,MAAM,CAAA;IAC3F,+FAA+F;IAC/F,QAAQ,CAAC,aAAa,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,KAAK,CAAC,KAAK,IAAI,CAAA;IACzE,yDAAyD;IACzD,QAAQ,CAAC,UAAU,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,KAAK,IAAI,CAAA;IAChE,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,CAAA;IAC9D,+EAA+E;IAC/E,QAAQ,CAAC,cAAc,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,KAAK,IAAI,CAAA;IACxE,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACvC,4EAA4E;IAC5E,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;IACrC,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,MAAM,IAAI,CAAA;IAC1B;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB,CAAA;AAED;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAA;AAEhF,6CAA6C;AAC7C,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,YAAY,EAAE,WAAW,GAAG,WAAW,CAAC,CAAA;AAE5E,uGAAuG;AACvG,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,GAAG,MAAM,IAAI,aAAa,CAEtF"}