@llm-dev-ops/agentics-cli 1.4.25 → 1.4.27

package/dist/bundled-agents/copilot-agents/dist/services/agents/contracts/objective-clarifier-schemas.js

@@ -0,0 +1,205 @@
+"use strict";
+/**
+ * Objective Clarifier Agent Schemas
+ *
+ * Purpose: Clarify ambiguous or incomplete objectives
+ * Classification: INTENT_ANALYSIS, DECOMPOSITION
+ * decision_type: objective_clarification
+ *
+ * Scope:
+ * - Resolve ambiguity
+ * - Normalize goals
+ * - Identify missing constraints
+ *
+ * Must Never:
+ * - Generate plans
+ * - Define solutions
+ * - Execute logic
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ObjectiveClarifierOutputSchema = exports.ObjectiveClarifierInputSchema = exports.NormalizedGoalSchema = exports.MissingConstraintSchema = exports.AmbiguitySchema = void 0;
+const zod_1 = require("zod");
+const pipeline_schemas_1 = require("./pipeline-schemas");
+/**
+ * Ambiguity detection result
+ */
+exports.AmbiguitySchema = zod_1.z.object({
+    /** Unique identifier for this ambiguity */
+    id: zod_1.z.string().min(1),
+    /** Type of ambiguity detected */
+    type: zod_1.z.enum([
+        'lexical', // Word meaning unclear
+        'syntactic', // Sentence structure unclear
+        'semantic', // Meaning/intent unclear
+        'referential', // Reference unclear (what does "it" refer to)
+        'scope', // Extent/boundaries unclear
+        'temporal', // Timing/sequencing unclear
+        'quantitative', // Amount/scale unclear
+        'conditional', // Conditions/constraints unclear
+    ]),
+    /** The ambiguous portion of the objective */
+    source_text: zod_1.z.string(),
+    /** Description of why this is ambiguous */
+    description: zod_1.z.string(),
+    /** Possible interpretations of the ambiguous element */
+    interpretations: zod_1.z.array(zod_1.z.object({
+        interpretation: zod_1.z.string(),
+        likelihood: zod_1.z.number().min(0).max(1),
+        assumptions: zod_1.z.array(zod_1.z.string()).default([]),
+    })).min(1),
+    /** Severity of the ambiguity (how much it blocks understanding) */
+    severity: zod_1.z.enum(['low', 'medium', 'high', 'critical']),
+    /** Suggested clarification question */
+    clarification_prompt: zod_1.z.string(),
+});
+/**
+ * Missing constraint identification
+ */
+exports.MissingConstraintSchema = zod_1.z.object({
+    /** Unique identifier */
+    id: zod_1.z.string().min(1),
+    /** Category of the missing constraint */
+    category: zod_1.z.enum([
+        'temporal', // Timeline, deadlines, duration
+        'resource', // Budget, tools, people, systems
+        'quality', // Standards, acceptance criteria
+        'scope', // Boundaries, inclusions/exclusions
+        'dependency', // Prerequisites, blockers
+        'compliance', // Regulations, policies
+        'technical', // Technology choices, compatibility
+        'performance', // Speed, scalability, limits
+    ]),
+    /** What constraint information is missing */
+    description: zod_1.z.string(),
+    /** Why this constraint matters */
+    impact: zod_1.z.string(),
+    /** Severity if left unspecified */
+    severity: zod_1.z.enum(['low', 'medium', 'high', 'critical']),
+    /** Suggested question to elicit this constraint */
+    clarification_prompt: zod_1.z.string(),
+    /** Default assumption if not clarified */
+    default_assumption: zod_1.z.string().optional(),
+});
+/**
+ * Normalized goal representation
+ */
+exports.NormalizedGoalSchema = zod_1.z.object({
+    /** Unique identifier for the goal */
+    goal_id: zod_1.z.string().min(1),
+    /** Normalized statement of the goal */
+    statement: zod_1.z.string().min(1),
+    /** Goal type classification */
+    type: zod_1.z.enum([
+        'functional', // What the system should do
+        'non_functional', // How well it should do it
+        'constraint', // Limitations or boundaries
+        'assumption', // Implicit requirements
+    ]),
+    /** Extracted action verb (normalized) */
+    action: zod_1.z.string(),
+    /** Subject/target of the action */
+    subject: zod_1.z.string(),
+    /** Optional object/output of the action */
+    object: zod_1.z.string().optional(),
+    /** Qualifiers and conditions */
+    qualifiers: zod_1.z.array(zod_1.z.string()).default([]),
+    /** Confidence in this normalization */
+    confidence: zod_1.z.number().min(0).max(1),
+    /** Original text this was derived from */
+    source_text: zod_1.z.string(),
+});
+/**
+ * Objective Clarifier Agent Input Schema
+ */
+exports.ObjectiveClarifierInputSchema = zod_1.z.object({
+    /** The raw objective to clarify */
+    objective: zod_1.z.string().min(1).max(50000),
+    /** Optional context to aid clarification */
+    context: zod_1.z.object({
+        /** Domain/industry context */
+        domain: zod_1.z.string().optional(),
+        /** Known stakeholders */
+        stakeholders: zod_1.z.array(zod_1.z.string()).optional(),
+        /** Existing system/project information */
+        existing_context: zod_1.z.string().optional(),
+        /** Previously established constraints */
+        known_constraints: zod_1.z.array(zod_1.z.string()).optional(),
+        /** Priority hints */
+        priorities: zod_1.z.array(zod_1.z.string()).optional(),
+    }).optional(),
+    /** Configuration for clarification */
+    config: zod_1.z.object({
+        /** Minimum ambiguity severity to report */
+        min_severity: zod_1.z.enum(['low', 'medium', 'high', 'critical']).optional(),
+        /** Maximum number of clarification questions to generate */
+        max_questions: zod_1.z.number().int().positive().max(20).optional(),
+        /** Whether to attempt automatic resolution of low-severity ambiguities */
+        auto_resolve_low_severity: zod_1.z.boolean().optional(),
+        /** Preferred interpretation style */
+        interpretation_style: zod_1.z.enum(['conservative', 'balanced', 'liberal']).optional(),
+    }).optional(),
+    /** Request ID for tracing */
+    request_id: zod_1.z.string().uuid().optional(),
+    /** Optional pipeline context for multi-agent orchestration */
+    pipeline_context: pipeline_schemas_1.PipelineContextSchema.optional(),
+});
+/**
+ * Objective Clarifier Agent Output Schema
+ */
+exports.ObjectiveClarifierOutputSchema = zod_1.z.object({
+    /** Unique clarification session identifier */
+    clarification_id: zod_1.z.string().uuid(),
+    /** Original objective (echoed for verification) */
+    original_objective: zod_1.z.string(),
+    /** Clarification status */
+    status: zod_1.z.enum([
+        'clear', // Objective is clear, no issues found
+        'needs_clarification', // Ambiguities or missing constraints found
+        'requires_decomposition', // Too complex, needs breaking down
+        'insufficient', // Not enough information to analyze
+    ]),
+    /** List of detected ambiguities */
+    ambiguities: zod_1.z.array(exports.AmbiguitySchema).default([]),
+    /** List of missing constraints */
+    missing_constraints: zod_1.z.array(exports.MissingConstraintSchema).default([]),
+    /** Normalized goals extracted from the objective */
+    normalized_goals: zod_1.z.array(exports.NormalizedGoalSchema).default([]),
+    /** Clarified/normalized version of the objective */
+    clarified_objective: zod_1.z.object({
+        /** The clarified objective statement */
+        statement: zod_1.z.string(),
+        /** Assumptions made during clarification */
+        assumptions: zod_1.z.array(zod_1.z.string()).default([]),
+        /** Unresolved items that need human input */
+        unresolved: zod_1.z.array(zod_1.z.string()).default([]),
+        /** Confidence in the clarification */
+        confidence: zod_1.z.number().min(0).max(1),
+    }),
+    /** Prioritized clarification questions */
+    clarification_questions: zod_1.z.array(zod_1.z.object({
+        question: zod_1.z.string(),
+        priority: zod_1.z.enum(['low', 'medium', 'high', 'critical']),
+        related_ambiguity_id: zod_1.z.string().optional(),
+        related_constraint_id: zod_1.z.string().optional(),
+    })).default([]),
+    /** Analysis metadata */
+    analysis: zod_1.z.object({
+        /** Total ambiguities detected */
+        total_ambiguities: zod_1.z.number().int().nonnegative(),
+        /** Total missing constraints */
+        total_missing_constraints: zod_1.z.number().int().nonnegative(),
+        /** Total goals extracted */
+        total_goals: zod_1.z.number().int().nonnegative(),
+        /** Overall clarity score (0-1) */
+        clarity_score: zod_1.z.number().min(0).max(1),
+        /** Completeness score (0-1) */
+        completeness_score: zod_1.z.number().min(0).max(1),
+        /** Word count of original objective */
+        word_count: zod_1.z.number().int().nonnegative(),
+        /** Complexity assessment */
+        complexity: zod_1.z.enum(['simple', 'moderate', 'complex', 'very_complex']),
+    }),
+    /** Clarification version */
+    version: zod_1.z.string().default('1.0.0'),
+});
+//# sourceMappingURL=objective-clarifier-schemas.js.map

package/dist/bundled-agents/copilot-agents/dist/services/agents/contracts/objective-clarifier-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"objective-clarifier-schemas.js","sourceRoot":"","sources":["../../../../../services/agents/contracts/objective-clarifier-schemas.ts"],"names":[],"mappings":"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"}

package/dist/bundled-agents/copilot-agents/dist/services/agents/contracts/pipeline-schemas.d.ts

@@ -0,0 +1,285 @@
+/**
+ * Pipeline Orchestration Schemas
+ *
+ * Types for multi-agent pipeline orchestration.
+ * Used by the decomposer to produce execution plans and by all agents
+ * to accept/echo pipeline context for traceability.
+ */
+import { z } from 'zod';
+/**
+ * The full Agentics domain registry. The decomposer uses this to route
+ * pipeline steps to the correct domain + agent.
+ */
+export declare const DOMAIN_REGISTRY: {
+    readonly copilot: {
+        readonly agents: readonly ["planner", "config", "decomposer", "clarifier", "intent", "reflection", "meta-reasoner"];
+    };
+    readonly forge: {
+        readonly agents: readonly ["sdk", "scaffold", "template"];
+    };
+    readonly runtime: {
+        readonly agents: readonly ["executor", "sandbox", "wasm"];
+    };
+    readonly data: {
+        readonly agents: readonly ["ingest", "transform", "query"];
+    };
+    readonly auth: {
+        readonly agents: readonly ["identity", "rbac", "token"];
+    };
+    readonly observability: {
+        readonly agents: readonly ["metrics", "trace", "log"];
+    };
+    readonly deploy: {
+        readonly agents: readonly ["ci", "cd", "rollback"];
+    };
+    readonly test: {
+        readonly agents: readonly ["unit", "integration", "e2e"];
+    };
+    readonly docs: {
+        readonly agents: readonly ["generate", "index", "search"];
+    };
+    readonly security: {
+        readonly agents: readonly ["scan", "audit", "compliance"];
+    };
+    readonly ml: {
+        readonly agents: readonly ["train", "inference", "evaluate"];
+    };
+    readonly search: {
+        readonly agents: readonly ["index", "query", "rank"];
+    };
+    readonly storage: {
+        readonly agents: readonly ["blob", "cache", "archive"];
+    };
+    readonly messaging: {
+        readonly agents: readonly ["pubsub", "queue", "stream"];
+    };
+    readonly gateway: {
+        readonly agents: readonly ["route", "ratelimit", "transform"];
+    };
+    readonly workflow: {
+        readonly agents: readonly ["orchestrate", "schedule", "retry"];
+    };
+    readonly ui: {
+        readonly agents: readonly ["component", "layout", "theme"];
+    };
+    readonly analytics: {
+        readonly agents: readonly ["collect", "aggregate", "report"];
+    };
+    readonly billing: {
+        readonly agents: readonly ["meter", "invoice", "plan"];
+    };
+    readonly notification: {
+        readonly agents: readonly ["email", "push", "webhook"];
+    };
+    readonly migration: {
+        readonly agents: readonly ["schema", "data", "rollback"];
+    };
+    readonly config: {
+        readonly agents: readonly ["validate", "distribute", "version"];
+    };
+    readonly secret: {
+        readonly agents: readonly ["vault", "rotate", "inject"];
+    };
+    readonly edge: {
+        readonly agents: readonly ["cdn", "function", "cache"];
+    };
+    readonly compliance: {
+        readonly agents: readonly ["gdpr", "hipaa", "soc2"];
+    };
+    readonly i18n: {
+        readonly agents: readonly ["translate", "locale", "format"];
+    };
+    readonly devtools: {
+        readonly agents: readonly ["lint", "format", "debug"];
+    };
+};
+export type DomainName = keyof typeof DOMAIN_REGISTRY;
+export declare const DOMAIN_NAMES: DomainName[];
+export declare const PipelineStepSchema: z.ZodObject<{
+    /** Step identifier within the pipeline */
+    step_id: z.ZodString;
+    /** Target domain from the 27-domain registry */
+    domain: z.ZodString;
+    /** Target agent within the domain */
+    agent: z.ZodString;
+    /** Human-readable description of what this step does */
+    description: z.ZodString;
+    /** step_id of the step whose output feeds into this step (null if no dependency) */
+    input_from: z.ZodNullable<z.ZodString>;
+    /** Label for the expected output artifact type */
+    output_schema: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    description: string;
+    step_id: string;
+    domain: string;
+    agent: string;
+    input_from: string | null;
+    output_schema: string;
+}, {
+    description: string;
+    step_id: string;
+    domain: string;
+    agent: string;
+    input_from: string | null;
+    output_schema: string;
+}>;
+export type PipelineStep = z.infer<typeof PipelineStepSchema>;
+export declare const PipelineSpecSchema: z.ZodObject<{
+    /** Unique plan identifier */
+    plan_id: z.ZodString;
+    /** Ordered list of execution steps */
+    steps: z.ZodArray<z.ZodObject<{
+        /** Step identifier within the pipeline */
+        step_id: z.ZodString;
+        /** Target domain from the 27-domain registry */
+        domain: z.ZodString;
+        /** Target agent within the domain */
+        agent: z.ZodString;
+        /** Human-readable description of what this step does */
+        description: z.ZodString;
+        /** step_id of the step whose output feeds into this step (null if no dependency) */
+        input_from: z.ZodNullable<z.ZodString>;
+        /** Label for the expected output artifact type */
+        output_schema: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        description: string;
+        step_id: string;
+        domain: string;
+        agent: string;
+        input_from: string | null;
+        output_schema: string;
+    }, {
+        description: string;
+        step_id: string;
+        domain: string;
+        agent: string;
+        input_from: string | null;
+        output_schema: string;
+    }>, "many">;
+    /** Pipeline metadata */
+    metadata: z.ZodObject<{
+        /** Original NL query that triggered decomposition */
+        source_query: z.ZodString;
+        /** ISO timestamp of pipeline creation */
+        created_at: z.ZodString;
+        /** Number of steps in the pipeline */
+        estimated_steps: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        source_query: string;
+        created_at: string;
+        estimated_steps: number;
+    }, {
+        source_query: string;
+        created_at: string;
+        estimated_steps: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    plan_id: string;
+    steps: {
+        description: string;
+        step_id: string;
+        domain: string;
+        agent: string;
+        input_from: string | null;
+        output_schema: string;
+    }[];
+    metadata: {
+        source_query: string;
+        created_at: string;
+        estimated_steps: number;
+    };
+}, {
+    plan_id: string;
+    steps: {
+        description: string;
+        step_id: string;
+        domain: string;
+        agent: string;
+        input_from: string | null;
+        output_schema: string;
+    }[];
+    metadata: {
+        source_query: string;
+        created_at: string;
+        estimated_steps: number;
+    };
+}>;
+export type PipelineSpec = z.infer<typeof PipelineSpecSchema>;
+export declare const PipelineStepRefSchema: z.ZodObject<{
+    step_id: z.ZodString;
+    domain: z.ZodString;
+    agent: z.ZodString;
+    output: z.ZodOptional<z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    step_id: string;
+    domain: string;
+    agent: string;
+    output?: unknown;
+}, {
+    step_id: string;
+    domain: string;
+    agent: string;
+    output?: unknown;
+}>;
+export type PipelineStepRef = z.infer<typeof PipelineStepRefSchema>;
+export declare const PipelineContextSchema: z.ZodObject<{
+    /** Pipeline plan ID */
+    plan_id: z.ZodString;
+    /** Current step being executed */
+    step_id: z.ZodString;
+    /** Outputs from previously completed steps */
+    previous_steps: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        step_id: z.ZodString;
+        domain: z.ZodString;
+        agent: z.ZodString;
+        output: z.ZodOptional<z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        step_id: string;
+        domain: string;
+        agent: string;
+        output?: unknown;
+    }, {
+        step_id: string;
+        domain: string;
+        agent: string;
+        output?: unknown;
+    }>, "many">>;
+    /** Execution-level metadata */
+    execution_metadata: z.ZodOptional<z.ZodObject<{
+        trace_id: z.ZodString;
+        initiated_by: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        trace_id: string;
+        initiated_by: string;
+    }, {
+        trace_id: string;
+        initiated_by: string;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    step_id: string;
+    plan_id: string;
+    previous_steps: {
+        step_id: string;
+        domain: string;
+        agent: string;
+        output?: unknown;
+    }[];
+    execution_metadata?: {
+        trace_id: string;
+        initiated_by: string;
+    } | undefined;
+}, {
+    step_id: string;
+    plan_id: string;
+    previous_steps?: {
+        step_id: string;
+        domain: string;
+        agent: string;
+        output?: unknown;
+    }[] | undefined;
+    execution_metadata?: {
+        trace_id: string;
+        initiated_by: string;
+    } | undefined;
+}>;
+export type PipelineContext = z.infer<typeof PipelineContextSchema>;

package/dist/bundled-agents/copilot-agents/dist/services/agents/contracts/pipeline-schemas.js

@@ -0,0 +1,106 @@
+"use strict";
+/**
+ * Pipeline Orchestration Schemas
+ *
+ * Types for multi-agent pipeline orchestration.
+ * Used by the decomposer to produce execution plans and by all agents
+ * to accept/echo pipeline context for traceability.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PipelineContextSchema = exports.PipelineStepRefSchema = exports.PipelineSpecSchema = exports.PipelineStepSchema = exports.DOMAIN_NAMES = exports.DOMAIN_REGISTRY = void 0;
+const zod_1 = require("zod");
+// ---------------------------------------------------------------------------
+// 27-Domain Registry
+// ---------------------------------------------------------------------------
+/**
+ * The full Agentics domain registry. The decomposer uses this to route
+ * pipeline steps to the correct domain + agent.
+ */
+exports.DOMAIN_REGISTRY = {
+    copilot: { agents: ['planner', 'config', 'decomposer', 'clarifier', 'intent', 'reflection', 'meta-reasoner'] },
+    forge: { agents: ['sdk', 'scaffold', 'template'] },
+    runtime: { agents: ['executor', 'sandbox', 'wasm'] },
+    data: { agents: ['ingest', 'transform', 'query'] },
+    auth: { agents: ['identity', 'rbac', 'token'] },
+    observability: { agents: ['metrics', 'trace', 'log'] },
+    deploy: { agents: ['ci', 'cd', 'rollback'] },
+    test: { agents: ['unit', 'integration', 'e2e'] },
+    docs: { agents: ['generate', 'index', 'search'] },
+    security: { agents: ['scan', 'audit', 'compliance'] },
+    ml: { agents: ['train', 'inference', 'evaluate'] },
+    search: { agents: ['index', 'query', 'rank'] },
+    storage: { agents: ['blob', 'cache', 'archive'] },
+    messaging: { agents: ['pubsub', 'queue', 'stream'] },
+    gateway: { agents: ['route', 'ratelimit', 'transform'] },
+    workflow: { agents: ['orchestrate', 'schedule', 'retry'] },
+    ui: { agents: ['component', 'layout', 'theme'] },
+    analytics: { agents: ['collect', 'aggregate', 'report'] },
+    billing: { agents: ['meter', 'invoice', 'plan'] },
+    notification: { agents: ['email', 'push', 'webhook'] },
+    migration: { agents: ['schema', 'data', 'rollback'] },
+    config: { agents: ['validate', 'distribute', 'version'] },
+    secret: { agents: ['vault', 'rotate', 'inject'] },
+    edge: { agents: ['cdn', 'function', 'cache'] },
+    compliance: { agents: ['gdpr', 'hipaa', 'soc2'] },
+    i18n: { agents: ['translate', 'locale', 'format'] },
+    devtools: { agents: ['lint', 'format', 'debug'] },
+};
+exports.DOMAIN_NAMES = Object.keys(exports.DOMAIN_REGISTRY);
+// ---------------------------------------------------------------------------
+// Pipeline Step (produced by decomposer)
+// ---------------------------------------------------------------------------
+exports.PipelineStepSchema = zod_1.z.object({
+    /** Step identifier within the pipeline */
+    step_id: zod_1.z.string().min(1),
+    /** Target domain from the 27-domain registry */
+    domain: zod_1.z.string().min(1),
+    /** Target agent within the domain */
+    agent: zod_1.z.string().min(1),
+    /** Human-readable description of what this step does */
+    description: zod_1.z.string().min(1),
+    /** step_id of the step whose output feeds into this step (null if no dependency) */
+    input_from: zod_1.z.string().nullable(),
+    /** Label for the expected output artifact type */
+    output_schema: zod_1.z.string().min(1),
+});
+// ---------------------------------------------------------------------------
+// Pipeline Spec (decomposer output)
+// ---------------------------------------------------------------------------
+exports.PipelineSpecSchema = zod_1.z.object({
+    /** Unique plan identifier */
+    plan_id: zod_1.z.string().uuid(),
+    /** Ordered list of execution steps */
+    steps: zod_1.z.array(exports.PipelineStepSchema).min(1),
+    /** Pipeline metadata */
+    metadata: zod_1.z.object({
+        /** Original NL query that triggered decomposition */
+        source_query: zod_1.z.string(),
+        /** ISO timestamp of pipeline creation */
+        created_at: zod_1.z.string().datetime(),
+        /** Number of steps in the pipeline */
+        estimated_steps: zod_1.z.number().int().nonnegative(),
+    }),
+});
+// ---------------------------------------------------------------------------
+// Pipeline Context (sent with requests in a pipeline)
+// ---------------------------------------------------------------------------
+exports.PipelineStepRefSchema = zod_1.z.object({
+    step_id: zod_1.z.string(),
+    domain: zod_1.z.string(),
+    agent: zod_1.z.string(),
+    output: zod_1.z.unknown().optional(),
+});
+exports.PipelineContextSchema = zod_1.z.object({
+    /** Pipeline plan ID */
+    plan_id: zod_1.z.string(),
+    /** Current step being executed */
+    step_id: zod_1.z.string(),
+    /** Outputs from previously completed steps */
+    previous_steps: zod_1.z.array(exports.PipelineStepRefSchema).default([]),
+    /** Execution-level metadata */
+    execution_metadata: zod_1.z.object({
+        trace_id: zod_1.z.string(),
+        initiated_by: zod_1.z.string(),
+    }).optional(),
+});
+//# sourceMappingURL=pipeline-schemas.js.map

package/dist/bundled-agents/copilot-agents/dist/services/agents/contracts/pipeline-schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-schemas.js","sourceRoot":"","sources":["../../../../../services/agents/contracts/pipeline-schemas.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAEH,6BAAwB;AAExB,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E;;;GAGG;AACU,QAAA,eAAe,GAAG;IAC7B,OAAO,EAAK,EAAE,MAAM,EAAE,CAAC,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,eAAe,CAAC,EAAE;IACjH,KAAK,EAAO,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE;IACvD,OAAO,EAAK,EAAE,MAAM,EAAE,CAAC,UAAU,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE;IACvD,IAAI,EAAQ,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE;IACxD,IAAI,EAAQ,EAAE,MAAM,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IACrD,aAAa,EAAE,EAAE,MAAM,EAAE,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE;IACtD,MAAM,EAAM,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE;IAChD,IAAI,EAAQ,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,CAAC,EAAE;IACtD,IAAI,EAAQ,EAAE,MAAM,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE;IACvD,QAAQ,EAAI,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,EAAE;IACvD,EAAE,EAAU,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,UAAU,CAAC,EAAE;IAC1D,MAAM,EAAM,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE;IAClD,OAAO,EAAK,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,EAAE;IACpD,SAAS,EAAG,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE;IACrD,OAAO,EAAK,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE;IAC3D,QAAQ,EAAI,EAAE,MAAM,EAAE,CAAC,aAAa,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE;IAC5D,EAAE,EAAU,EAAE,MAAM,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE;IACxD,SAAS,EAAG,EAAE,MAAM,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,EAAE;IAC1D,OAAO,EAAK,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE;IACpD,YAAY,EAAE,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE;IACtD,SAAS,EAAG,EAAE,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE;IACtD,MAAM,EAAM,EAAE,MAAM,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,SAAS,CAAC,EAAE;IAC7D,MAAM,EAAM,EAAE,MAAM,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE;IACrD,IAAI,EAAQ,EAAE,MAAM,EAAE,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE;IACpD,UAAU,EAAE,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE;IACjD,IAAI,EAAQ,EAAE,MAAM,EAAE,CAAC,WAAW,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE;IACzD,QAAQ,EAAI,EAAE,MAAM,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE;CAC3C,CAAC;AAIE,QAAA,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,uBAAe,CAAiB,CAAC;AAEzE,8EAA8E;AAC9E,yCAAyC;AACzC,8EAA8E;AAEjE,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC,0CAA0C;IAC1C,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAE1B,gDAAgD;IAChD,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAEzB,qCAAqC;IACrC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAExB,wDAAwD;IACxD,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAE9B,oFAAoF;IACpF,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAEjC,kDAAkD;IAClD,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACjC,CAAC,CAAC;AAIH,8EAA8E;AAC9E,oCAAoC;AACpC,8EAA8E;AAEjE,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC,6BAA6B;IAC7B,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAE1B,sCAAsC;IACtC,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,0BAAkB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAEzC,wBAAwB;IACxB,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC;QACjB,qDAAqD;QACrD,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE;QAExB,yCAAyC;QACzC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAEjC,sCAAsC;QACtC,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;KAChD,CAAC;CACH,CAAC,CAAC;AAIH,8EAA8E;AAC9E,sDAAsD;AACtD,8EAA8E;AAEjE,QAAA,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IACnB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE;IAClB,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC/B,CAAC,CAAC;AAIU,QAAA,qBAAqB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,uBAAuB;IACvB,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IAEnB,kCAAkC;IAClC,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE;IAEnB,8CAA8C;IAC9C,cAAc,EAAE,OAAC,CAAC,KAAK,CAAC,6BAAqB,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;IAE1D,+BAA+B;IAC/B,kBAAkB,EAAE,OAAC,CAAC,MAAM,CAAC;QAC3B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;QACpB,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE;KACzB,CAAC,CAAC,QAAQ,EAAE;CACd,CAAC,CAAC"}