@bluefly/openstandardagents 0.3.1 → 0.3.3

package/dist/types/prompts.d.ts

@@ -0,0 +1,219 @@
+/**
+ * OSSA Prompts Types
+ * Type definitions for spec.prompts - agent prompt configuration
+ *
+ * @module @openstandardagents/prompts
+ * @version 0.3.2
+ *
+ * Defines system prompts, greetings, and example interactions
+ * for consistent agent behavior and user experience.
+ */
+/**
+ * Message role in conversation
+ */
+export type MessageRole = 'system' | 'user' | 'assistant';
+/**
+ * Content type for messages
+ */
+export type ContentType = 'text' | 'markdown' | 'code' | 'json';
+/**
+ * Single message in a conversation
+ */
+export interface Message {
+    /** Role of the message sender */
+    role: MessageRole;
+    /** Message content */
+    content: string;
+    /** Content type (for formatting) */
+    content_type?: ContentType;
+    /** Optional name for the sender */
+    name?: string;
+}
+/**
+ * Example interaction for few-shot learning
+ */
+export interface PromptExample {
+    /** Example identifier */
+    id?: string;
+    /** Short title/description */
+    title?: string;
+    /** User input in the example */
+    user: string;
+    /** Expected assistant response */
+    assistant: string;
+    /** Optional tags for categorization */
+    tags?: string[];
+    /** Context/setup for the example */
+    context?: string;
+    /** Whether this example should be used in prompts */
+    enabled?: boolean;
+    /** Priority (higher = more likely to be included) */
+    priority?: number;
+}
+/**
+ * Collection of examples by category
+ */
+export interface ExampleCollection {
+    /** Category name */
+    category: string;
+    /** Description of this category */
+    description?: string;
+    /** Examples in this category */
+    examples: PromptExample[];
+    /** Maximum examples to include from this category */
+    max_include?: number;
+}
+/**
+ * Template variable definition
+ */
+export interface TemplateVariable {
+    /** Variable name (used in template as {{name}}) */
+    name: string;
+    /** Variable description */
+    description?: string;
+    /** Default value */
+    default?: string;
+    /** Whether the variable is required */
+    required?: boolean;
+    /** Variable type for validation */
+    type?: 'string' | 'number' | 'boolean' | 'array' | 'object';
+}
+/**
+ * Prompt template configuration
+ */
+export interface PromptTemplate {
+    /** Template content (supports {{variable}} substitution) */
+    content: string;
+    /** Template variables */
+    variables?: TemplateVariable[];
+    /** Template format (text or markdown) */
+    format?: 'text' | 'markdown';
+}
+/**
+ * Greeting configuration for different contexts
+ */
+export interface GreetingConfig {
+    /** Default greeting message */
+    default: string;
+    /** Greeting for new users */
+    first_time?: string;
+    /** Greeting for returning users */
+    returning?: string;
+    /** Context-specific greetings */
+    contextual?: Record<string, string>;
+    /** Whether to personalize with user name */
+    personalize?: boolean;
+    /** Include current time/date context */
+    include_time_context?: boolean;
+}
+/**
+ * System prompt section
+ */
+export interface SystemPromptSection {
+    /** Section identifier */
+    id: string;
+    /** Section title (optional, for documentation) */
+    title?: string;
+    /** Section content */
+    content: string;
+    /** Whether this section is required */
+    required?: boolean;
+    /** Conditions for including this section */
+    conditions?: Record<string, unknown>;
+    /** Priority for ordering (higher = earlier in prompt) */
+    priority?: number;
+}
+/**
+ * Complete system prompt configuration
+ */
+export interface SystemPromptConfig {
+    /** Main system prompt content */
+    content: string;
+    /** Optional sections to append */
+    sections?: SystemPromptSection[];
+    /** Template variables available */
+    variables?: TemplateVariable[];
+    /** Whether to include agent metadata in prompt */
+    include_metadata?: boolean;
+    /** Whether to include current date/time */
+    include_datetime?: boolean;
+    /** Whether to include tool descriptions */
+    include_tools?: boolean;
+    /** Maximum length (for truncation) */
+    max_length?: number;
+}
+/**
+ * Complete agent prompts configuration
+ * Used in spec.prompts within OSSA manifests
+ */
+export interface PromptsSpec {
+    /** System prompt configuration */
+    system: string | SystemPromptConfig;
+    /** Greeting configuration */
+    greeting?: string | GreetingConfig;
+    /** Few-shot examples */
+    examples?: PromptExample[] | ExampleCollection[];
+    /** Error message templates */
+    error_messages?: Record<string, string>;
+    /** Confirmation message templates */
+    confirmations?: Record<string, string>;
+    /** Help/usage instructions */
+    help?: string;
+    /** Farewell message */
+    farewell?: string;
+    /** Thinking/processing message */
+    thinking?: string;
+    /** Rate limit message */
+    rate_limit?: string;
+    /** Capability not available message */
+    capability_unavailable?: string;
+    /** Custom templates for specific scenarios */
+    templates?: Record<string, PromptTemplate>;
+    /** Language/locale for messages */
+    locale?: string;
+    /** Fallback locale */
+    fallback_locale?: string;
+}
+/**
+ * Check if system prompt is a config object
+ */
+export declare function isSystemPromptConfig(system: string | SystemPromptConfig): system is SystemPromptConfig;
+/**
+ * Check if greeting is a config object
+ */
+export declare function isGreetingConfig(greeting: string | GreetingConfig): greeting is GreetingConfig;
+/**
+ * Check if examples array contains ExampleCollections
+ */
+export declare function isExampleCollectionArray(examples: PromptExample[] | ExampleCollection[]): examples is ExampleCollection[];
+/**
+ * Normalize system prompt to config
+ */
+export declare function normalizeSystemPrompt(system: string | SystemPromptConfig): SystemPromptConfig;
+/**
+ * Normalize greeting to config
+ */
+export declare function normalizeGreeting(greeting: string | GreetingConfig): GreetingConfig;
+/**
+ * Flatten example collections to examples array
+ */
+export declare function flattenExamples(examples: PromptExample[] | ExampleCollection[]): PromptExample[];
+/**
+ * Render a template with variables
+ */
+export declare function renderTemplate(template: string | PromptTemplate, variables: Record<string, unknown>): string;
+/**
+ * Create a default prompts configuration
+ */
+export declare function createDefaultPrompts(agentName: string, role: string): PromptsSpec;
+/**
+ * Build complete system prompt from config
+ */
+export declare function buildSystemPrompt(config: SystemPromptConfig, context?: {
+    agentName?: string;
+    agentVersion?: string;
+    datetime?: Date;
+    tools?: string[];
+    customVariables?: Record<string, unknown>;
+}): string;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/types/prompts.d.ts.map

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

package/dist/types/prompts.js

@@ -0,0 +1,163 @@
+/**
+ * OSSA Prompts Types
+ * Type definitions for spec.prompts - agent prompt configuration
+ *
+ * @module @openstandardagents/prompts
+ * @version 0.3.2
+ *
+ * Defines system prompts, greetings, and example interactions
+ * for consistent agent behavior and user experience.
+ */
+// ============================================================================
+// Helper Functions
+// ============================================================================
+/**
+ * Check if system prompt is a config object
+ */
+export function isSystemPromptConfig(system) {
+    return typeof system === 'object' && system !== null && 'content' in system;
+}
+/**
+ * Check if greeting is a config object
+ */
+export function isGreetingConfig(greeting) {
+    return typeof greeting === 'object' && greeting !== null && 'default' in greeting;
+}
+/**
+ * Check if examples array contains ExampleCollections
+ */
+export function isExampleCollectionArray(examples) {
+    return (examples.length > 0 &&
+        typeof examples[0] === 'object' &&
+        'category' in examples[0] &&
+        'examples' in examples[0]);
+}
+/**
+ * Normalize system prompt to config
+ */
+export function normalizeSystemPrompt(system) {
+    if (isSystemPromptConfig(system)) {
+        return system;
+    }
+    return { content: system };
+}
+/**
+ * Normalize greeting to config
+ */
+export function normalizeGreeting(greeting) {
+    if (isGreetingConfig(greeting)) {
+        return greeting;
+    }
+    return { default: greeting };
+}
+/**
+ * Flatten example collections to examples array
+ */
+export function flattenExamples(examples) {
+    if (!isExampleCollectionArray(examples)) {
+        return examples;
+    }
+    const flattened = [];
+    for (const collection of examples) {
+        const toInclude = collection.max_include
+            ? collection.examples.slice(0, collection.max_include)
+            : collection.examples;
+        for (const example of toInclude) {
+            flattened.push({
+                ...example,
+                tags: [...(example.tags || []), collection.category],
+            });
+        }
+    }
+    return flattened;
+}
+/**
+ * Render a template with variables
+ */
+export function renderTemplate(template, variables) {
+    const content = typeof template === 'string' ? template : template.content;
+    return content.replace(/\{\{(\w+)\}\}/g, (match, varName) => {
+        if (varName in variables) {
+            const value = variables[varName];
+            return String(value);
+        }
+        // Check for default in template definition
+        if (typeof template === 'object' && template.variables) {
+            const varDef = template.variables.find((v) => v.name === varName);
+            if (varDef?.default !== undefined) {
+                return varDef.default;
+            }
+        }
+        return match; // Leave unreplaced if no value or default
+    });
+}
+/**
+ * Create a default prompts configuration
+ */
+export function createDefaultPrompts(agentName, role) {
+    return {
+        system: `You are ${agentName}, an AI assistant.
+
+${role}
+
+Please help users with their requests while being helpful, accurate, and safe.`,
+        greeting: `Hello! I'm ${agentName}. How can I help you today?`,
+        examples: [],
+        error_messages: {
+            general: "I apologize, but I encountered an error. Please try again.",
+            rate_limit: "I'm receiving too many requests. Please wait a moment.",
+            capability_unavailable: "I'm sorry, but I can't help with that request.",
+        },
+        farewell: "Goodbye! Feel free to return if you need any help.",
+        thinking: "Let me think about that...",
+    };
+}
+/**
+ * Build complete system prompt from config
+ */
+export function buildSystemPrompt(config, context) {
+    const parts = [];
+    // Add main content
+    let content = config.content;
+    // Add metadata if requested
+    if (config.include_metadata && context) {
+        const metadata = [
+            context.agentName && `Agent: ${context.agentName}`,
+            context.agentVersion && `Version: ${context.agentVersion}`,
+        ]
+            .filter(Boolean)
+            .join('\n');
+        if (metadata) {
+            content = `${metadata}\n\n${content}`;
+        }
+    }
+    // Add datetime if requested
+    if (config.include_datetime) {
+        const dt = context?.datetime || new Date();
+        content = `Current date: ${dt.toISOString()}\n\n${content}`;
+    }
+    parts.push(content);
+    // Add sections sorted by priority
+    if (config.sections) {
+        const sortedSections = [...config.sections].sort((a, b) => (b.priority || 0) - (a.priority || 0));
+        for (const section of sortedSections) {
+            parts.push(section.content);
+        }
+    }
+    // Add tools if requested
+    if (config.include_tools && context?.tools?.length) {
+        const toolList = context.tools.map((t) => `- ${t}`).join('\n');
+        parts.push(`\nAvailable tools:\n${toolList}`);
+    }
+    let result = parts.join('\n\n');
+    // Apply variable substitution
+    if (context?.customVariables) {
+        result = renderTemplate(result, context.customVariables);
+    }
+    // Truncate if needed
+    if (config.max_length && result.length > config.max_length) {
+        result = result.substring(0, config.max_length - 3) + '...';
+    }
+    return result;
+}
+//# sourceMappingURL=prompts.js.map

package/dist/types/prompts.js.map

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

package/dist/types/prompts.zod.d.ts

@@ -0,0 +1,252 @@
+/**
+ * OSSA Prompts Zod Schemas
+ * Validation schemas for spec.prompts
+ *
+ * @module @openstandardagents/prompts
+ * @version 0.3.2
+ */
+import { z } from 'zod';
+export declare const MessageRoleSchema: z.ZodEnum<{
+    system: "system";
+    assistant: "assistant";
+    user: "user";
+}>;
+export declare const ContentTypeSchema: z.ZodEnum<{
+    json: "json";
+    code: "code";
+    text: "text";
+    markdown: "markdown";
+}>;
+export declare const MessageSchema: z.ZodObject<{
+    role: z.ZodEnum<{
+        system: "system";
+        assistant: "assistant";
+        user: "user";
+    }>;
+    content: z.ZodString;
+    content_type: z.ZodOptional<z.ZodEnum<{
+        json: "json";
+        code: "code";
+        text: "text";
+        markdown: "markdown";
+    }>>;
+    name: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const PromptExampleSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    title: z.ZodOptional<z.ZodString>;
+    user: z.ZodString;
+    assistant: z.ZodString;
+    tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    context: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    priority: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const ExampleCollectionSchema: z.ZodObject<{
+    category: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    examples: z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        user: z.ZodString;
+        assistant: z.ZodString;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        context: z.ZodOptional<z.ZodString>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        priority: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+    max_include: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const TemplateVariableTypeSchema: z.ZodEnum<{
+    string: "string";
+    number: "number";
+    boolean: "boolean";
+    object: "object";
+    array: "array";
+}>;
+export declare const TemplateVariableSchema: z.ZodObject<{
+    name: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    default: z.ZodOptional<z.ZodString>;
+    required: z.ZodOptional<z.ZodBoolean>;
+    type: z.ZodOptional<z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        object: "object";
+        array: "array";
+    }>>;
+}, z.core.$strip>;
+export declare const TemplateFormatSchema: z.ZodEnum<{
+    text: "text";
+    markdown: "markdown";
+}>;
+export declare const PromptTemplateSchema: z.ZodObject<{
+    content: z.ZodString;
+    variables: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodOptional<z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            object: "object";
+            array: "array";
+        }>>;
+    }, z.core.$strip>>>;
+    format: z.ZodOptional<z.ZodEnum<{
+        text: "text";
+        markdown: "markdown";
+    }>>;
+}, z.core.$strip>;
+export declare const GreetingConfigSchema: z.ZodObject<{
+    default: z.ZodString;
+    first_time: z.ZodOptional<z.ZodString>;
+    returning: z.ZodOptional<z.ZodString>;
+    contextual: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    personalize: z.ZodOptional<z.ZodBoolean>;
+    include_time_context: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export declare const SystemPromptSectionSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodOptional<z.ZodString>;
+    content: z.ZodString;
+    required: z.ZodOptional<z.ZodBoolean>;
+    conditions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    priority: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const SystemPromptConfigSchema: z.ZodObject<{
+    content: z.ZodString;
+    sections: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        content: z.ZodString;
+        required: z.ZodOptional<z.ZodBoolean>;
+        conditions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        priority: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>>;
+    variables: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        default: z.ZodOptional<z.ZodString>;
+        required: z.ZodOptional<z.ZodBoolean>;
+        type: z.ZodOptional<z.ZodEnum<{
+            string: "string";
+            number: "number";
+            boolean: "boolean";
+            object: "object";
+            array: "array";
+        }>>;
+    }, z.core.$strip>>>;
+    include_metadata: z.ZodOptional<z.ZodBoolean>;
+    include_datetime: z.ZodOptional<z.ZodBoolean>;
+    include_tools: z.ZodOptional<z.ZodBoolean>;
+    max_length: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export declare const PromptsSpecSchema: z.ZodObject<{
+    system: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        content: z.ZodString;
+        sections: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+            content: z.ZodString;
+            required: z.ZodOptional<z.ZodBoolean>;
+            conditions: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            priority: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        variables: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            type: z.ZodOptional<z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                object: "object";
+                array: "array";
+            }>>;
+        }, z.core.$strip>>>;
+        include_metadata: z.ZodOptional<z.ZodBoolean>;
+        include_datetime: z.ZodOptional<z.ZodBoolean>;
+        include_tools: z.ZodOptional<z.ZodBoolean>;
+        max_length: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>;
+    greeting: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+        default: z.ZodString;
+        first_time: z.ZodOptional<z.ZodString>;
+        returning: z.ZodOptional<z.ZodString>;
+        contextual: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        personalize: z.ZodOptional<z.ZodBoolean>;
+        include_time_context: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>]>>;
+    examples: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodObject<{
+        id: z.ZodOptional<z.ZodString>;
+        title: z.ZodOptional<z.ZodString>;
+        user: z.ZodString;
+        assistant: z.ZodString;
+        tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        context: z.ZodOptional<z.ZodString>;
+        enabled: z.ZodOptional<z.ZodBoolean>;
+        priority: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>, z.ZodArray<z.ZodObject<{
+        category: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+        examples: z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            title: z.ZodOptional<z.ZodString>;
+            user: z.ZodString;
+            assistant: z.ZodString;
+            tags: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            context: z.ZodOptional<z.ZodString>;
+            enabled: z.ZodOptional<z.ZodBoolean>;
+            priority: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>;
+        max_include: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>]>>;
+    error_messages: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    confirmations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    help: z.ZodOptional<z.ZodString>;
+    farewell: z.ZodOptional<z.ZodString>;
+    thinking: z.ZodOptional<z.ZodString>;
+    rate_limit: z.ZodOptional<z.ZodString>;
+    capability_unavailable: z.ZodOptional<z.ZodString>;
+    templates: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        content: z.ZodString;
+        variables: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            default: z.ZodOptional<z.ZodString>;
+            required: z.ZodOptional<z.ZodBoolean>;
+            type: z.ZodOptional<z.ZodEnum<{
+                string: "string";
+                number: "number";
+                boolean: "boolean";
+                object: "object";
+                array: "array";
+            }>>;
+        }, z.core.$strip>>>;
+        format: z.ZodOptional<z.ZodEnum<{
+            text: "text";
+            markdown: "markdown";
+        }>>;
+    }, z.core.$strip>>>;
+    locale: z.ZodOptional<z.ZodString>;
+    fallback_locale: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type MessageRole = z.infer<typeof MessageRoleSchema>;
+export type ContentType = z.infer<typeof ContentTypeSchema>;
+export type Message = z.infer<typeof MessageSchema>;
+export type PromptExample = z.infer<typeof PromptExampleSchema>;
+export type ExampleCollection = z.infer<typeof ExampleCollectionSchema>;
+export type TemplateVariableType = z.infer<typeof TemplateVariableTypeSchema>;
+export type TemplateVariable = z.infer<typeof TemplateVariableSchema>;
+export type TemplateFormat = z.infer<typeof TemplateFormatSchema>;
+export type PromptTemplate = z.infer<typeof PromptTemplateSchema>;
+export type GreetingConfig = z.infer<typeof GreetingConfigSchema>;
+export type SystemPromptSection = z.infer<typeof SystemPromptSectionSchema>;
+export type SystemPromptConfig = z.infer<typeof SystemPromptConfigSchema>;
+export type PromptsSpec = z.infer<typeof PromptsSpecSchema>;
+//# sourceMappingURL=prompts.zod.d.ts.map

package/dist/types/prompts.zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.zod.d.ts","sourceRoot":"","sources":["../../src/types/prompts.zod.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,eAAO,MAAM,iBAAiB;;;;EAA0C,CAAC;AAEzE,eAAO,MAAM,iBAAiB;;;;;EAA+C,CAAC;AAE9E,eAAO,MAAM,aAAa;;;;;;;;;;;;;;iBAKxB,CAAC;AAMH,eAAO,MAAM,mBAAmB;;;;;;;;;iBAS9B,CAAC;AAEH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;iBAKlC,CAAC;AAMH,eAAO,MAAM,0BAA0B;;;;;;EAA6D,CAAC;AAErG,eAAO,MAAM,sBAAsB;;;;;;;;;;;;iBAMjC,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;EAA+B,CAAC;AAEjE,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;iBAI/B,CAAC;AAMH,eAAO,MAAM,oBAAoB;;;;;;;iBAO/B,CAAC;AAMH,eAAO,MAAM,yBAAyB;;;;;;;iBAOpC,CAAC;AAEH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAQnC,CAAC;AAMH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAc5B,CAAC;AAMH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC5D,MAAM,MAAM,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAChE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACxE,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAC9E,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAClE,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAC5E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAC1E,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}