cognitive-core 0.1.0 → 0.1.2

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

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/types/knowledge.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAyCxB,eAAO,MAAM,gBAAgB,6QAKnB,CAAC;AAEX,eAAO,MAAM,kBAAkB,+QAA2B,CAAC;AAC3D,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,8CAA8C;AAC9C,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,YAAY,GACrB,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,CAQ/C;AAMD,eAAO,MAAM,cAAc,wDAIzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,eAAO,MAAM,kBAAkB,wDAI7B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,eAAO,MAAM,oBAAoB,yDAK/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAMlE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;EAI9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;EAKhC,CAAC;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,eAAO,MAAM,8BAA8B;IACzC,wEAAwE;;IAExE,sDAAsD;;IAEtD,6CAA6C;;IAE7C,gEAAgE;;IAEhE,kDAAkD;;IAElD,yCAAyC;;IAEzC,qCAAqC;;;;;;;;;;;;;;;;;IAErC,8CAA8C;;;;;;;;;;;;;;IAE9C,kCAAkC;;IAElC,sCAAsC;;IAEtC,sEAAsE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEtE,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAC5C,OAAO,8BAA8B,CACtC,CAAC;AAMF,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,WAAW,EAAE,wBAAwB,CAAC;IACtC,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,aAAa,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;CACxD;AAMD,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,cAAc,EAAE,MAAM,CAAC;IACvB,0CAA0C;IAC1C,cAAc,EAAE,aAAa,CAAC;IAC9B,wBAAwB;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB;IACrB,UAAU,EAAE,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;CAChD;AAED,MAAM,WAAW,YAAY;IAC3B,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,6BAA6B;IAC7B,QAAQ,EAAE,UAAU,GAAG,aAAa,GAAG,gBAAgB,CAAC;CACzD;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,CAAC,EAAE,cAAc,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,YAAY,EAAE,aAAa,EAAE,CAAC;IAC9B,yDAAyD;IACzD,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,sDAAsD;IACtD,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,oCAAoC;IACpC,KAAK,EAAE,OAAO,EAAE,CAAC;IACjB,oCAAoC;IACpC,aAAa,EAAE,YAAY,EAAE,CAAC;CAC/B;AAMD,MAAM,WAAW,WAAW;IAC1B,4BAA4B;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,+BAA+B;IAC/B,eAAe,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,KAAK,EAAE,WAAW,CAAC;IACnB,4DAA4D;IAC5D,YAAY,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,YAAY,EAAE,OAAO,CAAC;IACtB,6CAA6C;IAC7C,0BAA0B,EAAE,MAAM,CAAC;IACnC,oBAAoB;IACpB,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACzC,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAcD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE;IACvC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;CACzB,GAAG,aAAa,CAqBhB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,eAAe,CAAC;IACxB,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;CACzB,GAAG,aAAa,CAqBhB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,eAAe,CAAC;CACzB,GAAG,aAAa,CAqBhB"}

package/dist/types/knowledge.js

@@ -0,0 +1,191 @@
+import { z } from 'zod';
+// ============================================================================
+// Link Relations (organized by graph layer)
+// ============================================================================
+/** Semantic layer relations */
+const SemanticRelations = [
+    'related-to',
+    'depends-on',
+    'specializes',
+    'generalizes',
+    'supports',
+];
+/** Temporal layer relations */
+const TemporalRelations = [
+    'observed-before',
+    'observed-after',
+    'co-occurred',
+    'supersedes',
+];
+/** Causal layer relations */
+const CausalRelations = [
+    'caused-by',
+    'led-to',
+    'broke',
+    'enabled',
+    'prevented',
+];
+/** Entity layer relations */
+const EntityRelations = [
+    'uses',
+    'part-of',
+    'interacts-with',
+    'contradicts',
+    'created-by',
+];
+export const AllLinkRelations = [
+    ...SemanticRelations,
+    ...TemporalRelations,
+    ...CausalRelations,
+    ...EntityRelations,
+];
+export const LinkRelationSchema = z.enum(AllLinkRelations);
+/** Map relation to its natural graph layer */
+export function inferLayerFromRelation(relation) {
+    if (SemanticRelations.includes(relation))
+        return 'semantic';
+    if (TemporalRelations.includes(relation))
+        return 'temporal';
+    if (CausalRelations.includes(relation))
+        return 'causal';
+    return 'entity';
+}
+// ============================================================================
+// Note Types
+// ============================================================================
+export const NoteTypeSchema = z.enum([
+    'observation',
+    'entity',
+    'domain-summary',
+]);
+export const SourceOriginSchema = z.enum([
+    'extracted',
+    'agent-authored',
+    'imported',
+]);
+export const GraphLayerNameSchema = z.enum([
+    'semantic',
+    'temporal',
+    'causal',
+    'entity',
+]);
+// ============================================================================
+// Knowledge Note Frontmatter Schema
+// ============================================================================
+export const KnowledgeLinkSchema = z.object({
+    target: z.string(),
+    relation: LinkRelationSchema,
+    layer: GraphLayerNameSchema.optional(),
+});
+export const KnowledgeSourceSchema = z.object({
+    origin: SourceOriginSchema,
+    trajectories: z.array(z.string()).optional(),
+    playbooks: z.array(z.string()).optional(),
+    agentId: z.string().optional(),
+});
+export const KnowledgeNoteFrontmatterSchema = z.object({
+    /** Unique identifier (kebab-case, prefixed with k- for observations) */
+    id: z.string(),
+    /** Note type determines organization and lifecycle */
+    type: NoteTypeSchema,
+    /** Knowledge domains this note belongs to */
+    domain: z.array(z.string()).default([]),
+    /** Specific entities (tools, libraries, patterns) referenced */
+    entities: z.array(z.string()).default([]),
+    /** Freeform tags for additional categorization */
+    tags: z.array(z.string()).default([]),
+    /** Confidence in this knowledge (0-1) */
+    confidence: z.number().min(0).max(1).default(0.5),
+    /** Where this knowledge came from */
+    source: KnowledgeSourceSchema,
+    /** Explicit links to other knowledge notes */
+    links: z.array(KnowledgeLinkSchema).default([]),
+    /** ISO 8601 creation timestamp */
+    created: z.string(),
+    /** ISO 8601 last updated timestamp */
+    updated: z.string(),
+    /** If this note replaces a previous one (contradiction resolution) */
+    supersedes: z.string().nullable().optional(),
+});
+// ============================================================================
+// Factory Functions
+// ============================================================================
+let noteCounter = 0;
+function generateNoteId(prefix) {
+    const timestamp = Date.now().toString(36);
+    const counter = (noteCounter++).toString(36);
+    return `${prefix}-${timestamp}-${counter}`;
+}
+/**
+ * Create a new observation note
+ */
+export function createObservation(input) {
+    const now = new Date().toISOString();
+    const id = input.id ?? generateNoteId('k');
+    return {
+        frontmatter: {
+            id,
+            type: 'observation',
+            domain: input.domain,
+            entities: input.entities,
+            tags: input.tags ?? [],
+            confidence: input.confidence ?? 0.3,
+            source: input.source,
+            links: input.links ?? [],
+            created: now,
+            updated: now,
+            supersedes: null,
+        },
+        body: `# ${input.title}\n\n${input.body}`,
+        filePath: `knowledge/observations/${id}.md`,
+    };
+}
+/**
+ * Create a new entity note
+ */
+export function createEntityNote(input) {
+    const now = new Date().toISOString();
+    const slug = input.entityName.toLowerCase().replace(/[^a-z0-9]+/g, '-');
+    return {
+        frontmatter: {
+            id: slug,
+            type: 'entity',
+            domain: input.domain,
+            entities: [input.entityName],
+            tags: input.tags ?? [],
+            confidence: input.confidence ?? 0.5,
+            source: input.source,
+            links: input.links ?? [],
+            created: now,
+            updated: now,
+            supersedes: null,
+        },
+        body: `# ${input.entityName}\n\n${input.body}`,
+        filePath: `knowledge/entities/${slug}.md`,
+    };
+}
+/**
+ * Create a new domain summary note
+ */
+export function createDomainSummary(input) {
+    const now = new Date().toISOString();
+    const slug = input.domainName.toLowerCase().replace(/[^a-z0-9]+/g, '-');
+    return {
+        frontmatter: {
+            id: slug,
+            type: 'domain-summary',
+            domain: [input.domainName],
+            entities: input.entities ?? [],
+            tags: input.tags ?? [],
+            confidence: 1.0,
+            source: input.source,
+            links: [],
+            created: now,
+            updated: now,
+            supersedes: null,
+        },
+        body: `# ${input.domainName}\n\n${input.body}`,
+        filePath: `knowledge/domains/${slug}.md`,
+    };
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/types/knowledge.js.map

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

package/dist/types/team-meta.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Team Meta-Learning Types
+ *
+ * Types for meta-learning about team formation and coordination.
+ * Observes patterns about which team configurations work for which contexts.
+ * The team-level analog of MetaObservation and MetaStrategy.
+ */
+/**
+ * TeamMetaObservation - Records team formation decisions and outcomes.
+ * The team-level analog of MetaObservation.
+ */
+export interface TeamMetaObservation {
+    id: string;
+    /** Source team trajectory */
+    teamTrajectoryId: string;
+    formation: FormationObservation;
+    compositionEffectiveness: CompositionObservation;
+    coordinationEffectiveness: CoordinationObservation;
+    outcome: TeamOutcomeObservation;
+    lessons: TeamLessonsLearned;
+    timestamp: Date;
+}
+/**
+ * How the team was formed and why.
+ */
+export interface FormationObservation {
+    /** Was a team playbook used to form this team? */
+    playbookUsed?: string;
+    /** Was the team formed from a template or ad-hoc? */
+    formationMethod: 'template' | 'playbook' | 'manual' | 'adaptive';
+    /** Confidence in the formation decision */
+    confidence: number;
+    /** Reasoning for formation choice */
+    reasoning: string;
+    /** Whether the formation was effective (DESIGN doc field) */
+    wasEffective?: boolean;
+    /** Topology type used (stored for reliable extraction in meta-learner) */
+    topologyUsed?: 'hierarchical' | 'flat' | 'wave' | 'custom';
+    /** Domain of the task */
+    domain?: string;
+}
+/**
+ * How effective was the team composition?
+ */
+export interface CompositionObservation {
+    /** Were all roles utilized? */
+    roleUtilization: Record<string, number>;
+    /** Were any roles missing that would have helped? */
+    missingRoles: string[];
+    /** Were any roles redundant? */
+    redundantRoles: string[];
+    /** Was team size appropriate? */
+    teamSizeAssessment: 'too-small' | 'right-sized' | 'too-large';
+    /** Was the topology appropriate? */
+    topologyAssessment: 'effective' | 'neutral' | 'hindering';
+}
+/**
+ * How effective was the coordination?
+ */
+export interface CoordinationObservation {
+    /** Was enforcement mode appropriate? */
+    enforcementAssessment: 'too-strict' | 'appropriate' | 'too-loose';
+    /** Were communication channels well-defined? */
+    channelEffectiveness: 'helpful' | 'neutral' | 'noisy';
+    /** Were there coordination bottlenecks? */
+    bottlenecks: string[];
+    /** Actual coordination overhead ratio */
+    coordinationOverhead: number;
+}
+/**
+ * Team outcome assessment.
+ */
+export interface TeamOutcomeObservation {
+    success: boolean;
+    quality: 'excellent' | 'good' | 'acceptable' | 'poor';
+    /** Was this faster than a single agent would have been? (estimated) */
+    speedupEstimate: number;
+    /** Cost efficiency: quality / tokens */
+    costEfficiency: number;
+}
+/**
+ * Lessons about team formation and coordination.
+ */
+export interface TeamLessonsLearned {
+    /** What team patterns worked */
+    whatWorked: string[];
+    /** What team patterns didn't work */
+    whatFailed: string[];
+    /** Suggestions for future team formation */
+    formationSuggestions: string[];
+    /** Suggestions for future coordination */
+    coordinationSuggestions: string[];
+    /** Role-specific suggestions (DESIGN doc field) */
+    roleSuggestions?: string[];
+}
+/**
+ * TeamMetaStrategy - Learned patterns about team formation.
+ * The team-level analog of MetaStrategy.
+ */
+export interface TeamMetaStrategy {
+    id: string;
+    name: string;
+    /** When to apply this team meta-strategy */
+    condition: TeamMetaCondition;
+    /** What formation/coordination adjustments to make */
+    adjustment: TeamMetaAdjustment;
+    /** Track effectiveness */
+    applicationCount: number;
+    successRate: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * Conditions for applying a team meta-strategy.
+ */
+export interface TeamMetaCondition {
+    /** Task characteristics that trigger this strategy */
+    taskCharacteristics: string[];
+    /** Available resources */
+    resourceConstraints: string[];
+    /** Domain context */
+    domains: string[];
+}
+/**
+ * Adjustments to team formation and coordination.
+ */
+export interface TeamMetaAdjustment {
+    /** Topology recommendation */
+    topologyBias?: Record<string, number>;
+    /** Team size adjustment */
+    teamSizeAdjustment: 'increase' | 'decrease' | 'maintain';
+    /** Role adjustments */
+    roleAdjustments: string[];
+    /** Coordination hints */
+    coordinationHints: string[];
+    /** Enforcement mode recommendation */
+    enforcementBias?: 'strict' | 'permissive' | 'audit';
+}
+/**
+ * Create a new team meta-observation.
+ */
+export declare function createTeamMetaObservation(params: {
+    id?: string;
+    teamTrajectoryId: string;
+    formation: FormationObservation;
+    compositionEffectiveness: CompositionObservation;
+    coordinationEffectiveness: CoordinationObservation;
+    outcome: TeamOutcomeObservation;
+    lessons: TeamLessonsLearned;
+}): TeamMetaObservation;
+/**
+ * Create a new team meta-strategy.
+ */
+export declare function createTeamMetaStrategy(params: {
+    id?: string;
+    name: string;
+    condition: TeamMetaCondition;
+    adjustment: TeamMetaAdjustment;
+}): TeamMetaStrategy;
+//# sourceMappingURL=team-meta.d.ts.map

package/dist/types/team-meta.d.ts.map

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

package/dist/types/team-meta.js

@@ -0,0 +1,42 @@
+/**
+ * Team Meta-Learning Types
+ *
+ * Types for meta-learning about team formation and coordination.
+ * Observes patterns about which team configurations work for which contexts.
+ * The team-level analog of MetaObservation and MetaStrategy.
+ */
+// ============================================================
+// Factory functions
+// ============================================================
+/**
+ * Create a new team meta-observation.
+ */
+export function createTeamMetaObservation(params) {
+    return {
+        id: params.id ?? crypto.randomUUID(),
+        teamTrajectoryId: params.teamTrajectoryId,
+        formation: params.formation,
+        compositionEffectiveness: params.compositionEffectiveness,
+        coordinationEffectiveness: params.coordinationEffectiveness,
+        outcome: params.outcome,
+        lessons: params.lessons,
+        timestamp: new Date(),
+    };
+}
+/**
+ * Create a new team meta-strategy.
+ */
+export function createTeamMetaStrategy(params) {
+    const now = new Date();
+    return {
+        id: params.id ?? crypto.randomUUID(),
+        name: params.name,
+        condition: params.condition,
+        adjustment: params.adjustment,
+        applicationCount: 0,
+        successRate: 0,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+//# sourceMappingURL=team-meta.js.map

package/dist/types/team-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-meta.js","sourceRoot":"","sources":["../../src/types/team-meta.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6JH,+DAA+D;AAC/D,oBAAoB;AACpB,+DAA+D;AAE/D;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,MAQzC;IACC,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,UAAU,EAAE;QACpC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,wBAAwB,EAAE,MAAM,CAAC,wBAAwB;QACzD,yBAAyB,EAAE,MAAM,CAAC,yBAAyB;QAC3D,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,IAAI,IAAI,EAAE;KACtB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAKtC;IACC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,UAAU,EAAE;QACpC,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,gBAAgB,EAAE,CAAC;QACnB,WAAW,EAAE,CAAC;QACd,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;KACf,CAAC;AACJ,CAAC"}