@weavelogic/knowledge-graph-agent 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (74) hide show
  1. package/README.md +264 -0
  2. package/dist/cli/bin.d.ts +8 -0
  3. package/dist/cli/bin.d.ts.map +1 -0
  4. package/dist/cli/bin.js +20 -0
  5. package/dist/cli/bin.js.map +1 -0
  6. package/dist/cli/commands/claude.d.ts +11 -0
  7. package/dist/cli/commands/claude.d.ts.map +1 -0
  8. package/dist/cli/commands/claude.js +102 -0
  9. package/dist/cli/commands/claude.js.map +1 -0
  10. package/dist/cli/commands/docs.d.ts +11 -0
  11. package/dist/cli/commands/docs.d.ts.map +1 -0
  12. package/dist/cli/commands/docs.js +108 -0
  13. package/dist/cli/commands/docs.js.map +1 -0
  14. package/dist/cli/commands/graph.d.ts +11 -0
  15. package/dist/cli/commands/graph.d.ts.map +1 -0
  16. package/dist/cli/commands/graph.js +122 -0
  17. package/dist/cli/commands/graph.js.map +1 -0
  18. package/dist/cli/commands/init.d.ts +11 -0
  19. package/dist/cli/commands/init.d.ts.map +1 -0
  20. package/dist/cli/commands/init.js +80 -0
  21. package/dist/cli/commands/init.js.map +1 -0
  22. package/dist/cli/commands/search.d.ts +11 -0
  23. package/dist/cli/commands/search.d.ts.map +1 -0
  24. package/dist/cli/commands/search.js +80 -0
  25. package/dist/cli/commands/search.js.map +1 -0
  26. package/dist/cli/commands/stats.d.ts +11 -0
  27. package/dist/cli/commands/stats.d.ts.map +1 -0
  28. package/dist/cli/commands/stats.js +84 -0
  29. package/dist/cli/commands/stats.js.map +1 -0
  30. package/dist/cli/commands/sync.d.ts +11 -0
  31. package/dist/cli/commands/sync.d.ts.map +1 -0
  32. package/dist/cli/commands/sync.js +76 -0
  33. package/dist/cli/commands/sync.js.map +1 -0
  34. package/dist/cli/index.d.ts +11 -0
  35. package/dist/cli/index.d.ts.map +1 -0
  36. package/dist/cli/index.js +45 -0
  37. package/dist/cli/index.js.map +1 -0
  38. package/dist/core/database.d.ts +121 -0
  39. package/dist/core/database.d.ts.map +1 -0
  40. package/dist/core/database.js +470 -0
  41. package/dist/core/database.js.map +1 -0
  42. package/dist/core/graph.d.ts +109 -0
  43. package/dist/core/graph.d.ts.map +1 -0
  44. package/dist/core/graph.js +343 -0
  45. package/dist/core/graph.js.map +1 -0
  46. package/dist/core/security.d.ts +62 -0
  47. package/dist/core/security.d.ts.map +1 -0
  48. package/dist/core/security.js +31 -0
  49. package/dist/core/security.js.map +1 -0
  50. package/dist/core/types.d.ts +232 -0
  51. package/dist/core/types.d.ts.map +1 -0
  52. package/dist/core/types.js +37 -0
  53. package/dist/core/types.js.map +1 -0
  54. package/dist/generators/claude-md.d.ts +33 -0
  55. package/dist/generators/claude-md.d.ts.map +1 -0
  56. package/dist/generators/claude-md.js +410 -0
  57. package/dist/generators/claude-md.js.map +1 -0
  58. package/dist/generators/docs-init.d.ts +20 -0
  59. package/dist/generators/docs-init.d.ts.map +1 -0
  60. package/dist/generators/docs-init.js +625 -0
  61. package/dist/generators/docs-init.js.map +1 -0
  62. package/dist/generators/graph-generator.d.ts +41 -0
  63. package/dist/generators/graph-generator.d.ts.map +1 -0
  64. package/dist/generators/graph-generator.js +266 -0
  65. package/dist/generators/graph-generator.js.map +1 -0
  66. package/dist/index.d.ts +41 -0
  67. package/dist/index.d.ts.map +1 -0
  68. package/dist/index.js +99 -0
  69. package/dist/index.js.map +1 -0
  70. package/dist/integrations/claude-flow.d.ts +62 -0
  71. package/dist/integrations/claude-flow.d.ts.map +1 -0
  72. package/dist/integrations/claude-flow.js +243 -0
  73. package/dist/integrations/claude-flow.js.map +1 -0
  74. package/package.json +77 -0
@@ -0,0 +1,232 @@
1
+ /**
2
+ * Knowledge Graph Agent - Core Types
3
+ *
4
+ * Type definitions for the knowledge graph system.
5
+ */
6
+ import { z } from 'zod';
7
+ export type NodeType = 'concept' | 'technical' | 'feature' | 'primitive' | 'service' | 'guide' | 'standard' | 'integration';
8
+ export type NodeStatus = 'draft' | 'active' | 'deprecated' | 'archived';
9
+ export interface NodeLink {
10
+ target: string;
11
+ type: 'wikilink' | 'markdown' | 'backlink';
12
+ text?: string;
13
+ context?: string;
14
+ }
15
+ export interface NodeFrontmatter {
16
+ title?: string;
17
+ type?: NodeType;
18
+ status?: NodeStatus;
19
+ tags?: string[];
20
+ category?: string;
21
+ description?: string;
22
+ created?: string;
23
+ updated?: string;
24
+ aliases?: string[];
25
+ related?: string[];
26
+ [key: string]: unknown;
27
+ }
28
+ export interface KnowledgeNode {
29
+ id: string;
30
+ path: string;
31
+ filename: string;
32
+ title: string;
33
+ type: NodeType;
34
+ status: NodeStatus;
35
+ content: string;
36
+ frontmatter: NodeFrontmatter;
37
+ tags: string[];
38
+ outgoingLinks: NodeLink[];
39
+ incomingLinks: NodeLink[];
40
+ wordCount: number;
41
+ lastModified: Date;
42
+ }
43
+ export interface GraphEdge {
44
+ source: string;
45
+ target: string;
46
+ type: 'link' | 'reference' | 'parent' | 'related';
47
+ weight: number;
48
+ context?: string;
49
+ }
50
+ export interface KnowledgeGraph {
51
+ nodes: Map<string, KnowledgeNode>;
52
+ edges: GraphEdge[];
53
+ metadata: GraphMetadata;
54
+ }
55
+ export interface GraphMetadata {
56
+ name: string;
57
+ version: string;
58
+ created: string;
59
+ updated: string;
60
+ nodeCount: number;
61
+ edgeCount: number;
62
+ rootPath: string;
63
+ }
64
+ export interface GraphStats {
65
+ totalNodes: number;
66
+ totalEdges: number;
67
+ nodesByType: Record<NodeType, number>;
68
+ nodesByStatus: Record<NodeStatus, number>;
69
+ orphanNodes: number;
70
+ avgLinksPerNode: number;
71
+ mostConnected: Array<{
72
+ id: string;
73
+ connections: number;
74
+ }>;
75
+ }
76
+ export declare const ConfigSchema: z.ZodObject<{
77
+ projectRoot: z.ZodDefault<z.ZodString>;
78
+ docsRoot: z.ZodDefault<z.ZodString>;
79
+ vaultName: z.ZodOptional<z.ZodString>;
80
+ graph: z.ZodDefault<z.ZodObject<{
81
+ includePatterns: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
82
+ excludePatterns: z.ZodDefault<z.ZodArray<z.ZodString, "many">>;
83
+ maxDepth: z.ZodDefault<z.ZodNumber>;
84
+ }, "strip", z.ZodTypeAny, {
85
+ includePatterns: string[];
86
+ excludePatterns: string[];
87
+ maxDepth: number;
88
+ }, {
89
+ includePatterns?: string[] | undefined;
90
+ excludePatterns?: string[] | undefined;
91
+ maxDepth?: number | undefined;
92
+ }>>;
93
+ database: z.ZodDefault<z.ZodObject<{
94
+ path: z.ZodDefault<z.ZodString>;
95
+ enableWAL: z.ZodDefault<z.ZodBoolean>;
96
+ }, "strip", z.ZodTypeAny, {
97
+ path: string;
98
+ enableWAL: boolean;
99
+ }, {
100
+ path?: string | undefined;
101
+ enableWAL?: boolean | undefined;
102
+ }>>;
103
+ claudeFlow: z.ZodDefault<z.ZodObject<{
104
+ enabled: z.ZodDefault<z.ZodBoolean>;
105
+ namespace: z.ZodDefault<z.ZodString>;
106
+ syncOnChange: z.ZodDefault<z.ZodBoolean>;
107
+ }, "strip", z.ZodTypeAny, {
108
+ enabled: boolean;
109
+ namespace: string;
110
+ syncOnChange: boolean;
111
+ }, {
112
+ enabled?: boolean | undefined;
113
+ namespace?: string | undefined;
114
+ syncOnChange?: boolean | undefined;
115
+ }>>;
116
+ templates: z.ZodDefault<z.ZodObject<{
117
+ customPath: z.ZodOptional<z.ZodString>;
118
+ defaultType: z.ZodDefault<z.ZodEnum<["concept", "technical", "feature", "primitive", "service", "guide", "standard", "integration"]>>;
119
+ }, "strip", z.ZodTypeAny, {
120
+ defaultType: "concept" | "technical" | "feature" | "primitive" | "service" | "guide" | "standard" | "integration";
121
+ customPath?: string | undefined;
122
+ }, {
123
+ customPath?: string | undefined;
124
+ defaultType?: "concept" | "technical" | "feature" | "primitive" | "service" | "guide" | "standard" | "integration" | undefined;
125
+ }>>;
126
+ }, "strip", z.ZodTypeAny, {
127
+ projectRoot: string;
128
+ docsRoot: string;
129
+ graph: {
130
+ includePatterns: string[];
131
+ excludePatterns: string[];
132
+ maxDepth: number;
133
+ };
134
+ database: {
135
+ path: string;
136
+ enableWAL: boolean;
137
+ };
138
+ claudeFlow: {
139
+ enabled: boolean;
140
+ namespace: string;
141
+ syncOnChange: boolean;
142
+ };
143
+ templates: {
144
+ defaultType: "concept" | "technical" | "feature" | "primitive" | "service" | "guide" | "standard" | "integration";
145
+ customPath?: string | undefined;
146
+ };
147
+ vaultName?: string | undefined;
148
+ }, {
149
+ projectRoot?: string | undefined;
150
+ docsRoot?: string | undefined;
151
+ vaultName?: string | undefined;
152
+ graph?: {
153
+ includePatterns?: string[] | undefined;
154
+ excludePatterns?: string[] | undefined;
155
+ maxDepth?: number | undefined;
156
+ } | undefined;
157
+ database?: {
158
+ path?: string | undefined;
159
+ enableWAL?: boolean | undefined;
160
+ } | undefined;
161
+ claudeFlow?: {
162
+ enabled?: boolean | undefined;
163
+ namespace?: string | undefined;
164
+ syncOnChange?: boolean | undefined;
165
+ } | undefined;
166
+ templates?: {
167
+ customPath?: string | undefined;
168
+ defaultType?: "concept" | "technical" | "feature" | "primitive" | "service" | "guide" | "standard" | "integration" | undefined;
169
+ } | undefined;
170
+ }>;
171
+ export type KGConfig = z.infer<typeof ConfigSchema>;
172
+ export interface GeneratorOptions {
173
+ projectRoot: string;
174
+ outputPath: string;
175
+ includeExamples?: boolean;
176
+ force?: boolean;
177
+ }
178
+ export interface GeneratedDocument {
179
+ path: string;
180
+ title: string;
181
+ type: NodeType;
182
+ content: string;
183
+ frontmatter: NodeFrontmatter;
184
+ }
185
+ export interface DocsInitOptions {
186
+ projectRoot: string;
187
+ docsPath?: string;
188
+ template?: string;
189
+ includeExamples?: boolean;
190
+ detectFramework?: boolean;
191
+ }
192
+ export interface DocsInitResult {
193
+ success: boolean;
194
+ docsPath: string;
195
+ filesCreated: string[];
196
+ errors: string[];
197
+ }
198
+ export interface MemoryEntry {
199
+ key: string;
200
+ value: unknown;
201
+ namespace?: string;
202
+ ttl?: number;
203
+ metadata?: Record<string, unknown>;
204
+ }
205
+ export interface SyncResult {
206
+ synced: number;
207
+ failed: number;
208
+ errors: Array<{
209
+ key: string;
210
+ error: string;
211
+ }>;
212
+ }
213
+ export interface ClaudeMdSection {
214
+ title: string;
215
+ content: string;
216
+ order: number;
217
+ }
218
+ export interface ClaudeMdTemplate {
219
+ name: string;
220
+ description: string;
221
+ sections: ClaudeMdSection[];
222
+ variables: Record<string, string>;
223
+ }
224
+ export interface ClaudeMdGeneratorOptions {
225
+ projectRoot: string;
226
+ outputPath?: string;
227
+ template?: string;
228
+ includeKnowledgeGraph?: boolean;
229
+ includeClaudeFlow?: boolean;
230
+ customSections?: ClaudeMdSection[];
231
+ }
232
+ //# sourceMappingURL=types.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,37 @@
1
+ import { z } from "zod";
2
+ const ConfigSchema = z.object({
3
+ // Project settings
4
+ projectRoot: z.string().default("."),
5
+ docsRoot: z.string().default("./docs"),
6
+ vaultName: z.string().optional(),
7
+ // Graph settings
8
+ graph: z.object({
9
+ includePatterns: z.array(z.string()).default(["**/*.md"]),
10
+ excludePatterns: z.array(z.string()).default([
11
+ "node_modules/**",
12
+ "dist/**",
13
+ ".git/**"
14
+ ]),
15
+ maxDepth: z.number().default(10)
16
+ }).default({}),
17
+ // Database settings
18
+ database: z.object({
19
+ path: z.string().default("./.kg/knowledge.db"),
20
+ enableWAL: z.boolean().default(true)
21
+ }).default({}),
22
+ // Claude-Flow integration
23
+ claudeFlow: z.object({
24
+ enabled: z.boolean().default(true),
25
+ namespace: z.string().default("knowledge-graph"),
26
+ syncOnChange: z.boolean().default(true)
27
+ }).default({}),
28
+ // Templates
29
+ templates: z.object({
30
+ customPath: z.string().optional(),
31
+ defaultType: z.enum(["concept", "technical", "feature", "primitive", "service", "guide", "standard", "integration"]).default("concept")
32
+ }).default({})
33
+ });
34
+ export {
35
+ ConfigSchema
36
+ };
37
+ //# sourceMappingURL=types.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.js","sources":["../../src/core/types.ts"],"sourcesContent":["/**\n * Knowledge Graph Agent - Core Types\n *\n * Type definitions for the knowledge graph system.\n */\n\nimport { z } from 'zod';\n\n// ============================================================================\n// Node Types\n// ============================================================================\n\nexport type NodeType =\n | 'concept' // Abstract concepts and ideas\n | 'technical' // Technical components and implementations\n | 'feature' // Product features and capabilities\n | 'primitive' // Base technology primitives (frameworks, libraries)\n | 'service' // Backend services and APIs\n | 'guide' // How-to guides and tutorials\n | 'standard' // Coding standards and conventions\n | 'integration'; // External integrations\n\nexport type NodeStatus = 'draft' | 'active' | 'deprecated' | 'archived';\n\nexport interface NodeLink {\n target: string; // Target node filename or path\n type: 'wikilink' | 'markdown' | 'backlink';\n text?: string; // Display text for the link\n context?: string; // Context in which link appears\n}\n\nexport interface NodeFrontmatter {\n title?: string;\n type?: NodeType;\n status?: NodeStatus;\n tags?: string[];\n category?: string;\n description?: string;\n created?: string;\n updated?: string;\n aliases?: string[];\n related?: string[];\n [key: string]: unknown;\n}\n\nexport interface KnowledgeNode {\n id: string;\n path: string;\n filename: string;\n title: string;\n type: NodeType;\n status: NodeStatus;\n content: string;\n frontmatter: NodeFrontmatter;\n tags: string[];\n outgoingLinks: NodeLink[];\n incomingLinks: NodeLink[];\n wordCount: number;\n lastModified: Date;\n}\n\n// ============================================================================\n// Graph Types\n// ============================================================================\n\nexport interface GraphEdge {\n source: string; // Source node ID\n target: string; // Target node ID\n type: 'link' | 'reference' | 'parent' | 'related';\n weight: number; // Relationship strength 0-1\n context?: string;\n}\n\nexport interface KnowledgeGraph {\n nodes: Map<string, KnowledgeNode>;\n edges: GraphEdge[];\n metadata: GraphMetadata;\n}\n\nexport interface GraphMetadata {\n name: string;\n version: string;\n created: string;\n updated: string;\n nodeCount: number;\n edgeCount: number;\n rootPath: string;\n}\n\nexport interface GraphStats {\n totalNodes: number;\n totalEdges: number;\n nodesByType: Record<NodeType, number>;\n nodesByStatus: Record<NodeStatus, number>;\n orphanNodes: number;\n avgLinksPerNode: number;\n mostConnected: Array<{ id: string; connections: number }>;\n}\n\n// ============================================================================\n// Configuration Types\n// ============================================================================\n\nexport const ConfigSchema = z.object({\n // Project settings\n projectRoot: z.string().default('.'),\n docsRoot: z.string().default('./docs'),\n vaultName: z.string().optional(),\n\n // Graph settings\n graph: z.object({\n includePatterns: z.array(z.string()).default(['**/*.md']),\n excludePatterns: z.array(z.string()).default([\n 'node_modules/**',\n 'dist/**',\n '.git/**',\n ]),\n maxDepth: z.number().default(10),\n }).default({}),\n\n // Database settings\n database: z.object({\n path: z.string().default('./.kg/knowledge.db'),\n enableWAL: z.boolean().default(true),\n }).default({}),\n\n // Claude-Flow integration\n claudeFlow: z.object({\n enabled: z.boolean().default(true),\n namespace: z.string().default('knowledge-graph'),\n syncOnChange: z.boolean().default(true),\n }).default({}),\n\n // Templates\n templates: z.object({\n customPath: z.string().optional(),\n defaultType: z.enum(['concept', 'technical', 'feature', 'primitive', 'service', 'guide', 'standard', 'integration']).default('concept'),\n }).default({}),\n});\n\nexport type KGConfig = z.infer<typeof ConfigSchema>;\n\n// ============================================================================\n// Generator Types\n// ============================================================================\n\nexport interface GeneratorOptions {\n projectRoot: string;\n outputPath: string;\n includeExamples?: boolean;\n force?: boolean;\n}\n\nexport interface GeneratedDocument {\n path: string;\n title: string;\n type: NodeType;\n content: string;\n frontmatter: NodeFrontmatter;\n}\n\nexport interface DocsInitOptions {\n projectRoot: string;\n docsPath?: string;\n template?: string;\n includeExamples?: boolean;\n detectFramework?: boolean;\n}\n\nexport interface DocsInitResult {\n success: boolean;\n docsPath: string;\n filesCreated: string[];\n errors: string[];\n}\n\n// ============================================================================\n// Claude-Flow Integration Types\n// ============================================================================\n\nexport interface MemoryEntry {\n key: string;\n value: unknown;\n namespace?: string;\n ttl?: number;\n metadata?: Record<string, unknown>;\n}\n\nexport interface SyncResult {\n synced: number;\n failed: number;\n errors: Array<{ key: string; error: string }>;\n}\n\n// ============================================================================\n// CLAUDE.md Template Types\n// ============================================================================\n\nexport interface ClaudeMdSection {\n title: string;\n content: string;\n order: number;\n}\n\nexport interface ClaudeMdTemplate {\n name: string;\n description: string;\n sections: ClaudeMdSection[];\n variables: Record<string, string>;\n}\n\nexport interface ClaudeMdGeneratorOptions {\n projectRoot: string;\n outputPath?: string;\n template?: string;\n includeKnowledgeGraph?: boolean;\n includeClaudeFlow?: boolean;\n customSections?: ClaudeMdSection[];\n}\n"],"names":[],"mappings":";AAuGO,MAAM,eAAe,EAAE,OAAO;AAAA;AAAA,EAEnC,aAAa,EAAE,SAAS,QAAQ,GAAG;AAAA,EACnC,UAAU,EAAE,SAAS,QAAQ,QAAQ;AAAA,EACrC,WAAW,EAAE,OAAA,EAAS,SAAA;AAAA;AAAA,EAGtB,OAAO,EAAE,OAAO;AAAA,IACd,iBAAiB,EAAE,MAAM,EAAE,OAAA,CAAQ,EAAE,QAAQ,CAAC,SAAS,CAAC;AAAA,IACxD,iBAAiB,EAAE,MAAM,EAAE,OAAA,CAAQ,EAAE,QAAQ;AAAA,MAC3C;AAAA,MACA;AAAA,MACA;AAAA,IAAA,CACD;AAAA,IACD,UAAU,EAAE,OAAA,EAAS,QAAQ,EAAE;AAAA,EAAA,CAChC,EAAE,QAAQ,EAAE;AAAA;AAAA,EAGb,UAAU,EAAE,OAAO;AAAA,IACjB,MAAM,EAAE,SAAS,QAAQ,oBAAoB;AAAA,IAC7C,WAAW,EAAE,QAAA,EAAU,QAAQ,IAAI;AAAA,EAAA,CACpC,EAAE,QAAQ,EAAE;AAAA;AAAA,EAGb,YAAY,EAAE,OAAO;AAAA,IACnB,SAAS,EAAE,UAAU,QAAQ,IAAI;AAAA,IACjC,WAAW,EAAE,SAAS,QAAQ,iBAAiB;AAAA,IAC/C,cAAc,EAAE,QAAA,EAAU,QAAQ,IAAI;AAAA,EAAA,CACvC,EAAE,QAAQ,EAAE;AAAA;AAAA,EAGb,WAAW,EAAE,OAAO;AAAA,IAClB,YAAY,EAAE,OAAA,EAAS,SAAA;AAAA,IACvB,aAAa,EAAE,KAAK,CAAC,WAAW,aAAa,WAAW,aAAa,WAAW,SAAS,YAAY,aAAa,CAAC,EAAE,QAAQ,SAAS;AAAA,EAAA,CACvI,EAAE,QAAQ,CAAA,CAAE;AACf,CAAC;"}
@@ -0,0 +1,33 @@
1
+ /**
2
+ * CLAUDE.md Generator
3
+ *
4
+ * Generates and manages CLAUDE.md configuration files for Claude Code
5
+ * with knowledge graph integration.
6
+ */
7
+ import type { ClaudeMdGeneratorOptions, ClaudeMdSection } from '../core/types.js';
8
+ /**
9
+ * Generate CLAUDE.md content
10
+ */
11
+ export declare function generateClaudeMd(options: ClaudeMdGeneratorOptions): string;
12
+ /**
13
+ * Create or update CLAUDE.md file
14
+ */
15
+ export declare function updateClaudeMd(options: ClaudeMdGeneratorOptions): Promise<{
16
+ created: boolean;
17
+ updated: boolean;
18
+ path: string;
19
+ content: string;
20
+ }>;
21
+ /**
22
+ * Add section to existing CLAUDE.md
23
+ */
24
+ export declare function addSection(projectRoot: string, section: ClaudeMdSection): boolean;
25
+ /**
26
+ * Get predefined section template
27
+ */
28
+ export declare function getSectionTemplate(name: string): ClaudeMdSection | null;
29
+ /**
30
+ * List available section templates
31
+ */
32
+ export declare function listSectionTemplates(): string[];
33
+ //# sourceMappingURL=claude-md.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"claude-md.d.ts","sourceRoot":"","sources":["../../src/generators/claude-md.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EACV,wBAAwB,EACxB,eAAe,EAEhB,MAAM,kBAAkB,CAAC;AA+O1B;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CAiC1E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC;IAC/E,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAeD;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,eAAe,GACvB,OAAO,CAiCT;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAEvE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAE/C"}