@deepagents/context 0.10.2 → 0.12.0

package/dist/lib/agent.d.ts

@@ -1,28 +1,103 @@
-import { type StreamTextTransform, type ToolChoice, type ToolSet, generateText } from 'ai';
+import { type GenerateTextResult, Output, type StreamTextResult, type StreamTextTransform, type ToolChoice, type ToolSet, generateText } from 'ai';
 import z from 'zod';
 import { type AgentModel } from '@deepagents/agent';
 import { type ContextEngine } from '../index.ts';
-export interface CreateAgent<COut, CIn = COut, Output = never> {
+import { type Guardrail } from './guardrail.ts';
+export interface CreateAgent<CIn, COut = CIn> {
     name: string;
-    context: ContextEngine;
+    context?: ContextEngine;
     tools?: ToolSet;
-    model: AgentModel;
+    model?: AgentModel;
     toolChoice?: ToolChoice<Record<string, COut>>;
-    output?: z.Schema<Output>;
     providerOptions?: Parameters<typeof generateText>[0]['providerOptions'];
     logging?: boolean;
+    /**
+     * Guardrails to apply during streaming.
+     * Each guardrail inspects text chunks and can trigger self-correction retries.
+     */
+    guardrails?: Guardrail[];
+    /**
+     * Maximum number of retry attempts when guardrails fail (default: 3).
+     */
+    maxGuardrailRetries?: number;
 }
-declare class Agent<COut, CIn = COut, Output = never> {
+declare class Agent<CIn, COut = CIn> {
     #private;
-    constructor(options: CreateAgent<COut, CIn, Output>);
-    generate<COut, CIn = COut, Output = never>(contextVariables: CIn, config?: {
+    readonly tools: ToolSet;
+    constructor(options: CreateAgent<CIn, COut>);
+    generate<COut, CIn = COut>(contextVariables: CIn, config?: {
         abortSignal?: AbortSignal;
-    }): Promise<import("ai").GenerateTextResult<ToolSet, Output_1>>;
-    stream<COut, CIn = COut, Output = never>(contextVariables: CIn, config?: {
+    }): Promise<GenerateTextResult<ToolSet, Output.Output<string, string, any>>>;
+    /**
+     * Stream a response from the agent.
+     *
+     * When guardrails are configured, `toUIMessageStream()` is wrapped to provide
+     * self-correction behavior. Direct access to fullStream/textStream bypasses guardrails.
+     *
+     * @example
+     * ```typescript
+     * const stream = await agent.stream({});
+     *
+     * // With guardrails - use toUIMessageStream for protection
+     * await printer.readableStream(stream.toUIMessageStream());
+     *
+     * // Or use printer.stdout which uses toUIMessageStream internally
+     * await printer.stdout(stream);
+     * ```
+     */
+    stream<COut, CIn = COut>(contextVariables: CIn, config?: {
         abortSignal?: AbortSignal;
         transform?: StreamTextTransform<ToolSet> | StreamTextTransform<ToolSet>[];
-    }): Promise<import("ai").StreamTextResult<ToolSet, import("ai").DeepPartial<Output_1>>>;
+        maxRetries?: number;
+    }): Promise<StreamTextResult<ToolSet, never>>;
+    clone(overrides?: Partial<CreateAgent<CIn, COut>>): Agent<CIn, COut>;
 }
-export declare function agent<Output, CIn, COut = CIn>(options: CreateAgent<COut, CIn, Output>): Agent<COut, CIn, Output>;
+export declare function agent<CIn, COut = CIn>(options: CreateAgent<CIn, COut>): Agent<CIn, COut>;
+/**
+ * Options for creating a structured output handler.
+ */
+export interface StructuredOutputOptions<TSchema extends z.ZodType> {
+    context?: ContextEngine;
+    model?: AgentModel;
+    schema: TSchema;
+    providerOptions?: Parameters<typeof generateText>[0]['providerOptions'];
+    tools?: ToolSet;
+}
+/**
+ * Create a structured output handler that provides simplified access to structured output.
+ *
+ * @param options - Configuration options including schema
+ * @returns Object with generate() and stream() methods
+ *
+ * @example
+ * ```typescript
+ * const output = structuredOutput({
+ *   name: 'extractor',
+ *   model: groq('...'),
+ *   context,
+ *   schema: z.object({
+ *     name: z.string(),
+ *     age: z.number(),
+ *   }),
+ * });
+ *
+ * // Generate - returns only the structured output
+ * const result = await output.generate({});
+ * // result: { name: string, age: number }
+ *
+ * // Stream - returns the full stream
+ * const stream = await output.stream({});
+ * ```
+ */
+export interface StructuredOutputResult<TSchema extends z.ZodType> {
+    generate<CIn>(contextVariables?: CIn, config?: {
+        abortSignal?: AbortSignal;
+    }): Promise<z.infer<TSchema>>;
+    stream<CIn>(contextVariables?: CIn, config?: {
+        abortSignal?: AbortSignal;
+        transform?: StreamTextTransform<ToolSet> | StreamTextTransform<ToolSet>[];
+    }): Promise<StreamTextResult<ToolSet, any>>;
+}
+export declare function structuredOutput<TSchema extends z.ZodType>(options: StructuredOutputOptions<TSchema>): StructuredOutputResult<TSchema>;
 export {};
 //# sourceMappingURL=agent.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/lib/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,mBAAmB,EACxB,KAAK,UAAU,EACf,KAAK,OAAO,EAGZ,YAAY,EAIb,MAAM,IAAI,CAAC;AAEZ,OAAO,CAAC,MAAM,KAAK,CAAC;AAEpB,OAAO,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,KAAK,aAAa,EAAe,MAAM,aAAa,CAAC;AAE9D,MAAM,WAAW,WAAW,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,EAAE,MAAM,GAAG,KAAK;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,CAAC,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC;IAC9C,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1B,eAAe,CAAC,EAAE,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;IACxE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,cAAM,KAAK,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,EAAE,MAAM,GAAG,KAAK;;gBAE9B,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC;IAItC,QAAQ,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,EAAE,MAAM,GAAG,KAAK,EACpD,gBAAgB,EAAE,GAAG,EACrB,MAAM,CAAC,EAAE;QACP,WAAW,CAAC,EAAE,WAAW,CAAC;KAC3B;IAiCU,MAAM,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,EAAE,MAAM,GAAG,KAAK,EAClD,gBAAgB,EAAE,GAAG,EACrB,MAAM,CAAC,EAAE;QACP,WAAW,CAAC,EAAE,WAAW,CAAC;QAC1B,SAAS,CAAC,EAAE,mBAAmB,CAAC,OAAO,CAAC,GAAG,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;KAC3E;CAsEJ;AAED,wBAAgB,KAAK,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,GAAG,GAAG,EAC3C,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GACtC,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,CAE1B"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/lib/agent.ts"],"names":[],"mappings":"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"}

package/dist/lib/engine.d.ts

@@ -0,0 +1,325 @@
+import { type EstimateResult } from './estimate.ts';
+import type { ContextFragment } from './fragments.ts';
+import type { Models } from './models.generated.ts';
+import { type ContextRenderer } from './renderers/abstract.renderer.ts';
+import { type BranchInfo, type CheckpointInfo, ContextStore, type GraphData, type MessageData } from './store/store.ts';
+/**
+ * Result of resolving context - ready for AI SDK consumption.
+ */
+export interface ResolveResult {
+    /** Rendered non-message fragments for system prompt */
+    systemPrompt: string;
+    /** Message fragments decoded to AI SDK format */
+    messages: unknown[];
+}
+/**
+ * Options for resolve().
+ */
+export interface ResolveOptions {
+    /** Renderer to use for system prompt (defaults to XmlRenderer) */
+    renderer: ContextRenderer;
+}
+/**
+ * Options for creating a ContextEngine.
+ */
+export interface ContextEngineOptions {
+    /** Store for persisting fragments (required) */
+    store: ContextStore;
+    /** Unique identifier for this chat (required) */
+    chatId: string;
+    /** User who owns this chat (required) */
+    userId: string;
+}
+/**
+ * Metadata about a chat.
+ */
+export interface ChatMeta {
+    /** Unique chat identifier */
+    id: string;
+    /** User who owns this chat */
+    userId: string;
+    /** When the chat was created */
+    createdAt: number;
+    /** When the chat was last updated */
+    updatedAt: number;
+    /** Optional user-provided title */
+    title?: string;
+    /** Optional custom metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Options for context inspection.
+ */
+export interface InspectOptions {
+    /** Model ID for cost estimation (required) */
+    modelId: Models;
+    /** Renderer for estimation (required) */
+    renderer: ContextRenderer;
+}
+/**
+ * Result of inspecting context state.
+ * JSON-serializable snapshot for debugging.
+ */
+export interface InspectResult {
+    /** Token usage and cost estimation */
+    estimate: EstimateResult;
+    /** Rendered output using the provided renderer */
+    rendered: string;
+    /** Fragment structure breakdown */
+    fragments: {
+        /** Non-message fragments (role, hints, etc.) */
+        context: ContextFragment[];
+        /** Pending messages not yet saved to store */
+        pending: ContextFragment[];
+        /** Persisted messages from the store */
+        persisted: MessageData[];
+    };
+    /** Conversation graph with branches and checkpoints */
+    graph: GraphData;
+    /** Inspection metadata */
+    meta: {
+        chatId: string;
+        branch: string;
+        timestamp: number;
+    };
+}
+/**
+ * Context engine for managing AI conversation context with graph-based storage.
+ *
+ * The engine uses a DAG (Directed Acyclic Graph) model for messages:
+ * - Messages are immutable nodes with parentId forming the graph
+ * - Branches are pointers to head (tip) messages
+ * - Checkpoints are pointers to specific messages
+ * - History is preserved through branching (rewind creates new branch)
+ */
+export declare class ContextEngine {
+    #private;
+    constructor(options: ContextEngineOptions);
+    /**
+     * Get the current chat ID.
+     */
+    get chatId(): string;
+    /**
+     * Get the current branch name.
+     */
+    get branch(): string;
+    /**
+     * Get metadata for the current chat.
+     * Returns null if the chat hasn't been initialized yet.
+     */
+    get chat(): ChatMeta | null;
+    /**
+     * Add fragments to the context.
+     *
+     * - Message fragments (user/assistant) are queued for persistence
+     * - Non-message fragments (role/hint) are kept in memory for system prompt
+     */
+    set(...fragments: ContextFragment[]): this;
+    unset(fragmentId: string): void;
+    /**
+     * Render all fragments using the provided renderer.
+     * @internal Use resolve() instead for public API.
+     */
+    render(renderer: ContextRenderer): string;
+    /**
+     * Resolve context into AI SDK-ready format.
+     *
+     * - Initializes chat and branch if needed
+     * - Loads message history from the graph (walking parent chain)
+     * - Separates context fragments for system prompt
+     * - Combines with pending messages
+     *
+     * @example
+     * ```ts
+     * const context = new ContextEngine({ store, chatId: 'chat-1', userId: 'user-1' })
+     *   .set(role('You are helpful'), user('Hello'));
+     *
+     * const { systemPrompt, messages } = await context.resolve();
+     * await generateText({ system: systemPrompt, messages });
+     * ```
+     */
+    resolve(options: ResolveOptions): Promise<ResolveResult>;
+    /**
+     * Save pending messages to the graph.
+     *
+     * Each message is added as a node with parentId pointing to the previous message.
+     * The branch head is updated to point to the last message.
+     *
+     * @example
+     * ```ts
+     * context.set(user('Hello'));
+     * // AI responds...
+     * context.set(assistant('Hi there!'));
+     * await context.save(); // Persist to graph
+     * ```
+     */
+    save(): Promise<void>;
+    /**
+     * Estimate token count and cost for the full context.
+     *
+     * Includes:
+     * - System prompt fragments (role, hints, etc.)
+     * - Persisted chat messages (from store)
+     * - Pending messages (not yet saved)
+     *
+     * @param modelId - Model ID (e.g., "openai:gpt-4o", "anthropic:claude-3-5-sonnet")
+     * @param options - Optional settings
+     * @returns Estimate result with token counts, costs, and per-fragment breakdown
+     */
+    estimate(modelId: Models, options?: {
+        renderer?: ContextRenderer;
+    }): Promise<EstimateResult>;
+    /**
+     * Rewind to a specific message by ID.
+     *
+     * Creates a new branch from that message, preserving the original branch.
+     * The new branch becomes active.
+     *
+     * @param messageId - The message ID to rewind to
+     * @returns The new branch info
+     *
+     * @example
+     * ```ts
+     * context.set(user('What is 2 + 2?', { id: 'q1' }));
+     * context.set(assistant('The answer is 5.', { id: 'wrong' })); // Oops!
+     * await context.save();
+     *
+     * // Rewind to the question, creates new branch
+     * const newBranch = await context.rewind('q1');
+     *
+     * // Now add correct answer on new branch
+     * context.set(assistant('The answer is 4.'));
+     * await context.save();
+     * ```
+     */
+    rewind(messageId: string): Promise<BranchInfo>;
+    /**
+     * Create a checkpoint at the current position.
+     *
+     * A checkpoint is a named pointer to the current branch head.
+     * Use restore() to return to this point later.
+     *
+     * @param name - Name for the checkpoint
+     * @returns The checkpoint info
+     *
+     * @example
+     * ```ts
+     * context.set(user('I want to learn a new skill.'));
+     * context.set(assistant('Would you like coding or cooking?'));
+     * await context.save();
+     *
+     * // Save checkpoint before user's choice
+     * const cp = await context.checkpoint('before-choice');
+     * ```
+     */
+    checkpoint(name: string): Promise<CheckpointInfo>;
+    /**
+     * Restore to a checkpoint by creating a new branch from that point.
+     *
+     * @param name - Name of the checkpoint to restore
+     * @returns The new branch info
+     *
+     * @example
+     * ```ts
+     * // User chose cooking, but wants to try coding path
+     * await context.restore('before-choice');
+     *
+     * context.set(user('I want to learn coding.'));
+     * context.set(assistant('Python is a great starting language!'));
+     * await context.save();
+     * ```
+     */
+    restore(name: string): Promise<BranchInfo>;
+    /**
+     * Switch to a different branch by name.
+     *
+     * @param name - Branch name to switch to
+     *
+     * @example
+     * ```ts
+     * // List branches (via store)
+     * const branches = await store.listBranches(context.chatId);
+     * console.log(branches); // [{name: 'main', ...}, {name: 'main-v2', ...}]
+     *
+     * // Switch to original branch
+     * await context.switchBranch('main');
+     * ```
+     */
+    switchBranch(name: string): Promise<void>;
+    /**
+     * Create a parallel branch from the current position ("by the way").
+     *
+     * Use this when you want to fork the conversation without leaving
+     * the current branch. Common use case: user wants to ask another
+     * question while waiting for the model to respond.
+     *
+     * Unlike rewind(), this method:
+     * - Uses the current HEAD (no messageId needed)
+     * - Does NOT switch to the new branch
+     * - Keeps pending messages intact
+     *
+     * @returns The new branch info (does not switch to it)
+     * @throws Error if no messages exist in the conversation
+     *
+     * @example
+     * ```ts
+     * // User asked a question, model is generating...
+     * context.set(user('What is the weather?'));
+     * await context.save();
+     *
+     * // User wants to ask something else without waiting
+     * const newBranch = await context.btw();
+     * // newBranch = { name: 'main-v2', ... }
+     *
+     * // Later, switch to the new branch and add the question
+     * await context.switchBranch(newBranch.name);
+     * context.set(user('Also, what time is it?'));
+     * await context.save();
+     * ```
+     */
+    btw(): Promise<BranchInfo>;
+    /**
+     * Update metadata for the current chat.
+     *
+     * @param updates - Partial metadata to merge (title, metadata)
+     *
+     * @example
+     * ```ts
+     * await context.updateChat({
+     *   title: 'Coding Help Session',
+     *   metadata: { tags: ['python', 'debugging'] }
+     * });
+     * ```
+     */
+    updateChat(updates: Partial<Pick<ChatMeta, 'title' | 'metadata'>>): Promise<void>;
+    /**
+     * Consolidate context fragments (no-op for now).
+     *
+     * This is a placeholder for future functionality that merges context fragments
+     * using specific rules. Currently, it does nothing.
+     *
+     * @experimental
+     */
+    consolidate(): void;
+    /**
+     * Inspect the full context state for debugging.
+     * Returns a JSON-serializable object with context information.
+     *
+     * @param options - Inspection options (modelId and renderer required)
+     * @returns Complete inspection data including estimates, rendered output, fragments, and graph
+     *
+     * @example
+     * ```ts
+     * const inspection = await context.inspect({
+     *   modelId: 'openai:gpt-4o',
+     *   renderer: new XmlRenderer(),
+     * });
+     * console.log(JSON.stringify(inspection, null, 2));
+     *
+     * // Or write to file for analysis
+     * await fs.writeFile('context-debug.json', JSON.stringify(inspection, null, 2));
+     * ```
+     */
+    inspect(options: InspectOptions): Promise<InspectResult>;
+}
+//# sourceMappingURL=engine.d.ts.map

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

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

package/dist/lib/estimate.d.ts

@@ -1,4 +1,4 @@
-import type { ContextFragment } from './context.ts';
+import type { ContextFragment } from './fragments.ts';
 import type { Models } from './models.generated.ts';
 import type { ContextRenderer } from './renderers/abstract.renderer.ts';
 /**

package/dist/lib/estimate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"estimate.d.ts","sourceRoot":"","sources":["../../src/lib/estimate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,SAAS,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC/B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAO9B,CAAC;AAoBF;;;GAGG;AACH,qBAAa,cAAc;;IAMzB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B3B;;;OAGG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI3C;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI7B;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;IAIhB;;;;OAIG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAI7D;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAI/C;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAWxC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc;CAyBzD;AAKD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,eAAe,EACzB,GAAG,SAAS,EAAE,eAAe,EAAE,GAC9B,OAAO,CAAC,cAAc,CAAC,CA0CzB"}
+{"version":3,"file":"estimate.d.ts","sourceRoot":"","sources":["../../src/lib/estimate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE;QACL,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE;QACN,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,SAAS,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC/B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAO9B,CAAC;AAoBF;;;GAGG;AACH,qBAAa,cAAc;;IAMzB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B3B;;;OAGG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI3C;;OAEG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI7B;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;IAIhB;;;;OAIG;IACH,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAI7D;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAI/C;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAWxC;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc;CAyBzD;AAKD;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAKlD;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,eAAe,EACzB,GAAG,SAAS,EAAE,eAAe,EAAE,GAC9B,OAAO,CAAC,cAAc,CAAC,CA0CzB"}